User Synchronization

Laserfiche Forms offers a variety of options to update the users who can access Forms. When you configure Laserfiche Forms, you have the option to import users from the Laserfiche Server, Microsoft Entra ID, or Laserfiche Directory Server services. As changes are made to your users in Laserfiche or Microsoft Entra ID, Laserfiche Forms will be updated according to the synchronization method you've configured.

We recommend configuring a synchronization schedule so Forms is automatically updated without any manual oversight. You may want to schedule the synchronization during off hours as it can be resource intensive.

Synchronize users on a schedule

There are two options or configuring a synchronization schedule. The second option allows for more precise scheduling using Windows Task Scheduler.

• Configure the synchronization interval in the Forms Server tab of the Forms Configuration page.
• Configure the User Sync Client to synchronize users on a specific schedule.
  1. Go to the Control Panel -> Administrative Tools -> Task Scheduler.
  2. In the Task Scheduler, select Action from the main menu, and select Create Basic Task.
  3. Use the Task Scheduler to give your task a name and specify how often it will run.
  4. On the Action page, select Start a program, and click Next.
  5. Browse to the UserSyncClient.exe application located in the "<Installation folder>\Forms\bin" folder.
  6. Optional: Insert "-q" next to Add arguments to run the User Sync Client in the background. The status update interval can be altered by adding the argument -t xxx, where xxx is a number of milliseconds between 0 and 2147483647. The default polling interval is 5000 milliseconds.
  7. Next to Start in, type the directory where the User Sync Client is located. E.g., Do not include quotation marks or a trailing slash.
  8. Click Next, and then Finish.

Manually synchronize users

• Click the Synchronize users button on the System Security page.
• Double-click the UserSyncClient.exe application located in the <Installation folder>\Forms\bin folder. Once the synchronization has finished, press ENTER to exit the console.

Note: Do not copy this application to another location as it relies on dll files in this location.

• Optional: Add the argument "-q" to launch the application in the background. Add the argument "-t xxxx" to change the status update interval (where xxx is a number of milliseconds between 0 and 2147483647). The easiest way to add an argument to the application is run the application from a command prompt. Show me how.
1. Go to the Start menu on the machine where Forms was installed.
2. In the Search text box, type cmd.
3. In the Command Prompt window type: Start "" "<Installation folder>\Forms\bin\UserSyncClient.exe" replacing <Installation folder> with the actual path for the User Sync Client. E.g., C:\Program Files\Laserfiche\Laserfiche Forms
4. After the last quotation marks, type a space and then the argument you want to use. E.g., Start "" "C:\Program Files\Laserfiche\Laserfiche Forms\Forms\bin\UserSyncClient.exe" -q



5. Press ENTER to run the User Sync Client.