Prise en charge de scripts pour les données complexes

Créez et référencez des données complexes à partir d’un script. Utilisez un script lorsque vos données sources proviennent d’un flux de données, d’une réponse d’étape REST ou d’une étape de recherche d’enregistrements.

Utilisez un script pour créer des données complexes lorsque les données proviennent de ces sources.

Tableau 1. Sources de données nécessitant un script

Source de données	Créer/mapper des données complexes à partir de
Flux de données Flux de réponse d’action	Étape de l'analyseur de script
Réponse de l’étape REST	Étape Script
Étape Rechercher des enregistrements

Flux de données Flux de réponse d’action

Les actions de flux de données utilisent un script d’analyseur pour mapper les valeurs d’éléments de flux à des valeurs d’objets complexes. Lors de l’écriture d’un script d’analyseur, utilisez des méthodes JavaScript appropriées au format du flux de données. Par exemple, utilisez la classe JSON - Scoped pour analyser ou coder un flux de données JSON.

Les scripts de l’analyseur ont accès aux objets d’entrée et de sortie du flux de données, ainsi qu’à une propriété targetObject. Pour plus d’informations sur l’analyse d’un flux de réponse en vue de créer des données complexes, consultez Actions de flux de données.

Réponse de l’étape REST

Vous pouvez convertir une réponse d’étape REST en un ou plusieurs objets complexes en l’analysant avec une étape de script. Pour accéder à une réponse à partir d’une étape de script, vous devez créer une variable de script d’entrée et la mapper à la charge utile de réponse de l’étape REST précédente. Pour plus d’informations sur la création de variables d’entrée de script, reportez-vous à la rubrique Étape Script

Écrivez un script qui mappe les valeurs de réponse REST à des valeurs d’objets complexes. Lors de l’écriture du script de réponse REST, utilisez des méthodes JavaScript appropriées au format de réponse, telles que la méthode JSON parse().

Remarque :

Lorsque vous utilisez des données complexes comme source d’une entrée de chaîne, Studio de workflow la convertit automatiquement en chaîne JSON.

Vous n’avez pas besoin d’utiliser une étape de script pour créer une demande REST à partir de données complexes. Vous pouvez générer des données complexes dans une action ou une étape antérieure, puis les mapper à une entrée de chaîne de l’étape REST. Au moment de l’exécution, l’action ou le flux convertit les données complexes en une représentation JSON.

Par exemple, consultez les étapes de script utilisées pour Introduction aux entrées dynamiques les actions de collecte de données. Les actions de collecte de données pour obtenir des noms de table et de champ utilisent toutes deux une étape de script pour analyser une réponse REST en objet JSON. Les deux actions de collecte de données créent également des variables de sortie qui stockent des données complexes sous forme d’objets JSON.

Étape Rechercher des enregistrements

Bien que les flux puissent utiliser Pour chaque logique de flux afin de traiter une liste d’enregistrements, les actions nécessitent une étape de script. L’étape Script remplace la logique de flux For each par JavaScript, telle qu’une boucle For ou While .

Pour accéder aux données d’enregistrement à partir d’une étape de script, vous devez créer une variable de script d’entrée et la mapper aux données d’enregistrement de l’étape de recherche précédente. Pour plus d’informations sur la création de variables d’entrée de script, reportez-vous à la rubrique Étape Script

Reportez-vous Créer une action personnalisée pour générer un tableau d’objets à partir d’une liste d’enregistrements à un exemple d’action qui convertit une liste d’enregistrements utilisateur en tableau d’objets de contact.

Remarque :

L’action Rechercher des enregistrements ne nécessite pas d’étape de script pour convertir les données d’enregistrement en données complexes. Vous pouvez créer une action personnalisée pour convertir un enregistrement en objet et appliquer une logique For Each Flow à l’action personnalisée. Voir Créer une action personnalisée pour générer un objet à partir d’un enregistrement et Créer un flux personnalisé pour générer un objet pour chaque enregistrement d’une liste pour un exemple de création d’un objet complexe sans utiliser de script.

Structures d’objets de remontée pas-à-pas

Vous pouvez référencer des éléments à partir de la structure d’un objet en parcourant le tracé de la structure en effectuant une remontée pas à pas. Tous les chemins de données complexes commencent par le nom de la source de données, qui est soit l’objet global pour les entrées, soit l’objet global pour les sorties, soit le nom du tableau ou de l’objet que vous avez créé dans le script.

