Azure DevOps Module

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

Wenn Sie Anweisungen zum Erstellen eines Szenarios benötigen, finden Sie weitere Informationen unter Erstellen eines Szenarios in Adobe Workfront Fusion.

Weitere Informationen zu Modulen finden Sie unter Module in Adobe Workfront Fusion.

Zugriffsanforderungen

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

Adobe Workfront plan*
Pro oder höher
Adobe Workfront license*
Plan, Arbeit
Adobe Workfront Fusion license**

Aktuelle Lizenzanforderungen: Keine Workfront Fusion Lizenzanforderungen.

Oder

Alte Lizenzanforderung: Workfront Fusion für die Arbeitsautomatisierung und -integration

Produkt

Aktuelle Produktanforderung: Wenn Sie über den Select- oder Prime Adobe Workfront-Plan verfügen, muss Ihr Unternehmen Adobe Workfront Fusion sowie Adobe Workfront erwerben, um die in diesem Artikel beschriebene Funktionalität nutzen zu können. Workfront Fusion ist im Ultimate Workfront-Plan enthalten.

Oder

Alte Produktanforderung: Ihr Unternehmen muss Adobe Workfront Fusion sowie Adobe Workfront erwerben, um die in diesem Artikel beschriebenen Funktionen nutzen zu können.

Wenden Sie sich an Ihren Workfront -Administrator, um zu erfahren, welchen Plan, welchen Lizenztyp oder welchen Zugriff Sie haben.

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 DevOps-Konto vom Typ Azure 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 -Modul hinzu.

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

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

    note important
    IMPORTANT
    Der Verbindungstyp Azure DevOps (Alle Bereiche anfordern) wird in naher Zukunft nicht mehr unterstützt. Daher empfehlen wir die Verwendung dieser Funktion nicht.
  4. Füllen Sie die folgenden Felder aus:

    table 0-row-2 1-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 Ihre Azure DevOps -Anwendung erstellt haben.
  5. Klicken Sie auf Weiter , um die Verbindung einzurichten und mit der Erstellung Ihres Szenarios fortzufahren.

Azure DevOps -Module und ihre Felder

Wenn Sie Azure DevOps -Module konfigurieren, 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 im Dienst zusätzliche Azure DevOps -Felder angezeigt werden. Ein fett hervorgehobener Titel in einem Modul zeigt ein erforderliches Feld an.

Wenn Sie die Zuordnungsschaltfläche über einem Feld oder einer Funktion sehen, können Sie damit Variablen und Funktionen für dieses Feld festlegen. Weitere Informationen finden Sie unter Informationen von einem Modul einem anderen zuordnen in Adobe Workfront Fusion.

Trigger

Auf Arbeitselemente achten

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 mit dem Datensatz verknüpften Standardfelder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.

Wenn Sie dieses Modul konfigurieren, werden die folgenden Felder angezeigt.

Webhook

Wählen Sie einen Webhook für das Modul aus oder fügen Sie ihn hinzu.

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

Informationen zum Erstellen eines Webhooks finden Sie unter Webhooks.

Aktionen

Benutzerspezifischer 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 anderen Azure DevOps -Modulen nicht ausgeführt werden kann.

Wenn Sie dieses Modul konfigurieren, werden die folgenden Felder angezeigt.

Verbindung
Anweisungen zum Verbinden Ihres Azure DevOps-Kontos mit Workfront Fusion finden Sie in diesem Artikel unter Verbinden von Azure DevOps mit Workfront Fusion.
Basis-URL
Auswählen oder Zuordnen der Basis-URL, mit der Sie eine Verbindung zu Ihrem Azure DevOps-Konto herstellen
Relative URL von

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

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

API-Version
Wählen Sie die Version der Azure DevOps-API aus oder ordnen Sie sie zu, mit der Sie für diesen API-Aufruf eine Verbindung herstellen möchten. Wenn keine Version ausgewählt ist, stellt Workfront Fusion eine Verbindung zur 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-Anforderungsmethoden in Adobe Workfront Fusion.
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"}

