Documentation Center

Enabling and configuring the External Preview module

To allow external parties, for instance translators to see more contextual information (images, ...) when translating, Content Manager foresees an integration endpoint, the External Preview.

About this task

The External Preview endpoint accepts an external resource (XML) and will render it with all linked resources (images, ...) like in the web client preview.

Out-of-the box, this External Preview endpoint requires a regular login, like any other resource in the web client.

To allow users who are not logged in to the web client to access the External Preview functionality, we need to enable the system to execute the specific functionality with a pre-configured identity.

In this section we will explain how you can enable the External Preview module (Trisoft.InfoShare.Web.ExternalPreviewModule.dll) and how you can configure a fixed identity for all requests to this endpoint without requiring a login.

Procedure

  1. Enable the module in the web.config of the ISHCM web site by un-commenting the following line in the section <system.webServer><modules>:
    <add name="TrisoftExternalPreviewModule" type="Trisoft.Info
    Share.Web.ExternalPreviewModule.AuthenticationModule,
    Trisoft.InfoShare.Web.ExternalPreviewModule" preCondition="m
    anagedHandler" />
  2. Enable the custom configuration section for the module in the web.config of the ISHCM web site by un-commenting the following line in the section <configuration>< configSections>:
    <section name="trisoft.infoshare.web.externalpreviewmodule"
    type="Trisoft.InfoShare.Web.ExternalPreviewModule.Configura
    tion.IdentityConfiguration, Trisoft.InfoShare.Web.ExternalPr
    eviewModule, Version=11.0.0.0, Culture=neutral, PublicKeyTok
    en=555d9fcb450e0935" />
  3. Enable the actual configuration section for the module in the web.config of the ISHCM web site by un-commenting the following lines:
    <trisoft.infoshare.web.externalpreviewmodule>
    <identity externalId="THE_FISHEXTERNALID_TO_USE" />
    </trisoft.infoshare.web.externalpreviewmodule>
  4. Update the externalId attribute with the external id (FISHEXTERNALID) you want to use as an identity for the External Preview.