On this page:

What you need to know

There are many OSLC link types available but you may find yourself using only a fraction of those.

OSLC Connect for Jira has a configuration page allowing you to select the default link types used when linking issues to external artifacts.

Later in this article, we will also cover an advanced usage of this configuration screen, allowing you to be more precise on Link Types available in a given project.

A note about this and Project Associations:

A logical but important thing to note here is that the configurations described on this page could be rendered useless without a proper Project Association configuration on your projects.

For example, you may choose the default Link Type for a Task to be Affects Requirement, but if your Jira Project doesn't have a Project Association to a Requirement application (e.g., ELM RM), this will not be the pre-selected Link Type for your Tasks.

Choosing a default Link Type

Now that we have a custom Screen to use, we need to define when it will be used.

This configuration is done on the OSLC Connect Issue Previews configuration page. Without this configuration, the default behavior of OSLC Connect for Jira is to select the last chosen Link Type when creating a link, choosing a default Link Type will override this.

To reach the configuration page, simply follow:

  1. Click the Jira Administration icon in the top right corner and go to the Manage apps tab.

  2. Click Link Type Mapping in the OSLC Connect section.

This page will allow you to choose the default Link Type for each Issue Type. Note that this configuration will affect every Jira Project using the chosen Issue Scheme.

To choose the default Link Type for each Issue Type:

  1. Choose an Issue Scheme in the selection list.

  2. For each Issue Type, you can choose to:

    • Leave the Default value. Which will keep the default behavior of automatically selecting the previously used Link Type when creating a link.

    • Customize the Default Link Type. Choosing a value other than None will make the selected Link Type the pre-selected Link Type when creating a link.

    • Restore the default value. If you want to revert to the default value, you can click the Restore button.

  3. Once you’re satisfied with all the changes, click the Save button at the top right.

It’s important to understand that following this procedure will not restrict the other Link Types from being used. Link Types restrictions are available and explained in the next section of this article.

An example of Link Type Scheme Mapping.

Choosing available Link Types

You may want to restrict some Link Types from being used, or simply remove them from the list because you have no use for them. This can be configured on the same Link Type Scheme Mapping configuration page. Once you are on that page:

  1. Choose an Issue Scheme in the selection list.

  2. On each Issue Type line, you’ll find an Enabled Link Types entry that’ll list all the available Link Types.

  3. To update this list, click the Edit button, which will open a configuration screen.

  4. For each Link Type, you now have the choice to:

    • Allow for both selection and creation of a remote artifact. This is the default value.

    • Allow the selection of a remote article, but restrict the creation.

    • Restrict both selection and creation. This will remove the Link Type from the list of available Link Types when creating a link.

  5. Click the Ok button at the bottom of the configuration screen and click the Save button at the top right of the page.

Similar to the Default Link Type configuration, these changes will affect all projects using the selected Issue Scheme.