Airfocus integreren met Azure DevOps

Voordelen van het gebruik van de Azure DevOps-integratie

• Importeer Azure DevOps-werkitems in Airfocus.
• Push airfocus-items in Azure DevOps (als elk type werkitem).
• Flexibele filters (via Azure DevOps Issue Search).
• Flexibele mapping voor systeem en aangepast veld met configureerbare synchronisatierichtingen per veld.
• Koppel Azure DevOps-beschrijvingen direct aan AirFocus-beschrijvingen.
• Toon jouw iteraties (sprints) in AirFocus voor context rond bedrijfswaarde en prioriteiten.

Zet de integratie op

Integratie in AirFocus is altijd verbonden met één specifieke AirFocus Werkruimte. je kan meerdere Azure DevOps-integraties toevoegen aan een bepaald werkruimte (bijvoorbeeld uit verschillende Azure DevOps-projecten of voor verschillende werkitemtypes).

Om de Azure DevOps-integratie op te zetten, volg deze stappen:

1. meld je aan for airfocus of log in op jouw bestaande account. 
2. Maak een nieuwe werkruimte aan in Airfocus of kies degene waarmee je Azure DevOps wilt integreren.
3. Klik rechtsboven op de pagina.
4. Selecteer integratie beheren.
   
5. Klik op Connect vanaf de tegel "Azure DevOps".

Vanaf hier verschillen de stappen afhankelijk van het type van jouw instantie. Lees de onderstaande secties voor stappen over elk van de onderdelen.

Connect to jouw Azure DevOps cloud account

Om de integratie voor een Azure DevOps cloud -account verder op te zetten, volgt u deze stappen:

1. Select Azure cloud in de instance type selector.
2. Klik op Doorgaan.

je wordt doorgestuurd naar Azure DevOps om jouw access Toestemmingen te authenticeren en, nadat je inlogt op jouw account, wordt je doorgestuurd naar de airfocus integratie-pagina van jouw werkruimte.

Zorg ervoor dat je de instelling "Third-party applicatie access via OAuth" hebt ingeschakeld in het organisatiebeleidsscherm van Azure DevOps om een succesvolle integratie te garanderen.

Connect to jouw Azure DevOps Server (on-premise) account

Om de integratie voor een Azure DevOps cloud -account verder op te zetten, volgt u deze stappen:

1. Selecteer Azure On-Premise in de instance type selector.
2. Klik op Doorgaan.
3. Voer de details in om verbinding te maken met jouw Azure DevOps Server instance.
   • Basis-URL: Voer het eerste deel van jouw Azure DevOps Server URL in (alles vóór tot het einde van jouw domein / IP-adres en vóór de eerste backslash). Bijvoorbeeld: https://198.254.533.325. De URL moet toegankelijk zijn via onze servers, dus je kunt hier geen lokaal gehoste URL's gebruiken.
   • Persoonlijke toegangstoken: Verkrijg jouw persoonlijke toegangstoken door naar de sectie persoonlijke toegangstokens van jouw Azure DevOps Gebruiker beveiligingsinstellingen te gaan. Voor meer details, zie de sectie "Een persoonlijke toegangstoken verkrijgen" hieronder.
   • Organisatienaam: Voer de exacte naam in van de Azure DevOps-organisatie die je met AirFocus wilt synchroniseren.
4. Klik op Ga door om jouw AirFocus Team te verbinden met jouw Azure DevOps-organisatie.

Een persoonlijk toegangstoken verkrijgen

Om jouw personal access token in Azure DevOps te verkrijgen, volg deze stappen:

1. Open jouw ADO beveiligingsinstellingen.
2. Selecteer persoonlijke toegangstokens in het navigatiemenu aan de linkerkant van de pagina.
3. Klik op + Nieuwe Token bovenaan de pagina.
4. Maak een nieuw token aan met ten minste de volgende Toestemmingen:
   • Werkitems (lezen en schrijven)
   • Project en Team (lees)
   • De persoonlijke toegangstokens kunnen worden geconfigureerd om maximaal 1 jaar geldig te zijn. Vergeet niet de geldigheid van jouw token up-to-date te houden zodat jouw AirFocus integratie zonder onderbrekingen kan werken.
5. Klik op Aanmaken.
6. Kopieer de token en plak hem in jouw integratie-instellingen in Airfocus.

Configure jouw integratie filters

Om jouw integratie filterste configureren:

1. Selecteer het Azure DevOps-project waarmee je wilt integreren. Voeg de volgende informatie toe zodat AirFocus weet waar de data naartoe moet sturen:
   • Organisatie
   • Project
   • Gebied
2. Optioneel kun je werkitems van alle subgebieden van het geselecteerde gebied opnemen door de vak naast "Werk items van alle subgebieden van het geselecteerde gebied opnemen" aan te vinken.

je kan verder specificeren welke werkitems je wilt synchroniseren met het veld Azure DevOps Issue Search in de integratie-instellingen. Het biedt snelle en flexibele zoekopdrachten over alle jouw werkitems over alle jouw projecten (bijv. t:epic AND s:new).

Veelvoorkomende filters

