Skip to main content

Jira Integration

Last updated on June 13, 2024

Overview

Jira Cloud (Jira) is an Atlassian product you can use to add and change issue types, fields, and workflows to manage tasks in your projects. You can easily integrate Jira into AccelByte Development Toolkit (ADT) to create new tickets or link crashes to existing tickets in your system.

Prerequisite

You must be an ADT Admin or Developer to do this integration.

To integrate Jira into your ADT system, you first need to link your ADT account with Atlassian. You can do this in two ways:

  • Linking through a game Crashes Page (for Admin and Developer role)

  • Linking through your namespace integrations page (Admin only)

  1. Log in to ADT Web.

  2. Go to the Crash menu and then click the Show the linked Jira ticket text on the top-right corner.

    Issue panel crash menu

  3. On the Create Jira Ticket page, click Sign in with Jira Cloud.

    Create Jira Ticket page

  4. Click Accept to allow ADT to access your Atlassian account.

    ADT access to Atlassian account

  1. Log in to ADT Web as an administrator.

  2. Go to the Namespace Settings menu by clicking the dropdown next to the game name, then select your namespace.

    Dashboard panel showing Namespace settings

  3. From the "Integrations" section, choose Jira.

  4. Click Sign in with Jira Cloud.

    Sign in with Jira Cloud panel

  5. Click Accept to allow ADT to access your Atlassian account. ADT would like to access your account page

If you want to sign in with Jira Enterprise (Jira Server), contact us at adt-support@accelbyte.net We will provide you with the Public Key that is required to do the next step of the integration.

After you get the Public Key, follow these steps:

  1. Open the Jira Enterprise (Jira Server) and click Administration Menu in the top right.

  2. Select Applications.

    Applications in the Jira administration panel

  3. Under the "Applications" tab on the "Administration" page, select Application links.

    Application links in the Jira administration panel

  4. Type any name for the new link. It does not have to be a valid link.

  5. Click Create New Link.

  6. On the "Configure Application URL" pop-up, click Continue.

    Configure Application URL pop-up

  7. In the "Link applications" form, type ADT in the Application Name field.

  8. Tick the Create incoming link checkbox.

  9. Click Continue to go to the next step.

    Link applications panel showing continue button

  10. Complete the following fields in the "Link applications" form:

    • Consumer Key (This is the Application name from the previous page.)

    • Consumer Name

    • Public Key

  11. Click Continue.

    Link applications panel showing continue button

  12. The system adds your application to the "Configure Application Links" page.

    Configure application links panel

  13. Contact us at adt-support@accelbyte.net and give us your Consumer Key and your Jira Enterprise (Jira Server) base URL and we will finish the integration.

Set up a Jira board for your game

  1. Log in to ADT Web.

  2. Go to the Settings menu.

  3. Choose Atlassian Jira from the configuration section.

  4. Click Sign in with Jira to link to Atlassian.

    Jira panel with sign in with jira area showing

  5. When the message "Your account has been linked" displays, you can choose the Jira board that connects to your game.

    Your account has been linked panel

  6. Click the edit button and then scroll down to select the Jira board for your game.

    Select Jira Board for your game

  7. Click on the Save changes button. Your game is now integrated to the Jira board.

    Jira Board integrated

  1. Log in to ADT Web.

  2. On the crash reports page, select your crash from the list. The issue displays.

  3. Click Create on the right to create or link a Jira ticket.

    Jira ticket shown

  4. In the Create/Link Jira Ticket form:

    • To create a new ticket, click Create ticket, then fill in the mandatory fields from your Jira board.

      Create link/jira ticket panel

    • Fill in the priority, assignee, and other fields that are available on your Jira board.

      Create link/jira ticket panel

    • Click the Create button. The Jira ticket is created successfully.

      Create link/jira ticket panel

    • To link an existing ticket, click Link ticket, provide the existing ticket details, then click the Link button.

      Create link/jira ticket panel

Create ticket from Issues page

You can also create Jira tickets from the "Issue" page. The steps are identical to the crash page. This set of instructions guides users through the seamless process of creating, managing, and linking Jira tickets from ADT crashes. It ensures effective integration and synchronization between ADT and Jira for streamlined issue tracking.