Airfocus integreren met Jira

Voordelen

Verbind jouw productmanagementworkflow, prioriteringskaders en roadmaps met de dagelijkse ontwikkeling door jouw data naadloos te synchroniseren tussen AirFocus en Jira. De integratie is compatibel met Jira cloud, Jira Server en Jira Data Center.

• Importeer Jira-uitgaven (als items) in Airfocus.
• Stuur airfocus-items in Jira (als elk type issue).
• Tweerichtingssynchronisatie en flexibele filters (aangepaste JQL).
• Flexibele veldmapping.
• Toon jouw AirFocus prioriteitsscores in Jira voor context rond bedrijfswaarde en prioriteiten.
• Vermogen om de ouder-kindrelatie direct in de lucht te zien.

Vereisten

• Over Airfocus: Gebruiker moet "Full" Toestemmingen hebben voor de werkruimte waarvoor ze de Jira-integratie willen configureren.
• Op Jira: "Administrator" Toestemmen zijn verplicht om de applicatielink tussen jouw Jira-instantie en AirFocus Team tot stand te brengen.
• Als de applicatielink tussen de Jira-instantie en het AirFocus-team al is opgezet, kan elke Jira-gebruiker met ten minste "Create_Issue" Toestemen aan een project nieuwe integratie voor die instantie opzetten.
• Onze Jira-integratie is compatibel met Jira cloud, Jira Server en Jira Data Center. Wij ondersteunen alle Jira Server-versies die staan vermeld in het Atlassian Support End of Life Policy. Versies die eerder zijn dan die daar vermeld zijn, hebben het einde van de levensduur (EOL) bereikt en kunnen functioneren, maar worden niet ondersteund.

Zet de Jira-integratie op

1. meld je aan for airfocus of log in op jouw bestaande account. 
2. Maak een nieuwe werkruimte aan in Airfocus of selecteer degene waarmee je Jira wilt integreren.
   • je hoeft jouw Jira-instantie slechts één keer per AirFocus Team te autoriseren.
   • je kan meerdere Jira-integraties toevoegen aan een bepaalde werkruimte (bijvoorbeeld van verschillende Jira-projecten of instanties).
