Structured Headings
Domain Message Specification

DiscontinuedMedication Tabular View

COCD_TP146053GB01
DiscontinuedMedication

This template class constrains the CDA substance administration class.

This template class is used to hold details of medications that have been discontinued.

Used by:
[1..1] [M] classCode (CS { CNE: ActClass } )
{ Fixed="SBADM" }

Model Attribute Description

The HL7 attribute classCode uses a code to describe this class as a substance administration.

Implementation in XML Instance

  • The XML attribute classCode is fixed to "SBADM".
[1..1] [M] moodCode (CS { CNE: ActMood } )
{ Fixed="EVN" }

Model Attribute Description

The HL7 attribute moodCode uses a code to describe this class as a substance administration event.

Implementation in XML Instance

  • The XML attribute moodCode is fixed to "EVN".
[0..1] effectiveTime (TS)

Model Attribute Description

The HL7 attribute effectiveTime is used to record the date and time of the discontinuation of the medication.

Implementation in XML Instance

The Timestamp datatype is used to carry this information as follows:

  • The XML attribute value of the XML element effectiveTime shall be populated with the time the medication was discontinuation using a time stamp in the format yyyymmddhhmmss[+|-ZZzz] where:
  • yyyy is the year
  • mm is the month
  • dd is the day
  • hh is the hour
  • mm is the minutes
  • ss is the seconds
  • [+|-ZZzz] is the time zone offset in hours and minutes

Sections from the right of this representation may be left off when the sending system does not record to this level of accuracy. When hours are present, the time zone offset must also be present.

[1..1] [M] id (II)

Model Attribute Description

The HL7 attribute id uses an identifier to identify each unique instance of a section.

Implementation in XML Instance

The Identifier Global data type flavour is used to carry the identifier in the XML element id as follows:

  • The XML attribute root shall contain a DCE UUID
[1..1] [M] statusCode (CS { CNE:ActStatus } )
{ Fixed="aborted" }

Model Attribute Description

The HL7 attribute statusCode uses a code from the ActStatus vocabulary to describes the status of medication change. As this template describes discontinued medications only, this is fixed to aborted.

Implementation in XML Instance

The Coded Only datatype flavour is used to carry this information as follows:

  • The XML attribute code of the XML element statusCode is fixed to aborted
[1..1] [M] templateId (II)
{ Fixed="COCD_TP146053GB01#DiscontinuedMedication" }
Model Attribute Description

The HL7 attribute templateId provides a unique identifier for the template and the class name within that template. This is used to identify how the CDA standard has been constrained for NHS use.

Implementation in XML Instance

The Identifier External data type flavour is used to carry this information in the XML element templateId as follows:
  • The XML attribute root is fixed to the OID "2.16.840.1.113883.2.1.3.2.4.18.2"
  • The XML attribute extension is fixed to "COCD_TP146053GB01#DiscontinuedMedication".
[0..1] text (ST)

Model Attribute Description

The HL7 attribute text is used to carry the description of the medication discontinuation.

Implementation in XML Instance

  • The text element shall contain the description of the medication discontinuation.
[0..1] author

This template class constrains the CDA author class.

This class is a links to the author of the medication entry.
[1..1] [M] typeCode (CS { CNE: ParticipationType } )
{ Fixed="AUT" }

Model Attribute Description

The HL7 attribute typeCode describes this class as an author participation.

Implementation in XML Instance

  • The XML attribute typeCode is fixed to "AUT".
[1..1] [M] contextControlCode (CS { CNE: ContextControl } )
{ Fixed="OP" }

Model Attribute Description

The HL7 attribute contextControlCode uses a set of codes from the HL7 vocabulary ContextControl to determine whether participations associated with the parent act are conducted across to the child act (also associated with the child act). This set of codes also determine how these participations conduct.

The conduction can only take place if the contextConductionInd in the actRelationships is set to "true".

The value of this attribute is fixed in the HL7 model to "OP":

  • "O" (Overriding) - the author replaces any author that has been conducted from any previous acts.
  • "P" (Propagating) - the author is conducted to all child acts where the contextConductionInd is set to "true".

