Azure DevOps

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

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

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

Zugriffsanforderungen

Erweitern Sie , um die Zugriffsanforderungen für die -Funktion in diesem Artikel anzuzeigen.

Sie müssen über folgenden Zugriff verfügen, um die Funktion in diesem Artikel verwenden zu können:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront-Paket Beliebig
Adobe Workfront-Lizenz

Neu: Standard

Oder

Aktuell: Arbeit oder höher

Lizenz für Adobe Workfront Fusion**

Aktuell: Keine Workfront Fusion-Lizenzanforderung

Oder

Legacy: Workfront Fusion für Arbeitsautomatisierung und -integration

Produkt

Neu:

  • Prime oder Workfront auswählen: Ihr Unternehmen muss Adobe Workfront Fusion erwerben.
  • Ultimate Workfront-Paket: Workfront Fusion ist enthalten.

Oder

Aktuell: Ihr Unternehmen muss Adobe Workfront Fusion erwerben.

Weitere Informationen 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
    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 zeigt Workfront Fusion die unten aufgeführten Felder an. Darüber hinaus können abhängig von Faktoren wie Ihrer Zugriffsebene in der App oder dem Service weitere Azure DevOps angezeigt werden. Ein fett gedruckter Titel in einem Modul gibt ein erforderliches Feld an.

Wenn die Zuordnungsschaltfläche ü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 von einem Modul zu einem anderen.

Umschalter für Zuordnung

Trigger

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 Datensatz 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

Datensatz 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.
Datensatztyp

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, die von den anderen Azure DevOps nicht durchgeführt werden kann.

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.
-Kopfzeilen

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"}

body

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

Hinweis:

Wenn Sie bedingte Anweisungen wie if in Ihrer JSON-Datei 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.

Sie geben die ID des Datensatzes an.

Das Modul gibt die ID des Datensatzes 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.
Datensatztyp

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.
Source-Datei
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.
Limit
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
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3