Skip to main content

Soft Deleter Installation Guide (Web Version)

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 consider 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 Soft Deleter Web Version:

  • FYB Soft Deleter Web Version - this is a server-side installation

INSTALLING FYB SOFT DELETER (WEB VERSION)​

LICENSE​

  1. Create a folder to house the license file (.lic) on the web server

  2. Place the license file in this folder

    info

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

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 Soft Deleter Web MSI will:

  • Deploy the installation files
  • Setup the application pool and application in IIS
  • Setup the temporary folder
  • Configure the application as specified by the user

To install the Soft Deleter Web Version follow these steps:

  1. Run command prompt as an administrator and launch the softdeleter-web-xxx.msi

  2. Click on the Next button

    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 on the Next button

    image.png

    Note

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

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

  6. Click on the Next button to continue

    image.png

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

  8. Click on the Next button

    image.png

    NAMEDESCRIPTION
    Database IdSets the Database ID that connects to the Content Manager dataset to run the application
    Workgroup ServerThe Work Group Server Name that connects to the Content Manager dataset to run the application
    License PathThe path to the license file
    Temp PathThe path to the temporary folder created
  9. On the second Configuration Settings window, select the finalizing options for the record and click on the Next button

    image.png

    NAMEDESCRIPTION
    Holding ContainerThe URI of the Content Manager holding container for Soft Deleter
    Soft Deleter LocationThe URI of the Soft Deleter Location Group within Content Manager
    Soft Delete RequestedThe URI of the Soft Delete Requested Additional Field within Content Manager
  10. On the Custom Setup window select the install location and click on the Next button

    image.png

  11. Confirm the Installation by clicking on the Install button

    image.png

  12. The installation will commence

    image.png

  13. Once the installation is complete click on the Finish button

    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 others should be disabled

    image.png

    image.png

DEPLOYMENT​

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

    Note

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

    image.png

  2. Copy all JavaScript files from this directory

    image.png

  3. Navigate to the Content Manager Web Client install 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

    Note

    If the server already contains other FYB Web Client add-ins then you only need to copy the SoftDeleter.js file - do not include the FYBWebClient.js.

    The contents of the existing FYBWebClient.js file will need to be updated to include any new add-ins being deployed.

    Open the FYBWebClient.js from the Soft Deleter add-in you just installed located here: C:\Program Files\FYB Pty Ltd\SoftDeleter Web\WebClientAddonScripts

    Locate the addinsHtml variable and copy all '<a>' tags in the list.

    image.png

    Open the existing FYBWebClient.js located here: C:\Program Files\Micro Focus\Content Manager\Web Client\CustomScripts

    Paste the contents between the <li> and </li> tags and save the file.

    image.png

    You can now skip to step 10.

  6. Navigate to C:\Program Files\Micro Focus\Content Manager\Web Client\Content\templates\Record

  7. In the RecordCommandPannel.tmpl.html file, locate the DIV that has a class value of "sidebar-nav scroll-command-panel".

  8. Insert the below code inside this DIV. The code will need to be inserted at the bottom of the parent DIV element. See the screenshot below for reference

<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>

image.png

  1. Copy the Custom.css and FYB folder from C:\Program Files\FYB Pty Ltd\SoftDeleterWeb\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

    Note

    If there are already other FYB Web Client Add-ins installed, copy the entire contents of the Custom.css file and paste it at the bottom of the existing Custom.css located here: C:\Program Files\Micro Focus\Content Manager\Web Client\Content\Custom.css

    Do not copy the FYB folder in step 10.