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/PlannedMedicationActivity | Version: 3.0.0-ballot | |||
Draft as of 2023-12-21 | Computable Name: PlannedMedicationActivity | |||
Other Identifiers: id: urn:hl7ii:2.16.840.1.113883.10.20.22.4.42:2014-06-09 |
This template represents planned medication activities. The priority of the medication activity to the patient and provider is communicated through Priority Preference. The effectiveTime indicates the time when the medication activity is intended to take place. The authorTime indicates when the documentation of the plan occurred.
Usage:
Description of Profiles, Differentials, Snapshots and how the different presentations work.
This structure is derived from SubstanceAdministration
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
SubstanceAdministration | C | 1..1 | SubstanceAdministration | XML Namespace: urn:hl7-org:v3 Elements defined in Ancestors: @nullFlavor, realmCode, typeId, templateId, @classCode, @moodCode, id, code, @negationInd, text, statusCode, effectiveTime, priorityCode, repeatNumber, routeCode, approachSiteCode, doseQuantity, rateQuantity, maxDoseQuantity, administrationUnitCode, consumable, subject, specimen, performer, author, informant, participant, entryRelationship, reference, precondition, 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 dose-unit-or-admin-unit: If doseQuantity/@unit is present, then administrationUnitCode SHALL NOT be present. should-author: SHOULD contain author |
Slices for templateId | 1..* | II | Slice: Unordered, Open by value:root, value:extension | |
templateId:planned-med-activity | 1..1 | II | ||
@root | 1..1 | oid, uuid, ruid | Required Pattern: 2.16.840.1.113883.10.20.22.4.42 | |
@extension | 1..1 | st | Required Pattern: 2014-06-09 | |
@classCode | 1..1 | cs | ||
@moodCode | 1..1 | cs | Binding: Planned moodCode (SubstanceAdministration/Supply) (required) | |
id | 1..* | II | ||
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 | ||
@code | 1..1 | cs | Fixed Value: active | |
effectiveTime | 1..1 | IVL_TS | The effectiveTime in a planned medication activity represents the time that the medication activity should occur. | |
repeatNumber | 0..1 | IVL_INT | In a Planned Medication Activity, repeatNumber defines the number of allowed administrations. For example, a repeatNumber of "3" means that the substance can be administered up to 3 times. | |
routeCode | C | 0..1 | CE | Binding: SPL Drug Route of Administration Terminology (required) should-translation: SHOULD contain translation |
translation | 0..* | CD | Binding: Medication Route (required) | |
approachSiteCode | 0..* | CD | Binding: Body Site Value Set (required) | |
doseQuantity | C | 0..1 | IVL_PQ | should-unit: SHOULD contain @unit |
@unit | 0..1 | cs | NOTE: The base CDA R2.0 standard requires @unit to be drawn from UCUM, and best practice is to use case sensitive UCUM units Binding: UnitsOfMeasureCaseSensitive (required) | |
rateQuantity | C | 0..1 | IVL_PQ | should-unit: SHOULD contain @unit |
@unit | 0..1 | cs | NOTE: The base CDA R2.0 standard requires @unit to be drawn from UCUM, and best practice is to use case sensitive UCUM units Binding: UnitsOfMeasureCaseSensitive (required) | |
maxDoseQuantity | 0..1 | RTO_PQ_PQ | ||
administrationUnitCode | 0..1 | CE | Binding: AdministrationUnitDoseForm (required) | |
consumable | 1..1 | InfrastructureRoot | ||
manufacturedProduct | 1..1 | MedicationInformation | Base for all types and resources | |
performer | 0..* | Performer2 | The clinician who is expected to perform the medication activity could be identified using substanceAdministration/performer. | |
author | 0..1 | AuthorParticipation | The author in a planned medication activity represents the clinician who is requesting or planning the medication activity. | |
Slices for entryRelationship | 0..* | EntryRelationship | The following entryRelationship captures any instructions associated with the planned medication activity. Slice: Unordered, Open by profile:act, profile:observation | |
entryRelationship:priorityPreference | 0..* | EntryRelationship | The following entryRelationship represents the priority that a patient or a provider places on the planned medication activity. | |
@typeCode | 1..1 | cs | Fixed Value: REFR | |
observation | 1..1 | PriorityPreference | Base for all types and resources | |
entryRelationship:indication | 0..* | EntryRelationship | The following entryRelationship represents the indication for the planned medication activity. | |
@typeCode | 1..1 | cs | Fixed Value: RSON | |
observation | 1..1 | Indication | Base for all types and resources | |
entryRelationship:instruction | 0..* | EntryRelationship | ||
@typeCode | 1..1 | cs | Fixed Value: SUBJ | |
act | 1..1 | Instruction | Base for all types and resources | |
precondition | 0..* | Precondition | ||
@typeCode | 1..1 | cs | ||
criterion | 1..1 | PreconditionforSubstanceAdministration | Base for all types and resources | |
Documentation for this format |
Path | Conformance | ValueSet |
SubstanceAdministration.moodCode | required | PlannedMoodCodeSubstanceAdministrationSupply |
SubstanceAdministration.routeCode | required | SPLDrugRouteOfAdministrationTerminology |
SubstanceAdministration.routeCode.translation | required | MedicationRoute |
SubstanceAdministration.approachSiteCode | required | BodySiteValueSet |
SubstanceAdministration.doseQuantity.unit | required | UnitsOfMeasureCaseSensitive (a valid code from UCUM) |
SubstanceAdministration.rateQuantity.unit | required | UnitsOfMeasureCaseSensitive (a valid code from UCUM) |
SubstanceAdministration.administrationUnitCode | required | AdministrationUnitDoseForm |
Id | Grade | Path(s) | Details | Requirements |
dose-unit-or-admin-unit | error | SubstanceAdministration | If doseQuantity/@unit is present, then administrationUnitCode SHALL NOT be present. : doseQuantity.unit.exists() implies administrationUnitCode.empty() | |
should-author | warning | SubstanceAdministration | SHOULD contain author : author.exists() | |
should-text-ref-value | warning | SubstanceAdministration | SHOULD contain text/reference/@value : text.reference.value.exists() | |
should-translation | warning | SubstanceAdministration.routeCode | SHOULD contain translation : translation.exists() | |
should-unit | warning | SubstanceAdministration.doseQuantity, SubstanceAdministration.rateQuantity | SHOULD contain @unit : nullFlavor.exists() or unit.exists() | |
value-starts-octothorpe | error | SubstanceAdministration.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 |
---|---|---|---|---|
SubstanceAdministration | C | 1..1 | SubstanceAdministration | XML Namespace: urn:hl7-org:v3 Elements defined in Ancestors: @nullFlavor, realmCode, typeId, templateId, @classCode, @moodCode, id, code, @negationInd, text, statusCode, effectiveTime, priorityCode, repeatNumber, routeCode, approachSiteCode, doseQuantity, rateQuantity, maxDoseQuantity, administrationUnitCode, consumable, subject, specimen, performer, author, informant, participant, entryRelationship, reference, precondition, 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 dose-unit-or-admin-unit: If doseQuantity/@unit is present, then administrationUnitCode SHALL NOT be present. should-author: SHOULD contain author |
Slices for templateId | 1..* | II | Slice: Unordered, Open by value:root, value:extension | |
templateId:planned-med-activity | 1..1 | II | ||
@root | 1..1 | oid, uuid, ruid | Required Pattern: 2.16.840.1.113883.10.20.22.4.42 | |
@extension | 1..1 | st | Required Pattern: 2014-06-09 | |
@classCode | 1..1 | cs | Binding: ActClass (2.0.0) (required) Fixed Value: SBADM | |
@moodCode | 1..1 | cs | Binding: Planned moodCode (SubstanceAdministration/Supply) (required) | |
id | 1..* | II | ||
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) | |
@code | 1..1 | cs | Fixed Value: active | |
effectiveTime | 1..1 | IVL_TS | The effectiveTime in a planned medication activity represents the time that the medication activity should occur. | |
repeatNumber | 0..1 | IVL_INT | In a Planned Medication Activity, repeatNumber defines the number of allowed administrations. For example, a repeatNumber of "3" means that the substance can be administered up to 3 times. | |
routeCode | C | 0..1 | CE | Binding: SPL Drug Route of Administration Terminology (required) should-translation: SHOULD contain translation |
translation | 0..* | CD | Binding: Medication Route (required) | |
approachSiteCode | 0..* | CD | Binding: Body Site Value Set (required) | |
doseQuantity | C | 0..1 | IVL_PQ | should-unit: SHOULD contain @unit |
@unit | 0..1 | cs | NOTE: The base CDA R2.0 standard requires @unit to be drawn from UCUM, and best practice is to use case sensitive UCUM units Binding: UnitsOfMeasureCaseSensitive (required) | |
rateQuantity | C | 0..1 | IVL_PQ | should-unit: SHOULD contain @unit |
@unit | 0..1 | cs | NOTE: The base CDA R2.0 standard requires @unit to be drawn from UCUM, and best practice is to use case sensitive UCUM units Binding: UnitsOfMeasureCaseSensitive (required) | |
maxDoseQuantity | 0..1 | RTO_PQ_PQ | ||
administrationUnitCode | 0..1 | CE | Binding: AdministrationUnitDoseForm (required) | |
consumable | 1..1 | InfrastructureRoot | ||
manufacturedProduct | C | 1..1 | MedicationInformation | Base for all types and resources |
performer | 0..* | Performer2 | The clinician who is expected to perform the medication activity could be identified using substanceAdministration/performer. | |
author | 0..1 | AuthorParticipation | The author in a planned medication activity represents the clinician who is requesting or planning the medication activity. | |
Slices for entryRelationship | 0..* | EntryRelationship | The following entryRelationship captures any instructions associated with the planned medication activity. Slice: Unordered, Open by profile:act, profile:observation | |
entryRelationship:priorityPreference | 0..* | EntryRelationship | The following entryRelationship represents the priority that a patient or a provider places on the planned medication activity. | |
@typeCode | 1..1 | cs | Binding: x_ActRelationshipEntryRelationship (required) Fixed Value: REFR | |
observation | C | 1..1 | PriorityPreference | Base for all types and resources |
entryRelationship:indication | 0..* | EntryRelationship | The following entryRelationship represents the indication for the planned medication activity. | |
@typeCode | 1..1 | cs | Binding: x_ActRelationshipEntryRelationship (required) Fixed Value: RSON | |
observation | C | 1..1 | Indication | Base for all types and resources |
entryRelationship:instruction | 0..* | EntryRelationship | ||
@typeCode | 1..1 | cs | Binding: x_ActRelationshipEntryRelationship (required) Fixed Value: SUBJ | |
act | C | 1..1 | Instruction | Base for all types and resources |
precondition | 0..* | Precondition | ||
@typeCode | 1..1 | cs | Binding: ActRelationshipType (required) Fixed Value: PRCN | |
criterion | 1..1 | PreconditionforSubstanceAdministration | Base for all types and resources | |
Documentation for this format |
Path | Conformance | ValueSet / Code |
SubstanceAdministration.classCode | required | Fixed Value: SBADM |
SubstanceAdministration.moodCode | required | PlannedMoodCodeSubstanceAdministrationSupply |
SubstanceAdministration.statusCode | required | ActStatus |
SubstanceAdministration.routeCode | required | SPLDrugRouteOfAdministrationTerminology |
SubstanceAdministration.routeCode.translation | required | MedicationRoute |
SubstanceAdministration.approachSiteCode | required | BodySiteValueSet |
SubstanceAdministration.doseQuantity.unit | required | UnitsOfMeasureCaseSensitive (a valid code from UCUM) |
SubstanceAdministration.rateQuantity.unit | required | UnitsOfMeasureCaseSensitive (a valid code from UCUM) |
SubstanceAdministration.administrationUnitCode | required | AdministrationUnitDoseForm |
SubstanceAdministration.entryRelationship:priorityPreference.typeCode | required | Fixed Value: REFR |
SubstanceAdministration.entryRelationship:indication.typeCode | required | Fixed Value: RSON |
SubstanceAdministration.entryRelationship:instruction.typeCode | required | Fixed Value: SUBJ |
SubstanceAdministration.precondition.typeCode | required | Fixed Value: PRCN |
Id | Grade | Path(s) | Details | Requirements |
dose-unit-or-admin-unit | error | SubstanceAdministration | If doseQuantity/@unit is present, then administrationUnitCode SHALL NOT be present. : doseQuantity.unit.exists() implies administrationUnitCode.empty() | |
product-choice | error | SubstanceAdministration.consumable.manufacturedProduct | manufacturedLabeledDrug and manufacturedMaterial are mutually exclusive (one must be present) : (manufacturedLabeledDrug | manufacturedMaterial).count() = 1 | |
should-author | warning | SubstanceAdministration | SHOULD contain author : author.exists() | |
should-author | warning | SubstanceAdministration.entryRelationship:priorityPreference.observation | SHOULD contain author : author.exists() | |
should-effectiveTime | warning | SubstanceAdministration.entryRelationship:priorityPreference.observation, SubstanceAdministration.entryRelationship:indication.observation | SHOULD contain effectiveTime : effectiveTime.exists() | |
should-text-ref-value | warning | SubstanceAdministration | SHOULD contain text/reference/@value : text.reference.value.exists() | |
should-text-ref-value | warning | SubstanceAdministration.entryRelationship:priorityPreference.observation, SubstanceAdministration.entryRelationship:indication.observation, SubstanceAdministration.entryRelationship:instruction.act | SHOULD contain text/reference/@value : text.reference.value.exists() | |
should-translation | warning | SubstanceAdministration.routeCode | SHOULD contain translation : translation.exists() | |
should-unit | warning | SubstanceAdministration.doseQuantity, SubstanceAdministration.rateQuantity | SHOULD contain @unit : nullFlavor.exists() or unit.exists() | |
value-starts-octothorpe | error | SubstanceAdministration.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 |
SubstanceAdministration.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.typeId.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.templateId:planned-med-activity.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.classCode | required | Fixed Value: SBADM |
SubstanceAdministration.moodCode | required | PlannedMoodCodeSubstanceAdministrationSupply |
SubstanceAdministration.code | example | ActSubstanceAdministrationCode |
SubstanceAdministration.text.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.text.compression | required | CDACompressionAlgorithm |
SubstanceAdministration.text.integrityCheckAlgorithm | required | IntegrityCheckAlgorithm |
SubstanceAdministration.text.mediaType | example | MediaType |
SubstanceAdministration.text.representation | required | BinaryDataEncoding |
SubstanceAdministration.statusCode | required | ActStatus |
SubstanceAdministration.statusCode.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.priorityCode | example | ActPriority |
SubstanceAdministration.routeCode | required | SPLDrugRouteOfAdministrationTerminology |
SubstanceAdministration.routeCode.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.routeCode.translation | required | MedicationRoute |
SubstanceAdministration.approachSiteCode | required | BodySiteValueSet |
SubstanceAdministration.doseQuantity.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.doseQuantity.unit | required | UnitsOfMeasureCaseSensitive (a valid code from UCUM) |
SubstanceAdministration.doseQuantity.operator | required | SetOperator |
SubstanceAdministration.rateQuantity.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.rateQuantity.unit | required | UnitsOfMeasureCaseSensitive (a valid code from UCUM) |
SubstanceAdministration.rateQuantity.operator | required | SetOperator |
SubstanceAdministration.administrationUnitCode | required | AdministrationUnitDoseForm |
SubstanceAdministration.consumable.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.consumable.typeId.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.consumable.typeCode | required | Fixed Value: CSM |
SubstanceAdministration.entryRelationship:priorityPreference.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.entryRelationship:priorityPreference.typeId.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.entryRelationship:priorityPreference.typeCode | required | Fixed Value: REFR |
SubstanceAdministration.entryRelationship:indication.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.entryRelationship:indication.typeId.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.entryRelationship:indication.typeCode | required | Fixed Value: RSON |
SubstanceAdministration.entryRelationship:instruction.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.entryRelationship:instruction.typeId.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.entryRelationship:instruction.typeCode | required | Fixed Value: SUBJ |
SubstanceAdministration.precondition.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.precondition.typeId.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.precondition.typeCode | required | Fixed Value: PRCN |
Id | Grade | Path(s) | Details | Requirements |
dose-unit-or-admin-unit | error | SubstanceAdministration | If doseQuantity/@unit is present, then administrationUnitCode SHALL NOT be present. : doseQuantity.unit.exists() implies administrationUnitCode.empty() | |
product-choice | error | SubstanceAdministration.consumable.manufacturedProduct | manufacturedLabeledDrug and manufacturedMaterial are mutually exclusive (one must be present) : (manufacturedLabeledDrug | manufacturedMaterial).count() = 1 | |
should-author | warning | SubstanceAdministration | SHOULD contain author : author.exists() | |
should-author | warning | SubstanceAdministration.entryRelationship:priorityPreference.observation | SHOULD contain author : author.exists() | |
should-effectiveTime | warning | SubstanceAdministration.entryRelationship:priorityPreference.observation, SubstanceAdministration.entryRelationship:indication.observation | SHOULD contain effectiveTime : effectiveTime.exists() | |
should-text-ref-value | warning | SubstanceAdministration | SHOULD contain text/reference/@value : text.reference.value.exists() | |
should-text-ref-value | warning | SubstanceAdministration.entryRelationship:priorityPreference.observation, SubstanceAdministration.entryRelationship:indication.observation, SubstanceAdministration.entryRelationship:instruction.act | SHOULD contain text/reference/@value : text.reference.value.exists() | |
should-translation | warning | SubstanceAdministration.routeCode | SHOULD contain translation : translation.exists() | |
should-unit | warning | SubstanceAdministration.doseQuantity, SubstanceAdministration.rateQuantity | SHOULD contain @unit : nullFlavor.exists() or unit.exists() | |
value-starts-octothorpe | error | SubstanceAdministration.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 SubstanceAdministration
Summary
Mandatory: 8 elements (4 nested mandatory elements)
Fixed Value: 4 elements
Structures
This structure refers to these other structures:
Slices
This structure defines the following Slices:
Differential View
This structure is derived from SubstanceAdministration
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
SubstanceAdministration | C | 1..1 | SubstanceAdministration | XML Namespace: urn:hl7-org:v3 Elements defined in Ancestors: @nullFlavor, realmCode, typeId, templateId, @classCode, @moodCode, id, code, @negationInd, text, statusCode, effectiveTime, priorityCode, repeatNumber, routeCode, approachSiteCode, doseQuantity, rateQuantity, maxDoseQuantity, administrationUnitCode, consumable, subject, specimen, performer, author, informant, participant, entryRelationship, reference, precondition, 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 dose-unit-or-admin-unit: If doseQuantity/@unit is present, then administrationUnitCode SHALL NOT be present. should-author: SHOULD contain author |
Slices for templateId | 1..* | II | Slice: Unordered, Open by value:root, value:extension | |
templateId:planned-med-activity | 1..1 | II | ||
@root | 1..1 | oid, uuid, ruid | Required Pattern: 2.16.840.1.113883.10.20.22.4.42 | |
@extension | 1..1 | st | Required Pattern: 2014-06-09 | |
@classCode | 1..1 | cs | ||
@moodCode | 1..1 | cs | Binding: Planned moodCode (SubstanceAdministration/Supply) (required) | |
id | 1..* | II | ||
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 | ||
@code | 1..1 | cs | Fixed Value: active | |
effectiveTime | 1..1 | IVL_TS | The effectiveTime in a planned medication activity represents the time that the medication activity should occur. | |
repeatNumber | 0..1 | IVL_INT | In a Planned Medication Activity, repeatNumber defines the number of allowed administrations. For example, a repeatNumber of "3" means that the substance can be administered up to 3 times. | |
routeCode | C | 0..1 | CE | Binding: SPL Drug Route of Administration Terminology (required) should-translation: SHOULD contain translation |
translation | 0..* | CD | Binding: Medication Route (required) | |
approachSiteCode | 0..* | CD | Binding: Body Site Value Set (required) | |
doseQuantity | C | 0..1 | IVL_PQ | should-unit: SHOULD contain @unit |
@unit | 0..1 | cs | NOTE: The base CDA R2.0 standard requires @unit to be drawn from UCUM, and best practice is to use case sensitive UCUM units Binding: UnitsOfMeasureCaseSensitive (required) | |
rateQuantity | C | 0..1 | IVL_PQ | should-unit: SHOULD contain @unit |
@unit | 0..1 | cs | NOTE: The base CDA R2.0 standard requires @unit to be drawn from UCUM, and best practice is to use case sensitive UCUM units Binding: UnitsOfMeasureCaseSensitive (required) | |
maxDoseQuantity | 0..1 | RTO_PQ_PQ | ||
administrationUnitCode | 0..1 | CE | Binding: AdministrationUnitDoseForm (required) | |
consumable | 1..1 | InfrastructureRoot | ||
manufacturedProduct | 1..1 | MedicationInformation | Base for all types and resources | |
performer | 0..* | Performer2 | The clinician who is expected to perform the medication activity could be identified using substanceAdministration/performer. | |
author | 0..1 | AuthorParticipation | The author in a planned medication activity represents the clinician who is requesting or planning the medication activity. | |
Slices for entryRelationship | 0..* | EntryRelationship | The following entryRelationship captures any instructions associated with the planned medication activity. Slice: Unordered, Open by profile:act, profile:observation | |
entryRelationship:priorityPreference | 0..* | EntryRelationship | The following entryRelationship represents the priority that a patient or a provider places on the planned medication activity. | |
@typeCode | 1..1 | cs | Fixed Value: REFR | |
observation | 1..1 | PriorityPreference | Base for all types and resources | |
entryRelationship:indication | 0..* | EntryRelationship | The following entryRelationship represents the indication for the planned medication activity. | |
@typeCode | 1..1 | cs | Fixed Value: RSON | |
observation | 1..1 | Indication | Base for all types and resources | |
entryRelationship:instruction | 0..* | EntryRelationship | ||
@typeCode | 1..1 | cs | Fixed Value: SUBJ | |
act | 1..1 | Instruction | Base for all types and resources | |
precondition | 0..* | Precondition | ||
@typeCode | 1..1 | cs | ||
criterion | 1..1 | PreconditionforSubstanceAdministration | Base for all types and resources | |
Documentation for this format |
Path | Conformance | ValueSet |
SubstanceAdministration.moodCode | required | PlannedMoodCodeSubstanceAdministrationSupply |
SubstanceAdministration.routeCode | required | SPLDrugRouteOfAdministrationTerminology |
SubstanceAdministration.routeCode.translation | required | MedicationRoute |
SubstanceAdministration.approachSiteCode | required | BodySiteValueSet |
SubstanceAdministration.doseQuantity.unit | required | UnitsOfMeasureCaseSensitive (a valid code from UCUM) |
SubstanceAdministration.rateQuantity.unit | required | UnitsOfMeasureCaseSensitive (a valid code from UCUM) |
SubstanceAdministration.administrationUnitCode | required | AdministrationUnitDoseForm |
Id | Grade | Path(s) | Details | Requirements |
dose-unit-or-admin-unit | error | SubstanceAdministration | If doseQuantity/@unit is present, then administrationUnitCode SHALL NOT be present. : doseQuantity.unit.exists() implies administrationUnitCode.empty() | |
should-author | warning | SubstanceAdministration | SHOULD contain author : author.exists() | |
should-text-ref-value | warning | SubstanceAdministration | SHOULD contain text/reference/@value : text.reference.value.exists() | |
should-translation | warning | SubstanceAdministration.routeCode | SHOULD contain translation : translation.exists() | |
should-unit | warning | SubstanceAdministration.doseQuantity, SubstanceAdministration.rateQuantity | SHOULD contain @unit : nullFlavor.exists() or unit.exists() | |
value-starts-octothorpe | error | SubstanceAdministration.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 |
---|---|---|---|---|
SubstanceAdministration | C | 1..1 | SubstanceAdministration | XML Namespace: urn:hl7-org:v3 Elements defined in Ancestors: @nullFlavor, realmCode, typeId, templateId, @classCode, @moodCode, id, code, @negationInd, text, statusCode, effectiveTime, priorityCode, repeatNumber, routeCode, approachSiteCode, doseQuantity, rateQuantity, maxDoseQuantity, administrationUnitCode, consumable, subject, specimen, performer, author, informant, participant, entryRelationship, reference, precondition, 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 dose-unit-or-admin-unit: If doseQuantity/@unit is present, then administrationUnitCode SHALL NOT be present. should-author: SHOULD contain author |
Slices for templateId | 1..* | II | Slice: Unordered, Open by value:root, value:extension | |
templateId:planned-med-activity | 1..1 | II | ||
@root | 1..1 | oid, uuid, ruid | Required Pattern: 2.16.840.1.113883.10.20.22.4.42 | |
@extension | 1..1 | st | Required Pattern: 2014-06-09 | |
@classCode | 1..1 | cs | Binding: ActClass (2.0.0) (required) Fixed Value: SBADM | |
@moodCode | 1..1 | cs | Binding: Planned moodCode (SubstanceAdministration/Supply) (required) | |
id | 1..* | II | ||
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) | |
@code | 1..1 | cs | Fixed Value: active | |
effectiveTime | 1..1 | IVL_TS | The effectiveTime in a planned medication activity represents the time that the medication activity should occur. | |
repeatNumber | 0..1 | IVL_INT | In a Planned Medication Activity, repeatNumber defines the number of allowed administrations. For example, a repeatNumber of "3" means that the substance can be administered up to 3 times. | |
routeCode | C | 0..1 | CE | Binding: SPL Drug Route of Administration Terminology (required) should-translation: SHOULD contain translation |
translation | 0..* | CD | Binding: Medication Route (required) | |
approachSiteCode | 0..* | CD | Binding: Body Site Value Set (required) | |
doseQuantity | C | 0..1 | IVL_PQ | should-unit: SHOULD contain @unit |
@unit | 0..1 | cs | NOTE: The base CDA R2.0 standard requires @unit to be drawn from UCUM, and best practice is to use case sensitive UCUM units Binding: UnitsOfMeasureCaseSensitive (required) | |
rateQuantity | C | 0..1 | IVL_PQ | should-unit: SHOULD contain @unit |
@unit | 0..1 | cs | NOTE: The base CDA R2.0 standard requires @unit to be drawn from UCUM, and best practice is to use case sensitive UCUM units Binding: UnitsOfMeasureCaseSensitive (required) | |
maxDoseQuantity | 0..1 | RTO_PQ_PQ | ||
administrationUnitCode | 0..1 | CE | Binding: AdministrationUnitDoseForm (required) | |
consumable | 1..1 | InfrastructureRoot | ||
manufacturedProduct | C | 1..1 | MedicationInformation | Base for all types and resources |
performer | 0..* | Performer2 | The clinician who is expected to perform the medication activity could be identified using substanceAdministration/performer. | |
author | 0..1 | AuthorParticipation | The author in a planned medication activity represents the clinician who is requesting or planning the medication activity. | |
Slices for entryRelationship | 0..* | EntryRelationship | The following entryRelationship captures any instructions associated with the planned medication activity. Slice: Unordered, Open by profile:act, profile:observation | |
entryRelationship:priorityPreference | 0..* | EntryRelationship | The following entryRelationship represents the priority that a patient or a provider places on the planned medication activity. | |
@typeCode | 1..1 | cs | Binding: x_ActRelationshipEntryRelationship (required) Fixed Value: REFR | |
observation | C | 1..1 | PriorityPreference | Base for all types and resources |
entryRelationship:indication | 0..* | EntryRelationship | The following entryRelationship represents the indication for the planned medication activity. | |
@typeCode | 1..1 | cs | Binding: x_ActRelationshipEntryRelationship (required) Fixed Value: RSON | |
observation | C | 1..1 | Indication | Base for all types and resources |
entryRelationship:instruction | 0..* | EntryRelationship | ||
@typeCode | 1..1 | cs | Binding: x_ActRelationshipEntryRelationship (required) Fixed Value: SUBJ | |
act | C | 1..1 | Instruction | Base for all types and resources |
precondition | 0..* | Precondition | ||
@typeCode | 1..1 | cs | Binding: ActRelationshipType (required) Fixed Value: PRCN | |
criterion | 1..1 | PreconditionforSubstanceAdministration | Base for all types and resources | |
Documentation for this format |
Path | Conformance | ValueSet / Code |
SubstanceAdministration.classCode | required | Fixed Value: SBADM |
SubstanceAdministration.moodCode | required | PlannedMoodCodeSubstanceAdministrationSupply |
SubstanceAdministration.statusCode | required | ActStatus |
SubstanceAdministration.routeCode | required | SPLDrugRouteOfAdministrationTerminology |
SubstanceAdministration.routeCode.translation | required | MedicationRoute |
SubstanceAdministration.approachSiteCode | required | BodySiteValueSet |
SubstanceAdministration.doseQuantity.unit | required | UnitsOfMeasureCaseSensitive (a valid code from UCUM) |
SubstanceAdministration.rateQuantity.unit | required | UnitsOfMeasureCaseSensitive (a valid code from UCUM) |
SubstanceAdministration.administrationUnitCode | required | AdministrationUnitDoseForm |
SubstanceAdministration.entryRelationship:priorityPreference.typeCode | required | Fixed Value: REFR |
SubstanceAdministration.entryRelationship:indication.typeCode | required | Fixed Value: RSON |
SubstanceAdministration.entryRelationship:instruction.typeCode | required | Fixed Value: SUBJ |
SubstanceAdministration.precondition.typeCode | required | Fixed Value: PRCN |
Id | Grade | Path(s) | Details | Requirements |
dose-unit-or-admin-unit | error | SubstanceAdministration | If doseQuantity/@unit is present, then administrationUnitCode SHALL NOT be present. : doseQuantity.unit.exists() implies administrationUnitCode.empty() | |
product-choice | error | SubstanceAdministration.consumable.manufacturedProduct | manufacturedLabeledDrug and manufacturedMaterial are mutually exclusive (one must be present) : (manufacturedLabeledDrug | manufacturedMaterial).count() = 1 | |
should-author | warning | SubstanceAdministration | SHOULD contain author : author.exists() | |
should-author | warning | SubstanceAdministration.entryRelationship:priorityPreference.observation | SHOULD contain author : author.exists() | |
should-effectiveTime | warning | SubstanceAdministration.entryRelationship:priorityPreference.observation, SubstanceAdministration.entryRelationship:indication.observation | SHOULD contain effectiveTime : effectiveTime.exists() | |
should-text-ref-value | warning | SubstanceAdministration | SHOULD contain text/reference/@value : text.reference.value.exists() | |
should-text-ref-value | warning | SubstanceAdministration.entryRelationship:priorityPreference.observation, SubstanceAdministration.entryRelationship:indication.observation, SubstanceAdministration.entryRelationship:instruction.act | SHOULD contain text/reference/@value : text.reference.value.exists() | |
should-translation | warning | SubstanceAdministration.routeCode | SHOULD contain translation : translation.exists() | |
should-unit | warning | SubstanceAdministration.doseQuantity, SubstanceAdministration.rateQuantity | SHOULD contain @unit : nullFlavor.exists() or unit.exists() | |
value-starts-octothorpe | error | SubstanceAdministration.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 |
SubstanceAdministration.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.typeId.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.templateId:planned-med-activity.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.classCode | required | Fixed Value: SBADM |
SubstanceAdministration.moodCode | required | PlannedMoodCodeSubstanceAdministrationSupply |
SubstanceAdministration.code | example | ActSubstanceAdministrationCode |
SubstanceAdministration.text.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.text.compression | required | CDACompressionAlgorithm |
SubstanceAdministration.text.integrityCheckAlgorithm | required | IntegrityCheckAlgorithm |
SubstanceAdministration.text.mediaType | example | MediaType |
SubstanceAdministration.text.representation | required | BinaryDataEncoding |
SubstanceAdministration.statusCode | required | ActStatus |
SubstanceAdministration.statusCode.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.priorityCode | example | ActPriority |
SubstanceAdministration.routeCode | required | SPLDrugRouteOfAdministrationTerminology |
SubstanceAdministration.routeCode.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.routeCode.translation | required | MedicationRoute |
SubstanceAdministration.approachSiteCode | required | BodySiteValueSet |
SubstanceAdministration.doseQuantity.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.doseQuantity.unit | required | UnitsOfMeasureCaseSensitive (a valid code from UCUM) |
SubstanceAdministration.doseQuantity.operator | required | SetOperator |
SubstanceAdministration.rateQuantity.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.rateQuantity.unit | required | UnitsOfMeasureCaseSensitive (a valid code from UCUM) |
SubstanceAdministration.rateQuantity.operator | required | SetOperator |
SubstanceAdministration.administrationUnitCode | required | AdministrationUnitDoseForm |
SubstanceAdministration.consumable.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.consumable.typeId.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.consumable.typeCode | required | Fixed Value: CSM |
SubstanceAdministration.entryRelationship:priorityPreference.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.entryRelationship:priorityPreference.typeId.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.entryRelationship:priorityPreference.typeCode | required | Fixed Value: REFR |
SubstanceAdministration.entryRelationship:indication.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.entryRelationship:indication.typeId.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.entryRelationship:indication.typeCode | required | Fixed Value: RSON |
SubstanceAdministration.entryRelationship:instruction.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.entryRelationship:instruction.typeId.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.entryRelationship:instruction.typeCode | required | Fixed Value: SUBJ |
SubstanceAdministration.precondition.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.precondition.typeId.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.precondition.typeCode | required | Fixed Value: PRCN |
Id | Grade | Path(s) | Details | Requirements |
dose-unit-or-admin-unit | error | SubstanceAdministration | If doseQuantity/@unit is present, then administrationUnitCode SHALL NOT be present. : doseQuantity.unit.exists() implies administrationUnitCode.empty() | |
product-choice | error | SubstanceAdministration.consumable.manufacturedProduct | manufacturedLabeledDrug and manufacturedMaterial are mutually exclusive (one must be present) : (manufacturedLabeledDrug | manufacturedMaterial).count() = 1 | |
should-author | warning | SubstanceAdministration | SHOULD contain author : author.exists() | |
should-author | warning | SubstanceAdministration.entryRelationship:priorityPreference.observation | SHOULD contain author : author.exists() | |
should-effectiveTime | warning | SubstanceAdministration.entryRelationship:priorityPreference.observation, SubstanceAdministration.entryRelationship:indication.observation | SHOULD contain effectiveTime : effectiveTime.exists() | |
should-text-ref-value | warning | SubstanceAdministration | SHOULD contain text/reference/@value : text.reference.value.exists() | |
should-text-ref-value | warning | SubstanceAdministration.entryRelationship:priorityPreference.observation, SubstanceAdministration.entryRelationship:indication.observation, SubstanceAdministration.entryRelationship:instruction.act | SHOULD contain text/reference/@value : text.reference.value.exists() | |
should-translation | warning | SubstanceAdministration.routeCode | SHOULD contain translation : translation.exists() | |
should-unit | warning | SubstanceAdministration.doseQuantity, SubstanceAdministration.rateQuantity | SHOULD contain @unit : nullFlavor.exists() or unit.exists() | |
value-starts-octothorpe | error | SubstanceAdministration.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 SubstanceAdministration
Summary
Mandatory: 8 elements (4 nested mandatory elements)
Fixed Value: 4 elements
Structures
This structure refers to these other structures:
Slices
This structure defines the following Slices: