Azure DevOps-Module

In einem Adobe Workfront Fusion-Szenario können Sie Workflows automatisieren, die Azure DevOps verwenden, und diese mit verschiedenen Anwendungen und Services von Drittanbietern verbinden.

Anweisungen zum Erstellen eines Szenarios finden Sie in den Artikeln unter Erstellen von Szenarios: Artikelindex.

Informationen zu Modulen finden Sie in den Artikeln unter Module: Artikelindex.

Zugriffsanforderungen

Erweitern, um die Zugriffsanforderungen für die in diesem Artikel beschriebene Funktionalität anzuzeigen.
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront-Paket

Ein beliebiges Adobe Workfront Workflow- und Adobe Workfront Automation and Integration-Paket

Workfront Ultimate

Workfront Prime- und Select-Pakete bei zusätzlichem Kauf von Workfront Fusion.

Adobe Workfront-Lizenzen

Standard

Work oder höher

Adobe Workfront Fusion-Lizenz

Betriebsbasiert: keine Workfront Fusion-Lizenz erforderlich

Connector-basiert (veraltet): Workfront Fusion for Work Automation and Integration

Produkt Wenn Ihre Organisation über ein Workfront Select- oder Prime-Paket ohne Workfront Automation and Integration verfügt, muss Ihre Organisation Adobe Workfront Fusion erwerben.

Weitere Details zu den Informationen in dieser Tabelle finden Sie unter Zugriffsanforderungen in der Dokumentation.

Informationen zu Adobe Workfront Fusion-Lizenzen finden Sie unter Adobe Workfront Fusion-Lizenzen.

Voraussetzungen

Um Azure DevOps Module verwenden zu können, müssen Sie über ein Azure DevOps-Konto verfügen.

Azure DevOps API-Informationen

Der Azure DevOps-Connector verwendet Folgendes:

API-Version
v5.1
API-Tag
v1.29.33

Verbinden von Azure DevOps mit Workfront Fusion connect-azure-devops-to-workfront-fusion

  1. Fügen Sie Ihrem Szenario ein Azure DevOps hinzu.

  2. Klicken Sie Hinzufügen neben dem Feld Verbindung.

  3. Wählen ​ im Feld ​ den Verbindungstyp aus, den Sie verwenden möchten.

    note
    NOTE
    Mit der Azure DevOps (EntraApp können Sie alle Bereiche für die Verbindung anfordern.
  4. Füllen Sie die folgenden Felder aus:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
    Verbindungsname Geben Sie einen Namen für die Verbindung ein, die Sie erstellen.
    Organisation Geben Sie den Namen der Organisation ein, unter der Sie Ihr Azure DevOps-Programm erstellt haben.
    App-ID Geben Sie die ID der DevOps-Anwendung ein, mit der Sie eine Verbindung herstellen.
    Client-Geheimnis Geben Sie das Client-Geheimnis für die DevOps-Anwendungen ein, mit denen Sie eine Verbindung herstellen.
    , alle Bereiche anfordern Wenn Sie den Verbindungstyp Azure DevOps (EntraApp) verwenden, aktivieren Sie diese Option, um alle Bereiche für die Verbindung anzufordern.
  5. Um eine Azure DevOps-App-ID oder einen geheimen Client-Schlüssel einzugeben, klicken Sie auf Erweiterte Einstellungen anzeigen und geben Sie diese in die sich öffnenden Felder ein.

  6. Klicken Sie Fortfahren, um die Einrichtung der Verbindung abzuschließen und mit der Erstellung Ihres Szenarios fortzufahren.

Azure DevOps-Module und ihre Felder

Beim Konfigurieren von Azure DevOps-Modulen werden in Workfront Fusion die unten aufgeführten Felder angezeigt. Darüber hinaus können abhängig von Faktoren wie Ihrer Zugriffsebene in der Anwendung oder im Service weitere Azure DevOps-Felder angezeigt werden. Ein fett formatierter Titel in einem Modul kennzeichnet ein Pflichtfeld.

Wenn die Schaltfläche „Zuordnung“ über einem Feld oder einer Funktion angezeigt wird, können Sie damit Variablen und Funktionen für dieses Feld festlegen. Weitere Informationen finden Sie unter Zuordnen von Informationen zwischen Modulen.

Umschalter „Zuordnung“

Auslöser

Auf Arbeitselemente ​

Dieses Instant Trigger-Modul führt ein Szenario aus, wenn ein Datensatz in Azure DevOps} hinzugefügt, aktualisiert oder gelöscht ​.

