--- sourceDocument: Workflows de version Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/build-workflows Release : - xanadu ft:locale : - fr-FR ft:publication_title : - Workflows de version Xanadu ft:clusterId : - crworkflow bundleId : - crworkflow workflow : - Creator --- # Prise en charge de scripts pour les données complexes # Prise en charge de scripts pour les données complexes {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 minutes de lecture 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. {#script-support-complex-data__table_b4b_4cp_phb__entry__2} | 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 | Étape Script | [Tableau 1. Sources de données nécessitant un script] {#script-support-complex-data__table_b4b_4cp_phb} ## Flux de données Flux de réponse d'action {#script-support-complex-data__section_cnh_yt4_phb} 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](https://www.servicenow.com/docs/access?context=create-data-stream-action&version=xanadu&pubname=xanadu-integrate-applications&ft:locale=en-US) de données. ## Réponse de l'étape REST {#script-support-complex-data__section_wyb_dh4_nhb} 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](https://servicenow-prod.fluidtopics.net/SjGIbEKxxGnmFr259a7PWw "Ajoutez un JavaScript personnalisé à exécuter dans une action réutilisable. Bien que la plupart des actions et étapes de base correspondent à des cas d’utilisation courants, vous pouvez créer une étape de script pour exécuter un comportement qui n’est pas satisfait par les étapes de base.") É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](https://servicenow-prod.fluidtopics.net/vDa9VwfWb40lm~uuIkPvCw#getting-started-dynamic-input "Créez un exemple d’action illustrant l’utilisation de tous les types d’entrées dynamiques disponibles dans un flux.") 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 {#script-support-complex-data__section_osw_gzn_nhb} 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](https://servicenow-prod.fluidtopics.net/SjGIbEKxxGnmFr259a7PWw "Ajoutez un JavaScript personnalisé à exécuter dans une action réutilisable. Bien que la plupart des actions et étapes de base correspondent à des cas d’utilisation courants, vous pouvez créer une étape de script pour exécuter un comportement qui n’est pas satisfait par les étapes de base.") Reportez-vous [Créer une action personnalisée pour générer un tableau d'objets à partir d'une liste d'enregistrements](https://servicenow-prod.fluidtopics.net/NHarrSoS~MICYVt4LGoaGQ "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.") à 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](https://servicenow-prod.fluidtopics.net/0FmKa68gsqTDC62j~cAjDw "Générer un objet à partir d’un enregistrement utilisateur. Découvrez comment utiliser une sortie d’action pour créer un objet à partir de valeurs d’enregistrement.") et [Créer un flux personnalisé pour générer un objet pour chaque enregistrement d'une liste](https://servicenow-prod.fluidtopics.net/Q3NDL2G7TlZEAkmKJ3FU5A "Générer un objet pour chaque enregistrement d’utilisateur dans une liste. Découvrez comment utiliser la logique de flux pour itérer dans une liste d’enregistrements.") pour un exemple de création d'un objet complexe sans utiliser de script. ## Structures d'objets de remontée pas-à-pas {#script-support-complex-data__section_lll_t1z_hhb} 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 {#script-support-complex-data__table_lck_5ct_hhb__entry__4} | 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 | [ ] {#script-support-complex-data__table_lck_5ct_hhb} 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 {#script-support-complex-data__id_epj_nvb_ptb} 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](https://servicenow-prod.fluidtopics.net/NHarrSoS~MICYVt4LGoaGQ)** 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](https://servicenow-prod.fluidtopics.net/RhEhzfzAD2GSdwQ7VfRDMA)** 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.