Skip to main content

Upgrade to the Sense Clock Transaction Service version 4 (Legacy Anviz Setup)

Migrate from the legacy ClockTransactionsTransmitter to the Sense Clock Transaction Service version 4

Who this guide is for:

This guide is for customers who:

  • Already have Anviz clocks installed

  • Are currently using the ClockTransactionsTransmitter (legacy app)

  • Need to upgrade to the new Sense Clock Transaction Service 4.0

Platform: Anviz clocks and Sense HR

🖊️ Note:

This article is for legacy upgrades only.

For new installations, use the standard setup guide


Overview

What this upgrade does

The Sense Clock Transaction Service version 4 replaces the legacy service and provides:

  • Improved reliability

  • Enhanced automation between Sense HR and your clock devices

  • Built-in diagnostics

  • Better visibility of clocks, employees, and clock records

  • Simplified device management and troubleshooting

  • Easier application updates


What’s new in the Sense Clock Transaction Service

Status tab

Use the Status tab to:

  • Start, stop or restart the service

  • Confirm the service is Running

  • Check the connection to IoT Hub

  • See the last publish and any recent publishing errors

  • View pending retries for records and employee syncs

  • Check for application updates

Sense Clock Transaction Service Status tab showing the service running, IoT Hub connected, publishing information, pending retries and Check for updates button.

Devices tab

Use the Devices tab to:

  • View your Anviz clocks

  • Check whether each clock is connected

  • Add additional clocks after initial setup

Devices tab showing Anviz clock IP addresses, device IDs, connection indicators and the Add Clock button.

Records tab

Use the Records tab to view clock events received by the Sense Clock Transaction Service.

You can:

  • Search records

  • Select a date range

  • Filter by device

  • View the employee ID, employee name and clock event time

  • Export records to CSV

Records tab showing clock records with device ID, employee ID, employee name and time, with search, device filter, date filters and Export CSV.

Employees tab

Use the Employees tab to:

  • View employees on your connected clocks

  • Filter employees by device

  • Search for employees

  • Confirm employee IDs

  • Check registered card, fingerprint and face information


Settings tab

Use the Settings tab to:

  • Configure the service port, username and password

  • Import the .bootargs file

  • Enable automatic employee update syncing between clocks


Sync tab

Use the Sync tab to reconcile employees across connected clocks.

When you run Sync Clocks, an employee who exists on at least one connected clock is added to the other connected clocks, together with their fingerprint and face templates where applicable.

This operation is additive — employees are not deleted.


Diagnostics tab

Use Diagnostics to check whether the Sense Clock Transaction Service has everything it needs to communicate successfully.

The diagnostic checks include:

  • Configuration

  • Certificate

  • Internet connection

  • DNS resolution

  • Port 8883 (MQTTS)

  • TLS handshake

  • Windows service

  • IoT Hub connection

  • Clock connections

Click Run diagnostics to perform the checks.

You can also use Copy report to copy the diagnostic results if you need to share them with your IT team or Sense Support.

Diagnostics tab showing successful checks for configuration, certificate, internet, DNS, port 8883, TLS handshake, Windows service, IoT Hub and connected clocks.


Changes to Employee Sync Behaviour

The Sense Clock Transaction Service version 4 introduces improved and more automated syncing between Sense HR and your clocks.


New employees are added automatically

When a new employee is created in Sense HR:

  • They are automatically sent to all connected clocks

  • A Time & Attendance ID is assigned and stored

No manual setup is required to create the employee on the clock.


Missing employees can be re-synced

If an employee is not visible on a clock:

  1. Go to Sense HR Dashboard > People

  2. Open the employee profile

  3. Click More actions (...)

  4. Select Anviz sync

The employee will be sent to all connected clocks.


Leavers are removed automatically

When an employee is marked as a leaver:

  • They are automatically removed from all clocks

  • This happens after their leaving date

No manual action required.


Optional: Sync updates across clocks

If Sync employee updates to all clocks is enabled under Sense Clock Transaction Service > Settings, updates made on one clock can automatically sync to the other connected clocks, including:

  • Name

  • Card

  • Fingerprint templates

  • Face templates

💡 Note: Biometric data is not stored in Sense HR.

When syncing across devices, only a secure biometric template (a mathematical representation of the fingerprint or face) is used — not the original image or scan.


Before vs After: What’s Changed

Feature

Legacy (ClockTransactionsTransmitter)

New (Sense Clock Transaction Service)

New employees

Manually managed or limited automation

Automatically sent to all clocks from Sense HR

Employee updates

Not synced after initial creation

Can be synced across clocks (optional setting)

Missing employees

Required manual troubleshooting

Can be re-synced using Anviz sync in Sense HR

Leavers

Remained on clocks unless manually removed

Automatically removed after leaving date

Device management

Configuration file based

Connected clocks visible and additional clocks can be added through Devices

Clock records

Limited visibility

Search, filter and export records through Records