Das Modul gibt alle Standardfelder zurück, die mit dem Eintrag verknüpft sind, sowie alle benutzerdefinierten Felder und Werte, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.

Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.

Webhook

Webhook für das Modul auswählen oder hinzufügen.

Weitere Informationen zu Webhooks in Trigger-Modulen finden Sie unter Instant Trigger (Webhooks).

Informationen zum Erstellen eines Webhooks finden Sie unter Webhooks.

Aktionen

Eintrag erstellen

Dieses Aktionsmodul erstellt ein neues Projekt oder Arbeitselement.

Das Modul gibt die Objekt-ID für das neu erstellte Arbeitselement oder die URL und den Status-Code eines neu erstellten Projekts aus.

Verbindung
Anweisungen zum Verbinden Ihres Azure DevOps-Kontos mit Workfront Fusion finden Sie unter Verbinden von Azure DevOps mit Workfront Fusion in diesem Artikel.
Eintragstyp

Wählen Sie aus, ob Sie ein Arbeitselement oder ein Projekt erstellen möchten.

  • -Projekt

    Füllen Sie die folgenden Felder aus:

    • Name: Geben Sie einen Namen für das neue Projekt ein oder ordnen Sie ihn ihm zu.

    • Description: Geben Sie eine Beschreibung für das neue Projekt ein oder ordnen Sie sie zu.

    • Sichtbarkeit: Wählen Sie aus, ob Ihr Projekt öffentlich oder privat sein soll. Benutzer müssen bei Ihrer Organisation angemeldet sein und Zugriff auf das Projekt erhalten haben, damit sie mit einem privaten Projekt interagieren können. Öffentliche Projekte sind für Benutzer sichtbar, die nicht bei Ihrer Organisation angemeldet sind.

    • Versionskontrolle: Wählen Sie aus, ob das Projekt Git oder Team Foundation Version Control (TFCV) für die Versionskontrolle verwenden soll.

    • Arbeitselementprozess: Wählen Sie den Arbeitsprozess aus, den Sie für das Projekt verwenden möchten. Die Optionen sind Basic, Scrum, Capability Maturity Model Integration (CMMI) und Agile.

      Weitere Informationen zu Azure DevOps-Prozessen finden Sie unter Standardprozesse und Prozessvorlagen in der Azure DevOps.

  • Arbeitselement

    Füllen Sie die folgenden Felder aus:

    • Project: Wählen Sie das Projekt aus, in dem Sie das Arbeitselement erstellen möchten.

    • Arbeitsaufgabentyp: Wählen Sie den Typ des Arbeitselements, das Sie erstellen möchten.

    • Andere Felder: Geben Sie in diesen Feldern den Wert ein, den das Arbeitselement für eine bestimmte Eigenschaft haben soll. Die verfügbaren Felder hängen vom Typ des Arbeitselements ab.

Benutzerdefinierter API-Aufruf

Mit diesem Aktionsmodul können Sie einen benutzerdefinierten authentifizierten Aufruf an die Azure DevOps-API durchführen. Auf diese Weise können Sie eine Datenflussautomatisierung erstellen, was über die anderen Azure DevOps-Module nicht möglich ist.

Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.

