{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":19503,"path":"healthcare-life-sciences/hl7-installed-components.md","title":"Components installed with HL7 v2.x Integration","bundle":null,"doc_type":null,"release":"australia","body":"\n# Components installed with HL7 v2.x Integration\n\nSeveral types of components are installed with activation of the HL7 v2.x Native Integration plugin, including tables, user roles, and Flow Designer actions.\n\n## Roles installed\n\n<table><thead><tr><th>\n\nRole title \\[name\\]\n\n</th><th>\n\nDescription\n\n</th><th>\n\nContains roles\n\n</th></tr></thead><tbody><tr><td>\n\nHL7 Integration Administrator\n\n \\[`sn_hl7_v2.admin`\\]\n\n</td><td>\n\nManages HL7 integration configuration, including parser configurations and message log access. Required for all administrative tasks in the HL7 integration application.\n\n</td><td>\n\nNone\n\n</td></tr></tbody>\n</table>## Tables installed\n\n<table><thead><tr><th>\n\nTable\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nHL7 Message Log\n\n \\[`sn_hl7_v2_message_log`\\]\n\n</td><td>\n\nStores every inbound HL7 v2.x message received by ServiceNow, including the raw payload, ACK response, extracted MSH metadata fields, and processing status. The `raw_payload` field is protected by a column-level ACL.\n\n</td></tr><tr><td>\n\nHL7 Parser Configuration\n\n \\[`sn_hl7_v2_parser_config`\\]\n\n</td><td>\n\nDefines parser configurations that map HL7 message types and sending system identities to segment and field extraction rules. Extends `sys_metadata`.\n\n</td></tr><tr><td>\n\nHL7 Parser Segment\n\n \\[`sn_hl7_v2_parser_segment`\\]\n\n</td><td>\n\nDefines individual HL7 segments \\(for example, PV1, PID\\) within a parser configuration, including the segment code and human-readable label. Extends `sys_metadata`.\n\n</td></tr><tr><td>\n\nHL7 Parser Field Map\n\n \\[`sn_hl7_v2_parser_field_map`\\]\n\n</td><td>\n\nMaps an HL7 field position within a parser segment to a dotted output path \\(`field_name`\\) in the message log's `parsed_data`, with an optional human-readable label. Supports field and component extraction. Extends `sys_metadata`.\n\n</td></tr></tbody>\n</table>## UI actions installed\n\nThe application installs two UI actions on the parser configuration form. **Parse Sample Payload** parses the configuration's sample payload and populates the parsed value on each field map. **Clone** deep-copies a configuration and its segments and field maps to a new, inactive configuration.\n\n## Demo parser configurations installed\n\nThe following parser configurations are installed only when you select **Load demo data** during installation. They are editable examples, not read-only records.\n\n|Configuration|Description|\n|-------------|-----------|\n|HL7 v2.8 ADT^A01 — Admit|Demo parser configuration for ADT^A01 \\(patient admit\\) messages. Covers the EVN, PID, and PV1 segments.|\n|HL7 v2.8 ADT^A02 — Transfer|Demo parser configuration for ADT^A02 \\(patient transfer\\) messages. Covers the EVN, PID, and PV1 segments.|\n|HL7 v2.8 ADT^A03 — Discharge|Demo parser configuration for ADT^A03 \\(patient discharge\\) messages. Covers the EVN, PID, and PV1 segments.|\n|HL7 v2.8 ADT^A08 — Update|Demo parser configuration for ADT^A08 \\(patient information update\\) messages. Covers the EVN, PID, and PV1 segments.|\n\n"}}