Airfocus mit Azure DevOps integrieren

Vorteile der Nutzung der Azure DevOps-Integration

• Importieren Sie Azure DevOps-Arbeitselemente in airfocus.
• Push airfocus Elemente in Azure DevOps (als beliebiger Arbeitselementtyp).
• Flexibler Filter (über die Azure DevOps-Problemsuche).
• Flexible Zuordnung für System- und benutzerdefinierte Felder mit konfigurierbaren Synchronisierungsrichtungen pro Feld.
• Direkt die Azure-DevOps-Beschreibungen auf AirFocus-Beschreibungen zuordnen.
• Zeigen Sie Ihre Iterationen (Sprints) in Airfocus an, um den Kontext zu Geschäftswert und -prioritäten zu erhalten.

setzen, bringen, einstellen up the Integration

Die Integration in airfocus verbindet sich immer mit einem bestimmten airfocus Der Arbeitsbereich. Sie können mehrere Azure DevOps-Integrationen zu einem bestimmten Arbeitsbereich hinzufügen (z. B. aus verschiedenen Azure DevOps-Projekten oder für verschiedene Arbeitselemente).

Um die Azure DevOps-Integration einzurichten, zu bringen und einzustellen, befolgen Sie diese Schritte:

1. Melden Sie sich bei AirFocus an oder melden Sie sich in Ihr bestehendes Konto ein. 
2. Erstellen Sie einen neuen Arbeitsbereich in airfocus oder wählen Sie denjenigen aus, mit dem Sie Azure DevOps integrieren möchten.
3. Klicken Sie oben rechts auf der Seite auf Erweiterungen .
4. Wählen Sie „Integration verwalten“.
   
5. Klicken Sie auf "Verbinden " im Kachel "Azure DevOps".

Ab hier unterscheiden sich die weiteren Schritte je nach Instanztyp. Lesen Sie die untenstehenden Abschnitte für die Schritte zu jedem einzelnen Teil.

Verbinden Sie sich mit Ihrem Azure DevOps Cloud-Konto

Um die Integration für ein Azure DevOps Cloud-Konto einzurichten, befolgen Sie diese Schritte:

1. Wählen Sie im Instanztyp-Selektor Azure Cloud aus.
2. Klicken Sie auf Weiterfahren.

Sie werden zu Azure DevOps weitergeleitet, um Ihre Zugriffsberechtigungen zu authentifizieren, und nach der Anmeldung in Ihrem Konto werden Sie zur airfocus-Integrationsseite Ihres Arbeitsbereichs weitergeleitet.

Um eine erfolgreiche Integration zu gewährleisten, stellen Sie sicher, dass die Einstellung „Zugriff von Drittanbieteranwendungen über OAuth “ im Bildschirm „Organisationsrichtlinien“ von Azure DevOps aktiviert ist.

Verbinden Sie sich mit Ihrem Azure DevOps Server (on-premise) Konto

Um die Integration für ein Azure DevOps Cloud-Konto einzurichten, befolgen Sie diese Schritte:

1. Wählen Sie im Auswahlfeld für den Instanztyp „Azure On-Premise“ aus.
2. Klicken Sie auf Weiterfahren.
3. Geben Sie die Details ein, um eine Verbindung zu Ihrer Azure DevOps Server-Instanz herzustellen.
   • Basis-URL: Gib den ersten Teil deiner Azure DevOps Server URL ein (alles davor bis zum Ende deiner Domain / IP-Adresse und vor dem ersten Backslash). Zum Beispiel: https://198.254.533.325. Die URL muss von unseren Servern zugänglich sein, daher können Sie hier keine lokal gehosteten URLs verwenden.
   • Persönliches Zugriffstoken: Sie erhalten Ihr persönliches Zugriffstoken im Abschnitt „Persönliche Zugriffstoken“ Ihrer Azure DevOps-Nutzungssicherheitseinstellungen. Weitere Einzelheiten finden Sie im Abschnitt „Persönliches Zugriffstoken erhalten“ weiter unten.
   • Organisationsname: Gib den genauen Namen der Azure-DevOps-Organisation ein, die du mit AirFocus synchronisieren möchtest.
4. Klicken Sie auf „Weiter“ , um Ihr airfocus-Team mit Ihrer Azure DevOps-Organisation zu verbinden.

Persönliches Zugriffstoken anfordern

Um Ihr persönliches Zugriffstoken in Azure DevOps zu erhalten, befolgen Sie diese Schritte:

