R6 Ballot (2nd Draft)

Publish-box (todo)

Pharmacy icon Work GroupMaturity Level: 1 Trial UseSecurity Category: Business Compartments: No defined compartments

Detailed Descriptions for the elements in the MedicationKnowledge resource.

MedicationKnowledge
Element Id MedicationKnowledge
Definition

Information about a medication that is used to support knowledge.

Short Display Definition of Medication Knowledge
Cardinality 0..*
Type MetadataResource
Summary false
MedicationKnowledge.identifier
Element Id MedicationKnowledge.identifier
Definition

Business identifier for this medication.

Short Display Business identifier for this medication
Note This is a business identifier, not a resource identifier (see discussion)
Cardinality 0..*
Type Identifier
Summary true
Comments

This is a business identifier, not a resource identifier (see discussion).

MedicationKnowledge.code
Element Id MedicationKnowledge.code
Definition

A code that specifies this medication, or a textual description if no code is available. Usage note: This could be a standard medication code such as a code from RxNorm, SNOMED CT, IDMP etc. It could also be a national or local formulary code, optionally with translations to other code systems.

Short Display Code that identifies this medication
Cardinality 0..1
Terminology Binding SNOMED CT Medication Codes (Example)
Type CodeableConcept
Summary true
Comments

Depending on the context of use, the code that was actually selected by the user (prescriber, dispenser, etc.) will have the coding.userSelected set to true. As described in the coding datatype: "A coding may be marked as a "userSelected" if a user selected the particular coded value in a user interface (e.g. the user selects an item in a pick-list). If a user selected coding exists, it is the preferred choice for performing translations etc. Other codes can only be literal translations to alternative code systems, or codes at a lower level of granularity (e.g. a generic code for a vendor-specific primary one).

MedicationKnowledge.status
Element Id MedicationKnowledge.status
Definition

A code to indicate if the medication referred to by this MedicationKnowledge is in active use within the drug database or inventory system. The status refers to the validity about the information of the medication and not to its medicinal properties.

Short Display draft | active | retired | unknown
Cardinality 0..1
Terminology Binding PublicationStatus (Required)
Type code
Is Modifier true (Reason: This element changes the interpretation of all descriptive attributes.)
Summary true
Comments

This status is intended to identify if the medication in a local system is in active use within a drug database or inventory. For example, a pharmacy system may create a new drug file record for a compounded product "ABC Hospital Special Cream" with an active status. At some point in the future, it may be determined that the drug record was created with an error and the status is changed to "entered in error". This status is not intended to specify if a medication is part of a particular formulary. It is possible that the drug record may be referenced by multiple formularies or catalogues and each of those entries would have a separate status.

MedicationKnowledge.author
Element Id MedicationKnowledge.author
Definition

The creator or owner of the knowledge or information about the medication.

Short Display Creator or owner of the knowledge or information about the medication
Cardinality 0..1
Type ContactDetail
Summary false
MedicationKnowledge.jurisdiction
Element Id MedicationKnowledge.jurisdiction
Definition

Lists the jurisdictions that this medication knowledge was written for.

Short Display Codes that identify the different jurisdictions for which the information of this resource was created
Cardinality 0..*
Type CodeableConcept
Summary false
Comments

The codes could have varying granularity from a country or group of countries down to a specific district.

MedicationKnowledge.name
Element Id MedicationKnowledge.name
Definition

All of the names for a medication, for example, the name(s) given to a medication in different countries. For example, acetaminophen and paracetamol or salbutamol and albuterol.

Short Display A name associated with the medication being described
Cardinality 0..1
Type string
Summary true
MedicationKnowledge.relatedMedicationKnowledge
Element Id MedicationKnowledge.relatedMedicationKnowledge
Definition

