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

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

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

  2. Klicken Sie Add neben dem Feld Connection .

  3. Wählen Sie im Feld Connection Type die Option Azure DevOps aus.

    note important
    IMPORTANT
    Der Azure DevOps (Request All Scopes) Verbindungstyp wird in naher Zukunft nicht mehr unterstützt. Daher empfehlen wir, sie nicht zu verwenden.
  4. Füllen Sie die folgenden Felder aus:

    table 0-row-2 1-row-2 layout-auto html-authored no-header
    Connection name Geben Sie einen Namen für die Verbindung ein, die Sie erstellen.
    Organization Geben Sie den Namen der Organisation ein, unter der Sie Ihr Azure DevOps-Programm erstellt haben.
  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 auf Continue , um die Einrichtung der Verbindung abzuschließen und mit der Erstellung des Szenarios fortzufahren.

Azure DevOps Module und ihre Felder

Beim Konfigurieren Azure DevOps Module 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

Auslöser

Watch for work items

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

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

Create a record

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.

Connection
Anweisungen zum Verbinden Ihres Azure DevOps-Kontos mit Workfront Fusion finden Sie unter Verbinden von Azure DevOps mit Workfront Fusion in diesem Artikel.
Record type

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

  • Project

    Füllen Sie die folgenden Felder aus:

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

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

    • Visibility: 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.

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

    • Work item process: 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.

  • Work item

    Füllen Sie die folgenden Felder aus:

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

    • Work item type: Wählen Sie den Typ des Arbeitselements aus, das Sie erstellen möchten.

    • Other fields: 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.

Custom API Call

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.

Connection
Anweisungen zum Verbinden Ihres Azure DevOps-Kontos mit Workfront Fusion finden Sie unter Verbinden von Azure DevOps mit Workfront Fusion in diesem Artikel.
Base 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.
Method
Wählen Sie die HTTP-Anfragemethode aus, die Sie zum Konfigurieren des API-Aufrufs benötigen. Weitere Informationen finden Sie unter HTTP-Anfragemethoden.
Headers

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

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

Query String

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.

Download an attachment

Dieses Aktionsmodul lädt eine Anlage herunter.

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

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

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

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

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.

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

Read record

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.

Connection
Anweisungen zum Verbinden Ihres Azure DevOps-Kontos mit Workfront Fusion finden Sie unter Verbinden von Azure DevOps mit Workfront Fusion in diesem Artikel.
Record type

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

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

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

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

Update a work item

Dieses Aktionsmodul aktualisiert ein vorhandenes Arbeitselement mithilfe seiner ID.

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

Connection
Anweisungen zum Verbinden Ihres Azure DevOps-Kontos mit Workfront Fusion finden Sie unter Verbinden von Azure DevOps mit Workfront Fusion in diesem Artikel.
Project
Wählen Sie das Projekt aus, das das Arbeitselement enthält, das Sie aktualisieren möchten.
Work Item Type
Wählen Sie den Typ des Arbeitselements aus, das Sie aktualisieren möchten.
Other Fields
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.
Work item ID
Geben Sie die ID des Arbeitselements ein, das Sie aktualisieren möchten, oder mappen Sie sie.

Upload an attachment

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.

Connection
Anweisungen zum Verbinden Ihres Azure DevOps-Kontos mit Workfront Fusion finden Sie unter Verbinden von Azure DevOps mit Workfront Fusion in diesem Artikel.
Project
Wählen Sie das Projekt aus, in das Sie eine Anlage hochladen möchten.
Work item ID
Geben Sie die ID des Arbeitselements ein, in das Sie eine Anlage hochladen möchten, oder ordnen Sie sie zu.
Comment
Geben Sie den Text eines Kommentars ein, den Sie zum hochgeladenen Anhang hinzufügen möchten.
Source file
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

List work items

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.

Connection
Anweisungen zum Verbinden Ihres Azure DevOps-Kontos mit Workfront Fusion finden Sie unter Verbinden von Azure DevOps mit Workfront Fusion in diesem Artikel.
Project
Wählen Sie das Projekt aus, aus dem Sie Arbeitselemente abrufen möchten.
Work item type
Wählen Sie den Typ des Arbeitselements, das Sie abrufen möchten.
Outputs
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