Verbindung
Anweisungen zum Verbinden Ihres Azure DevOps-Kontos mit Workfront Fusion finden Sie unter Verbinden von Azure DevOps mit Workfront Fusion in diesem Artikel.
Basis-URL
Wählen Sie die Basis-URL aus, mit der Sie eine Verbindung zu Ihrem Azure DevOps-Konto herstellen, oder ordnen Sie sie zu
relative URL

Geben Sie die relative URL ein, mit der Sie sich für diesen API-Aufruf verbinden möchten.

Beispiel: {organization}/_apis[/{area}]/{resource}

API-Version
Wählen Sie die Version der Azure DevOps-API aus, mit der Sie sich für diesen API-Aufruf verbinden möchten, oder ordnen Sie sie zu. Wenn keine Version ausgewählt ist, stellt Workfront Fusion eine Verbindung zu Azure DevOps API-Version 5.1 her.
Methode
Wählen Sie die HTTP-Anfragemethode aus, die Sie zum Konfigurieren des API-Aufrufs benötigen. Weitere Informationen finden Sie unter HTTP-Anfragemethoden.
Header

Fügen Sie die Header der Anfrage in Form eines standardmäßigen JSON-Objekts hinzu.

Beispiel: {"Content-type":"application/json"}

Abfragezeichenfolge

Fügen Sie die Abfrage für den API-Aufruf in Form eines standardmäßigen JSON-Objekts hinzu.

Beispiel: {"name":"something-urgent"}

Text

Fügen Sie den Textinhalt für den API-Aufruf in Form eines standardmäßigen JSON-Objekts hinzu.

Hinweis:

Wenn Sie bedingte Anweisungen wie if in Ihrem JSON-Objekt verwenden, setzen Sie die Anführungszeichen außerhalb der bedingten Anweisung.

Anlage herunterladen

Dieses Aktionsmodul lädt eine Anlage herunter.

Das -Modul gibt den Dateiinhalt des Anhangs zurück.

Verbindung
Anweisungen zum Verbinden Ihres Azure DevOps-Kontos mit Workfront Fusion finden Sie unter Verbinden von Azure DevOps mit Workfront Fusion in diesem Artikel.
Anhang URL
Geben Sie die URL des Anhangs ein, den Sie herunterladen möchten, oder mappen Sie sie.

Arbeitselemente verknüpfen

Dieses Aktionsmodul verknüpft zwei Arbeitselemente und definiert die Beziehung zwischen ihnen.

Verbindung
Anweisungen zum Verbinden Ihres Azure DevOps-Kontos mit Workfront Fusion finden Sie unter Verbinden von Azure DevOps mit Workfront Fusion in diesem Artikel.
Arbeitselement-ID
Geben Sie die ID des Hauptarbeitselements ein, mit dem Sie ein anderes Arbeitselement verknüpfen möchten, oder ordnen Sie sie zu.
ID des verknüpften Arbeitselements
Geben Sie die ID des Arbeitselements ein, das Sie mit dem Hauptarbeitselement verknüpfen möchten, oder ordnen Sie sie zu.
Link-Typ

Definieren Sie die Beziehung zwischen den Arbeitselementen, die Sie verknüpfen möchten.

Weitere Informationen finden Sie Referenzhandbuch für Link-Typen in der Azure DevOps-Dokumentation.

-Kommentar
Geben Sie den Text eines Kommentars ein oder mappen Sie ihn. Dies ist nützlich, um die Begründung oder Absicht des Links zu erklären.

Datensatz lesen

Dieses Aktionsmodul liest Daten aus einem einzelnen Datensatz in Azure DevOps.

Geben Sie die ID des Eintrags an.

Das Modul gibt daraufhin die ID des Eintrags und alle zugehörigen Felder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.

Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.

Verbindung
Anweisungen zum Verbinden Ihres Azure DevOps-Kontos mit Workfront Fusion finden Sie unter Verbinden von Azure DevOps mit Workfront Fusion in diesem Artikel.
Eintragstyp