Implementation in XML Instance

  • The XML attribute contextControlCode shall contain the value "OP"
[1..1] [M] contentId (II) { "NPFIT-300001#Role" }

Model Attribute Description

The HL7 (NHS localisation) attribute contentId, when valued in an instance, provides a unique forward pointing identifier for the template which constrains the classes and attributes which follow, for NHS use.

The attribute is intended simply as a structural navigational aid and should not be relied upon as an indicator of semantic meaning. The contentId is populated at run time with a value from the allowed list contained in the model.


Implementation in XML Instance

The Identifier External data type flavour is used to carry this information in the XML element contentId as follows:
  • The XML attribute root is fixed to the OID "2.16.840.1.113883.2.1.3.2.4.18.16"
  • The XML attribute extension shall contain one of the allowed template artefact identifiers.
[1..1] [M] functionCode (CV { CNE:ParticipationFunction } )
{ Fixed="OA" }

Model Attribute Description

The HL7 attribute functionCode uses a code from the vocabulary AuthorFunctionType to describe the function of the author as the originating author.

Implementation in XML Instance

The Coded Plain data type flavour of the Coded Value (CV) data type shall be used to carry this information in the XML element functionCode as follows:

  • The XML attribute code is fixed to "OA"
  • The XML attribute codeSystem is fixed to the OID "2.16.840.1.113883.2.1.3.2.4.17.178"
  • The XML attribute displayName is fixed to the author's function name "Originating Author".
[1..1] [M] templateId (II)
{ Fixed="COCD_TP146053GB01#author" }
Model Attribute Description

The HL7 attribute templateId provides a unique identifier for the template and the class name within that template. This is used to identify how the CDA standard has been constrained for NHS use.

Implementation in XML Instance

The Identifier External data type flavour is used to carry this information in the XML element templateId as follows:
  • The XML attribute root is fixed to the OID "2.16.840.1.113883.2.1.3.2.4.18.2"
  • The XML attribute extension is fixed to "COCD_TP146053GB01#author".
[1..1] [R] time (TS)

Model Attribute Description

The HL7 attribute time is used to define the time the author originally recorded the medication.

Implementation in XML Instance

The XML attribute value of the XML element time shall be populated with the time that author recorded the information using a time stamp in the format yyyymmddhhmmss[+|-ZZzz] where:

  • yyyy is the year
  • mm is the month
  • dd is the day
  • hh is the hour
  • mm is the minutes
  • ss is the seconds
  • [+|-ZZzz] is the time zone offset in hours and minutes

Sections from the right of this representation may be left off when the sending system does not record to this level of accuracy. When hours are present, the time zone offset must also be present.

Where no time is recorded or available then:

  • The XML attribute nullFlavor of the XML element time shall contain the value "UNK"
[1..1] participant (AuthorChoice)
A link to the choice of author templates.
[1..1] [M] consumable

This template class constrains the CDA consumable class.

This class is a links to the discontinued medication or medical device.
[1..1] [M] typeCode (CS { CNE: ParticipationType } )
{ Fixed="CSM" }

Model Attribute Description

The HL7 attribute typeCode describes this class as a consumable participation.

Implementation in XML Instance

  • The XML attribute typeCode is fixed to "CSM".
[1..1] [M] templateId (II)
{ Fixed="COCD_TP146053GB01#consumable" }
Model Attribute Description

The HL7 attribute templateId provides a unique identifier for the template and the class name within that template. This is used to identify how the CDA standard has been constrained for NHS use.

Implementation in XML Instance

The Identifier External data type flavour is used to carry this information in the XML element templateId as follows:
  • The XML attribute root is fixed to the OID "2.16.840.1.113883.2.1.3.2.4.18.2"
  • The XML attribute extension is fixed to "COCD_TP146053GB01#consumable".
[1..1] [M] manufacturedProduct (ManufacturedProduct)
A link to the manufactured product.
[0..1] entryRelationship

This template class constrains the CDA reason class.

