Guide de démarrage rapide de la définition ETL

Rversion finale: Australia

Mis à jour 12 mars 2026

4 minutes de lecture

Découvrez comment configurer et utiliser une définition ETL pour importer des données dans ServiceNow des tables.

Avant de commencer

Rôle requis : admin

Pour ce guide de démarrage rapide, nous allons importer des données dans le fichier JSON suivant vers des ServiceNow tables cibles. Ce fichier JSON contient des données hiérarchiques pour une école, des classes, des élèves et des matières. Enregistrez le contenu suivant dans un fichier JSON.


[{ 
   "name": "schoolA", 
   "classes": [ 
   { 
    "name": "classA", 
    "students": [ 
    {"name": "studentA", "subjects": [{"name": "subjectA", "marks": 80}, 
     {"name": "subjectB", "marks": 90},{"name": "subjectC", "marks": 100}]}, 
    {"name": "studentB", "subjects": [{"name": "subjectA", "marks": 75}, 
     {"name": "subjectB", "marks": 85}, {"name": "subjectC", "marks": 95}]}
   ] 
  },{ 
   "name": "classB", 
   "students": [ 
   {"name": "studentC", "subjects": [{"name": "subjectA", "marks": 60}, 
    {"name": "subjectB", "marks": 70}, {"name": "subjectC", "marks": 80}]}, 
   {"name": "studentD", "subjects": [{"name": "subjectA", "marks": 55}, 
    {"name": "subjectB", "marks": 65}, {"name": "subjectC", "marks": 75}]} 
   ] 
  } 
 ] 
}]

Procédure

Créez une source de données et chargez les données.
1. Créez une source de données au formatJSON et avec le chemin d’accès de chaque ligne sous la forme .
2. Cochez l’option Données en colonne unique .
3. Enregistrez la source de données.
4. Joignez le fichier JSON ci-dessus à la source de données.
5. Sélectionnez Charger tous les enregistrements pour charger des enregistrements dans la table de jeux d’importation.
6. Ouvrez la ligne de jeu d’importation créée.
  L’enregistrement doit être enregistré dans une seule colonne JSON.
Créez la structure de table cible pour importer des données.
1. Dans cet exemple, nous avons une école avec plusieurs classes, chaque classe a plusieurs élèves et chaque élève a plusieurs matières.
2. Créez une structure de tableau pour refléter ces relations.
3. School -> nom : string.
4. Classe -> nom : string , school : référence à l’école.
5. Étudiant -> nom : chaîne, classe : référence à la classe.
6. Sujet -> nom : chaîne, marque : entier, étudiant : référence à l’élève.
Créez une définition ETL pour mapper les données d’enregistrement JSON aux tables cibles.
1. Accéder à Ensembles de données système à importer > Définition ETL.
2. Sélectionnez Nouveau.
3. Entrez un nom et enregistrez l’enregistrement.
Créer des entités.
1. Sous l’onglet Entités ETL, sélectionnez Nouveau.
2. Définissez le nom comme Ensemble d’importation et enregistrez.
3. Ajoutez des champs d’entité de jeu d’importation pour toutes les valeurs terminales du JSON.
  Le field/path est le chemin à partir de la racine du JSON et nous marquons les tableaux avec [*].
4. Accédez à Définition ETL et sous Entités ETL, sélectionnez Nouveau.
5. Définissez le nom comme école.
6. Définissez la table comme table de l’école créée à l’étape 2.
7. Définissez le chemin comme l’école.
8. Enregistrez l’entité.
9. Sélectionnez Générer les champs sous Liens connexes.
  Cela devrait générer le champ Name (Nom ). Définissez la fusion sur vrai.
10. Accédez à Définition ETL et sous Entités ETL, sélectionnez Nouveau.
11. Définissez la table en tant que table de classe créée à l’étape 2.
12. Définissez le chemin en tant que classe[*].
  L’utilisation de [*] en fait une entité avec plusieurs lignes.
13. Sélectionnez Générer les champs sous Liens connexes.
14. Étant donné que l’école dans les champs Entité ETL est un champ de référence, remplacez le champ/chemin par school.name et définissez Fusion sur vrai pour le champ Nom , car le nom est unique.
15. Ajoutez également des entités à l’élève et à la matière.
  Pour l’objet, définissez Coalescence sur vrai pour les champs Nom et Étudiant .
Ajouter des mappages d’entités RTE.
1. Accédez à Mappages d’entités RTE et sélectionnez Nouveau.
2. Définir le nom à importer Définir sur l’école.
3. Définissez l’entité source sur Jeu d’importation.
4. Définissez l’entité cible sur École.
5. Conservez la commande à 100.
6. Sous Mappages de champs RTE, sélectionnez Nouveau.
7. Pour le champ Source, sélectionnez Nom de l’école.
  Vous ne pouvez sélectionner que les champs d’entité de l’entité source.
8. Pour le champ Cible, sélectionnez Nom.
  Vous ne pouvez sélectionner les champs Entité que de l’entité cible.
9. Accédez à Définition ETL et sous Mappages d’entités RTE, sélectionnez Nouveau.
10. Définir le nom sur Import Set to class (Classe).
11. Sélectionnez l’entité source pour importer le jeu.
12. Sélectionnez l’entité cible à classer.
13. Définissez la commande sur 200.
14. Ajoutez les mappages de champs RTE pour mapper le nom et le nom de l’établissement.
  Le champ cible de l’école doit correspondre au nom de l’école du jeu d’importation. Le système effectue une recherche de l’école à l’aide de cette valeur et définit la référence d’école correcte.
15. Ajoutez également des mappages pour l’élève et la matière.
Créez un enregistrement de transformateur de jeu d’importation robuste et exécutez l’importation.
1. Accédez à la source de données créée à l’étape 1.
2. Sélectionnez l’onglet Transformateur robuste et sélectionnez Nouveau.
3. Définissez un nom.
4. Définissez la définition du transformateur sur la définition ETL que nous avons créée précédemment.
5. Définissez Verbose.
  Aucune sélection détaillée n’est nécessaire, mais vous permet de déboguer la configuration. Désactivez-le avant de passer en production, car cela peut avoir un impact négatif sur les performances.
6. Sélectionnez Envoyer.
7. Sélectionnez Charger tous les enregistrements.
8. Sélectionnez Exécuter la transformation robuste.
9. Sélectionnez Transformer.
10. Accédez au jeu d’importation.
11. Sélectionnez l’onglet Lignes de jeu d’importation et ouvrez l’enregistrement de la ligne du jeu d’importation.
12. Si la configuration fonctionne correctement, elle doit afficher l’enregistrement de la ligne de l’ensemble de données à importer avec tous les enregistrements insérés.