Auswählen, ob ein Projekt oder ein Arbeitselement gelesen werden soll

  • Project: Wählen Sie das Projekt aus, das Sie lesen möchten.

  • Arbeitselement: Wählen Sie das Projekt aus, das das Arbeitselement enthält, das Sie lesen möchten, und wählen Sie dann den Arbeitselementtyp aus.

Ausgaben
Wählen Sie die Informationen aus, die im Ausgabepaket für dieses Modul enthalten sein sollen. Die verfügbaren Felder hängen vom Typ des Arbeitselements ab.
ID
Geben Sie die ID des Datensatzes ein, den Sie lesen möchten, oder mappen Sie sie.

Arbeitselement aktualisieren

Dieses Aktionsmodul aktualisiert ein vorhandenes Arbeitselement mithilfe seiner ID.

Das Modul gibt die ID des aktualisierten Arbeitselements zurück.

Verbindung
Anweisungen zum Verbinden Ihres Azure DevOps-Kontos mit Workfront Fusion finden Sie unter Verbinden von Azure DevOps mit Workfront Fusion in diesem Artikel.
Projekt
Wählen Sie das Projekt aus, das das Arbeitselement enthält, das Sie aktualisieren möchten.
Arbeitsaufgabentyp
Wählen Sie den Typ des Arbeitselements aus, das Sie aktualisieren möchten.
Andere Felder
Geben Sie in jedem dieser Felder den Wert ein, den das Arbeitselement für eine bestimmte Eigenschaft haben soll. Die verfügbaren Felder hängen vom Typ des Arbeitselements ab.
Arbeitselement-ID
Geben Sie die ID des Arbeitselements ein, das Sie aktualisieren möchten, oder mappen Sie sie.

Anlage hochladen

Dieses Aktionsmodul lädt eine Datei hoch und hängt sie an ein Arbeitselement an.

Das Modul gibt die Anlagen-ID und eine Download-URL für den Anhang zurück.

Verbindung
Anweisungen zum Verbinden Ihres Azure DevOps-Kontos mit Workfront Fusion finden Sie unter Verbinden von Azure DevOps mit Workfront Fusion in diesem Artikel.
Projekt
Wählen Sie das Projekt aus, in das Sie eine Anlage hochladen möchten.
Arbeitselement-ID
Geben Sie die ID des Arbeitselements ein, in das Sie eine Anlage hochladen möchten, oder ordnen Sie sie zu.
-Kommentar
Geben Sie den Text eines Kommentars ein, den Sie zum hochgeladenen Anhang hinzufügen möchten.
Quelldatei
Wählen Sie eine Quelldatei aus einem vorherigen Modul aus oder geben Sie den Namen und den Inhalt der Quelldatei ein oder mappen Sie ihn.

Suchvorgänge

Arbeitselemente auflisten

Dieses Aktionsmodul ruft alle Arbeitselemente eines bestimmten Typs in einem Azure DevOps Projekt ab.

Das Modul gibt die ID des Hauptarbeitselements und alle zugehörigen Felder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.

Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.

Verbindung
Anweisungen zum Verbinden Ihres Azure DevOps-Kontos mit Workfront Fusion finden Sie unter Verbinden von Azure DevOps mit Workfront Fusion in diesem Artikel.
Projekt
Wählen Sie das Projekt aus, aus dem Sie Arbeitselemente abrufen möchten.
Arbeitsaufgabentyp
Wählen Sie den Typ des Arbeitselements, das Sie abrufen möchten.
Ausgaben
Wählen Sie die Eigenschaften aus, die in der Modulausgabe angezeigt werden sollen. Die verfügbaren Felder hängen vom Typ des Arbeitselements ab, das Sie abrufen möchten. Sie müssen mindestens eine Eigenschaft auswählen.
Beschränkung
Geben Sie die maximale Anzahl von Arbeitselementen ein, die Workfront Fusion während eines Ausführungszyklus zurückgibt, oder mappen Sie sie.
recommendation-more-help
workfront-fusion-help-workfront-fusion