Skip to main content

WebClient Enhancement Suite Installation Guide

Raise a support ticket

DISCLAIMER​

Any advice FYB provides in relation to setting up any FYB App, FYB Add-in, FYB Connector and or advice in relation to opening access to your on-premise or in the cloud systems will be general advice only. This means that the advice is of a general nature and will not take into account your network setup, network infrastructure or any security requirements that you may have or in fact need. It is highly advised that you seek advice from internal or external providers to ensure that they are comfortable with what is required prior to going ahead with any deployment, setup or configuration for external access.

LICENSE DETAILS​

Please contact FYB for a valid license if you are yet to obtain one for your Add-in.

INSTALLATION COMPONENTS​

The following installation components are required to ensure full functionality of the FYB Web Client add-ins:

  • FYB WebClient Enhancement Suite API - this is a server-side installation

INSTALLING FYB WEB CLIENT ENHANCEMENT SUITE​

LICENSE​

  1. Create a folder to house the license file (.lic) on the IIS Server

  2. Place the license file in this folder

    info

    Note: You will be asked to enter this location during the installation

TRUSTED USER ACCOUNT​

Add the account that will run the application pool as a Trusted User Account in Enterprise Studio. Please refer to your Enterprise Studio help file on adding trusted accounts. If using a system account (application pool identity, network service etc) you will be required to enter the details as DOMAIN\ServerName$ . If using a dedicated windows service account, you will be required to enter the details as DOMAIN\username.

INSTALLATION​

The FYB WebClient Enhancement Suite MSI will:

  • Deploy the installation files
  • Setup the application pool and application in IIS
  • Setup the temp folder
  • Configure the FYB Webclient Enhancement Suite as specified by the user

To install the FYB Webclient Enhancement Suite follow these steps:

  1. Run command prompt as an administrator and launch the FYBWebClientEnhancement Suite.msi

  2. Click Next

    image.png

  3. On the Web Application Settings screen, select a Site to host the application and enter a name for the Virtual Directory

  4. Click Next.

    image.png

    Note

    You can use an existing virtual directory or create a new one with the installer

  5. On the Application Pool Settings screen, enter the domain, username, and password for the Application Pool identity.

  6. Click Next

    image.png

  7. On the Configuration Settings screen, enter the dataset ID, workgroup server, license path, and temp folder path.

  8. Click Next

    Note
    • You can use an existing folder for the Temp Path or create a new one with the installer. It should contain a trailing slash
    • The License Path should be set to the local path of the license file (including the file name). For example: C:\FYB Add-ins\Licenses\License.lic
    • The workgroup server should be set to local

    image.png

  9. On the Custom Setup screen select the install location and Click Next

    image.png

  10. Confirm the Installation by clicking Install

    image.png

  11. The installation will commence

    image.png

  12. Once the installation is complete click Finish

    image.png

CONFIGURATION​

  1. After the installation process is complete, you will be able to locate the application installed within the site selected during installation

  2. From the Features View go to Authentication and ensure that Windows Authentication and ASP.NET Impersonation are the only authentication types enabled. All other's should be disabled

    image.png

    image.png

DEPLOYING ADD-INS TO THE WEB-CLIENT​

DEPLOYMENT​

Once the FYB Webclient Enhancement Suite is installed the following structure will be created in the FYBWebClientEnhancement Suite installation directory.

  1. Navigate to C:\Program Files\FYB Pty Ltd\FYB Webclient API\WebClientAddonScripts.

    Note

    If you changed the installation directory from the default path, the above path will need to be adjusted.

    image.png

  2. Copy all JavaScript files from this directory

    image.png

  3. Navigate to Content Manager Web Client directory, by default this will be C:\Program Files\Micro Focus\Content Manager\Web Client

  4. Within the Web Client directory create a folder called CustomScripts (Named Exactly).

    image.png

  5. Copy the script files into this directory

    image.png

  6. Navigate to the Content Manager Web Client Record directory, by default this will be C:\Program Files\Micro Focus\Content Manager\Web Client\Content\templates\Record

  7. If Content Manager v10 and above: In the RecordCommandPannel.tmpl.html file, locate the DIV that has a class value of "sidebar-nav scroll-command-panel".

  8. If below Content Manager v10: In the RecordCommandPannel.tmpl.html file, locate the DIV that has a class value of "command-panel-padding-left-half listPaddingBottom listPaddingRight".

Insert the below code inside this DIV. The code will need to be inserted at the bottom of the parent DIV element.