3. Klik rechtsboven op Extensions in jouw werkruimte.
4. Selecteer integratie beheren.
5. Klik op Connect op de "Jira"-tegel.
6. Selecteer Connect a new Jira-instantie vanuit het dropdownmenu dat verschijnt.
7. Voer jouw Jira instance base URL in (bijv. https://airfocustest.atlassian.net/ of https://jira.mycompany.com).
8. Klik op Doorgaan.
9. Kopieer de "applicatie URL". Ik heb dit nodig voor de volgende stappen in Jira.
10. Klik op Jira applicatie link center om het Jira applicatie Link Center te openen.
    • Ik moet een beheerder zijn in Jira om deze pagina te kunnen openen. 

De volgende stappen verschillen voor Jira cloud en Jira Server/Data Center. Bekijk hieronder het gedeelte voor jouw voorbeeld om verder te gaan.

Maak een applicatielink aan in Jira cloud

1. Klik in Jira cloudop het Instellingen-icoon rechtsboven
2. Selecteer Jira-apps. 
3. Klik onder de sectie "integratie" aan de linkerkant op applicatielinks.
4. Klik op de knop 'Link maken ' rechtsboven op de pagina.
5. Selecteer de optie voor "Direct applicatielink".
6. Plak jouw airfocus URL als "applicatie URL".
7. Klik op Volgende.
8. Typ een naam in voor de applicatie en zorg dat het applicatietype is ingesteld als "Generieke applicatie".
9. Met behulp van de informatie die in airfocuswordt verstrekt, kopieer en plak je de naam van de dienstverlener, de consumentensleutel, het gedeelde geheim, de aanvraag-token URL, de toegangstoken-URL en de autorisatie-URL in Jira.
10. Kijk in de vak naast "Create coming link".
11. Klik op Doorgaan.
12. Met behulp van de informatie die in airfocuswordt verstrekt, kopieert en plakt u de Consumentensleutel, Consumentennaam en Publieke Sleutel in Jira.
13. Klik op Doorgaan.
14. Ga terug naar airfocus en klik op Installatie voltooien.

We verwijzen je naar de OAuth-autorisatiestap, waarmee Airfocus jouw Jira Gebruiker gebruikt om items tussen de twee te synchroniseren. Klik op Toestaan om AirFocus te autoriseren om te synchroniseren met jouw account.

Maak een applicatielink aan in Jira Server of Jira Data Center

1. Klik op de link Maken rechtsboven,
2. Selecteer Atlassian-product.
3. Plak jouw airfocus URL als "applicatie URL".
4. Klik op Doorgaan om te bevestigen.
   
5. Vul de waarden in die in de airfocus-interface worden vermeld.
6. Klik op Doorgaan.
7. Kopieer de waarden uit Stap 3. 
8. Klik op Doorgaan. 
   • je zou nu een bevestiging in Jira moeten zien.
9. Ga terug naar airfocus en klik op Installatie voltooien.

We verwijzen je naar de OAuth-autorisatiestap, waarmee Airfocus jouw Jira Gebruiker gebruikt om items tussen de twee te synchroniseren. Klik op Toestaan om AirFocus te autoriseren om te synchroniseren met jouw account.

Configureer integratiefilters

1. Selecteer het project dat je wilt synchroniseren. JE kan typen om de lijst met projecten te filteren.
   • Projecten die je kan zien maar niet de CREATE_ISSUES Toestemen voor missen, zijn als zodanig gemarkeerd (alleen beschikbaar voor Jira cloud).
   • De naam van jouw integratie wordt automatisch aangemaakt op basis van het project. JE kan het later ook veranderen.
2. Selecteer het type issue dat je wilt synchroniseren. 
   • Omdat de velden kunnen verschillen tussen issuetypes (afhankelijk van jouw Jira-versie en het type project, bijvoorbeeld teammanaged of bedrijfsbeheerd), filters dit de velden die je kan toewijzen aan die welke daadwerkelijk beschikbaar zijn op het geselecteerde issuetype.
   • Als je meerdere issuetypes wilt synchroniseren, raden we aan om elk één integratie op te zetten, hetzij in dezelfde werkruimte of over meerdere werkruimtes. je kan integratie vanuit andere werkruimtes (bijvoorbeeld voor Epics of Sub-taken) verbinden via de airfocus-hiërarchie.
   • je kan de gesynchroniseerde problemen ook nog verder filteren door een JQL- query in de issuefilters te geven (lees hier meer over JQL).

Kaart luchtfocus- en Jira-velden

Gebruik mapping om te definiëren hoe informatie in Jira moet worden gekoppeld aan informatie in Airfocus. Als je een probleem of item in het ene systeem verandert, wordt het andere systeem dienovereenkomstig aangepast.

je kan bijvoorbeeld definiëren hoe Jira-statussen moeten worden gekoppeld aan airfocus single-select velden en/of hoe Jira-labels gekoppeld moeten worden aan airfocus multi-select velden.

Er zijn ook veel meer opties om verschillende Jira-custom en systeemvelden toe te wijzen aan jouw airfocusvelden.

Als je naar de veldkaartopties kijkt, zie je dat standaard altijd twee velden worden toegewezen: itemnamen en itembeschrijvingen.

je kan voor elk van jouw velden bepalen of je een eenrichtingssynchronisatie of een tweerichtingssynchronisatie tussen het veld in Jira en Airfocus wilt.

je kan de kaartrichtingen voor alle velden tegelijk instellen (voor zover technisch mogelijk) met de knop "Richting instellen".

Standaard is de mappingrichting ingesteld van Jira op alleen airfocus en kan deze door de gebruiker worden aangepast naar wat beschikbaar is voor mapping.

Bij het instellen van een nieuwe mapping voor een van jouw velden zul ik merken dat je alleen Jira-veld naar luchtfocusvelden kunt koppelen als beide uiteinden hetzelfde veldtype hebben.

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

Nadat je twee velden hebt geselecteerd die je wilt toewijzen, kun je de veldopties selecteren en hoe ze toegewezen moeten worden.

Overzicht van alle toewijsbare veldtypen

Mappable Jira-systeemvelden:

⚠️ Waarschuwing over tweerichtingssynchronisatie voor het beschrijvingsveld: Het tweerichtingssynchronisatieproces kan kleine veranderingen in de inhoud en opmaak van jouw Jira-beschrijvingen veroorzaken. Dit komt doordat nog niet alle stijlen van Jira native ondersteuning hebben in Airfocus.

⚠️ Waarschuwingen over people field mapping: De mappinglogica is gebaseerd op displaynamen. Daarom wordt "Kirsten" in Jira NIET gekoppeld aan "Kirst" in Airfocus, ook al gebruiken beide accounts hetzelfde e-mailadres.

In het geval dat Jira slechts één waarde toestaat op een mensenveld (bijvoorbeeld ze kunnen maar één toegewezen hebben), bevoordeelt een synchronisatie met airfocus de eerste waarde voor het toegewezen airfocus-mensenveld. Bijvoorbeeld, een ticket in Jira dat aan "Julian" is toegewezen, overschrijft een item in airfocus dat aan "Julian en Nikita" is toegewezen. Nikita wordt verwijderd en alleen Julian blijft toegewezen.

Mappable Jira aangepast veld:

Probleemoplossing: Zoek jouw datumbereikveld

We hebben minstens twee datumvelden nodig (behalve fixversies) om ze te kunnen koppelen aan een Airfocus-datumbereikveld.

Onze integratie kan alleen datumvelden detecteren als ze zichtbaar zijn op het gesynchroniseerde issuetype (scherm). Ik moet ervoor zorgen dat er minstens twee datumvelden op het issuetype (scherm) op Jira staan en dat er ten minste één datumbereikveld beschikbaar is voor mapping op jouw airfocus werkruimte.

Hoe dat eruitziet in Jira:

• voor Jira cloud Team-managed ga naar projectinstellingen > issuetypes en sleep het veld van de rechter zijbalk naar de lijst met velden in het midden.
• Voor Jira cloud door het bedrijf beheerd (en Jira Server), ga naar projectinstellingen > issues > schermen en bewerk het scherm van het issue-type je're synchronisatie. JE kan onderaan extra datumvelden toevoegen.

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 met dezelfde waarden in zowel Airfocus als Jira.

Automatisch aanmaken van veldwaardegeneratie

Schakel "Auto-create field options" in om nieuwe velden die in Jira zijn gemaakt automatisch toe te voegen aan airfocus als ze aan een item worden toegevoegd. 

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

Hoe je de focusscore met Jira in kaart brengt

Met de Jira-integratie van airfocus kun je Airfocus gebruiken voor prioritering en roadmap, terwijl ontwikkelaars (en anderen) Jira gebruiken voor dagelijkse ontwikkelingsplanning.

Standaard tonen we al Airfocus-gegevens zoals prioriteitsscores, baan en tijdlijnen in Jira. Dit hulpartikel beschrijft hoe je de airfocus-focus score kunt mappen met een Jira aangepast veld (waar je ook op kunt filteren in Jira).

Door de AirFocus focus score te koppelen aan jouw Jira-project, kan ik jouw nummer één prioriteitsmetriek precies op de plek van mensen laten zien – op elke gesynchroniseerde Jira-uitgiftekaart en de uitgiftekaart. Op deze manier krijg je je hele team op één lijn en focus op welke keuze belangrijk is.

Om de airfocus-focus score in Jira weer te geven, moet je deze mappen met een Jira-aangepast veld. Het aangepast veld moet het veldtype "Nummerveld" hebben. Het opzetten hiervan duurt ongeveer 3 minuten.

Dat gaat als volgt:

1. Klik in Jira op het tandwielpictogram rechtsboven om de instellingen te openen.
2. Klik op Issues.
3. Selecteer aangepast veld in het navigatiemenu aan de linkerkant.
4. Klik rechtsboven op Een aangepast veld aanmaken .
5. Selecteer het getalveld als veldtype.
6. Typ een naam en beschrijving in (optioneel).
7. Klik op Aanmaken.
8. Koppel het nieuwe aangepaste veld aan schermen (van jouw gesynchroniseerde project)
   
9. Ga terug naar jouw Jira integratie-instellingen in Airfocus en selecteer het nieuw aangemaakte aangepast veld uit het keuzemenu
   

De airfocus-focus score zal nu verschijnen voor jouw Jira-nummers
 

Als je ook de focusscore op jouw kaarthoezen wilt laten zien, volg dan deze stappen:

1. Klik op het driepunt-icoon rechtsboven op jouw whiteboard.
2. Selecteer de instellingen van het whiteboard.
3. Klik op de kaartindeling in het navigatiemenu aan de linkerkant.
4. Selecteer jouw focus score aangepast veld uit het keuzemenu.
5. Klik op Toevoegen.
6. JE zal nu ook de focusscore op het whiteboard vinden.
   

Configureer extra instellingen

• Wanneer "Archief onbekende problemen" is ingeschakeld, zullen eerder geïmporteerde items in Airfocus zijn als ze niet meer in Jira aanwezig zijn (of gewoon niet meer overeenkomen met de JQL-filters).
• Wanneer "Automatisch synchroniseren" is ingeschakeld, synchroniseert jouw integratie automatisch elke 10 minuten en elke keer dat je de werkruimte opent.
• Klik op weergaven logs to weergaven jouw Jira integratie activiteit logs en zie welke wijzigingen zijn aangebracht vóór de laatste synchronisatie.

Soorten kaartitems links

je kan itemlinktypes synchroniseren—zoals "Blokken," "Duplicaten" en "Gerelateerd aan"—tussen Jira en airfocus via zowel bidirectionele als eenrichtingssynchronisatie. Wanneer bidirectionele (tweerichtings) synchronisatie is geconfigureerd voor een linktype, wordt elke update in het ene platform automatisch weerspiegeld in het andere, waardoor je afhankelijkheden op tijdlijnen en roadmaps kunt visualiseren zonder handmatige duplicatie. Voor meer specifieke workflows kun je eenrichtings-synchronisaties instellen of jouw data consolideren door meerdere Jira-linktypes aan één AirFocus-linktype toe te wijzen.

Om itemlinktypes in kaart te brengen, volgt u deze stappen:

1. Klik rechtsboven op de Extensies van elke Airfocus-pagina.
2. Selecteer integratie beheren.
3. Selecteer onder "Actieve integratie" Jira.
4. Onder "Item link type mapping" klik je + Voeg linktype-mapping toe.
5. Selecteer links een linktype voor Jira in de dropdowns en rechts een linktype voor Airfocus.
6. Klik op het pijltje onder "Direction" om te wijzigen of de synchronisatie bidirectioneel of eenrichtingsverkeer is.
7. Klik optioneel op + Voeg linktype toe om een extra Jira-linktype toe te voegen dat naar één airfocus-linktype wordt gekoppeld.
   • Als je een extra linktype toevoegt, synchroniseert Airfocus met Jira alleen met het primaire linktype.
8. Klik op Bijwerken en synchroniseren vanaf de onderkant van de pagina.

Itemrelatie en afhankelijkheden synchroniseren nu over Jira en Airfocus volgens de instellingen die ik heb ingesteld.
 

Hiërarchie-synchronisatie

Hiërarchiesynchronisatie voor Jira stelt je in staat om de ouder-kindrelaties automatisch te synchroniseren van jouw Jira-project naar airfocus. Dit stelt je in staat productmanagementwerk op airfocus te doen, terwijl je de nieuwste Jira-hiërarchie in zicht hebt, zonder te hoeven wisselen tussen airfocus en Jira.

Om de Hierarchy-synchronisatie voor Jira 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 toestaat.
• Twee of meer Jira-uitgavetypes 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 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 Jira-integratie-instellingenpagina schakel je de widget "Automatische itemkoppeling" aan.
3. JE kan elke werkruimte kiezen die aan de volgende voorwaarden voldoet:
   • De andere werkruimte heeft een hiërarchierelatie met de huidige.
   • De andere werkruimte heeft Jira-integratie met dezelfde Jira-instantie.
   • 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 bij het inschakelen van hiërarchie-synchronisatie voor Jira:

• 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 gesynchroniseerd kunnen worden.
• De Jira API onthult de kinderen van een episch verhaal niet, wat betekent dat het voorkomt dat Airfocus kan detecteren of een Jira-episch kind problemen heeft. Om de kindrelatie op Airfocus te zien, moet de Epic al gesynchroniseerd zijn met Airfocus wanneer ik de kinderen niveauproblemen synchroniseer, zodat alle relaties correct op Airfocus worden weergegeven.

Hiërarchiesynchronisatie voor Jira kan ook binnen dezelfde werkruimte worden geconfigureerd, als meerdere Jira-issuetypes zijn gesynchroniseerd met 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 vereist ten minste leestoegang tot het verbonden Jira-project om hiërarchie-synchronisatie voor Jira mogelijk te maken.

Opmerking over de hiërarchie-synchronisatie voor Jira datacenter/on-prem Gebruiker:

• De airfocus-hiërarchie synchroniseert niet met Jira-initiatieven op locatie. Alleen epische verhalen, verhalen, genomen en ondergenomen.
• De airfocus-hiërarchie synchroniseert met alle Jira- cloud niveaus, inclusief initiatieven, epics, verhalen, taken en sub-taken.

Aanvullende informatie

Verbind meerdere Jira-projecten

Om een ander Jira-project van dezelfde Jira-instantie te verbinden met jouw werkruimte, hoef je niet opnieuw door het authenticatieproces te gaan. je kunt vanaf nu nog een Jira-projectintegratie toevoegen op de integratiepagina. De setup vereist alleen het selecteren van de instantie en het direct starten van de mapping.

Statische IP-adressen naar whitelist voor jouw Jira Server-integratie

Als je integreert met een on-premise implementatiesysteem zoals Jira Server, moet jouw IT Team mogelijk airfocus in jouw firewall toestaan zodat Airfocus verbindingen kan maken met jouw server om records aan te maken. JE kan de verbinding maken via poort 443.

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

• 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

Probleemoplossing

• Controleer of de Toestemmingen van de gebruiker die AirFocus met Jira probeert te verbinden overeenkomt met de vereisten.
• Controleer op waarschuwingen of ontbrekende velden in het sectie veldkaart.
• Klik op de knop "debuggen" onderaan de integratie-instellingen. Tijdens de synchronisatie worden verschillende API-eindpunten aangeroepen. Als een van hen faalt, is het moeilijk te zeggen welke. De debuggen-dialoog toont alle aanroepen en hun resultaten, zodat je makkelijker een verkeerde configuratie kunt vinden.
• Verwijder en installeer de integratie opnieuw. Tip: De app-link die je kunt koppelen om AirFocus met Jira te verbinden blijft bestaan.
• Neem contact op met ons lieve customer success Team voor extra ondersteuning.

Feedback geven over dit artikel