FHIR Clinical Guidelines (v1.0.0) (STU1)

This page is part of the Clinical Guidelines (v1.0.0: STU 1) based on FHIR R4. This is the current published version in it's permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions

D.4.1 StructureDefinition-cpg-groupdefinition

Introduction:

Examples:

D.4.1.1 Formal Views of Profile Content

The official URL for this profile is:

http://hl7.org/fhir/uv/cpg/StructureDefinition/cpg-groupdefinition

Represents the definition of a group of subjects, suitable for use in various contexts, such as a cohort definition, a recommendation inclusion or exclusion criteria, the members of a study, or a population criteria

This profile builds on Group.

This profile was published on Thu Jun 06 00:00:00 UTC 2019 as a draft by Health Level Seven, Inc. - CDS WG.

Description of Profiles, Differentials, and Snapshots.

Summary

Mandatory: 1 element
Must-Support: 8 elements
Fixed Value: 2 elements
Prohibited: 1 element

Extensions

This structure refers to these extensions:

NameFlagsCard.TypeDescription & Constraintsdoco
.. Group I0..*GroupGroup of multiple entities
gdf-1: Group definition must have either an expression or characteristics, but not both
... cqf-expression SI0..1ExpressionAn dynamic expression
URL: http://hl7.org/fhir/StructureDefinition/cqf-expression
... identifier S0..*IdentifierUnique id
... active S0..1booleanWhether this group's record is in active use
... type S1..1codeperson | animal | practitioner | device | medication | substance
Fixed Value: person
... actual S1..1booleanDescriptive or actual
Fixed Value: false
... code S0..1CodeableConceptKind of Group members
... name S1..1stringLabel for Group
... characteristic SI0..*BackboneElementInclude / Exclude group members by Trait
... member 0..0

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. Group I0..*GroupGroup of multiple entities
gdf-1: Group definition must have either an expression or characteristics, but not both
... id Σ0..1stringLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: CommonLanguages (preferred)
Max Binding: AllLanguages: A human language.

... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... cqf-expression SI0..1ExpressionAn dynamic expression
URL: http://hl7.org/fhir/StructureDefinition/cqf-expression
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier SΣ0..*IdentifierUnique id
... active SΣ0..1booleanWhether this group's record is in active use
... type SΣ1..1codeperson | animal | practitioner | device | medication | substance
Binding: GroupType (required): Types of resources that are part of group.


Fixed Value: person
... actual SΣI1..1booleanDescriptive or actual
Fixed Value: false
... code SΣ0..1CodeableConceptKind of Group members
Binding: (unbound) (example): Kind of particular resource; e.g. cow, syringe, lake, etc.

... name SΣ1..1stringLabel for Group
... quantity Σ0..1unsignedIntNumber of members
... managingEntity Σ0..1Reference(Organization | RelatedPerson | Practitioner | PractitionerRole)Entity that is the custodian of the Group's definition
... characteristic SI0..*BackboneElementInclude / Exclude group members by Trait
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... code 1..1CodeableConceptKind of characteristic
Binding: (unbound) (example): List of characteristics used to describe group members; e.g. gender, age, owner, location, etc.

.... value[x] 1..1Value held by characteristic
Binding: (unbound) (example): Value of descriptive member characteristic; e.g. red, male, pneumonia, Caucasian, etc.

..... valueCodeableConceptCodeableConcept
..... valueBooleanboolean
..... valueQuantityQuantity
..... valueRangeRange
..... valueReferenceReference(Any)
.... exclude 1..1booleanGroup includes or excludes
.... period 0..1PeriodPeriod over which characteristic is tested

doco Documentation for this format

Summary

Mandatory: 1 element
Must-Support: 8 elements
Fixed Value: 2 elements
Prohibited: 1 element

Extensions

This structure refers to these extensions:

