This
page
is
part
of
the
FHIR
Specification
(v3.0.2:
(v4.0.1:
R4
-
Mixed
Normative
and
STU
3).
)
in
it's
permanent
home
(it
will
always
be
available
at
this
URL).
The
current
version
which
supercedes
this
version
is
5.0.0
.
For
a
full
list
of
available
versions,
see
the
Directory
of
published
versions
.
Page
versions:
R5
R4B
R4
R3
R4
R3
R2
FHIR
Infrastructure
Work
Group
|
Maturity Level : 1 | 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
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 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.
There
are
five
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.
This
resource
is
referenced
by
DataRequirement
,
UsageContext
,
ActivityDefinition
,
AdverseEvent
,
CarePlan
,
CareTeam
,
ChargeItem
,
ClinicalImpression
,
Communication
,
CommunicationRequest
,
Condition
,
Consent
,
Contract
,
DeviceRequest
,
DeviceUseStatement
,
DiagnosticReport
,
DocumentManifest
,
DocumentReference
,
Encounter
,
EventDefinition
,
EvidenceVariable
,
Flag
,
Goal
,
itself,
GuidanceResponse
,
ImagingStudy
,
Invoice
,
Library
,
List
,
Measure
,
MeasureReport
,
Media
,
MedicationAdministration
,
MedicationDispense
,
MedicationRequest
,
MedicationStatement
,
Observation
,
PlanDefinition
,
Procedure
,
ProcedureRequest
RequestGroup
,
ReferralRequest
ResearchDefinition
,
RequestGroup
ResearchElementDefinition
,
ResearchStudy
,
RiskAssessment
,
ServiceRequest
,
Specimen
and
Task
Structure
| Name | Flags | Card. | Type |
Description
&
Constraints
|
|---|---|---|---|---|
|
I TU | DomainResource |
Group
of
multiple
entities
+ Rule: Can only have members if group is Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension |
|
|
Σ | 0..* | Identifier |
Unique
id
|
|
Σ | 0..1 | boolean | Whether this group's record is in active use |
|
Σ | 1..1 | code |
person
|
animal
|
practitioner
|
device
|
medication
|
substance
GroupType ( Required ) |
|
Σ I | 1..1 | boolean | Descriptive or actual |
|
Σ | 0..1 | CodeableConcept | Kind of Group members |
|
Σ | 0..1 | string | Label for Group |
|
Σ | 0..1 | unsignedInt | Number of members |
| Σ | 0..1 | Reference ( Organization | RelatedPerson | Practitioner | PractitionerRole ) | Entity that is the custodian of the Group's definition |
![]() ![]() |
0..* | BackboneElement |
Include
/
Exclude
group
members
by
Trait
|
|
|
1..1 | CodeableConcept | Kind of characteristic | |
|
1..1 | Value held by characteristic | ||
|
CodeableConcept | |||
|
boolean | |||
|
Quantity | |||
|
Range | |||
| Reference () | |||
|
1..1 | boolean | Group includes or excludes | |
|
0..1 | Period | Period over which characteristic is tested | |
|
I | 0..* | BackboneElement |
Who
or
what
is
in
group
|
|
1..1 | Reference ( Patient | Practitioner | PractitionerRole | Device | Medication | Substance | Group ) | Reference to the group member | |
|
0..1 | Period | Period member belonged to the group | |
|
0..1 | boolean | If member is no longer in group | |
Documentation
for
this
format
|
||||
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 --> <identifier><!-- 0..* Identifier Unique id --></identifier>
< < <<active value="[boolean]"/><!-- 0..1 Whether this group's record is in active use --> <type value="[code]"/><!-- 1..1 person | animal | practitioner | device | medication | substance --> <actual value="[boolean]"/><!--1..1 Descriptive or actual --> <code><!-- 0..1 CodeableConcept Kind of Group members --></code>
< < <<name value="[string]"/><!-- 0..1 Label for Group --> <quantity value="[unsignedInt]"/><!-- 0..1 Number of members --> <managingEntity><!-- 0..1 Reference(Organization|RelatedPerson|Practitioner| PractitionerRole) Entity that is the custodian of the Group's definition --></managingEntity> <characteristic> <!-- 0..* Include / Exclude group members by Trait --> <code><!-- 1..1 CodeableConcept Kind of characteristic --></code><</value[x]> <<value[x]><!-- 1..1 CodeableConcept|boolean|Quantity|Range|Reference Value held by characteristic --></value[x]> <exclude value="[boolean]"/><!-- 1..1 Group includes or excludes --> <period><!-- 0..1 Period Period over which characteristic is tested --></period> </characteristic> <member> <!--0..* Who or what is in group -->
<</entity><entity><!-- 1..1 Reference(Patient|Practitioner|PractitionerRole|Device| Medication|Substance|Group) Reference to the group member --></entity> <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" : "",
"resourceType" : "Group",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"
"
"
"
"
"
"
"
"
" },
">,
" },
" },
"
"
"identifier" : [{ Identifier }], // Unique id
"active" : <boolean>, // Whether this group's record is in active use
"type" : "<code>", // R! person | animal | practitioner | device | medication | substance
"actual" : <boolean>, // C? R! Descriptive or actual
"code" : { CodeableConcept }, // Kind of Group members
"name" : "<string>", // Label for Group
"quantity" : "<unsignedInt>", // Number of members
"managingEntity" : { Reference(Organization|RelatedPerson|Practitioner|
PractitionerRole) }, // Entity that is the custodian of the Group's definition
"characteristic" : [{ // Include / Exclude group members by Trait
"code" : { CodeableConcept }, // R! Kind of characteristic
// value[x]: Value held by characteristic. One of these 5:
"valueCodeableConcept" : { CodeableConcept },
"valueBoolean" : <boolean>,
"valueQuantity" : { Quantity },
"valueRange" : { Range },
"valueReference" : { Reference },
"exclude" : <boolean>, // R! Group includes or excludes
"period" : { Period } // Period over which characteristic is tested
}],
"
"
"
"
"member" : [{ // C? Who or what is in group
"entity" : { Reference(Patient|Practitioner|PractitionerRole|Device|
Medication|Substance|Group) }, // R! Reference to the group member
"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:;[ 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:Group.identifier [ Identifier ], ... ; # 0..* Unique id fhir:Group.active [ boolean ]; # 0..1 Whether this group's record is in active use fhir:Group.type [ code ]; # 1..1 person | animal | practitioner | device | medication | substance fhir:Group.actual [ boolean ]; # 1..1 Descriptive or actual fhir:Group.code [ CodeableConcept ]; # 0..1 Kind of Group members fhir:Group.name [ string ]; # 0..1 Label for Group fhir:Group.quantity [ unsignedInt ]; # 0..1 Number of membersfhir:fhir:Group.managingEntity [ Reference(Organization|RelatedPerson|Practitioner|PractitionerRole) ]; # 0..1 Entity that is the custodian of the Group's definition fhir:Group.characteristic [ # 0..* Include / Exclude group members by Trait fhir:Group.characteristic.code [ CodeableConcept ]; # 1..1 Kind of characteristic# . One of these 4# Group.characteristic.value[x] : 1..1 Value held by characteristic. One of these 5 fhir:Group.characteristic.valueCodeableConcept [ CodeableConcept ] fhir:Group.characteristic.valueBoolean [ boolean ] fhir:Group.characteristic.valueQuantity [ Quantity ] fhir:Group.characteristic.valueRange [ Range ]fhir:fhir:Group.characteristic.valueReference [ Reference ] fhir:Group.characteristic.exclude [ boolean ]; # 1..1 Group includes or excludes fhir:Group.characteristic.period [ Period ]; # 0..1 Period over which characteristic is tested ], ...; fhir:Group.member [ # 0..* Who or what is in groupfhir:fhir:Group.member.entity [ Reference(Patient|Practitioner|PractitionerRole|Device|Medication|Substance|Group) ]; # 1..1 Reference to the group member fhir:Group.member.period [ Period ]; # 0..1 Period member belonged to the group fhir:Group.member.inactive [ boolean ]; # 0..1 If member is no longer in group ], ...; ]
Changes
since
DSTU2
R3
| Group | |
| Group.active |
|
| Group.type |
|
| Group.managingEntity |
|
| Group.characteristic.value[x] |
|
| Group.characteristic.exclude |
|
| Group.member.entity |
|
| Group.member.inactive |
|
See the Full Difference for further information
This analysis is available as XML or JSON .
See
R2
<-->
R3
<-->
R4
Conversion
Maps
(status
=
2
tests
that
all
execute
ok.
All
tests
pass
round-trip
testing
and
all
r3
resources
are
valid.).
valid.)
Structure
| Name | Flags | Card. | Type |
Description
&
Constraints
|
|---|---|---|---|---|
|
I TU | DomainResource |
Group
of
multiple
entities
+ Rule: Can only have members if group is Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension |
|
|
Σ | 0..* | Identifier |
Unique
id
|
|
Σ | 0..1 | boolean | Whether this group's record is in active use |
|
Σ | 1..1 | code |
person
|
animal
|
practitioner
|
device
|
medication
|
substance
GroupType ( Required ) |
|
Σ I | 1..1 | boolean | Descriptive or actual |
|
Σ | 0..1 | CodeableConcept | Kind of Group members |
|
Σ | 0..1 | string | Label for Group |
|
Σ | 0..1 | unsignedInt | Number of members |
| Σ | 0..1 | Reference ( Organization | RelatedPerson | Practitioner | PractitionerRole ) | Entity that is the custodian of the Group's definition |
![]() ![]() |
0..* | BackboneElement |
Include
/
Exclude
group
members
by
Trait
|
|
|
1..1 | CodeableConcept | Kind of characteristic | |
|
1..1 | Value held by characteristic | ||
|
CodeableConcept | |||
|
boolean | |||
|
Quantity | |||
|
Range | |||
| Reference () | |||
|
1..1 | boolean | Group includes or excludes | |
|
0..1 | Period | Period over which characteristic is tested | |
|
I | 0..* | BackboneElement |
Who
or
what
is
in
group
|
|
1..1 | Reference ( Patient | Practitioner | PractitionerRole | Device | Medication | Substance | Group ) | Reference to the group member | |
|
0..1 | Period | Period member belonged to the group | |
|
0..1 | boolean | If member is no longer in group | |
Documentation
for
this
format
|
||||
XML Template
<<Group xmlns="http://hl7.org/fhir"><!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..* Identifier Unique id --></identifier>
< < <<active value="[boolean]"/><!-- 0..1 Whether this group's record is in active use --> <type value="[code]"/><!-- 1..1 person | animal | practitioner | device | medication | substance --> <actual value="[boolean]"/><!--1..1 Descriptive or actual --> <code><!-- 0..1 CodeableConcept Kind of Group members --></code>
< < <<name value="[string]"/><!-- 0..1 Label for Group --> <quantity value="[unsignedInt]"/><!-- 0..1 Number of members --> <managingEntity><!-- 0..1 Reference(Organization|RelatedPerson|Practitioner| PractitionerRole) Entity that is the custodian of the Group's definition --></managingEntity> <characteristic> <!-- 0..* Include / Exclude group members by Trait --> <code><!-- 1..1 CodeableConcept Kind of characteristic --></code><</value[x]> <<value[x]><!-- 1..1 CodeableConcept|boolean|Quantity|Range|Reference Value held by characteristic --></value[x]> <exclude value="[boolean]"/><!-- 1..1 Group includes or excludes --> <period><!-- 0..1 Period Period over which characteristic is tested --></period> </characteristic> <member> <!--0..* Who or what is in group -->
<</entity><entity><!-- 1..1 Reference(Patient|Practitioner|PractitionerRole|Device| Medication|Substance|Group) Reference to the group member --></entity> <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" : "",
"resourceType" : "Group",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"
"
"
"
"
"
"
"
"
" },
">,
" },
" },
"
"
"identifier" : [{ Identifier }], // Unique id
"active" : <boolean>, // Whether this group's record is in active use
"type" : "<code>", // R! person | animal | practitioner | device | medication | substance
"actual" : <boolean>, // C? R! Descriptive or actual
"code" : { CodeableConcept }, // Kind of Group members
"name" : "<string>", // Label for Group
"quantity" : "<unsignedInt>", // Number of members
"managingEntity" : { Reference(Organization|RelatedPerson|Practitioner|
PractitionerRole) }, // Entity that is the custodian of the Group's definition
"characteristic" : [{ // Include / Exclude group members by Trait
"code" : { CodeableConcept }, // R! Kind of characteristic
// value[x]: Value held by characteristic. One of these 5:
"valueCodeableConcept" : { CodeableConcept },
"valueBoolean" : <boolean>,
"valueQuantity" : { Quantity },
"valueRange" : { Range },
"valueReference" : { Reference },
"exclude" : <boolean>, // R! Group includes or excludes
"period" : { Period } // Period over which characteristic is tested
}],
"
"
"
"
"member" : [{ // C? Who or what is in group
"entity" : { Reference(Patient|Practitioner|PractitionerRole|Device|
Medication|Substance|Group) }, // R! Reference to the group member
"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:;[ 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:Group.identifier [ Identifier ], ... ; # 0..* Unique id fhir:Group.active [ boolean ]; # 0..1 Whether this group's record is in active use fhir:Group.type [ code ]; # 1..1 person | animal | practitioner | device | medication | substance fhir:Group.actual [ boolean ]; # 1..1 Descriptive or actual fhir:Group.code [ CodeableConcept ]; # 0..1 Kind of Group members fhir:Group.name [ string ]; # 0..1 Label for Group fhir:Group.quantity [ unsignedInt ]; # 0..1 Number of membersfhir:fhir:Group.managingEntity [ Reference(Organization|RelatedPerson|Practitioner|PractitionerRole) ]; # 0..1 Entity that is the custodian of the Group's definition fhir:Group.characteristic [ # 0..* Include / Exclude group members by Trait fhir:Group.characteristic.code [ CodeableConcept ]; # 1..1 Kind of characteristic# . One of these 4# Group.characteristic.value[x] : 1..1 Value held by characteristic. One of these 5 fhir:Group.characteristic.valueCodeableConcept [ CodeableConcept ] fhir:Group.characteristic.valueBoolean [ boolean ] fhir:Group.characteristic.valueQuantity [ Quantity ] fhir:Group.characteristic.valueRange [ Range ]fhir:fhir:Group.characteristic.valueReference [ Reference ] fhir:Group.characteristic.exclude [ boolean ]; # 1..1 Group includes or excludes fhir:Group.characteristic.period [ Period ]; # 0..1 Period over which characteristic is tested ], ...; fhir:Group.member [ # 0..* Who or what is in groupfhir:fhir:Group.member.entity [ Reference(Patient|Practitioner|PractitionerRole|Device|Medication|Substance|Group) ]; # 1..1 Reference to the group member fhir:Group.member.period [ Period ]; # 0..1 Period member belonged to the group fhir:Group.member.inactive [ boolean ]; # 0..1 If member is no longer in group ], ...; ]
Changes
since
DSTU2
Release
3
| Group | |
| Group.active |
|
| Group.type |
|
| Group.managingEntity |
|
| Group.characteristic.value[x] |
|
| Group.characteristic.exclude |
|
| Group.member.entity |
|
| Group.member.inactive |
|
See the Full Difference for further information
This analysis is available as XML or JSON .
See
R2
<-->
R3
<-->
R4
Conversion
Maps
(status
=
2
tests
that
all
execute
ok.
All
tests
pass
round-trip
testing
and
all
r3
resources
are
valid.).
valid.)
Alternate
See
the
Profiles
&
Extensions
and
the
alternate
definitions:
Master
Definition
(
XML
,
+
JSON
),
,
XML
Schema
/
Schematron
(for
)
+
JSON
Schema
,
ShEx
(for
Turtle
)
+
see
the
extensions
&
the
dependency
analysis
| Path | Definition | Type | Reference |
|---|---|---|---|
| Group.type |
Types
of
resources
that
are
part
of
|
Required | GroupType |
| Group.code | Kind of particular resource; e.g. cow, syringe, lake, etc. | Unknown | No details provided yet |
| Group.characteristic.code | List of characteristics used to describe group members; e.g. gender, age, owner, location, etc. | Unknown | No details provided yet |
| Group.characteristic.value[x] | Value of descriptive member characteristic; e.g. red, male, pneumonia, Caucasian, etc. | Unknown | No details provided yet |
| id | Level | Location | Description | Expression |
|
grp-1
|
Rule | (base) |
Can
only
have
members
if
group
is
|
|
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.
Search parameters for 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 |
| actual | token | Descriptive or actual | Group.actual | |
| characteristic | token | Kind of characteristic | Group.characteristic.code | |
| characteristic-value | composite | A composite of both characteristic and value |
characteristic: code value: value |
|
| code | token | The kind of resources contained | Group.code | |
| exclude | token | Group includes or excludes | Group.characteristic.exclude | |
| identifier | token | Unique id | Group.identifier | |
| 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 , Device , Medication , Patient , Substance , PractitionerRole ) |
|
| type | token | The type of resources the group contains | Group.type | |
| value | token | Value held by characteristic |
|