Visualizing OSLC Links

After an OSLC Link has been created and you are no longer in edit mode, you can visualize it inside a Confluence page. They will be integrated seamlessly among the other contents of the page. Depending of what you chose when the link was created, they will be displayed as a simple link, with a title and icon, as a small preview, or as a large preview.

If you have not started a session yet with the OSLC Remote Application, you won't be able to see the actual icon nor the preview and, if private linking is enabled, not even the title of the remote artifacts. Instead of the preview, you will see the message Log in to see the preview content.. In this scenario, you can click on the Log in link embedded in the message to start the authentication/authorization process.

If, on the other hand, there is no friend application registered for this link anymore, you will instead see an error message and you won't be able to see the artifact icon or preview.

Once the authentication/authorization process is completed, it is expected you see the actual artifact icon, title ^[1] and its preview, but this will not be the case if the OSLC Scheme Auto-Refresh feature is disabled, by a Confluence server administrator, for the friend application to which the OSLC link belongs. In this latter case, refreshing the icon and title must be done manually by pressing the Refresh link where the Log in link used to be. Once this is done, the preview may still not be available if the following scenarios occur:

• The remote artifact has been deleted.
• The user does not have access to the remote artifact.

Once the link information is either manually or automatically refreshed, configured link attributes will be displayed, on the link title's right, as long as the Link Appearance feature is not disabled by a Confluence server administrator. A link attribute is a remote artifact's property configured to be displayed, by a Confluence server administrator, along with the artifact's title once refreshed.

Global Configurations Compatibility

If a Confluence page contains OSLC Links with versioned artifacts, you may see a Global Configuration widget displayed near the page title. A Global Configuration indicator will also be displayed next to each OSLC Link, to explain which version of the remote artifact is displayed.

To learn more about what this means, see how to Manage Global Configurations.

^[1] The title can also be updated after starting a session.This happens if, after creating the OSLC Link, remote users change the remote artifact title (OSLC Connect for Confluence stores the title the artifact had at the moment of the link creation).