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 transaction | The transaction's status is set to its Complete or Part Complete status. |
| Deliver | Each 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 out | A timekeeping record is created on the server, then updated with the end time and note. |
| Save a photo | The image is added to the transaction. |
| Save a signature | The 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
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 |
- See the Timekeeping Module for the timekeeping settings.
Transaction Type Settings
Inventory movement transactions require Connected Mode.
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: Deliveries | Allows 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 Service | Can 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 |
|---|---|
| Paused | Displays all the active jobs that were paused. |
| Working | Displays all the active jobs. |
| Clocked | Displays 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
The actions displayed change based on the selected Filter.
| Field | Description |
|---|---|
| Pause | Pauses all the selected active jobs. (Displayed if Working (button) is greyed out.) |
| Stop | Stops all the selected active jobs. (Displayed if Working (button) is greyed out.) |
| Clock Out | Clocks out the selected users. (Displayed if Clocked (button) is greyed out.) |
| Resume | Resumes the selected pause jobs. (Displayed if Paused (button) is greyed out.) |
| Cancel | Cancels the paused jobs. (Displayed if Pause (button) is greyed out.) |
Button
Back: Returns to the login screen.
Start Screen
- Tile buttons for all the features enabled. For example:
- DN –Deliveries
- WO –Field Service
- DN – Timekeeping
- WO – Timekeeping
- 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.