System visibility

Limited insight into issues

Status, publishing, retries and connection information available in the application

Troubleshooting

Reactive and manual

Built-in Diagnostics

Multi-clock environments

No automatic sync between devices

Automatic update sync plus manual clock reconciliation


Upgrade from Legacy App

Before you begin, ensure you have:

  • A Windows device running Windows 11
    • Ensure the Windows device running the service is powered on

  • Administrator access to the:
    • Windows device
    • Sense HR
    • Anviz clock devices

  • Downloaded and installed .NET 10.0 (Linux, macOS, and Windows) | .NET
    👉 Download .NET 10 Runtime for Windows

  • The latest Sense Clock Transaction Service version 4 installer | Sense Workplace
    👉 Download Clock Transaction Service V4.2


Step 1: (Optional) Back up your existing configuration

Before making any changes, create a backup of your current setup.

  1. Navigate to:
    C:\Program Files (x86)\ClocksTransactionsTransmitter

  2. Copy the entire folder to a safe location (e.g. Desktop or Documents)

  3. Rename:
    Example: ClocksTransactionsTransmitter_BACKUP

🖊️ Note:

The backup is for reference only and is not used by the system.

Do not run applications or edit files from the backup location.


Step 2: Close the old application

Close ClockTransactionsTransmitter if it is running


Step 3: Install the new application

  • Run the Sense Clock Transaction Service installer as administrator

  • Follow the installation prompts

This installs the new service in a separate location and does not overwrite your existing setup


Step 4: Confirm or create the data directory

Check that the following folder exists:

C:\ProgramData\ClockTransactionsService

If it does not exist:

  • Create it manually

💡 Note:

ProgramData is a hidden system folder on your C drive (this is different from Program Files).

If you cannot see it:

  1. Open File Explorer

  2. Click View

  3. Enable Hidden items

You can then navigate to:

C:\ProgramData\ClockTransactionsService


Step 5: Copy existing configuration files

From:

C:\Program Files (x86)\ClocksTransactionsTransmitter

Copy the following files:

  • .bootargs file

  • Records.csv

  • Settings.csv

  • clockip.txt

Paste files into:

C:\ProgramData\ClockTransactionsService

This preserves the existing configuration and clock information during migration.


Step 6: Open the new Sense Clock Transaction Service

Navigate to:

C:\Program Files (x86)\ClockTransactionsService

Run:

ClockTransactionsSettings.exe

Right-click → Run as Administrator

This application is used to configure and start the service


Step 7: Configure connection settings

  1. Open the Settings tab in the Sense Clock Transaction Service

  2. Confirm or enter the following:
    • Service Port

    • Username

    • Password

    • Bootargs file

If a bootargs file is not shown, click Import bootargs… and select the .bootargs file provided by Sense.

Optional (Recommended): Enable user updates across clocks

If you have multiple Anviz clock devices, you can enable automatic syncing of user updates.

  • Select Sync employee updates to all clocks
    This setting is OFF by default.

Settings tab showing Service Port, Username, Password, Sync employee updates to all clocks and Import bootargs button.

When enabled:

Updates made on one clock will automatically sync to all connected clocks every 5–10 minutes, including:

  • Name

  • Card

  • Fingerprint templates

  • Face templates

Click Save.


Step 8: Start the service

  1. Open Status tab

  2. Click Start

  3. Confirm the service shows Running

✅ Expected: Running


Step 9: Verify connection

  1. Open Devices tab

  2. Confirm clocks show as Connected


Step 10: Check connection diagnostics

  1. Open Diagnostics tab

  2. Click Run diagnostics

  3. Review the results

The summary shows how many checks passed, produced warnings, or failed.

Resolve any failed checks before continuing.


Step 11: Confirm employees

Open Employees and confirm employee records are listed for your connected clocks.


Step 12: Test clocking

  1. Ask an employee to clock in

  2. Wait 1–2 minutes

  3. Open Records and confirm the clock event has been received

  4. Confirm the event appears in Sense HR

✅ You have now successfully migrated to the Sense Clock Transactions Service.

✅ Your existing configuration, employees, and clock connections are preserved.


Updating the Sense Clock Transaction Service

You can check for available updates directly from the Status tab.

Click Check for updates to check whether an update is available.


Important: Restart After Changes

If you:

  • Make updates under the Sense Clock Transaction Service > Settings tab

  • Edit clockip.txt

You must restart the service:

  1. Go to Status tab

  2. Click Restart

  3. Confirm status = Running


Troubleshooting

For troubleshooting guidance, see:
Troubleshooting Anviz Clocks with Sense HR


When to Contact Your IT Team

Contact your IT team if:

  • Devices cannot be reached

  • Firewall or network restrictions are suspected

  • IP configuration needs updating


When to Contact Sense Support

Contact support if:

  • Devices are connected but no data is syncing

  • Errors appear in the Diagnostics

  • Issues persist after completing all steps

Did this answer your question?