From 6d145d350cf2d3e1d241efa0aadd414b0d2c69e7 Mon Sep 17 00:00:00 2001 From: khalid_shahin Date: Wed, 3 Dec 2025 14:35:33 -0500 Subject: [PATCH 1/4] J#45508 updated the Group short and descriptions --- source/group/structuredefinition-Group.xml | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/source/group/structuredefinition-Group.xml b/source/group/structuredefinition-Group.xml index 5ae4e2c9a3..59cb3df055 100644 --- a/source/group/structuredefinition-Group.xml +++ b/source/group/structuredefinition-Group.xml @@ -513,7 +513,7 @@ - + @@ -651,7 +651,7 @@ - + @@ -695,6 +695,7 @@ + @@ -713,7 +714,7 @@ - + @@ -732,7 +733,7 @@ - + @@ -745,7 +746,7 @@ - + @@ -755,8 +756,8 @@ - - + + From c5d713b7ff5f36e601fa6ff25618fb35c0257ff5 Mon Sep 17 00:00:00 2001 From: khalid_shahin Date: Wed, 3 Dec 2025 14:39:56 -0500 Subject: [PATCH 2/4] J#45508 moved "Defining Group Inclusion and Exclusion Criteria" from group-introduction to group-notes --- source/group/group-introduction.xml | 72 ---------------------------- source/group/group-notes.xml | 74 +++++++++++++++++++++++++++++ 2 files changed, 74 insertions(+), 72 deletions(-) diff --git a/source/group/group-introduction.xml b/source/group/group-introduction.xml index 65c7dc054d..5fc9493bf2 100644 --- a/source/group/group-introduction.xml +++ b/source/group/group-introduction.xml @@ -16,78 +16,6 @@

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.

-

Defining Group Inclusion and Exclusion Criteria

-

The Group definition, specifying the criteria for membership in the Group, may be expressed with one or more Group.characteristic elements. Here we describe how the Group StructureDefinition is used to express inclusion and exclusion criteria for group membership.

-

Group.membership

-

Group.membership requires one of three codes:

-
    -
  • 'enumerated': Use this code if the Group Resource lists the group members and/or specifies the number of entities in the group. Use of the 'enumerated' code will require use of the Group.type element.
    • -
  • 'definitional': Use this code if the Group Resource provides structured data (i.e. the Group.characteristic values) that is necessary and sufficient to define the qualifications for group membership (the inclusion and exclusion criteria for defining what makes something a member of the group). Use of the 'definitional' code will require use of the Group.type element. If a group is both enumerated and definitional, then use the enumerated code.
    • -
  • 'conceptual': Use this code if the Group Resource is an abstract representation of a group that is neither enumerated (listing or counting actual members) nor definitional (providing complete definition for membership qualifications). A different use of the 'conceptual' code is when the Group is otherwise 'definitional' but the Group.type cannot be used because the actual type value is not included in FHIR types.
    • -
-

Group.combinationMethod

-

Group.combinationMethod is used when there are two or more Group.characteristic instances to define how the characteristics are combined.

-
    -
  • Use a code 'all-of' to indicate that each of the characteristics must be met. This is functionally equivalent to combining all characteristics with an AND operator.
    • -
  • Use a code 'any-of' to indicate that at least one of the characteristics must be met. This is functionally equivalent to combining all characteristics with an OR operator.
    • -
  • Use a code 'at-least' to indicate that at least n of the characteristics must be met. Use Group.combinationThreshold to specify the value of n.
    • -
  • Use a code 'at-most' to indicate that at most n of the characteristics must be met. Use Group.combinationThreshold to specify the value of n.
    • -
  • Use a code 'except-subset' to indicate that the characteristics expressed as exclusion criteria are used as exceptions to meeting the characteristics expressed as inclusion criteria. Explaining by example: “Cancer of any kind (except basal cell skin cancer or cancer in situ) unless documented to be disease-free for five years” (Example of Group for Cancer Except Subset).
    • -
