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/PlannedImmunizationActivity | Version: 3.0.0-ballot | |||
Draft as of 2023-12-21 | Computable Name: PlannedImmunizationActivity | |||
Other Identifiers: id: urn:oid:2.16.840.1.113883.10.20.22.4.120 |
This template represents planned immunizations. Planned Immunization Activity is very similar to Planned Medication Activity with some key differences, for example, the drug code system is constrained to CVX codes. The priority of the immunization activity to the patient and provider is communicated through Priority Preference. The effectiveTime indicates the time when the immunization activity is intended to take place and 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 |
Slices for templateId | 1..* | II | Slice: Unordered, Open by value:root | |
templateId:planned-immunization-activity | 1..1 | II | ||
@root | 1..1 | oid, uuid, ruid | Required Pattern: 2.16.840.1.113883.10.20.22.4.120 | |
@extension | 0..0 | |||
@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 | SXCM_TS, IVL_TS, EIVL_TS, PIVL_TS, SXPR_TS | The effectiveTime in a planned immunization activity represents the time that the immunization activity should occur. | |
repeatNumber | 0..1 | IVL_INT | In a Planned Immunization 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) | |
consumable | 1..1 | InfrastructureRoot | ||
manufacturedProduct | 1..1 | ImmunizationMedicationInformation | Base for all types and resources | |
performer | 0..* | Performer2 | The clinician who is expected to perform the planned immunization activity could be identified using substanceAdministration/performer. | |
author | 0..* | AuthorParticipation | The author in a planned immunization activity represents the clinician who is requesting or planning the immunization activity. | |
Slices for entryRelationship | 0..* | EntryRelationship | The following entryRelationship captures any instructions associated with the planned immunization activity. Slice: Unordered, Open by profile:observation, profile:act | |
entryRelationship:priorityPreference | 0..* | EntryRelationship | The following entryRelationship represents the priority that a patient or a provider places on the immunization 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 immunization 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 | |
Slices for precondition | 0..* | Precondition | Slice: Unordered, Open by profile:criterion | |
precondition:pronditionForSubstanceAdmin | 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) |
Id | Grade | Path(s) | Details | Requirements |
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 | 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 |
Slices for templateId | 1..* | II | Slice: Unordered, Open by value:root | |
templateId:planned-immunization-activity | 1..1 | II | ||
@root | 1..1 | oid, uuid, ruid | Required Pattern: 2.16.840.1.113883.10.20.22.4.120 | |
@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 | The effectiveTime in a planned immunization activity represents the time that the immunization activity should occur. | ||
effectiveTime | SXCM_TS | |||
effectiveTime | IVL_TS | |||
effectiveTime | EIVL_TS | |||
effectiveTime | PIVL_TS | |||
effectiveTime | SXPR_TS | |||
repeatNumber | 0..1 | IVL_INT | In a Planned Immunization 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) | |
consumable | 1..1 | InfrastructureRoot | ||
manufacturedProduct | C | 1..1 | ImmunizationMedicationInformation | Base for all types and resources |
performer | 0..* | Performer2 | The clinician who is expected to perform the planned immunization activity could be identified using substanceAdministration/performer. | |
author | 0..* | AuthorParticipation | The author in a planned immunization activity represents the clinician who is requesting or planning the immunization activity. | |
Slices for entryRelationship | 0..* | EntryRelationship | The following entryRelationship captures any instructions associated with the planned immunization activity. Slice: Unordered, Open by profile:observation, profile:act | |
entryRelationship:priorityPreference | 0..* | EntryRelationship | The following entryRelationship represents the priority that a patient or a provider places on the immunization 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 immunization 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 |
Slices for precondition | 0..* | Precondition | Slice: Unordered, Open by profile:criterion | |
precondition:pronditionForSubstanceAdmin | 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.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:pronditionForSubstanceAdmin.typeCode | required | Fixed Value: PRCN |
Id | Grade | Path(s) | Details | Requirements |
product-choice | error | SubstanceAdministration.consumable.manufacturedProduct | manufacturedLabeledDrug and manufacturedMaterial are mutually exclusive (one must be present) : (manufacturedLabeledDrug | manufacturedMaterial).count() = 1 | |
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-manufacturerOrganization | warning | SubstanceAdministration.consumable.manufacturedProduct | SHOULD contain manufacturerOrganization : manufacturerOrganization.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 | 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-immunization-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.administrationUnitCode | example | AdministrableDrugForm |
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:pronditionForSubstanceAdmin.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.precondition:pronditionForSubstanceAdmin.typeId.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.precondition:pronditionForSubstanceAdmin.typeCode | required | Fixed Value: PRCN |
Id | Grade | Path(s) | Details | Requirements |
product-choice | error | SubstanceAdministration.consumable.manufacturedProduct | manufacturedLabeledDrug and manufacturedMaterial are mutually exclusive (one must be present) : (manufacturedLabeledDrug | manufacturedMaterial).count() = 1 | |
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-manufacturerOrganization | warning | SubstanceAdministration.consumable.manufacturedProduct | SHOULD contain manufacturerOrganization : manufacturerOrganization.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 | 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: 7 elements (4 nested mandatory elements)
Fixed Value: 4 elements
Prohibited: 1 element
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 |
Slices for templateId | 1..* | II | Slice: Unordered, Open by value:root | |
templateId:planned-immunization-activity | 1..1 | II | ||
@root | 1..1 | oid, uuid, ruid | Required Pattern: 2.16.840.1.113883.10.20.22.4.120 | |
@extension | 0..0 | |||
@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 | SXCM_TS, IVL_TS, EIVL_TS, PIVL_TS, SXPR_TS | The effectiveTime in a planned immunization activity represents the time that the immunization activity should occur. | |
repeatNumber | 0..1 | IVL_INT | In a Planned Immunization 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) | |
consumable | 1..1 | InfrastructureRoot | ||
manufacturedProduct | 1..1 | ImmunizationMedicationInformation | Base for all types and resources | |
performer | 0..* | Performer2 | The clinician who is expected to perform the planned immunization activity could be identified using substanceAdministration/performer. | |
author | 0..* | AuthorParticipation | The author in a planned immunization activity represents the clinician who is requesting or planning the immunization activity. | |
Slices for entryRelationship | 0..* | EntryRelationship | The following entryRelationship captures any instructions associated with the planned immunization activity. Slice: Unordered, Open by profile:observation, profile:act | |
entryRelationship:priorityPreference | 0..* | EntryRelationship | The following entryRelationship represents the priority that a patient or a provider places on the immunization 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 immunization 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 | |
Slices for precondition | 0..* | Precondition | Slice: Unordered, Open by profile:criterion | |
precondition:pronditionForSubstanceAdmin | 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) |
Id | Grade | Path(s) | Details | Requirements |
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 | 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 |
Slices for templateId | 1..* | II | Slice: Unordered, Open by value:root | |
templateId:planned-immunization-activity | 1..1 | II | ||
@root | 1..1 | oid, uuid, ruid | Required Pattern: 2.16.840.1.113883.10.20.22.4.120 | |
@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 | The effectiveTime in a planned immunization activity represents the time that the immunization activity should occur. | ||
effectiveTime | SXCM_TS | |||
effectiveTime | IVL_TS | |||
effectiveTime | EIVL_TS | |||
effectiveTime | PIVL_TS | |||
effectiveTime | SXPR_TS | |||
repeatNumber | 0..1 | IVL_INT | In a Planned Immunization 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) | |
consumable | 1..1 | InfrastructureRoot | ||
manufacturedProduct | C | 1..1 | ImmunizationMedicationInformation | Base for all types and resources |
performer | 0..* | Performer2 | The clinician who is expected to perform the planned immunization activity could be identified using substanceAdministration/performer. | |
author | 0..* | AuthorParticipation | The author in a planned immunization activity represents the clinician who is requesting or planning the immunization activity. | |
Slices for entryRelationship | 0..* | EntryRelationship | The following entryRelationship captures any instructions associated with the planned immunization activity. Slice: Unordered, Open by profile:observation, profile:act | |
entryRelationship:priorityPreference | 0..* | EntryRelationship | The following entryRelationship represents the priority that a patient or a provider places on the immunization 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 immunization 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 |
Slices for precondition | 0..* | Precondition | Slice: Unordered, Open by profile:criterion | |
precondition:pronditionForSubstanceAdmin | 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.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:pronditionForSubstanceAdmin.typeCode | required | Fixed Value: PRCN |
Id | Grade | Path(s) | Details | Requirements |
product-choice | error | SubstanceAdministration.consumable.manufacturedProduct | manufacturedLabeledDrug and manufacturedMaterial are mutually exclusive (one must be present) : (manufacturedLabeledDrug | manufacturedMaterial).count() = 1 | |
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-manufacturerOrganization | warning | SubstanceAdministration.consumable.manufacturedProduct | SHOULD contain manufacturerOrganization : manufacturerOrganization.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 | 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-immunization-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.administrationUnitCode | example | AdministrableDrugForm |
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:pronditionForSubstanceAdmin.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.precondition:pronditionForSubstanceAdmin.typeId.nullFlavor | required | CDANullFlavor |
SubstanceAdministration.precondition:pronditionForSubstanceAdmin.typeCode | required | Fixed Value: PRCN |
Id | Grade | Path(s) | Details | Requirements |
product-choice | error | SubstanceAdministration.consumable.manufacturedProduct | manufacturedLabeledDrug and manufacturedMaterial are mutually exclusive (one must be present) : (manufacturedLabeledDrug | manufacturedMaterial).count() = 1 | |
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-manufacturerOrganization | warning | SubstanceAdministration.consumable.manufacturedProduct | SHOULD contain manufacturerOrganization : manufacturerOrganization.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 | 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: 7 elements (4 nested mandatory elements)
Fixed Value: 4 elements
Prohibited: 1 element
Structures
This structure refers to these other structures:
Slices
This structure defines the following Slices: