Install and configure ServerScan Directory Watcher Service

App registration

Start by registering ServerScan Directory Watcher Service as an app in your Azure tenant.

1. Follow steps 1 and 2 only in Set up third-party integrations in Azure.

Note: While registering the app, make a note of Application (Client ID), Tenant ID, Client Secret, and Enterprise Application Object ID.

2. Go to Entra ID > App Registration, and select your app.

3. Click Go to Enterprise applications at the bottom right of the page.

   

4. Copy the Object ID (Enterprise Application Object ID) and paste it to, for example Notepad, as you will need it later for configuration in WorkZone Configurator.

   

5. To configure the Enterprise Application Object ID in WorkZone, see Configure APP Enterprise Application ID.

Configure APP Enterprise Application ID

When you have registered ServerScan Directory Watcher Service as an app, you need to configure the access to WorkZone in WorkZone Configurator.

1. Log in to WorkZone and open WorkZone Configurator.

2. Go to Global > OAuth settings > Integrations tab, and click Edit next to the XDISCANUSER account.

   

3. Enter the Enterprise Object ID of the Azure Entra ID app in the Object ID field, turn on Allow to act on behalf of other users, and select the security code 9 in the Security code field.

   

4. Click Save.

Download the folders

Before you can start the installation, you need to download two folders from the release drive ..\Release\WorkZone Directory Watcher:

• Deployment folder that contains the deployment script for automatic installation and configuration files.

• WZSS_Setup folder that contains the installer.

Install ServerScan Directory Watcher Service

Run the installer

1. Right-click Windows PowerShell and select Run as Administrator.

2. Go to the WZSS_Setup folder that contains the KMD.WorkZone.ServerScan.Setup.MSI file.

3. The table below shows the parameters that are required to install ServerScan Directory Watcher Service:

Parameter	Description	Example
DIRECTORYWATCHER	Path to the folder to monitor for scanned documents.	C:\ScannedDocs
SCHEMA	Path to the Components\Schedules folder. The folder must be named as shown in the example.	C:\Components\Schedules\
TRANSFORMATIONS	Path to the Components \Transformation folder. The folder must be named as shown in the example.	C:\Components \Transformations\
ERRORPATH	Path to the folder that stores error files.	C:\Logs\Errors
OUTPUTPATH	Path to the folder that stores processed files.	C:\ProcessedDocs
CLIENTID	Azure application client ID.	12345678-1234-1234-1234-123456789abc
TENANTID	Azure tenant ID.	87654321-4321-4321-4321-abcdef123456
CLIENTSECRET	Encrypted Azure application client secret.	EncryptedValue See Encrypt the secret.
REDIRECTURL	Redirect URL for OAuth authentication	https://localhost
AUTHREQUESTURL	URL for authentication requests.	https://<domainname>/.default Replace <domainname> with your domain name.
ODATAURL	URL for OData API.	https://<domainname>/odata/v3 Replace <domainname> with your domain name.
PROTOCOLANDHOST	Protocol and host for communication	https://<domainname> Replace <domainname> with your domain name.
LOGPATH	The path to the folder that stores logs that are generated daily.	<log file path>\\log.txt Replace <log file path> with the location of logs to be generated. For example: "C:\\WZ\\WZSS\\log.txt"

4. Use the following command to install the .MSI with all parameters. Replace the placeholders with actual values:

   msiexec /i "KMD.WorkZone.ServerScan.Setup.msi" DIRECTORYWATCHER="C:\ScannedDocs" SCHEMA="C:\Components\Schedules\" TRANSFORMATIONS="C:\Components\Transformations\" ERRORPATH="C:\Logs\Errors" OUTPUTPATH="C:\ProcessedDocs" CLIENTID="12345678-1234-1234-1234-123456789abc" TENANTID="87654321-4321-4321-4321-abcdef123456" CLIENTSECRET="EncryptedValue" REDIRECTURL="https://localhost" AUTHREQUESTURL="https://<domainname>/.default" ODATAURL="https://<domainname>/odata/v3" PROTOCOLANDHOST="https://<domainname>" LOGPATH="<log file path>\log.txt" /q

   

   Note: If a parameter value contains spaces, enclose parameter value in single quotes ' when you pass the command. For example: DIRECTORYWATCHER='"C:\testwzss\Scanned Documents\"'

5. Start the service with the following PowerShell command:

   Start-Service -Name "KMD WorkZone Directory Watcher Service"

Encrypt the secret

1. Go to the EncryptionHelper.ps1 file in the Deployment folder.

2. Open Windows PowerShell in administrative mode and run the command.

   .\EncryptionHelper.ps1 -encryptText "<Secret>"

3. Copy the Encrypted text and update the ClientSecret value.

Sample metadata XML templates

	Sample metadata file (XML file)
	English names (XSL file)

Danish names are no longer supported but you can use this file to map Danish names to English names:

Mapping of Danish names to English names (XML file)

Uninstall ServerScan Directory Watcher Service

1. Navigate to the location where you saved the original .MSI installation file.

2. Right-click the .MSI file and select Uninstall. This will start the uninstallation process.

If any error occur while uninstalling, follow these steps:

1. Open PowerShell as an Administrator.

2. Run these commands:

   • sc.exe stop "KMD WorkZone ServerScan Service"

   • sc.exe delete "KMD WorkZone ServerScan Service"

Confirm removal of the installation folder

When you have uninstalled the service, verify that the folder has been removed (C:\Program Files (x86)\KMD.WorkZone.ServerScan). If the folder still exists, you can delete it manually. Administrative rights may be required.