Universal viewing is an additional View configuration that allows the View Component to work out how to retrieve your original documents. It allows you to retrieve documents from various sources to view, without requiring you to use complex logic in your front end components to work out how to send the View request.
Universal viewing requires more internal communication between your IDOL components, which might affect performance.
When you enable universal viewing, you also configure the location of your document store (a Content component or DAH). You also configure a set of reference fields to specify how to retrieve the original documents (by using Distributed Connector, a Web URL, or from the file system).
To enable universal viewing
Open the HPE IDOL Server configuration file in a text editor.
Add a [UniversalViewing]
configuration section.
In the [UniversalViewing]
section, set Enabled
to True
to enable universal viewing.
Set DocumentStoreHost
and DocumentStorePort
to the host and port of your primary data index component (either the Content component, or DAH). View Server uses this component to retrieve the index representation of your documents to find the appropriate reference fields.
Set one or more of the following parameters to specify the reference fields in your documents that View Server must use to retrieve the documents from the associated sources:
DistributedConnectorReferenceField
|
The document reference field that contains a reference that View Server can use to retrieve the document by using the Distributed Connector. To use this option, you must configure the details for the Distributed Connector in the [Viewing] section. See Configure View to Use a Distributed Connector. |
FileSystemReferenceField
|
The document reference field that contains a reference value that View Server can use to retrieve the document from a local file system or network share. |
WebURLReferenceField
|
The document reference field that contains a reference value that View Server can use to retrieve the document from the Web. |
For example:
[UniversalViewing] Enabled=True DocumentStoreHost=localhost DocumentStorePort=9900 DistributedConnectorReferenceField=AUTN_IDENTIFIER WebURLReferenceField=DREREFERENCE FileSystemReferenceField=ORIGINAL_LOCATION
When you send a View request, View Server uses the requested reference to retrieve the index representation of the document from the document store. It then attempts to find the configured reference fields in the document:
DistributedConnectorReferenceField
, View Server attempts to retrieve the document by using the Distributed Connector. For this option, you must also configure a Distributed Connector in the [Viewing]
section.WebURLReferenceField
(and does not have the DistributedConnectorReferenceField
), View Server attempts to retrieve the document from the Web.FileSystemReferenceField
(and does not have the DistributedConnectorReferenceField
or WebURLReferenceField
), View Server attempts to retrieve the document directly from a file system or network share. Your [Viewing]
configuration must allow View Server to retrieve the file.If the document does not contain any of the configured reference fields, View Server attempts to retrieve the original document by the reference in the request, as usual. If it cannot retrieve the original document by reference, View Server returns the document title and content from the document store.
|