Récupération de ValueSet codes avec $expand - AWS HealthLake
UtilisationParamètres pris en chargeExemples

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Récupération de ValueSet codes avec $expand

AWS HealthLake prend désormais en charge les $expand opérations ValueSets que vous avez ingérées en tant que client, ce qui vous permet de récupérer la liste complète des codes contenus dans ces ValueSet ressources. Cette opération est particulièrement utile lorsque vous devez :

  • Récupérez tous les codes possibles à des fins de validation

  • Afficher les options disponibles dans les interfaces utilisateur

  • Effectuez des recherches de code complètes dans un contexte terminologique spécifique

Utilisation

L'$expandopération peut être invoquée sur les ValueSet ressources à l'aide des méthodes GET et POST :

Opérations prises en charge

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

Paramètres pris en charge

HealthLake prend en charge un sous-ensemble de paramètres FHIR $expand R4 :

Paramètre Type Obligatoire Description
url uri Non URL canonique du ValueSet à développer
id id Non ValueSet identifiant de ressource à étendre (pour les opérations GET ou POST)
filter chaîne Non Filtrer le résultat de l'extension du code
count entier Non Nombre de codes à retourner
offset entier Non Nombre de codes correspondants à ignorer avant de retourner. S'applique après le filtrage et uniquement aux codes correspondants, et non à l'intégralité du contenu non filtré de l'original ValueSet

Exemples

Demande GET par identifiant

GET [base]/ValueSet/example-valueset/$expand
Requête GET par URL avec filtre

GET [base]/ValueSet/$expand?url=http://example.com/ValueSet/my-valueset&filter=male&count=5
Requête POST avec paramètres (par ID)

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

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "count",
      "valueInteger": 10
    },
    {
      "name": "filter",
      "valueString": "admin"
    }
  ]
}
Requête POST avec paramètres (par 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
    }
  ]
}
Exemple de réponse

L'opération renvoie une ValueSet ressource avec un expansion élément contenant les codes développés :

{
  "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 réponse inclut :

  • expansion.total : nombre total de codes dans l'extension ValueSet

  • expansion.contains : tableau de codes étendus avec leur système, leur code et leurs valeurs d'affichage

  • expansion.parameter : paramètres utilisés dans la demande d'extension

Pour plus d'informations sur les spécifications de $expand fonctionnement, consultez la documentation du FHIR R4 ValueSet $expand.