Microsoft WindowsPermanent link for this heading

This chapter refers to a Microsoft Windows operating system.

InstallingPermanent link for this heading

To install the Fabasoft Folio Client (into the per-machine installation context), perform the following steps:

  1. Download the FolioClient.msi installation package from the Fabasoft Folio installation.
    https://<host>/<vdir>/fscasp/content/lib/FolioClient.msi
    Alternatively, you find the MSI file in the Setup\ComponentsBase\Client folder of the Fabasoft Folio distribution media.
  2. Make sure that you have administrative rights.
  3. Run the FolioClient.msi installation package and follow the installation wizard.

The Fabasoft Folio Client is installed in the following folder:
C:\Program Files (x86)\Fabasoft\Folio 2019\Client\
In case of a 32 bit operating system the base folder is Program Files.

Deployment via Active DirectoryPermanent link for this heading

The deployment of per-machine installation packages via Active Directory is described in the white paper “Deployment of ActiveX Controls via Microsoft Windows Active Directory”.

Deployment of the Google Chrome ExtensionPermanent link for this heading

The deployment of the Google Chrome Extension is described in the official Chromium documentation: http://dev.chromium.org/administrators/policy-list-3#ExtensionInstallForcelist

In case of the Fabasoft Folio Client the following key should be deployed:

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\ExtensionInstallForcelist

"1"="nofhaafhnnklcdahnbackdgpgnimcpob;https://clients2.google.com/service/update2/crx"

Deployment of the Mozilla Firefox ExtensionPermanent link for this heading

The deployment of the Mozilla Firefox Extension is described in the official Mozilla documentation: https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Alternative_distribution_options/Add-ons_in_the_enterprise

In case of the Fabasoft Folio Client the following key should be deployed:

HKEY_LOCAL_MACHINE\SOFTWARE\Mozilla\Firefox\Extensions

"nmextmozpm19@fabasoft.com"="<path_to_extracted_FolioFirefoxExtension_xpi>"

This archive file is located on the web server and can be extracted using any ZIP extractor:

https://<host>/<vdir>/fscasp/content/lib/FolioFirefoxExtension.xpi

Note: Without changing the Mozilla Firefox preferences (as described in the documentation: extensions.autoDisableScopes, extensions.enabledScopes), each user will be notified on the next application startup, that a new Mozilla Firefox Extension was installed. In this case, the user must explicitly confirm, that the Mozilla Firefox Extension should be enabled.

Trusted Sites for Fabasoft app.telemetryPermanent link for this heading

To allow that Fabasoft app.telemetry get more information about the client configuration and taking a screenshot, when pressing the app.telemetry feedback button you have to manually set a trusted site registry key for your web service URL.

Key: HKEY_CURRENT_USER\Software\Fabasoft\WebClient\TrustedSites
Value name: <web service URL e.g. folio.example.com>
Type: REG_SZ
Value data: 1

General SettingsPermanent link for this heading

