Schema zum Parsen von HL7v2-Nachrichten konfigurieren
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Auf dieser Seite erhalten Sie eine Übersicht darüber, wie und wann ein Schema in einem HL7v2-Speicher konfiguriert werden muss, um HL7v2-Nachrichten zu parsen.
Standardschema
Die Cloud Healthcare API verwendet ein Standardschema, um HL7v2-Nachrichten zu parsen. Dieses Schema entspricht dem HL7v2-Standard. Wenn Ihre HL7v2-Nachrichten dem Standard entsprechen und keine benutzerdefinierten Segmente, Felder oder anderen Daten enthalten, die vom Standard abweichen, lesen Sie den Hilfeartikel Schematisiertes Parsen für HL7v2-Nachrichten aktivieren.
Sie können Optionen für den Parser im Objekt ParserConfig angeben, unabhängig davon, ob Sie das Standardschema oder ein benutzerdefiniertes Schema verwenden. ParserConfig enthält ein ParserVersion-Objekt, mit dem Sie eine Version für den Parser angeben können. Weitere Informationen zu den einzelnen Versionen finden Sie in der Referenzdokumentation.
Wir empfehlen, für alle Anwendungsfälle die Version V3 des Parsers anzugeben. Die V3-Version bietet folgende Vorteile:
Sie enthält die Funktionen der V2-Version.
In Verbindung mit dem Standard-Parser werden die folgenden standardmäßig maskierten HL7v2-Steuerzeichen demaskiert:
Trennzeichen für Felder: |
Komponententrennzeichen: ^
Trennzeichen für Unterkomponenten: &
Wiederholungstrennzeichen: ~
Escape-Zeichen: \
Zeichen für Kürzung: #
Bei Verwendung mit einem benutzerdefinierten Parser verwendet der V3-Parser verbesserte Abgleichstechniken im Vergleich zu den anderen Parserversionen.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-09-03 (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."]]
