Structured Headings
Domain Message Specification

Housing Tabular View

COCD_TP146075GB01
Housing

This entry class constrains the CDA observation class.

Template for observations relating to assessment of current housing situation and suitability of housing.

Used by:
[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: x_ActMoodDocumentObservation } )
Model Attribute Description

The HL7 attribute moodCode uses a code to describe the mood of the observation.

Implementation in XML Instance

The XML attribute moodCode should use a value from the HL7 x_ActMoodDocumentObservation vocabulary.
[1..1] [M] code (CV { CNE:CDAObservationType } )
{ Fixed="HRF" }

Model Attribute Description

The HL7 attribute value uses a code from the CDAObservationType vocabulary to describe this class as an Housing related finding.

Implementation in XML Instance

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

  • The XML attribute code should contain the fixed value "HRF".
  • The XML attribute codeSystem should contain the fixed OID "2.16.840.1.113883.2.1.3.2.4.17.220"
  • The XML attribute displayName should carry the description associated with the code.
[1..1] [M] effectiveTime (IVL<TS>)
Model Attribute Description

The HL7 attribute effectiveTime is used for the time of the accommodation observation.

Where known the dates that the observation was effective on the patient should be recorded.

Implementation in XML Instance

The Interval of Points in Time data type flavour is used to carry this information in the XML element effectiveTime using the value attributes of the of the XML elements low and high.

The date range shall be carried as follows:

The XML attribute value of the XML elements low and high, shall be populated with 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 minute
  • ss is 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.

The Time Interval Complete data type shall be used:
  • The XML attribute value of the XML element low shall be populated with a 'start date' time stamp to indicate the onset of the allergy or adverse reaction.
  • The XML attribute value of the XML element high may be populated with an 'end date' time stamp to indicate when allergy or adverse reaction was no longer present.

The XML attribute value of the XML elements low and high should be populated to the level of detail that is available on the sending system.

[1..1] [M] id (II)
Model Attribute Description

The HL7 attribute id uses an identifier to identify the instance of the housing related observation.

Implementation in XML Instance

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

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

The HL7 attribute code uses a code to describe the status of the safeguarding event.

Implementation in XML Instance

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

  • The XML attribute code should contain the value of "completed".
[1..1] [M] templateId (II)
{ Fixed="COCD_TP146075GB01#Housing" }
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_TP146075GB01#Housing".
[1..1] [M] value (CD { CNE:HousingSnCT } )

Model Attribute Description

The HL7 attribute value uses a code from the HousingSnCT vocabulary to describe the person housing.

Implementation in XML Instance

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

  • The XML attribute xsi:type shall contain the value "CD"
  • The XML attribute code should contain a value from the vocabulary.
  • The XML attribute codeSystem should contain the fixed OID "2.16.840.1.113883.2.1.3.2.4.15"
  • The XML attribute displayName should carry the description associated code.It is recommended that the preferred term is used.
  • The XML element originalText may be used to carry the original text transcribed by the author.
  • The XML element originalText may also be used to carry an XML element reference. This can be used to link the coded item to the relevant text in the CDA section
  • Qualifiers may be used if required

Where there is no suitable vocabulary to enable the information to be coded then:

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

  • The XML attribute xsi:type shall contain the value "CD"
  • The XML attribute code should be omitted.
  • The XML attribute codeSystem should be omitted.
  • The XML attribute displayName should be omitted.
  • The XML element originalText shall be used to carry the original text transcribed by the author.
  • The XML element originalText may also be used to carry an XML element reference. This can be used to link the original text to the relevant text in the CDA section.
[0..1] author

This template class constrains the CDA author class.

The person who authored the recording of the housing observation, this must be included if the author is different to the document (inherited) author.

If there is no known author for the information held on the source system then:

  • The information may be included and the document author will be deemed to be the author (by inheritance). The author should be asked to decide whether this is acceptable or not.
  • If the document author does not want to be considered as the author of the information then information must not be included in the document.
[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-000005#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:AuthorFunctionType } )
{ Fixed="OA" }
Model Attribute Description

The HL7 attribute functionCode uses a code from the vocabulary AuthorFunctionType to describe the function of the 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_TP146075GB01#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_TP146075GB01#author".
[1..1] [R] time (TS)
The time at which the author authored the observation.
[1..1] participant (AuthorChoice)
A link to the choice of authors.
[0..1] informant

This template class constrains the CDA informant class.

Refers to who informed about the housing observation.

[1..1] [M] typeCode (CS { CNE: ParticipationType } )
{ Fixed="INF" }

Model Attribute Description

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

Implementation in XML Instance

  • The XML attribute typeCode is fixed to "INF".
[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-000002#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] templateId (II)
{ Fixed="COCD_TP146075GB01#informant" }
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_TP146075GB01#informant".
[1..1] participant (InformantChoice)
A link to the choice of informant.
AuthorChoice
An abstract placeholder for the templates of authors of the housing related finding.
Used by: Housing
[1..1] : Template1

A link to the choice of author templates.

InformantChoice

An abstract placeholder for the templates of informants of the housing related finding.

Used by: Housing
[1..1] : Template3

A link to the choice of templates for an informant.