Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

FHIR-Profile aktivieren

Auf dieser Seite wird erläutert, wie Sie FHIR-Implementierungsleitfäden und Profile in FHIR-Speicher importieren und aktivieren.

Übersicht

FHIR-Profile sind eine Reihe zusätzlicher Regeln, die auf der FHIR-Basisspezifikation definiert sind und mit der verfahren, wie verschiedene Gesundheitssysteme Ressourcen verarbeiten. FHIR-Profile können importiert und in einem FHIR-Speicher aktiviert werden, um dafür zu sorgen, dass alle Ressourcen in einem FHIR-Speicher bestimmte Kriterien für die Ressourcenstruktur und erfasste Informationen erfüllen.

Sie können FHIR-Profile für Ihren FHIR-Speicher importieren, indem Sie eine oder mehrere Strukturdefinitionen zusammengefasst in einen oder mehrere Implementierungsleitfäden einfügen. Eine Strukturdefinition definiert die Einschränkungen für ein Feld in einer FHIR-Ressource. Strukturdefinitionen verweisen auch auf Wertesätze, die Codesysteme und FHIR-Ressourcen verknüpfen. Im Implementierungsleitfaden können Sie diese Strukturdefinitionen verwenden, um Ressourcen zu validieren, damit sie mit dem Anwendungsfall Ihrer Drittanbieter-Software übereinstimmen.

Beispielsweise kann es sein, dass Ihre Drittanbieter-Software die Interoperabilität mit den Centers for Medicare & Medicaid Services (CMS) und den Zugriff auf Patientendaten in den USA erfüllt, indem sie eine Patientenzugriff-API bereitstellen, die den { 101}CARIN-Profile auf. Sie können den CARIN-Implementierungsleitfaden in Ihren FHIR-Speicher importieren und aktivieren, um die Ressourcen mit den CARIN-Profilen zu validieren. Das Importieren und Aktivieren von Implementierungsanleitungen wird in den folgenden Abschnitten auf dieser Seite beschrieben.

Nachdem Sie den Implementierungsleitfaden importiert haben, können Sie ihn in Ihrem FHIR-Speicher für die Ressourcenvalidierung aktivieren. Beim Aktualisieren einer Ressource oder dem Hinzufügen zu diesem Speicher wird geprüft, ob sie einer Strukturdefinition im Implementierungsleitfaden entspricht. Ist dies der Fall, wird die Ressource dem Speicher hinzugefügt. Wenn die Ressource nicht den Strukturdefinitionen im Implementierungsleitfaden entspricht, wird eine Fehlermeldung zurückgegeben und die Ressource abgelehnt.

Die Datenvalidierung wird erzwungen, wenn Sie die folgenden Methoden verwenden:

Workflow zur Profilvalidierung

Das folgende Diagramm zeigt den Validierungsworkflow zum Hinzufügen oder Aktualisieren von FHIR-Ressourcen:

fhir-Profile

FHIR-Profile definieren

In den folgenden Abschnitten wird beschrieben, wie Sie Strukturdefinitionen aus Ihrer Drittanbieter-Software herunterladen und einen Implementierungsleitfaden konfigurieren.

Strukturdefinitionen herunterladen

Laden Sie die Strukturdefinitionen, Implementierungsleitfäden und Wertsätze Ihres externen Softwareanbieters herunter, damit Ihre Strukturdefinitionen mit der autoritativen Quelle übereinstimmen.

Wenn Ihr System z. B. das fehlerhafte Profil Blaue Schaltfläche verwendet, können Sie die von Blue Button verwendeten Strukturdefinitionen und Implementierungsanleitung herunterladen.

Die Cloud Healthcare API ermöglicht die Validierung der folgenden Arten von Strukturdefinitionsregeln:

  • Partitionierung (im Typ value oder pattern)
  • min/max
  • Typ
  • fixed
  • Muster
  • minValue
  • maxValue
  • maxLength
  • Bindung

Implementierungsleitfaden konfigurieren

Nachdem Sie Ihre Strukturdefinitionen, den Implementierungsleitfaden und den Wertsatz heruntergeladen haben, müssen Sie die Profile hinzufügen, die im Implementierungsleitfaden validiert werden.

Führen Sie die folgenden Schritte aus, um Ihren Implementierungsleitfaden zur Verwendung in Ihrem FHIR-Speicher zu konfigurieren:

  1. Öffnen Sie die Datei mit dem Implementierungsleitfadens, die Sie von Ihrem Softwareanbieter heruntergeladen haben.

  2. Fügen Sie den folgenden Abschnitt hinzu, um die Strukturdefinitionen anzugeben, die Sie in Ihrem Implementierungsleitfaden validieren möchten:

    {
        "resourceType": "ImplementationGuide",
        ...
        "global": [
            {
            "type": "RESOURCE_TYPE",
            "profile": "STRUCTURE_DEFINITION_URL"
            }
        ]
        ...
    }
    

    Definieren Sie in diesem Beispiel Folgendes:

    • type definiert den Ressourcentyp.
    • profile ist mit der Definition der Quellstruktur des Profils verknüpft.
  3. Speichern Sie die Datei mit dem Implementierungsleitfaden.

Implementierungsleitfaden in Cloud Storage hochladen

Nachdem Sie den Implementierungsleitfaden bearbeitet haben, müssen Sie den Implementierungsleitfaden, Strukturdefinitionen und Wertsets zu Cloud Storage hinzufügen, damit sie zur Validierung von Ressourcen in Ihrem FHIR-Speicher verwendet werden können. Führen Sie die folgenden Befehle aus, um den Implementierungsleitfaden, Strukturdefinitionen und Wertsätze in Cloud Storage hinzuzufügen:

gsutil cp -r \
   PATH_TO_IMPLEMENTATION_GUIDE \
   gs://BUCKET/IMPLEMENTATION_GUIDE

Implementierungsleitfaden importieren

Damit Sie mit dem Implementierungsleitfaden Profile in Ihrem FHIR-Speicher validieren können, müssen Sie ihn als Ressource in Ihren Speicher importieren.

Die folgenden Beispiele zeigen, wie Sie den Implementierungsleitfaden in einen FHIR-Speicher importieren:

gcloud

Führen Sie den Befehl gcloud healthcare fhir-stores import gcs aus, um Ihren Implementierungsleitfaden als Ressource zu einem FHIR-Speicher hinzuzufügen.

Das folgende Beispiel zeigt, wie Sie den Implementierungsleitfaden zu einem FHIR-Speicher hinzufügen.

gcloud healthcare fhir-stores import gcs FHIR_STORE_ID \
  --dataset=DATASET_ID \
  --gcs-uri=gs://BUCKET/DIRECTORY/*

API

curl

Um Ihren Implementierungsleitfaden als Ressource zu einem FHIR-Speicher hinzuzufügen, senden Sie eine POST-Anfrage und geben Sie die folgenden Informationen an:

  • Name und Speicherort des übergeordneten Datasets
  • Der Name des FHIR-Speichers
  • Speicherort des Implementierungsleitfadens in einem Cloud Storage-Bucket

Das folgende Beispiel zeigt eine POST-Anfrage mit curl.

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    --data '{
      "contentStructure": "RESOURCE_PRETTY",
      "gcsSource": {
        "uri": "gs://BUCKET/DIRECTORY/*"
      }
    }' "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID:import"

Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"
}

PowerShell

Um Ihren Implementierungsleitfaden als Ressource zu einem FHIR-Speicher hinzuzufügen, senden Sie eine POST-Anfrage und geben Sie die folgenden Informationen an:

  • Name und Speicherort des übergeordneten Datasets
  • Der Name des FHIR-Speichers
  • Speicherort des Implementierungsleitfadens in einem Cloud Storage-Bucket

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" `
  -Body '{
    "contentStructure": "RESOURCE_PRETTY",
    "gcsSource": {
      "uri": "gs://BUCKET/DIRECTORY/*"
    }
  }' `
  -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID:import" | 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/operations/OPERATION_ID"
}

Implementierungsleitfaden aktivieren

Wenn Sie Profile mit einer Implementierungsanleitung validieren möchten, müssen Sie den Implementierungsleitfaden für die Validierung aktivieren. Wenn Sie mehr als einen Implementierungsleitfaden aktivieren, werden diese Anleitungen gemeinsam angewendet und eine Ressource muss nur mit einem Profil aus einem aktivierten Implementierungsleitfaden übereinstimmen.

Die folgenden Beispiele zeigen, wie Sie den Implementierungsleitfaden für die Profilvalidierung aktivieren:

curl

Um den Implementierungsleitfaden zu aktivieren , stellen Sie eine PATCH-Anfrage und geben Sie die folgenden Informationen an:

  • Name und Speicherort des übergeordneten Datasets
  • Der Name des FHIR-Speichers
  • Das Feld enabledImplementationGuides ist auf den Pfad zu Ihrer Implementierungsanleitungsressource eingestellt.

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/fhir+json;charset=utf-8" \
    --data '{
      "validationConfig": {
          "enabledImplementationGuides": ["IMPLEMENTATION_GUIDE_URL"]
      }
    }' "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID?updateMask=validationConfig"

Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID",
  "validationConfig": {
    "enabledImplementationGuides": ["IMPLEMENTATION_GUIDE_URL"],
    "disableProfileValidation": false
  }
}

PowerShell

Um den Implementierungsleitfaden zu aktivieren , stellen Sie eine PATCH-Anfrage und geben Sie die folgenden Informationen an:

  • Name und Speicherort des übergeordneten Datasets
  • Der Name des FHIR-Speichers
  • Das Feld enabledImplementationGuides ist auf den Pfad zu Ihrer Implementierungsanleitungsressource eingestellt.

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 '{
      "validationConfig": {
          "enabledImplementationGuides": ["IMPLEMENTATION_GUIDE_URL"],
          "disableProfileValidation": false
      }
  }' `
  -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID?updateMask=validationConfig" | 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/fhirStores/FHIR_STORE_ID",
  "validationConfig": {
    "enabledImplementationGuides": ["IMPLEMENTATION_GUIDE_URL"]
    "disableProfileValidation": false
  },
}