Table of Contents | ||
---|---|---|
|
Why use the TeamForm for Jira app
With TeamForm’s Jira App, an organisation’s Jira Admin(s) can link
their Jira Projects to relevant TeamForm Teams. This allows a Jira user to click through from Jira to TeamForm to view the team and team members who deliver this project.
...
We also offer a TeamForm integration, that combines with the TeamForm Jira app, to import Issues from Jira into TeamForm - displaying this team’s work items as Objectives.
...
Prerequisites
You have Jira Admin access where the plugin is to be installed.
You have configured IP whitelisting correctly, for Atlassian to connect to TeamForm, and for TeamForm to connect to Atlassian.
Getting started
From within Jira, install the TeamForm for Jira from the Atlassian Marketplace.
make sure you are logged into Jira, as a Jira Admin, to do this.
Navigate to , on the top toolbar of Jira.
Navigate to
Navigate to , on the sidebar, on the left-hand side of the page.
You may need to scroll the sidebar downwards to see this option, in the section.
The TeamForm for Jira Admin Page will be displayed.
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:
...
Tip |
---|
Congratulations! You can now start to |
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:
...
Tip |
---|
That’s it! You have made a |
Importing Issues into TeamForm
The TeamForm integration with Jira allows you to import a linked
Project’s Issues (e.g. Epics, initiatives, stories…) into TeamForm!
Info |
---|
Only Issues under a
|
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. |
...
Note |
---|
Remember, even though an Issue Type is selected, only some of the Issues with that Issue Type will be imported: e.g only those whose Project is |
...
Setting up your Jira integration from within TeamForm
Once the TeamForm for Jira App is in place in your Jira instance, you can install the TeamForm Jira Integration on the TeamForm side.
...
Tip |
---|
Excellent! You have now configured TeamForm to import Projects and Issues from Jira, using the Atlassian TeamForm Integration. |
Other TeamForm for Jira Config settings
Admin Page (Customised Message)
This section of the Admin Page is used to customise the appearance of the App for projects not yet linked to teams.
...
Enter your custom message into the text box. You could use the following, as an example:
Code Block language html Please go to this <a href='https://www.example.co' target='_blank'>link</a> if you need TeamForm access
...
Click
...
Admin Page (Permissions)
You can restrict who is able to link TeamForm Teams to projects in Jira:
...
Issue Picker
Status | ||||
---|---|---|---|---|
|
In addition to linking Projects to teams, you can link issues to teams (Beta). Note: child issues will not be automatically linked.
...