Configura uno schema per analizzare i messaggi HL7v2
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa pagina fornisce una panoramica di come e quando configurare uno schema in un archivio HL7v2 per analizzare i messaggi HL7v2.
Schema predefinito
L'API Cloud Healthcare utilizza uno schema predefinito per analizzare i messaggi HL7v2 conformi allo standard HL7v2. Se i tuoi messaggi HL7v2 sono conformi allo standard e
non contengono segmenti, campi o altri dati personalizzati che si discostano
dallo standard, consulta Attivare l'analisi schematizzata per i messaggi HL7v2.
Puoi specificare le opzioni per l'analizzatore nell'oggetto ParserConfig, indipendentemente dall'utilizzo dello schema predefinito o di uno schema personalizzato. ParserConfig contiene un
ParserVersion
oggetto che consente di specificare una versione per l'analizzatore. Per informazioni dettagliate su ogni versione, consulta la documentazione di riferimento.
Per tutti i casi d'uso, ti consigliamo di specificare la versione
V3
del parser. La versione V3 presenta i seguenti vantaggi:
Contiene le funzionalità esistenti nella versione V2.
Se utilizzato con il parser predefinito, rimuove gli escape dai seguenti caratteri di controllo HL7v2 con escape predefiniti:
Separatore di campo: |
Separatore dei componenti: ^
Separatore dei sottocomponenti: &
Separatore di ripetizione: ~
Carattere di escape: \
Carattere di troncamento: #
Se utilizzato con un parser personalizzato, il parser V3 utilizza tecniche di corrispondenza migliorate rispetto alle altre versioni del parser.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-05 UTC."],[[["\u003cp\u003eThis page guides users on configuring schemas for HL7v2 stores to parse HL7v2 messages effectively.\u003c/p\u003e\n"],["\u003cp\u003eThe Cloud Healthcare API uses a default schema for parsing standard HL7v2 messages, with a specific guide available for this use case.\u003c/p\u003e\n"],["\u003cp\u003eCustom schemas are necessary for HL7v2 messages that do not adhere to the standard, and a separate guide is available for these.\u003c/p\u003e\n"],["\u003cp\u003eRegardless of the schema used, the \u003ccode\u003eParserConfig\u003c/code\u003e object allows specifying a \u003ccode\u003eParserVersion\u003c/code\u003e, with \u003ccode\u003eV3\u003c/code\u003e recommended for its enhanced functionality, including unescaping default HL7v2 control characters and improved matching with custom parsers.\u003c/p\u003e\n"]]],[],null,["# Configure a schema to parse HL7v2 messages\n\nThis page provides an overview on how and when to configure a schema on\nan HL7v2 store to parse HL7v2 messages.\n\nDefault schema\n--------------\n\nThe Cloud Healthcare API uses a default schema to parse HL7v2 messages that conform\nto the HL7v2 standard. If your HL7v2 messages conform to the standard, and\ndo not contain custom segments, fields, or any other data that deviates from\nthe standard, see [Enable schematized parsing for HL7v2 messages](/healthcare-api/docs/how-tos/hl7v2-default-parser).\n\nCustom schema\n-------------\n\nIf you have HL7v2 messages that don't conform to the HL7v2 standard, see\n[Use a custom schema to parse HL7v2 messages](/healthcare-api/docs/how-tos/hl7v2-custom-parser).\n\nSelect a parser version\n-----------------------\n\nYou can specify options for the parser in the [`ParserConfig`](/healthcare-api/docs/reference/rest/v1/projects.locations.datasets.hl7V2Stores#ParserConfig) object, regardless of whether you're using the\ndefault schema or a custom schema. The `ParserConfig` contains a\n[`ParserVersion`](/healthcare-api/docs/reference/rest/v1/projects.locations.datasets.hl7V2Stores#ParserVersion)\nobject that lets you specify a version for the parser. See the [reference documentation](/healthcare-api/docs/reference/rest/v1/projects.locations.datasets.hl7V2Stores#ParserVersion.ENUM_VALUES) for details on each version.\n\nWe recommend that, for all use cases, you specify the\n[`V3`](/healthcare-api/docs/reference/rest/v1/projects.locations.datasets.hl7V2Stores#ParserVersion.ENUM_VALUES.V3)\nversion of the parser. The `V3` version has the following advantages:\n\n- It contains the existing functionality in the `V2` version.\n- When used with the default parser, it unescapes the following default escaped\n HL7v2 control characters:\n\n - Field separator: `|`\n - Component separator: `^`\n - Sub-component separator: `&`\n - Repetition separator: `~`\n - Escape character: `\\`\n - Truncation character: `#`\n- When used with a custom parser, the `V3` parser uses improved matching\n techniques over the other parser versions."]]
