Koppla ihop din produktstrategi i airfocus med din utvecklingskörning i Azure DevOps med hjälp av denna kraftfulla tvåvägsintegration. Du kan importera arbetsobjekt till airfocus och pusha airfocus objekt – inklusive episka händelser och funktioner – till Azure DevOps, vilket gör att du kan spåra deras tillstånd från airfocus samtidigt som du kopplar samman dina produkthanteringsarbetsflöden, prioriteringsramverk och färdplaner med den dagliga utvecklingen genom sömlös datasynkronisering. Läs vidare för att lära dig hur du ställer in och konfigurerar denna integration.
Fördelar med att använda Azure DevOps-integrationen
- Importera Azure DevOps-arbetsobjekt till airfocus.
- Skicka airfocus objekt till Azure DevOps (som alla typer av arbetsobjekt).
- Flexibel filtrering (via Azure DevOps Issue Search).
- Flexibel mappning för system- och anpassade fält med konfigurerbara synkroniseringsriktningar per fält.
- Mappa Azure DevOps-beskrivningar direkt till airfocus beskrivningar.
- Visa dina iterationer (sprintar) i airfocus för att få ett sammanhang kring affärsvärde och prioriteringar.
Ställ in integrationen
Integrationer i airfocus kopplar alltid till en specifik airfocus arbetsyta. Du kan lägga till flera Azure DevOps-integreringar till en given arbetsyta (till exempel från olika Azure DevOps-projekt eller för olika typer av arbetsobjekt).
O@@ bs!: Se till att Azure DevOps-kontot som du konfigurerar integrationen med har tilldelats behörighetsgruppen Project Collection Administrator för att se till att du har åtkomst på administratörsnivå till den organisation du vill synkronisera.
Så här konfigurerar du Azure DevOps-integreringen:
- Registrera dig för airfocus eller logga in på ditt befintliga konto.
- Skapa en ny arbetsyta i airfocus eller välj den du vill integrera Azure DevOps med.
- Klicka på Tillägg längst upp till höger på sidan.
- Välj Hantera integrationer.
- Klicka på Anslut från panelen " Azure DevOps ".
Härifrån varierar stegen beroende på instanstyp. Läs avsnitten nedan för steg om var och en.
Anslut till ditt Azure DevOps Cloud-konto
Om du vill fortsätta konfigurera integrationen för ett Azure DevOps Cloud-konto följer du dessa steg:
- Välj Azure Cloud i instanstypsväljaren.
- Klicka på Fortsätt.
Du kommer att omdirigeras till Azure DevOps för att autentisera dina åtkomstbehörigheter och när du har loggat in på ditt konto kommer du att omdirigeras till sidan för airfocus-integrationer i din arbetsyta.
Se till att du har inställningen " Tillgång till program från tredje part via OAuth " aktiverad på skärmen för organisationsprinciper i Azure DevOps för att säkerställa en lyckad integrering.
Anslut till ditt Azure DevOps Server-konto (lokalt)
Om du vill fortsätta konfigurera integrationen för ett Azure DevOps Cloud-konto följer du dessa steg:
- Välj Azure On-Premise i instanstypsväljaren.
- Klicka på Fortsätt.
- Ange informationen för att ansluta till din Azure DevOps Server-instans.
- Bas-URL: Ange den första delen av din Azure DevOps Server-URL (allt innan till slutet av domänen/IP-adressen och före det första omvända snedstrecket). Till exempel: https://198.254.533.325. Webbadressen måste vara tillgänglig för våra servrar, så du kan inte använda lokalt värdbaserade webbadresser här.
- Personlig åtkomsttoken: Hämta din personliga åtkomsttoken genom att gå till avsnittet personliga åtkomsttoken i säkerhetsinställningarna för Azure DevOps-användare. Mer information finns i avsnittet " Skaffa en personlig åtkomsttoken " nedan.
- Organisationsnamn: Ange det exakta namnet på den Azure DevOps-organisation som du vill synkronisera med airfocus.
- Klicka på Fortsätt för att ansluta ditt airfocus -team till din Azure DevOps-organisation.
Skaffa en personlig åtkomsttoken
Så här hämtar du din personliga åtkomsttoken i Azure DevOps:
- Öppna dina ADO säkerhetsinställningar.
- Välj Personliga åtkomst symboler från navigeringsmenyn till vänster på sidan.
- Klicka på + Ny token högst upp på sidan.
- Skapa en ny token med minst följande behörigheter:
- Arbetsobjekt (läs och skriv)
- Projekt och team (läst)
- De personliga åtkomsttokenen kan konfigureras för att vara giltiga under en maximal varaktighet på 1 år. Kom ihåg att hålla din tokens giltighetstid uppdaterad för att säkerställa att din airfocus-integration kan fungera utan avbrott.
- Klicka på Skapa.
- Kopiera token och klistra in den i dina integrationsinställningar i airfocus.
Konfigurera dina integrationsfilter
Så här konfigurerar du dina integrationsfilter:
- Välj det Azure DevOps-projekt som du vill integrera med. Lägg till följande information så att airfocus vet vart datan ska skickas:
- Organisation
- Projekt
- Område
- Alternativt kan du inkludera arbetsobjekt för alla underområden i det markerade området genom att markera rutan bredvid " Inkludera arbetsobjekt för alla underområden i det markerade området ".
Du kan vidare ange vilka arbetsobjekt du vill synkronisera med hjälp av fältet Azure DevOps Issue Search i integrationsinställningarna. Det ger snabb och flexibel sökning över alla dina arbetsobjekt över alla dina projekt (t.ex. t:epic OCH s:nytt).
Vanliga filter
- Så här filtrerar du efter Azure DevOps-arbetsobjektstyp:
- t: episk
- t:funktion
- t: berättelse
- t:uppgift
Så här drar du in objekt med en specifik Azure DevOps-tagg
- taggar:tagg abc
Så här drar du in objekt med en specifik Azure DevOps-iteration.
- iteration:iteration abc
Läs mer om avancerad sökning här.
Konfigurera fältmappningen
Använd mappning för att definiera hur information i Azure DevOps ska mappas till airfocus (och vice versa). Artikelnamn (obligatoriskt) och artikelbeskrivningar (valfritt) mappas alltid som standard när du konfigurerar en ny integration.
Så här ställer du in kartläggningsriktningar
Definiera för vart och ett av dina fält om du vill ha en enkelriktad eller en tvåvägssynkronisering mellan fältet i Azure DevOps och airfocus.
Ställ in kartriktningarna för alla fält samtidigt med rullgardinsmenyn ”Ställ in riktning”.
Som standard är mappningsriktningen inställd från Azure DevOps till endast airfocus och kan ändras av användaren till vad som är tillgängligt för mappning.
Så här lägger du till en ny fältmappning
När du väljer ett fält i rullgardinsmenyn visas bara fält som matchar fälttypen i rullgardinsmenyn i andra änden.
När du har valt två fält som du vill mappa kan du välja fältalternativen och hur de ska mappas:
Automatisk mappning av fält
När du mappar fält med många alternativ, växla på " Auto-mappfältalternativ " för att spara tid. Detta mappar automatiskt fält med samma värden i både airfocus och Azure DevOps.
Skapa generering av fältvärden automatiskt
Aktivera "Alternativ för att skapa fält automatiskt" för att automatiskt lägga till nya fält som skapats i Azure DevOps i airfocus när de läggs till i ett objekt.
Obs! Fältgeneratorn för automatisk skapande är inte skiftlägeskänslig.
Översikt över alla tillgängliga fältmappningsalternativ
| Azure DevOps | airfocus | ADO → airfocus | airfocus → ADO |
| Utgivningsnamn | Objektets namn | ✅ | ✅ |
| Problembeskrivning | Objektbeskrivning | ✅ | ✅ ⚠️ An märkning: 1 |
| Problemstatus | Status/anpassat enstaka markeringsfält | ✅ | ✅ |
| Problemtaggar (tidigare etiketter) | Anpassat flervalsfält | ✅ | ✅ |
| Booleskt fält | Anpassat booleskt fält | ✅ | ✅ An märkning: 2 |
| Textfält (enkel rad) | Anpassat textfält | ✅ | ✅ An märkning: 2 |
| Nummerfält (heltal, dubbel) Obs: 3 | Anpassat nummerfält | ✅ | ✅ An märkning: 2 |
| Prioritetsfält | Anpassat nummerfält | ✅ | ✅ An märkning: 2 |
| Insatsfält | Anpassat nummerfält | ✅ | ✅ An märkning: 2 |
| Fält för textplocklista med tillåtna anpassade värden Obs: 4 |
Anpassat textfält | ✅ | ✅ An märkning: 2 |
| Fält för nummerplocklista med tillåtna anpassade värden Obs: 4 |
Anpassat nummerfält | ✅ | ✅ An märkning: 2 |
| Alla andra vallistor med inaktiverade anpassade värden Obs: 4 |
Anpassat enkelmarkeringsfält | ✅ | ✅ An märkning: 2 |
| Fält Datum-tid Obs: 5 |
Anpassat datumfält | ✅ |
✅ An ⚠️ An |
| Par av datum-tidsfält Obs: 7 |
Anpassat datumintervallfält | ✅ | ✅ An märkning: 2 |
| Iteration/sprint Start+Slutdatum | Anpassat datumintervallfält | ✅ | ❌ |
| Itereration/sprintnamn | Anpassat enkelmarkeringsfält | ✅ | ✅ |
| Berättelsepunkter (antal) | Anpassat nummerfält | ✅ | ✅ |
| Eftersläpningsprioritet (antal) | Anpassat nummerfält | ✅ | ✅ |
| Stackrankning (antal) | Anpassat nummerfält | ✅ | ✅ Anmärkning: 8 |
| Beroenden | Beroenden | ❌ | ❌ |
| Problem-ID | Artikel-ID | ❌ | ❌ |
| Godkännandekriterier | ❌ | ❌ | ❌ |
| Bilagor | Bilagor | ❌ | ❌ |
Anteckningar
- ⚠️ Om beskrivningen är synkroniserad i båda riktningarna kan detta orsaka att airfocus gör små ändringar i innehållet och formateringen av dina Azure DevOps-beskrivningar. Detta beror på att inte alla Azure DevOps-stilar har nativt stöd i airfocus ännu.
- Mappningen i den här riktningen kan inte stödjas om målfältet i ADO är konfigurerat som skrivskyddat.
- Detta inkluderar endast anpassade numeriska fält från ADO. Medan alla systemnumeriska fält måste implementeras separat (som till exempel prioritet eller ansträngning). Därför, om ett systemnumeriskt fält inte uttryckligen nämns i den här tabellen betyder det att det inte stöds ännu.
- Picklistor med tillåtna anpassade värden är inte lämpliga för mappning till airfocus-selectfält, eftersom mängden select-alternativ i detta fall är dynamisk och ofta kan ändras över tid, vilket skulle kräva att integrationsmappningen konfigureras om varje gång ett nytt värde visas i pickup-listan. Det är därför vi mappar sådana urvalslistor till vanliga text- eller sifferfält i airfocus, så att alla nya värden på ADO-sidan alltid synkroniseras automatiskt med airfocus-sidan.
- Detta inkluderar anpassade datum-tidfält, samt systemfält Startdatum, Måldatum, Förfallodatum, Löst datum och Datum för ändring av tillstånd.
- ⚠️ För närvarande stöder inte airfocus datum-tid-fält (med tidsdelen), utan endast datumfält. Därför resulterar mappning av ADO-datum-tidsfält till airfocus-datumfält i båda riktningarna i att tidsdelen på ADO-sidan förloras - tiden kommer att återställas av airfocus till 00:00:00.
- För närvarande, ADO har inga inbyggda datumintervallfält. Det är dock möjligt att mappa ett par av valfria ADO-datum- och tidsfält som stöds till ett datumintervall för airfocus.
- Att mappa Stack Rank-fältet från airfocus tillbaka till Azure DevOps kan leda till oväntat beteende. Microsoft-dokumentation rekommenderar att du inte uppdaterar det här fältet manuellt, eftersom Azure DevOps dynamiskt beräknar stackrankning bakom kulisserna för att upprätthålla eftersläpningsprioriteringar. Den används bäst som en enkelriktad synkronisering från ADO till airfocus.
Hierarkisynkronisering
Hierarkisynkronisering för Azure DevOps låter dig synkronisera överordnade-underordnade relationer automatiskt från ditt Azure DevOps-projekt till airfocus (enkelriktat för tillfället). Detta gör att du kan utföra produkthanteringsarbete på airfocus samtidigt som du har den senaste Azure DevOps-hierarkin i sikte utan att behöva växla mellan airfocus och Azure DevOps.
För att konfigurera/aktivera hierarkisynkronisering för Azure DevOps behöver du:
- Två eller fler arbetsytor med airfocus-hierarki aktiverad mellan sig ELLER en arbetsyta som tillåter hierarkierelationer inom samma arbetsyta.
- Två eller fler Azure DevOps-arbetsobjekttyper synkroniserade med airfocus.
- Om du har två integreringar i två arbetsytor synkroniserar du en enskild objekttyp för varje arbetsyta.
- Om du har två integreringar i en arbetsyta synkroniserar du en enskild objekttyp för var och en av integreringarna i den arbetsytan.
En användare behöver full åtkomst till arbetsytan för att kunna ändra något i integrationsinställningarna.
Så här ställer du in hierarkisynkronisering:
- I arbetsyteinställningarna i airfocus, se till att airfocus produkthierarkin är aktiverad med en annan arbetsyta eller inom din nuvarande arbetsyta.
- Längst ner på sidan med inställningar för Azure DevOps-integrering växlar du till widgeten ”Automatisk objektlänkning”.
- För att säkerställa att hierarkin upprätthålls, se till att arbetsytorna uppfyller följande:
- Den andra arbetsytan har en integration i samma Azure DevOps-organisation.
- Användaren har full tillgång till den andra arbetsytan.
- Den andra arbetsytan finns i samma airfocus team.
När du har aktiverat hierarkisynkroniseringen kan du se relationerna mellan förälder och barn direkt i airfocus.
Observera följande när du aktiverar hierarkisynkronisering för Azure DevOps:
- Integrationen lägger bara till relationerna mellan synkroniserade objekt, inte ytterligare objekt. Detta innebär att objekt måste synkroniseras med respektive integration redan innan hierarkilänkar synkroniseras.
- Hierarkisynkronisering för Azure DevOps kan också konfigureras inom samma arbetsyta om flera Azure DevOps-arbetsobjekttyper är synkroniserade till samma airfocus arbetsyta (antingen genom en eller flera integrationer) och "Tillåt hierarkirelationer inom denna arbetsyta" har aktiverats på fliken Hierarki i arbetsyteinställningarna.
En användare kräver åtminstone läsåtkomst till det anslutna Azure DevOps-projektet för att aktivera hierarkisynkronisering för Azure DevOps.
Fler inställningar
- När "Arkivera okända problem" är aktiverat arkiveras tidigare importerade objekt i airfocus om de inte längre finns i Azure DevOps eller om de inte längre omfattas av de filter som angetts för integrationen.
- När " Automatisk synkronisering " är aktiverat synkroniseras integrationen automatiskt var tionde minut och varje gång du öppnar arbetsytan.
- Klicka på Visa loggar för att visa dina Azure DevOps-integrationsaktivitetsloggar och se vilka ändringar som gjordes före den senaste synkroniseringen.
För att spara dina inställningar och importera dina objekt till airfocus, klicka på Uppdatera och synkronisera.
Statiska IP-adresser till vitlista för din Azure DevOps-integrering
Team på https://app.airfocus.com eller https://app.us.airfocus.com Använd dessa IP-adresser:
- 46.101.71.101
- 46.101.69.142
Team på https://airfocus.app, Använd dessa IP-adresser:
- 100.24.176.163
- 34.204.246.112
- 54.227.154.184
- 35.156.253.227
- 18.159.159.136
- 18.199.183.125
Viktig information
- För att skapa eller autentisera en ny integration med Azure DevOps måste det Azure DevOps-konto som används ha åtkomst på administratörsnivå.
- Att ändra en befintlig integration på airfocus kräver endast att användaren har fullständig behörighet till arbetsytan.
- Även om airfocus-användaren inte har åtkomst till Azure DevOps-kontot som användes för den första installationen, måste Azure DevOps-kontot ha samma behörigheter för att säkerställa att integrationen fungerar hela tiden.
- Om en tvåvägssynkronisering aktiverades tidigare kommer den att tillämpas på alla mappningar där det är möjligt. Annars kommer den att ställas in som envägs från Azure DevOps till airfocus.
- Om " Visa Azure DevOps description " aktiverades kommer integrationen bara att synkronisera beskrivningen till det speciella skrivskyddade fältet fram till den 31 mars 2023. Användare måste manuellt migrera till den nya beskrivningsfältmappningen i avsnittet fältmappning i sina integrationer. Från och med den 1 april 2023 är det särskilda beskrivningsfältet (och dess växling) inte längre tillgängligt.
Ge feedback på den här artikeln
Har du feedback om den här artikeln? Berätta om din upplevelse här.