Associated or related medications. For example, if the medication is a branded product (e.g. Crestor), this is the Therapeutic Moeity (e.g. Rosuvastatin) or if this is a generic medication (e.g. Rosuvastatin), this would link to a branded product (e.g. Crestor.

Short Display Associated or related medication information
Cardinality 0..*
Summary false
MedicationKnowledge.relatedMedicationKnowledge.type
Element Id MedicationKnowledge.relatedMedicationKnowledge.type
Definition

The category of the associated medication knowledge reference.

Short Display Category of medicationKnowledge
Cardinality 1..1
Type CodeableConcept
Summary false
MedicationKnowledge.relatedMedicationKnowledge.reference
Element Id MedicationKnowledge.relatedMedicationKnowledge.reference
Definition

Associated documentation about the associated medication knowledge.

Short Display Associated documentation about the associated medication knowledge
Cardinality 1..*
Type Reference(MedicationKnowledge)
Summary false
MedicationKnowledge.associatedMedication
Element Id MedicationKnowledge.associatedMedication
Definition

Links to associated medications that could be prescribed, dispensed or administered.

Short Display The set of medication resources that are associated with this medication
Cardinality 0..*
Type Reference(Medication)
Summary false
MedicationKnowledge.productType
Element Id MedicationKnowledge.productType
Definition

Category of the medication or product (e.g. branded product, therapeutic moeity, generic product, innovator product, etc.).

Short Display Category of the medication or product
Cardinality 0..*
Type CodeableConcept
Summary false
MedicationKnowledge.monograph
Element Id MedicationKnowledge.monograph
Definition

Associated documentation about the medication.

Short Display Associated documentation about the medication
Cardinality 0..*
Summary false
MedicationKnowledge.monograph.type
Element Id MedicationKnowledge.monograph.type
Definition

The category of documentation about the medication. (e.g. professional monograph, patient education monograph).

Short Display The category of medication document
Cardinality 0..1
Type CodeableConcept
Summary false
MedicationKnowledge.monograph.source
Element Id MedicationKnowledge.monograph.source
Definition

Associated documentation about the medication.

Short Display Associated documentation about the medication
Cardinality 0..1
Type Reference(DocumentReference)
Summary false
MedicationKnowledge.preparationInstruction
Element Id MedicationKnowledge.preparationInstruction
Definition

The instructions for preparing the medication.

Short Display The instructions for preparing the medication
Cardinality 0..1
Type markdown
Summary false
MedicationKnowledge.cost
Element Id MedicationKnowledge.cost
Definition

The price of the medication.

Short Display The pricing of the medication
Cardinality 0..*
Summary false
MedicationKnowledge.cost.effectiveDate
Element Id MedicationKnowledge.cost.effectiveDate
Definition

The date range for which the cost information of the medication is effective.

Short Display The date range for which the cost is effective
Cardinality 0..*
Type Period
Summary false
MedicationKnowledge.cost.type
Element Id MedicationKnowledge.cost.type
Definition

The category of the cost information. For example, manufacturers' cost, patient cost, claim reimbursement cost, actual acquisition cost.

Short Display The category of the cost information
Cardinality 1..1
Type CodeableConcept
Summary false
MedicationKnowledge.cost.source
Element Id MedicationKnowledge.cost.source
Definition

The source or owner that assigns the price to the medication.

Short Display The source or owner for the price information
Cardinality 0..1
Type string
Summary false
MedicationKnowledge.cost.cost[x]
Element Id MedicationKnowledge.cost.cost[x]
Definition

The price or representation of the cost (for example, Band A, Band B or $, $$) of the medication.

Short Display The price or category of the cost of the medication
Cardinality 1..1
Terminology Binding Medication Cost Category Codes (Example)
Type Money|CodeableConcept
[x] Note See Choice of Datatypes for further information about how to use [x]
Summary false
MedicationKnowledge.monitoringProgram
Element Id MedicationKnowledge.monitoringProgram
Definition

The program under which the medication is reviewed.

Short Display Program under which a medication is reviewed
Cardinality 0..*
Summary true
MedicationKnowledge.monitoringProgram.type
Element Id MedicationKnowledge.monitoringProgram.type
Definition

Type of program under which the medication is monitored.

Short Display Type of program under which the medication is monitored
Cardinality 0..1
Type CodeableConcept
Summary false
MedicationKnowledge.monitoringProgram.name
Element Id MedicationKnowledge.monitoringProgram.name
Definition

Name of the reviewing program.

Short Display Name of the reviewing program
Cardinality 0..1
Type string
Summary false
MedicationKnowledge.indicationGuideline
Element Id MedicationKnowledge.indicationGuideline
Definition

Guidelines or protocols that are applicable for the administration of the medication based on indication.

Short Display Guidelines or protocols for administration of the medication for an indication
Cardinality 0..*
Summary false
MedicationKnowledge.indicationGuideline.indication
Element Id MedicationKnowledge.indicationGuideline.indication
Definition

Indication or reason for use of the medication that applies to the specific administration guideline.

Short Display Indication for use that applies to the specific administration guideline
Cardinality 0..*
Type CodeableReference(ClinicalUseDefinition)
Summary false
MedicationKnowledge.indicationGuideline.dosingGuideline
Element Id MedicationKnowledge.indicationGuideline.dosingGuideline
Definition

The guidelines for the dosage of the medication for the indication.

Short Display Guidelines for dosage of the medication
Cardinality 0..*
Summary false
MedicationKnowledge.indicationGuideline.dosingGuideline.treatmentIntent
Element Id MedicationKnowledge.indicationGuideline.dosingGuideline.treatmentIntent
Definition

The overall intention of the treatment, for example, prophylactic, supporative, curative, etc.

Short Display Intention of the treatment
Cardinality 0..1
Type CodeableConcept
Summary false
MedicationKnowledge.indicationGuideline.dosingGuideline.dosage
Element Id MedicationKnowledge.indicationGuideline.dosingGuideline.dosage
Definition

Dosage for the medication for the specific guidelines.

Short Display Dosage for the medication for the specific guidelines
Cardinality 0..*
Summary false
MedicationKnowledge.indicationGuideline.dosingGuideline.dosage.type
Element Id MedicationKnowledge.indicationGuideline.dosingGuideline.dosage.type
Definition

The type or category of dosage for a given medication (for example, prophylaxis, maintenance, therapeutic, etc.).

Short Display Category of dosage for a medication
Cardinality 1..1
Type CodeableConcept
Summary false
MedicationKnowledge.indicationGuideline.dosingGuideline.dosage.dosage
Element Id MedicationKnowledge.indicationGuideline.dosingGuideline.dosage.dosage
Definition

Dosage for the medication for the specific guidelines.

Short Display Dosage for the medication for the specific guidelines
Cardinality 1..*
Type Dosage
Summary false
MedicationKnowledge.indicationGuideline.dosingGuideline.administrationTreatment
Element Id MedicationKnowledge.indicationGuideline.dosingGuideline.administrationTreatment
Definition

The type of the treatment that the guideline applies to, for example, long term therapy, first line treatment, etc.

Short Display Type of treatment the guideline applies to
Cardinality 0..1
Type CodeableConcept
Summary false
MedicationKnowledge.indicationGuideline.dosingGuideline.patientCharacteristic
Element Id MedicationKnowledge.indicationGuideline.dosingGuideline.patientCharacteristic
Definition

Characteristics of the patient that are relevant to the administration guidelines (for example, height, weight, gender, etc.).

Short Display Characteristics of the patient that are relevant to the administration guidelines
Cardinality 0..*
Summary false
MedicationKnowledge.indicationGuideline.dosingGuideline.patientCharacteristic.type
Element Id MedicationKnowledge.indicationGuideline.dosingGuideline.patientCharacteristic.type
Definition

The categorization of the specific characteristic that is relevant to the administration guideline (e.g. height, weight, gender).

Short Display Categorization of specific characteristic that is relevant to the administration guideline
Cardinality 1..1
Type CodeableConcept
Summary false
MedicationKnowledge.indicationGuideline.dosingGuideline.patientCharacteristic.value[x]
Element Id MedicationKnowledge.indicationGuideline.dosingGuideline.patientCharacteristic.value[x]
Definition

The specific characteristic (e.g. height, weight, gender, etc.).

Short Display The specific characteristic
Cardinality 0..1
Type CodeableConcept|Quantity|Range
[x] Note See Choice of Datatypes for further information about how to use [x]
Summary false
MedicationKnowledge.medicineClassification
Element Id MedicationKnowledge.medicineClassification
Definition

Categorization of the medication within a formulary or classification system.

Short Display Categorization of the medication within a formulary or classification system
Cardinality 0..*
Summary false
MedicationKnowledge.medicineClassification.type
Element Id MedicationKnowledge.medicineClassification.type
Definition

The type of category for the medication (for example, therapeutic classification, therapeutic sub-classification).

Short Display The type of category for the medication (for example, therapeutic classification, therapeutic sub-classification)
Cardinality 1..1
Type CodeableConcept
Summary false
MedicationKnowledge.medicineClassification.source[x]
Element Id MedicationKnowledge.medicineClassification.source[x]
Definition

Either a textual source of the classification or a reference to an online source.

Short Display The source of the classification
Cardinality 0..1
Type string|uri
[x] Note See Choice of Datatypes for further information about how to use [x]
Summary false
MedicationKnowledge.medicineClassification.classification
Element Id MedicationKnowledge.medicineClassification.classification
Definition

Specific category assigned to the medication (e.g. anti-infective, anti-hypertensive, antibiotic, etc.).

Short Display Specific category assigned to the medication
Cardinality 0..*
Type CodeableConcept
Summary false
MedicationKnowledge.packaging
Element Id MedicationKnowledge.packaging
Definition

Information that only applies to packages (not products).

Short Display Details about packaged medications
Cardinality 0..*
Summary false
MedicationKnowledge.packaging.cost
Element Id MedicationKnowledge.packaging.cost
Definition

The cost of the packaged medication.

Short Display Cost of the packaged medication
Cardinality 0..*
Type See MedicationKnowledge.cost
Summary false
MedicationKnowledge.packaging.packagedProduct
Element Id MedicationKnowledge.packaging.packagedProduct
Definition

A reference to a PackagedProductDefinition that provides the details of the product that is in the packaging and is being priced.

Short Display The packaged medication that is being priced
Cardinality 0..1
Type Reference(PackagedProductDefinition)
Summary false
MedicationKnowledge.clinicalUseIssue
Element Id MedicationKnowledge.clinicalUseIssue
Definition

Potential clinical issue with or between medication(s) (for example, drug-drug interaction, drug-disease contraindication, drug-allergy interaction, etc.).

Short Display Potential clinical issue with or between medication(s)
Cardinality 0..*
Type Reference(ClinicalUseDefinition)
Summary false
MedicationKnowledge.storageGuideline
Element Id MedicationKnowledge.storageGuideline
Definition

Information on how the medication should be stored, for example, refrigeration temperatures and length of stability at a given temperature.

Short Display How the medication should be stored
Cardinality 0..*
Summary false
MedicationKnowledge.storageGuideline.reference
Element Id MedicationKnowledge.storageGuideline.reference
Definition

Reference to additional information about the storage guidelines.

Short Display Reference to additional information
Cardinality 0..1
Type uri
Summary false
MedicationKnowledge.storageGuideline.note
Element Id MedicationKnowledge.storageGuideline.note
Definition

Additional notes about the storage.

Short Display Additional storage notes
Cardinality 0..*
Type Annotation
Summary false
MedicationKnowledge.storageGuideline.stabilityDuration
Element Id MedicationKnowledge.storageGuideline.stabilityDuration
Definition

Duration that the medication remains stable if the environmentalSetting is respected.

Short Display Duration remains stable
Cardinality 0..1
Type Duration
Summary false
MedicationKnowledge.storageGuideline.environmentalSetting
Element Id MedicationKnowledge.storageGuideline.environmentalSetting
Definition

Describes a setting/value on the environment for the adequate storage of the medication and other substances. Environment settings may involve temperature, humidity, or exposure to light.

Short Display Setting or value of environment for adequate storage
Cardinality 0..*
Summary false
MedicationKnowledge.storageGuideline.environmentalSetting.type
Element Id MedicationKnowledge.storageGuideline.environmentalSetting.type
Definition

Identifies the category or type of setting (e.g., type of location, temperature, humidity).

Short Display Categorization of the setting
Cardinality 1..1
Type CodeableConcept
Summary false
MedicationKnowledge.storageGuideline.environmentalSetting.value[x]
Element Id MedicationKnowledge.storageGuideline.environmentalSetting.value[x]
Definition

Value associated to the setting. E.g., 40° – 50°F for temperature.

Short Display Value of the setting
Cardinality 1..1
Type Quantity|Range|CodeableConcept
[x] Note See Choice of Datatypes for further information about how to use [x]
Summary false
MedicationKnowledge.regulatory
Element Id MedicationKnowledge.regulatory
Definition

Regulatory information about a medication.

Short Display Regulatory information about a medication
Cardinality 0..*
Summary false
MedicationKnowledge.regulatory.regulatoryAuthority
Element Id MedicationKnowledge.regulatory.regulatoryAuthority
Definition

The authority that is specifying the regulations.

Short Display Specifies the authority of the regulation
Cardinality 1..1
Type Reference(Organization)
Summary false
MedicationKnowledge.regulatory.substitution
Element Id MedicationKnowledge.regulatory.substitution
Definition

Specifies if changes are allowed when dispensing a medication from a regulatory perspective.

Short Display Specifies if changes are allowed when dispensing a medication from a regulatory perspective
Cardinality 0..*
Summary false
MedicationKnowledge.regulatory.substitution.type
Element Id MedicationKnowledge.regulatory.substitution.type
Definition

Specifies the type of substitution allowed.

Short Display Specifies the type of substitution allowed
Cardinality 1..1
Type CodeableConcept
Summary false
MedicationKnowledge.regulatory.substitution.allowed
Element Id MedicationKnowledge.regulatory.substitution.allowed
Definition

Specifies if regulation allows for changes in the medication when dispensing.

Short Display Specifies if regulation allows for changes in the medication when dispensing
Cardinality 1..1
Type boolean
Summary false
MedicationKnowledge.regulatory.schedule
Element Id MedicationKnowledge.regulatory.schedule
Definition

Specifies the schedule of a medication in jurisdiction.

Short Display Specifies the schedule of a medication in jurisdiction
Cardinality 0..*
Type CodeableConcept
Summary false
MedicationKnowledge.regulatory.maxDispense
Element Id MedicationKnowledge.regulatory.maxDispense
Definition

The maximum number of units of the medication that can be dispensed in a period.

Short Display The maximum number of units of the medication that can be dispensed in a period
Cardinality 0..1
Summary false
MedicationKnowledge.regulatory.maxDispense.quantity
Element Id MedicationKnowledge.regulatory.maxDispense.quantity
Definition

The maximum number of units of the medication that can be dispensed.

Short Display The maximum number of units of the medication that can be dispensed
Cardinality 1..1
Type SimpleQuantity
Summary false
MedicationKnowledge.regulatory.maxDispense.period
Element Id MedicationKnowledge.regulatory.maxDispense.period
Definition

The period that applies to the maximum number of units.

Short Display The period that applies to the maximum number of units
Cardinality 0..1
Type Duration
Summary false
MedicationKnowledge.definitional
Element Id MedicationKnowledge.definitional
Definition

Along with the link to a Medicinal Product Definition resource, this information provides common definitional elements that are needed to understand the specific medication that is being described.

Short Display Minimal definition information about the medication
Cardinality 0..1
Summary false
MedicationKnowledge.definitional.definition
Element Id MedicationKnowledge.definitional.definition
Definition

Associated definitions for this medication.

Short Display Definitional resources that provide more information about this medication
Cardinality 0..*
Type Reference(MedicinalProductDefinition)
Summary false
MedicationKnowledge.definitional.doseForm
Element Id MedicationKnowledge.definitional.doseForm
Definition

Describes the form of the item. Powder; tablets; capsule.

Short Display powder | tablets | capsule +
Cardinality 0..1
Terminology Binding SNOMED CT Form Codes (Example)
Type CodeableConcept
Summary false
Comments

When Medication is referenced from MedicationRequest, this is the ordered form. When Medication is referenced within MedicationDispense, this is the dispensed form. When Medication is referenced within MedicationAdministration, this is administered form.

MedicationKnowledge.definitional.intendedRoute
Element Id MedicationKnowledge.definitional.intendedRoute
Definition

The intended or approved route of administration.

Short Display The intended or approved route of administration
Cardinality 0..*
Terminology Binding SNOMED CT Route Codes (Example)
Type CodeableConcept
Summary false
MedicationKnowledge.definitional.ingredient
Element Id MedicationKnowledge.definitional.ingredient
Definition

Identifies a particular constituent of interest in the product.

Short Display Active or inactive ingredient
Cardinality 0..*
Summary true
MedicationKnowledge.definitional.ingredient.item
Element Id MedicationKnowledge.definitional.ingredient.item
Definition

A reference to the resource that provides information about the ingredient.

Short Display Substances contained in the medication
Cardinality 1..1
Type CodeableReference(Substance)
Summary true
MedicationKnowledge.definitional.ingredient.type
Element Id MedicationKnowledge.definitional.ingredient.type
Definition

Indication of whether this ingredient affects the therapeutic action of the drug.

Short Display A code that defines the type of ingredient, active, base, etc
Cardinality 0..1
Terminology Binding RoleClassIngredientEntity icon (Example)
Type CodeableConcept
Summary false
MedicationKnowledge.definitional.ingredient.strength[x]
Element Id MedicationKnowledge.definitional.ingredient.strength[x]
Definition

Specifies how many (or how much) of the items there are in this Medication. For example, 250 mg per tablet. This is expressed as a ratio where the numerator is 250mg and the denominator is 1 tablet but can also be expressed a quantity when the denominator is assumed to be 1 tablet.

Short Display Quantity of ingredient present
Cardinality 0..1
Terminology Binding Medication Ingredient Strength Codes (Example)
Type Ratio|CodeableConcept|Quantity
[x] Note See Choice of Datatypes for further information about how to use [x]
Summary false
MedicationKnowledge.definitional.drugCharacteristic
Element Id MedicationKnowledge.definitional.drugCharacteristic
Definition

Specifies descriptive properties of the medicine, such as color, shape, imprints, etc.

Short Display Specifies descriptive properties of the medicine
Cardinality 0..*
Summary false
MedicationKnowledge.definitional.drugCharacteristic.type
Element Id MedicationKnowledge.definitional.drugCharacteristic.type
Definition

A code specifying which characteristic of the medicine is being described (for example, colour, shape, imprint).

Short Display Code specifying the type of characteristic of medication
Cardinality 0..1
Terminology Binding medicationKnowledge Characteristic Codes (Example)
Type CodeableConcept
Summary false
MedicationKnowledge.definitional.drugCharacteristic.value[x]
Element Id MedicationKnowledge.definitional.drugCharacteristic.value[x]
Definition

Description of the characteristic.

Short Display Description of the characteristic
Cardinality 0..1
Type CodeableConcept|string|SimpleQuantity|base64Binary|Attachment
[x] Note See Choice of Datatypes for further information about how to use [x]
Summary false
Comments

The description should be provided as a CodeableConcept, SimpleQuantity or an image. The description can be a string only when these others are not available.