Capabilities
Capabilities | Supported |
Connector Capabilities | |
Read | Yes |
Backfill | No |
Bidirectional Capabilities | |
Incident Create | No |
Incident Update | No |
Narrative Update | No |
Overview
The GovWorx Data Agent has the capabilities to browse a file share and pull CAD information located within XML files. Dispatch NOW can be configured to export XML files that hold the information needed for processing by the Data Agent. It is recommended to have CAD export the XML at the time the call is closed.
The Data Agent reads files changed in the last 2 hours, including files in subfolders.
XML Data Elements
The more data sent to GovWorx, the richer the experience will be. That said, sometimes certain CADs don't track data points, or other reasons to not get the data. View the CAD Data Element requirements and recommendations here.
Standard Data Fields
These are the standard data fields the Data Agent reads from Dispatch NOW XML files. The tables below show each GovWorx field and the source it comes from. The Data Agent reads the Response element under NewObjects. Source names are elements, or attributes where the name has an @, inside the Response element.
Note: Additional fields are considered enhancement requests.
Incident fields
GovWorx field | Dispatch NOW source | Notes |
Incident ID |
| |
Incident Number |
| |
Incident Type |
| |
Caller Number |
| |
Caller Name |
| |
Agency |
| |
Agency Type |
| |
Incident Date |
| |
Disposition |
| |
Location |
| |
Priority |
| |
Latitude |
| |
Longitude |
| |
Call Position |
| |
Call Taker ID |
| |
Call Taker Name |
| Joined as Last, First. |
Call Source |
| |
Call Received Time |
| The earliest CAD note timestamp setting replaces this with the earliest note time. |
Closed At |
|
Notes
GovWorx field | Dispatch NOW source | Notes |
Note Text |
| |
Note By |
| |
Note Time |
|
Responders and units
GovWorx field | Dispatch NOW source | Notes |
Unit Name |
| One responder for each distinct unit name. |
Dispatched By |
| From the activity with Status Dispatched. |
Dispatched At |
| From the activity with Status Dispatched. |
Enroute At |
| From the activity with Status Enroute. |
Arrived At |
| From the activity with Status On Scene. |
Cleared At |
| From the activity with Status Cleared. |
Personnel ID |
| From the activity with Status Cleared. |
Data Agent Settings
To prepare for this connection, we need the following details. These are settings in the GovWorx Data Agent configuration for this connector. A toggle is an on/off switch in that configuration.
Setting | Type | Explanation |
| Text | File location of the XML files created by CAD. Either a local path or a UNC share path. Recognized as a UNC path if it begins with two backslashes ("\\"). |
| Text | If file share requires separate credentials for access. GovWorx service account Username. Required for a UNC share path. |
| Password | If file share requires separate credentials for access. GovWorx service account Password. Required for a UNC share path. |
| Toggle | Optional: Toggle will enable the deletion of XML files after the data agent has processed the file. Recommended this setting be turned off till data integration is complete and verified. |
| Toggle | Toggle will use the earliest CAD note time as Call Received Time. Use it when the first note marks the start of the call better than the CAD pickup time. Call Pickup Time does not change. When no note has a time, Call Received Time stays as read from CAD. Default: off. This setting is on every CAD connector. |
*: Required