Trello is a task and project management tool for teams of all sizes. Unlike many task trackers, Trello represents tasks as cards placed into columns on a board, helping to visually organize information, what state tasks are in, and the flow of tasks.


RBCommons integrates with Trello, adding a review request field for associating related cards with a change.


You can have multiple Trello integrations (up to your plan limit), allowing the field to only be shown for certain groups or repositories on RBCommons or for them to map to different Trello teams.


Configuring Trello

  1. In your Team Administration page, navigate to Integrations and click Add Integration -> Trello.


  2. Provide a descriptive name in the Name field.

  3. Configure the Conditions under which the Trello cards field should appear for this integration.

    This lets you limit this configuration for specific repositories or review groups, if needed.

    To always show the field, select Always match.

  4. Enter your Trello API Key and Trello API Token.

    You can find the API key by visiting the Trello Developer API Key page. In the same section as your key, you’ll find a link to generate a token. Place both in their respective fields in your RBCommons configuration.


    ../../../_images/trello-keys.png


Adding Cards to Review Requests

When Trello is enabled, a Trello Cards field will be shown below Testing Done. Editing this field (by clicking the pencil icon) will let you search for and add cards related to your review request. Once you’ve specified the cards you want, click OK to save the field.


The names of added cards will be shown in the field. Clicking a name will take you to the details for that card in Trello.


../../../_images/trello-field.png