This class is a links to the indication for the discontinued medication entry.
[1..1] [M] typeCode (CS { CNE: ActRelationshipType } )
{ Fixed="RSON" }

Model Attribute Description

The HL7 attribute typeCode describes this class as a reason.

Implementation in XML Instance

  • The XML attribute typeCode is fixed to "RSON".
[1..1] [M] contextConductionInd (BL)
{ Fixed="true" }

Model Attribute Description

The HL7 attribute contextConductionInd uses a Boolean value (true or false) to determine whether information associated with the parent act is conducted across to the child act (also associated with the child act).

Implementation in XML Instance

  • The XML attribute contextConductionInd is fixed to "true".
[1..1] [M] seperatableInd (BL)
{ Fixed="false" }

Model Attribute Description

The HL7 attribute seperatableInd uses a Boolean (true or false) to indicate whether two pieces of information can be interpreted separately.

Implementation in XML Instance

  • The XML attribute seperatableInd is fixed to "false".
[1..1] [M] templateId (II)
{ Fixed="COCD_TP146053GB01#entryRelationship" }
Model Attribute Description

The HL7 attribute templateId provides a unique identifier for the template and the class name within that template. This is used to identify how the CDA standard has been constrained for NHS use.

Implementation in XML Instance

The Identifier External data type flavour is used to carry this information in the XML element templateId as follows:
  • The XML attribute root is fixed to the OID "2.16.840.1.113883.2.1.3.2.4.18.2"
  • The XML attribute extension is fixed to "COCD_TP146053GB01#entryRelationship".
[1..1] justifyingIndication (Indication)
A link to the justifying indication.
ManufacturedProduct

This template class constrains the CDA ManufacturedProduct class.

This template class is used for the role that plays the manufactured product.

Used by: DiscontinuedMedication
[1..1] [M] classCode (CS { CNE: RoleClass } )
{ Fixed="MANU" }

Model Attribute Description

The HL7 attribute classCode uses a code to describe this class as a manufactured product.

Implementation in XML Instance

  • The XML attribute classCode is fixed to "MANU".
[1..1] [M] templateId (II)
{ Fixed="COCD_TP146053GB01#manufacturedProduct" }
Model Attribute Description

The HL7 attribute templateId provides a unique identifier for the template and the class name within that template. This is used to identify how the CDA standard has been constrained for NHS use.

Implementation in XML Instance

The Identifier External data type flavour is used to carry this information in the XML element templateId as follows:
  • The XML attribute root is fixed to the OID "2.16.840.1.113883.2.1.3.2.4.18.2"
  • The XML attribute extension is fixed to "COCD_TP146053GB01#manufacturedProduct".
[1..1] [M] manufacturedManufacturedMaterialKind (ManufacturedMaterialKind)
A link to the manufactured material kind.
ManufacturedMaterialKind

This template class constrains the CDA Material class.

This template class is used for the entity that is the manufactured product.

Used by: ManufacturedProduct
[1..1] [M] classCode (CS { CNE: EntityClass } )
{ Fixed="MMAT" }

Model Attribute Description

The HL7 attribute classCode uses a code to describe this class as a manufactured material.

Implementation in XML Instance

  • The XML attribute classCode is fixed to "MMAT".
[1..1] [M] determinerCode (CS { CNE: EntityDeterminer } )
{ Fixed="KIND" }

Model Attribute Description

The HL7 attribute determinerCode uses a code to describe this class as an Kind of manufactured material.

Implementation in XML Instance

  • The XML attribute determinerCode is fixed to "KIND".
[1..1] [M] code (CE { CNE:MedicationItemSnCT } )

Model Attribute Description

The HL7 attribute code uses a concept from the Dictionary of Medicines and Devices (dm+d) to identify the medicine or device being discontinued for the patient. If the medicine being recorded does not appear on dm+d (for example for historical reasons, patient reported items, extemporaneous preparations, or simply not appearing on dm+d), the originalText element of code should be used to record these medicines.

Implementation in XML Instance

