Ajouter des champs personnalisés pour une intégration d'outil de planification

Ajoutez des champs personnalisés dans votre intégration d’outil de planification pour améliorer la configurabilité et accéder aux informations spécifiques à l’entreprise, ce qui facilite une prise de décision plus éclairée.

Avant de commencer

Rôle requis : sn_devops.admin

Pourquoi et quand exécuter cette tâche

Vous pouvez ajouter des champs personnalisés à une intégration d’outil de planification à l’aide de transformateurs d’enregistrement. Créez des transformateurs d’enregistrement pour chaque action de l’outil et ajoutez des règles de transformateur d’enregistrement pour mapper les champs de votre outil aux champs du modèle de données DevOps. Par exemple, imaginez un scénario où l’ID de l’élément Azure DevOps de travail est défini comme « adoid » pendant le processus d’importation. Si vous souhaitez l’aligner sur l’ID de l’élément de travail ServiceNow, vous pouvez le faire en créant un transformateur d’enregistrement pour l’action d’importation. Dans ce transformateur, vous devez établir des règles pour mapper le champ « AOID » au champ ID de l’élément de travail ServiceNow correspondant. Une fois le mappage de champs créé, chaque fois qu’un événement entrant est reçu d’Azure DevOps pour apporter des éléments de travail, les données sont traitées via le transformateur configuré dans la charge utile transformée.

Remarque :

Cette fonctionnalité n’est disponible que pour les intégrations d’outils de type plan du système de base, à l’exception de ServiceNow Agile Development 2.0.

Procédure

1. Accédez à la Espaces de travail > Espace de travail de changement DevOps > Administration.
2. Sélectionnez Intégrations > Intégrations d’outils dans l’onglet Listes.
3. Sélectionnez l’intégration de l’outil de planification pour laquelle vous souhaitez ajouter des champs personnalisés, puis sélectionnez Modifier les mappages de champs.
   Remarque :

   Vérifiez que le périmètre de l’application est sélectionné comme Intégrations DevOps.
4. Sur la page Modifier les mappages de champs, sélectionnez le bouton Créer un transformateur d’enregistrement dans la section Transformation de l’aptitude de planification.
   Remarque :

   Vous devez créer un transformateur d’enregistrement pour chaque action de l’outil. Dans cette procédure, un transformateur d’enregistrement est créé pour l’action d’importation.

   1. Sur la page Créer un transformateur d’enregistrement, sélectionnez Créer une séquence de transformateur.
   2. Sur la page Créer une séquence de règle de transformateur d’enregistrement, saisissez le nom de la séquence de règle dans le champ Nom , puis sélectionnez le type de séquence dans le champ Type .
   3. Sélectionnez Enregistrer.
5. Accédez à la page d’enregistrement du transformateur, sélectionnez l’onglet Règles du transformateur d’enregistrement , puis sélectionnez Nouveau.
6. Sur la page Créer une règle de transformateur d’enregistrement, renseignez les champs suivants.

   Tableau 1. Créer une règle de transformateur d’enregistrement

   Champ	Description
   Nom	Nom de la règle dans la séquence.
   Symbole	Nom du champ dans la charge utile transformée vers lequel la valeur du champ personnalisé est extraite.
   Chemin d'accès	Chemin d’accès de la charge utile à partir duquel la valeur du champ personnalisé est récupérée.
   Ordre	Ordre dans lequel la règle doit être exécutée dans la séquence.
   Description	Texte expliquant la règle.

   Remarque :

   Plusieurs règles peuvent également être ajoutées à une colonne personnalisée à partir de la charge utile JSON et d’autres champs peuvent être mappés. Toutes les transformations ajoutées sont prises en compte dans la charge utile transformée.
7. Sélectionnez Enregistrer.
8. Accédez à la section Détails de l’enregistrement du transformateur et renseignez les champs suivants.

   Tableau 2. Transformateur de l'enregistrement

   Champ	Description
   Nom	Nom du transformateur de l’enregistrement.
   Chemin de base	Chemin d’accès à partir duquel lire la charge utile entrante.
   Description	Texte expliquant le transformateur d’enregistrement.
   Chemin de l'enregistrement	Chemin d’accès à l’écriture pour la charge utile transformée.
   Séquence de règle de transformateur d'enregistrement	Séquence de règles que vous souhaitez associer à ce transformateur d’enregistrement.
   Actif	Option permettant d’activer le transformateur d’enregistrement.

9. Sélectionnez Enregistrer.
10. Accédez à la page Modifier les mappages de champs et sélectionnez Ajouter un mappage.
    1. Sélectionnez le transformateur d’enregistrement pour l’action de l’outil.
    2. Définissez la séquence dans laquelle le mappage de l’enregistrement est traité dans le champ Commande .
    3. Sélectionnez un symbole si vous souhaitez mapper le transformateur d’enregistrement à différentes entités.
       Remarque :

       Le champ Symbole ici est différent du champ Symbole dans le formulaire Créer une règle de transformateur d’enregistrement à l’étape 6.
    4. Sélectionnez Enregistrer.

    Remarque :

    Vous pouvez ajouter plusieurs mappages de champs pour une action selon vos besoins.

Information associée

• Transformer - Scoped, Global