Atlassian JIRA

Technical requirements

The following requirements must be met to integrate JIRA with SD Elements.

  • Server version must be 5.x, 6.x, or 7.x.

  • Server configuration must enable remote API access.

    • The option "Accept remote API calls" must be set to "ON".

    • For more information, see the online documentation.

  • Basic authentication must be enabled for connection users.

  • The user configured for the connection should:

    • Be a member of the project

    • Have permission to create, tag, transition and resolve issues.

    • Specific permissions: CREATE_ISSUES, CLOSE_ISSUE, ASSIGN_ISSUES, TRANSITION_ISSUES, RESOLVE_ISSUES

Default assigned fields

The following fields are set by default:

  • Summary

  • Description

  • Labels

  • Priority

Behavior

The integration supports the following:

Connection details

Enter the connection details for the server.

Protocol

Select the protocol for the connection (HTTPS or HTTP) (Default: HTTPS)

Server

The domain name or IP address of the server (Example: jira.server.com)

Context Root

Top-level location where JIRA is installed on a server. The value for this may be dependent on the configuration of an internal corporate proxy or where an administrator has installed JIRA.

Credentials

Enter the credentials needed to authenticate to the server.

Username

Username authorized to connect with the server. This user should be able to create and edit stories/issues in JIRA.

Password

The password used to authenticate to the server

Project details

Enter the project-level details.

JIRA Project Key

The key for the project where issues should be created.

Advanced JIRA configuration

Enter advanced configuration options.

JIRA version

Version of JIRA you are connecting to. (Default: 5)

States which map to DONE in SD Elements

Comma-separated list of states in JIRA that will be mapped to DONE in SD Elements.

To determine what status(es) to enter here, follow these steps:

  1. Click the View Workflow link when viewing a JIRA issue.

    view workflow.png

  2. In the resulting diagram, note the final status(es) that mark the end of the workflow for a given issue. In the diagram below, that status is Done, but in your environment, there may be others.

    workflow.png

In the example above the configuration value to enter is:

Done

If there are multiple statuses in your environment to indicate that work on an issue is complete, simply separate them with commas. For example:

Resolved,Closed

Issue Type

Type of work item that SD Elements will create when creating a task in JIRA. (Default: Bug)

JIRA reopen transition

Name of a transition to reopen an issue after it has been closed.

JIRA close transition

Name of a transition to close an open issue in JIRA.

Synchronization

Enter settings for synchronizing the SD Elements and JIRA projects.

Authoritative Source

Select the tool that will be the authoritative system of record: JIRA or SD Elements. This field is used in case of conflicting statuses between the JIRA issue and the SD Elements task. When you first synchronize a TODO task in SD Elements with an issue in JIRA, they will have the same status. If you then change the status in one tool, for example by closing the issue in JIRA, they will have conflicting statuses. This conflict is resolved when the projects are synchronized. There are three options:

  • ALM (default): The SD Elements task will be updated to match the status in JIRA. This is relevant to most workflows.

  • SD Elements: The JIRA status will be updated to match the SD Elements status.

  • Last Updated: The SD Elements and JIRA states will always reflect the latest update status. For example, if a JIRA issue is most recently updated then the SD Elements task status will be updated to reflect the JIRA status. The opposite is also true.

Include code sample How-To’s in task descriptions

Whether or not to include detailed code samples and How-To’s in the JIRA issue.

This server is not accessible from the SD Elements server

Select this option if SD Elements does not have direct network access to the JIRA server.

For example, if you are using a hosted SD Elements instance but you want to integrate with an internal/protected JIRA system, choose this option and run the Remote Integration Client to perform integration.

Tasks to synchronize

Select the SD Elements tasks that are synchronized with the JIRA project.

Tasks having a minimum priority

Synchronize tasks with a minimum priority (for example, 7 or above). This is useful if you want to limit the amount of work for users. (Default: 7)

Tasks with status

Synchronize only tasks with certain statuses, such as TODO or DONE. (Default: TODO)

Tasks having phase

Synchronize only tasks in certain phases, such as Requirements or Development. (Default: Requirements, Architecture & Design, Development)

Tasks having all of the following tags

Synchronize only tasks containing certain SD Elements task tags. (Optional)

Tasks with verification status

Synchronize only tasks with a specific verification status, such as Pass or Fail. (Default: None, Partial Pass, Pass, Fail)

Advanced ALM options

Enter advanced configuration options.

ALM Title Format

Issues created in JIRA will be given titles that match this format. (Default: "T21: Task Title")

Bypass server certificate validation for HTTPS (insecure, only for testing purposes)

Check this option if you need to test a connection without the proper SSL/TLS certificates.

Issue Labels / Tags

Tag value assigned to JIRA issues (Default: SD-Elements)

ALM parent issue

JIRA project issue to use as the parent issue. SD Elements tasks will be created as children of the parent issue. This is only applicable when creating issue types that are of type "Sub-Type" or similar.

Custom Priority Mapping

If the standard JIRA priorities have been customized, you must map the customized priority names in JIRA to their corresponding SD Elements numeric priorities.

 This is a common option that will need to be set.

For example, map "Blocker" issues to priority 10 in SD Elements, "Critical" to priorities 7-9, and so on.

Custom Fields Mapping

In addition to the default-assigned fields, you can map additional SD Elements fields to JIRA fields.

 Fields that are not required or have default values do not need to be set.

For example, you may have a required field in your JIRA project that is not set by default. Custom field mappings can be set at both the system connection and project connection levels, and that mappings set in a project connection will override mappings set in the system connection.

For more details refer to section Advanced field support.

Custom Lookup Fields

Deprecated method to sync more than one SD Elements project to a JIRA project. As of release 4.1, integrations that use Custom Lookup Fields will automatically be converted to the new method upon their next run.

ALM context

Provide a specific identifier to this project integration that can be used in an issue’s generated title format. This is applicable only when option ALM Title Format contains "Context"

Sync frequency

Select how frequently the SD Elements and JIRA projects are synchronized. You can choose from the following options. The more frequently you run synchronization, the greater the performance impact on both the SD Elements and JIRA servers. This is generally only a concern for large organizations running many synchronizations at once.

Hourly, Daily, Weekly, or Monthly

The projects will synchronize automatically every hour, day, week or month. Daily synchronization is typically sufficient, however you may want to select a more frequent interval if development moves quickly in your organization.

Manually

You must click the Sync button on the ALM Integrations page to synchronize the projects. This is the default value.

results matching ""

    No results matching ""