Other integrations

The Other integration type allows you to add an editable named external ID field to stories, or to create your own custom integration that allows importing of stories from external sources via drag and drop. To configure a custom integration, select Other from the dropdown on your project’s Integrations page and enter the following information:

Name

Give this integration a name (e.g., “My Ticket System”). This will be the label of the external ID field in stories, and if you specify an Import API URL as well, this will be the name of the Import panel.

Base URL

This URL will be used to link stories to the external system. If your stories are to be linked to http://www.myticketsystem/1234, enter http://www.myticketsystem/ in this field.

Import API URL

This is optional. If you enter a URL, you’ll see a sidebar item that opens an Import panel in your project with data fetched from that URL. The URL has to return XML in the following format (note that the story type must be one of feature, bug, chore, or release):

  <?xml version="1.0" encoding="UTF-8"?>
  <external_stories type="array">
   <external_story>
    <external_id>foo</external_id>
    <name>More power to shields</name>
    <description ></description >
    <requested_by>James Kirk</requested_by>
    <created_at type="datetime">2008/12/10 00:00:00 UTC</created_at>
    <story_type>feature</story_type>
    <estimate type="integer">1</estimate>
   </external_story>
   <external_story>
    <external_id>bar</external_id>
    <name>I am story 2</name>
    <description >I am a description</description >
    <requested_by>I am the reporter</requested_by>
    <created_at type="datetime">2009/12/10 00:00:00 UTC</created_at>
    <story_type>bug</story_type>
    <estimate type="integer">2</estimate>
   </external_story>
  </external_stories>

Based on the above XML example, you would see the following in your project.

The 'other' integration as it appears in a project sidebar menu

The 'other' integration panel

You can drag these into the Icebox or Backlog, which will create Tracker stories with links to the external resources based in the external_id element in the XML. It’s possible to keep stories and corresponding external resources synchronized via the Activity Webhook and API.

Previous
Campfire