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

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 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 SGC Excel.

    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 apporter des modifications à l’include de script, ajouter des mappages de classes ou de champs et apporter des modifications à l’ETL.
    • cmdb_inst_admin : permet uniquement d’ajouter de nouveaux mappages de classes ou de champs et d’apporter des modifications dans l’ETL.

    Procédure

    1. Une fois qu’une colonne personnalisée est créée dans la table intermédiaire, accédez à Tout > Administrateur de l'espace de travail industriel > Gestionnaire OT > Importer des appareils OT : table de stockage 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 d’entrée de feuille de calcul OT préalable à l’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 Tout > Administrateur de l'espace de travail industriel > Gestionnaire OT > Importer des appareils OT : includes 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 « < Nom de colonne ETL > » : « <Nom de colonne de la table intermédiaire> ».

      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 (,) 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 ».

      Nom de colonne ETL mis à jour avec SGOTAssetImportExcelConstants.
    7. Sélectionnez Mettre à jour pour enregistrer vos changements.
    8. Accédez à la Tout > 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.
      Sélectionnez l’étape 1 : fournissez 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 champ 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.
      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. Sur la page Assistant de carte de transformation ETL, dans la section Mapper les données au 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 de cmdb_ci_hardware matériel. Une fois ce champ mappé, le champ « commentaire » sur les 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 cmdb_ci_hardware matériel, mais qui est plutôt un champ dans la classe Technologie opérationnelle (cmdb_ci_ot), vous ajouterez le mappage de champs dans le talon Technologie opérationnelle (OT) 1.

      1. Ajoutez un mappage de champ à la classe Matériel 1.
      2. Pour la classe Matériel 1, sélectionnez 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 le matériel 1 classe : 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 pour voir le champ.
      Nouveau champ de commentaires ajouté.
    21. Dans le volet Données, faites glisser la pastille de données vers le champ Colonne de source de commentaires.
      Mapper vers le matériel.
      Vous pouvez également sélectionner l’icône de colonne source ( 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.
      Champ Colonne source rempli d’une pastille de données.
    22. Revenez aux classes CMDB pour mapper les données sources de la section Mapper les données au CMDB et ajouter des relations dans la page Assistant de carte de transformation ETL.
      Revenez à la page Classes CMDB pour mapper les 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 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.
        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 commentaire est mis à jour dans la table intermédiaire.
      5. Sélectionnez Marquer comme terminé.
        Une fois que les résultats de l’intégration de test et de restauration s’exécutent avec succès, confirmez que la feuille 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 champs de colonne est ajouté et vérifié avec succès.