Jira

Jira is a powerful issues and project tracker used by a lot of agile teams. Buddybuild can be configured to automatically open a Jira issue for each piece of feedback and crash report you receive on your app.

Note

How to grant permissions for the API?

You can read more about it here: OAuth security for application links

  1. Log in to the buddybuild dashboard.

  2. The App Settings button Click App Settings button in the top toolbar. The Default build configuration screen is displayed:

    The Default build configuration screen

  3. The Integrations button In the left navigation bar, click the Integrations button. The first of the Integrations screens (Apple Dev Connection) is displayed:

    The Apple Dev Connection screen

  4. The Jira Issues button In the left navigation, click the Jira Issues button. The Jira screen is displayed:

    The Jira screen

    If you have previously configured Jira, you might instead see:

    The Jira screen with existing configuration

  5. Enter the URL for your Jira instance into the Jira base URL field.

  6. In a new browser window or tab, log in to your Jira instance. The Jira dashboard is displayed:

    The Jira dashboard with the new Jira experience

  7. The Settings button in Jira In the navigation sidebar on the left, click the Settings button. The sidebar updates to show the Settings options:

    The Settings panel in Jira

  8. The Applications button in Jira Click the Applications button. The sidebar updates to show the Applications options:

    The Applications panel in Jira

  9. The Application links button in Jira Click the Application links button. The Configure Application Links screen is displayed:

    The Configure Application Links screen in Jira

  10. Copy the following URL into the Application URL field:

    https://dashboard.buddybuild.com/
    Tip

    What if I have multiple Jira integrations with buddybuild?

    You can append your app id to the URL, e.g.:

    https://dashboard.buddybuild.com/57acc935dfda60010066a000
  11. The Create new link button in Jira Click the Create new link button. The Configure Application URL dialog is displayed, containing a warning about receiving no response:

    The Configure Application URL dialog with 'no response' warning in Jira

    Ignore the warning.

  12. The Continue button in Jira Click the Continue button. The Link applications dialog is displayed:

    The Link applications dialog in Jira

  13. Enter a name for this application connection into the Application Name field. We recommend buddybuild. If you customized the Application URL to include the buddybuild app identifier, include the name of your app. For example: buddybuild - my app.

  14. The Continue button in Jira Click the Continue button. The Configure Application Links screen is re-displayed, including the just-created link:

    The Configure Application Links screen in Jira, including the newly-created link

  15. The pencil button in Jira Click the pencil icon to the right of the just-created link. The Configure dialog is displayed:

    The Configure dialog in Jira

  16. Click the Incoming Authentication button on the left side of the dialog. The dialog updates to show the Incoming Authentication fields:

    The Configure dialog in Jira, with the Incoming Authentication fields displayed

  17. Copy configuration from the browser window or tab containing the buddybuild dashboard into the Jira dialog:

    1. Copy the Consumer key value from buddybuild into the Consumer Key field in Jira.

    2. Copy the Public key value from buddybuild into the Public Key field in Jira. You have to scroll down in the Configure dialog to see the Public Key field.

    3. Copy the Consumer callback URL value from buddybuild into the Consumer Callback URL field in Jira.

  18. Enter a name into the Consumer Name field. We recommend buddybuild.

  19. Optionally enter a description for this application into the Description field.

  20. The Save button in Jira Click the Save button at the bottom of the dialog. The Configure Application Links screen is re-displayed.

    At this point, the configuration in Jira is complete.

  21. Switch back to the browser window/tab containing the buddybuild dashboard.

  22. The Connect JIRA account button Click the Connect JIRA account button. The Jira Authorization screen is displayed:

    The Jira authorize screen

  23. The Allow button in Jira Click the Allow button to permit buddybuild to create issues in Jira for feedback and crash reports. The Configure JIRA for Feedback screen is displayed:

    The Configure JIRA for Feedback screen

  24. Select the project, type of issue, reporter plugin, and priority for issues. The selections are defined in your Jira instance. Check the Automatically creates issues for Feedback to enable automatic issue creation whenever feedback is received.

    Note

    Permission to modify reporter

    By default, users without administrator privileges cannot modify the reporter when creating an issue. If you want to use another reporter, please make sure that the Jira account you used on buddybuild has the permission to do so — if not, you can let the Jira board administrator set the permission for you in project settings.

    When you have completed your selections, the Continue button becomes active:

    The Configure JIRA for Feedback screen, with selections made

  25. Click the Continue button. The Configure JIRA for Crash Reports screen is displayed:

    The Configure JIRA for Crash Reports screen

  26. Select the project, type of issue, reporter plugin, and priority for issues. The selections are defined in your Jira instance. Check the Automatically creates issues for Crash Reports to enable automatic issue creation whenever crash reports are received.

    Note

    Permission to modify reporter

    By default, users without administrator privileges cannot modify the reporter when creating an issue. If you want to use another reporter, please make sure that the Jira account you used on buddybuild has the permission to do so — if not, you can let the Jira board administrator set the permission for you in project settings.

  27. Click Continue. The integration confirmation screen is displayed:

    The integration confirmation screen for Jira

  28. Here you have a choice:

    The project, type of issue, reporter plugin, and issue priority selections you made, for both feedback and crash reports, can become the default for all new apps that you might add to buddybuild.

    1. The Yes, save as default integration button To make your selections the default, click the Yes, save as a default integration button.

    2. The No thanks! button To use the selections just for this app, click the No thanks! button.

    Once you have made your choice, the JIRA Issues screen is displayed, showing the active configuration:

    The JIRA Issues screen

That’s it! Buddybuild is now connected to your Jira. Feel free to adjust the configuration at any time; adjustments affects all subsequent feedback or crash report events. Remove the integration by clicking the trashcan icon.

Note

Buddybuild sends user feedback to Jira as Markdown-formatted content, which requires the Wiki Style Renderer. If you see Markdown markup in buddybuild-initiated issues, please ask your Jira administrator to enable the Wiki Style Renderer.

results matching ""

    No results matching ""