Tracker Reference

In BOS Enterprise, the Tracker app is a lightweight executable for Windows that runs as follows:

  • Dual Mode (Connected and Offline): The application runs on a Local Database which is populated from and then replicated to the Live Database when an internet connection exists. The Local Database is a metadata backup of the Live Database.
  • Connected Mode: Connects directly to the Live Database without an offline option.

Only the Field Service and Deliveries modules support Dual Mode.

The Tracker app manages deliveries, records timekeeping, records production quantities, and can be used as a lightweight clock-in and clock-out system.

Setting Up

  • Tracker.exe can be downloaded from Tools or the Shared Drive\Downloads\... folder.
  • For Dual Mode, a Data folder is needed that contains a metadata backup of the BOS Enterprise Database. The backup must be made from the Live Database after it is upgraded.
  • The Settings icon on the Login Screen opens a utility to create the TRACKER.INI based on the selected mode. The selected modes are Connected or Dual.
  • The Database Connection strings must be added to the TRACKER.INI file. The INI file must be formatted as follows:
    • [SERVERDB] path = server:localDBpath
    • [LOCALDB] path = server:localDBpath
  • For Connect Mode, the [LOCALDB] path = Live DB and the [SERVERDB] item is not required.

How Dual Mode Works

  • Tracker can run in Offline (red icon) or in Online (green icon) mode.
  • The Local Database is always updated in Online mode. The Server is also updated in real time.
  • If Tracker is Offline, updated records are flagged. When switched to Online mode, the Server is updated with all the flagged changes.
  • The Local Database starts out as a metadata-only copy of the Server Database which does not contain any data. Data is only downloaded when a user logs while online. The first login must be Online so that the user and transaction data can be downloaded to the local database.
  • The Local Database is a temporary database that only contains a subset of the data you are working on. This data is copied to the Server. When closing Tracker, you are warned if any records in the local database are not yet uploaded.

What Is Synchronised

Downloads

  • At login (Online): Your user details, the settings, the statuses and the latest document numbers, the first time you log in on the device. Refresh on the menu downloads them again.
  • Transactions: When you open a module with an empty list, or click Refresh on the list, the Active transactions assigned to you are downloaded with their items, customer or supplier and contact. Refresh replaces the list on the device.
  • Issue Inventory lists only reserved items, and Receive Inventory only ordered items, with their outstanding quantities.
  • Images: Refresh on the Images screen downloads the transaction's images.

Uploads

What you do in the app What changes on the server
Done or Part on a transactionThe transaction's status is set to its Complete or Part Complete status.
DeliverEach item is set to Complete, or Part Complete when less was delivered; the transaction status is set too.
Start and Stop (Field Service), Clock in and outA timekeeping record is created on the server, then updated with the end time and note.
Save a photoThe image is added to the transaction.
Save a signatureThe signed document is added to the transaction or timekeeping record.
  • When the server can be reached, each change is uploaded as soon as you save it.
  • Changes made offline are uploaded when you log in Online, click the Online/Offline button to go online, go Back to the menu, or log out.
  • The status bar shows "Uploading..." and then "<n> Record/s uploaded".
  • The status set in the app replaces the status on the server, even if it was changed there in the meantime.
  • Issue and Receive transactions, and the Timekeeping (Production Mode) module, work directly on the server: they need Connected mode.

Messages When Closing

  • "One or more records have not been uploaded to the Server. Continue to Exit the application?": changes are still waiting on the device. Go online first to upload them.
  • "There are one or more open Timekeeping records. Continue to Exit the application?": a timekeeping record is still running.

Settings

General Settings

Navigation Example

Main Menu > Setup > Settings > General (tab)

Note

The defaults are the values for new databases, new users and new Transaction Types. Your database may have different values.

Setting Description Default
Tracker > Enable Item Suggestions (select SM Class)Provides a dropdown list of all service manager classes to select one for production suggestions.Not set

Transaction Type Settings

Note

Inventory movement transactions require Connected Mode.

Navigation Example

Main Menu > Setup > Settings > Transactions (tab)

The following modules can be added to Transaction Types (e.g. Delivery Notes, Task Orders, Work Orders) to enable them:

Setting Description Default
Mobile/Tracker > Module: DeliveriesAllows customers to digitally sign for the goods.Unchecked
Mobile/Tracker > Module: Timekeeping (Production Mode)Lets you record the time it takes to complete a job.Unchecked
Tracker > Module: Field ServiceCan capture photos and obtain digital signatures to confirm timekeeping.Unchecked
Tracker > Module: Issue Goods (Select the Issue Transaction)Used to issue goods.Not set
Tracker > Module: Issue Inventory (Select the Issue Transaction)Used to issue inventory items.Not set
Tracker > Module: Receive Goods (Select the Receive Transaction)Used to receive goods.Not set
Tracker > Module: Receive Inventory (Select the Receive Transaction)Used to receive inventory items.Not set

Login Screen

  • Keypad: Used to type the login pin.
  • Login: Log in if their pin is entered.
    • When in Dual Mode, the green Login button connects to the Local and Remote Databases.
    • The red Login button connects only to the Local Database.
    • In Connected Mode, only the green Login button applies. You cannot log in if you are offline.
  • Manage: Navigates to a screen with these functions:
    • Pause / Resume multiple jobs
    • Stop multiple jobs
    • Clock out multiple users
  • Settings (Icon)
    • Mode: Select Connected or Dual – Connected and Offline.
    • Database: Fields to enter the database server and path depending on the selected mode.
    • Create TRACKER.INI file: Creates the Tracker.ini file.

Manage Screen

Filters Explained

Filter Description
PausedDisplays all the active jobs that were paused.
WorkingDisplays all the active jobs.
ClockedDisplays all the users who are clocked in.

Select

Fields are selected and unselected by clicking them, but the following two buttons can also be used:

  • Select: Selects unselected fields.
  • Unselect: Unselects selected fields.

Actions

Info

The actions displayed change based on the selected Filter.

Field Description
PausePauses all the selected active jobs. (Displayed if Working (button) is greyed out.)
StopStops all the selected active jobs. (Displayed if Working (button) is greyed out.)
Clock OutClocks out the selected users. (Displayed if Clocked (button) is greyed out.)
ResumeResumes the selected pause jobs. (Displayed if Paused (button) is greyed out.)
CancelCancels the paused jobs. (Displayed if Pause (button) is greyed out.)

Button

Back: Returns to the login screen.

Start Screen

  • Refresh: Updates data to and from the server.
  • Logout: Logs the user out of the Tracker app. A warning appears if one or more records are not uploaded to the Server.

Report an issue with this page

For more useful feedback, select the text on the page you're reporting about, then click Feedback again — or continue without selecting anything.