Parameters — Conteneur de paramètres d'opération
Parameters n'est pas une ressource au sens classique (pas de search, pas de history). C'est le format pivot pour passer des arguments aux opérations FHIR $.
Objet de la ressource
Parameters porte une collection nommée de valeurs typées et/ou de ressources. Sert d'entrée à $validate, $expand, $everything, $lookup et plus largement à toute opération définie par OperationDefinition. Sert aussi de sortie quand l'opération retourne plusieurs valeurs.
Champs clés
| Champ | Type | Cardinalité | Rôle |
|---|---|---|---|
parameter | BackboneElement[] | 0..* | Named parameter list. |
parameter.name | string | 1..1 | Parameter name. |
parameter.value[x] | any data type | 0..1 | Typed primitive value (valueString, valueDate, valueQuantity...). |
parameter.resource | Resource | 0..1 | Embedded resource value. |
parameter.part | BackboneElement[] | 0..* | Nested parameters (composite). |
Exemple JSON
Paramètres pour Patient/$everything avec dates :
{
"resourceType": "Parameters",
"parameter": [{
"name": "patient",
"resource": {
"resourceType": "Patient",
"id": "example",
"name": [{ "family": "Doe", "given": ["John"] }]
}
}, {
"name": "start",
"valueDate": "2026-01-01"
}, {
"name": "end",
"valueDate": "2026-12-31"
}]
} Pièges courants
- Stocké en BDD comme une ressource : Parameters NE doit PAS être persisté. C'est un message d'opération.
- Cardinalité de
parameter: l'OperationDefinition impose des cardinalités ; les violer renvoie 400 côté serveur. - Mélange value[x] / resource / part : un seul des trois par
parameter.
Ressources liées
- OperationDefinition — Définit les paramètres attendus.
- OperationOutcome — Résultat d'opération.
- Bundle — Pour transactions et search batch (autre conteneur).