Integration auf einen Blick
Mit der Workpath-Integration für Azure DevOps kannst du die strategischen Ziele deiner Organisation direkt mit der täglichen Arbeit in Azure DevOps Boards verknüpfen:
- Verknüpfe Azure DevOps-Work Items direkt aus Azure DevOps Services mit Workpath-Zielen
- Sieh in Azure DevOps neben jedem Work Item das verknüpfte Ziel und dessen Fortschritt
- Sieh in Workpath alle mit einem Ziel verknüpften Work Items und den Status aller untergeordneten Issues
Einrichtung der Azure DevOps-Integration
ℹ️ Für alle nachfolgenden Schritte benötigst du Admin-Rechte sowohl in Azure DevOps als auch in Workpath.
Die Einrichtung erfolgt in sechs Schritten:
- Erstelle ein Personal Access Token (PAT)
- Trage das PAT in Workpath ein
- Füge die Azure DevOps-Extension hinzu
- Installiere die Azure DevOps-Extension
- Konfiguriere Azure DevOps, damit die Workpath-Extension angezeigt wird
- Beginne mit der Verknüpfung von Work Items mit Zielen
Schritt 1: Personal Access Token (PAT) erstellen
ℹ️ Ein PAT ist ein API-Zugriffstoken, mit dem Workpath-Backend synchronisierte Daten zu verknüpften Work Items abrufen kann.
- Erstelle oder wähle in Azure DevOps einen technischen Benutzer aus (z. B. “Workpath Integration”).
- Füge diesen Benutzer zu allen Projekten hinzu, in denen eine Verknüpfung zu Workpath-Zielen möglich sein soll.
- Logge dich mit diesem Benutzer ein, klicke oben rechts auf das Benutzer-Icon und wähle Personal access tokens.
- Klicke auf New Token, nenne es “Workpath Integration” oder ähnlich.
- Lege ein Ablaufdatum fest (gemäß eurer Sicherheitsrichtlinien).
- Wähle Custom defined Scopes und setze bei Work Items den Zugriff auf Read.
- Klicke auf Create und kopiere das Token – sichere es an einem geschützten Ort.
Schritt 2: PAT in Workpath eintragen
- Gehe in Workpath zu Settings → Integrations → Azure DevOps (Admin-Zugriff erforderlich).
- Klicke auf Add a new connection.
- Trage deine Azure DevOps-URL ein (z. B.
https://dev.azure.com/dein-unternehmen/). - Füge das im Schritt 1 erstellte PAT ein.
- Klicke auf Save.
Schritt 3: Mehrere Tenants hinzufügen
Falls du mehrere Azure DevOps-Tenants verknüpfen möchtest, wiederhole Schritt 2 für jeden Tenant (URL + PAT).
Bitte sende außerdem die Liste aller Tenants an solutions@workpath.com, damit sie im Workpath-Backend korrekt konfiguriert werden.
Schritt 4: Azure DevOps-Extension installieren
- Stelle sicher, dass dein Benutzer Mitglied der Gruppe Project Collection Administrators ist (oder entsprechende Rechte hat).
- Gehe in Azure DevOps zu Organization Settings → Extensions → Shared.
- Wähle die Workpath Extension und klicke auf Install.
- Falls die Extension nicht gelistet ist, kontaktiere bitte das Workpath Support-Team.
- Erlaube alle angeforderten Scopes, damit die Extension korrekt auf die benötigten Daten zugreifen kann.
Schritt 5: Workpath-Extension in Azure DevOps anzeigen
Um das Workpath-Control in den Formularen deiner Work Items sichtbar zu machen, musst du den Prozess bzw. Issue-Typen anpassen:
- Gehe in Azure DevOps zu Organization Settings → Boards → Process.
- Wähle den Prozess aus, in dem du das Workpath-Control hinzufügen möchtest (oder lege einen neuen an).
- Wähle den Issue-Typ Epic (oder einen anderen Typ, falls gewünscht).
- Klick auf Add custom control, wähle die Workpath Custom Control aus und platziere sie im Formular.
- Öffne ein Epic in einem Projekt, das diesen Prozess nutzt, und überprüfe, ob das Control angezeigt wird.
- Wiederhole das für alle weiteren Issue-Typen, die du verknüpfen möchtest.
Schritt 6: Work Items mit Zielen verknüpfen
- Bitte deine Teams, Epics oder andere Work Items mit Workpath-Zielen zu verknüpfen (statt alle Child Issues einzeln zu verknüpfen).
- Melde dich in Azure DevOps mit einem Benutzer an, der auch Zugriff auf das entsprechende Team in Workpath hat.
- Öffne ein Work Item.
- In der Seitenleiste solltest du nun eine Liste aller Workpath-Ziele sehen und eines auswählen können.
🎉 Fertig! Die Integration ist jetzt aktiv und du kannst Work Items und Ziele nahtlos synchronisieren.