Aan de slag met de Jira-integratie
Het instellen van de Jira-integratie is snel en eenvoudig. Dit document begeleidt u door de noodzakelijke installatie en configuratie zodat uw hele organisatie gebruik kan maken van deze krachtige integratie.
Verbinden met Jira Cloud
Om te beginnen moet een geauthenticeerde verbinding met jouw Jira-instantie worden opgezet door een beheerder van het axe Account Portal. Deze verbinding wordt binnen jouw hele organisatie gebruikt, dus het is belangrijk dat de gebruiker die de verbinding tot stand brengt, toegang heeft tot elk project waarnaar u problemen wilt verzenden.
- Navigeer naar de pagina "CONFIGURATIE" binnen het axe Account Portal
- Klik op de link "Integraties" binnen de navigatie "Configuratie"
- Klik op de knop „Nieuwe verbinding toevoegen aan Jira Cloud"
- Er wordt een nieuw pop-up venster geopend (OAuth-toestemming) waarin gevraagd wordt om in te loggen (als u al een actieve Jira-sessie heeft, wordt deze stap overgeslagen)
- Zodra u geauthenticeerd bent met Jira, wordt u gevraagd om een Jira-instantie te kiezen om mee te verbinden in de selectielijst "Gebruik app op"
- Klik op "Accepteren" zodra u een Jira-instantie hebt gekozen
- Het pop-up venster sluit en er wordt een bevestigingsdialoog weergegeven
- Bevestig de Jira-instantie waarmee u verbinding wilt maken in de dropdown
- Klik op "Voltooien"
- Een bericht „Succesvol verbonden met Jira“ zal verschijnen zodra de verbinding tot stand is gebracht
Verbinden met Jira Data Center
- Navigeer naar de pagina "CONFIGURATIE" binnen het axe Account Portal
- Klik op de link "Integraties" binnen de navigatie "Configuratie"
- Klik op de knop "Nieuwe verbinding met Jira Data Center toevoegen"
- Klik op de knop "Instellingen configureren" (onder de tekst "Niet geconfigureerde verbinding")
- Geef jouw Jira Data Center-URL op (bijv.
https://jira.mycompany.com)
- Voer uw Consumer Key in (moet overeenkomen met wat u in Jira invoert).
- In Jira Data Center...
- Klik op de knop "Instellingen" (tandwielpictogram rechtsboven op de pagina)
- Klik op de link "Toepassingen"
- Klik op de link "Toepassingskoppelingen"
- Voer
https://www.deque.comin als de URL in het tekstveld - Klik op de knop "Nieuwe koppeling maken"
- Klik op de knop "Doorgaan"
- Als u een waarschuwing ziet vergelijkbaar met "Geen reactie ontvangen van de ingevoerde URL" of over omleidingen, kunt u deze veilig negeren. De URL zelf wordt niet gebruikt voor enige vorm van validatie; het is gewoon een verplicht veld om de verbinding correct op te zetten
- Geef een Applicatienaam op (bijv. „Deque Jira Integration“; je moet deze waarde later ook op de Jira Data Center-instellingenpagina opgeven)
- Vink het selectievakje "Inkomende koppeling maken" aan
- Klik op de knop "Doorgaan"
- Voer een waarde in het Consumer Key-veld in (bijv. „DequeOAuthKey“)
- Voer een waarde in het Consumentnaam-veld in (bijv. „Deque Jira Integration“)
- Voer de openbare sleutel die op de „Jira Data Center-instellingen“ pagina wordt getoond in het Veld openbare sleutel-veld in
- Terug in de Jira Data Center-instellingenpagina in de axe-accountportal...
- voer dezelfde Consumer Key in als die in Jira Data Center is ingevoerd
- Klik op de knop „Opslaan“
- Klik op de knop „Verbinden met integratie“
- Log in op Data Center in het pop-upvenster als je nog niet bent ingelogd
- Klik op „Toestaan“
- Sluit het venster
Vereiste voor Jira Cloud-verbinding vanuit Deque On-Premises-instantie
Registreer de Jira Client-app
- Navigeer naar https://developer.atlassian.com/console/myapps/
- Klik op de knop „Maken“ en kies „OAuth 2.0“ integratie
- Geef een naam op (bijv. „Acme Corp - axe on-prem - Jira Cloud-integratie“)
- Vink het Ik ga akkoord met de ontwikkelaarvoorwaarden van Atlassian-vakje aan en klik op de knop „Creëer“
- Klik in het "Distributie" tabblad op "Bewerken" en selecteer "Delen" voor "Distributiestatus"
- Stel "Naam van leverancier" in op „Deque“
- Stel „Privacybeleid“ in op „https://www.deque.com/privacy-policy/“
- Stel "Slaat uw app persoonlijke gegevens op?" in op „Nee“
- Wijzigingen opslaan
- Klik in het tabblad "Machtigingen" op de knop "Toevoegen" (naast "Jira API")
- Zodra het klaar is voor configuratie (wacht even), wordt de knop "Toevoegen" vervangen door een nieuwe knop "Configureren"
- Als de knop "Configureren" niet verschijnt, probeer de pagina opnieuw te laden
- Klik op "Configureren"
- Klik op "Bewerk scopes"
- vink de volgende selectievakjes aan: "read:jira-work", "read:jira-user", "write:jira-work" en "manage:jira-webhook"
- Klik in het tabblad "Autorisatie" op de knop "Toevoegen"
- Stel „Callback-URL“ in op „https://axe.deque.com/jira-direct/connected“
- Klik op de knop "Wijzigingen opslaan"
- Download deze afbeelding (rechtsklik > afbeelding opslaan als):
- Klik in het "Instellingen" tabblad op "Avatar wijzigen" en selecteer het axe-logo dat je zojuist hebt opgeslagen
- Sla in de sectie "Authenticatiedetails" de "Client-ID" en "Secret" op, aangezien deze worden gebruikt als onderdeel van je eigen installatie
- Zodra jouw Deque on-prem installatie voltooid is, volg je de bovenstaande stappen om de verbinding met Jira-cloud tot stand te brengen
Een actieve verbinding verbreken
Door op „Verbreek verbinding met Jira“ te klikken, wordt de actieve authenticatiesessie die eerder met Jira tot stand was gebracht ongeldig. Bovendien kunnen gebruikers geen problemen meer verzenden naar de Jira-instantie die werd losgekoppeld.
Om een verbroken verbinding opnieuw aan te sluiten, klik je op de knop „Verbinden met Jira“ die je opnieuw door de stappen van het verbinden leidt.
Het creëren van meerdere actieve verbindingen met dezelfde Jira-instantie moet worden vermeden. In plaats daarvan moet een gebruiker met alle vereiste toegang in Jira (rechten, projecten, enz.) de verbinding tot stand brengen.
Een verbinding verwijderen
Zodra een verbinding is verbroken, kun je deze verwijderen door op „Verwijder Jira-verbinding“ te klikken.
Je kunt nog steeds verbinden met een instantie die eerder is verbroken en verwijderd. Volg gewoon de stappen om een nieuwe verbinding tot stand te brengen.
Sjablonen
Zodra een verbinding tot stand is gebracht, kunnen sjablonen worden aangemaakt om te standaardiseren hoe axe-problemen worden gekoppeld aan Jira-velden. Sjablonen helpen om consistente probleemaanmaak binnen jouw organisatie te waarborgen.
Voor gedetailleerde informatie over het maken, beheren en gebruiken van sjablonen, zie onze documentatie over sjablonen.
Problemen naar Jira sturen
Zodra u een Jira-verbinding heeft gevestigd en sjablonen heeft gemaakt, kunt u beginnen met het versturen van axe-problemen naar Jira. Het proces stelt u in staat om individuele problemen of groepen van problemen te versturen om Jira-tickets aan te maken.