List — Liste ordonnée de ressources
L'une des cinq ressources fondatrices de FHIR. Conteneur générique qui groupe des ressources d'un même domaine avec un ordre, un titre, un état de revue. Idéal pour les « problèmes actifs », « allergies connues », « médicaments en cours », worklists.
Objet de la ressource
Tandis que Bundle est un conteneur de transaction ou de réponse de recherche
(transitoire), List est un conteneur persistant qui modélise une liste de
travail métier. Une List a un titre, un statut (current / retired / entered-in-error),
un mode (snapshot / changes / working), une date de revue, une source. Elle peut être
ordonnée par priorité, alphabétiquement, par date.
Cas typiques : liste des problèmes actifs d'un patient (Problem List, LOINC 11450-4), liste des médicaments en cours (Medication List), liste des allergies, liste de consultations à honorer, file d'attente pré-op, batch de prélèvements.
Champs clés
| Champ | Type | Cardinalité | Rôle |
|---|---|---|---|
identifier | Identifier[] | 0..* | Identifiants externes. |
status | code | 1..1 | current, retired, entered-in-error. |
mode | code | 1..1 | working, snapshot, changes. |
title | string | 0..1 | Titre humain. |
code | CodeableConcept | 0..1 | Type sémantique (LOINC 11450-4 Problem List, etc.). |
subject | Reference(Any)[] | 0..* | Sujet (Patient le plus souvent). |
encounter | Reference(Encounter) | 0..1 | Encounter associé. |
date | dateTime | 0..1 | Date de création. |
source | Reference | 0..1 | Auteur (Practitioner, Patient, Device). |
orderedBy | CodeableConcept | 0..1 | Critère de tri. |
note | Annotation[] | 0..* | Notes générales. |
entry | BackboneElement[] | 0..* | Items. |
entry.flag | CodeableConcept | 0..1 | Flag de l'item (changement, urgence…). |
entry.deleted | boolean | 0..1 | Item supprimé (en mode changes). |
entry.date | dateTime | 0..1 | Date d'ajout/retrait. |
entry.item | Reference(Any) | 1..1 | Ressource pointée. |
emptyReason | CodeableConcept | 0..1 | Raison d'une liste vide (closed, nothing-known…). |
Exemple JSON
Problem List active d'un patient avec diabète, HTA, IRC stade 3 et un asthme infantile
résolu marqué deleted :
{
"resourceType": "List",
"id": "patient-active-problems",
"identifier": [{ "system": "http://example.org/lists", "value": "PROB-LIST-2026-001234" }],
"status": "current",
"mode": "snapshot",
"title": "Active problem list",
"code": {
"coding": [{
"system": "http://loinc.org",
"code": "11450-4",
"display": "Problem list"
}]
},
"subject": { "reference": "Patient/example" },
"encounter": { "reference": "Encounter/example-stay" },
"date": "2026-05-16T10:00:00+02:00",
"source": { "reference": "Practitioner/dr-jones" },
"orderedBy": {
"coding": [{
"system": "http://terminology.hl7.org/CodeSystem/list-order",
"code": "priority",
"display": "Sorted by priority"
}]
},
"entry": [{
"flag": {
"coding": [{
"system": "http://terminology.hl7.org/CodeSystem/list-item-flag",
"code": "01"
}]
},
"item": { "reference": "Condition/diabetes-type-2" }
}, {
"item": { "reference": "Condition/hypertension" }
}, {
"item": { "reference": "Condition/ckd-stage-3" }
}, {
"deleted": true,
"item": { "reference": "Condition/asthma-childhood-resolved" }
}],
"emptyReason": null
}Usages typiques
- Problem List : synthèse des comorbidités actives.
- Allergy List : regroupement d'AllergyIntolerance actives.
- Medication List : traitement en cours.
- Worklist clinique : file de consultations, files d'attente pré-op.
- Document de synthèse : section d'un Composition ou d'un IPS Summary.
- Différentiel diagnostic : candidat diagnostics à investiguer.
Pièges courants
- Mode mal choisi :
snapshotest immutable ;changestrace les ajouts/retraits ;workingest le mode édition courante. Choisir le bon mode pour éviter les versions ambiguës. - Liste vide sans
emptyReason: une liste vide sans raison ne distingue pas « rien à signaler » de « non documenté ». - Confusion List / Bundle / Composition : Bundle = transport. Composition = document persistant avec sections. List = regroupement métier réutilisable.
- Entry.deleted en mode snapshot : incohérent.
deletedn'a de sens qu'enchanges. - Code de liste non standardisé : utiliser LOINC pour Problem List (11450-4), Allergy List (48765-2), Medication List (10160-0).
Ressources liées
- Condition, AllergyIntolerance, MedicationStatement — items typiquement listés.
- Composition — section d'un document peut être une List.
- Bundle — peut transporter une List + ses items.
- Group — équivalent pour les cohortes statistiques.
Voir aussi : Bundle — conteneur de transaction et Composition — document structuré.