Auf dieser Seite wird erläutert, wie Sie FHIR-Speicher (Fast Healthcare Interoperability Resources) erstellen, bearbeiten, anzeigen, auflisten und löschen. FHIR-Speicher enthalten FHIR-Ressourcen wie Anspruchsressourcen, Patientenressourcen, Medizinressourcen und mehr.
Die Cloud Healthcare API unterstützt die folgenden FHIR-Versionen:
FHIR-Speicher erstellen
Bevor Sie einen FHIR-Speicher erstellen können, müssen Sie ein Dataset erstellen.
Die folgenden Beispiele zeigen, wie Sie einen FHIR-Speicher mit der Methode projects.locations.datasets.fhirStores.create
erstellen.
Console
Führen Sie die folgenden Schritte aus, um einen FHIR-Speicher zu erstellen:
- Rufen Sie in der Google Cloud Console die Seite Datasets auf.
- Wählen Sie das Dataset, in dem Sie einen FHIR-Speicher erstellen möchten.
- Klicken Sie auf Datenspeicher erstellen.
- Wählen Sie FHIR als Datenspeichertyp aus.
- Geben Sie einen Namen ein, der in Ihrem Dataset eindeutig ist. Wenn der Name nicht eindeutig ist, wird die Erstellung des FHIR-Speichers schlägt fehl.
- Klicken Sie auf Weiter.
- So konfigurieren Sie Ihren FHIR-Speicher:
- Wählen Sie die FHIR-Version für den FHIR-Speicher aus, eine von DSTU2, STU3 oder R4.
- Wählen Sie aus den folgenden Optionen die entsprechenden erweiterten Einstellungen aus:
- Update erstellen zulassen: Wählen Sie diese Option aus, um das Erstellen einer neuen Ressource mithilfe eines Aktualisierungsvorgangs mit einer vom Nutzer angegebenen ID zuzulassen.
- Referenzielle Integritätsprüfungen: Wählen Sie diese Option aus, um die referenzielle Integrität in diesem Speicher zu aktivieren. Dies kann nach dem Erstellen des Speichers nicht mehr geändert werden.
- Ressourcenversionsverwaltung: Wählen Sie diese Option aus, um Verlaufsversionen von Ressourcen automatisch aufzuzeichnen. Dies kann nach dem Erstellen des Speichers nicht mehr geändert werden.
- Wählen Sie die entsprechenden Einstellungen für die Profilvalidierung aus den folgenden Feldern aus. Weitere Informationen finden Sie unter ValidationConfig:
- Profilvalidierung aktivieren: Wählen Sie diese Option aus, um die Profilvalidierung zu aktivieren. Um eine Implementierungsleitfaden, der in Ihrem FHIR-Speicher aktiviert ist, müssen Sie das Profil aktivieren Validierung.
- Validierung der Pflichtfelder aktivieren: Wählen Sie diese Option aus, um die Validierung der Ressourcenfelder zu aktivieren. mit den Strukturdefinitionen in Ihrem FHIR-Profil vergleichen.
- Validierung des Referenztyps aktivieren: Wählen Sie diese Option aus, um die Validierung des Referenztyps zu aktivieren.
- FHIRPath-Validierung aktivieren: Wählen Sie diese Option aus, um die FHIRPath-Kompatibilitätsprüfung zu aktivieren.
- Klicken Sie auf Weiter.
- Optional: So aktivieren Sie Implementierungsleitfäden in Ihrem FHIR-Speicher:
- Klicken Sie auf Implementierungsleitfäden aktivieren.
- Klicken Sie auf die Liste Implementierungsleitfäden und maximieren Sie sie.
- Wählen Sie die entsprechenden Implementierungsleitfäden aus der Liste aus.
Jeder Implementierungsleitfaden unterstützt eine bestimmte FHIR-Version. In der Liste werden nur die Implementierungsleitfäden, die mit der ausgewählten FHIR-Speicherversion kompatibel sind.
- Klicken Sie auf Import custom IG from Cloud Storage, um die Validierung benutzerdefinierter Profile zu importieren. Bundle aus einem Cloud Storage-Speicherort erstellen.
- Wählen Sie im Bereich Objekt auswählen eine Profilvalidierungsbundle-Ressource aus einem Cloud Storage-Speicherort aus. Weitere Informationen finden Sie unter Aktivieren Sie Implementierungsleitfäden in der Google Cloud Console.
- Klicken Sie auf Auswählen.
- Die ausgewählten Implementierungsleitfäden sind in einer Tabelle mit den Version, URL und Status.
- Wenn Sie Implementierungsleitfäden aktiviert, die Profilvalidierung aber nicht aktiviert haben: tritt der Implementierungsleitfaden nicht in Kraft.
- Klicken Sie auf Weiter.
- Optional: So exportieren Sie Ressourcenänderungen jedes Mal nach BigQuery, wenn die FHIR-Ressourcen in Ihrem Speicher vorhanden sind
erstellt, aktualisiert, gepatcht oder gelöscht werden, gehen Sie wie folgt vor:
- Klicken Sie auf Ressourcenänderungen in BigQuery streamen.
- Klicken Sie auf Streamingkonfiguration hinzufügen. Weitere Informationen zu BigQuery Streaming siehe Streaming von FHIR-Ressourcenänderungen in BigQuery.
- Wählen Sie im Schieberegler Rekursive Strukturtiefe die gewünschte Tiefe aus, um die Tiefe für alle rekursiven Strukturen im Ausgabeschema festzulegen. Der Standardwert für die rekursive Tiefe ist 2.
- Klicken Sie auf Fertig, um die Streamingkonfiguration zu speichern.
- Klicken Sie auf Weiter.
- Optional: So konfigurieren Sie ein Pub/Sub-Thema für den FHIR-Speicher:
- Klicken Sie auf Cloud Pub/Sub-Benachrichtigungen erhalten.
- Klicken Sie auf Cloud Pub/Sub-Thema hinzufügen und wählen Sie den Namen des Themas aus.
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 Weiter.
- Optional: So fügen Sie dem Store Labels hinzu:
- Klicken Sie auf Labels hinzufügen, um Ihre Datenspeicher zu organisieren.
- Geben Sie den Schlüssel und den Wert für das Label ein. Weitere Informationen zu Ressourcenlabels finden Sie unter Ressourcenlabel verwenden.
- Klicken Sie auf Erstellen.
Der neue FHIR-Speicher wird in der Liste angezeigt.
gcloud
Führen Sie den Befehl gcloud healthcare fhir-stores create
aus, um einen FHIR-Speicher im Dataset zu erstellen.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
- LOCATION ist der Standort des Datasets
- DATASET_ID: das übergeordnete Dataset des FHIR-Speichers
- FHIR_STORE_ID:
eine Kennung für den FHIR-Speicher. Die FHIR-Speicher-ID muss Folgendes enthalten:
- Eine im eigenen Dataset eindeutige ID
- Einen Unicode-String mit 1 bis 256 Zeichen, der Folgendes umfasst:
- Nummern
- Buchstaben
- Unterstriche
- Bindestriche
- Punkte
- FHIR_STORE_VERSION ist die FHIR-Version des FHIR-Speichers Verfügbare Optionen sind DSTU2, STU3 oder R4.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud healthcare fhir-stores create FHIR_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION \ --version=FHIR_STORE_VERSION
Windows (PowerShell)
gcloud healthcare fhir-stores create FHIR_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION ` --version=FHIR_STORE_VERSION
Windows (cmd.exe)
gcloud healthcare fhir-stores create FHIR_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION ^ --version=FHIR_STORE_VERSION
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Antwort
Created fhirStore [FHIR_STORE_ID].
REST
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: das übergeordnete Dataset des FHIR-Speichers
- FHIR_STORE_ID:
eine Kennung für den FHIR-Speicher. Die FHIR-Speicher-ID muss Folgendes enthalten:
- Eine im eigenen Dataset eindeutige ID
- Einen Unicode-String mit 1 bis 256 Zeichen, der Folgendes umfasst:
- Nummern
- Buchstaben
- Unterstriche
- Bindestriche
- Punkte
- FHIR_STORE_VERSION ist die FHIR-Version des FHIR-Speichers Verfügbare Optionen sind DSTU2, STU3 oder R4.
JSON-Text der Anfrage:
{ "version": "FHIR_STORE_VERSION" }
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json
.
Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:
cat > request.json << 'EOF' { "version": "FHIR_STORE_VERSION" } EOF
Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores?fhirStoreId=FHIR_STORE_ID"
PowerShell
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json
.
Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:
@' { "version": "FHIR_STORE_VERSION" } '@ | Out-File -FilePath request.json -Encoding utf8
Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores?fhirStoreId=FHIR_STORE_ID" | Select-Object -Expand Content
APIs Explorer
Kopieren Sie den Anfragetext und öffnen Sie die Referenzseite für Methoden. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Fügen Sie den Anfragetext in dieses Tool ein, füllen Sie alle Pflichtfelder aus und klicken Sie auf Ausführen.
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
Go
Java
Node.js
Python
Einen FHIR-Speicher bearbeiten
In folgenden Beispielen wird gezeigt, wie Sie einen FHIR-Speicher bearbeiten. Sie können einen FHIR-Speicher bearbeiten, um Attribute wie die Folgenden zu ändern:
- Das Pub/Sub-Thema, an das die Cloud Healthcare API weitergeleitet wird sendet Benachrichtigungen über Änderungen des FHIR-Speichers.
- Die Labels des FHIR-Speichers. Labels sind Schlüssel/Wert-Paare, mit denen Sie Ihre Google Cloud-Ressourcen organisieren können.
projects/PROJECT_ID/topics/PUBSUB_TOPIC
Console
Führen Sie die folgenden Schritte aus, um einen FHIR-Speicher zu bearbeiten:
Rufen Sie in der Google Cloud Console die Seite Datasets auf.
Zu den DatasetsWählen Sie das Dataset mit dem FHIR-Speicher aus, den Sie bearbeiten möchten.
Wählen Sie in der Liste Datenspeicher den FHIR-Speicher aus, den Sie bearbeiten möchten.
Klicken Sie auf
, um die Konfiguration des Speichers zu bearbeiten FHIR-Speicherkonfiguration.Weitere Informationen zu den Konfigurationsoptionen des FHIR-Speichers finden Sie unter FHIR-Speicher erstellen.
Klicken Sie auf Aktivieren Sie Implementierungsleitfäden in der Google Cloud Console.
, um die Implementierungsleitfäden des Speichers zu bearbeiten. Implementierungsleitfäden und wählen Sie die entsprechenden Implementierungsleitfäden aus. oder einen benutzerdefinierten Implementierungsleitfaden aus Cloud Storage importieren. Weitere Informationen finden Sie unterUm die Implementierungsleitfäden zu bearbeiten oder die aktivierte Implementierung zu erzwingen Leitfäden, müssen Sie die Profilvalidierung in der Abschnitt FHIR-Speicherkonfiguration.
Klicken Sie auf Neue Streaming-Konfiguration hinzufügen im Feld Dataset, um jedes Mal Ressourcenänderungen nach BigQuery zu exportieren, wenn die FHIR-Ressourcen in Ihrem Speicher erstellt, aktualisiert, gepatcht oder gelöscht werden.
Wählen Sie ein BigQuery-Dataset aus, an das Ressourcenänderungen gestreamt werden sollen. Weitere Informationen zu BigQuery-Streaming finden Sie unter FHIR-Ressourcenänderungen in BigQuery streamen.
Wenn Sie für alle rekursiven Strukturen im Ausgabeschema die Tiefe festlegen möchten, klicken Sie im Schieberegler Rekursive Strukturtiefe auf die entsprechende Tiefe. Standardmäßig ist die rekursive Tiefe 2.
Wenn Sie Ressourcenänderungen nur für bestimmte Ressourcentypen exportieren möchten, wählen Sie die Ressourcentypen aus der Liste FHIR-Ressourcentypen auswählen aus.
Wählen Sie im Abschnitt Cloud Pub/Sub-Benachrichtigungen einen Themennamen aus, um ein Pub/Sub-Thema für den Datenspeicher zu konfigurieren. 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
Um dem Speicher ein oder mehrere Labels hinzuzufügen, klicken Sie auf Ressourcenlabel verwenden.
Labels und auf Label hinzufügen. Geben Sie dann das Schlüssel/Wert-Label ein. Weitere Informationen zu Ressourcenlabel finden Sie unterKlicken Sie auf Speichern.
gcloud
Führen Sie den Befehl gcloud healthcare fhir-stores update
aus, um einen FHIR-Speicher zu bearbeiten.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
PROJECT_ID
: die ID Ihres Google Cloud-ProjektsLOCATION
ist der Standort des DatasetsDATASET_ID
: das übergeordnete Dataset des FHIR-SpeichersFHIR_STORE_ID
: die FHIR-Speicher-IDPUBSUB_TOPIC_ID
: ein Pub/Sub-Thema, in dem Nachrichten veröffentlicht werden, wenn ein Ereignis in einem Datenspeicher auftritt
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud healthcare fhir-stores update FHIR_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION \ --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID
Windows (PowerShell)
gcloud healthcare fhir-stores update FHIR_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION ` --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID
Windows (cmd.exe)
gcloud healthcare fhir-stores update FHIR_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION ^ --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Antwort
Updated fhirStore [FHIR_STORE_ID]. name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID notificationConfig: pubsubTopic: projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID version: FHIR_STORE_VERSION
REST
Verwenden Sie zum Bearbeiten eines FHIR-Speichers die Methode projects.locations.datasets.fhirStores.patch
.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
ist die ID Ihres Google Cloud-ProjektsLOCATION
ist der Standort des DatasetsDATASET_ID
: das übergeordnete Dataset des FHIR-SpeichersFHIR_STORE_ID
: die FHIR-Speicher-IDPUBSUB_TOPIC_ID
: Ein Pub/Sub-Thema, in dem Nachrichten veröffentlicht werden, wenn ein Ereignis in einem Datenspeicher auftritt. Informationen dazu, welche Daten in Pub/Sub-Benachrichtigungen enthalten sein sollen, finden Sie unter FHIR Pub/Sub-BenachrichtigungenKEY1
ist der erste LabelschlüsselVALUE1
ist der erste LabelwertKEY2
ist der zweite LabelschlüsselVALUE2
ist der zweite Labelwert
JSON-Text der Anfrage:
{ "notificationConfigs": [ { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID" } ], "labels": { "KEY1": "VALUE1", "KEY2": "VALUE2" } }
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json
.
Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:
cat > request.json << 'EOF' { "notificationConfigs": [ { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID" } ], "labels": { "KEY1": "VALUE1", "KEY2": "VALUE2" } } EOF
Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID?updateMask=notificationConfig,labels"
PowerShell
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json
.
Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:
@' { "notificationConfigs": [ { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID" } ], "labels": { "KEY1": "VALUE1", "KEY2": "VALUE2" } } '@ | Out-File -FilePath request.json -Encoding utf8
Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID?updateMask=notificationConfig,labels" | Select-Object -Expand Content
APIs Explorer
Kopieren Sie den Anfragetext und öffnen Sie die Referenzseite für Methoden. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Fügen Sie den Anfragetext in dieses Tool ein, füllen Sie alle Pflichtfelder aus und klicken Sie auf Ausführen.
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
Go
Java
Node.js
Python
FHIR-Speicherdetails abrufen
In den folgenden Beispielen wird gezeigt, wie Sie Details zu einem FHIR-Speicher abrufen können.
Console
So sehen Sie sich die Details eines FHIR-Speichers an:
- Öffnen Sie in der Google Cloud Console die Seite der Datasets.
- Wählen Sie das Dataset mit dem FHIR-Speicher aus.
- Klicken Sie auf den Namen des FHIR-Speichers.
gcloud
Führen Sie den Befehl gcloud healthcare fhir-stores describe
aus, um Details zu einem FHIR-Speicher abzurufen.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
- LOCATION ist der Standort des Datasets
- DATASET_ID: das übergeordnete Dataset des FHIR-Speichers
- FHIR_STORE_ID: die FHIR-Speicher-ID
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud healthcare fhir-stores describe FHIR_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare fhir-stores describe FHIR_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare fhir-stores describe FHIR_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Wenn Sie in der Ressource FhirStore
Felder konfiguriert haben, werden diese auch in der Antwort angezeigt.
Antwort
... name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID ... version: FHIR_STORE_VERSION
REST
Details zu einem FHIR-Speicher erhalten Sie mit der Methode projects.locations.datasets.fhirStores.get
.
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: das übergeordnete Dataset des FHIR-Speichers
- FHIR_STORE_ID ist die FHIR-Speicher-ID
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Führen Sie folgenden Befehl aus:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID"
PowerShell
Führen Sie folgenden Befehl aus:
$cred = gcloud auth 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/fhirStores/FHIR_STORE_ID" | Select-Object -Expand Content
APIs Explorer
Öffnen Sie das 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.
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Wenn Sie in der Ressource FhirStore
Felder konfiguriert haben, werden diese auch in der Antwort angezeigt.
Go
Java
Node.js
Python
FHIR-Speicher in einem Dataset auflisten
In den folgenden Beispielen wird gezeigt, wie Sie die FHIR-Speicher in einem Dataset auflisten.
Console
So zeigen Sie die Datenspeicher in einem Dataset an:
- Rufen Sie in der Google Cloud Console die Seite Datasets auf.
- Wählen Sie das Dataset aus, das den Datenspeicher enthält, den Sie anzeigen möchten.
gcloud
Führen Sie den Befehl gcloud healthcare fhir-stores list
aus, um Details zu einem FHIR-Speicher anzuzeigen.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
- DATASET_ID ist das übergeordnete Dataset des FHIR-Speichers
- LOCATION ist der Standort des Datasets
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud healthcare fhir-stores list --dataset=DATASET_ID --location=LOCATION
Windows (PowerShell)
gcloud healthcare fhir-stores list --dataset=DATASET_ID --location=LOCATION
Windows (cmd.exe)
gcloud healthcare fhir-stores list --dataset=DATASET_ID --location=LOCATION
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Wenn Sie in der Ressource FhirStore
Felder konfiguriert haben, werden diese auch in der Antwort angezeigt.
ID LOCATION REF_INT RES_VER UPDATE_CREATE TOPIC FHIR_STORE_ID LOCATION PUBSUB_TOPIC ...
REST
Verwenden Sie die Methode projects.locations.datasets.fhirStores.list
, um die FHIR-Speicher in einem Dataset aufzulisten.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT_ID ist die ID Ihres Google Cloud-Projekts
- DATASET_ID ist das übergeordnete Dataset des FHIR-Speichers
- LOCATION ist der Standort des Datasets
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Führen Sie folgenden Befehl aus:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores"
PowerShell
Führen Sie folgenden Befehl aus:
$cred = gcloud auth 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/fhirStores" | Select-Object -Expand Content
APIs Explorer
Öffnen Sie das 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.
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Wenn Sie in der Ressource FhirStore
Felder konfiguriert haben, werden diese auch in der Antwort angezeigt.
Go
Java
Node.js
Python
Funktions- oder Konformitätserklärung für einen FHIR-Speicher abrufen
Die folgenden Beispiele zeigen, wie Sie die Funktionen (STU3 oder R4) oder Konformität (DSTU2) für einen FHIR-Speicher.
Die Informationen in den Funktionen oder der Konformitätserklärung spiegeln die Einstellungen im FHIR-Speicher wider. Wenn FhirStore.enableUpdateCreate
beispielsweise auf true
gesetzt ist, wird dies im Feld CapabilityStatement.rest.resource.updateCreate
der Capability-Anweisung angezeigt.
Die folgende Tabelle zeigt die Cloud Healthcare API-Methode zum Abrufen der Capabilities- oder Compliance-Anweisung für einen FHIR-Speicher und die entsprechende Interaktion mit der FHIR-Spezifikation:
Cloud Healthcare API-Methode | Interaktion mit der FHIR-Spezifikation |
---|---|
projects.locations.datasets.fhirStores.fhir.capabilities |
Funktionen (STU3 oder R4) oder conformance (DSTU2) |
Console
Die Google Cloud Console und die gcloud CLI unterstützen diese Aktion nicht. Verwenden Sie stattdessen curl
, PowerShell oder Ihre bevorzugte Sprache.
gcloud
Die Google Cloud Console und die gcloud CLI unterstützen diese Aktion nicht. Verwenden Sie stattdessen curl
, PowerShell oder Ihre bevorzugte Sprache.
REST
Verwenden Sie die Methode projects.locations.datasets.fhirStores.fhir.capabilities
, um die Funktionen oder die Konformitätserklärung für einen FHIR-Speicher abzurufen.
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: das übergeordnete Dataset des FHIR-Speichers
- FHIR_STORE_ID ist die FHIR-Speicher-ID
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Führen Sie folgenden Befehl aus:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/metadata"
PowerShell
Führen Sie folgenden Befehl aus:
$cred = gcloud auth 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/fhirStores/FHIR_STORE_ID/fhir/metadata" | Select-Object -Expand Content
APIs Explorer
Öffnen Sie das 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.
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
Go
Java
Node.js
Python
Grundlegende Validierungsebene der Ressourcen festlegen
Standardmäßig wird auf alle Ressourcen in Ihrem FHIR-Speicher eine Basisressourcenvalidierung angewendet. Diese Validierung gewährleistet, dass Folgendes bei der Erstellung der Ressource zutrifft:
- Alle Pflichtfelder sind definiert.
- Alle referenzierten Ressourcentypen sind gültig.
- Die Ressource erfüllt alle FHIRPath-Einschränkungen.
Sie können Ihre Basisressourcenvalidierung weniger streng machen, indem Sie einen oder mehrere dieser Arten von Basisressourcenvalidierung für Ihren FHIR-Speicher deaktivieren.
Console
Die Google Cloud Console und die gcloud CLI unterstützen diese Aktion nicht. Verwenden Sie stattdessen curl
, PowerShell oder Ihre bevorzugte Sprache.
gcloud
Die Google Cloud Console und die gcloud CLI unterstützen diese Aktion nicht. Verwenden Sie stattdessen curl
, PowerShell oder Ihre bevorzugte Sprache.
REST
Verwenden Sie die Methode projects.locations.datasets.fhirStores.patch
, um die Basisressourcenvalidierung in einem vorhandenen FHIR-Speicher zu deaktivieren.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT_ID ist die ID Ihres Google Cloud-Projekts
- DATASET_ID ist das übergeordnete Dataset des FHIR-Speichers
- LOCATION ist der Standort des Datasets
- BASE_RESOURCE_VALIDATION_TYPE ist der Basisvalidierungstyp für Ressourcen, den Sie deaktivieren möchten. Legen Sie eines der folgenden Felder auf
true
fest, um die Validierung zu deaktivieren:disableRequiredFieldValidation
disableReferenceTypeValidation
disableFhirpathValidation
JSON-Text der Anfrage:
{ "validationConfig": { "BASE_RESOURCE_VALIDATION_TYPE": true } }
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json
.
Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:
cat > request.json << 'EOF' { "validationConfig": { "BASE_RESOURCE_VALIDATION_TYPE": true } } EOF
Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID?updateMask=validationConfig"
PowerShell
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json
.
Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:
@' { "validationConfig": { "BASE_RESOURCE_VALIDATION_TYPE": true } } '@ | Out-File -FilePath request.json -Encoding utf8
Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID?updateMask=validationConfig" | Select-Object -Expand Content
APIs Explorer
Kopieren Sie den Anfragetext und öffnen Sie die Referenzseite für Methoden. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Fügen Sie den Anfragetext in dieses Tool ein, füllen Sie alle Pflichtfelder aus und klicken Sie auf Ausführen.
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Wenn Sie in der Ressource FhirStore
Felder konfiguriert haben, werden diese auch in der Antwort angezeigt.
FHIR-Speicher löschen
In den folgenden Beispielen wird gezeigt, wie Sie einen FHIR-Speicher löschen.
Console
So löschen Sie einen Datenspeicher:
- Öffnen Sie in der Google Cloud Console die Seite Datasets.
- Wählen Sie das Dataset aus, das den Datenspeicher enthält, den Sie löschen möchten.
- Wählen Sie in der Drop-down-Liste Aktionen für den Datenspeicher, den Sie löschen möchten, Löschen aus.
- 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 fhir-stores delete
aus, um einen FHIR-Speicher zu löschen:
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
- LOCATION ist der Standort des Datasets
- DATASET_ID: das übergeordnete Dataset des FHIR-Speichers
- FHIR_STORE_ID: die FHIR-Speicher-ID
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud healthcare fhir-stores delete FHIR_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare fhir-stores delete FHIR_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare fhir-stores delete FHIR_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Deleted fhirStore [FHIR_STORE_ID].
REST
Verwenden Sie zum Löschen eines FHIR-Speichers die Methode projects.locations.datasets.fhirStores.delete
.
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: das übergeordnete Dataset des FHIR-Speichers
- FHIR_STORE_ID ist die FHIR-Speicher-ID
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Führen Sie folgenden Befehl aus:
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID"
PowerShell
Führen Sie folgenden Befehl aus:
$cred = gcloud auth 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/fhirStores/FHIR_STORE_ID" | Select-Object -Expand Content
APIs Explorer
Öffnen Sie das 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.
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
Go
Java
Node.js
Python
Nächste Schritte
FHIR-Ressourcen erstellen und verwenden