SMART Base
0.1.0 - ci-build

SMART Base, published by WHO. This guide is not an authorized publication; it is the continuous build for version 0.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-base/tree/main and changes regularly. See the Directory of published versions

Resource Profile: SMART Guidelines StructureMap

Official URL: http://smart.who.int/base/StructureDefinition/SGStructureMap Version: 0.1.0
Draft as of 2025-03-31 Computable Name: SGStructureMap

Defines the minimum expectations for StructureMap resources used in SMART Guidelines

Usage:

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

NameFlagsCard.TypeDescription & Constraintsdoco
.. StructureMap C 0..* StructureMap A Map of relationships between 2 structures that can be used to transform data
dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources
dom-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
dom-5: If a resource is contained in another resource, it SHALL NOT have a security label
dom-6: A resource should have narrative for robust management
smp-0: Name should be usable as an identifier for the module by machine processing applications such as code generation
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
ele-1: All FHIR elements must have a @value or children
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
... url Σ 1..1 uri Canonical identifier for this structure map, represented as a URI (globally unique)
ele-1: All FHIR elements must have a @value or children
... name ΣC 1..1 string Name for this structure map (computer friendly)
ele-1: All FHIR elements must have a @value or children
... title Σ 1..1 string Name for this structure map (human friendly)
ele-1: All FHIR elements must have a @value or children
... status ?!Σ 1..1 code draft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.


ele-1: All FHIR elements must have a @value or children
... publisher Σ 1..1 string Name of the publisher (organization or individual)
ele-1: All FHIR elements must have a @value or children
... description 1..1 markdown Natural language description of the structure map
ele-1: All FHIR elements must have a @value or children
... group Σ 1..* BackboneElement Named sections for reader convenience
ele-1: All FHIR elements must have a @value or children
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
.... name Σ 1..1 id Human-readable label
ele-1: All FHIR elements must have a @value or children
.... typeMode Σ 1..1 code none | types | type-and-types
Binding: StructureMapGroupTypeMode (required): If this is the default rule set to apply for the source type, or this combination of types.


ele-1: All FHIR elements must have a @value or children
.... input Σ 1..* BackboneElement Named instance provided when invoking the map
ele-1: All FHIR elements must have a @value or children
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
..... name Σ 1..1 id Name for this instance of data
ele-1: All FHIR elements must have a @value or children
..... mode Σ 1..1 code source | target
Binding: StructureMapInputMode (required): Mode for this instance of data.


ele-1: All FHIR elements must have a @value or children
.... rule Σ 1..* BackboneElement Transform Rule from source to target
ele-1: All FHIR elements must have a @value or children
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
..... name Σ 1..1 id Name of the rule for internal references
ele-1: All FHIR elements must have a @value or children
..... source Σ 1..* BackboneElement Source inputs to the mapping
ele-1: All FHIR elements must have a @value or children
...... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
...... context Σ 1..1 id Type or variable this rule applies to
ele-1: All FHIR elements must have a @value or children

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
StructureMap.statusrequiredPublicationStatus
http://hl7.org/fhir/ValueSet/publication-status|4.0.1
from the FHIR Standard
StructureMap.group.typeModerequiredStructureMapGroupTypeMode
http://hl7.org/fhir/ValueSet/map-group-type-mode|4.0.1
from the FHIR Standard
StructureMap.group.input.moderequiredStructureMapInputMode
http://hl7.org/fhir/ValueSet/map-input-mode|4.0.1
from the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorStructureMapIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorStructureMapIf the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
: contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4errorStructureMapIf a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
: contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5errorStructureMapIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceStructureMapA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()
smp-0warningStructureMapName should be usable as an identifier for the module by machine processing applications such as code generation
: name.matches('[A-Z]([A-Za-z0-9_]){0,254}')

 

Other representations of profile: CSV, Excel, Schematron