-

Group.combinationThreshold

-

Provides the value of "n" when "at-least" or "at-most" codes are used for Group.combinationMethod (see above)

-

Group.characteristic.code

-

Each characteristic must have a code value (CodeableConcept datatype) to specify the attribute. For instance:

-
    -
  • for a characteristic of "age > 18 years” the attribute is “age” and the attribute of age may be expressed as
    • -
-

"code": { "coding": [ { "system": "http://snomed.info/sct", "code": "397669002", "display": "Age" } ] }

-
    -
  • for a characteristic of "Body mass index >= 30 kg/m2" the attribute is "Body mass index" and the attribute may be expressed as
    • -
-

"code": { "coding": [ { "system": "http://loinc.org", "code": "39156-5", "display": "Body mass index (BMI) [Ratio]" } ] }

-

Group.characteristic.value[x]

-

Each characteristic must have a value[x] value to specify the value of the attribute that holds for members of the group. There is no [x] in the JSON or XML expression as it is replaced with the data type (CodeableConcept, boolean, Quantity, Range, Reference, uri, or Expression)

-

For instance:

-
    -
  • for a characteristic of "age > 18 years” the value is “> 18 years” and the value may be expressed with a Quantity datatype as
    • -
-

"valueQuantity": { "comparator": ">=", "value": 18, "unit": "years",

-

"system": "http://unitsofmeasure.org", "code": "a" }

-
    -
  • for a characteristic of "Body mass index >= 30 kg/m2" the value is ">= 30 kg/m2" and the value may be expressed as
    • -
-

"valueQuantity": { "comparator": ">=", "value": 30, "unit": "kg/m2",

-

"system": "http://unitsofmeasure.org", "code": "kg/m2" }

-

Group.characteristic.exclude

-

Sometimes group membership is determined by characteristics not possessed. When this is the case, the Group.characteristic.exclude element has a value of true ("exclude": true). For characteristics that are not exclusion criteria, the Group.characteristic.exclude element has a value of false ("exclude": false). The exclude element is required.

-

For example, an exclusion criterion of HbA1c ≥ 14.0% is expressed as:

-

{ "description": "HbA1c ≥ 14.0%", "code": {; "coding": [ { "system": "http://loinc.org", "code": "59261-8", "display": "Hemoglobin A1c/Hemoglobin.total in Blood" } ] }, "valueQuantity": { "value": 14, "comparator": ">=", "unit": "%", "system": "http://unitsofmeasure.org", "code": "%" }, "exclude": true }

-

Group.characteristic.description

-

A short, natural language description of the characteristic (using the markdown datatype) that could be used to communicate the criteria to an end-user. The description element is for convenience so that end users can understand the characteristic and is neither a required part of the characteristic nor part of the structured representation of the characteristic.

-

Group.characteristic.method

-

The method modifies the Group.characteristic.code and indicates how the value is to be determined, using the CodeableConcept datatype. For example, HbA1C values can be determined by High-Performance Liquid Chromatography or by Capillary electrophoresis.

-

The method may be expressed as multiple concepts, eg. standing barefoot for Height measurements could be expressed as two separate concepts (standing, barefoot) that express the method.

-

Group.characteristic.formula

-

The formula modifies the Group.characteristic.code and indicates how the value is to be determined, using an Expression datatype.

-

Group.characteristic.determiner

-

The determiner modifies the Group.characteristic.code and indicates who or what determines the value, using a Reference datatype. The determiner value may reference a person (Practitioner or PractitionerRole Resource) or group (Organization Resource) or device. The reference to a device can be either to a specific device using the Device Resource, or the DeviceMetric Resource if a specific set of device parameters is needed, or a type of device using the DeviceDefinition Resource.

-

Group.characteristic.offset

-

Defines the reference point for comparison when other than 0. As an example, to express a characteristic of a calcium level greater than the normal limit or a hemoglobin level less than 1 g/dL below the reference range, the offset concept would represent "normal limit" or "reference range".

-

This is a modifier element because it modifies the meaning of the characteristic.value[x].

-

Group.characteristic.instances[x]

-

Number of occurrences meeting the characteristic.

-

There should be a constraint on the Quantity.value and Range.low.value and Range.high.value that it can only be non-negative whole numbers.

-

Group.characteristic.duration[x]

-

Length of time in which the characteristic is met.

-

Group.characteristic.period

-

The period over which the characteristic is tested; e.g. the patient had an operation during the month of June.

-

Group.characteristic.timing

-

The relative time in which the characteristic is tested, eg. within a month following patient discharge.

-

Note: RelativeTime is a recent addition to the Group Resource. RelativeTime is used to express a point in time or an interval of time relative to an event defined in data types other than dateTime.

-

Example: Example of Group for HbA1c at 12 months

-

Example includes timing and offset "At 12 months form inclusion in a clinical trial. Inclusion is defined as enrollment via the SNOMED code.

-

"timing": [ { "contextCode": { "coding": [ { "system": "http://snomed.info/sct", "code": "709491003", "display": "Enrollment in clinical trial" } ] }, "offsetDuration": { "value": 12, "unit": "months", "system": "http://unitsofmeasure.org", "code": "mo" }, "text": "at 12 months" }

diff --git a/source/group/group-notes.xml b/source/group/group-notes.xml index 632c7045ce..14a218ace5 100644 --- a/source/group/group-notes.xml +++ b/source/group/group-notes.xml @@ -57,4 +57,78 @@ rather than merely saying "family member". There are a few options to support c such group member explicitly designated, then the nature of the more detailed personal relationship codes cannot reliably be interpreted. + + +

Defining Group Inclusion and Exclusion Criteria

+

The Group definition, specifying the criteria for membership in the Group, may be expressed with one or more Group.characteristic elements. Here we describe how the Group StructureDefinition is used to express inclusion and exclusion criteria for group membership.

+

Group.membership

+

Group.membership requires one of three codes:

+
    +
  • 'enumerated': Use this code if the Group Resource lists the group members and/or specifies the number of entities in the group. Use of the 'enumerated' code will require use of the Group.type element.
    • +
  • 'definitional': Use this code if the Group Resource provides structured data (i.e. the Group.characteristic values) that is necessary and sufficient to define the qualifications for group membership (the inclusion and exclusion criteria for defining what makes something a member of the group). Use of the 'definitional' code will require use of the Group.type element. If a group is both enumerated and definitional, then use the enumerated code.
    • +
  • 'conceptual': Use this code if the Group Resource is an abstract representation of a group that is neither enumerated (listing or counting actual members) nor definitional (providing complete definition for membership qualifications). A different use of the 'conceptual' code is when the Group is otherwise 'definitional' but the Group.type cannot be used because the actual type value is not included in FHIR types.
    • +
+

Group.combinationMethod

+

Group.combinationMethod is used when there are two or more Group.characteristic instances to define how the characteristics are combined.

+
    +
  • Use a code 'all-of' to indicate that each of the characteristics must be met. This is functionally equivalent to combining all characteristics with an AND operator.
    • +
  • Use a code 'any-of' to indicate that at least one of the characteristics must be met. This is functionally equivalent to combining all characteristics with an OR operator.
    • +
  • Use a code 'at-least' to indicate that at least n of the characteristics must be met. Use Group.combinationThreshold to specify the value of n.
    • +
  • Use a code 'at-most' to indicate that at most n of the characteristics must be met. Use Group.combinationThreshold to specify the value of n.
    • +
  • Use a code 'except-subset' to indicate that the characteristics expressed as exclusion criteria are used as exceptions to meeting the characteristics expressed as inclusion criteria. Explaining by example: “Cancer of any kind (except basal cell skin cancer or cancer in situ) unless documented to be disease-free for five years” (Example of Group for Cancer Except Subset).
    • +
+

Group.combinationThreshold

+

Provides the value of "n" when "at-least" or "at-most" codes are used for Group.combinationMethod (see above)

+

Group.characteristic.code

+

Each characteristic must have a code value (CodeableConcept datatype) to specify the attribute. For instance:

+
    +
  • for a characteristic of "age > 18 years” the attribute is “age” and the attribute of age may be expressed as
    • +
+

"code": { "coding": [ { "system": "http://snomed.info/sct", "code": "397669002", "display": "Age" } ] }

+
    +
  • for a characteristic of "Body mass index >= 30 kg/m2" the attribute is "Body mass index" and the attribute may be expressed as
    • +
+

"code": { "coding": [ { "system": "http://loinc.org", "code": "39156-5", "display": "Body mass index (BMI) [Ratio]" } ] }

+

Group.characteristic.value[x]

+

Each characteristic must have a value[x] value to specify the value of the attribute that holds for members of the group. There is no [x] in the JSON or XML expression as it is replaced with the data type (CodeableConcept, boolean, Quantity, Range, Reference, uri, or Expression)

+

For instance:

+
    +
  • for a characteristic of "age > 18 years” the value is “> 18 years” and the value may be expressed with a Quantity datatype as
    • +
+

"valueQuantity": { "comparator": ">=", "value": 18, "unit": "years",

+

"system": "http://unitsofmeasure.org", "code": "a" }

+
    +
  • for a characteristic of "Body mass index >= 30 kg/m2" the value is ">= 30 kg/m2" and the value may be expressed as
    • +
+

"valueQuantity": { "comparator": ">=", "value": 30, "unit": "kg/m2",

+

"system": "http://unitsofmeasure.org", "code": "kg/m2" }

+

Group.characteristic.exclude

+

Sometimes group membership is determined by characteristics not possessed. When this is the case, the Group.characteristic.exclude element has a value of true ("exclude": true). For characteristics that are not exclusion criteria, the Group.characteristic.exclude element has a value of false ("exclude": false). The exclude element is required.

+

For example, an exclusion criterion of HbA1c ≥ 14.0% is expressed as:

+

{ "description": "HbA1c ≥ 14.0%", "code": {; "coding": [ { "system": "http://loinc.org", "code": "59261-8", "display": "Hemoglobin A1c/Hemoglobin.total in Blood" } ] }, "valueQuantity": { "value": 14, "comparator": ">=", "unit": "%", "system": "http://unitsofmeasure.org", "code": "%" }, "exclude": true }

+

Group.characteristic.description

+

A short, natural language description of the characteristic (using the markdown datatype) that could be used to communicate the criteria to an end-user. The description element is for convenience so that end users can understand the characteristic and is neither a required part of the characteristic nor part of the structured representation of the characteristic.

+

Group.characteristic.method

+

The method modifies the Group.characteristic.code and indicates how the value is to be determined, using the CodeableConcept datatype. For example, HbA1C values can be determined by High-Performance Liquid Chromatography or by Capillary electrophoresis.

+

The method may be expressed as multiple concepts, eg. standing barefoot for Height measurements could be expressed as two separate concepts (standing, barefoot) that express the method.

+

Group.characteristic.formula

+

The formula modifies the Group.characteristic.code and indicates how the value is to be determined, using an Expression datatype.

+

Group.characteristic.determiner

+

The determiner modifies the Group.characteristic.code and indicates who or what determines the value, using a Reference datatype. The determiner value may reference a person (Practitioner or PractitionerRole Resource) or group (Organization Resource) or device. The reference to a device can be either to a specific device using the Device Resource, or the DeviceMetric Resource if a specific set of device parameters is needed, or a type of device using the DeviceDefinition Resource.

+

Group.characteristic.offset

+

Defines the reference point for comparison when other than 0. As an example, to express a characteristic of a calcium level greater than the normal limit or a hemoglobin level less than 1 g/dL below the reference range, the offset concept would represent "normal limit" or "reference range".

+

This is a modifier element because it modifies the meaning of the characteristic.value[x].

+

Group.characteristic.instances[x]

+

Number of occurrences meeting the characteristic.

+

There should be a constraint on the Quantity.value and Range.low.value and Range.high.value that it can only be non-negative whole numbers.

+

Group.characteristic.duration[x]

+

Length of time in which the characteristic is met.

+

Group.characteristic.period

+

The period over which the characteristic is tested; e.g. the patient had an operation during the month of June.

+

Group.characteristic.timing

+

The relative time in which the characteristic is tested, eg. within a month following patient discharge.

+

Note: RelativeTime is a recent addition to the Group Resource. RelativeTime is used to express a point in time or an interval of time relative to an event defined in data types other than dateTime.

+

Example: Example of Group for HbA1c at 12 months

+

Example includes timing and offset "At 12 months form inclusion in a clinical trial. Inclusion is defined as enrollment via the SNOMED code.

+

"timing": [ { "contextCode": { "coding": [ { "system": "http://snomed.info/sct", "code": "709491003", "display": "Enrollment in clinical trial" } ] }, "offsetDuration": { "value": 12, "unit": "months", "system": "http://unitsofmeasure.org", "code": "mo" }, "text": "at 12 months" }

From be5c0d9e5bf5f2d7dc70ef16eb8e1645cc3a4b1b Mon Sep 17 00:00:00 2001 From: khalid_shahin Date: Wed, 3 Dec 2025 14:47:21 -0500 Subject: [PATCH 3/4] J#45508 Group notes improvement --- source/group/group-notes.xml | 24 +++++++----------------- 1 file changed, 7 insertions(+), 17 deletions(-) diff --git a/source/group/group-notes.xml b/source/group/group-notes.xml index 14a218ace5..bc1ac623e0 100644 --- a/source/group/group-notes.xml +++ b/source/group/group-notes.xml @@ -77,8 +77,6 @@ rather than merely saying "family member". There are a few options to support c
  • Use a code 'at-most' to indicate that at most n of the characteristics must be met. Use Group.combinationThreshold to specify the value of n.
  • Use a code 'except-subset' to indicate that the characteristics expressed as exclusion criteria are used as exceptions to meeting the characteristics expressed as inclusion criteria. Explaining by example: “Cancer of any kind (except basal cell skin cancer or cancer in situ) unless documented to be disease-free for five years” (Example of Group for Cancer Except Subset).
    • -

    Group.combinationThreshold

    -

    Provides the value of "n" when "at-least" or "at-most" codes are used for Group.combinationMethod (see above)

    Group.characteristic.code

    Each characteristic must have a code value (CodeableConcept datatype) to specify the attribute. For instance:

      @@ -108,25 +106,17 @@ rather than merely saying "family member". There are a few options to support c

      { "description": "HbA1c ≥ 14.0%", "code": {; "coding": [ { "system": "http://loinc.org", "code": "59261-8", "display": "Hemoglobin A1c/Hemoglobin.total in Blood" } ] }, "valueQuantity": { "value": 14, "comparator": ">=", "unit": "%", "system": "http://unitsofmeasure.org", "code": "%" }, "exclude": true }

      Group.characteristic.description

      A short, natural language description of the characteristic (using the markdown datatype) that could be used to communicate the criteria to an end-user. The description element is for convenience so that end users can understand the characteristic and is neither a required part of the characteristic nor part of the structured representation of the characteristic.

      -

      Group.characteristic.method

      -

      The method modifies the Group.characteristic.code and indicates how the value is to be determined, using the CodeableConcept datatype. For example, HbA1C values can be determined by High-Performance Liquid Chromatography or by Capillary electrophoresis.

      +

      Describing how the characteristic value is determined

      +

      The Group.characteristic.method modifies the Group.characteristic.code and indicates how the value is to be determined, using the CodeableConcept datatype. For example, HbA1C values can be determined by High-Performance Liquid Chromatography or by Capillary electrophoresis.

      The method may be expressed as multiple concepts, eg. standing barefoot for Height measurements could be expressed as two separate concepts (standing, barefoot) that express the method.

      -

      Group.characteristic.formula

      -

      The formula modifies the Group.characteristic.code and indicates how the value is to be determined, using an Expression datatype.

      -

      Group.characteristic.determiner

      -

      The determiner modifies the Group.characteristic.code and indicates who or what determines the value, using a Reference datatype. The determiner value may reference a person (Practitioner or PractitionerRole Resource) or group (Organization Resource) or device. The reference to a device can be either to a specific device using the Device Resource, or the DeviceMetric Resource if a specific set of device parameters is needed, or a type of device using the DeviceDefinition Resource.

      +

      The Group.characteristic.formula modifies the Group.characteristic.code and indicates how the value is to be determined, using an Expression datatype.

      +

      The Group.characteristic.determiner modifies the Group.characteristic.code and indicates who or what determines the value, using a Reference datatype. The determiner value may reference a person (Practitioner or PractitionerRole Resource) or group (Organization Resource) or device. The reference to a device can be either to a specific device using the Device Resource, or the DeviceMetric Resource if a specific set of device parameters is needed, or a type of device using the DeviceDefinition Resource.

      Group.characteristic.offset

      Defines the reference point for comparison when other than 0. As an example, to express a characteristic of a calcium level greater than the normal limit or a hemoglobin level less than 1 g/dL below the reference range, the offset concept would represent "normal limit" or "reference range".

      This is a modifier element because it modifies the meaning of the characteristic.value[x].

      -

      Group.characteristic.instances[x]

      -

      Number of occurrences meeting the characteristic.

      -

      There should be a constraint on the Quantity.value and Range.low.value and Range.high.value that it can only be non-negative whole numbers.

      -

      Group.characteristic.duration[x]

      -

      Length of time in which the characteristic is met.

      -

      Group.characteristic.period

      -

      The period over which the characteristic is tested; e.g. the patient had an operation during the month of June.

      -

      Group.characteristic.timing

      -

      The relative time in which the characteristic is tested, eg. within a month following patient discharge.

      +

      Describing when the characteristic value is present

      +

      The Group.characteristic.period describes when the characteristic value is present in calendar time; e.g. the patient had an operation during the month of June.

      +

      The Group.characteristic.timing describes when the characteristic value is present with respect to an event; e.g. within a month following patient discharge.

      Note: RelativeTime is a recent addition to the Group Resource. RelativeTime is used to express a point in time or an interval of time relative to an event defined in data types other than dateTime.

      Example: Example of Group for HbA1c at 12 months

      Example includes timing and offset "At 12 months form inclusion in a clinical trial. Inclusion is defined as enrollment via the SNOMED code.

      From 8892f7afb459a1e8cb5c13aa6118fd8f05c49c20 Mon Sep 17 00:00:00 2001 From: khalid_shahin Date: Wed, 10 Dec 2025 13:07:34 -0500 Subject: [PATCH 4/4] J#45508 changed the element name from timing to relativeTime --- ...tualcohortdefinition-cancer-except-subset.xml | 4 ++-- ...le-eligibility-criteria-ada-rec-bariatric.xml | 16 ++++++++-------- ...mple-outcomedefinition-hba1c-at-12-months.xml | 4 ++-- source/group/group-notes.xml | 6 +++--- source/group/structuredefinition-Group.xml | 4 ++-- 5 files changed, 17 insertions(+), 17 deletions(-) diff --git a/source/group/group-example-conceptualcohortdefinition-cancer-except-subset.xml b/source/group/group-example-conceptualcohortdefinition-cancer-except-subset.xml index 465ffe4ffc..5c8c748562 100644 --- a/source/group/group-example-conceptualcohortdefinition-cancer-except-subset.xml +++ b/source/group/group-example-conceptualcohortdefinition-cancer-except-subset.xml @@ -108,7 +108,7 @@ - + @@ -131,6 +131,6 @@ - + diff --git a/source/group/group-example-eligibility-criteria-ada-rec-bariatric.xml b/source/group/group-example-eligibility-criteria-ada-rec-bariatric.xml index 1b6b1a2cf8..f1fbc0b8f2 100644 --- a/source/group/group-example-eligibility-criteria-ada-rec-bariatric.xml +++ b/source/group/group-example-eligibility-criteria-ada-rec-bariatric.xml @@ -373,7 +373,7 @@ - + @@ -389,7 +389,7 @@ - + @@ -484,7 +484,7 @@ - + @@ -500,7 +500,7 @@ - + @@ -547,7 +547,7 @@ - + @@ -563,7 +563,7 @@ - + @@ -582,7 +582,7 @@ - + @@ -598,7 +598,7 @@ - + diff --git a/source/group/group-example-outcomedefinition-hba1c-at-12-months.xml b/source/group/group-example-outcomedefinition-hba1c-at-12-months.xml index 6cf27a05a1..2ad0ff0e41 100644 --- a/source/group/group-example-outcomedefinition-hba1c-at-12-months.xml +++ b/source/group/group-example-outcomedefinition-hba1c-at-12-months.xml @@ -38,7 +38,7 @@ - + @@ -53,6 +53,6 @@ - + diff --git a/source/group/group-notes.xml b/source/group/group-notes.xml index bc1ac623e0..3f7af417d7 100644 --- a/source/group/group-notes.xml +++ b/source/group/group-notes.xml @@ -116,9 +116,9 @@ rather than merely saying "family member". There are a few options to support c

      This is a modifier element because it modifies the meaning of the characteristic.value[x].

      Describing when the characteristic value is present

      The Group.characteristic.period describes when the characteristic value is present in calendar time; e.g. the patient had an operation during the month of June.

      -

      The Group.characteristic.timing describes when the characteristic value is present with respect to an event; e.g. within a month following patient discharge.

      +

      The Group.characteristic.relativeTime describes when the characteristic value is present with respect to an event; e.g. within a month following patient discharge.

      Note: RelativeTime is a recent addition to the Group Resource. RelativeTime is used to express a point in time or an interval of time relative to an event defined in data types other than dateTime.

      Example: Example of Group for HbA1c at 12 months

      -

      Example includes timing and offset "At 12 months form inclusion in a clinical trial. Inclusion is defined as enrollment via the SNOMED code.

      -

      "timing": [ { "contextCode": { "coding": [ { "system": "http://snomed.info/sct", "code": "709491003", "display": "Enrollment in clinical trial" } ] }, "offsetDuration": { "value": 12, "unit": "months", "system": "http://unitsofmeasure.org", "code": "mo" }, "text": "at 12 months" }

      +

      Example includes relativeTime and offset "At 12 months form inclusion in a clinical trial. Inclusion is defined as enrollment via the SNOMED code.

      +

      "relativeTime": [ { "contextCode": { "coding": [ { "system": "http://snomed.info/sct", "code": "709491003", "display": "Enrollment in clinical trial" } ] }, "offsetDuration": { "value": 12, "unit": "months", "system": "http://unitsofmeasure.org", "code": "mo" }, "text": "at 12 months" }

      diff --git a/source/group/structuredefinition-Group.xml b/source/group/structuredefinition-Group.xml index 59cb3df055..5e55b4fe8b 100644 --- a/source/group/structuredefinition-Group.xml +++ b/source/group/structuredefinition-Group.xml @@ -754,8 +754,8 @@ - - + +