You may configure a scheme to change its linking rules as follows:
- In the OSLC Schemes page, choose the scheme you want to configure and click the
Configure option in the three-dot menu located in the last column of the table.
- Fill out the desired options in the dialog (see details below).
- Click the
Save button.
The configuration dialog shows the following tabs.
Friends Settings
This tab contains settings applicable to a given friend application. Registered OSLC Remote Applications
are listed on the left. Clicking on a friend application shows its detailed options on the right. If a given friend application cannot be
contacted (for example the remote server is currently offline), a warning is displayed and no change can be made on its configuration.
Configuration of other friends can be safely modified. Following are the configuration options for a friend application:
- Enablement
-
This section displays the application name on the left and a toggle button on the right. This button allows to disable or enable a friend
for the ${term-project-plural} using the current scheme. By default, all registered friends will be enabled.
No ${term-project-singular} associations or linking will be possible for a disabled friend or, if the friend is for a Global Configuration Manager application,
it won't be possible to select Global Configurations from that friend. When a friend is disabled, existing ${term-project-singular} associations and links remain.
Disable a friend when it is required to exclude it from the set of ${term-project-plural} using a given scheme.
- Linking
-
This section shows the OSLC domains supported by the friend. Below each domain are its resource types and link types.
You may uncheck a given OSLC domain to forbid creating any link to its resource types. Such restriction will prevent a ${term-project-singular} administrator
to create corresponding associations to remote containers of this friend. You may also uncheck more specifically a given resource type or link type,
to prevent users creating links of such type. This is notably useful when an OSLC remote application supports multiple domains and you want to enforce
a corporate process policy, such as the application can be used only for one domain (e.g. managing requirements) and not another (e.g. managing changes).
Clicking on a resource type or link type shows detailed options on the right:
- Creation dialog is available -
Uncheck this option to prevent creating a new resource while linking.
The linking will be possible only with existing resources of the selected type.
Use this when your process dictates new resources in the target application shall not be created from this application.
- Create backlinks when applicable -
Uncheck this option to prevent creating a backlink regardless of the Global Configuration management of the remote artifact container.
Disabling this option is not recommended unless it is well-known backlinks are not supported by the remote application.
Use this to avoid situation where user is notified of backlink failure for every link created from this application.
- Link Auto-Refresh
-
This section allows to disable or enable the auto refreshing of OSLC links for the selected friend application. By default, and once authenticated
by the friend application, each OSLC link is automatically refreshed to verify whether the remote artifact is still accessible, and to get its up-to-date title and icon.
By disabling this option, users will have to manually refresh OSLC links by hovering them and clicking the
Refresh link.
This helps to reduce network traffic or to improve the links page responsiveness when the friend application is slow.
- Link Appearance
-
This section allows to disable or enable the display of OSLC link attributes for the selected friend application. By default, OSLC link attributes
are displayed, once authenticated by the friend application, if the Link Appearance feature is enabled in its administration page; however, it may be required
to disable them only for the OSLC links of a given friend application(s). By disabling the Link Appearance at scheme level, no OSLC link attributes will
be displayed for the ${term-project-plural} using the scheme and whose remote artifact belongs to the selected friend application.
This helps to reduce network traffic or to improve the links page responsiveness when the friend application is slow.
- Rich Previews
-
This section allows to customize how rich previews of the selected friend application links are rendered:
- Frameless Preview: use this option to display the preview without the header frame. Some remote applications duplicate the resource title in the preview content.
This option helps avoiding redundancy but prevents navigating to the resource.
- Single Preview: use this option to prevent users from switching between the small and large preview.
- Default to Large Preview: use this option to display the large preview by default when available.