SDOH Clinical Care
0.1.0 - STU 1

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

Resource Profile: SDOHCC Group

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

Additional Guidance

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

Group.identifier should be used to provide an identifier that is recognized by the issuing organization for the specific group.

Group.code

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

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.

Request for comments

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

Formal Views of Profile Content

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

This structure is derived from Group

Summary

Must-Support: 3 elements

This structure is derived from Group

NameFlagsCard.TypeDescription & Constraintsdoco
.. Group 0..*GroupGroup of multiple entities
... identifier S0..*IdentifierUnique id
... code S0..1CodeableConceptKind of Group members
... managingEntity S0..1Reference(Organization | RelatedPerson | Practitioner | PractitionerRole)Entity that is the custodian of the Group's definition

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. Group I0..*GroupGroup of multiple entities
... 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
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionAdditional content defined by implementations
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier SΣ0..*IdentifierUnique id
... active Σ0..1booleanWhether this group's record is in active use
... type Σ1..1codeperson | animal | practitioner | device | medication | substance
Binding: GroupType (required): Types of resources that are part of group.

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

... name Σ0..1stringLabel for Group
... quantity Σ0..1unsignedIntNumber of members
... managingEntity SΣ0..1Reference(Organization | RelatedPerson | Practitioner | PractitionerRole)Entity that is the custodian of the Group's definition
... characteristic 0..*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
... member I0..*BackboneElementWho or what is in group
.... 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
.... entity 1..1Reference(Patient | Practitioner | PractitionerRole | Device | Medication | Substance | Group)Reference to the group member
.... period 0..1PeriodPeriod member belonged to the group
.... inactive 0..1booleanIf member is no longer in group

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. Group I0..*GroupGroup of multiple entities
... identifier Σ0..*IdentifierUnique id
... code Σ0..1CodeableConceptKind of Group members
Binding: (unbound) (example): Kind of particular resource; e.g. cow, syringe, lake, etc.

... managingEntity Σ0..1Reference(Organization | RelatedPerson | Practitioner | PractitionerRole)Entity that is the custodian of the Group's definition

doco Documentation for this format

This structure is derived from Group

Summary

Must-Support: 3 elements

Differential View

This structure is derived from Group

NameFlagsCard.TypeDescription & Constraintsdoco
.. Group 0..*GroupGroup of multiple entities
... identifier S0..*IdentifierUnique id
... code S0..1CodeableConceptKind of Group members
... managingEntity S0..1Reference(Organization | RelatedPerson | Practitioner | PractitionerRole)Entity that is the custodian of the Group's definition

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Group I0..*GroupGroup of multiple entities
... 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
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionAdditional content defined by implementations
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier SΣ0..*IdentifierUnique id
... active Σ0..1booleanWhether this group's record is in active use
... type Σ1..1codeperson | animal | practitioner | device | medication | substance
Binding: GroupType (required): Types of resources that are part of group.

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

... name Σ0..1stringLabel for Group
... quantity Σ0..1unsignedIntNumber of members
... managingEntity SΣ0..1Reference(Organization | RelatedPerson | Practitioner | PractitionerRole)Entity that is the custodian of the Group's definition
... characteristic 0..*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
... member I0..*BackboneElementWho or what is in group
.... 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
.... entity 1..1Reference(Patient | Practitioner | PractitionerRole | Device | Medication | Substance | Group)Reference to the group member
.... period 0..1PeriodPeriod member belonged to the group
.... inactive 0..1booleanIf member is no longer in group

doco Documentation for this format

 

Other representations of profile: Schematron

Terminology Bindings

PathConformanceValueSet
Group.languagepreferredCommonLanguages
Max Binding: AllLanguages
Group.typerequiredGroupType
Group.codeexample
Group.characteristic.codeexample
Group.characteristic.value[x]example

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)
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.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.memberAll 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())

Notes:

Notes text for Group resource