Skip to main content
Planview Customer Success Center

Trello

NOTE: Account Migration

Last Updated: 

Atlassian recently began migrating Trello accounts to Atlassian accounts. This process requires users to manually sign in to their accounts on Trello to complete the migration, and may take some time to complete.

During this time, Person Reconciliation may stop working as the user's Full Name becomes unavailable through the API and is replaced with the corresponding username.

To resolve this issue, you may need to modify the Atlassian Public Name to match the user's Full Name for existing integrations.

Trello Logo

 

 

Overview

Trello is a project management tool that uses boards, lists, and cards to help organize and prioritize projects. Thanks to Trello’s simplicity, many software delivery organizations adopt it as the project command center. That said, the detailed work to complete the project is often carried out by many practitioners working in several purpose-fit tools to maximize their own productivity.

Key Features and Benefits

Integration helps flow cards and updates to cards between Trello and all the other tools in your software delivery toolchain. The seamless flow of data eliminates the waste and overhead endemic in project management and cross-team collaboration, including duplicate data entry, status meetings and chasing down information. In the software delivery context, Trello is commonly integrated with “downstream” tools used by product managers, developers, testers and release managers to implement the details of a project. Most often Trello is integrated with Agile planning tools (Jira, Azure DevOps, Digital.ai Agility) and issue tracking tools (GitHub, GitLab, ServiceNow).

Demo Videos

 


 

Supported Extensions

Custom Fields Power-Up

Retrieval of values specified with Trello's built in Custom Fields power-up is supported.

Hello Epics Power-Up

Retrieval of 'children' relationships via Trello's Hello Epics power-up is supported.

 


 

Connector Setup Details

This section describes the basic steps needed to prepare your Trello instance for use with Hub. Note that additional fields for synchronization or configuration of queries may be required depending on the requirements of your integration.

Minimal User Permissions & Hub User

We recommend that you create a new user within your external tool, to be used only for your Hub integration. This is the user information you will enter when setting up your repository connection within Planview Hub. By creating a new user, you will ensure that the correct permissions are granted, and allow for traceability of the modifications that are made by the synchronization. 

In general, your user account should have sufficient permissions to create, read, and update artifacts in your repository. However, depending on the use case, your user may need different permissions. For example, if you are only interested in flowing data out of your repository, your user may not need to have full CRUD access, as the 'create' and 'update' permissions may not be needed.

Your user should have a secure password or token. Please be aware that Hub will not allow you to save a repository connection utilizing a weak password/token, such as 'tasktop.'

See Trello Help to learn how to create a new user.

List of minimal user permissions:

  • Administrator of a team on the board(s) being synchronized.

All other users being synchronized will need to either be a member of a team on the board(s) being synchronized, or a member of the board(s) being synchronized.

Connecting to the Trello Repository

Token Authenticator

Required Fields: 

  • Location/Connection URL 
  • API Key: An API key associated with the user you would like to use.
  • Token: An authentication token associated with your API key.

Optional Fields:

  • Throttling Settings: This field indicates the number of API calls that can be made per minute. See details here.
    • Note: This field should only be set under the guidance of customer care as the ideal value is highly dependent on each customer's unique environment. 
  • Connection Security: If checked, insecure connections to this repository will be allowed. See details here.

Screenshot 2023-08-14 at 10.03.28 AM.png

SSO Authentication

Additionally, Jama supports the following SSO implementations:

  • Script (HTTP cookies)
  • X.509 Certificate

Learn more about how to set up your repository in Planview Hub here. 

 


 

Other Configuration Settings

Rich Text

Supported rich text elements are: 

  • Headings
  • Code
  • Lists
  • Paragraph
  • Quote
  • Anchor
  • Emphasis
  • Strong

Attachments

In Trello, 'Attachments' can be split into many different types, which are treated differently by Hub:

Trello Attachment Types

Hub differentiates Trello 'Attachments' into three categories:

  • Attachments: These are files uploaded to Trello after selecting 'Attach from Computer.'  These are what will flow when you choose to flow attachments as part of your integration.
  • Relationships: These are relationships to other Trello cards (not boards) created when you select 'Attach from Trello.' These will be treated as 'Related To' relationships in your Hub integration. 
  • Web Links: These are URLs to third-party file services, Trello boards, or arbitrary links added by the user when selecting 'Attach from Google Drive, Dropbox, Box, Onedrive, or Trello (when selecting a board),' the 'Attach a link' text box, etc. These URLs will be handled by Hub as Web Links.

The Trello connector can retrieve the following metadata when flowing attachments out of Trello:

  • Date
  • Author
  • File Name
  • ID
  • Location
  • Size

Learn more about how to configure attachment flow in Planview Hub here.

Person Reconciliation

For person reconciliation, the following fields are available:

Fields Used for Hub’s Default Person Reconciliation Algorithm

Field Names for Person Reconciliation Extensions

(Note that these are case sensitive)

Label in Trello

ID

id

ID

(Not accessible in Trello UI)

