Die Azdo-Verbindung ermöglicht die Verwendung von Suivi, um Azdo-Arbeitselemente in verschiedenen Ansichten darzustellen.

Übersicht

Funktionsweise

Die Verbindung zwischen Suivi und Azure DevOps ermöglicht die Synchronisierung von Arbeitselementen (Work Items) aus einem Azure DevOps-Projekt (oft als Azdo bezeichnet) zu einem Suivi-Board. Diese Synchronisierung basiert auf verschiedenen Verbindungsparametern wie der Organisation und dem Area Path Ihres Projekts, um die Work Items zu identifizieren, die zum Suivi-Board übertragen werden sollen. Die für jedes Work Item synchronisierten Informationen hängen von den definierten Zuordnungen zwischen den Attributen des Suivi-Boards und denen von Azdo ab.

Wenn ein Work Item Beziehungen vom Typ 'Child' besitzt, können auch die Titel der untergeordneten Work Items synchronisiert werden. Dadurch wird die Liste der untergeordneten Elemente in Suivi sichtbar (bleibt jedoch nicht bearbeitbar und ohne direkten Link zu Azdo).

Darüber hinaus ist es möglich, Work Items in Azdo aus Elementen zu erstellen, die direkt vom Suivi-Board stammen. Diese Funktion ermöglicht es, Elemente auf dem Suivi-Board vorzubereiten und sie dann in Azure DevOps zu erstellen, entweder einzeln oder durch Mehrfachsynchronisierung.

Beispielsweise kann das Suivi-Board verwendet werden, um eine Reihe von User Stories im Rahmen der Untersuchung eines Features in Azdo zu initiieren. Sobald diese User Stories erstellt sind, können sie direkt in Azure DevOps, dem Referenztool für Entwickler, hochgeladen werden.

Es ist jedoch wichtig zu beachten, dass die Regel für die Änderung von Elementen nach der Synchronisierung unverändert bleibt: Sobald ein Work Item synchronisiert ist, wird es Eigentum von Azdo, und alle zugehörigen Felder in der Verbindung sind in Suivi nicht mehr bearbeitbar. Die Änderung muss dann auf der Azdo-Seite erfolgen.

Woraus besteht eine Azdo-Verbindung?

In einer Verbindung zwischen Suivi und Azdo kann nur ein Typ von Work Item pro Verbindung synchronisiert werden. Es ist jedoch möglich, mehrere Verbindungen für dasselbe Board zu definieren.

Um die Verbindung mit einem Azure DevOps-Projekt herzustellen, ist die erste erforderliche Information Ihr Personal Access Token (PAT), das als Zugangsberechtigung für Azdo dient. Dieses PAT hat eine maximale Gültigkeitsdauer von einem Jahr und kann in Ihren Azdo-Benutzereinstellungen erstellt werden.

Zu diesem PAT kommen die Informationen zur Identifizierung Ihres Projekts hinzu:

• Ihre Organisation

• Ihr Bereich (Area Path)

Schließlich ermöglicht die Verbindung zu Azure DevOps die Definition aller Azdo-Felder, die mit Suivi synchronisiert werden sollen, wobei es durchaus möglich ist, nur einen Teil der Felder Ihres Boards zu synchronisieren.

Synchronisationsprinzipien

Die Synchronisation ist bidirektional, was bedeutet, dass Work Items von Azdo nach Suivi übertragen werden können, ebenso wie Suivi neue Work Items in Azdo erstellen kann.

Achtung jedoch: Wenn das Element in Azdo erstellt wurde, ist jede Änderung dieses Elements in Suivi für alle synchronisierten Felder unmöglich (die nicht synchronisierten Felder bleiben bearbeitbar, da sie Eigentum des Suivi-Boards sind). Kurz gesagt, die Synchronisation von Suivi ist nur möglich, wenn das Work Item nicht in Azdo existiert.

Nutzungsbeschränkungen

Der Connector zwischen Suivi und Azdo hat bestimmte Funktionsgrenzen, die wichtig zu beachten sind:

