Managing OSLC Links

Once OSLC Connect for Confluence is installed and configured, users have access to a new macro when they edit a page: the OSLC Connect - Link macro. To open the OSLC Link macro editor, users can either:

• Open the macro browser with the toolbar (or with Ctrl+Shift+A) and look for the OSLC Connect - Link macro in the External content section.
• Use the macro suggestions, by typing {oslc anywhere in the page and selecting the OSLC Connect - Link macro.

With the OSLC Connect - Link macro, it is possible to create or remove OSLC links, as well as choose between different display modes.

If everything went as planned, the linking wizard will be closed, then the created OSLC Connect - Link macro(s) will be visible inside the page, at the location that was selected when the editor was opened.

Updating an OSLC Link

After an OSLC Link has been created, you can update a few settings.

1. Double-click on the OSLC Connect - Link macro, or click on the Edit button.
2. A modal will be displayed where you can choose:
   • Display mode: choose how you want the macro to be displayed inside the page.
     • Display as Link (default value): displays the title and icon of the remote artifact. The artifact preview is displayed on mouse hover.
     • Display as small Preview: displays the remote artifact small preview directly within the Confluence page.
     • Display as large Preview: displays the remote artifact large preview directly within the Confluence page. If no large preview is available, displays the small preview instead.
   • Link Attributes: (only when Display as Link is selected) to customize the configured link attributes to display along with the title. The available link attributes are configured by a Confluence server administrator which can also disabled them (without actually removing them) and then they won't be visible even if the Link Attributes combo is not empty.
   • Global Configuration: in case the linked artifact is Global Configuration enabled, you can edit its GC Strategy.
     • Page GC: the remote artifact version will depend on the Global Configuration selected on the page.
     • Pinned GC: always display the same version of the remote artifact. Ignore the page GC.

There is no way to update the target artifact of an OSLC Link. If you chose the wrong artifact, you will have to remove the OSLC Link and then create it again correctly.

Previewing an OSLC Link

At any point when updating an OSLC Link, a preview of the macro is displayed. It allows verifying that the link displays the remote artifact as expected, with the chosen presentation (link, small preview or large preview) and Global Configuration.

Removing an OSLC Link

1. Click on the OSLC Connect - Link macro placeholder you want to remove.
2. Click on the Remove button.

If everything went ok, you should no longer see the macro placeholder inside the page.

Global Configurations Compatibility

OSLC Links cannot be created if the OSLC Remote Application is Configuration Management enabled, unless a Global Configuration has been set up on the current Confluence page, or the user selects a Pinned GC. To learn more, see how to Manage Global Configurations.