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

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 3 minutes de lecture

    • Ajoutez des champs personnalisés à l'intégration de votre outil de planification pour améliorer la configurabilité et accéder à des informations propres à 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, examinez un scénario où l'ID de l'élément de travail Azure DevOps est défini sur « adoid » pendant le processus d'importation. Si vous le souhaitez, vous pouvez l'aligner sur l'ID de l'élément de travail ServiceNow 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 « adoid » 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, excepté pour ServiceNow Développement agile 2.0.

    Procédure

    1. Accédez à la Espaces de travail > Espace de travail de changement DevOps > Administration.
    2. Dans l'onglet Listes, sélectionnez Intégrations > Intégrations d'outils.
    3. Sélectionnez successivement l'intégration de l'outil de planification pour laquelle vous souhaitez ajouter des champs personnalisés, puis Modifier les mappages de champs. Enregistrement de l'intégration d'outil
      Remarque :
      Vérifiez que le périmètre de l'application est défini sur Intégrations DevOps.
    4. Dans la page Modifier les mappages de champs, sélectionnez le bouton Créer un transformateur d'enregistrement dans la section Planifier la transformation de l'aptitude.
      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. Dans la page Create New Record Transformer (Créer un transformateur d'enregistrement), sélectionnez Créer une séquence de transformateur. Page Create New Record Transformer page (Créer un transformateur d'enregistrement)
      2. Dans la page Create New Record Transformer Rule Sequence (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. Page Create new record transformer rule sequence (Créer une séquence de règle de transformateur d'enregistrement)
      3. Sélectionnez Enregistrer.
    5. Accédez à la page d'enregistrement du transformateur, sélectionnez l'onglet Règles du transformateur d'enregistrement, puis Nouveau. Onglet Règles du transformateur d'enregistrement dans l'enregistrement du transformateur d'enregistrement
    6. Dans la page Create New Record Transformer Rule (Créer une règle de transformateur d'enregistrement), renseignez les champs suivants. Page Create new record transformer rule (Créer une règle de transformateur d'enregistrement)
      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 :
      vous pouvez ajouter également plusieurs règles à une colonne personnalisée à partir de la charge utile JSON et mapper d'autres champs. 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 d'enregistrement.
      Chemin de base Chemin d'accès en lecture pour la charge utile entrante.
      Description Texte expliquant le transformateur d'enregistrement.
      Chemin de l'enregistrement Chemin d'accès dans lequel écrire la charge utile transformée.
      Séquence de règle de transformateur d'enregistrement Séquence de règle 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. Page Modifier les mappages de champs
      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 Ordre.
      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 du 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.