Username

username

Username

Email

N/A

N/A

N/A

fullName

Full Name

Learn more about how to configure person reconciliation in Planview Hub here.

Full Scan

Due to third party API limitations, updates to the following fields may not trigger change detection or cause a synchronization immediately.  To ensure these updates synchronize, a high fidelity full scan must occur or another qualifying change must be made to the artifact:

  • "Subscribed" Boolean Field

Learn more about how to configure change detection and full scan intervals in Planview Hub here

 


 

Supported Features

Special Features Supported

You can learn more about special features in Planview Hub here.

Feature

Applicable Hub Version

Applicable Repository Versions

1Not_allowed.svg.png Time Worked (Worklogs)

1Not_allowed.svg.png Impersonation

   

1checkicon.png Comments

1Not_allowed.svg.png Impersonation

1Not_allowed.svg.png Public/Private

Planview Hub: 18.4.1 and later

Any supported repository version:

1checkicon.png Attachments

1Not_allowed.svg.pngImpersonation

Planview Hub: 18.4.1 and later

Any supported repository version:

N/A - State Transitions

(Trello does not use state transitions. Status can flow out of or into Trello as a single-select.)

Planview Hub: 18.4.1 and later

Any supported repository version:

 


 

Supported Artifacts

Supported Work Items

Learn about the difference between containers and work items in Planview Hub here

Supported Work Item Type

Applicable Hub Versions

Applicable Repository Versions

Unique URL?

Card

Planview Hub: 18.4.1 and later

Any supported repository version:

Yes

Supported Containers

Learn more about containment in Planview Hub here

Containers that can synchronize between repositories

Applicable Hub Versions

Applicable Repository Versions

Unique URL?

N/A

 

 

 

Containers used to define the boundary of a collection

(when clicking 'Manage Projects' on a collection)

 

 

 

Boards

Planview Hub: 18.4.1 and later

Any supported repository version:

N/A

Containers used for artifact routing

 

 

 

Boards

Planview Hub: 18.4.1 and later

Any supported repository version:

N/A

 


 

Supported Field Types

Note: If one field of a given type is supported, others that are also that type in theory should also work. However, sometimes there are instances in which this is not the case due to the repository. So, while we can claim support for fields at the type level, there is a chance that some specific fields of a given type will not synchronize properly.

Field Type

Does Hub support custom fields of this type?*

How is field type referenced in the repository?

Sample Repository Fields Supported

Particular Repository Fields NOT Supported

1checkicon.png String

1checkicon.png

Text

Card Number, ID, Name, Short Link

Email

1checkicon.png Single-select

1checkicon.png

Dropdown

List, Board

 

1checkicon.png Multi-select

1Not_allowed.svg.png

 

Labels

 

1checkicon.png Boolean

1checkicon.png

 

Subscribed, Archived, Due Complete

 

1Not_allowed.svg.png Date

 

 

 

 

1checkicon.png Date Time

1checkicon.png

Date

Due Date, Last Activity Date

 

1Not_allowed.svg.png Duration

 

 

 

 

1checkicon.png Double

1checkicon.png

Number

Position

 

1Not_allowed.svg.png Long

 

 

 

 

1Not_allowed.svg.png Person

 

 

 

 

1checkicon.png Persons

N/A

 

Members

Voted Members

1checkicon.png Relationship(s)

Learn how to configure relationships in Planview Hub here.

N/A

 

Related to

Children (via Hello Epics power-up)

Parent

(due to Third Party API limitation)

1checkicon.png Rich Text

N/A

 

Description

 

1checkicon.png Location (read only)

N/A

 

Short URL, URL

 

1checkicon.png Web Links

N/A

 

 

 

*custom fields available via Custom Fields power-up

 


 

Functional Limitations

Category

Limitation

Applicable Hub Versions

Applicable Repository Versions

Configuration Requirement

Labels to be synchronized into Trello must be defined on the Trello board.

Planview Hub: 18.4.1 and later

Any supported repository version:

Feature Unsupported

Cards cannot currently be moved between boards (the board ID is read-only).

Planview Hub: 18.4.1 and later

Any supported repository version:

Third Party API Limitation

Spaces in attachment file names are converted to underscores.

Planview Hub: 18.4.1 and later

Any supported repository version:

Third Party API Limitation

Trello requires the size of an attachment to be provided when synchronizing attachments. Repositories that do not provide attachment size in the metadata will be unable to synchronize attachments into Trello.

Planview Hub: 18.4.1 and later

Any supported repository version:

Feature Unsupported

The Trello connector supports displaying and synchronizing of basic Markdown syntax. Full Trello Markdown is not supported.

Planview Hub: 18.4.1 and later

Any supported repository version:

Third Party API Limitation

Trello deliberately hides emails in their REST API responses.  It is not exposed for security reasons, and there is not a way to change this within the product.  As such, the e-mail field on cards cannot be synchronized and person search by e-mail is not possible.

Planview Hub: 18.4.1 and later

Any supported repository version: