National Directory of Healthcare Providers & Services (NDH) Implementation Guide
2.0.0-current - ci-build

National Directory of Healthcare Providers & Services (NDH) Implementation Guide, published by HL7 International / Patient Administration. This guide is not an authorized publication; it is the continuous build for version 2.0.0-current built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhir-us-ndh/ and changes regularly. See the Directory of published versions

## Resource Profile: NDH Group

Official URL: http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Group | Version: 2.0.0-current
Standards status: Trial-use | Maturity Level: 4 | Computable Name: NdhGroup

The NDH Group represents a group of multi-disciplinary providers organized around a specific healthcare program or service, not an individual patient. For example, a diabetic care team may include an endocrinologist, a diabetes educator, and a nutritionist.

Usages:

- Examples for this Profile: Behavioral Health Group
- CapabilityStatements using this Profile: NDH Server Capability Statement

You can also check for usages in the FHIR IG Statistics

### Formal Views of Profile Content

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

- Key Elements Table
- Differential Table
- Snapshot Table
- Statistics/References
- All

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Group | C | 0..* | Group | Group of multiple entities Constraints: grp-1
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
Slices for extension |  | 0..* | Extension | Extension Slice: Unordered, Open by value:url
extension:location |  | 0..* | Reference(NDH Location Profile) | Network coverage area URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-location-reference
extension:endpoint |  | 0..* | Reference(NDH Endpoint Profile) | Endpoint Reference URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-endpoint-reference
extension:verification-status |  | 0..1 | CodeableConcept | Group Verification Status URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-verification-status Binding: NDH Verification Status Value Set (extensible)
extension:artifact-description |  | 0..1 | markdown | Group Description URL: http://hl7.org/fhir/StructureDefinition/artifact-description
extension:artifact-effectivePeriod |  | 0..1 | Period | Group Effective Period URL: http://hl7.org/fhir/StructureDefinition/artifact-effectivePeriod
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
identifier | S Σ | 0..* | Identifier | Unique id
active | S Σ | 1..1 | boolean | Whether this group's record is in active use Fixed Value: true
type | Σ | 1..1 | code | person | animal | practitioner | device | medication | substance Binding: GroupType (required): Types of resources that are part of group. Fixed Value: practitioner
actual | Σ C | 1..1 | boolean | Descriptive or actual Fixed Value: true
code | S Σ | 1..1 | CodeableConcept | Kind of Group members Binding: Healthcare Service Category Value Set (extensible)
name | S Σ | 1..1 | string | Label for Group
managingEntity | S Σ | 0..1 | Reference(NDH Organization Profile) | Entity that is the custodian of the Group's definition
member | S C | 0..* | BackboneElement | Who or what is in group
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
entity |  | 1..1 | Reference(NDH Practitioner Profile | NDH PractitionerRole) | Reference to the group member
period | S | 0..1 | Period | Period member belonged to the group
inactive | S | 0..1 | boolean | If member is no longer in group
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Group.type | Base | required | GroupType | 📍4.0.1 | FHIR Std.
Group.code | Base | extensible | Healthcare Service Category Value Set | 📦2.0.0-current | This IG

#### Constraints

Id | Grade | Path(s) | Description | Expression
dom-2 | error | Group | If the resource is contained in another resource, it SHALL NOT contain nested Resources | `contained.contained.empty()`
dom-3 | error | 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 | error | 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 | error | Group | If a resource is contained in another resource, it SHALL NOT have a security label | `contained.meta.security.empty()`
dom-6 | best practice | Group | A resource should have narrative for robust management | `text.`div`.exists()`
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`
grp-1 | error | Group | Can only have members if group is "actual" | `member.empty() or (actual = true)`

This structure is derived from Group

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Group |  | 0..* | Group | Group of multiple entities
meta |  |  |  |
lastUpdated |  | 1..1 | instant | When the resource version last changed
Slices for extension |  | 0..* | Extension | Extension Slice: Unordered, Open by value:url
extension:location |  | 0..* | Reference(NDH Location Profile) | Network coverage area URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-location-reference
extension:endpoint |  | 0..* | Reference(NDH Endpoint Profile) | Endpoint Reference URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-endpoint-reference
extension:verification-status |  | 0..1 | CodeableConcept | Group Verification Status URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-verification-status Binding: NDH Verification Status Value Set (extensible)
extension:artifact-description |  | 0..1 | markdown | Group Description URL: http://hl7.org/fhir/StructureDefinition/artifact-description
extension:artifact-effectivePeriod |  | 0..1 | Period | Group Effective Period URL: http://hl7.org/fhir/StructureDefinition/artifact-effectivePeriod
identifier | S | 0..* | Identifier | Unique id
active | S | 1..1 | boolean | Whether this group's record is in active use Fixed Value: true
type |  | 1..1 | code | person | animal | practitioner | device | medication | substance Fixed Value: practitioner
actual |  | 1..1 | boolean | Descriptive or actual Fixed Value: true
code | S | 1..1 | CodeableConcept | Kind of Group members Binding: Healthcare Service Category Value Set (extensible)
name | S | 1..1 | string | Label for Group
managingEntity | S | 0..1 | Reference(NDH Organization Profile) | Entity that is the custodian of the Group's definition
member | S | 0..* | BackboneElement | Who or what is in group
entity |  | 1..1 | Reference(NDH Practitioner Profile | NDH PractitionerRole) | Reference to the group member
period | S | 0..1 | Period | Period member belonged to the group
inactive | S | 0..1 | boolean | If member is no longer in group
Documentation for this format

#### Terminology Bindings (Differential)

Path | Status | Usage | ValueSet | Version | Source
Group.code | Base | extensible | Healthcare Service Category Value Set | 📦2.0.0-current | This IG

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Group | C | 0..* | Group | Group of multiple entities Constraints: grp-1
id | Σ | 0..1 | id | Logical id of this artifact
meta | Σ | 0..1 | Meta | Metadata about the resource
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
versionId | Σ | 0..1 | id | Version specific identifier
lastUpdated | Σ | 1..1 | instant | When the resource version last changed
source | Σ | 0..1 | uri | Identifies where the resource comes from
profile | Σ | 0..* | canonical(StructureDefinition) | Profiles this resource claims to conform to
security | Σ | 0..* | Coding | Security Labels applied to this resource Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System.
tag | Σ | 0..* | Coding | Tags applied to this resource Binding: CommonTags (example): Codes that represent various types of tags, commonly workflow-related; e.g. "Needs review by Dr. Jones".
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): A human language.
Additional Bindings | Purpose
AllLanguages | Max Binding
text |  | 0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained |  | 0..* | Resource | Contained, inline Resources
Slices for extension |  | 0..* | Extension | Extension Slice: Unordered, Open by value:url
extension:location |  | 0..* | Reference(NDH Location Profile) | Network coverage area URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-location-reference
extension:endpoint |  | 0..* | Reference(NDH Endpoint Profile) | Endpoint Reference URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-endpoint-reference
extension:verification-status |  | 0..1 | CodeableConcept | Group Verification Status URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-verification-status Binding: NDH Verification Status Value Set (extensible)
extension:artifact-description |  | 0..1 | markdown | Group Description URL: http://hl7.org/fhir/StructureDefinition/artifact-description
extension:artifact-effectivePeriod |  | 0..1 | Period | Group Effective Period URL: http://hl7.org/fhir/StructureDefinition/artifact-effectivePeriod
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
identifier | S Σ | 0..* | Identifier | Unique id
active | S Σ | 1..1 | boolean | Whether this group's record is in active use Fixed Value: true
type | Σ | 1..1 | code | person | animal | practitioner | device | medication | substance Binding: GroupType (required): Types of resources that are part of group. Fixed Value: practitioner
actual | Σ C | 1..1 | boolean | Descriptive or actual Fixed Value: true
code | S Σ | 1..1 | CodeableConcept | Kind of Group members Binding: Healthcare Service Category Value Set (extensible)
name | S Σ | 1..1 | string | Label for Group
quantity | Σ | 0..1 | unsignedInt | Number of members
managingEntity | S Σ | 0..1 | Reference(NDH Organization Profile) | 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 Description: (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 Description: (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 | S C | 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(NDH Practitioner Profile | NDH PractitionerRole) | Reference to the group member
period | S | 0..1 | Period | Period member belonged to the group
inactive | S | 0..1 | boolean | If member is no longer in group
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Group.meta.security | Base | extensible | SecurityLabels | 📍4.0.1 | FHIR Std.
Group.meta.tag | Base | example | Common Tags | 📍4.0.1 | FHIR Std.
Group.language | Base | preferred | Common Languages | 📍4.0.1 | FHIR Std.
Group.type | Base | required | GroupType | 📍4.0.1 | FHIR Std.
Group.code | Base | extensible | Healthcare Service Category Value Set | 📦2.0.0-current | This IG
Group.characteristic.​code | Base | example |  | Not State | Unknown
Group.characteristic.​value[x] | Base | example |  | Not State | Unknown

#### Constraints

Id | Grade | Path(s) | Description | Expression
dom-2 | error | Group | If the resource is contained in another resource, it SHALL NOT contain nested Resources | `contained.contained.empty()`
dom-3 | error | 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 | error | 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 | error | Group | If a resource is contained in another resource, it SHALL NOT have a security label | `contained.meta.security.empty()`
dom-6 | best practice | Group | A resource should have narrative for robust management | `text.`div`.exists()`
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`
grp-1 | error | Group | Can only have members if group is "actual" | `member.empty() or (actual = true)`

This structure is derived from Group

Summary

Mandatory: 3 elements(1 nested mandatory element)
Must-Support: 8 elements
Fixed: 3 elements

Structures

This structure refers to these other structures:

- NDH Organization Profile (http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Organization)
- NDH Practitioner Profile (http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Practitioner)
- NDH PractitionerRole (http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-PractitionerRole)

Extensions

This structure refers to these extensions:

- http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-location-reference
- http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-endpoint-reference
- http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-verification-status
- http://hl7.org/fhir/StructureDefinition/artifact-description|5.2.0
- http://hl7.org/fhir/StructureDefinition/artifact-effectivePeriod|5.2.0

Maturity: 4

Key Elements View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Group | C | 0..* | Group | Group of multiple entities Constraints: grp-1
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
Slices for extension |  | 0..* | Extension | Extension Slice: Unordered, Open by value:url
extension:location |  | 0..* | Reference(NDH Location Profile) | Network coverage area URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-location-reference
extension:endpoint |  | 0..* | Reference(NDH Endpoint Profile) | Endpoint Reference URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-endpoint-reference
extension:verification-status |  | 0..1 | CodeableConcept | Group Verification Status URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-verification-status Binding: NDH Verification Status Value Set (extensible)
extension:artifact-description |  | 0..1 | markdown | Group Description URL: http://hl7.org/fhir/StructureDefinition/artifact-description
extension:artifact-effectivePeriod |  | 0..1 | Period | Group Effective Period URL: http://hl7.org/fhir/StructureDefinition/artifact-effectivePeriod
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
identifier | S Σ | 0..* | Identifier | Unique id
active | S Σ | 1..1 | boolean | Whether this group's record is in active use Fixed Value: true
type | Σ | 1..1 | code | person | animal | practitioner | device | medication | substance Binding: GroupType (required): Types of resources that are part of group. Fixed Value: practitioner
actual | Σ C | 1..1 | boolean | Descriptive or actual Fixed Value: true
code | S Σ | 1..1 | CodeableConcept | Kind of Group members Binding: Healthcare Service Category Value Set (extensible)
name | S Σ | 1..1 | string | Label for Group
managingEntity | S Σ | 0..1 | Reference(NDH Organization Profile) | Entity that is the custodian of the Group's definition
member | S C | 0..* | BackboneElement | Who or what is in group
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
entity |  | 1..1 | Reference(NDH Practitioner Profile | NDH PractitionerRole) | Reference to the group member
period | S | 0..1 | Period | Period member belonged to the group
inactive | S | 0..1 | boolean | If member is no longer in group
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Group.type | Base | required | GroupType | 📍4.0.1 | FHIR Std.
Group.code | Base | extensible | Healthcare Service Category Value Set | 📦2.0.0-current | This IG

#### Constraints

Id | Grade | Path(s) | Description | Expression
dom-2 | error | Group | If the resource is contained in another resource, it SHALL NOT contain nested Resources | `contained.contained.empty()`
dom-3 | error | 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 | error | 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 | error | Group | If a resource is contained in another resource, it SHALL NOT have a security label | `contained.meta.security.empty()`
dom-6 | best practice | Group | A resource should have narrative for robust management | `text.`div`.exists()`
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`
grp-1 | error | Group | Can only have members if group is "actual" | `member.empty() or (actual = true)`

Differential View

This structure is derived from Group

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Group |  | 0..* | Group | Group of multiple entities
meta |  |  |  |
lastUpdated |  | 1..1 | instant | When the resource version last changed
Slices for extension |  | 0..* | Extension | Extension Slice: Unordered, Open by value:url
extension:location |  | 0..* | Reference(NDH Location Profile) | Network coverage area URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-location-reference
extension:endpoint |  | 0..* | Reference(NDH Endpoint Profile) | Endpoint Reference URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-endpoint-reference
extension:verification-status |  | 0..1 | CodeableConcept | Group Verification Status URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-verification-status Binding: NDH Verification Status Value Set (extensible)
extension:artifact-description |  | 0..1 | markdown | Group Description URL: http://hl7.org/fhir/StructureDefinition/artifact-description
extension:artifact-effectivePeriod |  | 0..1 | Period | Group Effective Period URL: http://hl7.org/fhir/StructureDefinition/artifact-effectivePeriod
identifier | S | 0..* | Identifier | Unique id
active | S | 1..1 | boolean | Whether this group's record is in active use Fixed Value: true
type |  | 1..1 | code | person | animal | practitioner | device | medication | substance Fixed Value: practitioner
actual |  | 1..1 | boolean | Descriptive or actual Fixed Value: true
code | S | 1..1 | CodeableConcept | Kind of Group members Binding: Healthcare Service Category Value Set (extensible)
name | S | 1..1 | string | Label for Group
managingEntity | S | 0..1 | Reference(NDH Organization Profile) | Entity that is the custodian of the Group's definition
member | S | 0..* | BackboneElement | Who or what is in group
entity |  | 1..1 | Reference(NDH Practitioner Profile | NDH PractitionerRole) | Reference to the group member
period | S | 0..1 | Period | Period member belonged to the group
inactive | S | 0..1 | boolean | If member is no longer in group
Documentation for this format

#### Terminology Bindings (Differential)

Path | Status | Usage | ValueSet | Version | Source
Group.code | Base | extensible | Healthcare Service Category Value Set | 📦2.0.0-current | This IG

Snapshot View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Group | C | 0..* | Group | Group of multiple entities Constraints: grp-1
id | Σ | 0..1 | id | Logical id of this artifact
meta | Σ | 0..1 | Meta | Metadata about the resource
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
versionId | Σ | 0..1 | id | Version specific identifier
lastUpdated | Σ | 1..1 | instant | When the resource version last changed
source | Σ | 0..1 | uri | Identifies where the resource comes from
profile | Σ | 0..* | canonical(StructureDefinition) | Profiles this resource claims to conform to
security | Σ | 0..* | Coding | Security Labels applied to this resource Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System.
tag | Σ | 0..* | Coding | Tags applied to this resource Binding: CommonTags (example): Codes that represent various types of tags, commonly workflow-related; e.g. "Needs review by Dr. Jones".
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): A human language.
Additional Bindings | Purpose
AllLanguages | Max Binding
text |  | 0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained |  | 0..* | Resource | Contained, inline Resources
Slices for extension |  | 0..* | Extension | Extension Slice: Unordered, Open by value:url
extension:location |  | 0..* | Reference(NDH Location Profile) | Network coverage area URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-location-reference
extension:endpoint |  | 0..* | Reference(NDH Endpoint Profile) | Endpoint Reference URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-endpoint-reference
extension:verification-status |  | 0..1 | CodeableConcept | Group Verification Status URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-verification-status Binding: NDH Verification Status Value Set (extensible)
extension:artifact-description |  | 0..1 | markdown | Group Description URL: http://hl7.org/fhir/StructureDefinition/artifact-description
extension:artifact-effectivePeriod |  | 0..1 | Period | Group Effective Period URL: http://hl7.org/fhir/StructureDefinition/artifact-effectivePeriod
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
identifier | S Σ | 0..* | Identifier | Unique id
active | S Σ | 1..1 | boolean | Whether this group's record is in active use Fixed Value: true
type | Σ | 1..1 | code | person | animal | practitioner | device | medication | substance Binding: GroupType (required): Types of resources that are part of group. Fixed Value: practitioner
actual | Σ C | 1..1 | boolean | Descriptive or actual Fixed Value: true
code | S Σ | 1..1 | CodeableConcept | Kind of Group members Binding: Healthcare Service Category Value Set (extensible)
name | S Σ | 1..1 | string | Label for Group
quantity | Σ | 0..1 | unsignedInt | Number of members
managingEntity | S Σ | 0..1 | Reference(NDH Organization Profile) | 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 Description: (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 Description: (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 | S C | 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(NDH Practitioner Profile | NDH PractitionerRole) | Reference to the group member
period | S | 0..1 | Period | Period member belonged to the group
inactive | S | 0..1 | boolean | If member is no longer in group
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Group.meta.security | Base | extensible | SecurityLabels | 📍4.0.1 | FHIR Std.
Group.meta.tag | Base | example | Common Tags | 📍4.0.1 | FHIR Std.
Group.language | Base | preferred | Common Languages | 📍4.0.1 | FHIR Std.
Group.type | Base | required | GroupType | 📍4.0.1 | FHIR Std.
Group.code | Base | extensible | Healthcare Service Category Value Set | 📦2.0.0-current | This IG
Group.characteristic.​code | Base | example |  | Not State | Unknown
Group.characteristic.​value[x] | Base | example |  | Not State | Unknown

#### Constraints

Id | Grade | Path(s) | Description | Expression
dom-2 | error | Group | If the resource is contained in another resource, it SHALL NOT contain nested Resources | `contained.contained.empty()`
dom-3 | error | 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 | error | 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 | error | Group | If a resource is contained in another resource, it SHALL NOT have a security label | `contained.meta.security.empty()`
dom-6 | best practice | Group | A resource should have narrative for robust management | `text.`div`.exists()`
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`
grp-1 | error | Group | Can only have members if group is "actual" | `member.empty() or (actual = true)`

