Resource: External System Link Ticket Link ( /api/externalsystemlink/{externalSystemLinkId}/ticket/{ticketId}/link )
Resource you can POST to, resulting in Allows the creation of a new Incident incident in ET that is synchronized to a Ticket ticket in an external system (POST creates the background task only, which is then completed asynchronously as linking can be take a long timeJIRA, TFS or Rally).
Methods
POST
...
Starts Creates a background task for creating an incident from an external ticket. Note: this task completes asynchronously and may take some time to complete.
Required Permissions
- TestManagement/ExecuteTests
...
Create An example of creating a new incident synchronized with a ticket. Note: When the task completes, retrieving the progress of the task will include a link to the Incident that was created and an additional value, 'IncidentId'.
Request Headers
Key | Value | Description |
---|---|---|
Accept | application/json |
Request Parameters
Key | Value | Description |
---|---|---|
{ticketId} | 16841 | ID of the ticket to link to, in . In cases of systems such as JiraJIRA, this is the internal identifier, not the 'Key' for the ticket (issue). |
{externalSystemLinkId} | c63e805c-e5d3-4919-9d10-a0a500e0754a | ID This is the unique identifier of the ticket to external system link to, in cases of systems such as Jira, this is the internal identifier, not the 'Key' for the ticket (issue)in ET. |
Response Headers
Key | Value | Description |
---|---|---|
Content-Type | application/json; charset=utf-8 |
Response Body
Code Block | ||
---|---|---|
| ||
{ "Complete": false, "TotalElements": 0, "ProcessedElements": 0, "StartedAt": "2012-08-06T11:28:45Z", "ProgressInPercent": 0.0, "Id": "ticketlinking_cba3035a-bf63-4006-89b1-b291aaac0460", "Message": null, "Self": "http://localhost/api/backgroundtask/ticketlinking_cba3035a-bf63-4006-89b1-b291aaac0460" } |
Status Code
202 - Accepted
This example shows the progress response of linking once completed, including the additional details of the Incident that was created.
Request Headers
Key | Value | Description |
---|---|---|
Accept | application/json |
Request Parameters
Key | Value | Description |
---|---|---|
{ticketId} | 16841 | ID of the ticket to link to, in . In cases of systems such as JiraJIRA, this is the internal identifier, not the 'Key' for the ticket (issue). |
{externalSystemLinkId} | 9b01796c-a9ae-40cb-a6ad-a802346c0c33 | ID This is the unique identifier of the ticket to external system link to, in cases of systems such as Jira, this is the internal identifier, not the 'Key' for the ticket (issue)in ET. |
Response Headers
Key | Value | Description |
---|---|---|
Content-Type | application/json; charset=utf-8 |
Response Body
Code Block | ||
---|---|---|
| ||
{ "Complete": true, "StartedAt": "2012-08-06T11:39:45Z", "FinishedAt": "2012-08-06T11:39:53Z", "ProgressInPercent": 1.0, "Id": "ticketlinking_9b01796c-a9ae-40cb-a6ad-a802346c0c33", "Message": "Completed", "IncidentId": "029b2c43-38be-4c94-b547-a0a50185fb9e", "Self": "http://localhost/api/backgroundtask/ticketlinking_9b01796c-a9ae-40cb-a6ad-a802346c0c33", "Links": [ { "Href": "http://localhost/api/incident/029b2c43-38be-4c94-b547-a0a50185fb9e", "Rel": "Incident" } ] } |
Status Code
202 - Accepted
...