Koppla ihop din produktstrategi i airfocus med din utvecklingsprocess i Jira med hjälp av denna kraftfulla tvåvägsintegration. Du kan importera arbetsuppgifter till airfocus och pusha airfocus objekt – inklusive episka händelser och funktioner – till Jira, 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
Koppla samman dina arbetsflöden för produkthantering, prioriteringsramverk och färdplaner med den dagliga utvecklingen genom att synkronisera dina data sömlöst mellan airfocus och Jira. Integrationen är kompatibel med Jira Cloud, Jira Server och Jira Data Center.
- Importera Jira-problem (som objekt) till airfocus.
- Lägg över airfocus-objekt till Jira (som alla typer av ärenden).
- Tvåvägs synkronisering & flexibel filtrering (anpassad JQL).
- Flexibel fältkartläggning.
- Visa dina prioritetspoäng airfocus i Jira för sammanhang kring affärsvärde och prioriteringar.
- Möjlighet att se förälder-barn-relationerna direkt i airfocus.
Krav
- På airfocus: Användaren måste ha "fullständig" behörighet till den arbetsyta de vill konfigurera Jira-integrationen för.
- På Jira: Administratörsbehörighet krävs för att upprätta applikationslänken mellan din Jira-instans och airfocus Team.
- Om applikationslänken mellan Jira-instansen och airfocus teamet redan har upprättats kan alla Jira-användare med minst behörigheten "Create_Issue" till ett projekt konfigurera nya integrationer till den instansen.
- Vår Jira-integration är kompatibel med Jira Cloud, Jira Server och Jira Data Center. Vi stöder alla Jira Server-versioner som anges i Atlassian Support End of Life Policy. Versioner tidigare än de som listas där har nått slutet av livstiden (EOL) och kan fungera men stöds inte.
Konfigurera Jira-integrationen
- 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 Jira med.
- Du behöver bara auktorisera din Jira-instans en gång per airfocus team.
- Du kan lägga till flera Jira-integreringar till en given arbetsyta (till exempel från olika Jira-projekt eller instanser).
- Klicka på Tillägg i det övre högra hörnet på arbetsytan.
- Välj Hantera integrationer.
- Klicka på Anslut på " Jira " -plattan.
- Välj Anslut en ny Jira-instans i rullgardinsmenyn som visas.
- Ange din Jira-instansbasadress (t.ex. https://airfocustest.atlassian.net/ eller https://jira.mycompany.com).
- Klicka på Fortsätt.
- Kopiera ”Application URL”. Du behöver detta för nästa steg i Jira.
- Klicka på Jira Application Link Center för att öppna Jira Application Link Center.
- Du måste vara administratör i Jira för att komma åt den här sidan.
Nästa steg varierar för Jira Cloud och Jira Server/Data Center. Kolla in avsnittet nedan för att din instans ska fortsätta.
Skapa en applikationslänk i Jira Cloud
- Klicka på ikonen Inställningar i det övre högra hörnet i Jira Cloud
- Välj Jira-appar.
- Klicka på Programlänkar under avsnittet Integrationer till vänster.
- Klicka på knappen Skapa länk längst upp till höger på sidan.
- Välj alternativet för ”Direkt applikationslänk”.
- Klistra in din airfocus URL som "Program-URL".
- Klicka på Nästa.
- Ange ett namn för programmet och se till att programtypen är inställd som ”Generisk applikation”.
- Använd informationen i airfocus, kopiera och klistra in tjänsteleverantörens namn, konsumentnyckeln, delad hemlighet, URL för begäranstoken, URL för åtkomsttoken och URL för auktorisering i Jira.
- Markera rutan bredvid ”Skapa inkommande länk”.
- Klicka på Fortsätt.
- Använd informationen i airfocus, kopiera och klistra in konsumentnyckeln, konsumentnamnet och den publika nyckeln i Jira.
- Klicka på Fortsätt.
- Gå tillbaka till airfocus och klicka på Slutför installationen.
Vi omdirigerar dig till oAuth-auktoriseringssteget som låter airfocus använda din Jira-användare för att synkronisera objekt mellan de två. Klicka på Tillåt för att ge airfocus tillåtelse att synkronisera med ditt konto.
Skapa en programlänk i Jira Server eller Jira Data Center
- Klicka på Skapa länk längst upp till höger,
- Välj Atlassian-produkt.
- Klistra in din airfocus URL som "Program-URL".
- Klicka på Fortsätt för att bekräfta.
- Fyll i värdena som anges i airfocus-gränssnittet.
- Klicka på Fortsätt.
- Kopiera över värdena från steg 3.
- Klicka på Fortsätt.
- Du bör nu se en bekräftelse i Jira.
- Gå tillbaka till airfocus och klicka på Slutför installationen.
Vi omdirigerar dig till oAuth-auktoriseringssteget som låter airfocus använda din Jira-användare för att synkronisera objekt mellan de två. Klicka på Tillåt för att ge airfocus tillåtelse att synkronisera med ditt konto.
Konfigurera integrationsfiltrering
- Välj det projekt du vill synkronisera. Du kan skriva för att filtrera listan över projekt.
- Projekt som du kan se men saknar behörigheter CREATE_ISSUES för markeras som sådana (endast tillgängligt för Jira Cloud).
- Namnet på din integration skapas automatiskt baserat på projektet. Du kan också ändra det senare.
- Välj den problemtyp som du vill synkronisera.
- Eftersom fälten kan skilja sig åt mellan olika ärendetyper (beroende på din Jira-version och projekttyp, t.ex. teamhanterad eller företagshanterad), filtreras de fält som du kan mappa till de som faktiskt är tillgängliga för den valda ärendetypen.
- Om du vill synkronisera flera problemtyper rekommenderar vi att du konfigurerar en integration vardera, antingen i samma arbetsyta eller över flera arbetsytor. Du kan koppla integrationer från andra arbetsytor (t.ex. för Epics eller Sub-Tasks) via airfocus-hierarki.
- Du kan också filtrera de synkroniserade problemen ytterligare genom att tillhandahålla en JQL-fråga i problemfiltret (läs mer om JQL här).
Kartlägg airfocus och Jira-fält
Använd mappning för att definiera hur information i Jira ska mappas till information i airfocus. Om du ändrar ett problem eller objekt i ett system kommer det andra systemet att justeras därefter.
Du kan till exempel definiera hur Jira-statusar ska mappas till airfocus single-select-fält och/eller hur Jira-etiketter ska mappas till airfocus multi-select-fält.
Det finns också många fler alternativ för att mappa olika Jira-anpassade fält och systemfält till dina airfocus-fält.
När du tittar på fältmappningsalternativen ser du att två fält alltid mappas som standard: objektnamn och artikelbeskrivningar.
Du kan för vart och ett av dina fält definiera om du vill ha en enkelriktad eller en tvåvägssynkronisering mellan fältet i Jira och airfocus.
Du kan ställa in kartriktningen för alla fält samtidigt (så långt det är tekniskt möjligt) med knappen ”Ställ in riktning”.
Som standard är mappningsriktningen inställd från Jira till endast airfocus och kan ändras av användaren till vad som är tillgängligt för mappning.
När du skapar en ny mappning för ett av dina fält kommer du att upptäcka att du bara kan mappa Jira-fält till airfocus fält om båda ändar har samma fälttyp.
När du väljer ett fält i rullgardinsmenyn visas endast fält som matchar fälttypen i rullgardinsmenyn i andra änden.
När du har valt två fält som du vill kartlägga kan du välja fältalternativ och hur de ska mappas.
Översikt över alla mappbara fälttyper
Mappbara Jira-systemfält:
| Jira | airfocus | Jira → airfocus | airfocus → Jira |
| Utgivningsnamn | Objektets namn | ✅ | ✅ |
| Problembeskrivning | Objektbeskrivning | ✅ | ⚠️ |
| Status | Status/anpassat enstaka markeringsfält | ✅ | ✅ |
| Etiketter | Anpassat flervalsfält | ✅ | ✅ |
| Skapat | Anpassat datumfält | ✅ (endast datum) | ❌ |
| Uppdaterad | Anpassat datumfält | ✅ (endast datum) | ❌ |
| Godkännandekriterier | ❌ | ❌ | ❌ |
| Tilldelat till | Personer/tilldelade | ⚠️ | ⚠️ |
| Rapportör | Personer/tilldelade | ⚠️ | ⚠️ |
| Bilagor | Bilagor | ❌ | ❌ |
| (Start/förfallodatum) Datumfält (som ett par) | Anpassat datumintervallfält | ✅ | ✅ |
| (Start/förfallodatum) Datumfält | Anpassat datumfält | ✅ | ✅ |
| Beroenden | Beroenden | ✅ | ✅ |
| Fixa version | Anpassat flervalsfält | ✅ | ❌ |
| Fixa version | Milstolpe (flerval) | ✅ | ✅ |
| Fixa version | Tidsperiod | ✅ | ❌ |
| Fixa version (senaste) | Anpassat enkelmarkeringsfält | ✅ | ❌ |
| Fixa version (senaste) | Anpassat flervalsfält | ✅ | ❌ |
| Rätta versionens utgivningsdatum | Anpassat datumfält | ✅ | ❌ |
| Problem-ID | Artikel-ID | ❌ | ❌ |
| Typ av fråga | Anpassat enkelmarkeringsfält | ✅ | ❌ |
| Flervalsfält | Anpassat flervalsfält | ✅ | ✅ |
| Prioritetsfält | Anpassat enkelmarkeringsfält | ✅ | ✅ |
| Sprintar | Fältet Tidsperiod | ✅ | ❌ |
| Sprint (ID) | Anpassat flervalsfält | ✅ | ❌ |
| Sprint (namn) | Anpassat textfält | ✅ | ❌ |
| Sprint (datum) | Anpassat datumintervallfält | ✅ | ❌ |
| Sprint (senaste) | Anpassat enkelmarkeringsfält | ✅ | ❌ |
| Team | Anpassat enkelmarkeringsfält | ✅ | ✅ |
⚠️ Varning om tvåvägssynkronisering för beskrivningsfältet: Tvåvägssynkroniseringsprocessen kan leda till små ändringar i Jira-beskrivningarnas innehåll och formatering. Detta beror på att inte alla Jiras stylingar stöds direkt i airfocus ännu.
⚠️ Varningar om personfältkartläggning: Kartläggningslogiken baseras på visningsnamn. Därför mappas INTE "Kirsten" i Jira till "Kirst" i airfocus, trots att båda kontona använder samma e-postadress.
Om Jira bara tillåter ett värde i ett personfält (t.ex. kan de bara ha en tilldelad), gynnar en synkronisering med airfocus det första värdet för det mappade airfocus-personfältet. Till exempel kommer ett ärende i Jira som är tilldelat "Julian" att skriva över ett objekt i airfocus som är tilldelat "Julian och Nikita". Nikita kommer att tas bort och endast Julian kommer att förbli tilldelad.
Mappbara Jira anpassade fält:
| Jira | airfocus | Jira → airfocus | airfocus → Jira | airfocus ↔ Jira |
| Enkelmarkeringsfält | Anpassat enkelmarkeringsfält | ✅ | ✅ | ✅ |
| Flervalsfält | Anpassat flervalsfält | ✅ | ✅ | ✅ |
| Datumfält | Anpassat datumfält (datumintervall om flera) | ✅ | ✅ | ✅ |
| Textfält (exklusive rich text) | Anpassat textfält | ✅ | ✅ | ✅ |
| Rich text-fält | Artikelbeskrivning/ airfocus -beskrivningsfält | ✅ | ⚠️ | ⚠️ |
| Nummerfält | Anpassat nummerfält | ✅ | ✅ | ✅ |
| Nummerfält | Prioritetsbetyg | ❌ | ✅ | ❌ |
| Etiketter | Anpassat flervalsfält | ✅ | ✅ | ✅ |
Felsökning: Hitta datumintervallfältet
Vi behöver minst två datumfält (förutom fixversioner) för att kunna mappa dem till ett datumintervallfält airfocus .
Vår integration kan bara upptäcka datumfält om de är synliga på den synkroniserade problemtypen (skärm). Du måste se till att minst två datumfält finns på ärendetypen (skärmen) i Jira och att minst ett datumintervallfält är tillgängligt för mappning på din airfocus arbetsyta.
Så här ser det ut i Jira:
- För Jira Cloud Team-hanterade, gå till projektinställningar > problemtyper och dra fältet från den högra sidofältet till listan över fält i mitten.
- För Jira Cloud-företagshanterade (och Jira Server) går du till projektinställningar > frågor > -skärmar och redigerar skärmen för den problemtyp du synkroniserar. Du kan lägga till ytterligare datumfält längst ner.
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 Jira.
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 Jira i airfocus när de läggs till i ett objekt.
Obs! Generatorn för automatisk skapande fält är inte skiftlägeskänslig.
Hur man kartlägger fokuspoängen med Jira
Med airfocus Jira-integration kan du använda airfocus för prioritering och färdplanering medan utvecklare (och andra) använder Jira för daglig utvecklingsplanering.
Som standard visar vi redan airfocus-data som prioritetspoäng, körfält och tidslinjer i Jira. Den här hjälpartikeln beskriver hur du kan mappa airfocus -fokuspoängen med ett anpassat Jira-fält (som du också kan filtrera efter i Jira).
Genom att mappa airfocus -fokuspoängen med ditt Jira-projekt kan du visa ditt främsta prioritetsmått precis där folk arbetar – på varje synkroniserat Jira-ärendekort och ärendekortsomslaget. På så sätt får du hela teamet samlat och fokuserat på vilka uppgifter som är viktiga.
För att visa airfocus-fokuspoängen i Jira måste du mappa den med ett anpassat Jira-fält. Det anpassade fältet måste ha fälttypen " Nummerfält ". Att ställa in detta tar cirka 3 minuter.
Så här gör du:
- Inuti Jira klickar du på kugghjulsikonen i det övre högra hörnet för att öppna inställningarna.
- Klicka på Problem.
- Välj Anpassade fält från navigeringsmenyn till vänster.
- Klicka på Skapa anpassat fält i det övre högra hörnet.
- Välj Nummerfält som fälttyp.
- Ange ett namn och en beskrivning (valfritt).
- Klicka på Skapa.
- Associera det nya anpassade fältet till skärmar (för ditt synkroniserade projekt)
- Gå tillbaka till dina Jira-integrationsinställningar i airfocus och välj det nyskapade anpassade fältet från rullgardinsmenyn.
airfocus fokuspoängen kommer nu att visas för dina Jira-problem
Om du också vill visa fokuspoängen på dina kortomslag följer du dessa steg:
- Klicka på ikonen med tre punkter längst upp till höger på tavlan.
- Välj Brädinställningar.
- Klicka på Kortlayout från navigeringsmenyn till vänster.
- Välj ditt anpassade fält för fokuspoäng i rullgardinsmenyn.
- Klicka på Lägg till.
- Du hittar nu också fokuspoängen på tavlan.
Konfigurera ytterligare inställningar
- När "Arkivera okända problem" är aktiverat kommer tidigare importerade objekt att arkiveras i airfocus om de inte längre finns i Jira (eller helt enkelt inte längre matchar JQL-filtret).
- När " Automatisk synkronisering " är aktiverat synkroniseras integreringen automatiskt var tionde minut och varje gång du öppnar arbetsytan.
- Klicka på Visa loggar för att visa dina Jira-integrationsaktivitetsloggar och se vilka ändringar som gjordes före den senaste synkroniseringen.
Kartobjekt länktyper
Du kan synkronisera objektlänktyper – som "Block", "Duplikater" och "Relaterar till" – mellan Jira och airfocus med antingen dubbelriktad eller enkelriktad synkronisering. När dubbelriktad (tvåvägs) synkronisering är konfigurerad för en länktyp återspeglas alla uppdateringar i en plattform automatiskt i den andra, så att du kan visualisera beroenden på tidslinjer och färdplaner utan manuell duplicering. För mer specifika arbetsflöden kan du konfigurera enkelriktade synkroniseringar eller konsolidera dina data genom att mappa flera Jira-länktyper till en enda airfocus -länktyp.
Så här mappar du objektlänktyper:
- Klicka på Tillägg i det övre högra hörnet på valfri airfocus sida.
- Välj Hantera integrationer.
- Välj J ira under Aktiva integrationer.
- Under ”Mappning av objektlänktyper” klickar du på + Lägg till länktypsmappning.
- Använd rullgardinsmenyerna för att välja en länktyp för Jira till vänster och en länktyp för airfocus till höger.
- Klicka på pilikonen under ”Riktning” för att ändra om synkroniseringen är dubbelriktad eller enkelriktad.
- Du kan också klicka på + Lägg till länktyp för att lägga till ytterligare en Jira-länktyp som ska mappas till en enskild airfocus -länktyp.
- Om du lägger till en ytterligare länktyp kommer airfocus endast att synkronisera med den primära länktypen när den synkroniseras med Jira.
- Klicka på Uppdatera och synkronisera längst ned på sidan.
Objektrelationer och beroenden kommer nu att synkroniseras mellan Jira och airfocus enligt de inställningar du konfigurerade.
Hierarkisynkronisering
Hierarchy sync för Jira låter dig synkronisera förälder-barn-relationer automatiskt från ditt Jira-projekt till airfocus. Detta gör att du kan utföra produkthanteringsarbete på airfocus samtidigt som du har den senaste Jira-hierarkin i sikte utan att behöva växla mellan airfocus och Jira.
För att konfigurera/aktivera hierarkisynkronisering för Jira 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 Jira-problemtyper 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 integrationen.
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 Jira-integrationsinställningar, växla på widgeten ”Automatisk objektlänkning”.
- Du kan välja vilken arbetsyta som uppfyller följande:
- Den andra arbetsytan har en hierarkiselation till den aktuella.
- Den andra arbetsytan har Jira-integration med samma Jira-instans.
- 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 Jira:
- 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.
- Jira API:et avslöjar inte underordnade filer till ett epic, vilket innebär att det förhindrar att airfocus upptäcker om ett Jira epic har några problem med underordnade filer. För att se barnrelationerna på airfocus måste epic-läget redan vara synkroniserat med airfocus när du synkroniserar barnnivåproblemen för att alla relationer ska återspeglas korrekt på airfocus.
Hierarkisynkronisering för Jira kan också konfigureras inom samma arbetsyta, om flera Jira-problemtyper synkroniseras till samma airfocus arbetsyta (antingen genom en eller flera integrationer) och "Tillåt hierarkirelationer inom denna arbetsyta" har aktiverats under fliken Hierarki i arbetsyteinställningarna.
En användare kräver åtminstone läsåtkomst till det anslutna Jira-projektet för att aktivera hierarkisynkronisering för Jira.
Anmärkning om hierarkisynkronisering för Jira datacenter/on-prem-användare:
- airfocus hierarkin synkroniseras inte med Jiras lokala initiativ. Endast epos, berättelser, uppgifter och deluppgifter.
- airfocus hierarkin synkroniseras med alla Jira Cloud-nivåer, inklusive initiativ, episka händelser, berättelser, uppgifter och underuppgifter.
Ytterligare information
Anslut flera Jira-projekt
Om du vill ansluta ett annat Jira-projekt från samma Jira-instans till din arbetsyta behöver du inte gå igenom autentiseringsprocessen igen. Du kan lägga till ytterligare en Jira-projektintegration på integrationssidan från och med nu. Installationen kräver bara att du väljer instansen och startar mappningen direkt.
Statiska IP-adresser till vitlista för din Jira Server-integration
Om du integrerar med ett lokalt distributionssystem som Jira Server kan ditt IT-team behöva tillåta list airfocus i din brandvägg så att airfocus kan ansluta till din server för att skapa poster. Du kan göra anslutningen via port 443.
Team på https://app.airfocus.com eller https://app.us.airfocus.com använder dessa IP-adresser:
- 46.101.71.101
- 46.101.69.142
Teamet 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
Felsökning
- Kontrollera att behörigheterna för användaren som försöker ansluta airfocus till Jira matchar kraven.
- Kontrollera om det finns varningar eller saknade fält i fältmappningsavsnittet.
- Klicka på knappen " Debug " längst ned i integrationsinställningarna. Under synkroniseringen anropas flera API-slutpunkter. Om en av dem misslyckas är det svårt att säga vilken. Felsökningsdialogrutan visar alla samtal och deras resultat, för att göra det lättare för dig att hitta en felaktig konfiguration.
- Ta bort och installera om integrationen. Tips: Applänkkonfigurationen för att ansluta airfocus till Jira finns kvar.
- Kontakta vårt trevliga kundframgångsteam för ytterligare support.
Ge feedback på den här artikeln
Har du feedback om den här artikeln? Berätta om din upplevelse här.