Body

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

Hinweis:

Bei Verwendung von bedingten Anweisungen wie if in Ihrer JSON platzieren Sie die Anführungszeichen außerhalb der bedingten Anweisung.

Erstellen eines Datensatzes

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 in diesem Artikel unter Verbinden von Azure DevOps mit Workfront Fusion.
Record Type

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

    • Beschreibung: 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 Einen Prozess auswählen in der Dokumentation zu Azure DevOps .

  • Arbeitselement

    Füllen Sie die folgenden Felder aus:

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

    • Arbeitselementtyp: Wählen Sie den Typ des zu erstellenden Arbeitselements aus.

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

Herunterladen eines Anhangs

Dieses Aktionsmodul lädt einen Anhang herunter.

Das Modul gibt den Dateiinhalt des Anhangs zurück.

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

Verknüpfen von Arbeitselementen

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

Das Modul gibt die ID des Hauptarbeitselements und aller 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.

Wenn Sie dieses Modul konfigurieren, werden die folgenden Felder angezeigt.

Verbindung
Anweisungen zum Verbinden Ihres Azure DevOps-Kontos mit Workfront Fusion finden Sie in diesem Artikel unter Verbinden von Azure DevOps mit Workfront Fusion.
Arbeitselement-ID
Geben Sie die ID des Hauptelement 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 unter Link Type Reference in der Azure DevOps-Dokumentation.

Kommentar
Geben Sie den Text eines Kommentars ein oder ordnen Sie ihn zu. Dies ist nützlich, um die Begründung oder Absicht des Links zu erläutern.

Datensatz lesen

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

Sie geben die Kennung des Datensatzes an.

Das Modul gibt die Kennung 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.

Wenn Sie dieses Modul konfigurieren, werden die folgenden Felder angezeigt.

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

Auswählen, ob Sie ein Projekt oder ein Arbeitselement lesen möchten

  • Projekt: 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 Ausgabebundle für dieses Modul enthalten sein sollen. Die verfügbaren Felder hängen vom Arbeitselement-Typ ab.
ID
Geben Sie die Kennung des Datensatzes ein, den Sie lesen möchten, oder ordnen Sie sie zu.

Arbeitselement aktualisieren

Dieses Aktionsmodul aktualisiert ein vorhandenes Arbeitselement mit 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 in diesem Artikel unter Verbinden von Azure DevOps mit Workfront Fusion.
Projekt
Wählen Sie das Projekt aus, das das zu aktualisierende Arbeitselement enthält.
Arbeitselement Typ
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 aufweisen soll. Die verfügbaren Felder hängen vom Arbeitselement-Typ ab.
Arbeitselement-ID
Geben Sie die ID des Arbeitselements ein, das Sie aktualisieren möchten, oder ordnen Sie sie zu.

Hochladen eines Anhangs

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 in diesem Artikel unter Verbinden von Azure DevOps mit Workfront Fusion.
Projekt
Wählen Sie das Projekt aus, in das Sie einen Anhang hochladen möchten.
Arbeitselement-ID
Geben Sie die Kennung des Arbeitselements ein oder ordnen Sie sie zu, in das Sie einen Anhang hochladen möchten.
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 ordnen Sie sie zu.

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

Wenn Sie dieses Modul konfigurieren, werden die folgenden Felder angezeigt.

Verbindung
Anweisungen zum Verbinden Ihres Azure DevOps-Kontos mit Workfront Fusion finden Sie in diesem Artikel unter Verbinden von Azure DevOps mit Workfront Fusion.
Projekt
Wählen Sie das Projekt aus, aus dem Sie Arbeitselemente abrufen möchten.
Arbeitselement Typ
Wählen Sie den Typ des Arbeitselements aus, das Sie abrufen möchten.
Ausgaben
Wählen Sie die Eigenschaften aus, die in der Ausgabe des Moduls 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 ordnen Sie sie zu.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43