Ajouter un mappage de champs personnalisé dans la table intermédiaire pour Graphe de services

  • Rversion finale: Washingtondc
  • Mis à jour 7 févr. 2024
  • 4 minutes de lecture

    • Ajoutez un champ personnalisé à la table intermédiaire et mappez le champ personnalisé de la table intermédiaire au champ CI via Excel SGC.

    Avant de commencer

    Pour configurer la mise en page du formulaire, reportez-vous à la rubrique Configurer la mise en page du formulaire.

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

    Rôles requis :
    • admin : peut apporter des modifications dans le script include, ajouter des mappages de classes ou de champs et apporter des modifications dans l’ETL.
    • cmdb_inst_admin : peut uniquement ajouter de nouveaux mappages de classes ou de champs et effectuer des changements dans l’ETL.

    Procédure

    1. Une fois qu’une colonne personnalisée est créée dans la table intermédiaire, accédez à Tous > Administrateur de l'espace de travail industriel > Gestionnaire OT > Importer des appareils OT : table intermédiaire.
    2. Téléchargez le modèle Excel.
      Pour plus d’informations, voir Télécharger un modèle Excel.

      Si des enregistrements sont présents dans la table intermédiaire, vous pouvez modifier la valeur de la colonne dans les enregistrements existants.

    3. Préparez le modèle Excel.
      Pour plus d’informations, consultez Préparation de votre outil d’examen des entrées de feuille de travail OT avant importation pour l’importation de Connecteur du graphe de services.
    4. Importez le modèle Excel.
      Pour plus d’informations, voir Importer un modèle Excel.
    5. Accédez à la Tous > Administrateur de l'espace de travail industriel > Gestionnaire OT > Importer des appareils OT : includes de script et sélectionnez le script include SGOTAssetImportExcelConstants .
    6. Dans le script, mettez à jour le nouveau nom de colonne à partir de la table intermédiaire, ainsi que 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 » précédant le symbole deux-points ( : ) indique le nom de colonne ETL (affiché sous la forme d’une colonne dans l’étape d’aperçu ETL) et le « u_my_custom_field » après le deux-points indique le nom de colonne dans la table intermédiaire.

      Assurez-vous qu’une virgule (,) est 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 ».

      Mise à jour du nom de colonne ETL avec SGOTAssetImportExcelConstants.
    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 fournir les détails de base.
      Sélectionnez l’étape 1 : fournir des informations de base pour la carte de transformation ETL.
    12. Dans le champ Exemple de jeu d’importation , sélectionnez Extraire automatiquement un nouveau jeu d’importation.
      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. Dans la page Assistant de carte de transformation ETL, dans la section Préparer les données sources pour le mappage, sélectionnez Prévisualiser et préparer les données.
      Prévisualisez et préparez les données.
      Si la colonne n’est pas visible, répétez les étapes 11 à 14.
    16. Sélectionnez Marquer comme terminé.
    17. À partir de la page Assistant de carte de transformation ETL, dans la section Mapper les données à CMDB et ajouter des relations, sélectionnez Classes CMDB pour mapper les données source.
    18. Mappez la colonne à la classe et à l’attribut cibles.

      Par exemple, le champ « commentaires » est présent sur la classe Hardware cmdb_ci_hardware . Une fois ce champ mappé, le champ « commentaire » des classes enfants de matériel est également mis à jour, tant que la valeur de la colonne « commentaires » dans la table intermédiaire pour 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 en fait un champ de la classe Technologie opérationnelle (cmdb_ci_ot), vous devez ajouter le mappage de champ dans le stub Technologie opérationnelle (OT) 1.

      1. Ajoutez un mappage de champs à la classe Matériel 1.
      2. Pour la classe Hardware 1, sélectionnez Edit Mapping (Modifier le mappage).
        Sélectionner des classes CMDB pour mapper des données sources
    19. Dans la boîte de dialogue Ajouter un attribut qui s’affiche, dans la liste Attribut , sélectionnez Commentaires.
      Mapper la classe Matériel 1 - Boîte de dialogue Ajouter un attribut.
    20. Sélectionnez Enregistrer.
      Un nouveau champ nommé « Commentaires » s’affiche. Vous devrez peut-être faire défiler l’écran pour voir le champ.
      Ajout d’un nouveau champ de commentaires.
    21. Dans le volet Données, faites glisser la pastille de données vers le champ Colonne de la source des commentaires.
      Mappez vers le matériel.
      Vous pouvez également sélectionner l’icône de colonne source ( icône Colonne source.) pour sélectionner le champ de mappage de données correspondant.
      La colonne Source inclut la pastille de données.
      Champ de colonne source rempli d’une pastille de données.
    22. Revenez à la section Classes CMDB pour mapper les données sources de la CMDB à CMDB et ajouter des relations dans la page Assistant de carte de transformation ETL.
      Revenez à la page Classes CMDB pour mapper des données sources.
    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 de résultats d’intégration et planifier l’importation de la configuration guidée, sélectionnez Résultats d’intégration de test et de restauration.
        Assistant de carte de transformation ETL : 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, vérifiez 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é.
        Une fois que les résultats d’intégration de test et de restauration sont exécutés avec succès, confirmez que la feuille de calcul Excel est mise à jour.
      6. Sélectionnez Effectuer une restauration.
        Sélectionnez Effectuer une restauration.
      7. Si l’ETL n’est pas activé, sélectionnez Activer.
      Le nouveau mappage de champ de colonne est ajouté et vérifié avec succès.