To avoid that users have to make settings on their own and for best performance deploy following settings on the clients:

  • Add the defined domain name (HTTP) to the trusted sites. This is necessary to enable features like opening and saving documents directly via the web browser.
    Key: HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Internet Settings\ZoneMap\Domains\<domain name e.g. example.com>\<hostname e.g. folio>
    Value name: http
    Type: REG_DWORD
    Value data: 2
  • Add the defined domain name (HTTPS) to the trusted sites. This is necessary to enable features like opening and saving documents directly via the web browser.
    Key: HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Internet Settings\ZoneMap\Domains\<domain name e.g. example.com>\<hostname e.g. folio>
    Value name: https
    Type: REG_DWORD
    Value data: 2
  • Disable ActiveX Filtering (https://support.microsoft.com/en-us/help/17469/windows-internet-explorer-use-activex-controls).
  • Key: HKEY_CURRENT_USER\Software\Microsoft\Internet Explorer\Safety\ActiveXFiltering
    Value name: IsEnabled
    Type: REG_DWORD
    Value data: 0
  • Increase the WebDAV file size limit to 1 GB to be able to work with large documents.
    Key: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters
    Value name: FileSizeLimitInBytes
    Type: REG_DWORD
    Value data: 1073741824
  • Allow opening hyperlinks in Microsoft Office (http://support.microsoft.com/kb/218153).
    Key: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\9.0\Common\Internet (32 bit operating system)
    or
    HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Office\9.0\Common\Internet (64 bit operating system)
    Value name: ForceShellExecute
    Type: REG_DWORD
    Value data: 1

For more information about the meaning of these keys, consult http://msdn.microsoft.com.

Predefined Settings for UsersPermanent link for this heading

The users have the possibility to make different settings in the options dialog. These settings can also be set by the administrator using group policies so that the users can no longer change them.

To ease the group policy setup, you can find the corresponding administrative template here: Policy Templates.

The predefined settings can be defined in the following registry key:

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Fabasoft\NativeClient\Folio

  • Enable Synchronization
    Value name: SYNC_FS
    Type: REG_DWORD
    Value data (disabled): 0
    Value data (enabled): 1
  • Enable LAN Synchronization
    Value name: SYNC_FS_LAN
    Type: REG_DWORD
    Value data (disabled): 0
    Value data (enabled): 1
  • Restrict Path Length for Synchronization
    Value name: SYNC_FS_LONGPATH
    Type: REG_DWORD
    Value data (disabled): 0
    Value data (enabled): 1
  • Enable Contact Synchronization
    Value name: SYNC_MAPI_CONTACT
    Type: REG_DWORD
    Value data (disabled): 0
    Value data (enabled): 1
  • Enable Open Network Drive
    Value name: MOUNT_WEBDAV
    Type: REG_DWORD
    Value data (disabled): 0
    Value data (enabled): 1
  • Automatic Proxy Login
    Value name: AUTOLOGIN_PROXY
    Type: REG_DWORD
    Value data (disabled): 0
    Value data (enabled): 1
  • Download Speed Limitation
    Value name: DOWNLOAD_KBSEC
    Type: REG_DWORD
    Value data (disabled): 0
    Value data (enabled): <KB/s>
  • Upload Speed Limitation
    Value name: UPLOAD_KBSEC
    Type: REG_DWORD
    Value data (disabled): 0
    Value data (enabled): <KB/s>
  • Generate PDF Preview on the Workstation (Unencrypted Documents)
    Value name: AUTOSAVE_PDF
    Type: REG_DWORD
    Value data (disabled): 0
    Value data (enabled): 1
  • Generate PDF Preview on the Workstation (Encrypted Documents)
    Value name: AUTOSAVE_PDF_ENC
    Type: REG_DWORD
    Value data (disabled): 0
    Value data (enabled): 1
  • Generate Thumbnails From the PDF Preview on the Workstation (Encrypted Documents)
    Value name: AUTOSAVE_THUMB_ENC
    Type: REG_DWORD
    Value data (disabled): 0
    Value data (enabled): 1

File and Registry LocationsPermanent link for this heading

The data in these locations must not be removed or modified. The configuration settings will be written during the setup process and/or when logging in with the Fabasoft Web Browser Client.

  • C:\Users\<user>\AppData\Local\Temp (%TEMP%)
  • C:\Users\<user>\AppData\Local\Fabasoft (%LOCALAPPDATA%)
  • C:\Users\<user>\<synchronized folder> (%USERPROFILE%)
  • C:\Program Files (x86)\Fabasoft
  • HKEY_CURRENT_USER\Software\Fabasoft
  • HKEY_CURRENT_USER\Software\Classes\CLSID\<CLSID>
  • HKEY_CURRENT_USER\Software\Classes\<ProgID>
  • HKEY_CURRENT_USER\Software\Microsoft\Office\Excel\AddIns\<ProgID>
  • HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\AddIns\<ProgID>
  • HKEY_CURRENT_USER\Software\Microsoft\Office\PowerPoint\AddIns\<ProgID>
  • HKEY_CURRENT_USER\Software\Microsoft\Office\Word\AddIns\<ProgID>
  • HKEY_CURRENT_USER\Software\Mozilla\NativeMessagingHosts\<ID>
  • HKEY_CURRENT_USER\Software\Google\Chrome\NativeMessagingHosts\<ID>
  • HKEY_LOCAL_MACHINE\SOFTWARE\Fabasoft
  • HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Fabasoft
  • HKEY_LOCAL_MACHINE\SOFTWARE\Classes\CLSID\<CLSID>
  • HKEY_LOCAL_MACHINE\SOFTWARE\Classes\<ProgID>
  • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\ShellIconOverlayIdentifiers
  • HKEY_LOCAL_MACHINE\SOFTWARE\Classes\*\shellex\ContextMenuHandlers\<ProgID>
  • HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Directory\background\shellex\ContextMenuHandlers\<ProgID>
  • HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Directory\shellex\ContextMenuHandlers\<ProgID>
  • HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Folder\Background\shellex\ContextMenuHandlers\<ProgID>
  • HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Folder\shellex\ContextMenuHandlers\<ProgID>
  • HKEY_LOCAL_MACHINE\SOFTWARE\Classes\IE.AssocFile.URL\ShellEx\ContextMenuHandlers\<ProgID>
  • HKEY_LOCAL_MACHINE\SOFTWARE\Classes\IE.AssocFile.WEBSITE\ShellEx\ContextMenuHandlers\<ProgID>
  • HKEY_LOCAL_MACHINE\SOFTWARE\Classes\InternetShortcut\ShellEx\ContextMenuHandlers\<ProgID>
  • HKEY_LOCAL_MACHINE\SOFTWARE\Classes\lnkfile\shellex\ContextMenuHandlers\<ProgID>
  • HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Microsoft.Website\shellex\ContextMenuHandlers\<ProgID>