Fügen Sie anwenderdefinierte Felder für die Integration eines Planungstools hinzu

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 2 Minuten Lesedauer

    • Fügen Sie der Integration Ihres Planungstools anwenderdefinierte Felder hinzu, um die Konfigurierbarkeit zu verbessern und auf geschäftsspezifische Informationen zuzugreifen, um fundiertere Entscheidungen zu treffen.

    Vorbereitungen

    Erforderliche Rolle: sn_devops.admin

    Warum und wann dieser Vorgang ausgeführt wird

    Sie können einer Planungstool-Integration mithilfe von Datensatz-Umwandlern anwenderdefinierte Felder hinzufügen. Erstellen Sie Datensatzumwandler für jede Toolaktion, und fügen Sie Datensatzumwandlerregeln hinzu, um Felder in Ihrem Tool Feldern im DevOps-Datenmodell zuzuordnen. Betrachten Sie beispielsweise ein Szenario, in dem die Arbeitselement-ID Azure DevOps während des Importvorgangs als „Adoid“ definiert wird. Wenn Sie sie an der ServiceNow-Arbeitselement-ID ausrichten möchten, können Sie dies erreichen, indem Sie einen Datensatz-Umwandler für die Importaktion erstellen. In diesem Umwandler müssen Sie Regeln festlegen, um das Feld „Adoid“ dem entsprechenden ServiceNow-Arbeitselement-ID-Feld zuzuordnen. Nachdem die Feldzuordnung erstellt wurde, werden die Daten jedes Mal, wenn ein eingehendes Ereignis von Azure DevOps empfangen wird, um Arbeitselemente einzubeziehen, über den konfigurierten Umwandler in die transformierte Nutzlast verarbeitet.
    Hinweis:
    Diese Funktion ist nur für die Toolintegrationen des Basissystemplantyps verfügbar, mit Ausnahme von ServiceNow Agile Development 2.0.

    Prozedur

    1. Navigieren zu Arbeitsbereiche > DevOps – Change-Arbeitsbereich > Administration.
    2. Wählen Sie auf der Registerkarte Listen die Option Integrationen > Tool integrations (Integrationen > Toolintegrationen) aus.
    3. Wählen Sie die Integration des Planungstools aus, für die Sie anwenderdefinierte Felder hinzufügen möchten, und wählen Sie dann Feldzuordnungen bearbeitenaus. Toolintegrationsdatensatz
      Hinweis:
      Vergewissern Sie sich, dass DevOps Integrations (DevOps-Integrationen) als Anwendungsbereich ausgewählt ist.
    4. Klicken Sie auf der Seite „Feldzuordnungen bearbeiten“ im Abschnitt „Transformation der Planungsfähigkeit“ auf die Schaltfläche Datensatz-Umwandler erstellen.
      Hinweis:
      Sie müssen für jede Toolaktion einen Datensatz-Umwandler erstellen. In diesem Verfahren wird ein Datensatz-Umwandler für die Importaktion erstellt.
      1. Wählen Sie auf der Seite „Neuen Datensatz-Umwandler erstellen “ die Option Transformatorsequenz erstellen aus. Seite „Neuen Datensatz-Umwandler erstellen“.
      2. Geben Sie auf der Seite „Neuen Datensatz-Umwandler erstellen – Regelsequenz“ den Namen der Regelsequenz in das Feld Name ein, und wählen Sie den Typ der Sequenz im Feld Typ aus. Sequenzseite für neue Datensatz-Umwandlerregel erstellen
      3. Wählen Sie Speichern.
    5. Navigieren Sie zur Datensatzseite des Transformators, wählen Sie die Registerkarte Datensatz-Umwandlerregeln und dann Neuaus. Registerkarte „Datensatz-Umwandler-Regeln“ im Datensatz-Umwandler-Datensatz
    6. Füllen Sie auf der Seite „Neue Datensatz-Umwandlerregel erstellen“ die folgenden Felder aus. Neue Datensatz-Umwandlerregelseite erstellen
      Tabelle : 1. Neue Datensatz-Umwandlerregel erstellen
      Feld Beschreibung
      Name Name der Regel in der Sequenz.
      Symbol Name des Felds in der transformierten Nutzlast, bis in das der Wert des anwenderdefinierten Felds extrahiert wird.
      Pfad Nutzlastpfad, aus dem der Wert des anwenderdefinierten Felds abgerufen wird.
      Auftrag Reihenfolge, in der die Regel in der Sequenz ausgeführt werden muss.
      Beschreibung Text, der die Regel erklärt.
      Hinweis:
      Einer benutzerdefinierten Spalte können aus der JSON-Nutzlast mehrere Regeln hinzugefügt werden, und es können weitere Felder zugeordnet werden. Alle hinzugefügten Transformationen werden in der transformierten Nutzlast berücksichtigt.
    7. Wählen Sie Speichern.
    8. Navigieren Sie zum Abschnitt Details des Transformatordatensatzes, und füllen Sie die folgenden Felder aus.
      Tabelle : 2. Datensatz-Umwandler
      Feld Beschreibung
      Name Name des Datensatz-Umwandlers
      Basispfad Pfad, aus dem für die eingehende Nutzlast gelesen werden soll.
      Beschreibung Text, der den Datensatz-Umwandler erklärt.
      Datensatzpfad Schreibpfad für die transformierte Nutzlast.
      Regelsequenz des Datensatztransformators Regelsequenz, die diesem Datensatz-Umwandler zugeordnet werden soll.
      Aktiv Option zum Aktivieren des Datensatz-Umwandlers.
    9. Wählen Sie Speichern.
    10. Navigieren Sie zur Seite „Feldzuordnungen bearbeiten“, und wählen Sie Zuordnung hinzufügenaus. Seite „Feldzuordnungen bearbeiten“.
      1. Wählen Sie den Datensatz-Umwandler für die Toolaktion aus.
      2. Legen Sie im Feld Reihenfolge die Reihenfolge fest, in der die Zuordnung des Datensatzes verarbeitet wird.
      3. Wählen Sie ein Symbol aus, wenn Sie den Datensatz-Umwandler verschiedenen Entitäten zuordnen möchten.
        Hinweis:
        Das Feld Symbol unterscheidet sich hier vom Feld Symbol im Formular „Umwandlerregel für neuen Datensatz erstellen“ in Schritt 6.
      4. Wählen Sie Speichern.
      Hinweis:
      Sie können je nach Anforderung mehrere Feldzuordnungen für eine Aktion hinzufügen.