Ensuite, dans le chemin se trouvent les noms de chaque élément structurel référencé, séparés par des caractères de point (également appelés points). L’énumération des noms des éléments structurels est identique à la remontée pas à pas d’un champ de référence où vous répertoriez la structure de la table dans un champ de référence particulier.

Remarque :

Un chemin de remontée pas à pas indique toujours le nom d’un élément structurel plutôt que son étiquette.

Par exemple, supposons que vous définissiez un objet contact en tant que variable de sortie. La structure de l’objet est la suivante.

Figure 1. Exemple d’objet de contact

Placer dans la structure	Étiquette	Nom	Type
Parent	Contact	contact	Objet
Enfant	Prénom	first_name	Chaîne
Enfant	Nom	last_name	Chaîne
Enfant	Adresses e-mail	email_addresses	Array.Object
Petit-fils	Adresse e-mail	email_address	Objet
Arrière-petit-enfant	Type	type	Choix
Arrière-petit-enfant	E-mail	E-mail	Chaîne
Enfant	Téléphone	telephone_number	Array.Object
Enfant	Adresses postales	mailing_address	Array.Object

Le chemin d’accès de remontée pas à pas vers l’élément structurel Prénom sera outputs.contact.first_name tandis que le chemin d’accès à l’élément structurel Email sera outputs.contact.email_addresses[0].email, car vous devez spécifier un élément individuel du tableau par sa valeur d’index JavaScript.

Remarque :

Un chemin de remontée pas à pas omet le nom de l’élément répété dans le tableau. Par exemple, un tableau d’objets n’a pas besoin de spécifier le nom de l’élément objet. Toutefois, étant donné que les objets sont des conteneurs pour d’autres éléments, vous pouvez spécifier un élément enfant de l’objet dans un chemin de remontée pas à pas.

Directives générales

Gardez ces instructions générales à l’esprit lorsque vous créez un script avec des données complexes.

Utiliser des entrées de chaîne pour convertir des données complexes en une chaîne JSON

Lorsque vous mappez des données complexes à une entrée de chaîne, Studio de workflow celle-ci est automatiquement convertie en chaîne JSON. Au lieu d’écrire un script, vous pouvez ajouter une entrée de chaîne à une étape REST et la mapper aux données complexes d’une action ou d’une étape antérieure.

Enregistrer vos objets en tant que modèles

Enregistrez vos objets en tant que modèles afin de pouvoir les réutiliser dans d’autres actions, flux et étapes de script.

Créer des variables d’entrée de script pour accéder aux données antérieures

Créez une variable d’entrée de script pour toutes les données auxquelles vous souhaitez accéder à partir de l’entrée d’action ou d’une étape antérieure. Mappez la variable d’entrée de script à la pastille de données d’entrée ou d’étape. Par exemple, mappez la variable d’entrée de script à une liste d’enregistrements d’utilisateurs que vous avez consultés lors d’une étape précédente.

Créer une variable de sortie de script pour stocker des données complexes

Créez une variable de sortie de script pour stocker toutes les données complexes créées par votre script. Les variables de sortie du script doivent correspondre aux valeurs définies dans le script. Par exemple, créez un tableau d’objets contacts pour stocker plusieurs objets de contact. Enregistrez l’objet de contact comme modèle afin de pouvoir le réutiliser.

Mappez la sortie d’action à la variable de sortie de script

Lorsque vous souhaitez qu’une action personnalisée génère des données complexes, ajoutez une sortie d’action et mappez-la à la pastille de données pour votre variable de sortie d’étape Script. Par exemple, créez un tableau de contacts et chargez le modèle d’objet de contact que vous avez enregistré précédemment. Mappez la sortie d’action au tableau de contacts produit par votre étape de script.

• Créer une action personnalisée pour générer un tableau d’objets à partir d’une liste d’enregistrements
  Générer un tableau d’objets à partir d’une liste d’enregistrements d’utilisateurs. Découvrez comment utiliser une étape de script pour parcourir une liste d’enregistrements.
• Créer une action personnalisée pour générer un tableau de chaînes à partir d’une liste d’enregistrements
  Générez un tableau de chaînes à partir d’une liste d’enregistrements de rôles d’utilisateurs. Découvrez comment utiliser une étape de script pour parcourir une liste d’enregistrements.