Azure Devops Synchronisierung

Verbinden Sie Azure Devops mit aqua, um Issues zu erstellen und zu synchronisieren.

enn Sie Ihre Projekte gleichzeitig in aqua und Azure DevOps ausführen, können Sie die Synchronisierung von Tickets zwischen beiden Systemen einrichten, sodass jeder über die Änderungen informiert bleibt.

Das Azure DevOps-Sync umfasst:

Titel
Status
Zugewiesen an
Beschreibung
Bilder in der Beschreibung
Dateien

Um die Integration einzurichten, empfehlen wir, die Anweisungen zu befolgen und einige Vorbereitungen im Voraus zu treffen.

Vorbereitungen auf der aqua-Seite

Erstellen Sie zuerst einen technischen Benutzer.

Gehen Sie zum Abschnitt "Benutzerverwaltung" in aqua.
Fügen Sie einen neuen technischen Benutzer hinzu.
Weisen Sie diesem Benutzer eine technische Lizenz zu.

Dieser Benutzer wird alle Synchronisierungsoperationen in aqua durchführen und die Historie des Tickets auf dem Laufenden halten.

Wählen Sie dann das aqua-Projekt aus, das Sie mit dem Azure DevOps-Projekt synchronisieren möchten, und fügen Sie den technischen Benutzer mit der Rolle "Projekt Administrator" hinzu, um sicherzustellen, dass er alle erforderlichen Berechtigungen hat, um mit den Elementen zu arbeiten.

Als Nächstes zur Vorlagenseite gehen.

Für die Elemente, die Sie synchronisieren möchten (Anforderungen oder Fehler), definieren Sie die Statuswerte. Stellen Sie sicher, dass diese Werte in aqua und Azure DevOps genau übereinstimmen, um eine erfolgreiche Synchronisierung zu gewährleisten.

Beispiel: Wenn das Statusfeld in Azure DevOps die folgenden Werte aufweist:

To do
Doing
Done

Dann, in aqua, sollte es auch sein:

To do
Doing
Done

Vorbereitungen auf der Azure DevOps-Seite

Um die Integration einzurichten, benötigen Sie ein Azure DevOps-Token. Klicken Sie auf das Einstellungssymbol und wählen Sie 'Personal access tokens' aus, um es zu erstellen.

Klicken Sie dann auf die Schaltfläche 'New Token'.

Sobald die Seitenleiste erscheint, geben Sie dem Token einen eindeutigen Namen. Wir empfehlen die Auswahl der folgenden Optionen:

Organization access: All accessible organizations
Expiration: Beliebiger Zeitraum
Scope: Full scope

Als Sicherheitsmaßnahme können Sie den Zugriff nur einer Organisation gewähren. Wenn Sie dies tun, müssen Sie jedoch den Organisationsnamen manuell angeben, wenn Sie die Synchronisierungsintegration einrichten.

Sobald Sie das Token gespeichert haben, kopieren Sie es und bewahren Sie es sicher für die weitere Einrichtung auf.

Einrichten einer Integration

Navigieren Sie zur Integrationsseite und wechseln Sie zur Registerkarte 'Projekt'.

Beachten Sie, dass die Azure DevOps-Synchronisierungsintegration nur auf Projektebene unterstützt wird.

Klicken Sie dann auf die Schaltfläche "Konfigurieren".

Sobald das Modal geöffnet ist, wählen Sie das aqua-Projekt, das Sie synchronisieren möchten. Wählen Sie dann den zuvor erstellten Tech-Benutzer aus und geben Sie das API-Token von Azure DevOps ein.

Wenn Sie ein globales Token mit Zugriff auf alle Organisationen generiert haben, wird das System automatisch alle verfügbaren Azure DevOps-Organisationen zur Synchronisation abrufen und anzeigen. Wenn Sie ein organisationsspezifisches Token erstellt haben, geben Sie bitte den Organisationsnamen genau so ein, wie er in Azure DevOps erscheint.

Nachdem Sie das Token bereitgestellt haben, werden alle verfügbaren Projekte innerhalb der ausgewählten Organisation vorausgefüllt. Wählen Sie das Azure DevOps-Projekt aus, das Sie synchronisieren möchten.

Als Nächstes definieren Sie, welche aqua Elemente Sie synchronisieren möchten. Derzeit können Sie nur Anforderungen und Fehler mit Azure DevOps Epics, Issue und Task synchronisieren.

Wenn das Projekt ausgewählt wird, werden die verfügbaren Elementtypen aus Azure DevOps im Dropdown-Menü vorausgefüllt. Wählen Sie den Elementtyp, den Sie synchronisieren möchten, aus der Liste aus.

Beschreiben Sie anschließend die Richtung der Synchronisation:

Bidirektional: Aus der Integrationseinrichtung synchronisieren sich alle vorhandenen und neu erstellten Tickets in beiden Systemen in beide Richtungen. Beispielsweise werden Änderungen an einem Ticket in aqua in Azure DevOps reflektiert, und wenn Sie dasselbe Ticket in Azure DevOps ändern, werden die Änderungen zurück zu aqua übertragen.
Nur in Azure Devops erstellt: Aus der Integrationseinrichtung werden alle bestehenden und neu erstellten Tickets in Azure DevOps nur zu aqua synchronisiert. Wenn Sie beispielsweise ein Ticket in Azure DevOps bearbeiten, werden die Änderungen in aqua übernommen. Wenn Sie jedoch dasselbe Ticket in aqua ändern, werden die Änderungen nicht zurück nach Azure DevOps übertragen.
Nur in aqua erstellt: Aus der Integrationseinrichtung synchronisieren alle vorhandenen und neu erstellten Tickets in aqua nur mit Azure DevOps. Wenn Sie beispielsweise ein Ticket in aqua bearbeiten, werden die Änderungen in Azure DevOps übernommen. Wenn Sie dasselbe Ticket in Azure DevOps ändern, werden die Änderungen jedoch nicht nach aqua übertragen.

Die Synchronisierungsrichtung für jeden Elementtyp kann individuell festgelegt werden. Zum Beispiel können Sie Defekte in beide Richtungen und Anforderungen nur in eine bevorzugte Richtung synchronisieren.

Nachdem die Integration eingerichtet ist, werden alle bestehenden Tickets basierend auf den definierten Präferenzen synchronisiert. Die Synchronisierung läuft automatisch alle 10 Sekunden.

Wenn Sie die Synchronisierung deaktivieren möchten, können Sie dies entweder für die gesamte Synchronisierung oder für einen bestimmten Elementtyp tun.

Sie können die Synchronisierungsrichtung auch ändern, indem Sie eine andere Option aus dem Dropdown-Menü auswählen.

Bitte beachten Sie, dass Sie das aqua Projekt, das Azure DevOps-Projekt oder den Problemtyp nicht ändern können, sobald die Synchronisation eingerichtet ist.

Wenn Sie diese Anpassungen vornehmen müssen, empfehlen wir, die Synchronisierung vollständig zu entfernen und eine neue einzurichten.

Bei Fragen, benötigter Hilfe oder Feedback zur Azure Devops-Integration, wenden Sie sich gerne an support@aqua-cloud.io