<div class="btn-group fyb" id="fyb-addin" style="display:block" onclick="menu()">
<button role="button" name="button" style="width: auto !important; margin-top: 0;color:#000;font-size:13px;margin-bottom:5px;" class="btn btn-flat btn-primary dropdown-toggle" data-toggle="dropdown">
<span style="float:left">FYB ADD-IN & CONNECTOR</span>
&nbsp;
<span class="drop-down-caret" style="margin-top:-5px"></span>
</button>
<ul class="dropdown-menu" role="menu" style="margin-top:0; top:37px; left: 5px;" id="addin-menu"></ul>
</div>
  1. Copy the Custom.css and FYB folder from C:\Program Files\FYB Pty Ltd\FYB Webclient API\WebClientAddonScripts

    image.png

  2. Navigate back to C:\Program Files\Micro Focus\Content Manager\Web Client\Content and copy the FYB folder and Custom.css file into this directory.

    image.png

POST-DEPLOYMENT CONFIGURATION​

When using link generator for the first time, you will be required to provide the settings for the add-in.

Warning

Please note that these settings are centrally managed and will affect all users.

Please follow the steps below on how to configure the add-in:

  1. In Content Manager Web Client, select a Record

  2. Click on the MORE drop-down menu and select Link Generator from the list of option

    image.png

  3. The Link Generator configuration window will appear, within the settings window the below settings are available for configuration:

    Note

    The following settings must be configured at a minimum before Link Generator can be used:

    • License Path
    • Database ID
    • Internal
    NAMEDESCRIPTION
    SOFTWARE VERSIONCurrent version of the installed add-in
    LICENSED TOOrganisation the add-in is licensed to
    LICENSE EXPIRY DATEExpiry date of the license
    DATABASE IDThe two-character dataset identifier
    LICENCE PATHThe LOCAL file path to your license file including the .lic, for example:
    C:\FYB Add-Ins\Licenses\FYB Enhancement Suite_XXXXXXXX.lic
    INTERNALFYB Link Generator API URL configured for internal use. Example: http://servername/LinkGeneratorAPI/Record/
    EXTERNALFYB Link Generator API URL configured for external use (if applicable). Example: http://servername/LinkGeneratorAPI/Record/
    WEB CLIENTContent Manager Webclient URL
    Example: http://servername/hprmwebclient/?q=uri
    DEFAULT LINKSets the default link format to show when Link Generator opens.
    Can be set to "URL", "HYPERLINK", or "HTML"
  4. Press the Update button to save the settings

  5. Once configured, the Link Generator can now be used

SOFT DELETER​

When using Soft Deleter for the first time, you will be required to provide the settings for the add-in.

Warning

Please note that these settings are centrally managed and will affect all users.

Please follow the steps below on how to configure the add-in:

  1. In Content Manager Web Client, select a Record

  2. Click on the MORE drop-down menu and select Soft Deleter from the list of option

    image.png

  3. The Soft Deleter configuration window will appear, within the settings window the following settings are available for configuration

    Note

    The following settings must be configured at a minimum before Soft Deleter can be used:

    • License Path
    • Database ID
    • Holding Container
    • Soft Deleter Location
    NAMEDESCRIPTION
    SOFTWARE VERSIONCurrent version of the installed add-in
    LICENSED TOOrganisation the add-in is licensed to
    LICENSE EXPIRY DATEExpiry date of the license
    DATABASE IDThe two-character dataset identifier
    LICENSE PATHThe LOCAL file path to your license file including the .lic, for example:
    C:\FYB Add-Ins\Licenses\FYB Enhancement Suite_XXXXXXXX.lic
    HOLDING CONTAINERThe holding container is required by FYB Soft Deleter to transfer records to a temporary holding container. (Please supply the URI of the container to this field)
    SOFT DELETER LOCATIONThe URI of the nominated soft delete location group
    REASONSAdjust the reasons for deletion, the reason will appear under the drop-down list. You may add as many reasons as required or adjust the existing as necessary
    USE EVENT PROCESSORIf enabled, soft deletion of records will be delegated to the Soft Deleter event processor using the Soft Deleted Request additional field as the trigger flag
    REMOVE CAVEATSIf enabled, security caveats will be removed from soft deleted records
    CREATOR RESTRICTIONIf enabled, only the creator of the associated record can remove the record using the soft deleted request
    PUBLISHED RESTRICTIONIf enabled, this prevents records that are published from being soft deleted.
    The published documents are determined through a boolean additional field.
  4. Press the Update button to save the settings

  5. Once configured, the Soft Deleter can now be used

REASSIGN ACTIONS​

There is no configuration required for reassign actions.