Prise en charge des scripts pour les données complexes
Créer et référencer 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.
| 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 les 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 d’analyseur ont accès aux objets d’entrée et de sortie du flux de données ainsi qu’à une propriété targetObject. Voir Actions de flux de données pour plus d’informations sur l’analyse d’un flux de réponses pour créer des données complexes.
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 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 la 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 section Étape Script .
Écrivez un script qui mappe les valeurs de réponse REST à des valeurs d’objets complexes. Lors de l’écriture d’un script de réponse REST, utilisez des méthodes JavaScript appropriées au format de réponse, telles que la méthode JSON parse().
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 lors d’une action ou d’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 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 les noms de table et de champ utilisent toutes deux une étape de script pour analyser une réponse REST dans un 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 une boucle JavaScript telle qu’une boucle For ou While .
Pour accéder aux données d’enregistrement à partir d’une étape 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 section Étape Script .
Consultez 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 d’utilisateurs en tableau d’objets de contact.
Structures d’objets de remontée pas à pas
Vous pouvez référencer des éléments à partir de la structure d’un objet en remontant par pas le chemin de la structure. 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.
Viennent ensuite les noms de chaque élément structurel référencé, séparés par des points (également appelés points). La liste des noms d’éléments structurels est identique à la remontée pas à pas d’un champ de référence où vous répertoriez la structure d’un tableau dans un champ de référence particulier.
Par exemple, supposons que vous définissiez un objet de contact en tant que variable Sortie. L’objet a la structure suivante.
| 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 | Chaîne | ||
| Enfant | Téléphone | telephone_number | Array.Object |
| Enfant | Adresses postales | mailing_address | Array.Object |
Le chemin de remontée pas à pas vers l’élément structurel Prénom serait outputs.contact.first_name tandis que le chemin d’accès vers l’élément structurel Email serait outputs.contact.email_addresses[0].email puisque vous devez spécifier un élément individuel du tableau par sa valeur d’index JavaScript.
Directives générales
Gardez ces directives générales à l’esprit lorsque vous créez un script avec des données complexes.
- Utiliser les 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 elles sont automatiquement converties 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 précédente.
- 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 utilisateur 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 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 en tant que modèle afin de pouvoir le réutiliser.
- Mappez la sortie d’action à la variable de sortie de script
- Si 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 de 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 de l’action au tableau de contacts produit par votre étape Script.