tJIRAInput

Property Type

Select the way the connection details will be set.

• Built-In: The connection details will be set locally for this component. You need to specify the values for all related connection properties manually.

• Repository: The connection details stored centrally in Repository > Metadata will be reused by this component.

  You need to click the [...] button next to it and in the pop-up Repository Content dialog box, select the connection details to be reused, and all related connection properties will be automatically filled in.

This property is not available when other connection component is selected from the Connection Component dropdown list.

Schema and Edit schema

A schema is a row description that defines the number of fields (columns) to be processed and passed on to the next component.

Note that the schema of this component is empty by default, and you need to click Guess schema to retrieve it. The schema is a single column json of String type that stores the issue or project information in JSON format.

Jira URL

Specify the URL used to access JIRA.

Jira version

Authentication options

Select one of the following authentication methods depending on the server version and security requirements:

• If you selected Jira Server (v2):

  • Basic: Specify the username and password to access JIRA.

    To enter the password, click the [...] button next to the password field, enter the password in double quotes in the pop-up dialog box, and click OK to save the settings.

  • Personal Access Token: To enter the JIRA personal access token, click the [...] button next to the Token field, paste the token, and click OK to save the settings.
• If you selected Jira Cloud (v3):

  • Email and Token: Specify the email address to access JIRA, as well as the JIRA API token. Click the [...] button next to the Token field, paste the token, and click OK to save the settings.

JIRA resource

Select the JIRA resource from the drop-down list, either Issue or Project.

Use JQL query

In the JQL query field, specify the JQL (JIRA Query Language) query based on which you will search for issues in JIRA. Do not enter the query in double quotes. For more information about the JQL, see the Jira documentation.

If left empty, all issues from the defined JIRA account are retrieved.

This field is available only when Issue is selected from the Resource type drop-down list.

Issue ID

Enter the ID of the specific issue you want to retrieve from JIRA.

This field is available only when Issue is selected from the Resource type drop-down list.

Project ID

Enter the ID of the specific project you want to retrieve from JIRA.

This field is available only when Project is selected from the Resource type drop-down list.

Batch size

Specify the number of issues to be processed in each batch.

This field is available only when ISSUE is selected from the Jira resource drop-down list.

tStatCatcher Statistics

Select this checkbox to gather the Job processing metadata at the Job level as well as at each component level.

Global Variables

NB_LINE: the number of rows processed. This is an After variable and it returns an integer.

ERROR_MESSAGE: the error message generated by the component when an error occurs. This is an After variable and it returns a string. This variable functions only if the Die on error checkbox is cleared, if the component has this checkbox.

A Flow variable functions during the execution of a component while an After variable functions after the execution of the component.

To fill up a field or expression with a variable, press Ctrl+Space to access the variable list and choose the variable to use from it.

For more information about variables, see Using contexts and variables.

Usage rule

This component is usually used as a start component of a Job or subJob and it always needs an output link.

Limitation

This component doesn't support retrieving the comments of issues from JIRA.