This structure is derived from Group

Summary

Mandatory: 3 elements(1 nested mandatory element)
Must-Support: 8 elements
Fixed: 3 elements

Structures

This structure refers to these other structures:

- NDH Organization Profile (http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Organization)
- NDH Practitioner Profile (http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Practitioner)
- NDH PractitionerRole (http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-PractitionerRole)

Extensions

This structure refers to these extensions:

- http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-location-reference
- http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-endpoint-reference
- http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-verification-status
- http://hl7.org/fhir/StructureDefinition/artifact-description|5.2.0
- http://hl7.org/fhir/StructureDefinition/artifact-effectivePeriod|5.2.0

Maturity: 4

Other representations of profile: CSV, Excel, Schematron

### Notes:

### Search Parameters

#### Search Parameter defined by the NDH IG

None defined.

#### Search Parameter defined by FHIR Search Parameter Registry and used by the NDH IG

Since there is no direct individual url for each Search Parameter defined by FHIR Serach Parameter Registry, we have provided the following links for you to access more information about them.

- Search Parameter Registry
- Group Search Parameter from Registry

SearchParameter Name | Type | Example
--- | --- | ---
member | reference | `GET [base]/Group?member=Patient/123`
managing-entity | reference | `GET [base]/Group?managing-entity={system}|{value}`
type | token | `GET [base]/Group?type=some-type`
code | token | `GET [base]/Group?code=some-code`

#### _include Search Parameter

None defined.

#### _revinclude Search parameter

None defined.

#### Special Search Parameters

None defined.