--- sourceDocument: Xanadu : créer des intégrations avec des applications sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/integrate-applications Release : - xanadu ft:locale : - fr-FR ft:publication_title : - Xanadu : créer des intégrations avec des applications ft:clusterId : - crint bundleId : - crint workflow : - Creator --- # Actions et pagination du flux de données # Actions et pagination du flux de données {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 10 minutes de lecture Envoyez des demandes REST, SOAP ou JDBC de Studio de workflow à des API qui retournent un flux de données de réponse supérieur à 10 Mo ou qui retournent des résultats paginés. Analysez les données de flux dans une série de sorties d'objets complexes et utilisez les pastilles de données dans d'autres actions dans un flux. Par exemple, créez une Flux de données action pour importer une grande quantité de données sur les employés à partir d'un site RH tiers. L'action Flux de données envoie une demande REST au site tiers et traite la réponse pour renseigner les enregistrements de la table Utilisateur \[sys_user\]. Remarque : les actions de flux de données nécessitent un abonnement Hub d'intégration. Pour plus d'informations, consultez [Calendriers juridiques - Vue d'ensemble du concentrateur d'intégration](https://www.servicenow.com/content/dam/servicenow-assets/public/en-us/doc-type/legal/snc-addendum-integrationhub.pdf). ## Avantages {#data-stream-actions__section_d3h_2pm_tgb} Flux de données Les actions offrent ces avantages. * Analysez et formatez un flux de données de réponse supérieur à 10 Mo. * Envoyez automatiquement plusieurs demandes aux API qui paginent les résultats, le cas échéant. * Peut être utilisé dans [Hub d'intégration -Importation](https://servicenow-prod.fluidtopics.net/s4CuPgz4lhgY3bPVi0Gt4A "Automatisez les tâches d’importation de données via une interface consolidée qui fournit une expérience guidée, étape par étape. Définissez des sources de données externes, spécifiez des tables cibles, représentez la façon dont les données sources deviennent des données cibles et planifiez des importations régulières.") et pour [créer une source de données](https://servicenow-prod.fluidtopics.net/il5iKPVBHnZtUgrasu93Aw "Créez un enregistrement de source de données de type Flux de données (Centre d’intégration) pour définir les données complexes qu’un jeu d’importation doit importer à partir d’une action de flux de données."). * Permettez aux concepteurs de flux de traiter des demandes volumineuses sans codage ni configuration complexe. * Permettre aux concepteurs de flux de traiter chaque objet d'un flux de données à l'aide d'une logique de flux Pour chaque. Par exemple, vous pouvez créer une action Flux de données pour importer des données de document à partir d'un site tiers. Lorsque vous ajoutez l'action à un flux, Studio de workflow ajoute automatiquement cette action à un bloc logique de flux Pour chaque, permettant ainsi aux concepteurs de flux de créer facilement un enregistrement dans ServiceNow pour chaque objet du flux de données. Reportez-vous à [Utiliser une Flux de données action dans un flux](https://servicenow-prod.fluidtopics.net/Z0ke8gipvJvubh~XU92AgQ "Flux de données Les actions utilisent l’option de logique de flux Pour chaque pour traiter les données de flux dans un flux. Par exemple, supposons que vous souhaitiez utiliser une action qui importe les données d’un Flux de données document à partir d’un site tiers. Lorsqu’elle est ajoutée à un flux, l’action apparaît sous la forme d’un bloc logique Pour chaque flux, ce qui permet aux concepteurs de flux de créer facilement un enregistrement pour ServiceNow chaque objet du flux de données."). * Permettez aux concepteurs de flux de réutiliser Flux de données les actions dans plusieurs flux, en utilisant la même source de données de plusieurs façons. {#data-stream-actions__ul_k2p_2pm_tgb} ## Exécution d'une action de flux de données {#data-stream-actions__section_dq2_x13_z3b} Il existe deux façons d'exécuter une Flux de données action. À partir d'un flux : Vous pouvez traiter chaque objet d'un flux de données à l'aide d'une logique de flux Pour chaque. Par exemple, vous pouvez créer une action Flux de données pour importer des données de document à partir d'un site tiers. Lorsque vous ajoutez l'action à un flux, Studio de workflow ajoute automatiquement cette action à un bloc logique de flux Pour chaque, permettant ainsi aux concepteurs de flux de créer facilement un enregistrement dans ServiceNow pour chaque objet du flux de données. Reportez-vous à [Utiliser une Flux de données action dans un flux](https://servicenow-prod.fluidtopics.net/Z0ke8gipvJvubh~XU92AgQ "Flux de données Les actions utilisent l’option de logique de flux Pour chaque pour traiter les données de flux dans un flux. Par exemple, supposons que vous souhaitiez utiliser une action qui importe les données d’un Flux de données document à partir d’un site tiers. Lorsqu’elle est ajoutée à un flux, l’action apparaît sous la forme d’un bloc logique Pour chaque flux, ce qui permet aux concepteurs de flux de créer facilement un enregistrement pour ServiceNow chaque objet du flux de données."). À partir d'un script : Vous pouvez démarrer une Flux de données opération à l'aide de la méthode executeDataStreamAction() dans la classe FlowAPI. Pour plus d'informations, consultez [FlowAPI](https://www.servicenow.com/docs/access?context=ScriptableFlowAPI&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US). ## Plan d'action {#data-stream-actions__section_wnp_sgg_5gb} Flux de données Les actions suivent une structure définie. Suivez les invites pour ajouter et supprimer des étapes du plan d'action. Vous ne pouvez pas ajouter manuellement des étapes à une Flux de données action. Figure 1. Actions de flux de données REST et SOAP Figure 2. Action de flux de données JDBC Remarque : La désactivation d'une option dans une page de configuration supprime l'étape du plan Flux de données ainsi que toutes les données associées à l'étape. ## Prétraitement de l'action {#data-stream-actions__section_c3c_l1t_tgb} Utilisez la catégorie Prétraitement d'action pour récupérer les informations de connexion et d'identification ou pour exécuter un script de prétraitement. Sélectionnez Récupérer les informations de connexion pour récupérer les détails de connexion et d'informations d'identification à utiliser dans votre action. La sélection de cette option ajoute l'étape Obtenir des informations de connexion comme première étape du prétraitement de l'action. Pour plus d'informations, consultez [Get Connection Info step](https://www.servicenow.com/docs/access?context=get-connection-info-action-designer&version=xanadu&pubname=xanadu-build-workflows&ft:locale=en-US). Sélectionnez Activer le script de prétraitement pour exécuter un script de prétraitement avant que l'action n'envoie la demande d'API initiale. Par exemple, validez les entrées d'action ou définissez les valeurs par défaut. La sélection de cette option ajoute une étape de script à l'action Flux de données. Pour plus d'informations, consultez [Script step](https://www.servicenow.com/docs/access?context=javascript-step-action-designer&version=xanadu&pubname=xanadu-build-workflows&ft:locale=en-US). Le prétraitement s'exécute une fois par action, avant la première demande d'API. Il s'agit d'un composant d'action facultatif Flux de données qui s'exécute sur l'instance ou sur un Serveur MID. ## Demande {#data-stream-actions__section_a32_m1t_tgb} Utilisez la catégorie Demande pour configurer la façon dont l'action envoie les demandes d'API. La section Demande s'exécute une fois par page de résultats. Les composants de demande fournissent ces options de configuration. Étape de configuration de la pagination : Utilisez entraîne des lots. Une fois que la page de données est traitée, l'action Flux de données réexécute la section de demande pour retourner le jeu suivant de résultats. l'étape de configuration de la pagination pour configurer les options de pagination requises par l'API. Configurez manuellement l'étape de configuration de la pagination ou sélectionnez un modèle prédéfini pour appliquer des configurations courantes. Par exemple, appliquez le modèle Limite/décalage pour spécifier le nombre d'éléments que vous souhaitez retourner par page (limite), ainsi que le numéro de départ du premier élément (décalage). Après l'application d'un modèle, mettez à jour les valeurs pour vous assurer que la configuration est conforme aux exigences de l'API. Remarque : Aux fins de la gestion des licences, chaque demande compte comme une transaction, y compris chaque demande pour la page de résultats suivante. La valeur de la variable `getNextPage` réservée et en lecture seule détermine s'il faut demander une autre page de résultats. Tant que la variable `getNextPage` est définie sur vrai et que la page précédente contient des données, l'action continue d'envoyer des demandes pour la page suivante. Remarque : Vous devez explicitement définir la valeur sur vrai dans le script, sinon elle sera définie par défaut sur faux. Il s'agit d'un composant de demande facultatif qui ne s'exécute que sur l'instance. Remarque : La pagination ne s'applique pas à l'étape JDBC. Étape Script : Exécuter un script avant chaque demande pour la page de résultats suivante. Utilisez ce script pour la validation et la transformation des données lors de l'appel d'une API paginée. Par exemple, générez une charge utile JSON pour la demande de page suivante. La sélection de cette option ajoute une étape de script à l'action Flux de données. Pour plus d'informations, consultez [Script step](https://www.servicenow.com/docs/access?context=javascript-step-action-designer&version=xanadu&pubname=xanadu-build-workflows&ft:locale=en-US). Il s'agit d'un composant de demande facultatif qui s'exécute sur l'instance ou sur un Serveur MID. Étape REST ou SOAP : Envoyez une demande REST ou SOAP à une API tierce. Sélectionnez un format de données pour ajouter une étape associée à l'action Flux de données . Pour plus d'informations, consultez [Étape REST](https://servicenow-prod.fluidtopics.net/xBNtFtvtP1i_w8GbOUvNiQ "Envoyez une demande de service Web REST sortante à un système externe.") et [Étape SOAP](https://servicenow-prod.fluidtopics.net/HwZ3cW_WRH9Gnfyqo4ahTA "Activez les designers d'actions pour envoyer des demandes de service Web SOAP sortantes à des systèmes externes."). Il s'agit d'un composant de demande obligatoire qui s'exécute sur l'instance ou sur un Serveur MID. Étape JDBC : Envoyer une demande JDBC à une API tierce. Utilisez le script de transformation pour mettre en forme les données et ajouter une étape associée à l'action Flux de données . Pour plus d'informations, consultez [Étape JDBC](https://servicenow-prod.fluidtopics.net/~TvtsHB9zbtZ9akaGcWVGA "Créez une action réutilisable pour envoyer des commandes SQL à une base de données relationnelle.") et [Tester l'étape JDBC](https://servicenow-prod.fluidtopics.net/Q4mUAPV_5XcHNiKsFknUXg "Testez le avant de Étape JDBC tester ou de publier une action contenant le Étape JDBCfichier ."). Toutes les données sont récupérées et la pagination n'est pas nécessaire. Il s'agit d'un composant de demande obligatoire qui s'exécute sur un Serveur MID. ## Analyse des étapes REST et SOAP {#data-stream-actions__section_pkp_wws_tgb} Utilisez la catégorie d'analyse pour configurer la façon dont l'action sépare les éléments de flux de données en objets de données complexes. Utilisez l'étape de séparation pour identifier et séparer les éléments d'un flux XML ou JSON, et l'étape de l'analyseur de script pour transformer chaque élément en un objet complexe. La section d'analyse s'exécute une fois par élément du flux. Vous pouvez accéder aux sorties des étapes précédentes de votre action de flux de données à l'aide de l'objet fd_data , à l'exclusion de : * Étape REST ou SOAP Sorties de corps de réponse, de flux ou de message d'erreur * Sorties de l'étape de séparation {#data-stream-actions__ul_e3d_bdb_plb} Pour plus d'informations sur les données complexes, reportez-vous à [la rubrique Données complexes](https://www.servicenow.com/docs/access?context=complex-data&version=xanadu&pubname=xanadu-build-workflows&ft:locale=en-US). Les composants d'analyse fournissent ces options de configuration. Étape de séparation : Identifier le nœud parent dans le flux de réponse à mapper à un objet complexe. Par exemple, identifiez un élément utilisateur dans une charge utile XML pour créer un objet complexe pour chaque utilisateur dans le flux de réponse. Sélectionnez un type de séparateur pour identifier et séparer les éléments répétés dans un flux de données XML ou JSON. * JSON : identifie les objets d'un flux de données JSON. Utilisez une expression JSONPath pour identifier un tableau JSON contenant des données répétées. * XML : identifie les objets à partir d'un flux de données XML. Utilisez une expression XPath pour identifier un élément XML contenant des données répétées. {#data-stream-actions__ul_egw_4p2_fhb} Il s'agit d'un composant d'analyse obligatoire qui ne s'exécute que sur l'instance. Étape de l'analyseur de script : Utilisation JavaScript et des API ServiceNow pour mapper des éléments du flux de réponse à une sortie d'objet complexe représentée par l'objet global `TargetObject`. Par exemple, mappez les éléments d'enregistrement d'incident identifiés à l'étape de séparation à un objet complexe contenant des champs d'incident. Si le flux de données inclut des frères et sœurs de l'élément identifié dans l'étape de séparation que vous ne souhaitez pas mapper à un objet complexe, incluez des conditions pour exclure ces éléments. Vous pouvez ignorer des éléments dans le flux en ajoutant `outputs.state = 'SKIP'` chaque fois que nécessaire à la section de script de l'étape de l'analyseur de script. Il s'agit d'un composant d'analyse obligatoire qui ne s'exécute que sur l'instance. Figure 3. Vue d'ensemble de l'action de flux de données REST et SOAP ## Transformer le script dans l'étape JDBC {#data-stream-actions__section_sqs_rgj_h4b} L'action du flux de données JDBC ne nécessite pas de pagination. De plus, les étapes de séparation et d'analyse ne sont pas requises. L'étape JDBC génère un objet complexe pour chacun des enregistrements récupérés. Par conséquent, le prétraitement de l'action et le script de transformation dans l'action de flux de données JDBC sont facultatifs. Lors de l'utilisation du script de transformation, le concepteur d'action doit spécifier le nom interne des colonnes de table dans le script de transformation.Figure 4. Vue d'ensemble de l'action de flux de données JDBC ## Sorties de flux de données en étapes SOAP et REST {#data-stream-actions__section_j4k_rpz_c3b} Lors de la conception d'une Flux de données action, vous devez créer une sortie unique de type Objet ou Objet dynamique. L'étape de l'analyseur de script mappe les éléments du flux à cet objet à l'aide de l'objet `global targetObject` . Lors de l'exécution, le système divise et analyse le flux de données de réponse en fonction de la Flux de données configuration. Chaque élément du flux est mappé à la structure d'objet complexe définie par l'étape de l'analyseur de script et la sortie de l'objet, ce qui donne une grande série d'objets complexes. Pour plus d'informations sur les données complexes, reportez-vous à [la rubrique Données complexes](https://www.servicenow.com/docs/access?context=complex-data&version=xanadu&pubname=xanadu-build-workflows&ft:locale=en-US). ## Sorties de flux de données dans l'étape JDBC {#data-stream-actions__section_j23_glk_h4b} La sortie des étapes JDBC est un flux d'objets complexe. Les données entières sont récupérées en une seule demande. Remarque : * Vous pouvez uniquement récupérer des données et vous ne pouvez pas mettre à jour ou supprimer des enregistrements à l'aide de l'action de flux de données JDBC. * Les champs Ligne maximale et Taille maximale de la charge utile (Ko) disponibles dans l'étape JDBC ne sont pas disponibles dans l'action de flux de données JDBC. {#data-stream-actions__ul_a3y_1mk_h4b} ## Détails de l'exécution dans les étapes REST et SOAP {#data-stream-actions__section_if2_rs2_1hb} Affichez les résultats de configuration et d'exécution pour chaque élément traité par une Flux de données action. Sélectionnez un numéro d'enregistrement pour afficher les détails de sa configuration et de son exécution. Par défaut, les détails de l'exécution incluent les demandes pour les 1 000 derniers éléments. Pour modifier le nombre d'éléments dans les détails de l'exécution, mettez à jour la com.snc.process_flow.reporting.datastream.item.lastn propriété système. Résumé du flux de données : Affichez une vue d'ensemble de l'exécution qui inclut ces informations. * Nombre de pages : nombre de pages renvoyées par une API paginée. * Nombre total d'éléments : nombre d'éléments dans le flux de réponse mappés à des sorties d'objets complexes. * Nombre d'erreurs : nombre d'erreurs rencontrées. {#data-stream-actions__ul_wbb_scb_nhb} Détails de page : Affichez les données d'exécution pour chaque étape de l'action Flux de données . Sélectionnez une page pour afficher les détails d'exécution de chaque demande à une API paginée. Par défaut, les détails de l'exécution incluent les demandes des cinq dernières pages. Pour modifier le nombre de demandes dans les détails de l'exécution, mettez à jour la com.snc.process_flow.page.reporting.lastn propriété système. Définissez la valeur sur 0 pour supprimer les pages des détails de l'exécution et sur -1 pour inclure toutes les pages. Remarque : L'inclusion de toutes les pages peut affecter les performances et n'est pas recommandée. ## Détails de l'exécution dans l'étape JDBC {#data-stream-actions__section_edv_3nk_h4b} La construction du schéma d'objet complexe de sortie n'est pas nécessaire pour l'action de flux de données JDBC. Vous pouvez tester la requête et voir le résultat de la requête. Consultez [Tester l'étape JDBC](https://servicenow-prod.fluidtopics.net/Q4mUAPV_5XcHNiKsFknUXg "Testez le avant de Étape JDBC tester ou de publier une action contenant le Étape JDBCfichier .") pour plus d'informations. Configurez les propriétés mid.jdbc.datastream.max.record.size et mid.jdbc.datastream.fail.when.attachement.limit.exceeded récupérez les Serveur MID données selon vos besoins. Consultez [les propriétés du serveur MID](https://www.servicenow.com/docs/access?context=r_MIDServerProperties&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US) pour plus d'informations. * **[Flux de données Considérations relatives à la conception de l'action](https://servicenow-prod.fluidtopics.net/tOO4Y19eQURqgXujjAFlnQ)** Suivez ces considérations lors de la création d'une Flux de données action et lors de l'ajout d'une Flux de données action à un flux pour éviter les erreurs et les problèmes de performances. * **[Serveur MID Soutien aux Flux de données actions](https://servicenow-prod.fluidtopics.net/pX0bASNNTXXAfyX1CIHCGw)** Obtenez des données via un ServiceNow® Serveur MID lors de l'exécution d'une action Flux de données. * **[Créer une action de flux de données](https://servicenow-prod.fluidtopics.net/OxIKUXZeNGXEYEyM~M8oOQ)** Créez une action réutilisable pour traiter un flux de données de réponse dans un flux. * **[Tester une Flux de données action](https://servicenow-prod.fluidtopics.net/MajtOs~C3JlLGfITicJcgw)** Testez votre action Flux de données pour vous assurer qu'elle fonctionne comme vous le pensez avant de l'ajouter à un flux. * **[Utiliser une Flux de données action dans un flux](https://servicenow-prod.fluidtopics.net/Z0ke8gipvJvubh~XU92AgQ)** Flux de données Les actions utilisent l'option de logique de flux Pour chaque pour traiter les données de flux dans un flux. Par exemple, supposons que vous souhaitiez utiliser une action qui importe les données d'un Flux de données document à partir d'un site tiers. Lorsqu'elle est ajoutée à un flux, l'action apparaît sous la forme d'un bloc logique Pour chaque flux, ce qui permet aux concepteurs de flux de créer facilement un enregistrement pour ServiceNow chaque objet du flux de données.