Auf dieser Seite wird erläutert, wie Sie HL7v2-Nachrichten aufnehmen, erstellen, mit Labels versehen, auflisten, ansehen und löschen. HL7v2-Nachrichten werden für die Übertragung von klinischen Daten zwischen Systemen genutzt. Eine HL7v2-Nachricht kann Informationen zu einem Beobachtungsergebnis, ein an eine Apotheke gesendetes Rezept, eine Finanztransaktion oder andere klinikrelevante Ereignisse enthalten.
Übersicht über das Erstellen und Aufnehmen von HL7v2-Nachrichten
Sie können eine HL7v2-Nachricht mit einer der folgenden Methoden in der Cloud Healthcare API speichern:
Wenn Sie messages.ingest
verwenden, generiert die Methode eine Antwort mit einer der folgenden Optionen:
- Einer HL7v2-Bestätigungsnachricht (
ACK
) bei Erfolg - Einer negative Bestätigungsnachricht (
NACK
), wenn ein Fehler auftritt
Die Nachrichten ACK
und NACK
werden für Antworten an HL7v2-Schnittstellensysteme verwendet, die diese Bestätigungen erwarten.
Nachrichtenaufnahme und -erstellung mit einem MLLP-Adapter
HL7v2-Nachrichten werden zwischen Pflegesystemen und der Cloud Healthcare API über das MLLP (Minimal Layer Protocol) übermittelt. Weitere Informationen finden Sie unter MLLP und Google Cloud Platform MLLP-Adapter. Eine Anleitung zum Konfigurieren eines MLLP-Adapters für die sichere Kommunikation mit der Cloud Healthcare API finden Sie unter HL7v2-Nachrichten über TCP/IP-Verbindungen übertragen.
HL7v2-Nachrichten aufnehmen
Nachdem die Cloud Healthcare API die Nachricht aus einem Caret-System aufgenommen hat, generiert die Cloud Healthcare API eine Antwort, die ein hl7ack
-Feld mit einer base64-codierten HL7v2-Nachricht mit den folgenden Eigenschaften enthält:
- Der Nachrichtentyp ist
ACK
. - Die sendende und die empfangende Einrichtung werden getauscht und die sendende Anwendung und die empfangende Anwendung werden getauscht.
- Die Sendezeit der Nachricht ist die aktuelle Zeit und es wird eine neue Steuerungs-ID generiert.
- Der Wert des Felds
MSH-9.1
definiert den Nachrichtentyp. - Der Wert des
MSA.1
-Felds definiert einen Antworttyp. Der AntworttypAA
gibtApplication Accept
an, was bedeutet, dass die Nachricht validiert und erfolgreich aufgenommen wurde. - Der
MSA.2
-Wert enthält die Kontroll-ID der ursprünglichen Nachricht.
Die folgenden Beispiele zeigen, wie eine HL7v2-Nachricht mit der Methode projects.locations.datasets.hl7V2Stores.messages.ingest
aufgenommen wird.
curl
Wenn Sie eine HL7v2-Nachricht aufnehmen möchten, senden Sie eine POST
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Der Name des HL7v2-Speichers
- Ein
Message
Das folgende Beispiel zeigt eine POST
-Anfrage mit curl
und einer JSON-Beispieldatei mit dem Namen hl7v2-sample.json
.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data-binary @hl7v2-sample.json \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages:ingest"
Die folgende Beispielantwort zeigt die hl7Ack
- und Nachrichtendetails.
{ "hl7Ack": "TVNIfF5+XCZ8QXxBfEF8U0VORF9GQUNJTElUWXwyMDIwMDIxNDIxMjAwNXx8QUNLfDFmMmQ1MjQzLTFhOWEtNGE4My05ZmI5LWNlNTIzMTVmZjk2M3xUfDAuMA1NU0F8QUF8MjAxODAxMDEwMDAwMDA=", "message": { "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID", "data": "TVNIfF5+XCZ8QXxTRU5EX0ZBQ0lMSVRZfEF8QXwyMDE4MDEwMTAwMDAwMHx8VFlQRV5BfDIwMTgwMTAxMDAwMDAwfFR8MC4wfHx8QUF8fDAwfEFTQ0lJDUVWTnxBMDB8MjAxODAxMDEwNDAwMDANUElEfHwxNAExMTFeXl5eTVJOfDExMTExMTExXl5eXk1STn4xMTExMTExMTExXl5eXk9SR05NQlI=", "sendFacility": "SEND_FACILITY", "sendTime": "2018-01-01T00:00:00Z", "messageType": "TYPE", "createTime": "CREATE_TIME", "patientIds": [ { "value": "14\u0001111", "type": "MRN" }, { "value": "11111111", "type": "MRN" }, { "value": "1111111111", "type": "ORGNMBR" } ] } }
PowerShell
Wenn Sie eine HL7v2-Nachricht aufnehmen möchten, senden Sie eine POST
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Der Name des HL7v2-Speichers
- Ein
Message
Das folgende Beispiel zeigt eine POST
-Anfrage mit PowerShell und eine JSON-Beispieldatei namens hl7v2-sample.json
.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Post ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -InFile hl7v2-sample.json ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages:ingest" | Select-Object -Expand Content
Die folgende Beispielantwort zeigt die hl7Ack
- und Nachrichtendetails.
{ "hl7Ack": "TVNIfF5+XCZ8QXxBfEF8U0VORF9GQUNJTElUWXwyMDIwMDIxNDIxMjAwNXx8QUNLfDFmMmQ1MjQzLTFhOWEtNGE4My05ZmI5LWNlNTIzMTVmZjk2M3xUfDAuMA1NU0F8QUF8MjAxODAxMDEwMDAwMDA=", "message": { "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID", "data": "TVNIfF5+XCZ8QXxTRU5EX0ZBQ0lMSVRZfEF8QXwyMDE4MDEwMTAwMDAwMHx8VFlQRV5BfDIwMTgwMTAxMDAwMDAwfFR8MC4wfHx8QUF8fDAwfEFTQ0lJDUVWTnxBMDB8MjAxODAxMDEwNDAwMDANUElEfHwxNAExMTFeXl5eTVJOfDExMTExMTExXl5eXk1STn4xMTExMTExMTExXl5eXk9SR05NQlI=", "sendFacility": "SEND_FACILITY", "sendTime": "2018-01-01T00:00:00Z", "messageType": "TYPE", "createTime": "CREATE_TIME", "patientIds": [ { "value": "14\u0001111", "type": "MRN" }, { "value": "11111111", "type": "MRN" }, { "value": "1111111111", "type": "ORGNMBR" } ] } }
Go
Java
Node.js
Python
HL7v2-Nachrichten erstellen
Die folgenden Beispiele zeigen, wie Sie eine HL7v2-Nachricht mit der Methode projects.locations.datasets.hl7V2Stores.messages.create
erstellen.
REST
Verwenden Sie die projects.locations.datasets.hl7V2Stores.messages.create
-Methode, um eine HL7v2-Nachricht zu erstellen.
Wenn Sie eine HL7v2-Nachrichtendatei für die Beispielbefehle benötigen, können Sie die JSON-Datei hl7v2-sample.json
herunterladen.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT_ID ist die ID Ihres Google Cloud-Projekts
- LOCATION ist der Standort des Datasets
- DATASET_ID ist das übergeordnete Dataset des HL7v2-Speichers
- HL7V2_STORE_ID ist die HL7v2-Speicher-ID
- HL7V2_MESSAGE_FILE ist der Pfad zu einer JSON-formatierten Datei, die eine HL7v2-Nachricht auf Ihrem lokalen Computer enthält
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Führen Sie folgenden Befehl aus:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
--data-binary @HL7V2_MESSAGE_FILE \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages"
PowerShell
Führen Sie diesen Befehl aus:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-InFile HL7V2_MESSAGE_FILE `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages" | Select-Object -Expand Content
APIs Explorer
Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.
hl7v2-sample.json
-JSON-Datei erstellst, wird die folgende Ausgabe zurückgegeben:
Go
Java
Node.js
Python
HL7v2-Nachrichtensegment-Trennzeichen und -Kodierung
Das standardmäßige Segmenttrennzeichen in HL7v2 ist ein Zeilenumbruch (\r
). Die meisten Texteditoren verwenden Zeilenumbruchzeichen (\n
) als Segmenttrennzeichen. Dies erzeugt HL7v2-Nachrichten, die nicht mit der Standardkonfiguration in die Cloud Healthcare API aufgenommen werden können. Wie Sie zulassen, dass ein HL7v2-Speicher Nachrichten mit Zeilenvorschubzeichen als Segmenttrennzeichen aufnehmen kann, erfahren Sie unter Segmentabschlusszeichen festlegen.
Führen Sie den folgenden Befehl in einer Linux-Shell aus, um die Zeilenumbruchzeichen in einer Datei in Zeilenumbrüche umzuwandeln:
sed -z 's/\n/\r/g' INPUT_FILENAME > OUTPUT_FILENAME
Die Methoden Aufnehmen und Erstellen erwarten, dass HL7v2-Nachrichten base64-codierte Strings sind. Führen Sie den folgenden Befehl in einer Linux-Shell aus, um einen String in eine Base64-Codierung umzuwandeln:
openssl base64 -A -in ./INPUT_FILENAME -out ./OUTPUT_FILENAME
Segmentabschluss festlegen
Beim Erstellen oder Aufnehmen von Daten erfordert das HL7v2-Nachrichtenformat, dass Segmente mit dem Rückgabezeichen \r
beendet werden. Sie können einen HL7v2-Speicher so konfigurieren, dass HL7v2-Nachrichten mit einem nicht standardmäßigen Abschlusszeichen wie \n
akzeptiert werden.
Betrachten Sie die folgende HL7v2-Nachricht, die den standardmäßigen \r
als Segmentabschluss verwendet. Diese Nachricht wird standardmäßig akzeptiert, wenn Sie einen HL7v2-Speicher erstellen.
MSH|^~\\&|FROM_APP|FROM_FACILITY|TO_APP|TO_FACILITY|20150503223000||ADT^A01|20150503223000|P|2.5|\r EVN|A01|20110613083617|\r PID|1||21004053^^^^MRN||SULLY^BRIAN||19611209|M|||123 MAIN ST^^MOUNTAIN SPRINGS^CO^80439|\r PV1||I|H73 RM1^1^^HIGHWAY 73 CLINIC||||5148^MARY QUINN|||||||||Y||||||||||||||||||||||||||||20150503223000|\r
Die folgende Nachricht ist mit der vorherigen Nachricht identisch, außer dass sie \n
als Segmentabschlusszeichen verwendet:
MSH|^~\\&|FROM_APP|FROM_FACILITY|TO_APP|TO_FACILITY|20150503223000||ADT^A01|20150503223000|P|2.5|\n EVN|A01|20110613083617|\n PID|1||21004053^^^^MRN||SULLY^BRIAN||19611209|M|||123 MAIN ST^^MOUNTAIN SPRINGS^CO^80439|\n PV1||I|H73 RM1^1^^HIGHWAY 73 CLINIC||||5148^MARY QUINN|||||||||Y||||||||||||||||||||||||||||20150503223000|\n
Zum Speichern der Nachricht mit dem nicht standardmäßigen Abschlusszeichen konfigurieren Sie das Objekt ParserConfig
im HL7v2-Speicher und legen das Feld segmentTerminator
auf die base64-Codierung von \n
fest.
Die folgenden Beispiele zeigen, wie Sie segmentTerminator
in ParserConfig
konfigurieren, wenn Sie einen HL7v2-Speicher erstellen.
Wenn Sie bereits einen HL7v2-Speicher haben, können Sie ihn bearbeiten, um den Text ParserConfig
anzugeben. Nachdem Sie das Segmentabschlusszeichen festgelegt haben, können Sie die Nachricht erstellen oder aufnehmen.
curl
Wenn Sie einen HL7v2-Speicher mit dem Segmentabschlusszeichen \n
erstellen möchten, senden Sie eine POST
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Der Name des HL7v2-Speichers
- Ein
parserConfig
-Objekt, bei demsegmentTerminator
aufCg==
gesetzt ist (die Base64-Codierung von\n
)
Das folgende Beispiel zeigt eine POST
-Anfrage mit curl
.
curl -X POST \ --data "{ 'parserConfig': { 'segmentTerminator': 'Cg==' } }" \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores?hl7V2StoreId=HL7V2_STORE_ID"
Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID", "parserConfig": { "segmentTerminator": "Cg==" } }
PowerShell
Wenn Sie einen HL7v2-Speicher mit dem Segmentabschlusszeichen \n
erstellen möchten, senden Sie eine POST
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Der Name des HL7v2-Speichers
- Ein
parserConfig
-Objekt, bei demsegmentTerminator
aufCg==
gesetzt ist (die Base64-Codierung von\n
)
Das folgende Beispiel zeigt eine POST
-Anfrage mit PowerShell.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Post ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Body "{ 'parserConfig': { 'segmentTerminator': 'Cg==' } } ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores?hl7V2StoreId=HL7V2_STORE_ID" | Select-Object -Expand Content
Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID", "parserConfig": { "segmentTerminator": "Cg==" } }
Einen Null-Segment-Header verwenden
Eine HL7v2-Nachricht ohne Message Header Segment (MSH) hat einen Nullsegment-Header. In der Regel enthält eine HL7v2-Nachricht eine MSH-Datei, die Metadaten wie Quelle, Intent, Zweck und Ziel der Nachricht definiert.
Mit dem MSH können Sie Nachrichten suchen und filtern. Sie können jedoch Nachrichten ohne MSH speichern, indem Sie das Objekt ParserConfig
im HL7v2-Speicher konfigurieren und das Feld allowNullHeader
auf true
setzen.
Die folgende Beispielnachricht enthält ein PID-Segment (Patientenidentifizierung), aber keine MSH:
PID|1||21004053^^^^MRN||SULLY^BRIAN||19611209|M|||123 MAIN ST^^MOUNTAIN SPRINGS^CO^80439
Die folgenden Beispiele zeigen, wie Sie allowNullHeader
in ParserConfig
konfigurieren, wenn Sie einen HL7v2-Speicher erstellen.
Wenn Sie bereits einen HL7v2-Speicher haben, können Sie ihn bearbeiten und den Text ParserConfig
angeben. Nachdem Sie allowNullHeader
auf true
gesetzt haben, können Sie Nachrichten mit Null-Segment-Headern erstellen oder aufnehmen.
curl
Wenn Sie einen HL7v2-Speicher erstellen und Nachrichten ohne MSH speichern möchten, senden Sie eine POST
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Der Name des HL7v2-Speichers
- Ein
parserConfig
-Objekt, bei demallowNullHeader
auftrue
gesetzt ist
Das folgende Beispiel zeigt eine POST
-Anfrage mit curl
.
curl -X POST \ --data "{ 'parserConfig': { 'allowNullHeader': true } }" \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores?hl7V2StoreId=HL7V2_STORE_ID"
Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID", "parserConfig": { "allowNullHeader": true } }
PowerShell
Wenn Sie einen HL7v2-Speicher erstellen und Nachrichten ohne MSH speichern möchten, senden Sie eine POST
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Der Name des HL7v2-Speichers
- Ein
parserConfig
-Objekt, bei demallowNullHeader
auftrue
gesetzt ist
Das folgende Beispiel zeigt eine POST
-Anfrage mit PowerShell.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Post ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Body "{ 'parserConfig': { 'nullTerminator': true } } ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores?hl7V2StoreId=HL7V2_STORE_ID" | Select-Object -Expand Content
Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID", "parserConfig": { "allowNullHeader": true } }
Eine HL7v2-Nachricht hinzufügen
Sie können einer Nachricht ein oder mehrere Schlüssel/Wert-Labels hinzufügen. Ein Anwendungsfall für Labels ist das Hinzufügen von Statuslabels zu einer Nachricht, damit eine Anwendung Nachrichten nach Status abfragen kann.
In den folgenden Beispielen wird gezeigt, wie Sie einer HL7v2-Nachricht mithilfe der Methode projects.locations.datasets.hl7V2Stores.messages.patch
Labels hinzufügen.
curl
Wenn Sie einer HL7v2-Nachricht Labels hinzufügen möchten, senden Sie eine PATCH
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Der Name des HL7v2-Speichers
- Die Nachrichten-ID
- Die zu aktualisierenden Labeldaten
- Eine Aktualisierungsmaske
Das folgende Beispiel zeigt eine PATCH
-Anfrage mit curl
.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data "{ 'labels': { 'KEY' : 'VALUE' } }" "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?updateMask=labels"
Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID", "data": "DATA", "sendFacility": "SEND_FACILITY", "sendTime": "2018-01-01T00:00:00Z", "messageType": "TYPE", "createTime": "CREATE_TIME", "patientIds": [ { "value": "VALUE_1", "type": "TYPE_1" }, { "value": "VALUE_2", "type": "TYPE_2" } ], "labels": { "KEY": "VALUE" } }
PowerShell
Wenn Sie einer HL7v2-Nachricht Labels hinzufügen möchten, senden Sie eine PATCH
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Der Name des HL7v2-Speichers
- Die Nachrichten-ID
- Die zu aktualisierenden Labeldaten
- Eine Aktualisierungsmaske
Das folgende Beispiel zeigt eine PATCH
-Anfrage mit PowerShell.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Patch ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Body "{ 'labels': { 'KEY': 'VALUE' } }" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?updateMask=labels" | Select-Object -Expand Content
Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID", "data": "DATA", "sendFacility": "SEND_FACILITY", "sendTime": "2018-01-01T00:00:00Z", "messageType": "TYPE", "createTime": "CREATE_TIME", "patientIds": [ { "value": "VALUE_1", "type": "TYPE_1" }, { "value": "VALUE_2", "type": "TYPE_2" } ], "labels": { "KEY": "VALUE" } }
Go
Java
Node.js
Python
Inhalt von HL7v2-Nachrichten abrufen
In den folgenden Beispielen wird gezeigt, wie Sie den Inhalt einer HL7v2-Nachricht mit der Methode projects.locations.datasets.hl7V2Stores.messages.get
abrufen. Geben Sie eine der folgenden Optionen an, um den Abfrageparameter view
zu bestimmen:
BASIC
: Nur das Feldname
wird eingeschlossen.RAW_ONLY
: Schließen Sie alle Nachrichtenfelder mit Ausnahme des FeldsparsedData
ein.PARSED_ONLY
: Schließen Sie alle Nachrichtenfelder mit Ausnahme des Feldsdata
ein.FULL
: Schließen Sie alle Nachrichtenfelder ein. Dies ist die Standardeinstellung.
In den folgenden Beispielen wird gezeigt, wie Sie den Inhalt einer HL7v2-Nachricht mit den Ansichten FULL
, RAW_ONLY
und PARSED_ONLY
abrufen.
In der Ansicht FULL
Sie müssen die Ansicht FULL
nicht explizit festlegen, da FULL
der Standardwert ist. In den folgenden curl
- und PowerShell-Beispielen wird die Ansicht FULL
jedoch der Vollständigkeit halber als Abfrageparameter hinzugefügt.
curl
Um den Inhalt einer HL7v2-Nachricht mit der Ansicht FULL
abzurufen, stellen Sie eine GET
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Der Name des HL7v2-Speichers
- Die Nachrichten-ID
FULL
alsview
Das folgende Beispiel zeigt eine GET
-Anfrage mit curl
.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?view=FULL"
Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID", "data": "DATA", "sendFacility": "SEND_FACILITY", "sendTime": "2018-01-01T00:00:00Z", "messageType": "TYPE", "createTime": "CREATE_TIME", "patientIds": [ { "value": "VALUE_1", "type": "TYPE_1" }, { "value": "VALUE_2", "type": "TYPE_2" }, { "value": "VALUE_3", "type": "TYPE_3" } ], "parsedData": { "segments": [ { ""segmentId": "SEGMENT_ID_1", "fields": { FIELDS_1 } }, { "segmentId": "SEGMENT_ID_2", "fields": { FIELDS_2 } }, { "segmentId": "SEGMENT_ID_3", "fields": { FIELDS_3 } } ] } }
PowerShell
Um den Inhalt einer HL7v2-Nachricht mit der Ansicht FULL
abzurufen, stellen Sie eine GET
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Der Name des HL7v2-Speichers
- Die Nachrichten-ID
FULL
alsview
Das folgende Beispiel zeigt eine GET
-Anfrage mit PowerShell.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Get ` -Headers $headers ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?view=FULL" | Select-Object -Expand Content
Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID", "data": "DATA", "sendFacility": "SEND_FACILITY", "sendTime": "2018-01-01T00:00:00Z", "messageType": "TYPE", "createTime": "CREATE_TIME", "patientIds": [ { "value": "VALUE_1", "type": "TYPE_1" }, { "value": "VALUE_2", "type": "TYPE_2" }, { "value": "VALUE_3", "type": "TYPE_3" } ], "parsedData": { "segments": [ { ""segmentId": "SEGMENT_ID_1", "fields": { FIELDS_1 } }, { "segmentId": "SEGMENT_ID_2", "fields": { FIELDS_2 } }, { "segmentId": "SEGMENT_ID_3", "fields": { FIELDS_3 } } ] } }
Go
Java
Node.js
Python
In der Ansicht RAW_ONLY
In den folgenden Beispielen wird gezeigt, wie Sie den Inhalt einer HL7v2-Nachricht mit der Ansicht RAW_ONLY
abrufen, die alle Nachrichtenfelder außer parsedData
enthält.
curl
Um den Inhalt einer HL7v2-Nachricht mit der Ansicht RAW_ONLY
abzurufen, stellen Sie eine GET
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Der Name des HL7v2-Speichers
- Die Nachrichten-ID
RAW_ONLY
als Ansicht festlegen
Das folgende Beispiel zeigt eine GET
-Anfrage mit curl
.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?view=RAW_ONLY"
Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID", "data": "DATA", "sendFacility": "SEND_FACILITY", "sendTime": "2018-01-01T00:00:00Z", "messageType": "TYPE", "createTime": "CREATE_TIME", "patientIds": [ { "value": "VALUE_1", "type": "TYPE_1" }, { "value": "VALUE_2", "type": "TYPE_2" }, { "value": "VALUE_3", "type": "TYPE_3" } ] }
PowerShell
Um den Inhalt einer HL7v2-Nachricht mit der Ansicht RAW_ONLY
abzurufen, stellen Sie eine GET
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Der Name des HL7v2-Speichers
- Die Nachrichten-ID
RAW_ONLY
als Ansicht festlegen
Das folgende Beispiel zeigt eine GET
-Anfrage mit PowerShell.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Get ` -Headers $headers ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?view=RAW_ONLY" | Select-Object -Expand Content
Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID", "data": "DATA", "sendFacility": "SEND_FACILITY", "sendTime": "2018-01-01T00:00:00Z", "messageType": "TYPE", "createTime": "CREATE_TIME", "patientIds": [ { "value": "VALUE_1", "type": "TYPE_1" }, { "value": "VALUE_2", "type": "TYPE_2" }, { "value": "VALUE_3", "type": "TYPE_3" } ] }
In der Ansicht PARSED_ONLY
In den folgenden Beispielen wird gezeigt, wie Sie den Inhalt einer HL7v2-Nachricht mit der Ansicht PARSED_ONLY
abrufen, die alle Nachrichtenfelder außer data
enthält.
curl
Um den Inhalt einer HL7v2-Nachricht mit der Ansicht PARSED_ONLY
abzurufen, stellen Sie eine GET
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Der Name des HL7v2-Speichers
- Die Nachrichten-ID
PARSED_ONLY
als Ansicht festlegen
Das folgende Beispiel zeigt eine GET
-Anfrage mit curl
.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?view=PARSED_ONLY"
Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID", "sendFacility": "SEND_FACILITY", "sendTime": "2018-01-01T00:00:00Z", "messageType": "TYPE", "createTime": "CREATE_TIME", "patientIds": [ { "value": "VALUE_1", "type": "TYPE_1" }, { "value": "VALUE_2", "type": "TYPE_2" }, { "value": "VALUE_3", "type": "TYPE_3" } ], "parsedData": { "segments": [ { "segmentId": "SEGMENT_ID_1", "fields": { FIELDS_1 } }, { "segmentId": "SEGMENT_ID_2", "fields": { FIELDS_2 } }, { "segmentId": "SEGMENT_ID_3", "fields": { FIELDS_3 } } ] } }
PowerShell
Um den Inhalt einer HL7v2-Nachricht mit der Ansicht PARSED_ONLY
abzurufen, stellen Sie eine GET
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Der Name des HL7v2-Speichers
- Die Nachrichten-ID
PARSED_ONLY
als Ansicht festlegen
Das folgende Beispiel zeigt eine GET
-Anfrage mit PowerShell.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Get ` -Headers $headers ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?view=PARSED_ONLY" | Select-Object -Expand Content
Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID", "sendFacility": "SEND_FACILITY", "sendTime": "2018-01-01T00:00:00Z", "messageType": "TYPE", "createTime": "CREATE_TIME", "patientIds": [ { "value": "VALUE_1", "type": "TYPE_1" }, { "value": "VALUE_2", "type": "TYPE_2" }, { "value": "VALUE_3", "type": "TYPE_3" } ], "parsedData": { "segments": [ { "segmentId": "SEGMENT_ID_1", "fields": { FIELDS_1 } }, { "segmentId": "SEGMENT_ID_2", "fields": { FIELDS_2 } }, { "segmentId": "SEGMENT_ID_3", "fields": { FIELDS_3 } } ] } }
In der Ansicht BASIC
In den folgenden Beispielen wird gezeigt, wie Sie den Inhalt einer HL7v2-Nachricht mit der Ansicht BASIC
abrufen, die nur das Feld name
enthält.
curl
Um den Inhalt einer HL7v2-Nachricht mit der Ansicht BASIC
abzurufen, stellen Sie eine GET
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Der Name des HL7v2-Speichers
- Die Nachrichten-ID
BASIC
als Ansicht festlegen
Das folgende Beispiel zeigt eine GET
-Anfrage mit curl
.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?view=BASIC"
Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID" }
PowerShell
Um den Inhalt einer HL7v2-Nachricht mit der Ansicht BASIC
abzurufen, stellen Sie eine GET
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Der Name des HL7v2-Speichers
- Die Nachrichten-ID
BASIC
als Ansicht festlegen
Das folgende Beispiel zeigt eine GET
-Anfrage mit PowerShell.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Get ` -Headers $headers ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID?view=BASIC" | Select-Object -Expand Content
Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID" }
HL7v2-Nachrichten auflisten
In den folgenden Beispielen wird gezeigt, wie die Nachrichten mithilfe der Methode in einem HL7v2-Speicher aufgelistet werden. Geben Sie den Abfrageparameter view
mit einer der folgenden Optionen an, um die Informationen zu den einzelnen Nachrichten in der Liste zu bestimmen:
BASIC
: Nur das Feldname
wird eingeschlossen. Dies ist die Standardeinstellung.RAW_ONLY
: Schließen Sie alle Nachrichtenfelder mit Ausnahme des FeldsparsedData
ein.PARSED_ONLY
: Schließen Sie alle Nachrichtenfelder mit Ausnahme des Feldsdata
ein.FULL
: Schließen Sie alle Nachrichtenfelder ein.
curl
Wenn Sie die Nachrichten in einem HL7v2-Speicher auflisten möchten, senden Sie eine GET
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Der Name des HL7v2-Speichers
view
,BASIC
,RAW_ONLY
,PARSED_ONLY
oderFULL
oder weglassen, um den StandardwertBASIC
zu verwenden
Das folgende Beispiel zeigt eine GET
-Anfrage mit curl
. In der Anfrage wird ?view=FULL
angegeben, um alle Nachrichtenfelder einzuschließen.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages?view=FULL"
Wenn die Anfrage erfolgreich ist, gibt der Server den HTTP-Statuscode 200 OK
und ein Nachrichtenarray namens hl7_v2_messages
zurück. Die folgende Beispielantwort ist abgeschnitten.
{ "hl7_v2_messages": [ { "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID", "data": "DATA", "sendFacility": "SEND_FACILITY", "sendTime": "SEND_TIME", "messageType": "MESSAGE_TYPE", "createTime": "CREATE_TIME", ... }, ... ] }
PowerShell
Wenn Sie die Nachrichten in einem HL7v2-Speicher auflisten möchten, senden Sie eine GET
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Der Name des HL7v2-Speichers
view
,BASIC
,RAW_ONLY
,PARSED_ONLY
oderFULL
oder weglassen, um den StandardwertBASIC
zu verwenden
Das folgende Beispiel zeigt eine GET
-Anfrage mit PowerShell. In der Anfrage wird ?view=FULL
angegeben, um alle Nachrichtenfelder einzuschließen.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Get ` -Headers $headers ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages?view=FULL" | Select-Object -Expand Content
Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück. Die Beispielantwort ist abgeschnitten.
{ "hl7_v2_messages": [ { "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID", "data": "DATA", "sendFacility": "SEND_FACILITY", "sendTime": "SEND_TIME", "messageType": "MESSAGE_TYPE", "createTime": "CREATE_TIME", ... }, ... ] }
Go
Java
Node.js
Python
Eine HL7v2-Nachricht löschen
In den folgenden Beispielen wird gezeigt, wie Sie eine HL7v2-Nachricht mit der Methode projects.locations.datasets.hl7V2Stores.messages.delete
löschen.
curl
Um eine HL7v2-Nachricht zu löschen, senden Sie eine DELETE
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Der Name des HL7v2-Speichers
- Die HL7v2-Nachrichten-ID
Das folgende Beispiel zeigt eine DELETE
-Anfrage mit curl
.
curl -X DELETE \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID"
Wenn die Anfrage erfolgreich ist, gibt der Server die leere Antwort im JSON-Format zurück:
{}
PowerShell
Um eine HL7v2-Nachricht zu löschen, senden Sie eine DELETE
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Der Name des HL7v2-Speichers
- Die HL7v2-Nachrichten-ID
Das folgende Beispiel zeigt eine DELETE
-Anfrage mit PowerShell.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Delete ` -Headers $headers ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID" | Select-Object -Expand Content
Wenn die Anfrage erfolgreich ist, gibt der Server den leeren Antworttext im JSON-Format zurück:
{}