Skip to main content

CAD Data Elements

These are the Data fields required and recommended from CAD systems.

Written by Kevin Biegert

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. The base required fields are highlighted in red.

The EIDO field column shows where each field goes in a NENA EIDO 1.0.1 incident snapshot when using the GovWorx Connections Platform API.

Incident

Red rows indicate required base fields.

Field

Type

Notes

EIDO field

SysId

string

CAD System unique identifier for the incident (if applicable)

incidentComponent.internalIncidentId

IncidentNumber

string

Incident Number

Same element as SysId. Required.

incidentComponent.internalIncidentId

IncidentType

string

Incident Type / Problem Nature

The first value present is used.

incidentComponent.incidentTypeInternalText, incidentTypeCommonRegistryText, or incidentTypeInternalCode

Agency

string

Agency identifier

The agency $id or agencyJcard name.

agencyComponent from the call taker's agencyReference, or incidentComponent.updatedByAgencyReference

AgencyType

string

Agency type

agencyComponent.agencyType

Priority

string

Incident Priority

incidentComponent.incidentPriorityInternalText, or incidentCommonPriorityNumber

IncidentDate

date

Date/Time Incident Created

The earliest call on the incident.

callComponent.callStartTimestamp

Disposition

string

Disposition of Incident

incidentComponent.dispositionComponent.dispositionCommonRegistryCode

Location

string

Address / Location of Incident

Source facts location keeps a full address string as sent.

locationComponent.locationByValue (PIDF-LO civic address), or locationDescriptionText

Latitude

string

locationComponent.locationByValue (gml:Point pos)

Longitude

string

locationComponent.locationByValue (gml:Point pos)

ClosedAt

date

Date/Time Incident was closed

Only when incidentStatusCommonRegistryText includes closed.

incidentComponent.lastUpdateTimeStamp

CallerName

string

The primary caller's name

The person with role reportingParty. Full name, or given name and surname.

personComponent.ncPersonComponent.name

CallerNumber

string

The primary caller's phone number

From the reporting party's callBackReference, else the call's.

callbackComponent.callBackInformationUri (tel: value)

CallPosition

string

The position/workstation that the call taker who received the call was sitting in

On the call taker agent.

agentComponent.agentWorkstationPositionIdentification

CallTakerId

*CommsCoach Required

string

The personnel ID of the call taker. This field gets mapped in the user list Personnel ID to associate users to events.

The agent with agentRoleRegistryText callTaker. Source facts personnelId can carry the CAD personnel ID.

agentComponent.$id

CallTakerName

string

The call taker on the incident

On the call taker agent.

agentComponent.agentJcard (fn entry)

CallSource

string

Information about how the incident was initiated. Typically these is information such as Admin Line vs E911 vs Field Initiated

A standardPrimaryCallType of unknown is left out.

callComponent.localCallType, or standardPrimaryCallType

CallReceivedTime

* This can be the earliest timestamp to indicate the call taker has begun create a CAD incident

date

Data for matching call audio. Time the call was received.

The earliest call on the incident. Required.

callComponent.callStartTimestamp

CallPickupTime

* This can be the earliest timestamp to indicate the call taker has begun create a CAD incident

date

Data for matching call audio. Time the call was answered.

Same value as CallReceivedTime. Left empty when source facts pickupTimeSupplied is false for the call.

callComponent.callStartTimestamp

CallHangupTime

date

Time the call was ended.

Approximate.

callComponent.lastUpdateTimeStamp when callStateRegistryText is callEnd

Case ID

string

Case Report number if assigned

Values other than internalIncidentId.

incidentComponent.documentIdentification

RelatedSysId

string

Reference to a linked incident / parent incident

linkComponent.incidentTrackingIdentifier with linkDirectionCode PARENT or RELATED

ResponseArea

string

Jurisdiction, beat, ORI (among multiple), etc.

incidentComponent.beatOrDispatchGroupText

RadioChannel

string

EIDO 1.0 has no incident-level radio channel.

nc:ContactRadioType.channel in the contact information of a person or agency.

Incident Responders

Field

Type

Notes

EIDO field

PersonnelId

string

Agency identifier for the personnel associated with assigned units

From emergencyResourceComponent.agentReference. Source facts personnelId or personnelReferences can carry it.

agentComponent.$id

UnitName

string

Unit(s) assigned to incident with Primary Unit designation

From dispatchComponent.emergencyResourceReference. Source facts unitId can carry it.

emergencyResourceComponent.emergencyResourceName

DispatchedAt

date

Dispatch date/time

Else emergencyResourceComponent.lastUpdateTimeStamp when primaryUnitStatusRegistryText is DISPATCHED.

Source facts dispatchedAt on the dispatchComponent

DispatchedBy

* Required for matching Radio Traffic

string

PersonnelId of the dispatcher who dispatched the unit

dispatchComponent.agentReference

EnrouteAt

date

Enroute date/time

Else emergencyResourceComponent.lastUpdateTimeStamp when primaryUnitStatusRegistryText is RESPONDING or ENROUTE.

Source facts enrouteAt on the dispatchComponent

ArrivedAt

date

Arrived date/time

Else emergencyResourceComponent.lastUpdateTimeStamp when primaryUnitStatusRegistryText is ON-LOCATION or ARRIVED.

Source facts arrivedAt on the dispatchComponent

ClearedAt

date

Cleared date/time

Else emergencyResourceComponent.lastUpdateTimeStamp when primaryUnitStatusRegistryText is CLEARED.

Source facts clearedAt on the dispatchComponent

Incident Notes

Field

Type

Notes

EIDO field

NoteId

string

CAD System ID for the note

Source facts noteId keeps the CAD note ID as sent.

notesComponent.$id

Note

string

Body of the note

notesComponent.notesActionComments

NoteBy

string

Comment Entered by

Read the same way as CallTakerId.

notesComponent.agentReference

NoteAT

string

Note Timestamp

notesComponent.lastUpdateTimeStamp

Did this answer your question?