Naar de hoofdinhoud

JIRA naar BlueDolphin-integratie

Geschreven door Jetmir Abdija
Deze week bijgewerkt

Dit artikel is vertaald met behulp van AI en kan kleine onnauwkeurigheden bevatten. Raadpleeg de Engelse versie voor volledige nauwkeurigheid.

BlueDolphin ondersteunt nu integratie met Jira, waardoor je Jira-epics kunt aanmaken of bijwerken voor objectdefinities in je BlueDolphin-tenant. Je kunt velden instellen die in de epic-metadata worden ontvangen, zoals verantwoordelijke, status, beschrijving en issue key.

Vereiste: Stel een JIRA-webhook in om informatie via de integratie te verzenden.

LET OP: Integratie ondersteunt geen relaties en de gegevensstroom is eenrichtingsverkeer van Jira naar BlueDolphin.

BlueDolphin Configuratie

  1. Zodra je de sjabloon Template name - BIF: Jira Entity -> BlueDolphin Object (CREATE, UPDATE) hebt geïnstalleerd, word je doorgestuurd naar de configuratiepagina.

  2. Vul in het gedeelte Configuratie alle verplichte velden in aan de hand van de tabel hieronder.

  3. Klik op Verifieer en Koppel om te controleren of de connectorgegevens juist zijn.

  4. Als de verbinding succesvol is, verschijnt rechtsonder verbonden en wordt het veld Integratie Mapping zichtbaar.

  5. Koppel in de Integratie Mapping de JIRA-velden aan de BlueDolphin objectdefinities die je wilt verbinden.
    Dit is de één-op-één veldmappingtabel van de JIRA-velden naar de eigenschappen van het BlueDolphin Object Type of vragenlijstvelden.

  6. Klik rechtsonder op Activeer.

  7. Neem de waarde van de Webhook URL over; deze heb je nodig voor de webhookconfiguratie aan de JIRA-kant. Zie de informatie in het gedeelte JIRA webhook.

Configuratievelden

Vul alle gegevens in zoals beschreven in de tabel,

Sectie

Veld

Beschrijving

Flow Naam

Sjabloonnaam

Webhook URL

Webhook endpoint

Jira Configuratie (Bron)

Instance URL

Adres-URL van de JIRA API, bijvoorbeeld “https://your-jira-instance.atlassian.net”

Gebruikersnaam

JIRA API accountnaam. Bijvoorbeeld [email protected]

API Token

Jira API-sleutel

Project Key

Project key uit JIRA die je wilt koppelen aan BlueDolphin

Entity

Type issue (in dit geval “Epic”)

BlueDolphin ID Veld

BlueDolphin ID-veld aangemaakt in Jira. Het ID in Jira verschijnt in aangepaste velden als “customfield_XXXXX”.

BlueDolphin configuratie (Doel)

API URL

Selecteer uit de dropdown

API Sleutel

Workspace ID

BlueDolphin Workspace ID die je wilt koppelen.

Admin-> Configuratie-> Bedrijfsonderdelen

Selecteer de workspace die je wilt gebruiken en kopieer en plak het laatste deel van de URL.

LET OP: Tenants zonder workspace moeten de “get workspace”-call van de publieke API gebruiken om deze op te halen.

workspace ID.jpeg

Objectdefinitie ID

BlueDolphin Objectdefinitie ID die je wilt koppelen.

Admin-> Configuratie-> Objectdefinitie:

Selecteer de objectdefinitie die je wilt gebruiken en kopieer en plak het laatste deel van de URL.

Object definition ID.jpeg

BlueDolphin Link ID Veld

Het BlueDolphin Link ID Veld moet handmatig worden bewerkt.

Als je bijvoorbeeld een aangepast veld hebt met het nummer 10046 voor het opslaan van een BlueDolphin ID, volg dan het onderstaande proces.

  1. Ga naar je project en klik linksonder op Project Instellingen.

    Essential steps involved in onboarding a new employee.png
  2. Klik op de optie Issue types.

    Issue types.png
  3. Selecteer rechtsonder de optie Ga naar custom.

    custom fields.png
  4. Zoek je BlueDolphin ID op en klik op Bewerk details.

    edit details.png
  5. Zoek de URL op en kopieer de laatste 5 cijfers na de URL.

    URL ID.png
  6. Plak het volgende in het veld, waarbij je XXXXX vervangt door de cijfers uit je URL.

     customfield_XXXXX

Jira Webhook

Voor meer informatie over de Jira webhook, raadpleeg de Atlassian documentatie.

Bij het instellen van een webhook, voeg een filter toe voor het issuetype dat je wilt synchroniseren. Als je dit filter niet instelt, kunnen de resultaten onverwacht zijn.

De JSON-configuratie zou er ongeveer zo uit moeten zien als in het onderstaande voorbeeld:

Was dit een antwoord op uw vraag?