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:
Ctrl+Shift+A
) and look for the OSLC Connect - Link
macro in the External content
section.{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.
OSLC Connect - Link
macro editor with the method of your choice.Domain
of the artifacts you want to link with in the OSLC Remote Application.
Supported domains are: Architecture Management
, Change Management
, Quality Management
and Requirements Management
[1].Container
combo will be displayed with the associated remote projects/containers to select [2].Create new
- allows to create a new artifact before linking to it.Link to existing
- allows linking to an existing artifact.Add Link
button.OK
button.If everything went as planned, the selection/creation dialog 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.
If, on the other hand, there is a constraint or failure with the linking, the macro editor will remain open and will report all problems found.
After an OSLC Link has been created, you can choose how you want it to be displayed inside the page:
OSLC Connect - Link
macro placeholder.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.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.
To see how an OSLC Link is going to be displayed in the page:
OSLC Connect - Link
macro placeholder.Preview
button.OSLC Connect - Link
macro placeholder you want to remove.Remove
button.If everything went ok, you should no longer see the macro placeholder inside the page.
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. To learn more, see how to Manage Global Configurations.