Eine FHIR-Ressource erstellen - AWS HealthLake

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Eine FHIR-Ressource erstellen

Die create FHIR-Interaktion erstellt eine neue FHIR-Ressource in einem HealthLake Datenspeicher. Weitere Informationen finden Sie createin der FHIR RESTful R4-API-Dokumentation.

Um eine FHIR-Ressource zu erstellen

  1. Sammeln HealthLake region und datastoreId schätzen. Weitere Informationen finden Sie unter Eigenschaften des Datenspeichers abrufen.

  2. Ermitteln Sie den Typ der Resource zu erstellenden FHIR. Weitere Informationen finden Sie unter Ressourcentypen.

  3. Konstruieren Sie mithilfe der gesammelten Werte für HealthLake region und datastoreId eine URL für die Anfrage. Geben Sie auch den zu erstellenden Resource FHIR-Typ an. Scrollen Sie über die Schaltfläche Kopieren, um den gesamten URL-Pfad im folgenden Beispiel anzuzeigen.

    POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource

  4. Konstruieren Sie einen JSON-Hauptteil für die Anfrage und geben Sie die FHIR-Daten für die neue Ressource an. Für dieses Verfahren verwenden wir eine Patient FHIR-Ressource. Speichern Sie die Datei also unter. create-patient.json

    {
    "resourceType": "Patient",
    "identifier": [
        {
            "system": "urn:oid:1.2.36.146.595.217.0.1",
            "value": "12345"
        }
    ],
    "name": [
        {
            "family": "Silva",
            "given": [
                "Ana",
                "Carolina"
            ]
        }
    ],
    "gender": "female",
    "birthDate": "1992-02-10"
}

  5. Senden Sie die Anforderung . Die create FHIR-Interaktion verwendet eine POST Anfrage mit entweder AWS Signature Version 4 oder SMART bei der FHIR-Autorisierung. In den folgenden Beispielen wird eine Patient FHIR-Ressource entweder HealthLake mithilfe von curl oder der Konsole erstellt. HealthLake Scrollen Sie über die Schaltfläche Kopieren, um ein vollständiges Beispiel anzuzeigen.

    SigV4

    SigV4-Autorisierung

    curl --request POST \
  'https://healthlake.region.amazonaws.com/datastore/datastore-id/r4/Patient' \
  --aws-sigv4 'aws:amz:region:healthlake' \
  --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
  --header "x-amz-security-token:$AWS_SESSION_TOKEN" \
  --header 'Accept: application/json' \
  --data @create-patient.json
    SMART on FHIR

    Beispiel für die SMART-on-FHIR-Autorisierung für den IdentityProviderConfigurationDatentyp.

    {
    "AuthorizationStrategy": "SMART_ON_FHIR",
    "FineGrainedAuthorizationEnabled": true,
    "IdpLambdaArn": "arn:aws:lambda:your-region:your-account-id:function:your-lambda-name",
    "Metadata": "{\"issuer\":\"https://ehr.example.com\", \"jwks_uri\":\"https://ehr.example.com/.well-known/jwks.json\",\"authorization_endpoint\":\"https://ehr.example.com/auth/authorize\",\"token_endpoint\":\"https://ehr.token.com/auth/token\",\"token_endpoint_auth_methods_supported\":[\"client_secret_basic\",\"foo\"],\"grant_types_supported\":[\"client_credential\",\"foo\"],\"registration_endpoint\":\"https://ehr.example.com/auth/register\",\"scopes_supported\":[\"openId\",\"profile\",\"launch\"],\"response_types_supported\":[\"code\"],\"management_endpoint\":\"https://ehr.example.com/user/manage\",\"introspection_endpoint\":\"https://ehr.example.com/user/introspect\",\"revocation_endpoint\":\"https://ehr.example.com/user/revoke\",\"code_challenge_methods_supported\":[\"S256\"],\"capabilities\":[\"launch-ehr\",\"sso-openid-connect\",\"client-public\",\"permission-v2\"]}"
}

    Der Anrufer kann im Autorisierungs-Lambda Berechtigungen zuweisen. Weitere Informationen finden Sie unter OAuth 2.0-Bereiche.

    AWS Console
    Anmerkung

    Die HealthLake Konsole unterstützt nur die AWS SigV4-Autorisierung.

    1. Melden Sie sich auf der Seite „Abfrage ausführen“ in der HealthLake Konsole an.

    2. Treffen Sie im Abschnitt Abfrageeinstellungen die folgenden Optionen.

    • Datenspeicher-ID — Wählen Sie eine Datenspeicher-ID aus, um eine Abfragezeichenfolge zu generieren.

    • Abfragetyp — wählen SieCreate.

    • Ressourcentyp — wählen Sie den zu erstellenden FHIR-Ressourcentyp aus.

    • Hauptteil der Anfrage — Konstruieren Sie einen JSON-Hauptteil für die Anfrage und geben Sie die FHIR-Daten für die neue Ressource an.

    3. Wählen Sie Abfrage ausführen.
Konfiguration der Validierungsebene für die Ressourcenerstellung

Wenn Sie eine FHIR-Ressource erstellen, können Sie optional einen x-amzn-healthlake-fhir-validation-level HTTP-Header angeben, um eine Validierungsebene für die Ressource zu konfigurieren. AWS HealthLake unterstützt derzeit die folgenden Validierungsstufen:

  • strict: Ressourcen werden anhand des Profilelements der Ressource oder der R4-Spezifikation, falls kein Profil vorhanden ist, validiert. Dies ist die Standardvalidierungsebene für AWS HealthLake.

  • structure-only: Ressourcen werden anhand von R4 validiert, wobei alle referenzierten Profile ignoriert werden.

  • minimal: Ressourcen werden minimal validiert, wobei bestimmte R4-Regeln ignoriert werden. Ressourcen, die die erforderlichen Strukturprüfungen nicht bestehen, search/analytics werden aktualisiert und enthalten nun eine Warnung zur Prüfung.

Ressourcen, die mit der Mindestvalidierungsstufe erstellt wurden, können in einen Datenspeicher aufgenommen werden, obwohl die für die Suchindizierung erforderliche Überprüfung fehlgeschlagen ist. In diesem Fall werden die Ressourcen um eine Healthlake-spezifische Erweiterung erweitert, um die genannten Fehler zu dokumentieren:

{
    "url": "http://healthlake.amazonaws.com/fhir/StructureDefinition/validation-issue",
    "valueString": "{\"resourceType\":\"OperationOutcome\",\"issue\":[{\"severity\":\"error\",\"code\":\"processing\",\"details\":{\"text\":\"FHIR resource in payload failed FHIR validation rules.\"},\"diagnostics\":\"FHIR resource in payload failed FHIR validation rules.\"}]}"
}

Zusätzlich wird der folgende HTTP-Antwort-Header mit dem Wert „true“ hinzugefügt:

x-amzn-healthlake-validation-issues : true
Anmerkung

Die aufgenommenen Daten, die gemäß der R4-Spezifikation fehlerhaft formatiert sind, können möglicherweise nicht wie erwartet durchsucht werden, wenn diese Fehler vorliegen.