The Coded Value (CV) data type shall be used to carry this information in the XML element code as follows:

If the medicine or device is a dm+d concept

  • The XML attribute code shall contain a value from the vocabulary MedicationItemSnCT.
  • The XML attribute codeSystem shall contain the OID "2.16.840.1.113883.2.1.3.2.4.15".
  • The XML attribute displayName shall carry the description associated with the code.

If the medicine is not a dm+d concept (note that devices that are not part of dm+d are recorded separately)

  • The XML element originalText should be used to record the medicine.
[1..1] [M] templateId (II)
{ Fixed="COCD_TP146053GB01#manufacturedManufacturedMaterialKind" }
Model Attribute Description

The HL7 attribute templateId provides a unique identifier for the template and the class name within that template. This is used to identify how the CDA standard has been constrained for NHS use.

Implementation in XML Instance

The Identifier External data type flavour is used to carry this information in the XML element templateId as follows:
  • The XML attribute root is fixed to the OID "2.16.840.1.113883.2.1.3.2.4.18.2"
  • The XML attribute extension is fixed to "COCD_TP146053GB01#manufacturedManufacturedMaterialKind".
AuthorChoice
Choice of authors for the medication item.
Used by: DiscontinuedMedication
[1..1] : Template1
Indication

This template class constrains the CDA observation class.

This template class is used to carry the indication associated with a discontinued medication (i.e. reason for stopping the medication). Indications are sent as SNOMED CT finding concepts, or as text, in the value attribute of this class.

Used by: DiscontinuedMedication
[1..1] [M] classCode (CS { CNE: ActClass } )
{ Fixed="OBS" }

Model Attribute Description

The HL7 attribute classCode uses a code to describe this class as an observation.

Implementation in XML Instance

  • The XML attribute classCode is fixed to "OBS".
[1..1] [M] moodCode (CS { CNE: ActMood } )
{ Fixed="EVN" }

Model Attribute Description

The HL7 attribute moodCode uses a code to describe this class as an observation event.

Implementation in XML Instance

  • The XML attribute moodCode is fixed to "EVN".
[1..1] [M] code (CV { CNE:SnomedCT } )
{ Fixed="410665000" }

Model Attribute Description

The HL7 attribute code uses a fixed concept from the SNOMED CT terminology to indicate that the concept being carried in the value attribute of this class is an indication for discontinuing a medication.

Implementation in XML Instance

The Coded Value (CV) data type shall be used to carry this information in the XML element code as follows:

  • The XML attribute code shall contain the value "410665000".
  • The XML attribute codeSystem shall contain the OID "2.16.840.1.113883.2.1.3.2.4.15"
  • The XML attribute displayName shall carry the description associated with the code.
[1..1] [M] templateId (II)
{ Fixed="COCD_TP146053GB01#justifyingIndication" }
Model Attribute Description

The HL7 attribute templateId provides a unique identifier for the template and the class name within that template. This is used to identify how the CDA standard has been constrained for NHS use.

Implementation in XML Instance

The Identifier External data type flavour is used to carry this information in the XML element templateId as follows:
  • The XML attribute root is fixed to the OID "2.16.840.1.113883.2.1.3.2.4.18.2"
  • The XML attribute extension is fixed to "COCD_TP146053GB01#justifyingIndication".
[1..1] [M] value (CV { CNE:FindingTypeSnCT } )

Model Attribute Description

The HL7 attribute value uses a concept from the SNOMED CT terminology, or a text representation, to describe the medication discontinuation indication.

Implementation in XML Instance

The Coded Value (CV) data type shall be used to carry this information in the XML element value as follows:

If using a concept from the SNOMED CT terminology

  • The XML attribute xsi:type shall contain the value "CV"
  • The XML attribute code shall contain a value from the FindingTypeSnCT vocabulary.
  • The XML attribute codeSystem shall contain the OID "2.16.840.1.113883.2.1.3.2.4.15".
  • The XML attribute displayName shall carry the description associated with the code.

If using text

  • The XML element originalText of the value element may be used to convey the indication.