This page is part of the SDOH Clinical Care for Multiple Domains (v0.1.0: STU 1 Ballot 1) based on FHIR R4. The current version which supercedes this version is 2.0.0. For a full list of available versions, see the Directory of published versions
Defining URL: | http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-Group |
Version: | 0.1.0 |
Name: | SDOHCC_Group |
Title: | SDOHCC Group |
Status: | Draft as of 2020-12-16T20:13:36+00:00 |
Definition: | This is a profile on the Group resource to allow collections of individuals with SDOH data to be easily exchanged with allowed organizations. |
Publisher: | HL7 International - Patient Care WG |
Source Resource: | XML / JSON / Turtle |
The official URL for this profile is:
http://hl7.org/fhir/us/sdoh-clinicalcare/StructureDefinition/SDOHCC-Group
Information for Group
The SDOHCC Group profile allows the aggregation of individuals that have a common set of characteristics (e.g. are all referred to the same food panty). This will enable organizations that have permission to easily retrieve information related to the cohort of individuals for which they have a common responsibility. The section that follows provides additional guidance on some elements in the SDOHCC Group profile.
Group.identifier should be used to provide an identifier that is recognized by the issuing organization for the specific group.
Group.code does not currently have a specific binding to a value set. We are seeking input an appropriate value set for this element.
Group.managingEntity is a reference to the entity that is responsible for managing the Group resource. In general, Group.managingEntity should refer to the provider Organization.
We have not chosen to additionally constrain the Group resource and are seeking input on the appropriateness of constraining the following elements. Group.type Group.actual Group.characteristic Group.characteristic.code Group.member
Description of Profiles, Differentials, Snapshots and how the different presentations work.
This structure is derived from Group
This structure is derived from Group
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Group | 0..* | Group | Group of multiple entities | |
identifier | S | 0..* | Identifier | Unique id |
code | S | 0..1 | CodeableConcept | Kind of Group members |
managingEntity | S | 0..1 | Reference(Organization | RelatedPerson | Practitioner | PractitionerRole) | Entity that is the custodian of the Group's definition |
Documentation for this format |
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Group | I | 0..* | Group | Group of multiple entities |
id | Σ | 0..1 | string | Logical id of this artifact |
meta | Σ | 0..1 | Meta | Metadata about the resource |
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created |
language | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred) Max Binding: AllLanguages: A human language. | |
text | 0..1 | Narrative | Text summary of the resource, for human interpretation | |
contained | 0..* | Resource | Contained, inline Resources | |
extension | 0..* | Extension | Additional content defined by implementations | |
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
identifier | SΣ | 0..* | Identifier | Unique id |
active | Σ | 0..1 | boolean | Whether this group's record is in active use |
type | Σ | 1..1 | code | person | animal | practitioner | device | medication | substance Binding: GroupType (required): Types of resources that are part of group. |
actual | ΣI | 1..1 | boolean | Descriptive or actual |
code | SΣ | 0..1 | CodeableConcept | Kind of Group members Binding: (unbound) (example): Kind of particular resource; e.g. cow, syringe, lake, etc. |
name | Σ | 0..1 | string | Label for Group |
quantity | Σ | 0..1 | unsignedInt | Number of members |
managingEntity | SΣ | 0..1 | Reference(Organization | RelatedPerson | Practitioner | PractitionerRole) | Entity that is the custodian of the Group's definition |
characteristic | 0..* | BackboneElement | Include / Exclude group members by Trait | |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | 0..* | Extension | Additional content defined by implementations | |
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
code | 1..1 | CodeableConcept | Kind of characteristic Binding: (unbound) (example): List of characteristics used to describe group members; e.g. gender, age, owner, location, etc. | |
value[x] | 1..1 | Value held by characteristic Binding: (unbound) (example): Value of descriptive member characteristic; e.g. red, male, pneumonia, Caucasian, etc. | ||
valueCodeableConcept | CodeableConcept | |||
valueBoolean | boolean | |||
valueQuantity | Quantity | |||
valueRange | Range | |||
valueReference | Reference(Any) | |||
exclude | 1..1 | boolean | Group includes or excludes | |
period | 0..1 | Period | Period over which characteristic is tested | |
member | I | 0..* | BackboneElement | Who or what is in group |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | 0..* | Extension | Additional content defined by implementations | |
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
entity | 1..1 | Reference(Patient | Practitioner | PractitionerRole | Device | Medication | Substance | Group) | Reference to the group member | |
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 |
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Group | I | 0..* | Group | Group of multiple entities |
identifier | Σ | 0..* | Identifier | Unique id |
code | Σ | 0..1 | CodeableConcept | Kind of Group members Binding: (unbound) (example): Kind of particular resource; e.g. cow, syringe, lake, etc. |
managingEntity | Σ | 0..1 | Reference(Organization | RelatedPerson | Practitioner | PractitionerRole) | Entity that is the custodian of the Group's definition |
Documentation for this format |
This structure is derived from Group
Differential View
This structure is derived from Group
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Group | 0..* | Group | Group of multiple entities | |
identifier | S | 0..* | Identifier | Unique id |
code | S | 0..1 | CodeableConcept | Kind of Group members |
managingEntity | S | 0..1 | Reference(Organization | RelatedPerson | Practitioner | PractitionerRole) | Entity that is the custodian of the Group's definition |
Documentation for this format |
Snapshot View
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Group | I | 0..* | Group | Group of multiple entities |
id | Σ | 0..1 | string | Logical id of this artifact |
meta | Σ | 0..1 | Meta | Metadata about the resource |
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created |
language | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred) Max Binding: AllLanguages: A human language. | |
text | 0..1 | Narrative | Text summary of the resource, for human interpretation | |
contained | 0..* | Resource | Contained, inline Resources | |
extension | 0..* | Extension | Additional content defined by implementations | |
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
identifier | SΣ | 0..* | Identifier | Unique id |
active | Σ | 0..1 | boolean | Whether this group's record is in active use |
type | Σ | 1..1 | code | person | animal | practitioner | device | medication | substance Binding: GroupType (required): Types of resources that are part of group. |
actual | ΣI | 1..1 | boolean | Descriptive or actual |
code | SΣ | 0..1 | CodeableConcept | Kind of Group members Binding: (unbound) (example): Kind of particular resource; e.g. cow, syringe, lake, etc. |
name | Σ | 0..1 | string | Label for Group |
quantity | Σ | 0..1 | unsignedInt | Number of members |
managingEntity | SΣ | 0..1 | Reference(Organization | RelatedPerson | Practitioner | PractitionerRole) | Entity that is the custodian of the Group's definition |
characteristic | 0..* | BackboneElement | Include / Exclude group members by Trait | |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | 0..* | Extension | Additional content defined by implementations | |
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
code | 1..1 | CodeableConcept | Kind of characteristic Binding: (unbound) (example): List of characteristics used to describe group members; e.g. gender, age, owner, location, etc. | |
value[x] | 1..1 | Value held by characteristic Binding: (unbound) (example): Value of descriptive member characteristic; e.g. red, male, pneumonia, Caucasian, etc. | ||
valueCodeableConcept | CodeableConcept | |||
valueBoolean | boolean | |||
valueQuantity | Quantity | |||
valueRange | Range | |||
valueReference | Reference(Any) | |||
exclude | 1..1 | boolean | Group includes or excludes | |
period | 0..1 | Period | Period over which characteristic is tested | |
member | I | 0..* | BackboneElement | Who or what is in group |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | 0..* | Extension | Additional content defined by implementations | |
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
entity | 1..1 | Reference(Patient | Practitioner | PractitionerRole | Device | Medication | Substance | Group) | Reference to the group member | |
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 |
Other representations of profile: Schematron
Path | Conformance | ValueSet |
Group.language | preferred | CommonLanguages Max Binding: AllLanguages |
Group.type | required | GroupType |
Group.code | example | |
Group.characteristic.code | example | |
Group.characteristic.value[x] | example |
Id | Path | Details | Requirements |
dom-2 | Group | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() | |
dom-3 | Group | 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 : 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-4 | Group | If 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-5 | Group | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() | |
dom-6 | Group | A resource should have narrative for robust management : text.`div`.exists() | |
grp-1 | Group | Can only have members if group is "actual" : member.empty() or (actual = true) | |
ele-1 | Group.meta | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | Group.implicitRules | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | Group.language | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | Group.text | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | Group.extension | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | Group.extension | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
ele-1 | Group.modifierExtension | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | Group.modifierExtension | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
ele-1 | Group.identifier | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | Group.active | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | Group.type | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | Group.actual | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | Group.code | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | Group.name | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | Group.quantity | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | Group.managingEntity | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | Group.characteristic | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | Group.characteristic.extension | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | Group.characteristic.extension | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
ele-1 | Group.characteristic.modifierExtension | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | Group.characteristic.modifierExtension | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
ele-1 | Group.characteristic.code | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | Group.characteristic.value[x] | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | Group.characteristic.exclude | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | Group.characteristic.period | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | Group.member | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | Group.member.extension | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | Group.member.extension | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
ele-1 | Group.member.modifierExtension | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | Group.member.modifierExtension | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
ele-1 | Group.member.entity | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | Group.member.period | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | Group.member.inactive | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) |
Notes text for Group resource