Craft.io allows you to set up two-way synchronization with Pivotal Tracker.
There are two steps required to integrate between Craft.io and Pivotal Tracker. Follow them carefully so that the integration succeeds.
Important: In order to connect to Pivotal Tracker, you will need to have the login credentials to Pivotal Tracker.
Synchronize Craft.io to Pivotal Tracker
Connecting Craft.io to Pivotal Tracker
Click Integrations from the user menu at the lower left, and choose to connect to Pivotal Tracker:
You will be asked to enter your Pivotal Tracker API Token;
To generate an API token, open your Profile page on Pivotal Tracker.
Scroll to the bottom of the page and copy the token.
In Craft.io, paste the token into the text field and click Next.
For more about the Pivotal Tracker API Token, go here.
Select a Pivotal Tracker project from the drop-down menu, and click Next.
Note that a product in Craft.io connects to a single project in Pivotal Tracker.
The Mapping Between Craft.io and Pivotal Tracker
The following items will be synced through the two-way integration between Craft.io and Pivotal Tracker. Note that syncing will never delete any items on both sides.
- Delivered/accepted items in Pivotal Tracker will immediately release the story in Craft.io, and vice versa.
- Releasing a story in Craft.io will mark the story in Pivotal Tracker as delivered/accepted upon sync, and vice versa.
Congratulations! You are now ready for your first sync!
You can synchronize the systems for the first time, or do it later. You can also choose to skip this step and sync selected stories instead. For more information about syncing a specific story, see the Sync a Single Story section below.
Note: You can always return to this step by clicking the Push button:
First Time Sync Between Craft.io and Pivotal Tracker
Note: On the first sync, the Pivotal Tracker project is synced into Craft.io. The import is performed once. To enable automatic updates from Pivotal Tracker to Craft.io, you will need to set a webhook in Pivotal Tracker. See ‘Syncing Pivotal Tracker back to Craft.io’ below for more.
Select the parts of your product in Craft.io that you want to push to Pivotal Tracker.
The following options are available:
- All Product - Syncs the entire Craft.io product to Pivotal tracker.
- Releases - Allows you to select one or more Craft.io releases to be pushed to Pivotal tracker.
- Sprint Backlog - Allows you to select one or more Craft.io sprint backlogs to be pushed to Pivotal Tracker.
Once you have completed your selection, click Sync. Depending on the size of your product, the procedure could take several minutes to complete.
When the sync is completed, you will see messages showing what was synced and/or skipped. Note that all Pivotal Tracker stories are created in Craft.io under the PivotalTracker Theme feature, ordered by their Epics. You can move them to different features across Craft.io using drag and drop in the Editor, or by bulk action in the Search and Filter tool. For more about Search and Filtering, look Here
Syncing Pivotal Tracker Back to Craft.io
In Craft.io, select Integrations from user menu and click Sync Pivotal Tracker Back to Craft.io. You will see information on how to create a webhook in Pivotal Tracker, as well as the webhook listener URL to use in the webhook configuration. This is a unique URL that contains your product ID. Copy the URL to your clipboard and continue to the webhook configuration in Pivotal Tracker.
In Pivotal Tracker, open the Settings page of your project and select Webhooks in the sidebar.
Paste the webhook URL you copied earlier and select v5 from the drop-down menu. Click Add.
Syncing a Single Story
At times you may want to update or send a single story to Pivotal Tracker. This can be a new story that you created or one that you updated. You can do this from the Pivotal Tracker section in the story’s right panel:
Click Sync Item to sync the story to Pivotal Tracker.
View the story’s status in Pivotal Tracker.
Click the Pivotal Tracker story title to open the corresponding issue in Pivotal Tracker.
The Pivotal Tracker integration Menu
You can always access the last sync log or disconnect the integration from the 3 dots integration menu: