SMART Guidelines L3 SOP
1.1.0 - ci-build International flag

SMART Guidelines L3 SOP, published by WHO. This guide is not an authorized publication; it is the continuous build for version 1.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/WorldHealthOrganization/smart-ig-starter-kit and changes regularly. See the Directory of published versions

User Scenarios

Scenarios are uniquely identified “example stories” that describe how the system is expected to behave in a relatively concrete scenario.

Each Scenario is defined by the following data:

Scenarioidentifier 1..*status 1..1name 1..1title 1..1description 1..1actor 1..*step 1..1initiator 0..1receiver 0..1activity 0..1description 0..1Data needsfor scenarios(seelegend)

Inputs

  • L2 scenarios in narrative form

Outputs

  • ExampleScenarios in input/scenarios
  • One FSH file per ExampleScenario in input/fsh/scenarios

Activities


Summary: From each L2 Use Case, the L3 author creates an ExampleScenario. Ideally some example data (resources) are also added.

  • Check input scenarios - the L2 should contain identifiable, well-defined and well-delimited scenario descriptions. these should be rather concrete - i.e. not high abstractions, but concrete to a specific context.
  • Develop ExampleScenario resources

Output Criteria / Definition of Done

  • Each User Scenario in the L2 should be covered by one or more ExampleScenarios
    • At least the “normal” flow shall be covered by an example scenario
  • ExampleScenarios should reference the example instances from the other resources (see profiles, decision tables, forms, indicators)
  • ExampleScenarios should be validated by the publisher (i.e. no QA issues)
  • ExampleScenarios should be reviewed by the L2 author

Change tracking

As with all FHIR Conformance resources, change management is critical. Do not set the version element of ExampleScenarios defined in the SMART Guideline, the version element will be set by the publication process. See the versioning topic for more information on change management.

Tooling

Tool Usage Doc
Sushi New ExampleScenarios can be created in FSH syntax HL7 Spec
Sushi Documentation

Informative examples

Known issues and dependencies