ExampleScenario — Scénario d'usage métier

La documentation pédagogique des Implementation Guides : acteurs, instances de ressources, process, alternatives. La « swimlane diagram » de FHIR.

Objet de la ressource

ExampleScenario décrit un scénario d'usage dans lequel des acteurs (Patient, Practitioner, EHR, app tierce) échangent des ressources FHIR. C'est l'équivalent FHIR d'un use-case rédigé, d'un BPMN ou d'un diagramme de séquence UML. Très utilisée par les IGs IHE, HL7 Da Vinci, et FHIR Connectathons pour cadrer les flux à tester.

Champs clés

Champ	Type	Cardinalité	Rôle
`url`	uri	0..1	URL canonique.
`identifier`	Identifier[]	0..*	Identifiants métier.
`version`	string	0..1	Version.
`name`	string	0..1	Nom technique.
`title`	string	0..1	Titre humain.
`status`	code	1..1	`draft \| active \| retired \| unknown`.
`actor`	BackboneElement[]	0..*	Acteurs du scénario.
`instance`	BackboneElement[]	0..*	Instances de ressources utilisées (versions au fil du process).
`process`	BackboneElement[]	0..*	Process principaux et leurs étapes (avec alternatives).

Exemple JSON

json examplescenario-example.json

{
  "resourceType": "ExampleScenario",
  "id": "example-admit-discharge",
  "url": "http://example.org/ExampleScenario/admit-discharge",
  "version": "5.0.0",
  "name": "AdmitDischargeScenario",
  "title": "Admission-Discharge Scenario",
  "status": "active",
  "actor": [{
    "key": "patient",
    "type": "person",
    "title": "The patient"
  }, {
    "key": "ed-nurse",
    "type": "person",
    "title": "Emergency department nurse"
  }],
  "instance": [{
    "key": "patient-resource",
    "structureType": {
      "coding": [{
        "system": "http://hl7.org/fhir/fhir-types",
        "code": "Patient"
      }]
    },
    "title": "Patient resource at admission"
  }],
  "process": [{
    "title": "Patient admission",
    "step": [{
      "process": [{
        "title": "Create Patient",
        "description": "Nurse creates Patient resource on admission."
      }]
    }]
  }]
}

Pièges courants

Acteur sans key — les références internes ne fonctionnent pas.
Step sans process ni operation — l'étape ne raconte rien.
Instance sans structureType — l'outil de rendu ne sait pas de quel type FHIR il s'agit.

Fondamentaux

Standards

Messages phares

Outils