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
Verwenden Sie eine der folgenden Methoden, um eine HL7v2-Nachricht in der Cloud Healthcare API zu speichern:
Wenn Sie messages.ingest verwenden, wird mit der Methode eine Antwort generiert, die Folgendes enthält:
- 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.1definiert den Nachrichtentyp. - Der Wert des
MSA.1-Felds definiert einen Antworttyp. Der AntworttypAAgibtApplication Acceptan, 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: 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 folgenden 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 erstellt wird:
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 demsegmentTerminatoraufCg==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 demsegmentTerminatoraufCg==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 demallowNullHeaderauftruegesetzt 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 demallowNullHeaderauftruegesetzt 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 Feldnamewird eingeschlossen.RAW_ONLY: Schließen Sie alle Nachrichtenfelder mit Ausnahme des FeldsparsedDataein.PARSED_ONLY: Schließen Sie alle Nachrichtenfelder mit Ausnahme des Feldsdataein.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
FULLalsview
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
FULLalsview
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_ONLYals 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_ONLYals 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_ONLYals 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_ONLYals 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
BASICals 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
BASICals 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 Feldnamewird eingeschlossen. Dies ist die Standardeinstellung.RAW_ONLY: Schließen Sie alle Nachrichtenfelder mit Ausnahme des FeldsparsedDataein.PARSED_ONLY: Schließen Sie alle Nachrichtenfelder mit Ausnahme des Feldsdataein.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_ONLYoderFULLoder weglassen, um den StandardwertBASICzu 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_ONLYoderFULLoder weglassen, um den StandardwertBASICzu 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:
{}