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 er een geauthenticeerde verbinding met uw Jira-instantie worden gemaakt door een beheerdersaccount van het axe-accountportaal. Deze verbinding wordt binnen uw 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-accountportaal
- Klik op de link "Integraties" binnen de navigatie "Configuratie"
- Klik op de knop "Nieuwe verbinding met Jira Cloud toevoegen"
- 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" verschijnt zodra de verbinding tot stand is gebracht
Verbinden met Jira Data Center
- Navigeer naar de pagina "CONFIGURATIE" binnen het axe-accountportaal
- 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")
- Voer uw Jira Data Center-URL in (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 tekstinvoerveld - 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"; u zult dezezelfde waarde moeten opgeven op de Jira Data Center-instellingenpagina)
- 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 (bijv. „Deque Jira-integratie“)
- Voer de openbare sleutel in die wordt weergegeven op de pagina „Jira Data Center-instellingen“ in het Veld openbare sleutel veld
- Terug in de Jira Data Center-instellingenpagina in de axe-accountportal...
- voer dezelfde Consumer Key in die was ingevoerd in Jira Data Center
- 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
- Ga 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 aan Ik ga akkoord met de ontwikkelaarvoorwaarden van Atlassian selectievakje en klik op de knop „Maken“
- 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 (rechtermuisknop > 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 je Deque on-prem installatie voltooid is, volg je 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, klikt u op de knop „Verbind met Jira“, die u 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, kunt u deze verwijderen door op „Verwijder Jira-verbinding“ te klikken.
U kunt nog steeds verbinding maken met een instantie die eerder is verbroken en verwijderd. Volg eenvoudig de stappen om een nieuwe verbinding tot stand te brengen.
Sjablonen
Zodra een verbinding tot stand is gebracht, kunnen sjablonen worden gemaakt om te standaardiseren hoe axe-problemen worden toegewezen aan Jira-velden. Sjablonen helpen ervoor te zorgen dat probleemcreatie consistent is binnen uw organisatie.
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.