Differential View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Group I0..*GroupGroup of multiple entities
gdf-1: Group definition must have either an expression or characteristics, but not both
... cqf-expression SI0..1ExpressionAn dynamic expression
URL: http://hl7.org/fhir/StructureDefinition/cqf-expression
... identifier S0..*IdentifierUnique id
... active S0..1booleanWhether this group's record is in active use
... type S1..1codeperson | animal | practitioner | device | medication | substance
Fixed Value: person
... actual S1..1booleanDescriptive or actual
Fixed Value: false
... code S0..1CodeableConceptKind of Group members
... name S1..1stringLabel for Group
... characteristic SI0..*BackboneElementInclude / Exclude group members by Trait
... member 0..0

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Group I0..*GroupGroup of multiple entities
gdf-1: Group definition must have either an expression or characteristics, but not both
... id Σ0..1stringLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: CommonLanguages (preferred)
Max Binding: AllLanguages: A human language.

... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... cqf-expression SI0..1ExpressionAn dynamic expression
URL: http://hl7.org/fhir/StructureDefinition/cqf-expression
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier SΣ0..*IdentifierUnique id
... active SΣ0..1booleanWhether this group's record is in active use
... type SΣ1..1codeperson | animal | practitioner | device | medication | substance
Binding: GroupType (required): Types of resources that are part of group.


Fixed Value: person
... actual SΣI1..1booleanDescriptive or actual
Fixed Value: false
... code SΣ0..1CodeableConceptKind of Group members
Binding: (unbound) (example): Kind of particular resource; e.g. cow, syringe, lake, etc.

... name SΣ1..1stringLabel for Group
... quantity Σ0..1unsignedIntNumber of members
... managingEntity Σ0..1Reference(Organization | RelatedPerson | Practitioner | PractitionerRole)Entity that is the custodian of the Group's definition
... characteristic SI0..*BackboneElementInclude / Exclude group members by Trait
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... code 1..1CodeableConceptKind of characteristic
Binding: (unbound) (example): List of characteristics used to describe group members; e.g. gender, age, owner, location, etc.

.... value[x] 1..1Value held by characteristic
Binding: (unbound) (example): Value of descriptive member characteristic; e.g. red, male, pneumonia, Caucasian, etc.

..... valueCodeableConceptCodeableConcept
..... valueBooleanboolean
..... valueQuantityQuantity
..... valueRangeRange
..... valueReferenceReference(Any)
.... exclude 1..1booleanGroup includes or excludes
.... period 0..1PeriodPeriod over which characteristic is tested

doco Documentation for this format

 

D.4.1.2 Terminology Bindings

Terminology Bindings

PathConformanceValueSet / Code
Group.languagepreferredCommonLanguages
Max Binding: AllLanguages
Group.typerequiredFixed Value: person
Group.codeexample
Group.characteristic.codeexample
Group.characteristic.value[x]example

D.4.1.3 Constraints

Constraints

IdPathDetailsRequirements
dom-2GroupIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3GroupIf 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-4GroupIf 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-5GroupIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6GroupA resource should have narrative for robust management
: text.`div`.exists()
grp-1GroupCan only have members if group is "actual"
: member.empty() or (actual = true)
gdf-1GroupGroup definition must have either an expression or characteristics, but not both
: extension('http://hl7.org/fhir/StructureDefinition/cqf-expression').exists() xor characteristic.exists()
ele-1Group.metaAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Group.implicitRulesAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Group.languageAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Group.textAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Group.extensionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Group.extensionMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Group.extension:expressionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Group.extension:expressionMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Group.modifierExtensionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Group.modifierExtensionMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Group.identifierAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Group.activeAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Group.typeAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Group.actualAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Group.codeAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Group.nameAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Group.quantityAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Group.managingEntityAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Group.characteristicAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Group.characteristic.extensionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Group.characteristic.extensionMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Group.characteristic.modifierExtensionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Group.characteristic.modifierExtensionMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Group.characteristic.codeAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Group.characteristic.value[x]All FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Group.characteristic.excludeAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Group.characteristic.periodAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Group.member.extensionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Group.member.extensionMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Group.member.modifierExtensionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Group.member.modifierExtensionMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Group.member.entityAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Group.member.periodAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Group.member.inactiveAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())