{"id":"incident-rms-connectors","slug":"incident-rms-connectors","title":"Records Management System Connectors: Tyler New World and Hexagon Integration","description":"The Records Management System (RMS) Connectors module exports closed incident data from the platform to external law enforcement and public safety records management systems, ensuring that incident records are synchronis","category":"data-integration","tags":["data-integration","compliance","geospatial"],"lastModified":"2026-04-14","source_ref":"content/modules/incident-rms-connectors.md","url":"/developers/incident-rms-connectors","htmlPath":"/developers/incident-rms-connectors","jsonPath":"/api/docs/modules/incident-rms-connectors","markdownPath":"/api/docs/modules/incident-rms-connectors?format=markdown","checksum":"1f4cb4c6a8a6b19294887a1f8d79ab527fcac6d6ba630fb59bc1a4973ad8cd1f","headings":[{"id":"overview","text":"Overview","level":2},{"id":"key-features","text":"Key Features","level":2},{"id":"use-cases","text":"Use Cases","level":2},{"id":"automated-incident-synchronisation","text":"Automated Incident Synchronisation","level":3},{"id":"niem-compliant-data-exchange","text":"NIEM-Compliant Data Exchange","level":3},{"id":"custom-agency-integration","text":"Custom Agency Integration","level":3},{"id":"pre-production-validation","text":"Pre-Production Validation","level":3},{"id":"post-transmission-audit","text":"Post-Transmission Audit","level":3},{"id":"how-it-works","text":"How It Works","level":2},{"id":"integration","text":"Integration","level":2},{"id":"supported-standards","text":"Supported Standards","level":2}],"markdown":"# Records Management System Connectors: Tyler New World and Hexagon Integration\n\n## Overview\n\nThe Records Management System (RMS) Connectors module exports closed incident data from the platform to external law enforcement and public safety records management systems, ensuring that incident records are synchronised with the agency's official RMS without manual re-entry. The module provides native connectors for Tyler Technologies New World and Hexagon (formerly Intergraph), the two most widely deployed public safety RMS platforms, alongside a generic REST connector for agencies with custom or proprietary systems. Data exports use the CAP 1.2 (Common Alerting Protocol) and NIEM 6.0 (National Information Exchange Model) standards to maximise interoperability with downstream systems.\n\n## Key Features\n\n- **Tyler New World Connector**: Authenticates via OAuth 2.0 client credentials, automatically refreshing access tokens, and posts incident data to the Tyler API with embedded CAP 1.2 XML for rich incident context. Falls back to a static bearer token if OAuth is not configured\n- **Hexagon RMS Connector**: Exports incidents in NIEM-JSON format to the Hexagon endpoint, supporting HTTP Basic, API key, or Bearer token authentication, matched to whatever method the agency's Hexagon deployment requires\n- **Generic REST Connector**: A configurable connector accepting any HTTPS endpoint with Bearer, Basic, or unauthenticated access modes, enabling integration with custom-built or regional RMS systems beyond the named providers\n- **CAP 1.2 Standard Export**: Tyler connector embeds a Common Alerting Protocol 1.2 body within the incident payload, validated against the OASIS XSD, enabling the receiving Tyler system to process the rich structured event data with no custom parsing required\n- **NIEM 6.0 JSON Export**: Hexagon connector sends incident data formatted to the National Information Exchange Model 6.0 JSON specification, including IncidentID, SourceSystem identifier, NIEMVersion (4.2), field mapping, and the full NIEM export body\n- **Tenant-Configured Field Mapping**: Both connectors support per-tenant field mapping so that platform incident fields can be aligned to the agency's RMS field names without changing the connector code\n- **Dry-Run Default**: All connectors operate in dry-run mode by default: the full export payload is constructed and logged exactly as it would be transmitted, but no HTTP request is sent. Live transmission requires explicit activation through the RMS_LIVE_PUSH environment flag, preventing accidental RMS writes in test environments\n- **Exponential Backoff Retry**: Failed transmissions are retried up to three times with delays of 0.5, 1, and 2 seconds, handling transient network issues without blocking the incident closure workflow\n- **Push Result Logging**: Every export attempt, including dry-run builds, is recorded with the constructed payload, HTTP result, and any error detail, giving integration administrators full visibility into transmission status\n\n## Use Cases\n\n### Automated Incident Synchronisation\nWhen an emergency dispatcher closes an incident in the platform, the RMS connector automatically exports the record to the agency's Tyler New World or Hexagon system. Incident data reaches the official records system within seconds of closure, eliminating the data entry backlog that accrues when personnel manually create RMS records at end of shift.\n\n### NIEM-Compliant Data Exchange\nAn agency participating in inter-agency data sharing under NIEM standards uses the Hexagon connector to export incidents in NIEM 6.0 JSON format, enabling automatic ingestion by partner agencies' systems and meeting federal reporting compliance requirements.\n\n### Custom Agency Integration\nAn agency running a bespoke records management system uses the generic REST connector. They configure the endpoint URL, select Basic authentication, and define a field mapping that aligns the platform's incident schema to their system's expected payload structure, no custom development required.\n\n### Pre-Production Validation\nBefore enabling live RMS transmission, the integration team uses dry-run mode to inspect the exact payload that would be sent for real incidents. They validate field mapping, confirm CAP or NIEM formatting, and verify authentication headers, all without risking any data appearing in the production RMS.\n\n### Post-Transmission Audit\nAn agency administrator queries the push result log to confirm that all incidents closed during a specific shift were successfully transmitted to the RMS, identify any that failed, and view the exact error returned by the RMS system for failed attempts.\n\n## How It Works\n\n```mermaid\nflowchart TD\n    A[Incident Closed] --> B{RMS_LIVE_PUSH enabled?}\n    B -->|No| C[Dry-Run: Build payload + log\\nNo HTTP request sent]\n    B -->|Yes| D{Connector type?}\n\n    D -->|Tyler| E[Fetch OAuth2 token\\nclient credentials flow]\n    E --> F[Build incident payload\\nwith CAP 1.2 XML embedded]\n    F --> G[POST to Tyler API]\n\n    D -->|Hexagon| H[Build NIEM 6.0 JSON payload]\n    H --> I[POST to Hexagon endpoint\\nBasic / API Key / Bearer]\n\n    D -->|Generic REST| J[Build configured payload]\n    J --> K[POST to custom endpoint\\nconfigured auth mode]\n\n    G --> L{Success?}\n    I --> L\n    K --> L\n\n    L -->|Yes| M[Record PushResult: OK]\n    L -->|No, attempt < 3| N[Exponential backoff retry]\n    N --> G\n    L -->|No, 3 failures| O[Record PushResult: error detail]\n```\n\n## Integration\n\nRMS Connectors are invoked by the Incident Management module on incident state transitions that trigger an export event (typically incident closure or a specific status change defined by the tenant). Connector configuration, endpoint URL, authentication credentials, field mapping, and active connector type, is managed per organisation through the administration console and stored in the tenant configuration record. The push result is recorded on the incident record and visible in the incident detail view, allowing dispatchers and supervisors to see RMS transmission status alongside the incident timeline.\n\n## Supported Standards\n\n- **CAP 1.2**: OASIS Common Alerting Protocol, validated against XSD schema\n- **NIEM 6.0 JSON**: National Information Exchange Model, structural validation included\n- **NIEM 4.2 version identifier**: Used in Hexagon payloads for downstream system compatibility\n\n**Last Reviewed:** 2026-04-14\n**Last Updated:** 2026-04-14\n"}