Ajouter un mappage de champ personnalisé dans la table intermédiaire pour Connecteur du graphe de services pour Microsoft Excel

Avec , Connecteur du graphe de services pour Microsoft Excel ajoutez un champ personnalisé à la table intermédiaire et mappez le champ personnalisé au champ Élément de configuration (CI).

Avant de commencer

Pour configurer la mise en page du formulaire, voir Configurer la mise en page du formulaire.

Pour créer un champ personnalisé dans la table intermédiaire, consultez Ajouter et personnaliser un champ dans une table.

Rôles requis :

• admin : peut modifier l’include de script. Peut ajouter des mappages de classes ou de champs et modifier l’ETL.
• cmdb_inst_admin : permet uniquement d’ajouter de nouveaux mappages de classes ou de champs et de modifier l’ETL.

Procédure

1. Ajouter des colonnes personnalisées à la table Étape intermédiaire [sg_ot_excel_staging].
2. Accédez à Tout et, dans le champ Filtre , ajoutez sg_ot_excel_staging.list.
3. Sur votre clavier, appuyez sur Entrée.
4. Si nécessaire, créez manuellement des enregistrements en sélectionnant Nouveau.
5. Accédez à la Tous > Administrateur de l'espace de travail industriel > Gestionnaire OT > Importer des appareils OT : inclusions de script et sélectionnez l’include de script SGOTAssetImportExcelConstants .
6. Dans le script, mettez à jour le nouveau nom de colonne à partir de la table intermédiaire et le nouveau nom de colonne ETL à l’intérieur de l’objet SGOTAssetImportExcelConstants.importSetColumnsVsStagingColumnsMap au format « <ETL Column Name> » : « <Column Name from staging table> ».

   Dans cet exemple, le « u_my_custom_field » avant les deux-points ( : ) indique le nom de la colonne ETL (affiché sous la forme d’une colonne dans l’étape d’aperçu ETL) et le « u_my_custom_field » après les deux-points indique le nom de la colonne dans la table intermédiaire.

   Assurez-vous qu’une virgule (,) a été ajoutée à la fin de la ligne au-dessus de la nouvelle ligne. Dans cet exemple, une virgule est ajoutée après la ligne « custom_fields » : « custom_fields ».

   

7. Sélectionnez Mettre à jour pour enregistrer vos changements.
8. Accédez à la Tous > Configuration > Centre d'intégration ETL.
9. Sélectionnez l’application CMDB : ETL d’importation SG-OT Excel .
10. Si la page Données de mappage non valides détectées s’affiche, sélectionnez Fermer.
11. Dans l’Assistant de carte de transformation ETL, dans la section Spécifier les détails de base de la configuration guidée, sélectionnez Importer les données sources et fournissez les détails de base.
    
    
12. Dans le champ Exemple de jeu d’importation , sélectionnez Extraire automatiquement un nouveau jeu d’importation.
    
    
13. Sélectionnez Enregistrer.
    La bannière des informations de base enregistrées avec succès s’affiche.
14. Sélectionnez Marquer comme terminé.
15. Sur la page Assistant de carte de transformation ETL, dans la section Préparer les données sources au mappage, sélectionnez Prévisualiser et préparer les données.
    Si la colonne n’est pas visible, répétez les étapes 11 à 14.
16. Sélectionnez Marquer comme terminé.
17. Sur la page Assistant de carte de transformation ETL, dans la section Mapper les données à la CMDB et Ajouter des relations, sélectionnez Classes CMDB pour mapper les données sources.
18. Mappez la colonne à la classe et à l’attribut cibles.

    Par exemple, le champ Commentaires est présent sur la classe Matériel [cmdb_ci_hardware]. Une fois le champ mappé, le champ Commentaires sur les classes enfants Matériel est mis à jour si la valeur de la colonne Commentaires dans la table intermédiaire de cette ligne n’est pas vide.

    Si vous ajoutez un mappage pour un nouveau champ qui n’est pas présent, ou pour un champ qui n’est pas spécifique à la classe de cmdb_ci_hardware matériel, mais qui est plutôt un champ de la classe Technologie opérationnelle (cmdb_ci_ot), vous pouvez ajouter le mappage de champ dans le talon Technologie opérationnelle (OT) 1.

    1. Ajoutez un mappage de champ à la classe Matériel 1.
    2. Pour la classe Hardware 1 (Matériel) sélectionnez Edit Mapping (Modifier le mappage).
       
       
19. Dans la boîte de dialogue Ajouter un attribut qui s’affiche, dans la liste Attribut, sélectionnez Commentaires.
    
    
20. Sélectionnez Enregistrer.
    Un nouveau champ nommé « Commentaires » s’affiche.
    
    
21. Depuis le volet Data (Données), faites glisser la pastille de données vers le champComments Source Column (Colonne de source des commentaires).
    Vous pouvez également sélectionner l’icône de colonne source ( ) pour sélectionner le champ de mappage de données correspondant.
    La colonne Source inclut la pastille de données.
    
    
22. Revenez aux classes CMDB pour mapper les données sources de la section Mapper les données à la CMDB et Ajouter des relations dans la page Assistant de carte de transformation ETL.
    
    
23. Sélectionnez Marquer comme terminé.
24. Suivez ces étapes pour vérifier les nouveaux mappages de champs.
    1. Accédez à la page d’accueil de l’assistant de carte de transformation ETL.
    2. Dans la section Prévisualiser les échantillons des résultats d’intégration et l’importation du calendrier de la configuration guidée, sélectionnez Résultats d’intégration de test et de restauration.
       
       
    3. Sélectionnez Exécuter l’intégration.
    4. Une fois l’exécution terminée, confirmez que le champ Commentaires du CI pour lequel vous avez fourni une valeur de commentaires est mis à jour dans la table intermédiaire.
    5. Sélectionnez Marquer comme terminé.
    6. Sélectionnez Effectuer une restauration.
    7. Si l’ETL n’est pas activé, sélectionnez Activer.
    Le nouveau mappage de champs de colonne est ajouté et vérifié avec succès.