Creating Links in Atlassian Confluence

In this article, we take you through the steps of creating new OSLC links or adding links to existing OSLC resources from your Confluence page using OSLC Connect for Confluence.

It assumes that your setup has been previously handled by the various Administrators at their respective levels.

You can suggest your Administrators review the corresponding Learning Journeys if you happen to have any problem with that:

Start your Link

To create or add a new link:

Go to the Edit mode of your Confluence page.
Type {oslc onto the page and select the OSLC Connect - Link macro.
Confluence suggests the OSLC Connect - Link macro upon typing OSLC
Alternatively, you can use the macro browser:

If you don’t see the macro listed, reach out to your Administrator to review the Learning Journeys listed above that cover the installation of the plugin.

Use the OSLC Link Dialog

When you click on the macro name, the macro will open the form to Select or Create an OSLC artifact.

The first step of the OSLC Connect - Link macro

The next step is to select the Domain and a Container. To do so:

Select the domain among those for which you have created a Space Association.
Choose your target container.

If this screen is mentioning Global Configurations, then your artifact container is Global Configuration enabled and you may review Global Configurations for Confluence Links.

Linking to an existing resource

Select the Link to existing radio button.
Choose the artifact type.
Click Add Link.

You can then select one or more artifacts from the remote repository using its Selection Dialog.

Creating a resource and linking to it

Select the Create new radio button.
Choose the artifact type.
Click Add Link.

You can then fill out the form from the remote application to create an artifact there.

When you submit the Creation Dialog, the artifact is automatically created in the remote container (IBM ELM, Polarion ALM) and linked to the active artifact in our local repository (Confluence).

The default Link Display

Links’ default rendering will be a standard link, such as:

You can now save your page and your links will be rendered as follows:

Start your Link

Use the OSLC Link Dialog

Linking to an existing resource

Creating a resource and linking to it

The default Link Display

Other Link Display Styles