Creazione di una risorsa FHIR - AWS HealthLake

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Creazione di una risorsa FHIR

L'createinterazione FHIR crea una nuova risorsa FHIR in un HealthLake archivio dati. Per ulteriori informazioni, consulta la documentazione dell'createAPI FHIR RESTful R4.

Per creare una risorsa FHIR

  1. Colleziona HealthLake region e datastoreId valorizza. Per ulteriori informazioni, consulta Ottenere le proprietà dell'archivio dati.

  2. Determina il tipo di FHIR Resource da creare. Per ulteriori informazioni, consulta Tipi di risorsa.

  3. Costruisci un URL per la richiesta utilizzando i valori raccolti per HealthLake region e. datastoreId Includi anche il Resource tipo FHIR da creare. Per visualizzare l'intero percorso dell'URL nell'esempio seguente, scorri il pulsante Copia.

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

  4. Costruisci un corpo JSON per la richiesta, specificando i dati FHIR per la nuova risorsa. Ai fini di questa procedura, stiamo usando una Patient risorsa FHIR, quindi salva il file con nome. 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. Inviare la richiesta . L'createinterazione FHIR utilizza una POST richiesta con autorizzazione AWS Signature Version 4 o SMART on FHIR. Gli esempi seguenti creano una Patient risorsa FHIR HealthLake utilizzando curl o la Console. HealthLake Per visualizzare un intero esempio, scorri il pulsante Copia.

    SigV4

    Autorizzazione SIGv4

    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

    Esempio di autorizzazione SMART on FHIR per il tipo di dati IdentityProviderConfiguration.

    {
    "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\"]}"
}

    Il chiamante può assegnare le autorizzazioni nella lambda di autorizzazione. Per ulteriori informazioni, consulta OAuth Cannocchiali 2.0.

    AWS Console
    Nota

    La HealthLake console supporta solo l'autorizzazione SigV4.AWS

    1. Accedi alla pagina Esegui interrogazione sulla Console. HealthLake

    2. Nella sezione Impostazioni della query, effettua le seguenti selezioni.

    • Data Store ID: scegli un ID del data store per generare una stringa di query.

    • Tipo di query: scegliCreate.

    • Tipo di risorsa: scegli il tipo di risorsa FHIR da creare.

    • Corpo della richiesta: crea un corpo JSON per la richiesta, specificando i dati FHIR per la nuova risorsa.

    3. Scegli Esegui query.
Configurazione del livello di convalida per la creazione di risorse

Quando si crea una risorsa FHIR, è possibile specificare facoltativamente un'intestazione x-amzn-healthlake-fhir-validation-level HTTP per configurare un livello di convalida per la risorsa. AWS HealthLake attualmente supporta i seguenti livelli di convalida:

  • strict: Le risorse vengono convalidate in base all'elemento del profilo della risorsa o alla specifica R4 se non è presente alcun profilo. Questo è il livello di convalida predefinito per. AWS HealthLake

  • structure-only: Le risorse vengono convalidate rispetto a R4, ignorando i profili di riferimento.

  • minimal: Le risorse vengono convalidate minimamente, ignorando alcune regole R4. Le risorse che non superano i controlli di struttura richiesti search/analytics verranno aggiornate per includere un avviso per l'audit.

Le risorse create con il livello di convalida minimo possono essere inserite in un Datastore nonostante la mancata convalida richiesta per l'indicizzazione della ricerca. In questo caso, le risorse verranno aggiornate per includere un'estensione specifica di Healthlake per documentare tali errori:

{
    "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.\"}]}"
}

Inoltre, la seguente intestazione di risposta HTTP verrà inclusa con il valore «true»:

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

I dati inseriti che presentano un formato errato secondo la specifica R4 potrebbero non essere ricercabili come previsto se sono presenti questi errori.