1. Öffnen Sie Ihre ADO-Sicherheitseinstellungen.
2. Wählen Sie persönliche Zugriffstoken im Navigationsmenü auf der linken Seite der Seite aus.
3. Klicke oben auf der Seite + Neues Token.
4. Erstellen Sie ein neues Token mit mindestens den folgenden Berechtigungen:
   • Arbeitselemente (Lesen und Schreiben)
   • Projekt und Team (lesen)
   • Die persönlichen Zugangstoken können so konfiguriert werden, dass sie maximal 1 Jahr gültig sind. Denken Sie daran, die Gültigkeit Ihres Tokens aktuell zu halten, um sicherzustellen, dass Ihre airfocus-Integration ohne Unterbrechungen funktioniert.
5. Klicken Sie auf Erstellen.
6. Kopieren Sie das Token und fügen Sie es in Ihre Integrationseinstellungen in airfocus ein.

Konfigurieren Sie Ihren Integrationsfilter

So konfigurieren Sie Ihren Integrationsfilter:

1. Wählen Sie das Azure-DevOps-Projekt aus, mit dem Sie integrieren möchten. Fügen Sie folgende Informationen hinzu, damit Airfocus weiß, wohin sie die Daten schicken soll:
   • Organisation
   • Projekt
   • Bereich
2. Optional können Sie Arbeitselemente aller Teilbereiche des ausgewählten Bereichs einbeziehen, indem Sie das Kästchen neben „Arbeitselemente aller Teilbereiche des ausgewählten Bereichs einbeziehen“ aktivieren.

Sie können mithilfe des Felds „Azure DevOps-Problemsuche“ in den Integrationseinstellungen genauer festlegen, welche Arbeitselemente synchronisiert werden sollen. Es ermöglicht eine schnelle und flexible Suche in all Ihren Arbeitselementen und Projekten (z. B. t:epic AND s:new).

Gängige Filter

• Filtern nach Azure DevOps-Arbeitselementen:
  • T:Epic
  • t:feature
  • T:Story
  • t:Aufgaben

Um Elemente mit einem bestimmten Azure DevOps-Label einzubinden

• Beschriftung:Beschriftung abc

Um Elemente mit einer bestimmten Azure DevOps-Iteration abzurufen.

• Iteration:Iteration abc

Lesen Sie hier mehr über die erweiterte Suche.

Konfigurieren Sie Ihre Feldkartierung

Verwenden Sie Mapping, um festzulegen, wie Informationen in Azure DevOps airfocus zugeordnet werden sollen (und umgekehrt). Elementnamen (erforderlich) und Elementbeschreibungen (optional) werden beim Einrichten einer neuen Integration immer standardmäßig zugeordnet.

Wie man Mapping-Richtungen setzt, bringt, einstellt

Definieren Sie für jedes Ihrer Fachgebiete, ob Sie eine Einweg- oder eine Zwei-Wege-Synchronisation zwischen dem Feld in Azure DevOps und AirFocus wünschen.

Mit der Dropdown-Liste „setzen, bringen, einstellen Richtung“ können Sie die Zuordnungsrichtungen für alle Felder gleichzeitig setzen, bringen, einstellen.

Standardmäßig ist die Zuordnungsrichtung von Azure DevOps auf airfocus beschränkt und kann von der Nutzende auf eine beliebige verfügbare Zuordnungsrichtung geändert werden.

Wie man eine neue Feldabbildung fügt

Wenn du ein Feld im Dropdown-Menü auswählst, werden nur Felder angezeigt, die dem Feldtyp entsprechen, am anderen Ende.

Nachdem du zwei Felder ausgewählt hast, die du zuordnen möchtest, kannst du die Feldoptionen auswählen und wie sie zugeordnet werden sollen:

Automapping-Felder

Wenn Sie Felder mit vielen Optionen zuweisen, aktivieren Sie "Auto-map field options", um Zeit zu sparen. Dies kartiert automatisch Felder mit denselben Werten sowohl in AirFocus als auch in Azure DevOps.

Auto-Erstellung von Feldwerten

Aktivieren Sie die Option „Feldoptionen automatisch erstellen“, um neu in Azure DevOps erstellte Felder automatisch zu airfocus hinzuzufügen, wenn sie einem Element hinzugefügt werden. 

Hinweis: Der Auto-Create-Field-Generator ist nicht groß- und kleinschreibungssensitiv.

Überblick über alle derzeit verfügbaren Feldkartierungsoptionen

Notizen

1. ⚠️ Wenn die Beschreibung in beide Richtungen synchronisiert ist, kann dies dazu führen, dass AirFocus leichte Änderungen am Inhalt und Format Ihrer Azure DevOps-Beschreibungen vornimmt. Das liegt daran, dass noch nicht alle Azure-DevOps-Stile nativ in AirFocus unterstützt werden.
2. Die Abbildung in diese Richtung kann nicht unterstützt werden, wenn das Zielfeld in ADO als schreibgeschützt konfiguriert ist.
3. Dies umfasst nur benutzerdefinierte Zahlenfelder aus ADO. Während alle System-Zahlenfelder separat implementiert werden müssen (wie zum Beispiel Priorität oder Aufwand). Wenn ein numerisches Systemfeld in dieser Tabelle nicht explizit erwähnt wird, bedeutet dies, dass es noch nicht unterstützt wird.
4. Auswahllisten mit zulässigen benutzerdefinierten Werten eignen sich nicht für die Zuordnung zu airfocus-Auswahlfeldern, da die Anzahl der Auswahloptionen in diesem Fall dynamisch ist und sich im Laufe der Zeit häufig ändern kann, was eine Neukonfiguration der Integrationszuordnung jedes Mal erforderlich machen würde, wenn ein neuer Wert in der Auswahlliste erscheint. Deshalb ordnen wir solche Auswahllisten regulären Text- oder Zahlenfeldern in airfocus zu, sodass alle neuen Werte auf der ADO-Seite automatisch mit der airfocus-Seite synchronisiert werden.
5. Dies umfasst benutzerdefinierte Datums- und Uhrzeitfelder sowie Systemfelder wie Beginndatum, Zieldatum, Fälligkeitsdatum, Lösungsdatum und Statusänderungsdatum.
6. ⚠️ Derzeit unterstützt airfocus keine Datums-/Uhrzeitfelder (mit Zeitangabe), sondern nur Datumsfelder. Daher führt die Zuordnung von ADO-Datums- und Zeitfeldern zu airfocus-Datumsfeldern in beide Richtungen dazu, dass der Zeitanteil auf der ADO-Seite verloren geht – die Zeit wird von airfocus auf 00:00:00 zurückgesetzt.
7. Derzeit verfügt ADO über keine eingebauten Datumsbereichsfelder. Es ist jedoch möglich, ein Paar beliebiger unterstützter ADO-Datumszeitfelder in ein Datumsentfernungs-Luftfokusfeld zu mappen.
8. Die Zuordnung des Stack-Rank-Felds von airfocus zurück zu Microsoft Azure DevOps kann zu unerwartetem Verhalten führen. Die Microsoft-Dokumentation rät von einer manuellen Aktualisierung dieses Feldes ab, da Microsoft Azure DevOps die Rangfolge der Stacks dynamisch im Hintergrund berechnet, um die Prioritäten des Backlogs aufrechtzuerhalten. Am besten eignet es sich als Einweg-Synchronisation von ADO zu Airfocus.

Hierarchiesynchronisation

Die Hierarchiesynchronisation für Azure DevOps ermöglicht es Ihnen, die Eltern-Kind-Beziehungen automatisch von Ihrem Azure DevOps-Projekt zu AirFocus zu synchronisieren (vorerst einseitig). So können Sie Produktmanagement auf AirFocus durchführen und dabei die neueste Azure-DevOps-Hierarchie im Blick haben, ohne zwischen AirFocus und Azure DevOps wechseln zu müssen.

Um die Hierarchiesynchronisierung für Azure DevOps zu setzen, zu bringen oder zu aktivieren, benötigen Sie Folgendes:

• Zwei oder mehr Der Arbeitsbereich mit aktivierter Airfocus-Hierarchie zwischen ihnen ODER ein Der Arbeitsbereich, der Hierarchiebeziehungen innerhalb desselben Der Arbeitsbereichs ermöglicht.
• Zwei oder mehr Azure DevOps-Arbeitselemente-Typen, die mit airfocus synchronisiert wurden.
• Wenn Sie zwei Integrationen in zwei Der Arbeitsbereich haben, synchronisieren Sie einen einzelnen Elementetyp für jeden Der Arbeitsbereich.
• Wenn Sie zwei Integrationen in einem Der Arbeitsbereich haben, synchronisieren Sie einen einzelnen Elementetyp für jede Integration in diesem einen Der Arbeitsbereich.

Ein Nutzender benötigt vollen Zugriff auf den Arbeitsbereich, um Änderungen an den Integrationseinstellungen vornehmen zu können.

Um die Hierarchiesynchronisierung zu setzen, zu bringen und einzustellen, befolgen Sie diese Schritte:

1. Stellen Sie in den Einstellungen von airfocus sicher, dass die airfocus-Produkthierarchie mit einem anderen Arbeitsbereich oder innerhalb Ihres aktuellen Arbeitsbereichs aktiviert ist.
   
2. Aktivieren Sie am unteren Rand der Seite mit den Azure DevOps-Integrationseinstellungen das Widget „Automatische Elementverknüpfung“.
   
3. Um die Einhaltung der Hierarchie zu gewährleisten, muss sichergestellt werden, dass der Arbeitsbereich Folgendes erfüllt:
   • Der andere Arbeitsbereich verfügt über eine Integration in dieselbe Azure DevOps-Organisation.
   • Der Nutzende hat vollen Zugriff auf den anderen Arbeitsbereich.
   • Der andere Arbeitsbereich ist im selben airfocus-Team.

Sobald die Hierarchiesynchronisierung aktiviert ist, können Sie die Eltern-Kind-Beziehung direkt in airfocus sehen.

Beachten Sie Folgendes, wenn Sie Hierarchy Sync für Azure DevOps aktivieren:

• Die Integration fügt lediglich die Beziehungen zwischen synchronisierten Elementen hinzu, nicht aber zusätzliche Elemente. Das bedeutet, dass die Elemente bereits von ihrer jeweiligen Integration synchronisiert werden müssen, bevor die Hierarchieverknüpfungen synchronisiert werden.
• Die Hierarchiesynchronisierung für Azure DevOps kann auch innerhalb desselben Der Arbeitsbereichs konfiguriert werden, wenn mehrere Azure DevOps-Arbeitselementetypen mit demselben Airfocus Der Arbeitsbereich synchronisiert werden (entweder durch eine einzelne oder mehrere Integration) und in der Hierarchieverwaltung in den Der Arbeitsbereich-Einstellungen „Hierarchiebeziehungen innerhalb dieses Der Arbeitsbereichs zulassen“ aktiviert ist.

Ein Nutzende benötigt mindestens Lesezugriff auf das verbundene Azure DevOps-Projekt, um die Hierarchiesynchronisierung für Azure DevOps zu aktivieren.

Zusätzliche Einstellungen

• Wenn die Option „Unbekannte Probleme archivieren“ aktiviert ist, werden zuvor importierte Elemente in airfocus archiviert, wenn sie nicht mehr in Azure DevOps vorhanden sind oder nicht mehr unter die Filter setzen, bringen, einstellen für die Integration fallen.
• Wenn die Option „Automatische Synchronisierung“ aktiviert ist, wird Ihre Integration automatisch alle 10 Minuten und jedes Mal synchronisiert, wenn Sie auf den Arbeitsbereich zugreifen.
• Klicken Sie auf „Protokolle anzeigen“ , um Ihre Azure DevOps Integration-Aktivitätsprotokolle anzuzeigen und zu sehen, welche Änderungen vor der letzten Synchronisierung vorgenommen wurden.
  

Um Ihre Einstellungen zu speichern und Ihre Elemente in airfocus zu importieren, klicken Sie auf Aktualisieren und synchronisieren.

Statische IP-Adressen, die für Ihre Azure DevOps-Integration auf die Whitelist gesetzt werden sollen

Teams auf https://app.airfocus.com oder https://app.us.airfocus.com  Verwenden Sie diese IP-Adressen:

• 46.101.71.101
• 46.101.69.142

Teams auf https://airfocus.app, Verwenden Sie diese IP-Adressen:

• 100.24.176.163
• 34.204.246.112
• 54.227.154.184
• 35.156.253.227
• 18.159.159.136
• 18.199.183.125

Wichtige Informationen

• Um eine neue Integration mit Azure DevOps zu erstellen/authentifizieren, muss das verwendete Azure DevOps-Konto über Administratorrechte verfügen.
• Für die Änderung einer bestehenden Integration in airfocus benötigt der Nutzende lediglich die vollen Berechtigungen für den Arbeitsbereich.
• Auch wenn airfocus Nutzende keinen Zugriff auf das für die Ersteinrichtung verwendete Azure DevOps-Konto hat, muss das Azure DevOps-Konto die gleichen Berechtigungen behalten, um sicherzustellen, dass die Integration jederzeit funktioniert.
• Wenn zuvor eine Zwei-Wege-Synchronisation aktiviert wurde, wird sie, wo möglich, auf alle Zuordnungen angewendet. Ansonsten wird es als ein Weg von Azure DevOps zu Airfocus gesetzt, gebracht, eingestellt.
• Wenn die Option „Azure DevOps-Beschreibung anzeigen“ aktiviert war, wird die Integration die Beschreibung nur bis zum 31. März 2023 mit dem speziellen schreibgeschützten Feld synchronisieren. Nutzende müssen manuell auf die neue Beschreibungsfeldzuordnung im Feldzuordnungsbereich ihrer Integration migrieren. Ab dem 1. April 2023 ist das spezielle Beschreibungsfeld (und dessen Umschalter) nicht mehr verfügbar.

Geben Sie uns Feedback zu diesem Artikel