This page is part of the CCDA: Consolidated CDA Release (v3.0.0-ballot: CCDA 3.0 Ballot 1) based on FHIR (HL7® FHIR® Standard) v5.0.0. . For a full list of available versions, see the Directory of published versions
Official URL: http://hl7.org/cda/us/ccda/StructureDefinition/MedicationAdherence | Version: 3.0.0-ballot | |||
Draft as of 2023-12-21 | Computable Name: MedicationAdherence | |||
Other Identifiers: id: urn:hl7ii:2.16.840.1.113883.10.20.22.4.508:2023-05-01 |
This profile represents whether a medication has been consumed according to instructions.
Usage:
Description of Profiles, Differentials, Snapshots and how the different presentations work.
This structure is derived from Observation
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Observation | C | 1..1 | Observation | XML Namespace: urn:hl7-org:v3 Elements defined in Ancestors: @nullFlavor, realmCode, typeId, templateId, @classCode, @moodCode, @negationInd, id, code, derivationExpr, text, statusCode, effectiveTime, priorityCode, repeatNumber, languageCode, value, interpretationCode, methodCode, targetSiteCode, subject, specimen, performer, author, informant, participant, entryRelationship, reference, precondition, sdtcPrecondition2, referenceRange, sdtcInFulfillmentOf1 Base for all types and resources Instances of this type are validated by templateId Logical Container: ClinicalDocument (CDA Class) should-text-ref-value: SHOULD contain text/reference/@value should-informant: SHOULD contain informant |
Slices for templateId | 1..* | II | Slice: Unordered, Open by value:root, value:extension | |
templateId:med-adherence | 1..1 | II | ||
@root | 1..1 | oid, uuid, ruid | Required Pattern: 2.16.840.1.113883.10.20.22.4.508 | |
@extension | 1..1 | st | Required Pattern: 2023-05-01 | |
@moodCode | 1..1 | cs | Fixed Value: EVN | |
id | 1..* | II | ||
code | 1..1 | CD | Adherence to prescribed medication instructions [Reported] | |
@code | 1..1 | cs | Required Pattern: 71799-1 | |
@codeSystem | 1..1 | oid, uuid, ruid | LOINC Required Pattern: 2.16.840.1.113883.6.1 | |
text | 0..1 | ED | SHOULD reference the portion of section narrative text corresponding to this entry | |
reference | C | 0..1 | TEL | value-starts-octothorpe: If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative |
statusCode | 1..1 | CS | ||
effectiveTime | 1..1 | IVL_TS | ||
value | 1..1 | CD | ||
@code | 1..1 | cs | Binding: Medication Adherence SCT (extensible) | |
informant | 0..* | Informant | (USCDI) 'The person or organization that provided the information about the medication adherence.' | |
Documentation for this format |
Path | Conformance | ValueSet |
Observation.value.code | extensible | MedicationAdherenceSCT |
Id | Grade | Path(s) | Details | Requirements |
should-informant | warning | Observation | SHOULD contain informant : informant.exists() | |
should-text-ref-value | warning | Observation | SHOULD contain text/reference/@value : text.reference.value.exists() | |
value-starts-octothorpe | error | Observation.text.reference | If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative : value.exists() implies value.startsWith('#') |
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Observation | C | 1..1 | Observation | XML Namespace: urn:hl7-org:v3 Elements defined in Ancestors: @nullFlavor, realmCode, typeId, templateId, @classCode, @moodCode, @negationInd, id, code, derivationExpr, text, statusCode, effectiveTime, priorityCode, repeatNumber, languageCode, value, interpretationCode, methodCode, targetSiteCode, subject, specimen, performer, author, informant, participant, entryRelationship, reference, precondition, sdtcPrecondition2, referenceRange, sdtcInFulfillmentOf1 Base for all types and resources Instances of this type are validated by templateId Logical Container: ClinicalDocument (CDA Class) should-text-ref-value: SHOULD contain text/reference/@value should-informant: SHOULD contain informant |
Slices for templateId | 1..* | II | Slice: Unordered, Open by value:root, value:extension | |
templateId:med-adherence | 1..1 | II | ||
@root | 1..1 | oid, uuid, ruid | Required Pattern: 2.16.840.1.113883.10.20.22.4.508 | |
@extension | 1..1 | st | Required Pattern: 2023-05-01 | |
@classCode | 1..1 | cs | Binding: ActClassObservation (2.0.0) (required) | |
@moodCode | 1..1 | cs | Binding: XActMoodDocumentObservation (2.0.0) (required) Fixed Value: EVN | |
id | 1..* | II | ||
code | 1..1 | CD | Adherence to prescribed medication instructions [Reported] Binding: ObservationType (example) | |
@code | 1..1 | cs | Required Pattern: 71799-1 | |
@codeSystem | 1..1 | oid, uuid, ruid | LOINC Required Pattern: 2.16.840.1.113883.6.1 | |
text | 0..1 | ED | SHOULD reference the portion of section narrative text corresponding to this entry | |
reference | C | 0..1 | TEL | value-starts-octothorpe: If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative |
statusCode | 1..1 | CS | Binding: ActStatus (required) | |
effectiveTime | 1..1 | IVL_TS | ||
value | 1..1 | CD | ||
@code | 1..1 | cs | Binding: Medication Adherence SCT (extensible) | |
informant | 0..* | Informant | (USCDI) 'The person or organization that provided the information about the medication adherence.' | |
Documentation for this format |
Path | Conformance | ValueSet / Code |
Observation.classCode | required | ActClassObservation |
Observation.moodCode | required | Fixed Value: EVN |
Observation.code | example | ObservationType |
Observation.statusCode | required | ActStatus |
Observation.value.code | extensible | MedicationAdherenceSCT |
Id | Grade | Path(s) | Details | Requirements |
should-informant | warning | Observation | SHOULD contain informant : informant.exists() | |
should-text-ref-value | warning | Observation | SHOULD contain text/reference/@value : text.reference.value.exists() | |
value-starts-octothorpe | error | Observation.text.reference | If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative : value.exists() implies value.startsWith('#') |
Path | Conformance | ValueSet / Code |
Observation.nullFlavor | required | CDANullFlavor |
Observation.typeId.nullFlavor | required | CDANullFlavor |
Observation.templateId:med-adherence.nullFlavor | required | CDANullFlavor |
Observation.classCode | required | ActClassObservation |
Observation.moodCode | required | Fixed Value: EVN |
Observation.code | example | ObservationType |
Observation.code.nullFlavor | required | CDANullFlavor |
Observation.text.nullFlavor | required | CDANullFlavor |
Observation.text.compression | required | CDACompressionAlgorithm |
Observation.text.integrityCheckAlgorithm | required | IntegrityCheckAlgorithm |
Observation.text.mediaType | example | MediaType |
Observation.text.representation | required | BinaryDataEncoding |
Observation.statusCode | required | ActStatus |
Observation.priorityCode | example | ActPriority |
Observation.languageCode | required | AllLanguages |
Observation.value.nullFlavor | required | CDANullFlavor |
Observation.value.code | extensible | MedicationAdherenceSCT |
Observation.interpretationCode | required | ObservationInterpretation |
Observation.methodCode | example | ObservationMethod |
Observation.referenceRange.nullFlavor | required | CDANullFlavor |
Observation.referenceRange.typeId.nullFlavor | required | CDANullFlavor |
Observation.referenceRange.typeCode | required | Fixed Value: REFV |
Id | Grade | Path(s) | Details | Requirements |
should-informant | warning | Observation | SHOULD contain informant : informant.exists() | |
should-text-ref-value | warning | Observation | SHOULD contain text/reference/@value : text.reference.value.exists() | |
value-starts-octothorpe | error | Observation.text.reference | If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative : value.exists() implies value.startsWith('#') |
This structure is derived from Observation
Summary
Mandatory: 11 elements
Fixed Value: 1 element
Slices
This structure defines the following Slices:
Differential View
This structure is derived from Observation
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Observation | C | 1..1 | Observation | XML Namespace: urn:hl7-org:v3 Elements defined in Ancestors: @nullFlavor, realmCode, typeId, templateId, @classCode, @moodCode, @negationInd, id, code, derivationExpr, text, statusCode, effectiveTime, priorityCode, repeatNumber, languageCode, value, interpretationCode, methodCode, targetSiteCode, subject, specimen, performer, author, informant, participant, entryRelationship, reference, precondition, sdtcPrecondition2, referenceRange, sdtcInFulfillmentOf1 Base for all types and resources Instances of this type are validated by templateId Logical Container: ClinicalDocument (CDA Class) should-text-ref-value: SHOULD contain text/reference/@value should-informant: SHOULD contain informant |
Slices for templateId | 1..* | II | Slice: Unordered, Open by value:root, value:extension | |
templateId:med-adherence | 1..1 | II | ||
@root | 1..1 | oid, uuid, ruid | Required Pattern: 2.16.840.1.113883.10.20.22.4.508 | |
@extension | 1..1 | st | Required Pattern: 2023-05-01 | |
@moodCode | 1..1 | cs | Fixed Value: EVN | |
id | 1..* | II | ||
code | 1..1 | CD | Adherence to prescribed medication instructions [Reported] | |
@code | 1..1 | cs | Required Pattern: 71799-1 | |
@codeSystem | 1..1 | oid, uuid, ruid | LOINC Required Pattern: 2.16.840.1.113883.6.1 | |
text | 0..1 | ED | SHOULD reference the portion of section narrative text corresponding to this entry | |
reference | C | 0..1 | TEL | value-starts-octothorpe: If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative |
statusCode | 1..1 | CS | ||
effectiveTime | 1..1 | IVL_TS | ||
value | 1..1 | CD | ||
@code | 1..1 | cs | Binding: Medication Adherence SCT (extensible) | |
informant | 0..* | Informant | (USCDI) 'The person or organization that provided the information about the medication adherence.' | |
Documentation for this format |
Path | Conformance | ValueSet |
Observation.value.code | extensible | MedicationAdherenceSCT |
Id | Grade | Path(s) | Details | Requirements |
should-informant | warning | Observation | SHOULD contain informant : informant.exists() | |
should-text-ref-value | warning | Observation | SHOULD contain text/reference/@value : text.reference.value.exists() | |
value-starts-octothorpe | error | Observation.text.reference | If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative : value.exists() implies value.startsWith('#') |
Key Elements View
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Observation | C | 1..1 | Observation | XML Namespace: urn:hl7-org:v3 Elements defined in Ancestors: @nullFlavor, realmCode, typeId, templateId, @classCode, @moodCode, @negationInd, id, code, derivationExpr, text, statusCode, effectiveTime, priorityCode, repeatNumber, languageCode, value, interpretationCode, methodCode, targetSiteCode, subject, specimen, performer, author, informant, participant, entryRelationship, reference, precondition, sdtcPrecondition2, referenceRange, sdtcInFulfillmentOf1 Base for all types and resources Instances of this type are validated by templateId Logical Container: ClinicalDocument (CDA Class) should-text-ref-value: SHOULD contain text/reference/@value should-informant: SHOULD contain informant |
Slices for templateId | 1..* | II | Slice: Unordered, Open by value:root, value:extension | |
templateId:med-adherence | 1..1 | II | ||
@root | 1..1 | oid, uuid, ruid | Required Pattern: 2.16.840.1.113883.10.20.22.4.508 | |
@extension | 1..1 | st | Required Pattern: 2023-05-01 | |
@classCode | 1..1 | cs | Binding: ActClassObservation (2.0.0) (required) | |
@moodCode | 1..1 | cs | Binding: XActMoodDocumentObservation (2.0.0) (required) Fixed Value: EVN | |
id | 1..* | II | ||
code | 1..1 | CD | Adherence to prescribed medication instructions [Reported] Binding: ObservationType (example) | |
@code | 1..1 | cs | Required Pattern: 71799-1 | |
@codeSystem | 1..1 | oid, uuid, ruid | LOINC Required Pattern: 2.16.840.1.113883.6.1 | |
text | 0..1 | ED | SHOULD reference the portion of section narrative text corresponding to this entry | |
reference | C | 0..1 | TEL | value-starts-octothorpe: If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative |
statusCode | 1..1 | CS | Binding: ActStatus (required) | |
effectiveTime | 1..1 | IVL_TS | ||
value | 1..1 | CD | ||
@code | 1..1 | cs | Binding: Medication Adherence SCT (extensible) | |
informant | 0..* | Informant | (USCDI) 'The person or organization that provided the information about the medication adherence.' | |
Documentation for this format |
Path | Conformance | ValueSet / Code |
Observation.classCode | required | ActClassObservation |
Observation.moodCode | required | Fixed Value: EVN |
Observation.code | example | ObservationType |
Observation.statusCode | required | ActStatus |
Observation.value.code | extensible | MedicationAdherenceSCT |
Id | Grade | Path(s) | Details | Requirements |
should-informant | warning | Observation | SHOULD contain informant : informant.exists() | |
should-text-ref-value | warning | Observation | SHOULD contain text/reference/@value : text.reference.value.exists() | |
value-starts-octothorpe | error | Observation.text.reference | If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative : value.exists() implies value.startsWith('#') |
Snapshot View
Path | Conformance | ValueSet / Code |
Observation.nullFlavor | required | CDANullFlavor |
Observation.typeId.nullFlavor | required | CDANullFlavor |
Observation.templateId:med-adherence.nullFlavor | required | CDANullFlavor |
Observation.classCode | required | ActClassObservation |
Observation.moodCode | required | Fixed Value: EVN |
Observation.code | example | ObservationType |
Observation.code.nullFlavor | required | CDANullFlavor |
Observation.text.nullFlavor | required | CDANullFlavor |
Observation.text.compression | required | CDACompressionAlgorithm |
Observation.text.integrityCheckAlgorithm | required | IntegrityCheckAlgorithm |
Observation.text.mediaType | example | MediaType |
Observation.text.representation | required | BinaryDataEncoding |
Observation.statusCode | required | ActStatus |
Observation.priorityCode | example | ActPriority |
Observation.languageCode | required | AllLanguages |
Observation.value.nullFlavor | required | CDANullFlavor |
Observation.value.code | extensible | MedicationAdherenceSCT |
Observation.interpretationCode | required | ObservationInterpretation |
Observation.methodCode | example | ObservationMethod |
Observation.referenceRange.nullFlavor | required | CDANullFlavor |
Observation.referenceRange.typeId.nullFlavor | required | CDANullFlavor |
Observation.referenceRange.typeCode | required | Fixed Value: REFV |
Id | Grade | Path(s) | Details | Requirements |
should-informant | warning | Observation | SHOULD contain informant : informant.exists() | |
should-text-ref-value | warning | Observation | SHOULD contain text/reference/@value : text.reference.value.exists() | |
value-starts-octothorpe | error | Observation.text.reference | If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative : value.exists() implies value.startsWith('#') |
This structure is derived from Observation
Summary
Mandatory: 11 elements
Fixed Value: 1 element
Slices
This structure defines the following Slices: