Auf dieser Seite wird erläutert, wie Sie HL7v2-Speicher (Health Level Seven Version 2.x) erstellen, bearbeiten, aufrufen und löschen.
HL7v2-Speicher erstellen
Bevor Sie einen HL7v2-Speicher erstellen können, müssen Sie ein Dataset erstellen.
In den folgenden Beispielen wird gezeigt, wie Sie einen HL7v2-Speicher erstellen.
Console
So erstellen Sie einen HL7v2-Speicher:
- Rufen Sie in der Cloud Console die Seite „Datasets“ auf.
- Öffnen Sie das Dataset, in dem Sie einen HL7v2-Speicher erstellen möchten.
- Klicken Sie auf Datenspeicher erstellen.
- Geben Sie einen Namen Ihrer Wahl ein, der in Ihrem Dataset eindeutig ist. Wenn der Name nicht eindeutig ist, schlägt die Erstellung des Datenspeichers fehl.
- Wählen Sie DICOM als Datenspeichertyp aus.
-
Wenn Sie ein Pub/Sub-Thema für den Datenspeicher konfigurieren möchten, geben Sie den Namen des Themas ein.
Wenn Sie ein Pub/Sub-Thema angeben, geben Sie den qualifizierten URI zum Thema ein, wie im folgenden Beispiel gezeigt:
projects/PROJECT_ID/topics/PUBSUB_TOPIC
- Klicken Sie auf Erstellen.
Der neue Datenspeicher wird in der Liste angezeigt.
gcloud
Führen Sie den Befehl gcloud healthcare hl7v2-stores create
aus, um einen HL7v2-Speicher im Dataset zu erstellen.
- Die HL7v2-Speicher-ID muss im Dataset eindeutig sein. Es kann sich um einen beliebigen Unicode-String mit 1 bis 256 Zeichen handeln, der aus Zahlen, Buchstaben, Unterstrichen, Bindestrichen und Punkten besteht.
- Wenn Sie ein Pub/Sub-Thema über Änderungen im HL7v2-Speicher benachrichtigen möchten, geben Sie mit dem Argument
--pubsub-topic
einen vorhandenen Pub/Sub-Themennamen an.
projects/PROJECT_ID/topics/PUBSUB_TOPIC
Das folgende Beispiel zeigt, wie Sie einen HL7v2-Speicher erstellen:
gcloud healthcare hl7v2-stores create HL7V2_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Wenn die Anfrage erfolgreich ist, wird in der Eingabeaufforderung die folgende Meldung angezeigt:
Created hl7v2Store [HL7V2_STORE_ID].
API
Verwenden Sie die Methode projects.locations.datasets.hl7V2Stores.create
, um einen HL7v2-Speicher zu erstellen.
curl
Senden Sie zum Erstellen eines HL7v2-Speichers eine POST
-Anfrage und geben Sie die folgenden Informationen an:
- Der Name des übergeordneten Datasets
- Ein Name für den HL7v2-Speicher Der Name des HL7v2-Speichers muss im übergeordneten Dataset eindeutig sein. Es kann sich um einen beliebigen Unicode-String mit 1 bis 256 Zeichen handeln, der aus Zahlen, Buchstaben, Unterstrichen, Bindestrichen und Punkten besteht.
- Ein Zugriffstoken
- Optional ein vorhandenes Pub/Sub-Thema, an das die Cloud Healthcare API-Benachrichtigungen über Änderungen an HL7v2-Speichern sendet. Informationen zum Konfigurieren des Pub/Sub-Themas finden Sie unter HL7v2-Speicher bearbeiten.
- Optional eine Liste der vorhandenen Pub/Sub-Themen und -Filter. Die Cloud Healthcare API kann Benachrichtigungen an mehrere Themen senden und Sie können mit Filtern einschränken, welche Benachrichtigungen gesendet werden. Weitere Informationen zum Konfigurieren von Pub/Sub-Themen und -Filtern finden Sie unter HL7v2-Speicher bearbeiten.
Das folgende Beispiel zeigt eine POST
-Anfrage mit curl
.
curl -X POST \ --data "" \ -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" }
PowerShell
Senden Sie zum Erstellen eines HL7v2-Speichers eine POST
-Anfrage und geben Sie die folgenden Informationen an:
- Der Name des übergeordneten Datasets
- Ein Name für den HL7v2-Speicher Der Name des HL7v2-Speichers muss im übergeordneten Dataset eindeutig sein. Es kann sich um einen beliebigen Unicode-String mit 1 bis 256 Zeichen handeln, der aus Zahlen, Buchstaben, Unterstrichen, Bindestrichen und Punkten besteht.
- Ein Zugriffstoken
- Optional ein vorhandenes Pub/Sub-Thema, an das die Cloud Healthcare API-Benachrichtigungen über Änderungen an HL7v2-Speichern sendet. Informationen zum Konfigurieren des Pub/Sub-Themas finden Sie unter HL7v2-Speicher bearbeiten.
- Optional eine Liste der vorhandenen Pub/Sub-Themen und -Filter. Die Cloud Healthcare API kann Benachrichtigungen an mehrere Themen senden und Sie können mit Filtern einschränken, welche Benachrichtigungen gesendet werden. Weitere Informationen zum Konfigurieren von Pub/Sub-Themen und -Filtern finden Sie unter HL7v2-Speicher bearbeiten.
Das folgende Beispiel zeigt eine POST
-Anfrage mit Windows 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" ` -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" }
Go
Java
Node.js
Python
HL7v2-Speicher bearbeiten
Die folgenden Beispiele zeigen, wie Sie die folgenden Änderungen an einem HL7v2-Speicher vornehmen:
Bearbeiten Sie die Liste der Pub/Sub-Themen und -Filter, die die Cloud Healthcare API zum Senden von Benachrichtigungen über Änderungen an HL7v2-Speichern verwendet.
Bearbeiten Sie die Labels. Labels sind Schlüssel/Wert-Paare, mit denen Sie Ihre Google Cloud-Ressourcen organisieren können.
projects/PROJECT_ID/topics/PUBSUB_TOPICDamit Benachrichtigungen gesendet werden, müssen Sie dem Dienstkonto Cloud Healthcare Service Agent zusätzliche Berechtigungen erteilen. Weitere Informationen finden Sie unter Pub/Sub-Berechtigungen für DICOM-, FHIR- und HL7v2-Speicher.
Console
Die Cloud Console unterstützt das Bearbeiten des Pub/Sub-Themas oder der Labels nicht. Verwenden Sie stattdessen curl
, Windows PowerShell oder Ihre bevorzugte Sprache.
gcloud
Das gcloud
-Tool unterstützt das Bearbeiten des Pub/Sub-Themas oder der Labels nicht. Verwenden Sie stattdessen curl
, Windows PowerShell oder Ihre bevorzugte Sprache.
API
Verwenden Sie zum Bearbeiten eines HL7v2-Speichers die Methode projects.locations.datasets.hl7V2Stores.patch
.
curl
Wenn Sie einen HL7v2-Speicher bearbeiten möchten, senden Sie eine PATCH
-Anfrage und geben Sie die folgenden Informationen an:
- Der Name des übergeordneten Datasets
- Der Name des HL7v2-Speichers
Die zu aktualisierenden Metadaten Dieses Beispiel enthält den qualifizierten URI zu den Pub / Sub-Themen, die Filter für die Themen und eine Reihe von Labels, die als durch Kommas getrennte Liste von Schlüssel/Wert-Paaren definiert sind.
Beispiele für gültige Filterwerte finden Sie unter
filter
.Eine Aktualisierungsmaske
Ein Zugriffstoken
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 "{ 'notificationConfigs': [ { 'pubsubTopic': 'projects/PROJECT_ID/topics/PUBSUB_TOPIC1', 'filter' : 'FILTER1' }, { 'pubsubTopic': 'projects/PROJECT_ID/topics/PUBSUB_TOPIC2', 'filter': 'FILTER2' }, ], 'labels': { 'KEY1':'VALUE1','KEY2':'VALUE2' } }" "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID?updateMask=notificationConfigs,labels"
Weitere Informationen zum Definieren von Filtern und Filtersyntax finden Sie unter Hl7V2NotificationConfig
.
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": {}, "labels": { "KEY1": "VALUE1", "KEY2": "VALUE2" }, "notificationConfigs": [ { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC1", "filter": "FILTER1" }, { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC2", "filter": "FILTER2" } ] }
PowerShell
Wenn Sie einen HL7v2-Speicher bearbeiten möchten, senden Sie eine PATCH
-Anfrage und geben Sie die folgenden Informationen an:
- Der Name des übergeordneten Datasets
- Der Name des HL7v2-Speichers
Die zu aktualisierenden Metadaten Dieses Beispiel enthält den qualifizierten URI zu den Pub / Sub-Themen, die Filter für die Themen und eine Reihe von Labels, die als durch Kommas getrennte Liste von Schlüssel/Wert-Paaren definiert sind.
Beispiele für gültige Filterwerte finden Sie unter
filter
.Eine Aktualisierungsmaske
Ein Zugriffstoken
Das folgende Beispiel zeigt eine PATCH
-Anfrage mit Windows 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 "{ 'notificationConfigs': [ { 'pubsubTopic': 'projects/PROJECT_ID/topics/PUBSUB_TOPIC1', 'filter': 'FILTER1' }, { 'pubsubTopic': 'projects/PROJECT_ID/topics/PUBSUB_TOPIC2', 'filter': 'FILTER2' }, ], 'labels': { 'KEY1':'VALUE1','KEY2':'VALUE2' } }" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID?updateMask=notificationConfigs,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", "parserConfig": {}, "labels": { "KEY1": "VALUE1", "KEY2": "VALUE2" }, "notificationConfigs": [ { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC1", "filter": "FILTER1" }, { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC2", "filter": "FILTER2" } ] }
Go
Java
Node.js
Python
HL7v2-Speicherdetails abrufen
In den folgenden Beispielen wird gezeigt, wie Sie Details zu einem HL7v2-Speicher abrufen können.
Console
So rufen Sie die Details eines HL7v2-Speichers auf:
- Rufen Sie in der Cloud Console die Seite „Datasets“ auf.
- Klicken Sie auf die ID des Datasets, das den HL7v2-Speicher enthält.
- Klicken Sie auf den Namen des HL7v2-Speichers.
gcloud
Führen Sie den Befehl gcloud healthcare hl7v2-stores describe
aus, um Details zu einem HL7v2-Speicher aufzurufen.
Das folgende Beispiel zeigt, wie Sie Details zu einem HL7v2-Speicher abrufen.
gcloud healthcare hl7v2-stores describe HL7V2_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Wenn die Anfrage erfolgreich ist, zeigt die Eingabeaufforderung die HL7v2-Speicherdetails an:
name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7v2-stores/HL7V2_STORE_ID
API
Verwenden Sie die Methode projects.locations.datasets.hl7V2Stores.get
, um Details zu einem HL7v2-Speicher abzurufen.
curl
Wenn Sie Details zu einem HL7v2-Speicher abrufen möchten, senden Sie eine GET
-Anfrage und geben Sie die folgenden Informationen an:
- Der Name des übergeordneten Datasets
- Der Name des HL7v2-Speichers
- Ein Zugriffstoken
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"
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" }
Wenn Sie in der Ressource Hl7V2Store
Felder konfiguriert haben, werden diese auch in der Antwort angezeigt.
PowerShell
Wenn Sie Details zu einem HL7v2-Speicher abrufen möchten, senden Sie eine GET
-Anfrage und geben Sie die folgenden Informationen an:
- Der Name des übergeordneten Datasets
- Der Name des HL7v2-Speichers
- Ein Zugriffstoken
Das folgende Beispiel zeigt eine GET
-Anfrage mit Windows 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" | 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" }
Wenn Sie in der Ressource Hl7V2Store
Felder konfiguriert haben, werden diese auch in der Antwort angezeigt.
Go
Java
Node.js
Python
HL7v2-Speicher in einem Dataset auflisten
In den folgenden Beispielen wird gezeigt, wie Sie die HL7v2-Speicher in einem Dataset auflisten.
Console
So zeigen Sie die Datenspeicher in einem Dataset an:
- Rufen Sie in der Cloud Console die Seite „Datasets“ auf.
- Klicken Sie auf die ID des Datasets, dessen Datenspeicher Sie anzeigen möchten.
gcloud
Führen Sie den Befehl gcloud healthcare hl7v2-stores list
aus, um die HL7v2-Speicher in einem Dataset aufzulisten.
gcloud healthcare hl7v2-stores list --dataset=DATASET_ID
Wenn die Anfrage erfolgreich ist, werden in der Eingabeaufforderung die HL7v2-Speicher aufgelistet:
ID LOCATION TOPIC HL7V2_STORE_ID LOCATION projects/PROJECT_ID/topics/PUBSUB_TOPIC
API
Verwenden Sie die Methode projects.locations.datasets.hl7V2Stores.list
, um die HL7v2-Speicher in einem Dataset aufzulisten.
curl
Wenn Sie die HL7v2-Speicher in einem Dataset auflisten möchten, senden Sie eine GET
-Anfrage und geben Sie die folgenden Informationen an:
- Der Name des übergeordneten Datasets
- Ein Zugriffstoken
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"
Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:
{ "hl7V2Stores": [ { "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID" }, { ... } ] }
Wenn Sie in der Ressource Hl7V2Store
Felder konfiguriert haben, werden diese auch in der Antwort angezeigt.
PowerShell
Wenn Sie die HL7v2-Speicher in einem Dataset auflisten möchten, senden Sie eine GET
-Anfrage und geben Sie die folgenden Informationen an:
- Der Name des übergeordneten Datasets
- Ein Zugriffstoken
Das folgende Beispiel zeigt eine GET
-Anfrage mit Windows 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" | Select-Object -Expand Content
Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:
{ "hl7V2Stores": [ { "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID" }, { ... } ] }
Wenn Sie in der Ressource Hl7V2Store
Felder konfiguriert haben, werden diese auch in der Antwort angezeigt.
Go
Java
Node.js
Python
HL7v2-Speicher löschen
In den folgenden Beispielen wird gezeigt, wie Sie einen HL7v2-Speicher löschen.
Console
So löschen Sie einen Datenspeicher:
- Rufen Sie in der Cloud Console die Seite „Datasets“ auf.
- Öffnen Sie das Dataset, indem Sie auf die Dataset-ID klicken.
- Wählen Sie den zu löschenden Datenspeicher aus und klicken Sie auf Löschen.
- Geben Sie zur Bestätigung den Namen des Datenspeichers ein und klicken Sie dann auf Löschen.
gcloud
Führen Sie den Befehl gcloud healthcare hl7v2-stores delete
aus, um einen HL7v2-Speicher zu löschen:
Führen Sie den Befehl
delete
aus:gcloud healthcare hl7v2-stores delete HL7V2_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Geben Sie zur Bestätigung Y ein.
Wenn die Anfrage erfolgreich ist, wird in der Eingabeaufforderung Folgendes angezeigt:
Deleted hl7v2Store [HL7V2_STORE_ID]
API
Verwenden Sie die Methode projects.locations.datasets.hl7V2Stores.delete
, um einen HL7v2-Speicher zu löschen.
curl
Wenn Sie einen HL7v2-Speicher löschen möchten, senden Sie eine DELETE
-Anfrage und geben Sie die folgenden Informationen an:
- Der Name des übergeordneten Datasets
- Der Name des zu löschenden HL7v2-Speichers
- Ein Zugriffstoken
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"
Wenn die Anfrage erfolgreich ist, gibt der Server die leere Antwort im JSON-Format zurück:
{}
PowerShell
Wenn Sie einen HL7v2-Speicher löschen möchten, senden Sie eine DELETE
-Anfrage und geben Sie die folgenden Informationen an:
- Der Name des übergeordneten Datasets
- Der Name des zu löschenden HL7v2-Speichers
- Ein Zugriffstoken
Das folgende Beispiel zeigt eine DELETE
-Anfrage mit Windows 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" | Select-Object -Expand Content
Wenn die Anfrage erfolgreich ist, gibt der Server den leeren Antworttext im JSON-Format zurück:
{}
Go
Java
Node.js
Python
Nächste Schritte
- Konzeptionelle Dokumentation zur Implementierung von HL7v2 in der Cloud Healthcare API lesen.
- HL7v2-Nachrichten erstellen und verwalten.