This is the Continuous Integration Build of FHIR (will be incorrect/inconsistent at times).
See the Directory of published versions
FHIR Infrastructure Work Group | Maturity Level: 3 | Trial Use | Security Category: Business | Compartments: Device, Patient, Practitioner |
Represents a defined collection of entities that may be discussed or acted upon collectively but which are not expected to act collectively, and are not formally or legally recognized; i.e. a collection of entities that isn't an Organization.
The Group resource is used in one of two ways:
Examples of the former could include a family, a household, or group therapy or treatment sessions, exposed entities tracked as part of public health, etc. The latter might be used to define expected subjects for a clinical study.
Both use cases are handled by a single resource because the data elements captured tend to be similar.
NOTE: While Specimen does not quite fit with this definition, it is being retained as part of Group to avoid making a breaking change to the Observation resource.
There are a number of mechanisms in FHIR for communicating collections of resources:
contained
element - allows multiple resources to be nested
inside any DomainResource. This is a special type of grouping where the grouped resources lose independent existence - they
no longer have their own identifiers, can't easily be queried independently, etc. Use of this grouping is a technical
mechanism for managing the independence of resources and has no impact on meaning.
Structure
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Group | TU | DomainResource | Group of multiple entities + Rule: Group.type SHALL be defined if Group.membership is either 'definitional' or 'enumerated' Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension Interfaces Implemented: CanonicalResource | |
url | ΣC | 0..1 | uri | Canonical identifier for this Group, represented as an absolute URI (globally unique) + Warning: URL should not contain | or # - these characters make processing canonical references problematic |
identifier | Σ | 0..* | Identifier | Business Identifier for this Group |
version | Σ | 0..1 | string | Business version of the Group |
versionAlgorithm[x] | Σ | 0..1 | How to compare versions Binding: Version Algorithm (Extensible) | |
versionAlgorithmString | string | |||
versionAlgorithmCoding | Coding | |||
name | Σ | 0..1 | string | Label for Group |
title | Σ | 0..1 | string | Name for this Group (human friendly) |
status | ?!Σ | 0..1 | code | draft | active | retired | unknown Binding: PublicationStatus (Required) |
experimental | Σ | 0..1 | boolean | For testing purposes, not real usage |
date | Σ | 0..1 | dateTime | Date last changed |
publisher | Σ | 0..1 | string | Name of the publisher/steward (organization or individual) |
contact | Σ | 0..* | ContactDetail | Contact details for the publisher |
description | 0..1 | markdown | Natural language description of the group | |
useContext | Σ | 0..* | UsageContext | The context that the content is intended to support |
purpose | 0..1 | markdown | Why this Group is defined | |
copyright | 0..1 | markdown | Use and/or publishing restrictions | |
copyrightLabel | T | 0..1 | string | Copyright holder and year(s) |
type | Σ | 0..1 | code | person | animal | practitioner | device | careteam | healthcareservice | location | organization | relatedperson | specimen Binding: Group Type (Required) |
membership | Σ | 1..1 | code | definitional | conceptual | enumerated Binding: Group Membership Basis (Required) |
code | Σ | 0..1 | CodeableConcept | Use of the Group (and by implication, kind of members) Binding: Group Code (Extensible) |
quantity | Σ | 0..1 | unsignedInt | Number of members |
managingEntity | Σ | 0..1 | Reference(Organization | RelatedPerson | Practitioner | PractitionerRole) | Entity that is the custodian of the Group's definition |
combinationMethod | ?!Σ | 0..1 | code | all-of | any-of | at-least | at-most | except-subset Binding: Group Characteristic Combination (Required) |
combinationThreshold | 0..1 | positiveInt | Provides the value of "n" when "at-least" or "at-most" codes are used | |
characteristic | Σ | 0..* | BackboneElement | Include / Exclude group members by Trait |
code | Σ | 1..1 | CodeableConcept | Kind of characteristic Binding: GroupCharacteristicKind (Example) |
value[x] | Σ | 1..1 | Value held by characteristic Binding: GroupCharacteristicValue (Example) | |
valueCodeableConcept | CodeableConcept | |||
valueBoolean | boolean | |||
valueQuantity | Quantity | |||
valueRange | Range | |||
valueReference | Reference() | |||
valueUri | uri | |||
valueExpression | Expression | |||
exclude | Σ | 1..1 | boolean | Group includes or excludes |
description | 0..1 | markdown | Natural language description of the characteristic | |
method | 0..* | CodeableConcept | Method for how the characteristic value was determined Binding: Definition Method (Example) | |
determinedBy[x] | 0..1 | Defines the characteristic | ||
determinedByReference | Reference(Device | DeviceDefinition | DeviceMetric) | |||
determinedByExpression | Expression | |||
offset | ?!Σ | 0..1 | CodeableConcept | Reference point for comparison Binding: Characteristic Offset (Example) |
instances[x] | 0..1 | Number of occurrences meeting the characteristic | ||
instancesQuantity | Quantity | |||
instancesRange | Range | |||
duration[x] | 0..1 | Length of time in which the characteristic is met | ||
durationDuration | Duration | |||
durationRange | Range | |||
period | 0..1 | Period | Period over which characteristic is tested | |
timing | 0..* | RelativeTime | Timing in which the characteristic is determined | |
member | 0..* | BackboneElement | Who or what is in group | |
entity | 1..1 | Reference(CareTeam | Device | Group | HealthcareService | Location | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson | Specimen) | Reference to the group member | |
involvement | 0..* | CodeableConcept | Code that describes how user is part of the group Binding: Group Involvement (Example) | |
period | 0..1 | Period | Period member belonged to the group | |
inactive | 0..1 | boolean | If member is no longer in group | |
Documentation for this format |
See the Extensions for this resource
UML Diagram (Legend)
XML Template
<Group xmlns="http://hl7.org/fhir"> <!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <url value="[uri]"/><!-- 0..1 Canonical identifier for this Group, represented as an absolute URI (globally unique) --> <identifier><!-- 0..* Identifier Business Identifier for this Group --></identifier> <version value="[string]"/><!-- 0..1 Business version of the Group --> <versionAlgorithm[x]><!-- 0..1 string|Coding How to compare versions --></versionAlgorithm[x]> <name value="[string]"/><!-- 0..1 Label for Group --> <title value="[string]"/><!-- 0..1 Name for this Group (human friendly) --> <status value="[code]"/><!-- 0..1 draft | active | retired | unknown --> <experimental value="[boolean]"/><!-- 0..1 For testing purposes, not real usage --> <date value="[dateTime]"/><!-- 0..1 Date last changed --> <publisher value="[string]"/><!-- 0..1 Name of the publisher/steward (organization or individual) --> <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact> <description value="[markdown]"/><!-- 0..1 Natural language description of the group --> <useContext><!-- 0..* UsageContext The context that the content is intended to support --></useContext> <purpose value="[markdown]"/><!-- 0..1 Why this Group is defined --> <copyright value="[markdown]"/><!-- 0..1 Use and/or publishing restrictions --> <copyrightLabel value="[string]"/><!-- 0..1 Copyright holder and year(s) --> <type value="[code]"/><!-- 0..1 person | animal | practitioner | device | careteam | healthcareservice | location | organization | relatedperson | specimen --> <membership value="[code]"/><!-- 1..1 definitional | conceptual | enumerated --> <code><!-- 0..1 CodeableConcept Use of the Group (and by implication, kind of members) --></code> <quantity value="[unsignedInt]"/><!-- 0..1 Number of members --> <managingEntity><!-- 0..1 Reference(Organization|Practitioner|PractitionerRole| RelatedPerson) Entity that is the custodian of the Group's definition --></managingEntity> <combinationMethod value="[code]"/><!-- 0..1 all-of | any-of | at-least | at-most | except-subset --> <combinationThreshold value="[positiveInt]"/><!-- 0..1 Provides the value of "n" when "at-least" or "at-most" codes are used --> <characteristic> <!-- 0..* Include / Exclude group members by Trait --> <code><!-- 1..1 CodeableConcept Kind of characteristic --></code> <value[x]><!-- 1..1 CodeableConcept|boolean|Quantity|Range|Reference|uri| Expression Value held by characteristic --></value[x]> <exclude value="[boolean]"/><!-- 1..1 Group includes or excludes --> <description value="[markdown]"/><!-- 0..1 Natural language description of the characteristic --> <method><!-- 0..* CodeableConcept Method for how the characteristic value was determined --></method> <determinedBy[x]><!-- 0..1 Reference(Device|DeviceDefinition|DeviceMetric)| Expression Defines the characteristic --></determinedBy[x]> <offset><!-- 0..1 CodeableConcept Reference point for comparison --></offset> <instances[x]><!-- 0..1 Quantity|Range Number of occurrences meeting the characteristic --></instances[x]> <duration[x]><!-- 0..1 Duration|Range Length of time in which the characteristic is met --></duration[x]> <period><!-- 0..1 Period Period over which characteristic is tested --></period> <timing><!-- 0..* RelativeTime Timing in which the characteristic is determined --></timing> </characteristic> <member> <!-- 0..* Who or what is in group --> <entity><!-- 1..1 Reference(CareTeam|Device|Group|HealthcareService|Location| Organization|Patient|Practitioner|PractitionerRole|RelatedPerson|Specimen) Reference to the group member --></entity> <involvement><!-- 0..* CodeableConcept Code that describes how user is part of the group --></involvement> <period><!-- 0..1 Period Period member belonged to the group --></period> <inactive value="[boolean]"/><!-- 0..1 If member is no longer in group --> </member> </Group>
JSON Template
{ "resourceType" : "Group", // from Resource: id, meta, implicitRules, and language // from DomainResource: text, contained, extension, and modifierExtension "url" : "<uri>", // Canonical identifier for this Group, represented as an absolute URI (globally unique) "identifier" : [{ Identifier }], // Business Identifier for this Group "version" : "<string>", // Business version of the Group // versionAlgorithm[x]: How to compare versions. One of these 2: "versionAlgorithmString" : "<string>", "versionAlgorithmCoding" : { Coding }, "name" : "<string>", // Label for Group "title" : "<string>", // Name for this Group (human friendly) "status" : "<code>", // draft | active | retired | unknown "experimental" : <boolean>, // For testing purposes, not real usage "date" : "<dateTime>", // Date last changed "publisher" : "<string>", // Name of the publisher/steward (organization or individual) "contact" : [{ ContactDetail }], // Contact details for the publisher "description" : "<markdown>", // Natural language description of the group "useContext" : [{ UsageContext }], // The context that the content is intended to support "purpose" : "<markdown>", // Why this Group is defined "copyright" : "<markdown>", // Use and/or publishing restrictions "copyrightLabel" : "<string>", // Copyright holder and year(s) "type" : "<code>", // person | animal | practitioner | device | careteam | healthcareservice | location | organization | relatedperson | specimen "membership" : "<code>", // R! definitional | conceptual | enumerated "code" : { CodeableConcept }, // Use of the Group (and by implication, kind of members) "quantity" : "<unsignedInt>", // Number of members "managingEntity" : { Reference(Organization|Practitioner|PractitionerRole| RelatedPerson) }, // Entity that is the custodian of the Group's definition "combinationMethod" : "<code>", // all-of | any-of | at-least | at-most | except-subset "combinationThreshold" : "<positiveInt>", // Provides the value of "n" when "at-least" or "at-most" codes are used "characteristic" : [{ // Include / Exclude group members by Trait "code" : { CodeableConcept }, // R! Kind of characteristic // value[x]: Value held by characteristic. One of these 7: "valueCodeableConcept" : { CodeableConcept }, "valueBoolean" : <boolean>, "valueQuantity" : { Quantity }, "valueRange" : { Range }, "valueReference" : { Reference }, "valueUri" : "<uri>", "valueExpression" : { Expression }, "exclude" : <boolean>, // R! Group includes or excludes "description" : "<markdown>", // Natural language description of the characteristic "method" : [{ CodeableConcept }], // Method for how the characteristic value was determined // determinedBy[x]: Defines the characteristic. One of these 2: "determinedByReference" : { Reference(Device|DeviceDefinition|DeviceMetric) }, "determinedByExpression" : { Expression }, "offset" : { CodeableConcept }, // Reference point for comparison // instances[x]: Number of occurrences meeting the characteristic. One of these 2: "instancesQuantity" : { Quantity }, "instancesRange" : { Range }, // duration[x]: Length of time in which the characteristic is met. One of these 2: "durationDuration" : { Duration }, "durationRange" : { Range }, "period" : { Period }, // Period over which characteristic is tested "timing" : [{ RelativeTime }] // Timing in which the characteristic is determined }], "member" : [{ // Who or what is in group "entity" : { Reference(CareTeam|Device|Group|HealthcareService|Location| Organization|Patient|Practitioner|PractitionerRole|RelatedPerson|Specimen) }, // R! Reference to the group member "involvement" : [{ CodeableConcept }], // Code that describes how user is part of the group "period" : { Period }, // Period member belonged to the group "inactive" : <boolean> // If member is no longer in group }] }
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> . [ a fhir:Group; fhir:nodeRole fhir:treeRoot; # if this is the parser root # from Resource: .id, .meta, .implicitRules, and .language # from DomainResource: .text, .contained, .extension, and .modifierExtension fhir:url [ uri ] ; # 0..1 Canonical identifier for this Group, represented as an absolute URI (globally unique) fhir:identifier ( [ Identifier ] ... ) ; # 0..* Business Identifier for this Group fhir:version [ string ] ; # 0..1 Business version of the Group # versionAlgorithm[x] : 0..1 How to compare versions. One of these 2 fhir:versionAlgorithm [ a fhir:string ; string ] fhir:versionAlgorithm [ a fhir:Coding ; Coding ] fhir:name [ string ] ; # 0..1 Label for Group fhir:title [ string ] ; # 0..1 Name for this Group (human friendly) fhir:status [ code ] ; # 0..1 draft | active | retired | unknown fhir:experimental [ boolean ] ; # 0..1 For testing purposes, not real usage fhir:date [ dateTime ] ; # 0..1 Date last changed fhir:publisher [ string ] ; # 0..1 Name of the publisher/steward (organization or individual) fhir:contact ( [ ContactDetail ] ... ) ; # 0..* Contact details for the publisher fhir:description [ markdown ] ; # 0..1 Natural language description of the group fhir:useContext ( [ UsageContext ] ... ) ; # 0..* The context that the content is intended to support fhir:purpose [ markdown ] ; # 0..1 Why this Group is defined fhir:copyright [ markdown ] ; # 0..1 Use and/or publishing restrictions fhir:copyrightLabel [ string ] ; # 0..1 Copyright holder and year(s) fhir:type [ code ] ; # 0..1 person | animal | practitioner | device | careteam | healthcareservice | location | organization | relatedperson | specimen fhir:membership [ code ] ; # 1..1 definitional | conceptual | enumerated fhir:code [ CodeableConcept ] ; # 0..1 Use of the Group (and by implication, kind of members) fhir:quantity [ unsignedInt ] ; # 0..1 Number of members fhir:managingEntity [ Reference(Organization|Practitioner|PractitionerRole|RelatedPerson) ] ; # 0..1 Entity that is the custodian of the Group's definition fhir:combinationMethod [ code ] ; # 0..1 all-of | any-of | at-least | at-most | except-subset fhir:combinationThreshold [ positiveInt ] ; # 0..1 Provides the value of "n" when "at-least" or "at-most" codes are used fhir:characteristic ( [ # 0..* Include / Exclude group members by Trait fhir:code [ CodeableConcept ] ; # 1..1 Kind of characteristic # value[x] : 1..1 Value held by characteristic. One of these 7 fhir:value [ a fhir:CodeableConcept ; CodeableConcept ] fhir:value [ a fhir:boolean ; boolean ] fhir:value [ a fhir:Quantity ; Quantity ] fhir:value [ a fhir:Range ; Range ] fhir:value [ a fhir:Reference ; Reference ] fhir:value [ a fhir:uri ; uri ] fhir:value [ a fhir:Expression ; Expression ] fhir:exclude [ boolean ] ; # 1..1 Group includes or excludes fhir:description [ markdown ] ; # 0..1 Natural language description of the characteristic fhir:method ( [ CodeableConcept ] ... ) ; # 0..* Method for how the characteristic value was determined # determinedBy[x] : 0..1 Defines the characteristic. One of these 2 fhir:determinedBy [ a fhir:Reference ; Reference(Device|DeviceDefinition|DeviceMetric) ] fhir:determinedBy [ a fhir:Expression ; Expression ] fhir:offset [ CodeableConcept ] ; # 0..1 Reference point for comparison # instances[x] : 0..1 Number of occurrences meeting the characteristic. One of these 2 fhir:instances [ a fhir:Quantity ; Quantity ] fhir:instances [ a fhir:Range ; Range ] # duration[x] : 0..1 Length of time in which the characteristic is met. One of these 2 fhir:duration [ a fhir:Duration ; Duration ] fhir:duration [ a fhir:Range ; Range ] fhir:period [ Period ] ; # 0..1 Period over which characteristic is tested fhir:timing ( [ RelativeTime ] ... ) ; # 0..* Timing in which the characteristic is determined ] ... ) ; fhir:member ( [ # 0..* Who or what is in group fhir:entity [ Reference(CareTeam|Device|Group|HealthcareService|Location|Organization|Patient| Practitioner|PractitionerRole|RelatedPerson|Specimen) ] ; # 1..1 Reference to the group member fhir:involvement ( [ CodeableConcept ] ... ) ; # 0..* Code that describes how user is part of the group fhir:period [ Period ] ; # 0..1 Period member belonged to the group fhir:inactive [ boolean ] ; # 0..1 If member is no longer in group ] ... ) ; ]
Changes from both R4 and R4B
Group | |
Group.url |
|
Group.version |
|
Group.versionAlgorithm[x] |
|
Group.title |
|
Group.status |
|
Group.experimental |
|
Group.date |
|
Group.publisher |
|
Group.contact |
|
Group.description |
|
Group.useContext |
|
Group.purpose |
|
Group.copyright |
|
Group.copyrightLabel |
|
Group.type |
|
Group.membership |
|
Group.code |
|
Group.combinationMethod |
|
Group.combinationThreshold |
|
Group.characteristic.value[x] |
|
Group.characteristic.description |
|
Group.characteristic.method |
|
Group.characteristic.determinedBy[x] |
|
Group.characteristic.offset |
|
Group.characteristic.instances[x] |
|
Group.characteristic.duration[x] |
|
Group.characteristic.timing |
|
Group.member.entity |
|
Group.member.involvement |
|
Group.active |
|
Group.actual |
|
See the Full Difference for further information
This analysis is available for R4 as XML or JSON and for R4B as XML or JSON.
Structure
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Group | TU | DomainResource | Group of multiple entities + Rule: Group.type SHALL be defined if Group.membership is either 'definitional' or 'enumerated' Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension Interfaces Implemented: CanonicalResource | |
url | ΣC | 0..1 | uri | Canonical identifier for this Group, represented as an absolute URI (globally unique) + Warning: URL should not contain | or # - these characters make processing canonical references problematic |
identifier | Σ | 0..* | Identifier | Business Identifier for this Group |
version | Σ | 0..1 | string | Business version of the Group |
versionAlgorithm[x] | Σ | 0..1 | How to compare versions Binding: Version Algorithm (Extensible) | |
versionAlgorithmString | string | |||
versionAlgorithmCoding | Coding | |||
name | Σ | 0..1 | string | Label for Group |
title | Σ | 0..1 | string | Name for this Group (human friendly) |
status | ?!Σ | 0..1 | code | draft | active | retired | unknown Binding: PublicationStatus (Required) |
experimental | Σ | 0..1 | boolean | For testing purposes, not real usage |
date | Σ | 0..1 | dateTime | Date last changed |
publisher | Σ | 0..1 | string | Name of the publisher/steward (organization or individual) |
contact | Σ | 0..* | ContactDetail | Contact details for the publisher |
description | 0..1 | markdown | Natural language description of the group | |
useContext | Σ | 0..* | UsageContext | The context that the content is intended to support |
purpose | 0..1 | markdown | Why this Group is defined | |
copyright | 0..1 | markdown | Use and/or publishing restrictions | |
copyrightLabel | T | 0..1 | string | Copyright holder and year(s) |
type | Σ | 0..1 | code | person | animal | practitioner | device | careteam | healthcareservice | location | organization | relatedperson | specimen Binding: Group Type (Required) |
membership | Σ | 1..1 | code | definitional | conceptual | enumerated Binding: Group Membership Basis (Required) |
code | Σ | 0..1 | CodeableConcept | Use of the Group (and by implication, kind of members) Binding: Group Code (Extensible) |
quantity | Σ | 0..1 | unsignedInt | Number of members |
managingEntity | Σ | 0..1 | Reference(Organization | RelatedPerson | Practitioner | PractitionerRole) | Entity that is the custodian of the Group's definition |
combinationMethod | ?!Σ | 0..1 | code | all-of | any-of | at-least | at-most | except-subset Binding: Group Characteristic Combination (Required) |
combinationThreshold | 0..1 | positiveInt | Provides the value of "n" when "at-least" or "at-most" codes are used | |
characteristic | Σ | 0..* | BackboneElement | Include / Exclude group members by Trait |
code | Σ | 1..1 | CodeableConcept | Kind of characteristic Binding: GroupCharacteristicKind (Example) |
value[x] | Σ | 1..1 | Value held by characteristic Binding: GroupCharacteristicValue (Example) | |
valueCodeableConcept | CodeableConcept | |||
valueBoolean | boolean | |||
valueQuantity | Quantity | |||
valueRange | Range | |||
valueReference | Reference() | |||
valueUri | uri | |||
valueExpression | Expression | |||
exclude | Σ | 1..1 | boolean | Group includes or excludes |
description | 0..1 | markdown | Natural language description of the characteristic | |
method | 0..* | CodeableConcept | Method for how the characteristic value was determined Binding: Definition Method (Example) | |
determinedBy[x] | 0..1 | Defines the characteristic | ||
determinedByReference | Reference(Device | DeviceDefinition | DeviceMetric) | |||
determinedByExpression | Expression | |||
offset | ?!Σ | 0..1 | CodeableConcept | Reference point for comparison Binding: Characteristic Offset (Example) |
instances[x] | 0..1 | Number of occurrences meeting the characteristic | ||
instancesQuantity | Quantity | |||
instancesRange | Range | |||
duration[x] | 0..1 | Length of time in which the characteristic is met | ||
durationDuration | Duration | |||
durationRange | Range | |||
period | 0..1 | Period | Period over which characteristic is tested | |
timing | 0..* | RelativeTime | Timing in which the characteristic is determined | |
member | 0..* | BackboneElement | Who or what is in group | |
entity | 1..1 | Reference(CareTeam | Device | Group | HealthcareService | Location | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson | Specimen) | Reference to the group member | |
involvement | 0..* | CodeableConcept | Code that describes how user is part of the group Binding: Group Involvement (Example) | |
period | 0..1 | Period | Period member belonged to the group | |
inactive | 0..1 | boolean | If member is no longer in group | |
Documentation for this format |
See the Extensions for this resource
XML Template
<Group xmlns="http://hl7.org/fhir"> <!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <url value="[uri]"/><!-- 0..1 Canonical identifier for this Group, represented as an absolute URI (globally unique) --> <identifier><!-- 0..* Identifier Business Identifier for this Group --></identifier> <version value="[string]"/><!-- 0..1 Business version of the Group --> <versionAlgorithm[x]><!-- 0..1 string|Coding How to compare versions --></versionAlgorithm[x]> <name value="[string]"/><!-- 0..1 Label for Group --> <title value="[string]"/><!-- 0..1 Name for this Group (human friendly) --> <status value="[code]"/><!-- 0..1 draft | active | retired | unknown --> <experimental value="[boolean]"/><!-- 0..1 For testing purposes, not real usage --> <date value="[dateTime]"/><!-- 0..1 Date last changed --> <publisher value="[string]"/><!-- 0..1 Name of the publisher/steward (organization or individual) --> <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact> <description value="[markdown]"/><!-- 0..1 Natural language description of the group --> <useContext><!-- 0..* UsageContext The context that the content is intended to support --></useContext> <purpose value="[markdown]"/><!-- 0..1 Why this Group is defined --> <copyright value="[markdown]"/><!-- 0..1 Use and/or publishing restrictions --> <copyrightLabel value="[string]"/><!-- 0..1 Copyright holder and year(s) --> <type value="[code]"/><!-- 0..1 person | animal | practitioner | device | careteam | healthcareservice | location | organization | relatedperson | specimen --> <membership value="[code]"/><!-- 1..1 definitional | conceptual | enumerated --> <code><!-- 0..1 CodeableConcept Use of the Group (and by implication, kind of members) --></code> <quantity value="[unsignedInt]"/><!-- 0..1 Number of members --> <managingEntity><!-- 0..1 Reference(Organization|Practitioner|PractitionerRole| RelatedPerson) Entity that is the custodian of the Group's definition --></managingEntity> <combinationMethod value="[code]"/><!-- 0..1 all-of | any-of | at-least | at-most | except-subset --> <combinationThreshold value="[positiveInt]"/><!-- 0..1 Provides the value of "n" when "at-least" or "at-most" codes are used --> <characteristic> <!-- 0..* Include / Exclude group members by Trait --> <code><!-- 1..1 CodeableConcept Kind of characteristic --></code> <value[x]><!-- 1..1 CodeableConcept|boolean|Quantity|Range|Reference|uri| Expression Value held by characteristic --></value[x]> <exclude value="[boolean]"/><!-- 1..1 Group includes or excludes --> <description value="[markdown]"/><!-- 0..1 Natural language description of the characteristic --> <method><!-- 0..* CodeableConcept Method for how the characteristic value was determined --></method> <determinedBy[x]><!-- 0..1 Reference(Device|DeviceDefinition|DeviceMetric)| Expression Defines the characteristic --></determinedBy[x]> <offset><!-- 0..1 CodeableConcept Reference point for comparison --></offset> <instances[x]><!-- 0..1 Quantity|Range Number of occurrences meeting the characteristic --></instances[x]> <duration[x]><!-- 0..1 Duration|Range Length of time in which the characteristic is met --></duration[x]> <period><!-- 0..1 Period Period over which characteristic is tested --></period> <timing><!-- 0..* RelativeTime Timing in which the characteristic is determined --></timing> </characteristic> <member> <!-- 0..* Who or what is in group --> <entity><!-- 1..1 Reference(CareTeam|Device|Group|HealthcareService|Location| Organization|Patient|Practitioner|PractitionerRole|RelatedPerson|Specimen) Reference to the group member --></entity> <involvement><!-- 0..* CodeableConcept Code that describes how user is part of the group --></involvement> <period><!-- 0..1 Period Period member belonged to the group --></period> <inactive value="[boolean]"/><!-- 0..1 If member is no longer in group --> </member> </Group>
JSON Template
{ "resourceType" : "Group", // from Resource: id, meta, implicitRules, and language // from DomainResource: text, contained, extension, and modifierExtension "url" : "<uri>", // Canonical identifier for this Group, represented as an absolute URI (globally unique) "identifier" : [{ Identifier }], // Business Identifier for this Group "version" : "<string>", // Business version of the Group // versionAlgorithm[x]: How to compare versions. One of these 2: "versionAlgorithmString" : "<string>", "versionAlgorithmCoding" : { Coding }, "name" : "<string>", // Label for Group "title" : "<string>", // Name for this Group (human friendly) "status" : "<code>", // draft | active | retired | unknown "experimental" : <boolean>, // For testing purposes, not real usage "date" : "<dateTime>", // Date last changed "publisher" : "<string>", // Name of the publisher/steward (organization or individual) "contact" : [{ ContactDetail }], // Contact details for the publisher "description" : "<markdown>", // Natural language description of the group "useContext" : [{ UsageContext }], // The context that the content is intended to support "purpose" : "<markdown>", // Why this Group is defined "copyright" : "<markdown>", // Use and/or publishing restrictions "copyrightLabel" : "<string>", // Copyright holder and year(s) "type" : "<code>", // person | animal | practitioner | device | careteam | healthcareservice | location | organization | relatedperson | specimen "membership" : "<code>", // R! definitional | conceptual | enumerated "code" : { CodeableConcept }, // Use of the Group (and by implication, kind of members) "quantity" : "<unsignedInt>", // Number of members "managingEntity" : { Reference(Organization|Practitioner|PractitionerRole| RelatedPerson) }, // Entity that is the custodian of the Group's definition "combinationMethod" : "<code>", // all-of | any-of | at-least | at-most | except-subset "combinationThreshold" : "<positiveInt>", // Provides the value of "n" when "at-least" or "at-most" codes are used "characteristic" : [{ // Include / Exclude group members by Trait "code" : { CodeableConcept }, // R! Kind of characteristic // value[x]: Value held by characteristic. One of these 7: "valueCodeableConcept" : { CodeableConcept }, "valueBoolean" : <boolean>, "valueQuantity" : { Quantity }, "valueRange" : { Range }, "valueReference" : { Reference }, "valueUri" : "<uri>", "valueExpression" : { Expression }, "exclude" : <boolean>, // R! Group includes or excludes "description" : "<markdown>", // Natural language description of the characteristic "method" : [{ CodeableConcept }], // Method for how the characteristic value was determined // determinedBy[x]: Defines the characteristic. One of these 2: "determinedByReference" : { Reference(Device|DeviceDefinition|DeviceMetric) }, "determinedByExpression" : { Expression }, "offset" : { CodeableConcept }, // Reference point for comparison // instances[x]: Number of occurrences meeting the characteristic. One of these 2: "instancesQuantity" : { Quantity }, "instancesRange" : { Range }, // duration[x]: Length of time in which the characteristic is met. One of these 2: "durationDuration" : { Duration }, "durationRange" : { Range }, "period" : { Period }, // Period over which characteristic is tested "timing" : [{ RelativeTime }] // Timing in which the characteristic is determined }], "member" : [{ // Who or what is in group "entity" : { Reference(CareTeam|Device|Group|HealthcareService|Location| Organization|Patient|Practitioner|PractitionerRole|RelatedPerson|Specimen) }, // R! Reference to the group member "involvement" : [{ CodeableConcept }], // Code that describes how user is part of the group "period" : { Period }, // Period member belonged to the group "inactive" : <boolean> // If member is no longer in group }] }
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> . [ a fhir:Group; fhir:nodeRole fhir:treeRoot; # if this is the parser root # from Resource: .id, .meta, .implicitRules, and .language # from DomainResource: .text, .contained, .extension, and .modifierExtension fhir:url [ uri ] ; # 0..1 Canonical identifier for this Group, represented as an absolute URI (globally unique) fhir:identifier ( [ Identifier ] ... ) ; # 0..* Business Identifier for this Group fhir:version [ string ] ; # 0..1 Business version of the Group # versionAlgorithm[x] : 0..1 How to compare versions. One of these 2 fhir:versionAlgorithm [ a fhir:string ; string ] fhir:versionAlgorithm [ a fhir:Coding ; Coding ] fhir:name [ string ] ; # 0..1 Label for Group fhir:title [ string ] ; # 0..1 Name for this Group (human friendly) fhir:status [ code ] ; # 0..1 draft | active | retired | unknown fhir:experimental [ boolean ] ; # 0..1 For testing purposes, not real usage fhir:date [ dateTime ] ; # 0..1 Date last changed fhir:publisher [ string ] ; # 0..1 Name of the publisher/steward (organization or individual) fhir:contact ( [ ContactDetail ] ... ) ; # 0..* Contact details for the publisher fhir:description [ markdown ] ; # 0..1 Natural language description of the group fhir:useContext ( [ UsageContext ] ... ) ; # 0..* The context that the content is intended to support fhir:purpose [ markdown ] ; # 0..1 Why this Group is defined fhir:copyright [ markdown ] ; # 0..1 Use and/or publishing restrictions fhir:copyrightLabel [ string ] ; # 0..1 Copyright holder and year(s) fhir:type [ code ] ; # 0..1 person | animal | practitioner | device | careteam | healthcareservice | location | organization | relatedperson | specimen fhir:membership [ code ] ; # 1..1 definitional | conceptual | enumerated fhir:code [ CodeableConcept ] ; # 0..1 Use of the Group (and by implication, kind of members) fhir:quantity [ unsignedInt ] ; # 0..1 Number of members fhir:managingEntity [ Reference(Organization|Practitioner|PractitionerRole|RelatedPerson) ] ; # 0..1 Entity that is the custodian of the Group's definition fhir:combinationMethod [ code ] ; # 0..1 all-of | any-of | at-least | at-most | except-subset fhir:combinationThreshold [ positiveInt ] ; # 0..1 Provides the value of "n" when "at-least" or "at-most" codes are used fhir:characteristic ( [ # 0..* Include / Exclude group members by Trait fhir:code [ CodeableConcept ] ; # 1..1 Kind of characteristic # value[x] : 1..1 Value held by characteristic. One of these 7 fhir:value [ a fhir:CodeableConcept ; CodeableConcept ] fhir:value [ a fhir:boolean ; boolean ] fhir:value [ a fhir:Quantity ; Quantity ] fhir:value [ a fhir:Range ; Range ] fhir:value [ a fhir:Reference ; Reference ] fhir:value [ a fhir:uri ; uri ] fhir:value [ a fhir:Expression ; Expression ] fhir:exclude [ boolean ] ; # 1..1 Group includes or excludes fhir:description [ markdown ] ; # 0..1 Natural language description of the characteristic fhir:method ( [ CodeableConcept ] ... ) ; # 0..* Method for how the characteristic value was determined # determinedBy[x] : 0..1 Defines the characteristic. One of these 2 fhir:determinedBy [ a fhir:Reference ; Reference(Device|DeviceDefinition|DeviceMetric) ] fhir:determinedBy [ a fhir:Expression ; Expression ] fhir:offset [ CodeableConcept ] ; # 0..1 Reference point for comparison # instances[x] : 0..1 Number of occurrences meeting the characteristic. One of these 2 fhir:instances [ a fhir:Quantity ; Quantity ] fhir:instances [ a fhir:Range ; Range ] # duration[x] : 0..1 Length of time in which the characteristic is met. One of these 2 fhir:duration [ a fhir:Duration ; Duration ] fhir:duration [ a fhir:Range ; Range ] fhir:period [ Period ] ; # 0..1 Period over which characteristic is tested fhir:timing ( [ RelativeTime ] ... ) ; # 0..* Timing in which the characteristic is determined ] ... ) ; fhir:member ( [ # 0..* Who or what is in group fhir:entity [ Reference(CareTeam|Device|Group|HealthcareService|Location|Organization|Patient| Practitioner|PractitionerRole|RelatedPerson|Specimen) ] ; # 1..1 Reference to the group member fhir:involvement ( [ CodeableConcept ] ... ) ; # 0..* Code that describes how user is part of the group fhir:period [ Period ] ; # 0..1 Period member belonged to the group fhir:inactive [ boolean ] ; # 0..1 If member is no longer in group ] ... ) ; ]
Changes from both R4 and R4B
Group | |
Group.url |
|
Group.version |
|
Group.versionAlgorithm[x] |
|
Group.title |
|
Group.status |
|
Group.experimental |
|
Group.date |
|
Group.publisher |
|
Group.contact |
|
Group.description |
|
Group.useContext |
|
Group.purpose |
|
Group.copyright |
|
Group.copyrightLabel |
|
Group.type |
|
Group.membership |
|
Group.code |
|
Group.combinationMethod |
|
Group.combinationThreshold |
|
Group.characteristic.value[x] |
|
Group.characteristic.description |
|
Group.characteristic.method |
|
Group.characteristic.determinedBy[x] |
|
Group.characteristic.offset |
|
Group.characteristic.instances[x] |
|
Group.characteristic.duration[x] |
|
Group.characteristic.timing |
|
Group.member.entity |
|
Group.member.involvement |
|
Group.active |
|
Group.actual |
|
See the Full Difference for further information
This analysis is available for R4 as XML or JSON and for R4B as XML or JSON.
Additional definitions: Master Definition XML + JSON, XML Schema/Schematron + JSON Schema, ShEx (for Turtle) , the spreadsheet version & the dependency analysis
Path | ValueSet | Type | Documentation |
---|---|---|---|
Group.versionAlgorithm[x] | VersionAlgorithm | Extensible | Indicates the mechanism used to compare versions to determine which is more current. |
Group.status | PublicationStatus | Required | The lifecycle status of an artifact. |
Group.type | GroupType | Required | Types of resources that are part of group. |
Group.membership | GroupMembershipBasis | Required | Basis for membership in a group |
Group.code | GroupCode (a valid code from Group Type) | Extensible | A code that describes the use of the group. The use of the group usually dictates what kind of entities can be members of the group |
Group.combinationMethod | GroupCharacteristicCombination | Required | Logical grouping of characteristics for the Group Resource. |
Group.characteristic.code | Example | ||
Group.characteristic.value[x] | Example | ||
Group.characteristic.method | DefinitionMethod | Example | The method used to define, describe, or determine a characteristic value. |
Group.characteristic.offset | CharacteristicOffset | Example | Reference point for characteristic.valueQuantity. |
Group.member.involvement | GroupInvolvement | Example | A code that describes how a member of the group participates in the group. |
UniqueKey | Level | Location | Description | Expression |
cnl-1 | Warning | Group.url | URL should not contain | or # - these characters make processing canonical references problematic | exists() implies matches('^[^|# ]+$') |
cnl-2 | Rule | (base) | Group.type SHALL be defined if Group.membership is either 'definitional' or 'enumerated' | Group.type.exists() or (Group.membership = 'conceptual') |
If both Group.characteristic
and Group.member
are present, then the
members are the individuals who were found who met the characteristic. It's possible that
there might be other candidate members who meet the characteristic and aren't (yet) in the list.
All members SHALL have the listed characteristics.
For operations to assist in adding to, removing from, or filtering contents of large Groups, see Operations for Large Resources.
Membership testing is used to test for active members of a Group. At a minimum, servers supporting membership testing on Group resources SHALL be able to correctly identify active enumerated entities. Active enumerated entities in a group are entities:
Group.member.entity
,Group.member.inactive
with a value of true
, andGroup.member.period
(e.g., either the element is not present or has a period covering 'now').
Membership testing MAY also be applied to characteristic-defined Groups. If supported,
membership testing is based on the characteristic testing of the Group. Any entity meeting
the required characteristics is considered to be active
.
Servers SHOULD declare whether they support only the enumerated or characteristic group filters. Servers MAY impose additional membership constraints (e.g. based on modifier extensions).
Search parameters for this resource. See also the full list of search parameters for this resource, and check the Extensions registry for search parameters on extensions related to this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.
Name | Type | Description | Expression | In Common |
characteristic | token | Kind of characteristic | Group.characteristic.code | |
characteristic-reference | reference | An entity referenced in a characteristic | (Group.characteristic.value.ofType(Reference)) | |
characteristic-value | composite | A composite of both characteristic and value | On Group.characteristic: characteristic: code value: (value.ofType(CodeableConcept)) | (value.ofType(boolean)) |
|
code | token | The kind of resources contained | Group.code | |
exclude | token | Group includes or excludes | Group.characteristic.exclude | |
identifier | token | Unique id | Group.identifier | 36 Resources |
managing-entity | reference | Entity that is the custodian of the Group's definition | Group.managingEntity (Practitioner, Organization, PractitionerRole, RelatedPerson) |
|
member | reference | Reference to the group member | Group.member.entity (Practitioner, Group, Specimen, Organization, CareTeam, Device, Patient, HealthcareService, PractitionerRole, RelatedPerson, Location) |
|
membership | token | Definitional or enumerated group | Group.membership | |
name | string | A portion of the Group's name | Group.name | 27 Resources |
status | token | The current status of the Group | Group.status | 36 Resources |
type | token | The type of resources the group contains | Group.type | |
url | uri | The uri that identifies the Group | Group.url | 35 Resources |
value | token | Value held by characteristic | (Group.characteristic.value.ofType(CodeableConcept)) | (Group.characteristic.value.ofType(boolean)) |