Recupero dei codici con ValueSet $expand - AWS HealthLake
UtilizzoParametri supportatiEsempi

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à.

Recupero dei codici con ValueSet $expand

AWS HealthLake ora supporta l'$expandoperazione relativa ValueSets ai codici acquisiti da te come cliente, consentendoti di recuperare l'elenco completo dei codici contenuti in quelle ValueSet risorse. Questa operazione è particolarmente utile quando è necessario:

  • Recuperare tutti i codici possibili a scopo di convalida

  • Visualizza le opzioni disponibili nelle interfacce utente

  • Esegui ricerche complete di codice all'interno di un contesto terminologico specifico

Utilizzo

L'$expandoperazione può essere richiamata sulle ValueSet risorse utilizzando i metodi GET e POST:

Operazioni supportate

GET/POST [base]/ValueSet/[id]/$expand
GET [base]/ValueSet/$expand?url=http://example.com
POST [base]/ValueSet/$expand

Parametri supportati

HealthLake supporta un sottoinsieme di parametri FHIR R4: $expand

Parametro Tipo Campo obbligatorio Descrizione
url uri No URL canonico del file da espandere ValueSet
id id No ValueSet id della risorsa da espandere (per le operazioni GET o POST)
filter string No Filtra il risultato dell'espansione del codice
count integer No Numero di codici da restituire
offset integer No Numero di codici corrispondenti da saltare prima della restituzione. Si applica dopo il filtraggio e solo ai codici corrispondenti, non al contenuto completo e non filtrato dell'originale ValueSet

Esempi

GET Richiesta per ID

GET [base]/ValueSet/example-valueset/$expand
Richiesta GET per URL con filtro

GET [base]/ValueSet/$expand?url=http://example.com/ValueSet/my-valueset&filter=male&count=5
Richiesta POST con parametri (per ID)

POST [base]/ValueSet/example-valueset/$expand
Content-Type: application/fhir+json

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "count",
      "valueInteger": 10
    },
    {
      "name": "filter",
      "valueString": "admin"
    }
  ]
}
Richiesta POST con parametri (tramite URL)

POST [base]/ValueSet/$expand
Content-Type: application/fhir+json

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "url",
      "valueUri": "http://hl7.org/fhir/ValueSet/administrative-gender"
    },
    {
      "name": "count",
      "valueInteger": 10
    }
  ]
}
Risposta di esempio

L'operazione restituisce una ValueSet risorsa con un expansion elemento contenente i codici espansi:

{
  "resourceType": "ValueSet",
  "id": "administrative-gender",
  "status": "active",
  "expansion": {
    "identifier": "urn:uuid:12345678-1234-1234-1234-123456789abc",
    "timestamp": "2024-01-15T10:30:00Z",
    "total": 4,
    "parameter": [
      {
        "name": "count",
        "valueInteger": 10
      }
    ],
    "contains": [
      {
        "system": "http://hl7.org/fhir/administrative-gender",
        "code": "male",
        "display": "Male"
      },
      {
        "system": "http://hl7.org/fhir/administrative-gender",
        "code": "female",
        "display": "Female"
      },
      {
        "system": "http://hl7.org/fhir/administrative-gender",
        "code": "other",
        "display": "Other"
      },
      {
        "system": "http://hl7.org/fhir/administrative-gender",
        "code": "unknown",
        "display": "Unknown"
      }
    ]
  }
}

La risposta include:

  • expansion.total: numero totale di codici nell'espanso ValueSet

  • expansion.contains: matrice di codici espansi con i relativi valori di sistema, codice e visualizzazione

  • expansion.parameter: parametri utilizzati nella richiesta di espansione

Per ulteriori informazioni sulle specifiche $expand operative, consultate la documentazione FHIR R4. ValueSet $expand