Versions Compared

Key

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

This Marketplace App is still in Beta.

If you encounter any issues while using the App, please contact support@teamform.co.

The TeamForm Atlassian Marketplace App is for existing TeamForm customers who also use using Atlassian’s Jira Cloud SaaS product.

Tip

The Marketplace App allows customers to ‘link’ their Jira Issues to a Team with Teams in TeamForm.

Tip

You can link a whole Project to a Team in TeamFrom.

Tip

TeamForm can use the TeamForm Marketplace App to import Jira Issues as TeamForm Objectives.

Table of Contents
stylenone

Setup

...

and Usage Instructions

Info

This process can only be completed by a Jira Admin.

...

  1. Clicked ‘Change' with each of the new setup details.

Issue Linking

  1. Head to an Issue on any Jira board on the current Instance:

  2. Click on ‘TeamForm Team’ on the right-hand side.

    1. A panel will open, showing that this issue is currently ‘Unassigned’ to a TeamForm Team.

  3. To assign a Team, click the select box at the bottom of the panel. Click on one of the Teams to ‘link’ it to this Issue:

  4. To search for other Teams in TeamForm, type the name, or part of a name into the select box. The Marketplace App will query TeamForm, and show potential Teams relevant to your search term.

  5. For example, try typing: ‘customer', which should return 'Customer Success’ as the top result.

...

Note

If you need to remove a Team's Issue link, click the 'x' to the right of the Team in the list.

Project Linking

To link a project to one (or many) TeamForm Team(s):

  1. Click on ‘TeamForm’ on the left-hand sidebar.

    1. This will show the Project-level settings for the App.

  2. To assign a Team, click the select box at the bottom of the panel.

  3. Click on one of the Teams to ‘link’ it to this Jira Project.

  4. To search for other Teams in TeamForm, type the name, or part of a name into the select box. The Marketplace App will query TeamForm, and show potential Teams relevant to your search term.

    1. For example, try typing: ‘customer', which should return 'Customer Success’ as the top result.

Mapping Issue Types to Team Types

Info

This process can only be completed by a Jira Admin.

...

  1. Go to the Admin Page of the Jira Marketplace App.

  2. Scroll to the bottom of the Admin Page, to the section entitled: Team Type Mappings

  3. Make a note of, or copy-paste, a Team Type ID from TeamForm.

    1. You can see a particular Team Type’s ID in the Org Structure section of TeamForm.

  4. Find the Issue Type you would like to map to this Team Type.

  5. Click ‘Change’

  6. Enter your Team Type ID in the text field.

  7. Click ‘Create’.

    1. You can add multiple mappings to the same Jira Issue Type.

    2. You can remove a mapping by clicking on it.

  8. Click ‘Done’.

Importing Jira Issues as TeamForm Objectives

Info

This process can only be completed by a Jira Admin.

...

Note

Note: the import process will not find any Issues to import, unless those Issue Types have been mapped to a Team Type in TeamForm. See the relevant section of this document for details.

Note

The import process will import all Issues of mapped Types into TeamForm. This includes Issues in the past. Be sure this is what you want before creating a mapping from an Issue Type to a Team Type.

In particular, it is probably unsafe to create a mapping from Jira Tasks if there are a large amount of Tasks already in Jira.

Related information

Filter by label (Content by label)
page
showLabelsfalse
max5
spacescom.atlassian.confluence.content.render.xhtml.model.resource.identifiers.SpaceResourceIdentifier@9e4
maxCheckboxfalse
showSpacefalse
sortmodified
showSpacetypefalsepage
reversetruetype
labelsteam team-details types
cqllabel in ( "system-admin" , "marketplace" ) and type = "page" and space = "OS"labelsteam team-details types