💡 Es gibt jetzt einen einfacheren Weg, Azure DevOps zu verbinden. Jede Person kann sich mit ihrem eigenen Azure DevOps-Konto direkt aus Workpath heraus anmelden – ohne Personal Access Token und ohne Erweiterung – und Work Items direkt mit ihren Zielen verknüpfen. Für die meisten Teams ist das der empfohlene Einstieg. Siehe Verwendung der Azure DevOps-Integration. Die unten beschriebene Einrichtung mit Personal Access Token und Erweiterung wird weiterhin unterstützt und kann parallel zur persönlichen Anmeldung genutzt werden, zum Beispiel um Work Items direkt aus Azure DevOps zu verknüpfen.
ℹ️ Für Admins: Damit die persönliche Anmeldung für deine Mitarbeitenden verfügbar ist, gehe zu Einstellungen → Verbindungen und aktiviere Azure DevOps für deine Organisation. Je nach Azure DevOps-Konfiguration musst du zusätzlich die Workpath-Anwendung in Azure DevOps freigeben – siehe Berechtigung für Microsoft-Anwendungen erteilen.
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.