---
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


---

# Utiliser les consommateurs ETL et de carte de transformation pour importer des données

# Utiliser les consommateurs ETL et de carte de transformation pour importer des données {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes de lecture

Utilisez les définitions ETL et les cartes de transformation pour traiter les événements Kafka. Les définitions ETL et les cartes de transformation spécifient la logique de transformation à utiliser lors de l'extraction des données via les importations planifiées. Vous pouvez utiliser les mêmes définitions ETL et cartes de transformation pour transformer les événements reçus via Kafka.

## Avant de commencer

* Rôle requis : integration_hub_admin
* Cette page fait partie de la [Connexion au flux Guide de démarrage rapide](https://servicenow-prod.fluidtopics.net/pSOwxsIatwhV7e9pvIEh0w "Ce guide de démarrage rapide vous donne une vue d’ensemble de la configuration et de l’utilisation de chacun des six producteurs et consommateurs de Stream Connect pour échanger des données entre votre ServiceNow instance et un environnement Kafka.")section .
* Ce document vous montre comment utiliser des messages via votre connexion à Hermes. Pour configurer et tester votre connexion, consultez [Set up a secure connection to the Hermes Messaging Service](https://www.servicenow.com/docs/access?context=set-up-secure-connection-to-hermes&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US) et [Test de la connexion à Hermes via la passerelle ADCv2](https://servicenow-prod.fluidtopics.net/5IC9ajft_b3sWyh~hQ4hug "Vérifiez que le magasin de clés et le magasin de clés de confiance ont été correctement générés en testant la connexion à Hermes via la passerelle ADCv2.").
* La première partie de cette page vous montre comment utiliser le consommateur ETL pour consommer des messages. Pour utiliser le consommateur ETL, vous avez besoin d'un [transformateur de jeu d'importation robuste](https://servicenow-prod.fluidtopics.net/Es5cPGcLnfunjZ7CaJmvZw "Utilisez des transformateurs de jeux d’importation robustes au lieu de cartes de transformation si vous souhaitez extraire, transformer et charger des données dans une ou plusieurs tables cibles.").
* La deuxième partie de cette page vous montre comment utiliser un consommateur de carte de transformation pour utiliser des messages. Pour utiliser le consommateur de carte de transformation, vous avez besoin d'une [carte de transformation](https://servicenow-prod.fluidtopics.net/Ne~ED4p01m2kX_3xiUOujw "Une carte de transformation est un ensemble de cartes de champs qui déterminent les relations entre les champs d’un jeu d’importation et les champs d’une table existante ServiceNow , telle que Incident [incident] ou Utilisateur [sys_user].").
{#use-etl-transform-map-consumers__ul_gm5_njx_cyb}

## Procédure

1. Créez une rubrique pour utiliser ETL et transformer les messages des consommateurs de carte.
   1. Utilisez la commande suivante pour créer une rubrique dans Hermès.  
      Dans cet exemple, le nom de la rubrique est topic2.

          bin/kafka-topics.sh --create --command-config config/bootcamp.properties  --bootstrap-server <instance name>.service-now.com:4000,<instance name>.service-now.com:4001,<instance name>.service-now.com:4002, <instance name>.service-now.com:4003 --topic snc.<instance name>.topic2

      Assurez-vous de remplacer `<nom d'instance>` par le nom de votre instance.
   2. Pour afficher la rubrique, connectez-vous à l'instance et accédez à ToutCentre d'intégrationConnexion au fluxRubriques.  
      Remarque :  
      La création d'une rubrique prend environ 10 minutes.
   {#use-etl-transform-map-consumers__substeps_lv3_ylx_cyb}
2. Créez un consommateur ETL pour utiliser les données de la rubrique.
   1. Accédez à la ToutCentre d'intégrationConsommateursConsommateur ETL.
   2. Sélectionnez Nouveau.
   3. Sur le formulaire Consommateur Kafka, saisissez un nom dans le champ Nom .  
      Cet exemple utilise le nom Importation de membres.
   4. Pour le transformateur de jeu d'importation robuste déposé, sélectionnez un transformateur de jeu d'importation robuste existant.  
      Pour le transformateur de jeu d'importation robuste, sélectionnez-en un qui n'utilise pas l'option permettant de stocker les données dans une seule colonne. Pour pouvoir voir les messages, assurez-vous que l'option Détaillé est activée sur le transformateur de jeu d'importation robuste.
   5. Désélectionnez l'option Données dans une seule colonne .  
      Cette option ne doit être sélectionnée que pour les tables de jeux d'importation avec des données dans une seule colonne.
   6. Définissez le mappage de colonnes sur Étiquette.  
      Cela signifie que les clés JSON du message d'entrée sont mappées aux étiquettes de colonne de la table Jeu d'importation.  
   7. Enregistrez le formulaire.
   8. [Créer un flux Kafka](https://servicenow-prod.fluidtopics.net/DoLarXwTOWrH3FzYJ47DaA "Définissez un flux de données pour un consommateur d’extraction, de transformation (ETL), de carte de transformation ou de script. Un flux Kafka définit le flux de données vers votre consommateur.") pour le consommateur.
   9. Sur le formulaire Flux Kafka, définissez les valeurs de champ suivantes.  
      * Nom du <kbd class="ph userinput">flux Topic2</kbd>.
      * Rubrique de la rubrique créée précédemment, topic2.
      * Concurrence maximale à <kbd class="ph userinput">1</kbd>.
      * Commencer à consommer dans Messages reçus après la première activation.
      * Gestion des messages à optimiser automatiquement.
      {#use-etl-transform-map-consumers__ul_pbp_rqm_2yb}
   10. Sélectionnez le lien Activer sous Liens connexes.  
       Vous devriez être en mesure de voir l'abonnement activé.  
   {#use-etl-transform-map-consumers__substeps_ajg_hkx_cyb}
3. Publiez des messages dans la rubrique 2.
   1. Exécutez la commande suivante pour publier des messages dans topic2.  

          bin/kafka-console-producer.sh --topic snc.<instance name>.topic2  --producer.config  config/bootcamp.properties  --bootstrap-server <instance name>.service-now.com:4000,<instance name>.service-now.com:4001,<instance name>.service-now.com:4002,<instance name>.service-now.com:4003

      Assurez-vous de remplacer `<nom d'instance>` par le nom de votre instance.

      Cette commande vous invite à entrer des messages.
   2. Envoyez le message JSON suivant.  

          {"city":"San Diego","name":"Jhon","id":"SN001","state":"California"}

      Vous pouvez envoyer ce message avec n'importe quelle valeur, mais la clé du message JSON doit correspondre aux étiquettes de la table Jeu d'importation.
   3. Revenez au consommateur ETL que vous avez créé.  
      Au bout d'une minute environ, les données doivent avoir été importées via le jeu d'importation.  
   4. Pour afficher des informations détaillées sur le jeu d'importation, sélectionnez le numéro du jeu d'importation.  
   5. Pour afficher des informations détaillées sur une ligne du jeu d'importation, sélectionnez le numéro de ligne du jeu d'importation.  
   {#use-etl-transform-map-consumers__substeps_uzy_4kx_cyb}
4. Créez un consommateur de carte de transformation pour consommer des données.
   1. Accédez à la ToutCentre d'intégrationConsommateursConsommateur de carte de transformation.
   2. Sélectionnez Nouveau.
   3. Dans le formulaire Consommateur de carte de transformation Kafka, saisissez un nom dans le champ Nom .
   4. Pour le champ Transform Map (Carte de transformation ), sélectionnez une carte de transformation existante.  
   5. Enregistrez le formulaire.
   6. [Créer un flux Kafka](https://servicenow-prod.fluidtopics.net/DoLarXwTOWrH3FzYJ47DaA "Définissez un flux de données pour un consommateur d’extraction, de transformation (ETL), de carte de transformation ou de script. Un flux Kafka définit le flux de données vers votre consommateur.") pour le consommateur.
   7. Sur le formulaire Flux Kafka, définissez les valeurs de champ suivantes.  
      * Nom du <kbd class="ph userinput">flux de la carte de transformation</kbd>.
      * Rubrique de la rubrique créée précédemment, topic2.
      * Concurrence maximale à <kbd class="ph userinput">1</kbd>.
      * Commencer à consommer dans Messages reçus après la première activation.
      * Gestion des messages à optimiser automatiquement.
      {#use-etl-transform-map-consumers__ul_u4q_1wm_2yb}
   8. Sélectionnez le lien Activer sous Liens connexes.  
      Vous devriez être en mesure de voir l'abonnement activé.  
   {#use-etl-transform-map-consumers__substeps_yt5_vkx_cyb}
5. Publiez des messages dans la rubrique 2.
   1. Exécutez la commande suivante pour publier des messages dans topic2.  

          bin/kafka-console-producer.sh --topic snc.<instance name>.topic2  --producer.config  config/bootcamp.properties  --bootstrap-server <instance name>.service-now.com:4000,<instance name>.service-now.com:4001,<instance name>.service-now.com:4002,<instance name>.service-now.com:4003

      Assurez-vous de remplacer `<nom d'instance>` par le nom de votre instance.

      Cette commande vous invite à entrer des messages.
   2. Envoyez le message JSON suivant.  

          {"city":"San Diego","name":"Jhon","id":"SN001","state":"California"}

      Vous pouvez envoyer ce message avec n'importe quelle valeur, mais la clé du message JSON doit correspondre aux étiquettes de la table Jeu d'importation.
   3. Accédez au consommateur de carte de transformation que vous avez créé.  
      Au bout d'une minute environ, les données doivent avoir été importées via le jeu d'importation.
   4. Pour afficher des informations détaillées sur le jeu d'importation, sélectionnez le numéro du jeu d'importation comme à l'étape 3d ci-dessus.
   {#use-etl-transform-map-consumers__substeps_t4b_clx_cyb}

## Que faire ensuite

[Utiliser l'étape Kafka Producer et l'API ProducerV2 pour publier des messages](https://servicenow-prod.fluidtopics.net/On4Nwe13~jBDk6qqsN7_Fw "Transférez les données vers ServiceNow Hermes afin que les consommateurs Kafka puissent les lire.").