• Da das Work Item Eigentum von Azdo ist, kann jedes synchronisierte Feld nur auf der Azdo-Seite bearbeitet werden.

• Nur Beziehungen vom Typ 'Child' werden synchronisiert.

• Diskussionen, verknüpfte Dokumente und der Verlauf eines Work Items können nicht synchronisiert werden (Bilder in einem Feld vom Typ Langer Text hingegen schon).

• Jede Verbindung ermöglicht die Synchronisierung von nur einem Work Item-Typ (außer wenn er untergeordnete Elemente hat).

• Jedes Element (und seine untergeordneten Elemente), das im Board Suivi initialisiert wird, muss zwingend den Status Suivi haben, der dem Status "New" im Azdo-Projekt entspricht. Andernfalls wird die Erstellung auf Azdo-Seite abgelehnt. Überprüfen Sie diese Information in den Feldzuordnungen der Verbindung.

Definition des Board-Modells basierend auf Azdo-Daten (Agile-Modell)

Azdo stellt die synchronisierbaren Felder zur Verfügung. Sie werden jedoch feststellen, dass einige davon nicht mit dem entsprechenden Attribut in Suivi verknüpft werden können, sondern ein Attribut vom Typ Text oder Zahl verwenden (z. B.: Priority = Attribut Zahl und nicht Auswahl aus einer Liste, obwohl es sich auf Azdo-Seite um eine Liste handelt).

Wichtigste unterstützte Felder und ihre Entsprechung in Suivi

Weitere Systemfelder können ebenfalls synchronisiert werden. Siehe Microsoft-Dokumentation.

Verbindung zu einem Azure DevOps Board herstellen

Voraussetzungen

Um die Verbindung zu Azure DevOps einzurichten, benötigen Sie Ihr persönliches Azure DevOps-Token.

Um dieses Token zu erstellen, gehen Sie wie folgt vor:

1. Klicken Sie oben rechts im Header von Azure DevOps auf User Settings > Personal Access Tokens.

2. Klicken Sie auf New token.

3. Geben Sie einen Namen ein und legen Sie das Ablaufdatum des Tokens fest.

4. Aktivieren Sie die Kontrollkästchen Read, Read & write und Read, write & manage im Bereich Work Items, bevor Sie auf Create klicken.

5. Kopieren Sie Ihr Token. Achtung! Sobald das Fenster geschlossen ist, können Sie nicht mehr auf Ihr Token zugreifen.

Azure DevOps-Verbindung deklarieren

Um sich mit einem Azure DevOps-Board zu verbinden, müssen die Zugriffsparameter für Azdo und die Zuordnung der Felder zwischen den beiden Systemen deklariert werden:

1. Klicken Sie auf die Schaltfläche … des Boards > Connectoren.

2. Klicken Sie auf Neue Verbindung > Azure DevOps

3. Geben Sie die erforderlichen Informationen für den Zugriff auf das Board ein, wie z. B.:
   • Den Namen der Verbindung im Feld Name.

   • Ihr persönliches Azdo-Token im Feld Personal Access Token.

   • Den Namen Ihrer Organisation, der in der URL von Azure DevOps angegeben ist, wie z. B. https://dev.azure.com/Projektname/ …. Dies ist der Projektname, den Sie im Feld Organization eingeben müssen.

4. Klicken Sie auf Weiter.

5. Wählen Sie das Azure-Projekt und den Area-Pfad aus, den Sie synchronisieren möchten.
   ⛔

   Der Area-Pfad ist ein strikter Filter: Alle seine Unter-Areas werden bei der Synchronisierung nicht berücksichtigt (z. B.: Wenn Sie Agile/area/area1 wählen, werden alle Elemente mit dem Area Agile/area oder Agile/area/area+N ausgeschlossen).

6. Wählen Sie den Typ der zu synchronisierenden Work Items aus der vorgeschlagenen Liste aus (eine Zahl nach dem Work Item zeigt Ihnen die Anzahl der vorhandenen Work Items an).

