Jira

ExpandedToggleIcon        Connection Dialog

To connect to Jira, first you need to select the Environment (Cloud or Server) to connect to and enter the Domain.

 

Connecting to Jira Server

To connect to Jira Server, you need to specify your User Id (user email) and Password (API token).

 

Connecting to Jira Cloud

 

For Basic Authentication, you need to enter your User Id (user email) and Password (API token).

For OAuth Authentication, you need to:

1.Click Web Login;
2.Sign in to Jira in the opened login page in the browser.
3.Cloud Id and Refresh Token are automatically generated.

 

In addition to the required options, Advanced connection options may be set for more fine connection tuning.

 

ExpandedToggleIcon        Advanced Connection Options

The following table describes the options that you can include in the Connection String using the Advanced Connection Editor dialog box:

 

Option

Description

Authentication Type

Determines the type of API authentication - Basic or OAuth.

Connection Lifetime

When a connection is returned to the pool, its creation time is compared with the current time, and the connection is destroyed if that time span (in seconds) exceeds the value specified by Connection Lifetime. The default value is 0 (connection always returns to pool).

Connection Timeout

The length of time (in seconds) to wait for a connection to the server before terminating the attempt and generating an error. The default value is 60.

Default Command Timeout

The time in seconds to wait while trying to execute a command before terminating the attempt and generating an error. The default value is 60.

Failover Retries

The number of retries to perform a command if it fails because of the exception, which indicates that the reason of a failure may be temporary. The default value is 7.

Local SQL Engine

Determines whether to enable local SQL processing (enabled by default). Local SQL processing allows performing complex SELECT statements that cannot be directly compiled to Jira API calls. In this case the data from the mentioned cloud objects is queried to the local cache, and then the query is performed against the cache.

If local SQL processing is disabled, only simple SELECT statements that can be directly translated into Jira API calls can be used. More complex SELECT statements will fail.

Max Pool Size

The maximum number of connections allowed in the pool. Setting the Max Pool Size value in the connection string can affect performance. The default value is 100.

Min Pool Size

The minimum number of connections allowed in the pool. The default value is 0.

Password

For Jira Basic authentication, it stores API Token.

For Jira OAuth authentication, it stores OAuth access token.

Persist Security Info

Indicates if security-sensitive information, such as the password, is not returned as part of the connection if the connection is open or has ever been in an open state.

Pooling

If true, by default, the connection is drawn from the appropriate pool or is created and added to the appropriate pool.

Proxy Host

The host name or IP address of proxy server.

Proxy Password

The password for the proxy server account.

Proxy Port

The port number of the proxy server. The default value is 3128.

Proxy User

The proxy server account name.

Readonly

Indicates whether the connection is read-only (allows only SELECT statements).

Token Server

When Jira Basic authentication is selected, this parameter is not used.

When Jira OAuth authentication is selected, SSIS Data Flow Components for Jira can query new refresh tokens automatically when the current one expires and store them between sessions if you set this parameter. This parameter specifies the location to store new tokens between sessions. You can specify a file or a registry key to store tokens. For example, "file://D:\temp\oauth_token_1234.txt" or "reg://HKEY_CURRENT_USER\Software\Devart\dotConnect\OAuth_12345"

Url

Domain address.

User

For Jira Basic authentication, this parameter contains User email.

For Jira OAuth authentication, this parameter is not used.

UTC Dates

If set to True, dates will be converted to UTC format during import, and the date values entered by the user (in SELECT statements, etc.) are considered UTC dates when sending them to the data source.