Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of contents

Table of Contents
Info

BigPicture Enterprise feature.

Jira Cloud feature - secondary, additional Jira Clouds can be connected. 

You can connect multiple additional Jira Cloud instances. 

...

To use additional Jira Clouds, you need to:

  • connect them to BigPicture (you can do it in App Configuration or directly in one of the Boxes)

  • add them to the scope of your Boxes

Before you proceed

WebHooks

Info

Make sure to register WebHooks

WebHook setup is necessary for automatic synchronization between the primary and a secondary Jira Cloud. 

App

BigPicture must be installed on the Jira Cloud you are going to will connect (secondary Jira Cloud) with.

...

Recommendation: create a separate Jira user for this purpose (an account that isn't is NOT used by an actual person , but serves just this purpose). This user account needs to must have Jira admin permissions (secondary Jira Cloud).

...

Note: this is sensitive security information. Access to the API token should be limited.

The token needs to must be generated from a technical user account (see above). 

  1. Set up a new user account in the secondary Jira Cloud.

  2. Grant the Jira admin permissions to the technical user.

  3. Log in as a technical user into the secondary Jira Cloud.

  4. Go to Manage Account > Security > Create and Manage API Tokens.

...

  1. Image Added
  2. Create an API token (see the following link).

  3. Copy the token.

If someone else is setting up the additional Jira Cloud connection, provide them with the token.

Required fields information

To set up a connection, you will need:

Connect Jira Cloud to BigPicture

App configuration

...

  • Image Added

  • Fill in the information and click next:

...

  • Image Added
  • Provide the BigPicture endpoint URL and check the boxes: 

...

Box scope definition

...

  • Image Added
  • Click "Connect".

Result - Box scope

  1. Add new integration.

...

  1. Image Added
  2. Open the selection dropdown.

...

  1. Image Added
  2. Select "Jira Cloud" from the list.

...

  1. Image Added
  2. Open the "Connection" dropdown and select the Jira Cloud connection.

...

  1. Image Added
  2. Click "Add".

Data from the additional Jira Cloud can be added to the scope. 

...

After Jira Cloud is connected, the following features are available:

  • Scope definition - you can base the scope on Jira Cloud projects from the additional connection

  • You can add the fields from connected Jira Clouds to column views/card views

  • You can define the structure builders for the additional Jira Cloud connections

  • Field mapping of the connected Jira Clouds can be managed in App Configuration 

  • Dependencies mapping of connected Jira Clouds can be set in App Configuration

...

Additional requirements:

The app works properly when connected to Jira Cloud is valid.

Constraints

  • Task creation

    you

    You can't use BigPicture to create tasks in the additional Jira Cloud. When you add tasks, they are added to the primary Jira. 

  • Task grouping (using the "status" field): → tasks from two different Jiras can't be grouped into unified groups.

  • Task report → doesn't allow

    for use of

    using Jira fields from the additional Jira Cloud.

Additional configuration

Field mapping and dependency mapping of the newly connected Jira Cloud are empty and need to be set up.

You can use the matching BigPicture fields of the secondary Jira Cloud or

...

different fields for mapping. The only requirement is that you create a mapping.

All fields you want to use for mapping must be added to your Jira projects. Otherwise, the BigPicture app won't be able to update them.

  • You can't use the 'not synchronized' option for the secondary Jira Cloud

  • BigPicture fields are not automatically added to the secondary Jira Cloud screens

BigPicture custom fields

Are you using custom fields created by the BigPicture app? You can use matching fields for the secondary Jira Cloud.

During the app installation, additional custom fields were created on the Jira instance. You can find them in the Jira Settings of the primary instance ("Custom fields").

Image Removed
Image Removed

You can use the matching custom fields on the secondary Jira Cloud or use different fields for mapping.

Fields used for mapping must be added to Jira screens

  1. Go to the 'custom fields' list.
  2. Find the field.
  3. Associate to screens.
    Image Removed
  4. Select the 'screens' by ticking the boxes and 'update'.
    Image Removed

...

Dependencies

Link types can be found, added, and configured in the 'issue linking' section of Jira administration.Image Removed 

...