7. Wenn Sie optional nur die untergeordneten Elemente eines bestimmten Work Items synchronisieren möchten, geben Sie dessen Azdo-Identifikationsnummer ein und klicken Sie auf Weiter.
   💡

   Beachten Sie, dass bei Verwendung dieser Einstellung nur die untergeordneten Elemente dieses Work Items mit Suivi synchronisiert werden und umgekehrt alle von Suivi erstellten Elemente bei der aufsteigenden Synchronisierung (Suivi >> Azdo) zu untergeordneten Elementen dieses Work Items werden

8. Ordnen Sie die Suivi-Felder den Azdo-Feldern zu, die Sie synchronisieren möchten.
   💡

   Es ist nicht erforderlich, alle Felder zuzuordnen. Nicht zugeordnete Felder bleiben bearbeitbar und sind nur in Suivi sichtbar.

9. Wenn Sie Felder vom Typ Tags verwendet haben, klicken Sie auf die Schaltfläche Konfigurieren, um die Listenwerte denen des Azdo-Feldes zuzuordnen.

10. Klicken Sie auf Fertig.

Daten synchronisieren

Azdo-Elemente mit Suivi synchronisieren

Sobald die Verbindung konfiguriert ist, können Sie die Synchronisierung der Elemente in Ihrem Suivi-Board starten. Dafür stehen Ihnen mehrere Vorgehensweisen zur Verfügung:

• von der Verbindung aus: durch Klicken auf die Kebab-Schaltfläche > Board synchronisieren im Verbindungseinstellungsdialog,

• über das Kontextmenü des Boards: Klicken Sie auf die Kebab-Schaltfläche rechts neben dem Board-Namen > Board synchronisieren,

• über die Synchronisierungsschaltfläche in der Kopfzeile.

Ein neues Suivi-Element mit Azdo synchronisieren

Wie bereits erwähnt, können Sie von einem Suivi-Board aus Elemente im Azdo-Projekt erstellen. Dazu steht in der Tabellenansicht des Boards eine Funktion zur Synchronisierung einer Zeile oder mehrerer ausgewählter Zeilen zur Verfügung. Es ist auch möglich, dies einzeln direkt beim Bearbeiten des Elements (Bearbeitungsformular) durchzuführen.

Um die Synchronisierung eines Elements mit Azdo aus der Tabellenansicht zu starten:

1. Doppelklicken Sie in der Tabellenansicht mit der linken Maustaste auf die Zelle des Attributs Verbindung des gewünschten Elements. Es erscheint ein Menü Element synchronisieren mit.

2. Wählen Sie die gewünschte Verbindung aus, falls mehrere vorhanden sind. Der Link zum Azdo-Arbeitselement erscheint in der Zelle. Er hat die Form „Projekt: Arbeitselementtyp Nr. Azdo

   Um die Synchronisierung eines Elements mit Azdo über das Bearbeitungsformular des Elements zu starten:

   1. Öffnen Sie das Bearbeitungsformular.
   2. Wählen Sie beim Attribut Verbindung die gewünschte Verbindung aus, falls mehrere vorhanden sind. Der Link zum Azdo-Arbeitselement erscheint in der Zelle. Er hat die Form „Projekt: Arbeitselementtyp Nr.Azdo

      Einen Azdo-Link löschen

      Wenn ein Azdo-Link erstellt wurde, kann er weiterhin vom Board Suivi gelöscht werden. Dies kann nützlich sein, wenn beispielsweise die Synchronisierung nicht korrekt funktioniert hat und der Link dadurch unbrauchbar geworden ist.

      💡

      Beachten Sie, dass bei der nächsten Synchronisierung ein neues ähnliches Element im Board erstellt wird, wenn Sie einen Link auf einem Element löschen. Seien Sie daher vorsichtig, wenn Ihr Board synchronisierte und nicht synchronisierte Attribute verwendet.
      • Um den Link aus der Tabellenansicht zu löschen, klicken Sie einfach auf das rote Symbol für unterbrochene Verbindung, das beim Überfahren in der Zelle erscheint.
      • Wenn Sie das Bearbeitungsformular des Elements verwenden, klicken Sie auf die Schaltfläche […] des Azdo-Link-Attributs.