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
| 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: Verfügbar für Organisationen mit betriebsbasierten Lizenzen 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:
Verbinden von Azure DevOps mit Workfront Fusion connect-azure-devops-to-workfront-fusion
Verbinden von Azure DevOps mit Workfront Fusion mithilfe von EntraApp
-
Fügen Sie Ihrem Szenario ein Azure DevOps hinzu.
-
Klicken Sie Hinzufügen neben dem Feld Verbindung.
-
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. -
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. -
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.
-
Klicken Sie Fortfahren, um die Einrichtung der Verbindung abzuschließen und mit der Erstellung Ihres Szenarios fortzufahren.
Verbinden von Azure DevOps mit Workfront Fusion mithilfe eines Service-Prinzipals
Sie können eine Verbindung erstellen, die einen Service-Prinzipal (eine Anwendungs-API-Verbindung) anstelle eines persönlichen Kontos verwendet. Dies ist nützlich, wenn die Verbindung als Anwendung oder Service-Identität und nicht als eine bestimmte Person ausgeführt werden soll. Dies kann nützlich sein, damit die Integration nicht unterbrochen wird, wenn diese Person beispielsweise das Unternehmen verlässt oder ihr Passwort ändert.
Dieser Verbindungstyp ist für alle Azure DevOps-Module verfügbar.
- Voraussetzungen für das Verbinden von Azure DevOps mit Workfront Fusion mithilfe eines Service-Prinzipals
- Erstellen der App-Registrierung in der Microsoft Entra ID
- Erstellen von Client-Geheimnissen
- Erfassen von Verbindungsdetails
- Hinzufügen des Service-Prinzipals zu Ihrer Azure DevOps-Organisation
- Erstellen der Verbindung
Voraussetzungen für das Verbinden von Azure DevOps mit Workfront Fusion mithilfe eines Service-Prinzipals
Um diese Verbindung zu erstellen, benötigen Sie Folgendes:
- Globaler Administrator oder Anwendungsadministrator Zugriff auf die Microsoft Entra ID, um die App zu registrieren. Wenn Sie nicht über diesen Zugriff verfügen, bitten Sie jemanden in Ihrem IT- oder Identitäts-Team, diesen Schritt für Sie auszuführen.
- Projektsammlungs-Administrator greifen Sie in Ihrer Azure DevOps-Organisation zu, um den Service-Prinzipal als Mitglied hinzuzufügen. Häufig handelt es sich dabei um eine andere Person als die Person, die die Microsoft Entra ID verwaltet.
- Der Name Ihres Azure DevOps-Unternehmens. Sie finden diese in Ihrer Azure DevOps-URL:
dev.azure.com/<your organization name>.
Erstellen der App-Registrierung in der Microsoft Entra ID
- Melden Sie sich beim Microsoft Entra Admin Center an.
- Navigieren Sie App-Registrierungen > Neue Registrierung.
- Geben Sie der App einen klaren, erkennbaren Namen. Beispiel:
Workfront Fusion Azure DevOps Integration. - Lassen Sie Umleitungs-URI leer. Für diese Verbindung ist keine Anmeldung über einen Browser erforderlich.
- Wählen Sie Registrieren aus.
- Fahren Sie mit Erstellen eines Client-Geheimnisses fort.
Erstellen von Client-Geheimnissen
- Navigieren Sie in Ihrer neuen App-Registrierung zu Zertifikate und Geheimnisse.
- Wählen Sie Neues Client-Geheimnis, fügen Sie eine Beschreibung hinzu und wählen Sie einen Ablaufzeitraum aus.
- Bestätigen Sie die Angaben mithilfe der Schaltfläche Hinzufügen.
- Kopieren Sie den (Wert der geheimen Daten. Er wird nur einmal angezeigt. Wenn Sie die Seite verlassen möchten, bevor Sie sie kopieren, müssen Sie eine neue erstellen.
- Fahren Sie Verbindungsdetails erfassen fort.
Erfassen von Verbindungsdetails
-
Beachten Sie auf der Seite Übersicht der App-Registrierung die folgenden Werte. Diese werden beim Erstellen der Verbindung im Modul eingegeben.
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Mandanten-ID Auf der Seite Überblick mit der Beschriftung Verzeichnis (Mandanten-ID. Client-ID Auf der Seite Überblick mit der Bezeichnung Anwendungs-(Client-)ID. Client-Geheimnis Der Wert, den Sie in " eines Client-Geheimnisses“ kopiert. Organisation Ihr Azure DevOps-Organisationsname. Wenn Ihre URL beispielsweise dev.azure.com/yourorgist, geben Sieyourorgein.note NOTE Sie können den Bereich (API-Berechtigungen) App Registrierung überspringen. Wenn Sie dort Azure DevOps hinzufügen, sind nur Delegierte Berechtigungen verfügbar. Anwendungsberechtigungen werden ausgegraut angezeigt. Dies ist zu erwarten, da Azure DevOps die Gewährung von Zugriff auf diese Weise nicht unterstützt. Stattdessen wird der Zugriff direkt innerhalb von Azure DevOps gewährt, im nächsten Teil. -
Fahren Sie fort Service-Prinzipal zu Ihrer Azure DevOps-Organisation hinzufügen.
Hinzufügen des Service-Prinzipals zu Ihrer Azure DevOps-Organisation
Durch die Registrierung der App in der Microsoft Entra ID wird nur deren Identität erstellt. Sie gewährt der App noch keinen Zugriff auf Ihre Azure DevOps-Daten. Durch dieses Verfahren wird diesem Zugriff gewährt.
-
Melden Sie sich bei Ihrer Azure DevOps-Organisation unter
dev.azure.com/<your organization name>an. -
Wählen Sie Organisationseinstellungen unten links aus und klicken Sie auf Benutzer.
-
Wählen Sie Benutzer hinzufügen aus.
-
Suchen Sie im Suchfeld nach dem Anzeigenamen der App, d. h. dem Namen, den Sie bei der Registrierung der App angegeben haben. Suchen Sie nicht nach der Client-ID.
-
Zugriffsebene auswählen:
- Standard reicht in der Regel aus, um Arbeitselemente, Pinnwände und Repos zu lesen und zu schreiben.
- Wenn Ihr Workflow im Rahmen der Einrichtung verfügbare Prozesse wie Agile, Scrum oder benutzerdefinierte Vorlagen durchsuchen muss, fügen Sie den Service-Prinzipal stattdessen der Gruppe Projektsammlungs-" hinzu. Dies ist eine umfassendere Zugriffsberechtigung, gewähren Sie sie also nur, wenn Sie diese Funktion benötigen.
-
Weisen Sie den Service-Prinzipal gemäß den üblichen Zugriffsverfahren Ihres Unternehmens dem jeweiligen Projekt bzw. den Projekten zu, das bzw. die er benötigt.
-
Bestätigen Sie die Angaben mithilfe der Schaltfläche Hinzufügen.
-
Fahren Sie Verbindung erstellen fort.
Erstellen der Verbindung
-
Wählen Sie im Bildschirm zur Verbindungseinrichtung des Moduls den Verbindungstyp Service-) aus.
-
Geben Sie Folgendes ein:
- Mandanten-ID
- Client-ID
- Client Secret (Client-Geheimnis)
- Organisation
-
Speichern Sie die Verbindung.
Wenn alles korrekt eingerichtet ist, wird die Verbindung erfolgreich validiert.
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.
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.
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.
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.
Geben Sie die relative URL ein, mit der Sie sich für diesen API-Aufruf verbinden möchten.
Beispiel: {organization}/_apis[/{area}]/{resource}
Fügen Sie die Header der Anfrage in Form eines standardmäßigen JSON-Objekts hinzu.
Beispiel: {"Content-type":"application/json"}
Fügen Sie die Abfrage für den API-Aufruf in Form eines standardmäßigen JSON-Objekts hinzu.
Beispiel: {"name":"something-urgent"}
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.
Arbeitselemente verknüpfen
Dieses Aktionsmodul verknüpft zwei Arbeitselemente und definiert die Beziehung zwischen ihnen.
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.
Arbeitselement aktualisieren
Dieses Aktionsmodul aktualisiert ein vorhandenes Arbeitselement mithilfe seiner ID.
Das Modul gibt die ID des aktualisierten Arbeitselements zurück.
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.
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.