Versions Compared

Key

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

...

  1. From within Jira, install the TeamForm for Jira from the Atlassian Marketplace.

    1. make sure you are logged into Jira, as a Jira Admin, to do this.

  2. Navigate to , on the top toolbar of Jira.

  3. Navigate to

  4. Navigate to , on the sidebar, on the left-hand side of the page.

    1. You may need to scroll the sidebar downwards to see this option, in the section.

  5. The TeamForm for Jira Admin Page will be displayed.

  6. You now need to fill out the Authentication Section of this page - details of how to do this can be found below.

Admin Page within Jira (Authentication Section)

Tenant ID and Workspace ID can be found in the TeamForm app:

...

Client ID and Client Secret are obtained by contacting TeamForm Support.

Please use the following template in your support request:

Code Block
Hi TeamForm Support,

Please supply Client Credentials (ID and Secret) to connect the TeamForm for Jira App.

Access Level: <production, staging, test etc>
Tenant ID: <tenant id (as found above)>
Workspace ID: <workspace id>
Security Contact: <your email, or the email of the person responsible for the secure storage of the Client Credentials>
Atlassian Jira URL: <xyz.atlassian.net>

Thank you,

...

Custom TeamForm URL: this is the URL of TeamForm, e.g xyz.teamform.co

  • Click Image Modified (change) on each field

...

  • , and fill out the relevant details.

...

  • Click Image Added (update) and continue to the next one.

Tip

Congratulations! You can now start to link TeamForm Teams to Jira Projects!

Linking Projects in Jira to TeamForm Teams

Visit one of your Projects in Jira and look for the TeamForm icon on the left sidebar, as shown here:

...

Info

Only Issues under a linked Project will be imported, and only those Issues that match the following criteria:

  • their Project is linked, using the process above

  • their Issue Type is marked as as defined below

  • you have to set up the TeamForm Jira Integration in TeamForm is setup

  • issues Issues are open Open (by default, TeamForm will exclude issues which are closed excludes closed issues prior to the current TeamForm planning allocation window or “project”“allocation project”)

Setting up which issues are to be included in the import

Info

You will likely want to import only a subset of issue types into TeamForm. This section details how to include or exclude Jira issue types.

...