Capabilities
Capabilities | 365Labs (Service Bus) | 365Labs API |
Connector Capabilities | ||
Read | Yes | Yes |
Backfill | No | No |
Bidirectional Capabilities | ||
Incident Create | No | No |
Incident Update | No | No |
Narrative Update | No | No |
Overview
API
The Data Agent reads data using the CAD365Labs API.
Each run asks the API for incidents from one day before to one day after the current date. The Data Agent keeps closed incidents only.
Service Bus
The Data Agent reads data from a 365Labs Azure Service Bus topic.
The Data Agent reads Call Closure messages. It skips other message types.
Standard Data Fields
These are the standard data fields the Data Agent reads from 365Labs. The tables below show each GovWorx field and the 365Labs source it comes from. Source names are JSON fields of the incident.
Note: Additional fields are considered enhancement requests.
API: Incident fields
GovWorx field | 365Labs API source | Notes |
Incident ID |
| CAD record key. |
Incident Number |
| |
Incident Type |
| |
Incident Date |
| Includes the time offset settings. |
Closed At |
| Includes the time offset settings. The Data Agent reads closed incidents only. |
Priority |
| High, Medium and Low are normalized. Other values pass through unchanged. |
Caller Name |
| |
Caller Number |
| Uses the phoneNumber of the first entry in calls when the incident has none. |
Call Taker ID |
| The first call. Uses createdBy when takenBy is empty. |
Call Taker Name |
| The first call. Uses createdBy when takenBy is empty. |
Call Received Time |
| The first call. Uses startedAt when the incident has no calls. The earliest CAD note timestamp setting replaces this with the earliest note time. |
Agency |
| The agency of the first unit. |
Location |
| Joined with spaces. The apartment number is written as Apt followed by the number. |
Latitude |
| Needs both latitude and longitude. |
Longitude |
| Needs both latitude and longitude. |
Disposition |
| The first disposition. |
API: Notes
GovWorx field | 365Labs API source | Notes |
Note Text |
| Each comment is plain text. The API sends no author or time, so Note By and Note Time stay empty. |
API: Responders and units
GovWorx field | 365Labs API source | Notes |
Unit Name |
| |
Dispatched By |
| The first official with a value. With the CreatedBy toggle on, uses createdBy when the unit has no official. |
Dispatched At |
| Includes the time offset settings. |
Enroute At |
| Includes the time offset settings. |
Arrived At |
| Includes the time offset settings. |
Cleared At |
| Includes the time offset settings. |
Service Bus: Incident fields
GovWorx field | 365Labs Service Bus source | Notes |
Incident ID |
| CAD record key. |
Incident Number |
| |
Incident Type |
| |
Incident Date |
| |
Closed At |
| |
Priority |
| High, Medium and Low are normalized. An empty value becomes Medium. |
Caller Name |
| |
Caller Number |
| |
Call Taker ID |
| Uses createdBy.name when the badge number is empty. |
Call Taker Name |
| |
Agency |
| The agency of the first unit. |
Location |
| Joined with a space. The apartment number is written as Apt followed by the number. |
Latitude |
| Read from the geolocation text, for example [longitude, latitude]. |
Longitude |
| Read from the geolocation text, for example [longitude, latitude]. |
Disposition |
| The first disposition. |
Service Bus: Notes
GovWorx field | 365Labs Service Bus source | Notes |
Note Text |
| |
Note By |
| Uses createdBy.badgeNumber when the name is empty. |
Note Time |
|
Service Bus: Responders and units
GovWorx field | 365Labs Service Bus source | Notes |
Unit Name |
| |
Dispatched By |
| The incident creator. Uses createdBy.name when the ID is empty. |
Dispatched At |
| |
Enroute At |
| |
Arrived At |
| |
Cleared At |
|
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.
API
*: Required
Setting | Type | Explanation |
| Text | Provided by 365Labs |
| Password | Provided by 365Labs |
| Text | Optional Value if Time sync is off from Cloud to Voice Logger |
| Text | Optional Value if Time sync is off from Cloud to Voice Logger |
| Toggle | Toggle will use the incident creator as Dispatched By when a unit has no official. Default is off. |
| 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. |
Service Bus
*: Required
Setting | Type | Explanation |
| Password | The connection string for the 365Labs Azure Service Bus. |
| Text | The name of the Service Bus topic to read. |
| Text | The name of the subscription on the topic. |
| Number | Default is 5. |
| Number | How long each run waits for messages. Default is 30 seconds. |
| Number | How many messages each run reads. Default is 15. |
| 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. |
