Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

StorYd Admins can create a connection to a Jira Server/DC instance. Once the StorYd Integration Plugin is installed on Jira, the connection can be initiated from the StorYd Application admin page. A Jira admin will then need to enable the connections from the Integration admin page, in Jira. Once enabled Users in the StorYd Application can define field mappings. This will map StorYd Epic fields to Jira fields. These mappings will be used to export StorYd Epic data into a Jira issue. Once a StorYd Epic is exported into Jira, It will create a link between the StorYd Epic and Jira issue.

Setting up a connection

Install the StorYd Integration Plugin. This can be found on the Atlassian Marketplace. Once the plugin is installed, navigate to the Managed Apps → Global Configuration (STORYD INTEGRATION).

...

In the Epic view select the “Export information” option from the menu, after clicking the menu icon

...

Select the “Integrated Application“ Application (Export)“ in the export type field and then select the relevant integrated application from the dropdown option field.

...

Expanding the Epic you should see an integrations section, listing the exported Issue. Exporting the data has created an integration link between the Jira Issue and StorYd Epic.

...

Creating integration links without exporting data

Users can create a link between a StorYd Epic and Jira Issue without exporting Data (note. Jira plugin version 1.0.2 and above is required).

In the Epic view select the “Export information” option from the menu, after clicking the menu icon

...

Select the “Integrated Application (Link)“ in the export type field and then select the relevant integrated application from the dropdown option field.

...

An “Issue Key“ field will then be displayed. Enter the Jira Issue Key you would like to create a link for and then click the “Create Link” button.

...

This will create a link between the Jira Issue and StorYd Epic.

After exporting a Epic there will be an integration link created between the StorYd Epic and Jira Issue.

...

Each integration link has a clickable link that can be clicked. This will open a new tab to the URL of the linked item.

Network Information

StorYd to Jira

For version 1 of integration. All requests will be initiated from StorYd servers, these requests will be over HTTPS over port 443.

Requests will originate from the following IP addresses:

  1. 35.189.4.59 for the Australian region.

  2. Unknown (non-static IP) for the development region/environment. If a static IP address is required for testing, please contact support.

All requests will only access routes starting with "/rest/storyd-integration/" on your Jira instance. E.g. https://<base-url>/rest/storyd-integratiom/latest/config/initiate-connection.

Jira to StorYd

As of version 1, no requests will be initiated from Jira. Although, during a request from StorYd servers, Jira may send a request to StorYd servers to validate tokens. Requests to validate tokens will be sent to

  1. https://www.storydsoftware.com.au for the Australian region.

  2. https://test.storydsoftware.app for the development region/environment.

There will be future releases where requests will initiate from Jira and send a request to StorYd servers, all requests will be sent to:

  1. https://www.storydsoftware.com.au for the Australian region.

  2. https://test.storydsoftware.app for the development region/environment.