Inserting a link to remote content
We can insert links to remote content into elements containing a rich text field using the Insert Link to Remote Document button in the rich text editor. Only remote content that is configured for remote server access can be selected using this button.
Click Insert Link to Remote Document, and use the wizard panels to select a document.
To connect to a remote server, you identify the server and the authentication method used to access the server. We can either select a predefined server or enter the server URL directly. By default, no predefined servers are configured, but an administrator can add servers to the list. To authenticate with a server, there are several available methods:
- If single sign-on is configured between the remote server and the portal, we can connect with the current user.
- We can enter a user ID and password for the remote server.
- We can select a credential vault slot associated with the server. Credential vault slots are set up by an administrator and enable users to log in without credentials.
If we use a user ID and password or credential vault slot, the remote server must accept authentication requests that use HTTP basic authentication.
If you access the remote server with a user ID and password, a temporary credential vault slot is created to store and manage authentication data. When you close the wizard, the temporary credential vault slot is automatically deleted. However, if you do not close the wizard explicitly, the temporary credential vault slot cannot be deleted. For example, this situation can occur if you close the browser window before completing the wizard. Any temporary credential vault slots that are not used for at least three hours are removed by a cleanup task (com.ibm.portal.cmis.TransientSlotCleanupTask) that runs once a day. An administrator can change the schedule of the cleanup task using xmlaccess.sh.
Theme note: The Insert Link to Remote Document function requires the wp_federated_documents_picker theme module. The page containing the authoring portlet must use a theme that integrates this theme module. In addition, to ensure that the module is loaded, the module profile used by the page must include the wp_federated_documents_picker theme module. Both the deferred profile (profiles/profile_deferred.json) and the full profile (profiles/profile_full.json) of the Portal 8.0 theme support the wizard to insert links to remote content.
If the wp_federated_documents_picker theme module cannot be loaded by the authoring portlet, the wizard is not available when you click Insert Link to Remote Document. To access the wizard, ensure that the theme and module profile applied to the portal page containing the authoring portlet include the wp_federated_documents_picker theme module. If the feature is disabled when using inline editing of web content, complete these steps:
- Apply a theme to the hidden authoring page containing the wp_federated_documents_picker theme module. For example, we can apply the Portal 8.0 theme.
- Apply a module profile to the hidden authoring page containing the wp_federated_documents_picker theme module. For example, we can apply the full profile of the Portal 8.0 theme.
- Apply a skin without decorations to the reserved authoring portlet instance on the hidden authoring page. For example, we can apply the "Portal 8.0 - No Skin" skin.
Parent: ElementsRelated:
Related:
Configure remote server access for links
Configure the federated documents feature
Related:
Determine which client side APIs the current portal page provides