X4 Produktdokumentation

Atlassian Jira Connector


jiraIcon_16x16.png  Atlassian Jira Connector: Connects processes with Atlassian Jira.

Please note that in you first need to create a placeholder group with the appropriate Jira credentials to use the adapter. You can do this either manually in the Global Parameter Configuration or via an integration process using the adapter Global Parameter Management.

Example:

PlaceholderGroup.png

Properties

Operation

Defines the operation executed by the adapter

Possible values:

  • Get Issue: Get an issue from a specific project

  • Get all Issues: Get all issues from a specific project

  • Create Issue: Create issue in a specific project

  • Edit Issue: Edit available fields in an existing issue

  • Add Attachment: Add an attachment to a specific issue

  • Remove Attachment: Delete attachment of an issue by global ID

  • Get all Comments: Get all comments from a specific issue

  • Get Comment: Get a specific comment from an issue

  • Add Comment: Add a new comment to an issue

  • Edit Comment: Edit a specific comment

  • Search: Search by parameters

  • Execute Transition: Perform status transition for a specific issue

  • Get Transition: Get status of a specific issue

Parameters

Adapter

Main adapter class (Do not change!)

Possible values: de.softproject.integration.nativeadapter.NativeAdapter : Main class (default)

Repository

Virtual repository of the adapter project. The value cannot be changed.

host

URL of the Jira server

Possible values: Valid URL, e.g. jira.example.com

port

Port of the ReST API

Possible values:

  • Positive integer

  • 443: Default port

key

Project key with or without issue ID

Possible values: Project key, e.g. XVIERXVIER-12345

secure

Defines if the communication should take place via HTTPS or not

Possible values: true (default) / false

username

Jira user to be used for authentification

password

Password of the Jira user to be used for authentication

token

Token used for the authentication

query

Used with operation Get all Issues ; Search criteria as a "Jira Query Language" expression.

Possible values: Valid search criteria, e.g.

  • project=XVIER and Rang < 999

  • project=ITSERVICE and reporter=max.mustermann

offset

Offset at which the enumeration of operations starts

count

Maximum number of returned issues

id

ID that specifies comments or attachments

Status values

1

The adapter operation was executed successfully.

-1

An error occurred during the adapter's execution.

Input

The adapter expects different input structures depending on the selected operation. For more information, see the following subchapters.

Output

The adapter outputs different structures depending on the selected operation. For more information, see the following subchapters.