3 Comments

In order to sync with Trello you need to set up a connection between your story map to a Trello board. You need to be a Story map Admin in StoriesOnBoard and a normal user on the Trello board you’d like to sync with.

Connect your story map to a Trello board

I assume that you already have a story map and a board and in Trello and lists are also defined on that board. Please create them if they are not exist yet. I’m using the MapShop sample map in this guide.

  1. In StoriesOnBoard open the story map and from there open Board settings
    BoardSettings_menu_thumb2
  2. On Tool integration tab select Trello and click Connect (watch out for the possibly blocked popup!)
     BoardSettings_ToolsIntegration_select_Trello
  3. Allow StoriesOnBoard to create and update cards on behalf of the logged in user by clicking on the Allow button.
    Trello_Connect_board_allow
    The popup window should close after that.
  4. Select the Trello board you’d like to sync with and click on Link board
    BoardSettings_ToolsIntegration_link_Trello_board 
  5. Select the Trello list where new cards should appear when they are sent to Trello
    BoardSettings_Trello_export_select_Trello_list 
  6. Map Trello lists to StoriesOnBoard card statuses
    BoardSettings_Trello_status_mappings
    Similar to the setup above is recommended for most projects. It means that on your story maps you’ll get a higher level (aggregated) overview, where you can plan your releases and in Trello you’ll have the detailed lists needed for the implementation (of course in Trello, you can have as fine grained process as you need for your projects).
  7. Select which fields you’d like to sync with Trello
    BoardSettings_select_which_fields_to_sync_from_Trello 
    If sync name and description changes are checked, when a title or description changes in Trello or on your story map, the changes will be also visible in the other system (after a refresh).
  8. Allow importing of new cards from Trello for story map collaborators
    BoardSettings_import_options_enable_importing_of_new_cards_from_Trello
    If checked, a new menu appears on the board where non-admin collaborators can also import new cards from Trello. 
  9. Connect your map with the Trello board by saving the settings. A confirmation will be asked, because after establishing the connection to a Trello board, the cards’ statuses will be set by the connected Trello cards’ statues, which means you won’t be able to change them on the board and now they are all being reset to “Todo”.
    BoardSettings_save_confirmation_thum
  10. If the connection is established, you’ll see the following message on the top of the settings dialog:
    BoardSettings_connected_to_Trello
    There you can
    • disable integration temporarily, if you don’t want to send new cards to Trello or sync their statuses, title and description for a while in either of the systems.
    • unlink board, if you’d like to connect your story map to another board in Trello (selecting another board will delete connections between StoriesOnBoard  and Trello cards!)
    • disconnect Trello, if you’d like to connect to Trello with another user or connect to a different tool like JIRA or Pivotal Tracker.

Congratulations! Your story map is connected to a Trello board. Read along to find out how to keep your map and your Trello board in sync.



Comments

Comment by Nikita Dedik

That's a really huge and valuable update! Fantastic!!

Nikita Dedik
Comment by Nikita Dedik

Okay, I setup a connection with Trello, but when I try to change status of some older story, I receive an error about some missing permissions and immediately a redirect to error page.

Nikita Dedik
Comment by Arpi

Dear Nikita,
Please contact us from the feedback widget found on the bottom-right corner in the app.
Thanks,
Arpi

Post comment