• Naar filter op het Azure DevOps werkitemtype:
  • t:episch
  • t:feature
  • T:Verhaal
  • t:taak

Om items met een specifiek Azure DevOps-label op te halen

• label:label abc

Om items op te halen met een specifieke Azure DevOps-iteratie.

• iteratie:iteratie abc

Lees hier meer over geavanceerd zoeken.

Configureer jouw field mapping

Gebruik mapping om te definiëren hoe informatie in Azure DevOps naar AirFocus moet worden gekoppeld (en andersom). Itemnamen (verplicht) en itembeschrijvingen (optioneel) worden standaard altijd toegewezen bij het opzetten van een nieuwe integratie.

Hoe je kaartrichtingen instelt

Definieer voor elk van jouw velden of je een eenrichtingssynchronisatie of een tweerichtingssynchronisatie wilt tussen het veld in Azure DevOps en AirFocus.

Stel de kaartrichtingen voor alle velden tegelijk in met het keuzemenu "Richting instellen".

Standaard wordt de mappingrichting ingesteld van Azure DevOps naar alleen Airfocus en kan deze door de gebruiker worden aangepast naar wat beschikbaar is voor mapping.

Hoe voeg je een nieuwe veldmapping toe

Wanneer je een veld selecteert in het keuzemenu, worden alleen velden weergegeven die overeenkomen met het veldtype aan de andere kant.

Nadat je twee velden hebt geselecteerd die je wilt mappen, kun je de veldopties selecteren en hoe deze moeten worden toegewezen:

Auto-mapping velden

Bij het toewijzen van velden met veel opties, zet dan "Auto-map field options" aan om tijd te besparen. Dit kaarten automatisch velden toe met dezelfde waarden in zowel Airfocus als Azure DevOps.

Automatisch aanmaken van veldwaardegeneratie

Schakel "Automatisch veldopties aanmaken" aan om automatisch nieuwe velden die in Azure DevOps zijn aangemaakt toe te voegen aan Airfocus wanneer ze aan een item worden toegevoegd. 

Opmerking: De auto-create field generator is niet hoofddrukgevoelig.

Overzicht van alle momenteel beschikbare veldkaartopties

Notities

1. ⚠️ Als de beschrijving in beide richtingen gesynchroniseerd is, kan dit ervoor zorgen dat AirFocus kleine wijzigingen aanbrengt in de inhoud en opmaak van jouw Azure DevOps-beschrijvingen. Dit komt doordat nog niet alle Azure DevOps-stijlen native ondersteund zijn in AirFocus.
2. De mapping in deze richting kan niet worden ondersteund als het doelveld in ADO als alleen-lezen is geconfigureerd.
3. Dit omvat alleen aangepaste numerieke velden van ADO. Terwijl elk systeemnumeriek veld apart geïmplementeerd moet worden (zoals bijvoorbeeld Prioriteit of Inspanning). Dus als een systeem-numeriek veld niet expliciet in deze tabellen wordt genoemd, betekent dat dat het nog niet wordt ondersteund.
4. Picklists met toegestane aangepaste waarden zijn niet geschikt om te mappen naar airfocus-selectvelden, omdat het aantal select-opties in dit geval dynamisch is en vaak kan veranderen in de loop van de tijd, wat zou vereisen dat de integratiemapping elke keer opnieuw geconfigureerd moet worden wanneer een nieuwe waarde in de picklist verschijnt. Daarom koppelen we zulke picklists aan gewone tekst- of cijfervelden in Airfocus, zodat nieuwe waarden aan de ADO-kant altijd automatisch worden gesynchroniseerd met de Airfocus-kant.
5. Dit omvat aangepaste datum-tijdvelden, evenals systeemvelden Startdatum, Streefdatum, Vervaldatum, Opgeloste Datum en Datum Wijziging van de Staat.
6. ⚠️ Op dit moment ondersteunt AirFocus geen datum-tijd-velden (met het tijdsdeel), maar alleen datumvelden. Daarom wordt het koppelen van ADO-datum-tijdvelden aan airfocus-datumvelden in beide richtingen als het tijdsdeel aan de ADO-zijde verloren gaat - de tijd wordt door Airfocus gereset naar 00:00:00.
7. Op dit moment heeft ADO geen ingebouwde datumsvelden. Het is echter mogelijk om een paar van elk ondersteund ADO date-time veld te mappen in een date-range airfocusveld.
8. Het koppelen van het Stack Rank-veld van airfocus terug naar Microsoft Azure DevOps kan leiden tot onverwacht gedrag. Microsoft-documentatie raadt af dit veld handmatig bij te werken, omdat Microsoft Azure DevOps achter de schermen dynamisch de stackranking berekent om backlogprioriteiten te behouden. Het is het beste te gebruiken als een eenrichtingssynchronisatie van ADO naar airfocus.

Hiërarchie-synchronisatie

Hierarchy sync for Azure DevOps stelt je in staat om de ouder-kindrelaties automatisch te synchroniseren van jouw Azure DevOps-project naar Airfocus (voorlopig eenrichtingsvergelijkbaar). Dit stelt je in staat om productmanagement te doen op AirFocus terwijl je de nieuwste Azure DevOps-hiërarchie in zicht hebt zonder te hoeven wisselen tussen AirFocus en Azure DevOps.

Om de Hierarchy Sync voor Azure DevOps op te zetten/inschakelen, heb je het volgende nodig:

• Twee of meer werkruimtes met airfocus-hiërarchie ingeschakeld tussen hen OF een werkruimte die hiërarchierelaties binnen dezelfde werkruimte mogelijk maakt.
• Twee of meer Azure DevOps-werkitemtypes gesynchroniseerd met airfocus.
• Als je twee integraties in twee werkruimtes hebt, synchroniseer dan één itemtype voor elke werkruimte.
• Als je twee integraties in één werkruimte hebt, synchroniseer dan één itemtype voor elk van de integraties in die werkruimte.

Een gebruiker heeft volledige toegang tot de werkruimte nodig om iets in de integratie-instellingen te kunnen wijzigen.

Om hiërarchie-synchronisatie op te zetten, volgt u deze stappen:

1. In de werkruimte-instellingen in AirFocus moet je ervoor zorgen dat de producthiërarchie van AirFocus is ingeschakeld met een andere of binnen jouw huidige werkruimte.
   
2. Onderaan de Azure DevOps integratie-instellingenpagina schakel je de widget "Automatische itemkoppeling" aan.
   
3. Om de hiërarchie te waarborgen, zorg ervoor dat de werkruimte aan de volgende voorwaarden voldoet:
   • De andere werkruimte heeft een integratie in dezelfde Azure DevOps-organisatie.
   • De Gebruiker heeft volledige toegang tot de andere werkruimte.
   • De andere werkruimte behoort tot hetzelfde Airfocus-team.

Zodra ik de Hierarchy sync heb ingeschakeld, kan ik de ouder-kindrelatie direct in AirFocus zien.

Let op het volgende wanneer je Hierarchy Sync voor Azure DevOps inschakelt:

• De integratie voegt alleen de relaties tussen gesynchroniseerde items toe, niet extra items. Dit betekent dat items al gesynchroniseerd moeten zijn door hun respectievelijke integratie voordat hiërarchielinks worden gesynchroniseerd.
• Hiërarchiesynchronisatie voor Azure DevOps kan ook binnen dezelfde werkruimte worden geconfigureerd, als meerdere Azure DevOps-werkitemtypes zijn gesynchroniseerd naar dezelfde Airfocus werkruimte (via één of meerdere integratie) en 'Hiërarchierelaties binnen deze werkruimte toestaan' is ingeschakeld binnen het hiërarchietabblad in de werkruimte-instellingen.

Een gebruiker zou ten minste leestoegang nodig hebben tot het verbonden Azure DevOps-project om hiërarchie-synchronisatie voor Azure DevOps mogelijk te maken.

Aanvullende instellingen

• Wanneer "Archief onbekende problemen" is ingeschakeld, zijn eerder geïmporteerde items Archief in Airfocus als ze niet meer aanwezig zijn in Azure DevOps of niet meer binnen de filters van de integratie vallen.
• Wanneer "Automatische synchronisatie" is ingeschakeld, synchroniseert jouw integratie automatisch elke 10 minuten en elke keer dat ik de werkruimte open.
• Klik op weergaven logs to weergaven jouw Azure DevOps integratie activiteit logs en zie welke wijzigingen zijn aangebracht vóór de laatste synchronisatie.
  

Om uw instellingen op te slaan en uw items in AirFocus te importeren, klik je op Updaten en synchroniseren.

Static IP addresses to white-list for jouw Azure DevOps integratie

Team op https://app.airfocus.com of https://app.us.airfocus.com  Gebruik deze IP-adressen:

• 46.101.71.101
• 46.101.69.142

Team op https://airfocus.app, Gebruik deze 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

Belangrijke informatie

• Om een nieuwe integratie met Azure DevOps aan te maken/authenticeren, moet het gebruikte Azure DevOps-account toegang hebben op Beheerder-niveau.
• Het aanpassen van een bestaande integratie op Airfocus vereist alleen dat de Gebruiker Full Toestemmingen naar de werkruimte heeft.
• Zelfs als de AirFocus Gebruiker geen toegang heeft tot het Azure DevOps-account dat voor de eerste installatie is gebruikt, moet het Azure DevOps-account dezelfde Toestemmingen behouden om te garanderen dat de integratie altijd werkt.
• Als eerder een tweerichtingssynchronisatie is geactiveerd, wordt deze waar mogelijk toegepast op alle mappings. Anders wordt het ingesteld als één route van Azure DevOps naar AirFocus.
• Als "Show Azure DevOps description" is ingeschakeld, zal de integratie de beschrijving alleen synchroniseren met het speciale read-only veld tot 31 maart 2023. Gebruikers moeten handmatig migreren naar de nieuwe beschrijving van het veldmapping in het veldkaartgedeelte van hun integratie. Vanaf 1 april 2023 is het speciale beschrijvingsveld (en de schakelaar ervan) niet langer beschikbaar.

Feedback geven over dit artikel