--- sourceDocument: Australie Workflow Data Fabric sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/integrate-applications Release : - australia ft:locale : - fr-FR ft:publication_title : - Australie Workflow Data Fabric ft:clusterId : - crint bundleId : - crint workflow : - Creator --- # Actions de flux de données et pagination # Actions de flux de données et pagination {#ariaid-title1} * Rversion finale: Australia * * Mis à jour 12 mars 2026 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 11 minutes de lecture Envoyez des demandes REST, SOAP ou JDBC depuis Studio de workflow des API qui renvoient un flux de données de réponse supérieur à 10 Mo ou qui renvoient des résultats paginés. Analysez les données de flux en 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 d'employé à 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 Centre d'intégration abonnement. Pour plus d'informations, voir [Calendriers juridiques - Centre d'intégration présentation](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 [Centre d'intégration - Importation](https://servicenow-prod.fluidtopics.net/LRR~5UVEOr08_9FVdNvvCw "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, mappez comment 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/gpgdAhoR7jCwkfWo_CGDXg "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 de la logique de flux Pour chaque . Par exemple, vous pouvez créer une action qui importe les Flux de données données d'un document à partir d'un site tiers. Lorsque vous ajoutez l'action à un flux, Studio de workflow l'action est automatiquement ajoutée à un bloc de logique de flux Pour chaque , ce qui permet aux concepteurs de flux de créer facilement un enregistrement ServiceNow pour chaque objet du flux de données. Voir [Utiliser une Flux de données action dans un flux](https://servicenow-prod.fluidtopics.net/3XKgZsyaDa4mvToIHJ~0hQ "Flux de données 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 Flux de données données d’un document à partir d’un site tiers. Lorsqu’elle est ajoutée à un flux, l’action apparaît sous la forme d’un bloc de logique de flux Pour chaque , ce qui permet aux concepteurs de flux de créer facilement un enregistrement ServiceNow pour chaque objet du flux de données."). * Permettez aux concepteurs de flux de réutiliser Flux de données des 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 de la logique de flux Pour chaque . Par exemple, vous pouvez créer une action qui importe les Flux de données données d'un document à partir d'un site tiers. Lorsque vous ajoutez l'action à un flux, Studio de workflow l'action est automatiquement ajoutée à un bloc de logique de flux Pour chaque , ce qui permet aux concepteurs de flux de créer facilement un enregistrement ServiceNow pour chaque objet du flux de données. Voir [Utiliser une Flux de données action dans un flux](https://servicenow-prod.fluidtopics.net/3XKgZsyaDa4mvToIHJ~0hQ "Flux de données 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 Flux de données données d’un document à partir d’un site tiers. Lorsqu’elle est ajoutée à un flux, l’action apparaît sous la forme d’un bloc de logique de flux Pour chaque , ce qui permet aux concepteurs de flux de créer facilement un enregistrement ServiceNow pour chaque objet du flux de données."). À partir d'un script : Vous pouvez démarrer un à l'aide de Flux de données la méthode executeDataStreamAction() dans la classe FlowAPI. Pour plus d'informations, consultez [FlowAPI.](https://www.servicenow.com/docs/access?context=ScriptableFlowAPI&version=australia&pubname=australia-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 instructions 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 : Effacer une option dans une page de configuration supprime l'étape du Flux de données plan et supprime toutes les données associées à l'étape. ## Évaluation des erreurs d'action {#data-stream-actions__section_ewd_xdp_qdc} Utilisez [l'évaluation des erreurs](https://www.servicenow.com/docs/access?context=action-error-evaluation&version=australia&pubname=australia-build-workflows&ft:locale=en-US) pour intercepter les erreurs d'étape et spécifier le comportement d'erreur de chaque étape que vous ajoutez à une action de flux de données. Vous pouvez également créer vos propres conditions d'erreur en spécifiant quand une action renvoie un état d'erreur ainsi que les codes d'état et les messages qu'elle renvoie. ## Prétraitement de l'action {#data-stream-actions__section_c3c_l1t_tgb} Utilisez la catégorie de prétraitement de l'action pour récupérer les détails de connexion et d'informations 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 sur la 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=australia&pubname=australia-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 des valeurs par défaut. La sélection de cette option ajoute une étape de script à l'action Flux de données . Pour en savoir plus, consultez [Script step](https://www.servicenow.com/docs/access?context=javascript-step-action-designer&version=australia&pubname=australia-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 : Demande résultats par lots. Une fois qu'une page de données est traitée, l'action Flux de données exécute à nouveau la section de demande pour renvoyer l'ensemble de résultats suivant. Utilisez 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 renvoyer par page (limite) et le numéro de départ pour le 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 : À des fins de gestion des licences, chaque demande compte pour une transaction, y compris chaque demande pour la page de résultats suivante. La valeur de la variable `getNextPage` réservée 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 définir explicitement la valeur sur true dans le script, sinon elle sera définie par défaut sur false. Il s'agit d'un composant de demande facultatif qui s'exécute uniquement sur l'instance. Remarque : La pagination ne s'applique pas à l'étape JDBC. Étape Script : Exécutez 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 en savoir plus, consultez [Script step](https://www.servicenow.com/docs/access?context=javascript-step-action-designer&version=australia&pubname=australia-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/q47RVM5SobtDFyPGIZGDzw "Envoyez une demande de service Web REST sortante à un système externe.") et [Étape SOAP](https://servicenow-prod.fluidtopics.net/Zyp1zr6XVLFfsNNhiNUYyA "Permettez aux concepteurs d’action d’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 : Envoyez une demande JDBC à une API tierce. Utilisez le script de transformation pour formater 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/Rke5bn0HEjdsj~GOs7YqBw "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/9awviS2c9lAqxT_Ct6MU4Q "Testez le Étape JDBC avant de tester ou de publier une action qui contient le Étape JDBC."). 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 dans les étapes REST et SOAP {#data-stream-actions__section_pkp_wws_tgb} Utilisez la catégorie 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 utilisez l'étape de l'analyseur de script pour transformer chaque élément en un objet complexe. La section 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 des éléments suivants : * É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, consultez [Données complexes](https://www.servicenow.com/docs/access?context=complex-data&version=australia&pubname=australia-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éponses à 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 à partir 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 : identifier des 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 ServiceNow API pour mapper les é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é à 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 >>` partout où cela est nécessaire dans la section Script de l'étape 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 des actions de flux de données REST et SOAP ## Générer la phase d'analyse pour les actions de flux de données basées sur REST {#data-stream-actions__section_hlw_y1v_pfc} Vous pouvez configurer automatiquement l'étape de séparation, l'étape de l'analyseur de script et les sorties pour les actions de flux de données basées sur REST. La fonctionnalité Tester l'étape REST dans les actions de flux de données basées sur REST exécute une demande au point de terminaison REST configuré, analyse la charge utile de la réponse et configure automatiquement les composants d'analyse et de sortie. Lorsqu'une étape REST est ajoutée à la section Requête d'une action de flux de données, vous pouvez utiliser le bouton Tester l'étape REST de l'étape REST pour [générer automatiquement la section Analyse et les sorties](https://servicenow-prod.fluidtopics.net/JyxwUpyvrBmi_1Szp~73Ag "Configurez automatiquement l’étape de séparation, l’étape de l’analyseur de script et les sorties pour les actions de flux de données basées sur REST. La fonctionnalité Tester l’étape REST dans les actions de flux de données basées sur REST exécute une demande au point de terminaison REST configuré, analyse la charge utile de la réponse et configure automatiquement les composants d’analyse et de sortie."). La section Analyse comprend l'étape de séparation et l'étape d'analyse. La génération automatique place également la sortie d'objets complexes dans la section Sorties. ## Étape Transformer le script dans 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'analyseur ne sont pas nécessaires. 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 aux é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 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'objets complexes 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, consultez [Données complexes](https://www.servicenow.com/docs/access?context=complex-data&version=australia&pubname=australia-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. Toutes les données sont récupérées en une seule demande. Remarque : * Vous pouvez uniquement récupérer des données et 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 à 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 d'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 d'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éponses mappés aux 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 de 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 d'exécution incluent les demandes pour les 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 des 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 d'exécution dans l'étape JDBC {#data-stream-actions__section_edv_3nk_h4b} La construction du schéma d'objets complexes en 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/9awviS2c9lAqxT_Ct6MU4Q "Testez le Étape JDBC avant de tester ou de publier une action qui contient le Étape JDBC.") 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 Serveur MID les données selon vos besoins. Consultez [les propriétés du serveur MID](https://www.servicenow.com/docs/access?context=r_MIDServerProperties&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) pour plus d'informations. * **[Considérations relatives à la conception de l'action de flux de données](https://servicenow-prod.fluidtopics.net/k8muupzluqvgwowCdVLVrg)** 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 prise en charge des actions de flux de données](https://servicenow-prod.fluidtopics.net/4oS5zRzV_gSFpJAlJmzAOQ)** Obtenir des données via un ServiceNow® Serveur MID lors de l'exécution d'une Flux de données action. * **[Créer une action de flux de données](https://servicenow-prod.fluidtopics.net/asqGayzq6r8vctkSXBC4nw)** Créez une action réutilisable pour traiter un flux de données de réponse au sein d'un flux. * **[Générer la phase d'analyse pour les actions de flux de données basées sur REST](https://servicenow-prod.fluidtopics.net/JyxwUpyvrBmi_1Szp~73Ag)** Configurez automatiquement l'étape de séparation, l'étape de l'analyseur de script et les sorties pour les actions de flux de données basées sur REST. La fonctionnalité Tester l'étape REST dans les actions de flux de données basées sur REST exécute une demande au point de terminaison REST configuré, analyse la charge utile de la réponse et configure automatiquement les composants d'analyse et de sortie. * **[Tester une Flux de données action](https://servicenow-prod.fluidtopics.net/DsGz3R51KAZpl9Mj_Z8ySQ)** Testez votre Flux de données action pour vous assurer qu'elle fonctionne comme prévu avant de l'ajouter à un flux. * **[Utiliser une Flux de données action dans un flux](https://servicenow-prod.fluidtopics.net/3XKgZsyaDa4mvToIHJ~0hQ)** Flux de données 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 Flux de données données d'un document à partir d'un site tiers. Lorsqu'elle est ajoutée à un flux, l'action apparaît sous la forme d'un bloc de logique de flux Pour chaque , ce qui permet aux concepteurs de flux de créer facilement un enregistrement ServiceNow pour chaque objet du flux de données.