What syncs from Vantagepoint
FieldTime pulls the following data from Vantagepoint on every sync cycle:Firms
Client and vendor firm names, client indicators, vendor indicators, and statuses.
Organizations
Organization codes, names, and active/inactive statuses.
Employees
Employee roster including names, titles, divisions, employment type, and supervisor assignments.
Projects
Active projects with dates, project managers, client assignments, and project codes.
Project Phases (WBS2)
Phase-level work breakdown structure for each synced project that has sub-level enabled.
Project Tasks (WBS3)
Task-level work breakdown structure for each synced phase that has sub-level enabled.
Project PWDs
Prevailing wage determinations (PWDs) for each synced project, used to apply the correct labor classification rates.
Employee roles, supervisor assignments, and project manager assignments are controlled in Vantagepoint. Changes take effect after the next sync.
Sync frequency and scheduling
Each data type has its own configurable sync frequency. You can set any endpoint to sync as often as every hour or as infrequently as once a week. The available intervals are 1, 2, 3, 4, 6, 8, 12, 24, 48, 72, and 168 hours. When automatic sync is enabled, FieldTime’s scheduler triggers each endpoint according to its individual frequency setting. You do not need to do anything once automatic sync is configured — FieldTime picks up changes from Vantagepoint on the next scheduled run.Using the VP Sync Manager
The VP Sync Manager is the Admin panel section where you connect to Vantagepoint, configure sync schedules, and monitor sync history. Navigate to Admin → VP Sync to open it.Connecting to Vantagepoint
Before any syncs can run, you must provide your Vantagepoint API credentials:Enter your credentials
Fill in the following fields:
- Base URL — your Vantagepoint API root (e.g.,
https://your-vp-host/api/v1) - Username and Password — the Vantagepoint service account credentials
- Client ID and Client Secret — the OAuth client registered in Vantagepoint for FieldTime
- Integrated Database — the name of the Vantagepoint database to connect to
Configuring automatic sync
Once connected, scroll to the Sync Configuration section:- Check Automatic sync enabled to activate the scheduler.
- For each data type (Firms, Organizations, Employees, Projects, Phases, Tasks, Project PWDs), check the endpoint’s toggle to include it in automatic sync and choose a frequency from the dropdown.
- Optionally enable Email on sync failure and enter a notification email address to receive alerts if any sync run fails.
- Click Save Settings.
Running a manual sync
Each endpoint section in the VP Sync Manager includes two buttons:- Dry Run — fetches data from Vantagepoint and shows you exactly what would be created, updated, or skipped without writing anything to FieldTime. Use this to preview changes before committing.
- Sync Now — runs a full sync for that endpoint immediately, writing all changes to FieldTime.
Monitoring sync history
The Recent Runs table at the bottom of the VP Sync Manager shows the last 20 sync runs across all endpoints. Each row displays:| Column | Description |
|---|---|
| Started | Date and time the run began |
| Type | Which endpoint and whether it was automatic, manual, or a dry run |
| Status | completed, partial, running, or failed |
| Fetched | Records retrieved from Vantagepoint |
| Created | New records written to FieldTime |
| Updated | Existing records updated in FieldTime |
| Skipped | Rows ignored (e.g., already up-to-date) |
| Errors | Records that could not be processed |
