JIRA Update

On this Page

1 Settings
2 Examples

Snap type:

Write

Description:

This Snap provides the functionality to execute the HTTP Put method to a JIRA REST API service endpoint to update JIRA issues.

Expected upstream Snaps: Any Snap with a document output view
Expected downstream Snaps: Any Snap with a document input view
Expected input: Input document should contain JIRA issue ID and fields to update. The following example uses the Snap to insert a comment:

 {
        "id": "17000",
        "fields": {
        "comment": "this is an example of JIRA Update Snap to insert comment"
  }

Expected output: Output document contains the response from the JIRA REST API service endpoint. An example of an output document is as following:

  {
        "headers": {
            "strict-transport-security": "max-age=315360000;includeSubdomains",
            "x-content-type-options": "nosniff",
            "x-seraph-loginreason": "OK",
            "connection": "keep-alive",
            "set-cookie": "atlassian.xsrf.token=BWCK-SR48-JN93-ESFC|9516f97dabdfcb95ea739defda6ffec0caa1ece7|lin; Path=/; Secure",
            "content-type": "application/json;charset=UTF-8",
            "date": "Mon, 08 Dec 2014 17:20:18 GMT",
            "x-arequestid": "560x115x1",
            "x-asen": "SEN-2848532",
            "content-length": "0",
            "x-asessionid": "1es5ykj",
            "cache-control": "no-cache, no-store, no-transform",
            "x-ausername": "admin",
            "server": "nginx"
        },
        "statusLine": {
            "reasonPhrase": "No Content",
            "statusCode": 204,
            "protoVersion": "HTTP/1.1"
        },
        "entity": "No Content",
        "original": {
            "id": "17000"
            "fields": {},
            "update": {
                "comment": [
                    {
                        "add": {
                            "body": "this is an example of JIRA Update Snap to insert comment"
                        }
                    }
                ]
            }
        }
    }

Prerequisites:

[None]

Support and limitations:

Works in Ultra Tasks.

Account:

This Snap uses account references created on the Accounts page of SnapLogic Manager to handle access to this endpoint. The Snap supports the JIRA basic auth account.

Views:

Input	This Snap has exactly one input view and receives documents in the view. Each document contains data to be updated at the JIRA REST API service endpoint. The Snap provides the schema on the input view.
Output	This Snap has at most one output view and produces documents in the view. Each document contains the response data from the JIRA REST API service endpoint.
Error	This Snap has at most one document error view and produces zero or more documents in the view. Each document contains the response from the JIRA REST API service endpoint.

Settings

Label

Required. The name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your pipeline.

API version

The JIRA REST API version number.

Example: 2

Default value: 2

Examples

For a simple update to a JIRA item, you can use a simple Mapper + JIRA Update pipeline.

When the JIRA Update Snap has a valid account, the target schema is displayed in the Mapper Snap.
Specify the ID of the JIRA issue by mapping a value to $id, then update the fields you need to. In the following screen, JIRA issue FULL-8 will update the Assignee in JIRA to the value of the pipeline parameter _assignee.

Use the JIRA Get fields API to determine what your custom fields are.

JIRA Update

Settings

Examples

See Also