Difference between revisions of "Header"

From HL7 Publishing Wiki
Jump to navigation Jump to search
 
(594 intermediate revisions by 2 users not shown)
Line 6: Line 6:
 
=[[CDA Document Exchange in HL7 Messages]]=
 
=[[CDA Document Exchange in HL7 Messages]]=
 
(content on separate page)
 
(content on separate page)
=[[CDA R-MIM]]=
+
=[[CDA Templating]]=
 +
(content on separate page)
 +
=[[CDA Design]]=
 
(remaining content on other page)
 
(remaining content on other page)
 
+
==[[Clinical Document]]==
 +
(remaining content on separate page)
 
==Header==
 
==Header==
  
The purpose of the CDA header is to enable clinical document exchange across and within institutions; facilitate clinical document management; and facilitate compilation of an individual patient's clinical documents into a lifetime electronic patient record.
+
The purpose of the CDA header is to enable clinical document exchange across and within institutions; facilitate clinical document management; and facilitate compilation of an individual patient's clinical documents into a lifetime electronic patient record. The CDA header sets the context for the document as a whole and the context for understanding the content contained in the document.
 
  
 
  
===Header Attributes===
+
===ClinicalDocument===
 +
 
 +
The CDA schema was produced by serialization of the CDA model. The starting point for this serialization was the ClinicalDocument class. The ClinicalDocument is the root element in a CDA document instance.
 +
 
 +
[[Image:Header.png|400px|border|center|Authenicator]]
 +
 
 +
====ClinicalDocument Attributes====
  
This section describes attributes of the root ClinicalDocument class.  
+
This section describes attributes defined in the ClinicalDocument class.  
  
The table below identifies the attributes for the ClinicalDocument class. For each attribute the name, data type, cardinality, code bindings, and binding strength are provided. The links will enable the access to the attribute definitions, data type definitions, and when appropriate, the value set or concept domain associated with the codes found in the class.   
+
The table below identifies the attributes of ClinicalDocument. For each item, the name is provided, along with the data type, wire cardinality*, code bindings, and binding type or strength. The links allow will access to the item's definition, data type definition, and when appropriate, the concept domain or value set used with the item.   
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: ClinicalDocument Attributes
+
|+Table {{AUTOTABLENUM}}: ClinicalDocument Attributes  
!RIM Attribute(s)!!Data Type!!Cardinality!!Value Set Binding!!Binding Type
+
!Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Act-classCode-att    classCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ActClass.htm#DOCCLIN DOCCLIN]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Act-moodCode-att    moodCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ActMood.htm#EVN EVN]||Fixed
 
|-
 
|-
|[http://cda/rim/rim.htm#Act-classCode-att classCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[1..1]||[http://cda/infrastructure/vocabulary/vs_ActClass.htm#ActClassClinicalDocument V:ActClassClinicalDocument]||CLOSED
+
|[http://cda/infrastructure/rim/rim.htm#InfrastructureRoot-typeId-att typeId]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-II II]||[1..1]|| ||
 
|-
 
|-
|[http://cda/rim/rim.htm#Act-moodCode-att moodCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[1..1]||[http://cda/infrastructure/vocabulary/vs_ActMood.htm#ActMoodEventOccurrence V:ActMoodEventOccurrence]||CLOSED
+
|[http://cda/infrastructure/rim/rim.htm#InfrastructureRoot-templateId-att templateId]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-II II]||[0..*]|| ||
 
|-
 
|-
|[http://cda/rim/rim.htm#Act-id-att id]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-II II]||[1..1]||||
+
|[http://cda/infrastructure/rim/rim.htm#Act-id-att id]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-II II]||[1..1]|| ||
 
|-   
 
|-   
|[http://cda/rim/rim.htm#Act-code-att code]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CE CE]||[1..1]||[http://cda/infrastructure/vocabulary/vs_LN.htm#DocumentType D:DocumentType]||OPEN
+
|[http://cda/infrastructure/rim/rim.htm#Act-code-att code]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CE CE]||[1..1]||[http://cda/infrastructure/vocabulary/vs_loinc.htm#DocumentType D:DocumentType]||Open
 
|-
 
|-
|[http://cda/rim/rim.htm#Act-title-att title]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TS TS]||[0..1]||||
+
|[http://cda/infrastructure/rim/rim.htm#Act-title-att title]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-ST ST]||[0..1]|| ||
 
|-
 
|-
|[http://cda/rim/rim.htm#Act-effectiveTime-att effectiveTime]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TS TS] ||[0..1]||||
+
|[http://cda/infrastructure/rim/rim.htm#Act-effectiveTime-att effectiveTime]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TS TS] ||[0..1]|| ||
 
|-
 
|-
|[http://cda/rim/rim.htm#Act-confidentialityCode-att confidentialityCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CE CE]>||[0..*]||[http://cda/infrastructure/vocabulary/voc_ConceptDomains.htm#Confidentiality D:Confidentiality]||OPEN
+
|[http://cda/infrastructure/rim/rim.htm#Act-confidentialityCode-att confidentialityCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CE CE]>||[0..*]||[http://cda/infrastructure/vocabulary/vs_Confidentiality.htm#x_BasicConfidentialityKind V:x_BasicConfidentialityKind]||Open
 
|-
 
|-
|[http://cda/rim/rim.htm#Act-languageCode-att languageCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CE CE]||[0..1]||[http://cda/infrastructure/vocabulary/voc_ConceptDomains.htm#HumanLanguage D:HumanLanguage]||CLOSED
+
|[http://cda/infrastructure/rim/rim.htm#Act-languageCode-att languageCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/voc_ConceptDomains.htm#HumanLanguage D:HumanLanguage]||Closed
 
|-
 
|-
|[http://cda/rim/rim.htm#Act-setId-att setId]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-II II]||[0..1]||||
+
|[http://cda/infrastructure/rim/rim.htm#Act-setId-att setId]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-II II]||[0..1]|| ||
 
|-
 
|-
|[http://cda/rim/rim.htm#Act-versionNumber-att versionNumber]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-ST.SIMPLE ST.SIMPLE]||[0..1]||||
+
|[http://cda/infrastructure/rim/rim.htm#Act-versionNumber-att versionNumber]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-ST ST]||[0..1]|| ||
 
|-
 
|-
|[http://cda/rim/rim.htm#Act-copyTime-att copyTime] ('''Deprecated''')||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TS TS] ||[0..1]||||
+
|[http://cda/infrastructure/rim/rim.htm#Act-copyTime-att copyTime] ('''Deprecated''')||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TS TS] ||[0..1]|| ||
 
|}
 
|}
 +
'''Note*:''' The wire cardinality represents is the effective cardinality of an element, taking into account [[#Recipient Responsibilities|1.3.1 Recipient Responsibilities]], relaxation of the requirement to exchange fixed and defaulted values. The logical cardinality expressed in the CDA Hierarchical Description is still present, but assumed by the recipient, not imposed on the wire format of an instance of a CDA document. 
 +
 +
 +
'''ClinicalDocument.classCode'''
 +
 +
The ClinicalDocument.classCode in the CDA model is fixed to "DOCCLIN". As a result, in the CDA R2.1 Schema, the ClinicalDocument/@classCode has been fixed to "DOCCLIN".
 +
 +
As noted in section [[#Recipient_Responsibilities|1.3.1 Recipient Responsibilities]], fixed and default values asserted in this standard are not required to be present in CDA document instances. However, CDA Implementation Guides can still require them via conformance statements. 
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for ClinicalDocument.classCode  
+
|+Table {{AUTOTABLENUM}}: Fixed ClinicalDocument.classCode  
! style="text-align:left;"  colspan="5" |  v:ActClassClinicalDocument <small>[2.16.840.1.113883.1.11.13948] (CLOSED) </small>
+
!Code!!Display Name
|-
 
!Code!!Print Name!! !!Code!!Print Name
 
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/ActClass.htm#DOCCLIN DOCCLIN] ('''Default''')||clinical document || ||[http://cda/infrastructure/vocabulary/ActClass.htm#CDALVLONE CDALVLONE]||CDA Level One clinical document
+
|[http://cda/infrastructure/vocabulary/ActClass.htm#DOCCLIN DOCCLIN]||clinical document  
 
|-
 
|-
!style="text-align:left;"  colspan="5" | <small> Code System: ActClass (HL7) Code System OID: 2.16.840.1.113883.5.6</small>
+
!style="text-align:left;"  colspan="2" | <small> Code System: ActClass (HL7) Code System OID: 2.16.840.1.113883.5.6</small>
 
|}
 
|}
  
 +
'''ClinicalDocument.moodCode'''
 +
 +
The ClinicalDocument.moodCode in the CDA model is fixed to "EVN" or event mood to indicate that this is documentation of a past service. In the CDA R2.1 Schema, the ClinicalDocument/@moodCode has been fixed to "EVN".
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for ClinicalDocument.moodCode
+
|+Table {{AUTOTABLENUM}}: Fixed ClinicalDocument.moodCode
! style="text-align:left;"  colspan="2" |  v:ActMoodEventOccurrence <small>[2.16.840.1.113883.1.11.20267] (CLOSED) </small>
 
 
|-
 
|-
!Code!!Print Name
+
!Code!!Display Name
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/ActMood.htm#EVN EVN] ('''Fixed''')||event
+
|[http://cda/infrastructure/vocabulary/ActMood.htm#EVN EVN]||event
 
|-
 
|-
 
!style="text-align:left;"  colspan="2" |<small> Code System: ActMood (HL7) Code System OID: 2.16.840.1.113883.5.1001</small>
 
!style="text-align:left;"  colspan="2" |<small> Code System: ActMood (HL7) Code System OID: 2.16.840.1.113883.5.1001</small>
 
|}
 
|}
  
====<big>ClinicalDocument.id</big>====
+
The ClinicalDocument class inherits various attributes from the [http://cda/infrastructure/rim/rim.htm#InfrastructureRoot-cls InfrastructureRoot] class of the RIM, including ClinicalDocument.templateId and ClinicalDocument.typeId which are discussed here. All CDA classes inherit from infrastructureRoot, which is discussed in Section (link here).
 +
 
 +
'''ClinicalDocument.typeId'''
 +
 
 +
ClinicalDocument.typeId is a technology-neutral explicit reference to this CDA, Release Two specification, and must be valued as follows: ClinicalDocument.typeId.root = "2.16.840.1.113883.1.3" (which is the OID for HL7 Registered models); ClinicalDocument.typeId.extension = "POCD_HD000040UV20" (which is the unique identifier for the CDA, Release Two Hierarchical Description).
 +
 
 +
'''ClinicalDocument.templateId'''
 +
 
 +
When a templateId is present in a CDA element, it signals the imposition of a set of template-defined constraints for that element. The templateId is one of the infrastructure attributes added to all CDA classes.  It has only been displayed for ClinicalDocument, but is present in all CDA classes, where it can be used to identify constraints defined in an external Implementation Guide template. See 4.3.2 Template Versioning.
 +
 
 +
'''ClinicalDocument.id'''
  
 
Represents the unique instance identifier of a clinical document.
 
Represents the unique instance identifier of a clinical document.
  
====<big>ClinicalDocument.code</big>====
+
'''ClinicalDocument.code'''
  
 
The code specifying the particular kind of document (e.g. History and Physical, Discharge Summary, Progress Note). The value set is drawn from LOINC, and has a CWE coding strength.
 
The code specifying the particular kind of document (e.g. History and Physical, Discharge Summary, Progress Note). The value set is drawn from LOINC, and has a CWE coding strength.
  
Within the LOINC database, beginning with version 2.09, May 2003, document type codes are those that have a value of "DOC" in the Scale component. This subset of LOINC is included in the appendix (see [[#LOINC_Document_Codes|LOINC Document Codes]]).
+
Within the LOINC database, beginning with version 2.09, May 2003, document type codes are those that have a value of "DOC" in the Scale component. This subset of LOINC is described in the appendix (see [[#LOINC_Document_Codes|LOINC Document Codes]]).
  
:'''NOTE:''' The hierarchical relationship among LOINC document codes is in evolution. Per the LOINC version 2.14 (December 2004) manual: As soon as possible, the component terms used in the creation of the names of document type codes will be mapped to either the UMLS Metathesaurus or SNOMED CT. This mapping will help to establish the meaning of the terms and will allow aggregation and classification of document type codes based on definitions, computable relationships, and subsumption hierarchies that exist in the reference terminology.
+
'''ClinicalDocument.title'''
 
 
====<big>ClinicalDocument.title</big>====
 
  
 
Represents the title of the document. It's commonly the case that clinical documents do not have a title, and are collectively referred to by the display name of ClinicalDocument.code (e.g. a "consultation" or "progress note"). Where these display names are rendered to the clinician, or where the document has a unique title, the ClinicalDocument.title component should be used. In the example document in the appendix (see [[#Sample_Document|Sample Document]]), the value of ClinicalDocument.title = "Good Health Clinic Consultation Note".
 
Represents the title of the document. It's commonly the case that clinical documents do not have a title, and are collectively referred to by the display name of ClinicalDocument.code (e.g. a "consultation" or "progress note"). Where these display names are rendered to the clinician, or where the document has a unique title, the ClinicalDocument.title component should be used. In the example document in the appendix (see [[#Sample_Document|Sample Document]]), the value of ClinicalDocument.title = "Good Health Clinic Consultation Note".
  
====<big>ClinicalDocument.effectiveTime</big>====
+
'''ClinicalDocument.effectiveTime'''
  
Signifies the document creation time, when the document first came into being. Where the CDA document is a transform from an original document in some other format, the ClinicalDocument.effectiveTime is the time the original document is created. The time when the transform occurred is not currently represented in CDA.
+
Signifies the document creation time, when the document first came into being. Where the CDA document is a transform from an original document in some other format, the ClinicalDocument.effectiveTime is the time the original document was created. The time when the transform occurred is not currently represented in CDA.
  
====<big>ClinicalDocument.ConfidentialityCode</big>====
+
'''ClinicalDocument.ConfidentialityCode'''
  
Confidentiality is a required contextual component of CDA, where the value expressed in the header holds true for the entire document, unless overridden by a nested value (as further described in [[#CDA_Context|CDA Context]]).  
+
Confidentiality is a required contextual component of CDA, where the value expressed in the header holds true for the entire document, unless overridden by a nested value (as further described in [[#CDA_Context|CDA Context]]). A best practice for clinical documents is to assert the highest level of confidentiality present within a document at the header level.
  
 
{| class='wikitable'   
 
{| class='wikitable'   
 
|+Table {{AUTOTABLENUM}}: Value set for ClinicalDocument.confidentialityCode
 
|+Table {{AUTOTABLENUM}}: Value set for ClinicalDocument.confidentialityCode
! style="text-align:left;"  colspan="5" |  X_BasicConfidentialityKind <small>[2.16.840.1.113883.1.11.16926] (OPEN) </small>
+
! style="text-align:left;"  colspan="5" |  x_BasicConfidentialityKind <small>[2.16.840.1.113883.1.11.16926] (OPEN) </small>
 
|-
 
|-
!Code !!Print Name!! !!Code !! Print Name
+
!Code !!Display Name!! !!Code !!Display Name
 
|-
 
|-
 
|[http://cda/infrastructure/vocabulary/Confidentiality.htm#N  N]||normal || ||[http://cda/infrastructure/vocabulary/Confidentiality.htm#R  R]||restricted
 
|[http://cda/infrastructure/vocabulary/Confidentiality.htm#N  N]||normal || ||[http://cda/infrastructure/vocabulary/Confidentiality.htm#R  R]||restricted
Line 107: Line 136:
 
<nowiki>*</nowiki> The codeSystem value is included here because confidentialityCode is of type CE, and therefore must carry both a code and a codeSystem.
 
<nowiki>*</nowiki> The codeSystem value is included here because confidentialityCode is of type CE, and therefore must carry both a code and a codeSystem.
  
====<big>ClinicalDocument.languageCode</big>====
+
'''ClinicalDocument.languageCode'''
  
 
Specifies the human language of character data (whether they be in contents or attribute values). The values of the attribute are language identifiers as defined by the IETF (Internet Engineering Task Force) RFC 3066 for the Identification of Languages, ed. H. Alvestrand. 1995, which obsoletes RFC 1766. The HL7 code system for these values is "2.16.840.1.113883.6.121". Language is a contextual component of CDA, where the value expressed in the header holds true for the entire document, unless overridden by a nested value (as further described in [[#CDA_Context|CDA Context]]).
 
Specifies the human language of character data (whether they be in contents or attribute values). The values of the attribute are language identifiers as defined by the IETF (Internet Engineering Task Force) RFC 3066 for the Identification of Languages, ed. H. Alvestrand. 1995, which obsoletes RFC 1766. The HL7 code system for these values is "2.16.840.1.113883.6.121". Language is a contextual component of CDA, where the value expressed in the header holds true for the entire document, unless overridden by a nested value (as further described in [[#CDA_Context|CDA Context]]).
  
====<big>ClinicalDocument.setId</big>====
+
'''ClinicalDocument.setId'''
  
 
Represents an identifier that is common across all document revisions.
 
Represents an identifier that is common across all document revisions.
  
====<big>ClinicalDocument.versionNumber</big>====
+
'''ClinicalDocument.versionNumber'''
  
An integer value used to version successive replacement documents.
+
A string used to represent the version of the document. For CDA R2.1 we use the ST data type as defined in the HL7 Version 3 Standard: XML Implementation Technology Specification - Wire Format Compatible Release 1 Data Types, Release 1 (XML ITS R2B). We have adopted, for all versionNumber references in CDA R2.1, this data type because it supports an @value attribute, and can support wire format compatibility with the versionNumber in CDA R2.0.
  
====<big>ClinicalDocument.copyTime (Deprecated)</big>====
+
'''ClinicalDocument.copyTime (Deprecated)'''
  
 
Represents the time a document is released (i.e. copied or sent to a display device) from a document management system that maintains revision control over the document. Once valued, it cannot be changed. The intent is to give the viewer of the document some notion as to how long the document has been out of the safe context of its document management system.
 
Represents the time a document is released (i.e. copied or sent to a display device) from a document management system that maintains revision control over the document. Once valued, it cannot be changed. The intent is to give the viewer of the document some notion as to how long the document has been out of the safe context of its document management system.
Line 131: Line 160:
 
====<big>authenticator</big>====
 
====<big>authenticator</big>====
  
Represents a participant who has attested to the accuracy of the document, but who does not have privileges to legally authenticate the document. An example would be a resident physician who sees a patient and dictates a note, then later signs it. (See also [[#legalAuthenticator|legalAuthenticator]])
+
[[Image:Authenicator.png|800px|border|center|authenicator]]
  
A clinical document can have zero to many authenticators. While electronic signatures are not captured in a CDA document, both authentication and legal authentication require that a document has been signed manually or electronically by the responsible individual. An authenticator has a required authenticator.time indicating the time of authentication, and a required authenticator.signatureCode, indicating that a signature has been obtained and is on file.  
+
Represents a participant who has attested to the accuracy of the document, but who does not have privileges to legally authenticate the document. An example would be a resident physician who sees a patient and dictates a note, then later signs it. (See also [[#legalAuthenticator|legalAuthenticator]] (&sect; 5.2.2.8))
 +
 
 +
A clinical document can have zero to many authenticators. Both authentication and legal authentication require that a document has been signed manually or electronically by the responsible individual.  
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for authenticator.typeCode
+
|+Table {{AUTOTABLENUM}}: Authenicator
! style="text-align:left;" colspan="2" | v:ParticipationAuthenticator <small>[2.16.840.1.113883.1.11.20065] (CLOSED) </small>
+
!Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Participation-typeCode-att typeCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ParticipationType.htm#AUTHEN AUTHEN]||Fixed
 
|-
 
|-
!Code!!Print Name
+
|[http://cda/infrastructure/rim/rim.htm#Participation-time-att  time]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TS TS] ||[1..1]||||
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/ParticipationType.htm#AUTHEN AUTHEN] ('''Fixed''')||authenticator
+
|[http://cda/infrastructure/rim/rim.htm#Participation-signatureCode-att signatureCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CV CV]||[0..1]||[http://cda/infrastructure/vocabulary/ParticipationSignature.htm S]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Participation-signatureText-att  signatureText]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-ED ED] ||[0..1]||||
 +
|}
 +
 
 +
'''authenticator.typeCode'''
 +
 
 +
The authenticator.typeCode is fixed to "AUTHEN" to indicate that a participant has attested his participation through a signature.
 +
 
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: Fixed authenticator.typeCode
 +
!Code!!Display Name
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ParticipationType.htm#AUTHEN AUTHEN]||authenticator
 
|-
 
|-
 
!style="text-align:left;"  colspan="2" |<small> Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90</small>
 
!style="text-align:left;"  colspan="2" |<small> Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90</small>
 
|}
 
|}
 +
 +
'''authenticator.time'''
 +
 +
Authenticator has a required authenticator.time indicating the time of authentication.
 +
 +
'''authenticator.signatureCode'''
 +
 +
Authenticator has a required authenticator.signatureCode, indicating that a signature has been obtained and is on file.
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for authenticator.signatureCode
+
|+Table {{AUTOTABLENUM}}: Fixed authenticator.signatureCode
! style="text-align:left;"  colspan="5" |  v:ParticipationSignature <small>[2.16.840.1.113883.5.89] (CLOSED) </small>
+
!Code!!Display Name
|-
 
!Code!!Print Name!! !!Code!!Print Name
 
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/ParticipationSignature.htm S] ('''Fixed''')||signed|| ||[http://cda/infrastructure/vocabulary/ParticipationSignature.htm I] ('''Deprecated''')||intended
+
|[http://cda/infrastructure/vocabulary/ParticipationSignature.htm S] ('''Fixed''')||signed
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/ParticipationSignature.htm X] ('''Deprecated''')||required|| ||  ||
+
!style="text-align:left;"  colspan="2" | <small> Code System: ParticipationSignature (HL7) Code System OID: 2.16.840.1.113883.5.89</small>
|-
 
!style="text-align:left;"  colspan="5" | <small> Code System: ParticipationSignature (HL7) Code System OID: 2.16.840.1.113883.5.89</small>
 
 
|}
 
|}
  
 
'''Note''': CDA Release One represented either an intended ("X") or actual ("S") authenticator.  CDA Release 2 and 2.1 only represents an actual authenticator, so usage of "X" and "I" are deprecated.
 
'''Note''': CDA Release One represented either an intended ("X") or actual ("S") authenticator.  CDA Release 2 and 2.1 only represents an actual authenticator, so usage of "X" and "I" are deprecated.
  
An authenticator is a person in the role of an assigned entity (AssignedEntity class). An assigned entity is a person assigned to the role by the scoping organization. The entity playing the role is a person (Person class). The entity scoping the role is an organization (Organization class). (See {{ext|infrastructure/rim/rim.htm#Role-cls|here}} for a description of "player" and "scoper" role associations.)  
+
'''authenticator.signatureText'''
 +
 
 +
A new attribute, SignatureText has been added to authenticator. The signature can be represented either inline or by reference according to the ED data type. Typical cases are:
 +
 
 +
# Paper-based signatures: the ED data type may refer to a document or other resource that can be retrieved through an electronic interface to a hardcopy archive.
 +
# Electronic signature: this attribute can represent virtually any electronic signature scheme.
 +
# Digital signature: this attribute can represent digital signatures by reference to a signature data block that is constructed in accordance to a digital signature standard, such as XML-DSIG, PKCS#7, PGP, etc.
 +
 
 +
<div id="div-AssignedEntity"></div>
 +
=====AssignedEntity=====
 +
 
 +
An authenticator is a person in the role of an assigned entity (AssignedEntity class). An assigned entity is a person assigned to the role by the scoping organization. The entity playing the role is a person (Person class). The entity scoping the role is an organization (Organization class). (See [http://cda/infrastructure/rim/rim.htm#Role-cls here] for a description of "player" and "scoper" role associations.)  
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for AssignedEntity.classCode
+
|+Table {{AUTOTABLENUM}}: AssignedEntity  
! style="text-align:left;"  colspan="5" | v:RoleClassAssignedEntity  <small>[2.16.840.1.113883.1.11.11595] (CLOSED) </small>
+
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 
|-
 
|-
!Code!!Print Name!! !!Code!!Print Name
+
|[http://cda/infrastructure/rim/rim.htm#Role-classCode-att classCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/RoleClass.htm#ASSIGNED ASSIGNED]||Fixed
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/RoleClass.htm#ASSIGNED ASSIGNED ] ('''Default''')||assigned entity ||
+
|[http://cda/infrastructure/rim/rim.htm#Role-id-att  id ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-II II]>||[1..*]|| ||  
||[http://cda/infrastructure/vocabulary/RoleClass.htm#COMPAR COMPAR]||commissioning party
+
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-code-att  code]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CE CE]||[0..1]||[http://cda/infrastructure/vocabulary/voc_ConceptDomains.htm#RoleCode D:RoleCode]|| Open
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/RoleClass.htm#SGNOFF SGNOFF] ||signing authority or officer|| || ||
+
|[http://cda/infrastructure/rim/rim.htm#Role-addr-att  addr ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-AD AD]>||[0..*]|| ||  
 
|-
 
|-
!style="text-align:left;" colspan="5" |<small> Code System: RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110</small>
+
|[http://cda/infrastructure/rim/rim.htm#Role-telecom-att telecom ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TEL TEL]>||[0..*]|| ||
 
|}
 
|}
 +
 +
'''AssignedEntity.classCode'''
 +
 +
The classCode is fixed to "ASSIGNED", which is used in this context to indicate that a person in the employ of an organization was acting as their agent. 
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for Person.classCode
+
|+Table {{AUTOTABLENUM}}: Fixed AssignedEntity.classCode
! style="text-align:left;"  colspan="2" | v:EntityClassPerson <small>[2.16.840.1.113883.1.11.20049] (CLOSED)</small>
+
!Code!!Display Name
|-
 
!Code!!Print Name
 
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/EntityClass.htm#PSN PSN] ('''Fixed''')||person
+
|[http://cda/infrastructure/vocabulary/RoleClass.htm#ASSIGNED ASSIGNED ]||assigned entity
 
|-
 
|-
!style="text-align:left;"  colspan="2" | <small> Code System: EntityClass (HL7) Code System OID: 2.16.840.1.113883.5.41</small>
+
!style="text-align:left;"  colspan="2" |<small> Code System: RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110</small>
 
|}
 
|}
  
 +
'''AssignedEntity.id'''
 +
 +
In this context, it is a unique identifier for the person in this Role.
 +
 +
'''AssignedEntity.code'''
 +
 +
Identifies the specific kind of Role to which an Role-instance belongs. The AssignedEntity.code is bound to D:RoleCode, which enables any code from the HL7 [http://cda/infrastructure/vocabulary/RoleCode.htm RoleCode vocabulary].
 +
 +
'''AssignedEntity.addr'''
 +
 +
A postal address for the Entity while in the Role.
 +
 +
'''AssignedEntity.telecom'''
 +
 +
A telecommunication address for the Entity while in the Role.
 +
 +
=====Person=====
 +
 +
Refer to [[#div-person|Person]] (&sect; 5.2.2.2.2) as defined for Author participation.
 +
 +
<div id="div-organization"></div>
 +
<div id="div-Organization"></div>
 +
 +
=====Organization=====
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for Person.determinerCode
+
|+Table {{AUTOTABLENUM}}: Organization
! style="text-align:left;" colspan="2" | v:EntityDeterminerSpecific <small>[2.16.840.1.113883.1.11.20052] (CLOSED)</small>
+
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Entity-classCode-att classCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/EntityClass.htm#ORG ORG]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Entity-determinerCode-att determinerCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/EntityDeterminer.htm#INSTANCE INSTANCE]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Entity-id-att  id ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-II II]>||[0..*]|| ||
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Entity-name-att  name]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-ON ON]>||[0..1]|| ||
 
|-
 
|-
!Code!!Print Name
+
|[http://cda/infrastructure/rim/rim.htm#Entity-telecom-att  telecom ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TEL TEL]>||[0..*]|| ||
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/EntityDeterminer.htm#INSTANCE INSTANCE] ('''Fixed''')||specific
+
|[http://cda/infrastructure/rim/rim.htm#Organization-addr-att  addr]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-AD AD]>||[0..*]|| ||
 
|-
 
|-
!style="text-align:left;" colspan="2" | <small> Code System: EntityDeterminer (HL7) Code System OID: 2.16.840.1.113883.5.30</small>
+
|[http://cda/infrastructure/rim/rim.htm#Organization-standardIndustryClassCode-att standardIndustryClassCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CE CE]||[0..1]|| [http://cda/infrastructure/vocabulary/voc_ConceptDomains.htm#OrganizationIndustryClass D:OrganizationIndustryClass]
 
|}
 
|}
 +
 +
'''Organization.classCode'''
 +
With the code fixed to "ORG", it indicates we are referencing an Organization.
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for Organization.classCode
+
|+Table {{AUTOTABLENUM}}: Fixed Organization.classCode
! style="text-align:left;"  colspan="5" | v:EntityClassOrganization <small>[2.16.840.1.113883.1.11.10889] (CLOSED)</small>
+
!Code!!Display Name
 
|-
 
|-
!Code!!Print Name!! !!Code!!Print Name
+
|[http://cda/infrastructure/vocabulary/EntityClass.htm#ORG ORG] ||organization
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/EntityClass.htm#ORG ORG] ('''Default''')||organization||
+
!style="text-align:left;"  colspan="2" | <small> Code System: EntityClass (HL7) Code System OID: 2.16.840.1.113883.5.41</small>
||[http://cda/infrastructure/vocabulary/EntityClass.htm#PUB PUB]||public institution
+
|}
 +
 
 +
'''Organization.determinerCode'''
 +
 
 +
The determinerCode is fixed to "INSTANCE", which indicates that the scoping organization referenced, is a specific instance of an organization.
 +
 
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: Fixed Organization.determinerCode
 +
!Code!!Display Name
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/EntityClass.htm#STATE STATE]||state||
+
|[http://cda/infrastructure/vocabulary/EntityDeterminer.htm#INSTANCE INSTANCE]||specific
||[http://cda/infrastructure/vocabulary/EntityClass.htm#NAT NAT]||Nation
 
 
|-
 
|-
!style="text-align:left;"  colspan="5" | <small> Code System: EntityClass (HL7) Code System OID: 2.16.840.1.113883.5.41</small>
+
!style="text-align:left;"  colspan="2" | <small> Code System: EntityDeterminer (HL7) Code System OID: 2.16.840.1.113883.5.30</small>
 
|}
 
|}
 +
 +
'''Organization.id'''
 +
 +
A unique identifier for the Organization.
 +
 +
'''Organization.name'''
 +
 +
A non-unique textual identifier or moniker for the organization.
 +
 +
'''Organization.telecom'''
 +
 +
A telecommunication address for the Organization.
 +
 +
'''Organization.addr'''
 +
 +
The postal or residential address of an organization.
 +
 +
'''Organization.standardIndustryClassCode'''
 +
 +
A code which identifies the industrial category of an organization. In the US Realm, it has been bound to the Code System: North American Industry Classification System  [2.16.840.1.113883.6.85] (NAICS).  The binding type is Open, so other code system and values sets may be used in the US and other realms.  [http://cda/infrastructure/vocabulary/voc_ConceptDomains.htm#OrganizationIndustryClass D:OrganizationIndustryClass]
 +
 +
<div id="div-OrganizationPartOf"></div>
 +
=====OrganizationPartOf=====
 +
 +
A scoping organization can be part of a larger organization. Where there is a need to include whole-part relationships, the OrganizationPartOf role can be used. OrganizationPartOf.statusCode indicates the state of the whole-part relationship (e.g. "active", "terminated").
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for Organization.determinerCode
+
|+Table {{AUTOTABLENUM}}: OrganizationPartOf
! style="text-align:left;"  colspan="2" | v:EntityDeterminerSpecific <small>[2.16.840.1.113883.1.11.20052] (CLOSED)</small>
+
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 
|-
 
|-
!Code!!Print Name
+
|[http://cda/infrastructure/rim/rim.htm#Role-classCode-att classCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/RoleClass.htm#PART PART]||Fixed
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/EntityDeterminer.htm#INSTANCE INSTANCE] ('''Fixed''')||specific
+
|[http://cda/infrastructure/rim/rim.htm#Role-id-att  id ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-II II]>||[1..*]|| ||
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-code-att  code]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CE CE]||[0..1]||[http://cda/infrastructure/vocabulary/voc_ConceptDomains.htm#RoleCode D:RoleCode]|| Open
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-statusCode-att  statusCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/RoleStatus.htm V:RoleStatus]||Closed
 
|-
 
|-
!style="text-align:left;" colspan="2" | <small> Code System: EntityDeterminer (HL7) Code System OID: 2.16.840.1.113883.5.30</small>
+
|[http://cda/infrastructure/rim/rim.htm#Role-effectiveTime-att effectiveTime]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-IVL IVL]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TS TS] >||[0..1]|| ||
 
|}
 
|}
  
A scoping organization can be part of a larger organization. Where there is a need to include whole-part relationships, the OrganizationPartOf role can be used. OrganizationPartOf.statusCode indicates the state of the whole-part relationship (e.g. "active", "terminated"). OrganizationPartOf.effectiveTime is an interval of time specifying the period during which the whole-part relationhship is in effect, if such time limit is applicable and known.  
+
 
 +
'''OrganizationPartOf.classCode'''
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for OrganizationPartOf.classCode
+
|+Table {{AUTOTABLENUM}}: Fixed OrganizationPartOf.classCode
! style="text-align:left;"  colspan="5" |  v:RoleClassPart  <small>[2.16.840.1.113883.1.11.20154] (CLOSED) </small>
+
!Code!!Display Name
|-
 
!Code!!Print Name!! !!Code!!Print Name
 
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/RoleClass.htm#PART PART] ('''Default''')||part||
+
|[http://cda/infrastructure/vocabulary/RoleClass.htm#PART PART]||part
||[http://cda/infrastructure/vocabulary/RoleClass.htm#ACTM ACTM]||active moiety
 
 
|-
 
|-
!style="text-align:left;"  colspan="5" |<small> Code System: RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110</small>
+
!style="text-align:left;"  colspan="2" |<small> Code System: RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110</small>
 
|}
 
|}
 +
 +
'''OrganizationPartOf.id'''
 +
 +
A unique identifier for the player organization in this Role.
 +
 +
'''OrganizationPartOf.code'''
 +
 +
The specific kind of Role to which an Role-instance belongs.
 +
 +
'''OrganizationPartOf.statusCode'''
 +
 +
The state of this Role as defined in the state-transition model.
  
 
{| class='wikitable'   
 
{| class='wikitable'   
 
|+Table {{AUTOTABLENUM}}: Value set for OrganizationPartOf.statusCode
 
|+Table {{AUTOTABLENUM}}: Value set for OrganizationPartOf.statusCode
! style="text-align:left;"  colspan="5" |  v:RoleStatus      <small>[2.16.840.1.113883.5.1068] (CLOSED) </small>
+
! style="text-align:left;"  colspan="5" |  V:RoleStatus      <small>[2.16.840.1.113883.5.1068] (CLOSED) </small>
 
|-
 
|-
!Code!!Print Name!! !!Code!!Print Name
+
!Code!!Display Name!! !!Code!!Display Name
 
|-
 
|-
 
|[http://cda/infrastructure/vocabulary/RoleStatus.htm#normal normal]||normal||
 
|[http://cda/infrastructure/vocabulary/RoleStatus.htm#normal normal]||normal||
Line 259: Line 404:
 
!style="text-align:left;"  colspan="5" |<small> Code System: RoleStatus (HL7) Code System OID: 2.16.840.1.113883.5.1068</small>
 
!style="text-align:left;"  colspan="5" |<small> Code System: RoleStatus (HL7) Code System OID: 2.16.840.1.113883.5.1068</small>
 
|}
 
|}
 +
 +
'''OrganizationPartOf.effectiveTime'''
 +
 +
The OrganizationPartOf.effectiveTime is an interval of time specifying the period during which the whole-part relationhship is in effect, if such time limit is applicable and known.
  
 
====<big>author</big>====
 
====<big>author</big>====
 +
 +
[[Image:Author.png|800px|border|center|author]]
  
 
Represents the humans and/or machines that authored the document.  
 
Represents the humans and/or machines that authored the document.  
  
In some cases, the role or function of the author is inherent in the ClinicalDocument.code, such as where ClinicalDocument.code is "Medical Student Progress Note". The role of the author can also be recorded in the Author.functionCode or AssignedAuthor.code attribute. If either of these attributes is included, they should be equivalent to or further specialize the role inherent in the ClinicalDocument.code (such as where the ClinicalDocument.code is simply "Physician Progress Note" and the value of Author.functionCode is "rounding physician"), and shall not conflict with the role inherent in the ClinicalDocument.code, as such a conflict would constitute an ambiguous situation.  
+
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: author
 +
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Participation-typeCode-att  typeCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ParticipationType.htm#AUT AUT]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Participation-functionCode-att  functionCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CE CE]||[0..1]||[http://cda/infrastructure/vocabulary/voc_ConceptDomains.htm#ParticipationFunction D:ParticipationFunction]|| Open
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Participation-contextControlCode-att contextControlCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ContextControl.htm#_ContextControlPropagating OP]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Participation-time-att time]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TS TS] ||[1..1]||||
 +
|}
 +
 
 +
'''author.typeCode'''
 +
 
 +
The author.typeCode is fixed to "AUT", used to indicate the party that originates the document and is responsible for the information in the document.
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for author.typeCode
+
|+Table {{AUTOTABLENUM}}: Fixed author.typeCode
! style="text-align:left;"  colspan="2" |  v:ParticipationAuthorOriginator <small>[2.16.840.1.113883.1.11.20064] (CLOSED) </small>
+
!Code!!Display Name
|-
 
!Code!!Print Name
 
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/ParticipationType.htm#AUT AUT] ('''Fixed''')||author
+
|[http://cda/infrastructure/vocabulary/ParticipationType.htm#AUT AUT]||author
 
|-
 
|-
 
!style="text-align:left;"  colspan="2" |<small> Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90</small>
 
!style="text-align:left;"  colspan="2" |<small> Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90</small>
 
|}
 
|}
 +
 +
'''author.functionCode'''
 +
 +
 +
The author.functionCode is bound to the concept domain ParticipationFunction, which is used to specify the exact function an actor had in a service in all necessary detail. This domain may include local extensions (Open).
 +
 +
In some cases, the role or function of the author is inherent in the ClinicalDocument.code, such as where ClinicalDocument.code is "Medical Student Progress Note". The role of the author can also be recorded in the Author.functionCode or AssignedAuthor.code attribute. If either of these attributes is included, they should be equivalent to or further specialize the role inherent in the ClinicalDocument.code (such as where the ClinicalDocument.code is simply "Physician Progress Note" and the value of Author.functionCode is "rounding physician"), and shall not conflict with the role inherent in the ClinicalDocument.code, as such a conflict would constitute an ambiguous situation.
 +
 +
'''author.contextControlCode'''
 +
 +
The author.contextControlCode is fixed to "OP". It means that the author will replace the set of author participations that have propagated from ancestor Acts, and will itself be the only author to propagate to any child Acts that allow context to be propagated. 
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for author.contextControlCode
+
|+Table {{AUTOTABLENUM}}: Fixed author.contextControlCode
! style="text-align:left;"  colspan="2" |  v:ContextControlOverridingPropagating <small>[2.16.840.1.113883.1.11.20034] (CLOSED) </small>
+
!Code!!Display Name
|-
 
!Code!!Print Name
 
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/ContextControl.htm#OP OP] ('''Fixed''')||overriding, propagating
+
|[http://cda/infrastructure/vocabulary/ContextControl.htm#_ContextControlPropagating OP]||overriding, propagating
 
|-
 
|-
 
!style="text-align:left;"  colspan="2" |<small> Code System: ContextControl (HL7) Code System OID: 2.16.840.1.113883.5.1057</small>
 
!style="text-align:left;"  colspan="2" |<small> Code System: ContextControl (HL7) Code System OID: 2.16.840.1.113883.5.1057</small>
 
|}
 
|}
 +
 +
'''author.time'''
 +
 +
The author.time is used to capture the time this specific author contributed content to the document.
 +
 +
=====AssignedAuthor=====
  
 
An author is a person in the role of an assigned author (AssignedAuthor class). The entity playing the role is a person (Person class) or a device (AuthoringDevice class). The entity scoping the role is an organization (Organization class), and is the organization from which the document originates.  
 
An author is a person in the role of an assigned author (AssignedAuthor class). The entity playing the role is a person (Person class) or a device (AuthoringDevice class). The entity scoping the role is an organization (Organization class), and is the organization from which the document originates.  
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for AssignedAuthor.classCode
+
|+Table {{AUTOTABLENUM}}: AssignedAuthor  
! style="text-align:left;" colspan="5" | v:RoleClassAssignedEntity  <small>[2.16.840.1.113883.1.11.11595] (CLOSED) </small>
+
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-classCode-att classCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/RoleClass.htm#ASSIGNED ASSIGNED]||Fixed
 
|-
 
|-
!Code!!Print Name!! !!Code!!Print Name
+
|[http://cda/infrastructure/rim/rim.htm#Role-id-att  id ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-II II]>||[1..*]|| ||
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/RoleClass.htm#ASSIGNED ASSIGNED ] ('''Default''')||assigned entity ||
+
|[http://cda/infrastructure/rim/rim.htm#Role-code-att  code ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CE CE]||[0..1]||[http://cda/infrastructure/vocabulary/voc_ConceptDomains.htm#RoleCode D:RoleCode]|| Open
||[http://cda/infrastructure/vocabulary/RoleClass.htm#COMPAR COMPAR]||commissioning party
+
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-addr-att  addr ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-AD AD]>||[0..*]|| ||  
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-telecom-att  telecom ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TEL TEL]>||[0..*]|| ||
 +
|}
 +
 +
'''AssignedAuthor.classCode'''
 +
 
 +
The classCode is fixed to "ASSIGNED", which is used in this context to indicate that a person in the employ of an organization was acting as their agent. 
 +
 
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: Fixed AssignedAuthor.classCode
 +
!Code!!Display Name
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/RoleClass.htm#SGNOFF SGNOFF] ||signing authority or officer|| || ||
+
|[http://cda/infrastructure/vocabulary/RoleClass.htm#ASSIGNED ASSIGNED ]||assigned entity
 
|-
 
|-
 
!style="text-align:left;"  colspan="5" |<small> Code System: RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110</small>
 
!style="text-align:left;"  colspan="5" |<small> Code System: RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110</small>
 
|}
 
|}
  
 +
'''AssignedAuthor.id'''
 +
 +
In this context, it is a unique identifier for the person in this Role.
 +
 +
'''AssignedAuthor.code'''
 +
 +
Identifies the specific kind of Role to which an Role-instance belongs. The AssignedEntity.code is bound to D:RoleCode, which enables any code from the HL7 [http://cda/infrastructure/vocabulary/RoleCode.htm RoleCode vocabulary].
 +
 +
'''AssignedAuthor.addr'''
 +
 +
A postal address for the Entity while in the Role.
 +
 +
'''AssignedAuthor.telecom'''
 +
 +
A telecommunication address for the Entity while in the Role.
 +
 +
<div id='div-person'></div>
 +
 +
=====Person @a@=====
 +
 +
A human being.
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for AuthoringDevice.classCode 
+
|+Table {{AUTOTABLENUM}}: Person
! style="text-align:left;" colspan="5" | V:EntityClassDevice <small>[2.16.840.1.113883.1.11.11623] (CLOSED) </small>
+
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
|-
+
|-
!Code!!Print Name!! !!Code!!Print Name
+
|[http://cda/infrastructure/rim/rim.htm#Entity-classCode-att classCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/EntityClass.htm#PSN PSN]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Entity-determinerCode-att determinerCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/EntityDeterminer.htm#INSTANCE  INSTANCE]||Fixed
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/EntityClass.htm#DEV DEV] ('''Default''')||role||
+
|[http://cda/infrastructure/rim/rim.htm#Entity-name-att  name]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-PN PN]>||[0..*]|| ||
||[http://cda/infrastructure/vocabulary/EntityClass.htm#CER CER]||certificate representation
 
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/EntityClass.htm#MODDV MODDV]||imaging modality, ImagingModalityEntity||
+
|[http://cda/infrastructure/rim/rim.htm#Entity-desc-att  desc ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-ED ED]||[0..1]|| ||  
|| ||
 
 
|-
 
|-
!style="text-align:left;"  colspan="5" | <small> Code System: EntityClass (HL7) Code System OID: 2.16.840.1.113883.5.41</small>
+
|[http://cda/infrastructure/rim/rim.htm#LivingSubject-birthTime-att birthTime]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TS TS]||[0..1]|| ||
 
|}
 
|}
 +
 +
'''Person.classCode'''
 +
 +
With the code fixed to "PSN", it indicates we are referencing a Person.
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for AuthoringDevice.determinerCode
+
|+Table {{AUTOTABLENUM}}: Fixed Person.classCode
! style="text-align:left;"  colspan="2" | v:EntityDeterminerSpecific <small>[2.16.840.1.113883.1.11.20052] (CLOSED)</small>
+
!Code!!Display Name
 +
|-
 +
|[http://cda/infrastructure/vocabulary/EntityClass.htm#PSN PSN]||person
 
|-
 
|-
!Code!!Print Name
+
!style="text-align:left;"  colspan="2" | <small> Code System:  EntityClass (HL7) Code System OID: 2.16.840.1.113883.5.41</small>
 +
|}
 +
 
 +
'''Person.determinerCode'''
 +
 
 +
The determinerCode is fixed to "INSTANCE", which indicates that we are dealing with a specific person.
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: Fixed Person.determinerCode
 +
!Code!!Display Name
 
|-
 
|-
 
|[http://cda/infrastructure/vocabulary/EntityDeterminer.htm#INSTANCE INSTANCE] ('''Fixed''')||specific
 
|[http://cda/infrastructure/vocabulary/EntityDeterminer.htm#INSTANCE INSTANCE] ('''Fixed''')||specific
Line 329: Line 557:
 
!style="text-align:left;"  colspan="2" | <small> Code System:  EntityDeterminer (HL7) Code System OID: 2.16.840.1.113883.5.30</small>
 
!style="text-align:left;"  colspan="2" | <small> Code System:  EntityDeterminer (HL7) Code System OID: 2.16.840.1.113883.5.30</small>
 
|}
 
|}
 +
 +
'''Person.name'''
 +
 +
The person's name.
 +
 +
Note: The person name data type "PN" supports current, and historical names using validTime, and the specification of different use codes can indicate legal name, tribal name, stage name and others.
 +
 +
'''Person.desc'''
 +
 +
A textual or multimedia depiction of the person.
 +
 +
'''Person.birthTime'''
 +
 +
The date and time of a person's birth.
 +
 +
=====AuthoringDevice=====
 +
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: AuthoringDevice
 +
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Entity-classCode-att classCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/EntityClass.htm#DEV DEV]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Entity-determinerCode-att determinerCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/EntityDeterminer.htm#INSTANCE  INSTANCE]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Entity-code-att  code]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CE CE]||[0..1]||[http://cda/infrastructure/vocabulary/voc_ConceptDomains.htm#EntityCode D:EntityCode] ||
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Device-manufacturerModelName-att  manufacturerModelName ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SC SC]||[0..1]||[http://cda/infrastructure/vocabulary/voc_ConceptDomains.htm#ManufacturerModelName  D:ManufacturerModelName ] ||
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Device-softwareName-desc-att  softwareName ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SC SC]||[0..1]||[http://cda/infrastructure/vocabulary/voc_ConceptDomains.htm#SoftwareName  D:SoftwareName ] ||
 +
|}
 +
 +
'''AuthoringDevice.classCode'''
 +
 +
The AuthoringDevice.classCode is fixed to "DEV" indicating that a device was used to generate content in the document.
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: Fixed AuthoringDevice.classCode 
 +
!Code!!Display Name
 +
|-
 +
|[http://cda/infrastructure/vocabulary/EntityClass.htm#DEV DEV]||role
 +
|-
 +
!style="text-align:left;"  colspan="5" | <small> Code System: EntityClass (HL7) Code System OID: 2.16.840.1.113883.5.41</small>
 +
|}
 +
 +
'''AuthoringDevice.determinerCode'''
 +
 +
The determinerCode is fixed to "INSTANCE", which indicates we are referencing a specific device.
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: Fixed AuthoringDevice.determinerCode
 +
!Code!!Display Name
 +
|-
 +
|[http://cda/infrastructure/vocabulary/EntityDeterminer.htm#INSTANCE INSTANCE]||specific
 +
|-
 +
!style="text-align:left;"  colspan="2" | <small> Code System:  EntityDeterminer (HL7) Code System OID: 2.16.840.1.113883.5.30</small>
 +
|}
 +
 +
'''AuthoringDevice.code'''
 +
 +
The AuthoringDevice.code is bound to the EntityCode domain. 
 +
 +
'''AuthoringDevice.manufacturerModelName'''
 +
 +
Is used to convey a coded name for the device.
 +
 +
'''AuthoringDevice.softwareName'''
 +
 +
Is used to convey a coded name for the software used to author content.
 +
 +
=====MaintainedEntity (Deprecated)=====
  
 
:'''NOTE:''' In CDA, Release One, it was possible to specify those individuals responsible for the device. This functionality has been deprecated in CDA, Release Two. The MaintainedEntity class is present for backwards compatibility, and its use is discouraged, except where needed to support the transformation of CDA, Release One documents.  
 
:'''NOTE:''' In CDA, Release One, it was possible to specify those individuals responsible for the device. This functionality has been deprecated in CDA, Release Two. The MaintainedEntity class is present for backwards compatibility, and its use is discouraged, except where needed to support the transformation of CDA, Release One documents.  
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for MaintainedEntity.classCode
+
|+Table {{AUTOTABLENUM}}: MaintainedEntity
! style="text-align:left;" colspan="2" | v:RoleClassMaintainedEntity  <small>[2.16.840.1.113883.1.11.20147] (CLOSED)</small>
+
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-classCode-att classCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/RoleClass.htm#MNT MNT]||Fixed
 
|-
 
|-
!Code!!Print Name
+
|[http://cda/infrastructure/rim/rim.htm#Role-effectiveTime-att effectiveTime]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-IVL IVL]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TS TS]>||[0..1]|| ||
 +
|}
 +
 
 +
'''MaintainedEntity.classCode'''
 +
 
 +
With the classCode fixed to "MNT", it indicates that AuthoringDevice is maintained by person assuming responsibility for proper operation, quality, and safety.
 +
 
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: Fixed MaintainedEntity.classCode
 +
!Code!!Display Name
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/RoleClass.htm#MNT MNT] ('''Fixed''')||maintained entity
+
|[http://cda/infrastructure/vocabulary/RoleClass.htm#MNT MNT]||maintained entity
 
|-
 
|-
 
!style="text-align:left;"  colspan="2" | <small> Code System:  RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110</small>
 
!style="text-align:left;"  colspan="2" | <small> Code System:  RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110</small>
 
|}
 
|}
 +
 +
'''MaintainedEntity.effectiveTime'''
 +
 +
An interval of time specifying the period during which the Role is in effect.
  
 
====<big>custodian</big>====
 
====<big>custodian</big>====
 +
 +
[[Image:Custodian.png|800px|border|center|custodian]]
  
 
Represents the organization that is in charge of maintaining the document. The custodian is the steward that is entrusted with the care of the document. Every CDA document has exactly one custodian.  
 
Represents the organization that is in charge of maintaining the document. The custodian is the steward that is entrusted with the care of the document. Every CDA document has exactly one custodian.  
  
The custodian participation satisfies the CDA definition of Stewardship (see [[#What_is_the_CDA|What is the CDA]]). Because CDA is an exchange standard and may not represent the original form of the authenticated document, the custodian represents the steward of the original source document.  
+
The custodian participation satisfies the CDA definition of Stewardship (see [[#What_is_the_CDA|What is the CDA]] (&sect; 1.1)). Because CDA is an exchange standard and may not represent the original form of the authenticated document, the custodian represents the steward of the original source document.  
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for custodian.typeCode
+
|+Table {{AUTOTABLENUM}}: custodian  
! style="text-align:left;"  colspan="2" | v:ParticipationCustodian <small>[2.16.840.1.113883.1.11.20073] (CLOSED) </small>
+
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 
|-
 
|-
!Code!!Print Name
+
|[http://cda/infrastructure/rim/rim.htm#Participation-typeCode-att  typeCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ParticipationType.htm#CST CST]||Fixed
 +
|}
 +
 
 +
'''custodian.typeCode'''
 +
 
 +
The custodian.typeCode is fixed to "CST", which indicates in this instance an organization that is in charge of maintaining this document. Examples: Medical Records Dept in hospital, Health Information Management Dept., etc. 
 +
 
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}:Fixed custodian.typeCode
 +
!Code!!Display Name
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/ParticipationType.htm#CST CST] ('''Fixed''')||custodian
+
|[http://cda/infrastructure/vocabulary/ParticipationType.htm#CST CST]||custodian
 
|-
 
|-
 
!style="text-align:left;"  colspan="2" |<small> Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90</small>
 
!style="text-align:left;"  colspan="2" |<small> Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90</small>
Line 361: Line 684:
  
 
A custodian is a scoping organization in the role of an assigned custodian (AssignedCustodian class). The steward organization (CustodianOrganization class) is an entity scoping the role of AssignedCustodian, and has a required CustodianOrganization.id.  
 
A custodian is a scoping organization in the role of an assigned custodian (AssignedCustodian class). The steward organization (CustodianOrganization class) is an entity scoping the role of AssignedCustodian, and has a required CustodianOrganization.id.  
 +
 +
=====AssignedCustodian=====
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for AssignedCustodian.classCode
+
|+Table {{AUTOTABLENUM}}: AssignedCustodian
! style="text-align:left;"  colspan="5" | v:RoleClassAssignedEntity  <small>[2.16.840.1.113883.1.11.11595] (CLOSED) </small>
+
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 
|-
 
|-
!Code!!Print Name!! !!Code!!Print Name
+
|[http://cda/infrastructure/rim/rim.htm#Role-classCode-att classCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/RoleClass.htm#ASSIGNED ASSIGNED]||Fixed
|-
+
|}
|[http://cda/infrastructure/vocabulary/RoleClass.htm#ASSIGNED ASSIGNED ] ('''Default''')||assigned entity ||
+
 
||[http://cda/infrastructure/vocabulary/RoleClass.htm#COMPAR COMPAR]||commissioning party
+
'''AssignedCustodian.classCode
 +
 
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: Fixed AssignedCustodian.classCode
 +
!Code!!Display Name
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/RoleClass.htm#SGNOFF SGNOFF] ||signing authority or officer|| || ||
+
|[http://cda/infrastructure/vocabulary/RoleClass.htm#ASSIGNED ASSIGNED ]||assigned entity
 
|-
 
|-
!style="text-align:left;"  colspan="5" |<small> Code System: RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110</small>
+
!style="text-align:left;"  colspan="2" |<small> Code System: RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110</small>
 
|}
 
|}
 +
 +
=====CustodianOrganization=====
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for CustodianOrganization.classCode
+
|+Table {{AUTOTABLENUM}}: CustodianOrganization
! style="text-align:left;"  colspan="5" | v:EntityClassOrganization <small>[2.16.840.1.113883.1.11.10889] (CLOSED)</small>
+
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 
|-
 
|-
!Code!!Print Name!! !!Code!!Print Name
+
|[http://cda/infrastructure/rim/rim.htm#Entity-classCode-att classCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/EntityClass.htm#ORG ORG]||Fixed
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/EntityClass.htm#ORG ORG] ('''Default''')||organization||
+
|[http://cda/infrastructure/rim/rim.htm#Entity-determinerCode-att determinerCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/EntityDeterminer.htm#INSTANCE INSTANCE]||Fixed
||[http://cda/infrastructure/vocabulary/EntityClass.htm#PUB PUB]||public institution
 
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/EntityClass.htm#STATE STATE]||state||
+
|[http://cda/infrastructure/rim/rim.htm#Entity-id-att  id ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-II II]>||[1..*]|| ||  
||[http://cda/infrastructure/vocabulary/EntityClass.htm#NAT NAT]||Nation
 
 
|-
 
|-
!style="text-align:left;" colspan="5" | <small> Code System: EntityClass (HL7) Code System OID: 2.16.840.1.113883.5.41</small>
+
|[http://cda/infrastructure/rim/rim.htm#Entity-name-att name]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-ON ON]>||[0..1]|| ||
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Entity-telecom-att  telecom ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TEL TEL]>||[0..*]|| ||
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Organization-addr-att  addr]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-AD AD]>||[0..*]|| ||
 
|}
 
|}
 +
 +
'''CustodianOrganization.classCode'''
 +
With the code fixed to "ORG", it indicates we are referencing an Organization.
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for CustodianOrganization.determinerCode
+
|+Table {{AUTOTABLENUM}}: Fixed CustodianOrganization.classCode
! style="text-align:left;"  colspan="2" | v:EntityDeterminerSpecific <small>[2.16.840.1.113883.1.11.20052] (CLOSED)</small>
+
!Code!!Display Name
 +
|-
 +
|[http://cda/infrastructure/vocabulary/EntityClass.htm#ORG ORG] ||organization
 
|-
 
|-
!Code!!Print Name
+
!style="text-align:left;"  colspan="2" | <small> Code System: EntityClass (HL7) Code System OID: 2.16.840.1.113883.5.41</small>
 +
|}
 +
 
 +
'''CustodianOrganization.determinerCode'''
 +
 
 +
The determinerCode is fixed to "INSTANCE", which indicates that the scoping organization referenced, is a specific instance of an organization.
 +
 
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: Fixed CustodianOrganization.determinerCode
 +
!Code!!Display Name
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/EntityDeterminer.htm#INSTANCE INSTANCE] ('''Fixed''')||specific
+
|[http://cda/infrastructure/vocabulary/EntityDeterminer.htm#INSTANCE INSTANCE]||specific
 
|-
 
|-
 
!style="text-align:left;"  colspan="2" | <small> Code System:  EntityDeterminer (HL7) Code System OID: 2.16.840.1.113883.5.30</small>
 
!style="text-align:left;"  colspan="2" | <small> Code System:  EntityDeterminer (HL7) Code System OID: 2.16.840.1.113883.5.30</small>
 
|}
 
|}
 +
 +
'''CustodianOrganization.id'''
 +
 +
A unique identifier for the Organization.
 +
 +
'''CustodianOrganization.name'''
 +
 +
A non-unique textual identifier or moniker for the organization.
 +
 +
'''CustodianOrganization.telecom'''
 +
 +
A telecommunication address for the Organization.
 +
 +
'''CustodianOrganization.addr'''
 +
 +
The postal or residential address of an organization.
  
 
====<big>dataEnterer (Transcriptionist)</big>====
 
====<big>dataEnterer (Transcriptionist)</big>====
 +
 +
[[Image:DataEnterer.png|600px|border|center|dataEnterer ]]
  
 
Represents the participant who has transformed a dictated note into text.
 
Represents the participant who has transformed a dictated note into text.
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for dataEnterer.typeCode
+
|+Table {{AUTOTABLENUM}}: dataEnterer  
! style="text-align:left;"  colspan="2" | v:ParticipationDataEntryPerson <small>[2.16.840.1.113883.1.11.20079] (CLOSED) </small>
+
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 
|-
 
|-
!Code!!Print Name
+
|[http://cda/infrastructure/rim/rim.htm#Participation-typeCode-att  typeCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ParticipationType.htm#ENT ENT]||Fixed
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/ParticipationType.htm#ENT ENT] ('''Fixed''')||data entry person
+
|[http://cda/infrastructure/rim/rim.htm#Participation-contextControlCode-att contextControlCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ContextControl.htm#_ContextControlPropagating OP]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Participation-time-att time]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TS TS] ||[1..1]||||
 +
|}
 +
 
 +
'''dataEnterer.typeCode'''
 +
 
 +
The dataEnterer.typeCode is fixed to "ENT".
 +
 
 +
{| class='wikitable'
 +
|+Table {{AUTOTABLENUM}}: Fixed dataEnterer.typeCode
 +
!Code!!Display Name
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ParticipationType.htm#ENT ENT]||data entry person
 
|-
 
|-
 
!style="text-align:left;"  colspan="2" |<small> Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90</small>
 
!style="text-align:left;"  colspan="2" |<small> Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90</small>
 
|}
 
|}
  
 +
'''dataEnterer.contextControlCode'''
 +
 +
The dataEnterer.contextControlCode is fixed to "OP".
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for dataEnterer.contextControlCode
+
|+Table {{AUTOTABLENUM}}: Fixed dataEnterer.contextControlCode
! style="text-align:left;"  colspan="2" |  v:ContextControlOverridingPropagating <small>[2.16.840.1.113883.1.11.20034] (CLOSED) </small>
+
!Code!!Display Name
 
|-
 
|-
!Code!!Print Name
+
|[http://cda/infrastructure/vocabulary/ContextControl.htm#_ContextControlPropagating OP]||overriding, propagating
|-
 
|[http://cda/infrastructure/vocabulary/ContextControl.htm#OP OP] ('''Fixed''')||overriding, propagating
 
 
|-
 
|-
 
!style="text-align:left;"  colspan="2" |<small> Code System: ContextControl (HL7) Code System OID: 2.16.840.1.113883.5.1057</small>
 
!style="text-align:left;"  colspan="2" |<small> Code System: ContextControl (HL7) Code System OID: 2.16.840.1.113883.5.1057</small>
 
|}
 
|}
 +
 +
'''dataEnterer.time'''
 +
 +
The date and time the data was entered into the originating system.
 +
 +
=====AssignedEntity @a@=====
 +
 +
Refer to [[#div-AssignedEntity|AssignedEntity]] (&sect; 5.2.2.1.1) as defined for authenticator participation.
  
 
====<big>encounterParticipant</big>====
 
====<big>encounterParticipant</big>====
  
See [[#EncompassingEncounter|EncompassingEncounter]] for a description of the encounterParticipant participant.
+
See [[#EncompassingEncounter|EncompassingEncounter]] (&sect; 5.2.3.5) for a description of the encounterParticipant participant.
  
 
====<big>informant</big>====
 
====<big>informant</big>====
 +
 +
[[Image:Informant.png|600px|border|center|informant]]
  
 
An informant (or source of information) is a person that provides relevant information, such as the parent of a comatose patient who describes the patient's behavior prior to the onset of coma.  
 
An informant (or source of information) is a person that provides relevant information, such as the parent of a comatose patient who describes the patient's behavior prior to the onset of coma.  
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for informant.typeCode
+
|+Table {{AUTOTABLENUM}}: informant
! style="text-align:left;"  colspan="2" | v:ParticipationInformant <small>[2.16.840.1.113883.1.11.20086] (CLOSED) </small>
+
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Participation-typeCode-att typeCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ParticipationType.htm#INF INF]||Fixed
 
|-
 
|-
!Code!!Print Name
+
|[http://cda/infrastructure/rim/rim.htm#Participation-contextControlCode-att contextControlCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ContextControl.htm#_ContextControlPropagating OP]||Fixed
 +
|}
 +
 
 +
'''informant.typeCode'''
 +
The informant.typeCode is fixed to "INF", which indicates the source of reported information (e.g., a next of kin who answers questions about the patient's history).
 +
 
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: Fixed informant.typeCode
 +
!Code!!Display Name
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/ParticipationType.htm#INF INF] ('''Fixed''')||informant
+
|[http://cda/infrastructure/vocabulary/ParticipationType.htm#INF INF]||informant
 
|-
 
|-
 
!style="text-align:left;"  colspan="2" |<small> Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90</small>
 
!style="text-align:left;"  colspan="2" |<small> Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90</small>
 
|}
 
|}
 +
 +
'''informant.contextControlCode'''
 +
 +
The informant.contextControlCode is fixed to "OP". It means that the informant will replace the set of informant participations that have propagated from ancestor Acts, and will itself be the only informant to propagate to any child Acts that allow context to be propagated. 
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for informant.contextControlCode
+
|+Table {{AUTOTABLENUM}}: Fixed informant.contextControlCode
! style="text-align:left;"  colspan="2" |  v:ContextControlOverridingPropagating <small>[2.16.840.1.113883.1.11.20034] (CLOSED) </small>
+
!Code!!Display Name
 
|-
 
|-
!Code!!Print Name
+
|[http://cda/infrastructure/vocabulary/ContextControl.htm#_ContextControlPropagating OP]||overriding, propagating
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/ContextControl.htm#OP OP] ('''Fixed''')||overriding, propagating
+
!style="text-align:left;"  colspan="2" |<small> Code System: ContextControl (HL7) Code System OID: 2.16.840.1.113883.5.1057</small>
 +
|}
 +
 
 +
An informant can be a person in one of two roles RelatedEntity or AssignedEntity.
 +
=====RelatedEntity=====
 +
 
 +
The RelatedEntity role is used to represent an informant without a role.id (e.g. a parent or guy on the street). The informant in this case bears some formal or personal relationship to the patient. The role is unscoped, with the assumption that the patient is always the implied scoper. RelatedEntity.code can be used to specify the nature of the relationship.
 +
 
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: RelatedEntity
 +
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-classCode-att classCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/RoleClass.htm#_RoleClassMutualRelationship v:RoleClassMutualRelationship]||Closed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-code-att  code]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CE CE]||[0..1]||[http://cda/infrastructure/vocabulary/voc_ConceptDomains.htm#PersonalRelationshipRoleType D:PersonalRelationshipRoleType ]|| Open
 
|-
 
|-
!style="text-align:left;" colspan="2" |<small> Code System: ContextControl (HL7) Code System OID: 2.16.840.1.113883.5.1057</small>
+
|[http://cda/infrastructure/rim/rim.htm#Role-addr-att addr ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-AD AD]>||[0..*]|| ||
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-telecom-att  telecom ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TEL TEL]>||[0..*]|| ||
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-effectiveTime-att effectiveTime]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-IVL IVL]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TS TS]>||[0..1]|| ||
 
|}
 
|}
  
An informant can be a person in one of two roles. The RelatedEntity role is used to represent an informant without a role.id (e.g. a parent or guy on the street). The informant in this case bears some formal or personal relationship to the patient. The role is unscoped, with the assumption that the patient is always the implied scoper. RelatedEntity.code can be used to specify the nature of the relationship. The AssignedEntity role is used for an identified informant, and is scoped by an Organization.
+
'''RelatedEntity.classCode'''
  
 
{| class='wikitable'   
 
{| class='wikitable'   
Line 464: Line 885:
 
! style="text-align:left;"  colspan="5" |  v:RoleClassMutualRelationship  <small>[2.16.840.1.113883.1.11.19316] (CLOSED) </small>
 
! style="text-align:left;"  colspan="5" |  v:RoleClassMutualRelationship  <small>[2.16.840.1.113883.1.11.19316] (CLOSED) </small>
 
|-
 
|-
!Code!!Print Name!! !!Code!!Print Name
+
!Code!!Display Name!! !!Code!!Display Name
 
|-
 
|-
 
|[http://cda/infrastructure/vocabulary/RoleClass.htm#AFFL AFFL] ||affiliate||
 
|[http://cda/infrastructure/vocabulary/RoleClass.htm#AFFL AFFL] ||affiliate||
Line 525: Line 946:
 
!style="text-align:left;"  colspan="5" |<small> Code System: RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110</small>
 
!style="text-align:left;"  colspan="5" |<small> Code System: RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110</small>
 
|}
 
|}
 +
 +
'''RelatedEntity.code'''
 +
 +
The RelatedEntity.code is bound to the PersonalRelationshipRoleType concept domain.
 +
 +
'''RelatedEntity.addr'''
 +
 +
The RelatedEntity.addr is used to convey the postal address for the informant.
 +
 +
'''RelatedEntity.telecom'''
 +
 +
The RelatedEntity.telecom is used to convey the phone number for the informant.
 +
 +
'''RelatedEntity.effectiveTime'''
 +
 +
The RelatedEntity.effectiveTime is used to convey the time period that the role is/was in effect.
 +
 +
=====AssignedEntity @b@=====
 +
 +
The AssignedEntity role is used for an identified informant, and is scoped by an Organization.
 +
 +
Refer to [[#div-AssignedEntity|AssignedEntity]] (&sect; 5.2.2.1.1) as defined for authenticator participation.
  
 
====<big>informationRecipient</big>====
 
====<big>informationRecipient</big>====
 +
 +
 +
[[Image:InformationRecipient.png|600px|border|center|informationRecipient]]
 +
 +
 
Represents a recipient who should receive a copy of the document.
 
Represents a recipient who should receive a copy of the document.
  
:'''NOTE:''' The information recipient is an entity to whom a copy of a document is directed, at the time of document authorship. It is not the same as the cumulative set of persons to whom the document has subsequently been disclosed, over the life-time of the patient. Such a disclosure list would not be contained within the document, and it outside the scope of CDA.  
+
:'''NOTE:''' The information recipient is an entity to whom a copy of a document is directed, at the time of document authorship. It is not the same as the cumulative set of persons to whom the document has subsequently been disclosed, over the life-time of the patient. Such a disclosure list would not be contained within the document, and it is outside the scope of CDA.
 +
 
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: informationRecipient
 +
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Participation-typeCode-att  typeCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[1..1]||[http://cda/infrastructure/vocabulary/vs_ParticipationType.htm#x_InformationRecipient  V:x_InformationRecipient]||Closed
 +
|}
 +
 
 +
 
 +
'''informationRecipient.typeCode'''
 +
 
 +
Two values are available for the informationRecipient.typeCode, the default value is primary information recipient an alternative value is tracker.
  
 
{| class='wikitable'   
 
{| class='wikitable'   
Line 535: Line 995:
 
! style="text-align:left;"  colspan="5" |  v:x_InformationRecipient <small>[2.16.840.1.113883.1.11.19366] (CLOSED) </small>
 
! style="text-align:left;"  colspan="5" |  v:x_InformationRecipient <small>[2.16.840.1.113883.1.11.19366] (CLOSED) </small>
 
|-
 
|-
!Code!!Print Name!! !!Code!!Print Name
+
!Code!!Display Name!! !!Code!!Display Name
 
|-
 
|-
 
|[http://cda/infrastructure/vocabulary/ParticipationType.htm#PRCP PRCP] ('''Default''')||primary information recipient||  
 
|[http://cda/infrastructure/vocabulary/ParticipationType.htm#PRCP PRCP] ('''Default''')||primary information recipient||  
Line 543: Line 1,003:
 
|}
 
|}
  
Where a person is the intended recipient (IntendedRecipient class), the playing entity is a person (Person class), optionally scoped by an organization (Organization class). Where the intended recipient is an organization, the IntendedRecipient.classCode is valued with "ASSIGNED", and the recipient is reflected by the presence of a scoping Organization, without a playing entity. Where a health chart is the intended recipient, the IntendedRecipient.classCode is valued with "HLTHCHRT" (health chart). In this case there is no playing entity, and an optional scoping organization (Organization class).  
+
=====IntendedRecipient=====
 +
 
 +
Identifies the person(s), organization or health chart to receive the document.
 +
 
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: IntendedRecipient
 +
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-classCode-att classCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[1..1]||[http://cda/infrastructure/vocabulary/vs_RoleClass.htm#x_InformationRecipientRole V:x_InformationRecipientRole]||Closed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-id-att  id ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-II II]>||[1..*]|| ||
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-addr-att  addr ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-AD AD]>||[0..*]|| ||
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-telecom-att  telecom ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TEL TEL]>||[0..*]|| ||
 +
|}
 +
 
 +
'''IntendedRecipient.classCode'''
 +
 
 +
Where a person is the intended recipient (IntendedRecipient class), the IntendedRecipient.classCode is valued with "ASSIGNED", and the playing entity is a person (Person class), optionally scoped by an organization (Organization class). Where the intended recipient is an organization, the IntendedRecipient.classCode is valued with "ASSIGNED", and the recipient is reflected by the presence of a scoping Organization, without a playing entity. Where a health chart is the intended recipient, the IntendedRecipient.classCode is valued with "HLTHCHRT" (health chart). In this case there is no playing entity, and an optional scoping organization (Organization class).  
  
 
{| class='wikitable'   
 
{| class='wikitable'   
 
|+Table {{AUTOTABLENUM}}: Value set for IntendedRecipient.classCode
 
|+Table {{AUTOTABLENUM}}: Value set for IntendedRecipient.classCode
! style="text-align:left;"  colspan="5" |  v:x_InformationRecipientRole <small>[2.16.840.1.113883.1.11.16772] (CLOSED) </small>
+
! style="text-align:left;"  colspan="5" |  V:x_InformationRecipientRole <small>[2.16.840.1.113883.1.11.16772] (CLOSED) </small>
 
|-
 
|-
!Code!!Print Name!! !!Code!!Print Name
+
!Code!!Display Name!! !!Code!!Display Name
 
|-
 
|-
 
|[http://cda/infrastructure/vocabulary/RoleClass.htm#ASSIGNED ASSIGNED] ('''Default''')||assigned entity||  
 
|[http://cda/infrastructure/vocabulary/RoleClass.htm#ASSIGNED ASSIGNED] ('''Default''')||assigned entity||  
Line 556: Line 1,035:
 
!style="text-align:left;"  colspan="5" |<small> Code System: RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110</small>
 
!style="text-align:left;"  colspan="5" |<small> Code System: RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110</small>
 
|}
 
|}
 +
 +
 +
'''IntendedRecipient.id'''
 +
 +
Optional identifier of the intended recipient.
 +
 +
'''IntendedRecipient.addr'''
 +
 +
Optional postal address of the intended recipient.
 +
 +
'''IntendedRecipient.telecom'''
 +
 +
Optional phone number for the intended recipient.
 +
 +
=====Person @b@=====
 +
 +
Refer to [[#div-person|Person]] (&sect; 5.2.2.2.2) as defined for Author participation.
 +
 +
=====Organization @a@=====
 +
 +
Refer to [[#div-organization|organization]] (&sect; 5.2.2.1.3) as defined for authenticator participation.
  
 
====<big>legalAuthenticator</big>====
 
====<big>legalAuthenticator</big>====
  
Represents a participant who has legally authenticated the document.
+
Represents the participant(s) who has legally authenticated the document.
 +
 
 +
[[Image:Authenicator.png|800px|border|center|authenicator]]
 +
 
 +
<span class="change-highlight">CDA R2.1, now supports [0..*] legal authentications. This enhancement was put into CDA to support the sharing of medical documents needing to take more than one legal authentication signature.</span>
  
 
The CDA is a standard that specifies the structure of exchanged clinical documents. In the case where a local document is transformed into a CDA document for exchange, authentication occurs on the local document, and that fact is reflected in the exchanged CDA document. A CDA document can reflect the unauthenticated, authenticated, or legally authenticated state. The unauthenticated state exists when no authentication information has been recorded (i.e., it is the absence of being either authenticated or legally authenticated).
 
The CDA is a standard that specifies the structure of exchanged clinical documents. In the case where a local document is transformed into a CDA document for exchange, authentication occurs on the local document, and that fact is reflected in the exchanged CDA document. A CDA document can reflect the unauthenticated, authenticated, or legally authenticated state. The unauthenticated state exists when no authentication information has been recorded (i.e., it is the absence of being either authenticated or legally authenticated).
  
While electronic signatures are not captured in a CDA document, both authentication and legal authentication require that a document has been signed manually or electronically by the responsible individual. A legalAuthenticator has a required legalAuthenticator.time indicating the time of authentication, and a required legalAuthenticator.signatureCode, indicating that a signature has been obtained and is on file.  
+
Both authentication and legal authentication require that a document has been signed manually or electronically by the responsible individual. A legalAuthenticator has a required legalAuthenticator.time indicating the time of authentication, and a required legalAuthenticator.signatureCode, indicating that a signature has been obtained and is on file.  
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for legalAuthenticator.typeCode
+
|+Table {{AUTOTABLENUM}}: legalAuthenticator[0..*]
! style="text-align:left;" colspan="2" | v:ParticipationAuthenticator <small>[2.16.840.1.113883.1.11.20065] (CLOSED) </small>
+
!Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Participation-typeCode-att typeCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ParticipationType.htm#LA LA]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Participation-contextControlCode-att contextControlCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ContextControl.htm#_ContextControlPropagating OP]||Fixed
 
|-
 
|-
!Code!!Print Name
+
|[http://cda/infrastructure/rim/rim.htm#Participation-time-att  time]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TS TS] ||[1..1]||||
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/ParticipationType.htm#LA LA] ('''Fixed''')||legal authenticator
+
|[http://cda/infrastructure/rim/rim.htm#Participation-signatureCode-att signatureCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CV CV]||[0..1]||[http://cda/infrastructure/vocabulary/ParticipationSignature.htm S]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Participation-signatureText-att  signatureText]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-ED ED] ||[0..1]||||
 +
|}
 +
 
 +
'''legalAuthenticator.typeCode'''
 +
 
 +
The ClinicalDocument.typeCode is fixed to "LA" to indicate that a participant has legally attested his participation through a signature.
 +
 
 +
{| class='wikitable'
 +
|+Table {{AUTOTABLENUM}}: Fixed legalAuthenticator.typeCode
 +
!Code!!Display Name
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ParticipationType.htm#AUTHEN AUTHEN]||authenticator
 
|-
 
|-
 
!style="text-align:left;"  colspan="2" |<small> Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90</small>
 
!style="text-align:left;"  colspan="2" |<small> Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90</small>
 
|}
 
|}
 +
 +
'''legalAuthenticator.contextControlCode'''
 +
 +
 +
The legalAuthenticator.contextControlCode is fixed to "OP". It means that the legalAuthenticator will  propagate to any child Acts that allow context to be propagated.
 +
 +
'''legalAuthenticator.time'''
 +
 +
legalAuthenticatorhas a required legalAuthenticator.time indicating the time of authentication.
 +
 +
'''legalAuthenticator.signatureCode'''
 +
 +
legalAuthenticatorhas a required legalAuthenticator.signatureCode, indicating that a signature has been obtained and is on file.
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for legalAuthenticator.signatureCode
+
|+Table {{AUTOTABLENUM}}: Fixed legalAuthenticator.signatureCode
! style="text-align:left;"  colspan="5" |  v:ParticipationSignature <small>[2.16.840.1.113883.5.89] (CLOSED) </small>
+
!Code!!Display Name
|-
 
!Code!!Print Name!! !!Code!!Print Name
 
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/ParticipationSignature.htm S] ('''Fixed''')||signed|| ||[http://cda/infrastructure/vocabulary/ParticipationSignature.htm I] ('''Deprecated''')||intended
+
|[http://cda/infrastructure/vocabulary/ParticipationSignature.htm S] ('''Fixed''')||signed
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/ParticipationSignature.htm X] ('''Deprecated''')||required|| ||  ||
+
!style="text-align:left;"  colspan="2" | <small> Code System: ParticipationSignature (HL7) Code System OID: 2.16.840.1.113883.5.89</small>
|-
 
!style="text-align:left;"  colspan="5" | <small> Code System: ParticipationSignature (HL7) Code System OID: 2.16.840.1.113883.5.89</small>
 
 
|}
 
|}
'''Note''': CDA Release One represented either an intended ("X") or actual ("S") authenticator.  CDA Release 2 and 2.1 only represents an actual authenticator, so usage of "X" and "I" are deprecated.
+
 
 +
'''Note''': CDA Release One represented either an intended ("X") or actual ("S") legalAuthenticator.  CDA Release 2 and 2.1 only represents an actual legalAuthenticator, so only S / Signed can be indicated for the signatureCode.
 +
 
 +
'''legalAuthenticator.signatureText'''
 +
 
 +
A new attribute, SignatureText has been added to legalAuthenticator. The signature can be represented either inline or by reference according to the ED data type. Typical cases are:
 +
 
 +
# Paper-based signatures: the ED data type may refer to a document or other resource that can be retrieved through an electronic interface to a hardcopy archive.
 +
# Electronic signature: this attribute can represent virtually any electronic signature scheme.
 +
# Digital signature: this attribute can represent digital signatures by reference to a signature data block that is constructed in accordance to a digital signature standard, such as XML-DSIG, PKCS#7, PGP, etc.
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for legalAuthenticator.contextControlCode
+
|+Table {{AUTOTABLENUM}}: Fixed legalAuthenticator.contextControlCode
! style="text-align:left;"  colspan="2" |  v:ContextControlOverridingPropagating <small>[2.16.840.1.113883.1.11.20034] (CLOSED) </small>
 
 
|-
 
|-
!Code!!Print Name
+
!Code!!Display Name
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/ContextControl.htm#OP OP] ('''Fixed''')||overriding, propagating
+
|[http://cda/infrastructure/vocabulary/ContextControl.htm#_ContextControlPropagating OP]||overriding, propagating
 
|-
 
|-
 
!style="text-align:left;"  colspan="2" |<small> Code System: ContextControl (HL7) Code System OID: 2.16.840.1.113883.5.1057</small>
 
!style="text-align:left;"  colspan="2" |<small> Code System: ContextControl (HL7) Code System OID: 2.16.840.1.113883.5.1057</small>
Line 602: Line 1,140:
  
 
A legalAuthenticator is a person in the role of an assigned entity (AssignedEntity class). An assigned entity is a person assigned to the role by the scoping organization. The entity playing the role is a person (Person class). The entity scoping the role is an organization (Organization class).
 
A legalAuthenticator is a person in the role of an assigned entity (AssignedEntity class). An assigned entity is a person assigned to the role by the scoping organization. The entity playing the role is a person (Person class). The entity scoping the role is an organization (Organization class).
 +
 +
=====AssignedEntity @c@=====
 +
 +
Refer to [[#div-AssignedEntity|AssignedEntity]] (&sect; 5.2.2.1.1) as defined for authenticator participation.
 +
 +
=====Person @c@=====
 +
 +
Refer to [[#div-person|Person]] (&sect; 5.2.2.2.2) as defined for Author participation.
 +
 +
=====Organization @b@=====
 +
 +
Refer to [[#div-Organization|Organization]] (&sect; 5.2.2.1.3) as defined for authenticator participation.
 +
 +
=====OrganizationPartOf @a@=====
 +
 +
Refer to [[#div-OrganizationPartOf|OrganizationPartOf]] (&sect; 5.2.2.1.4) as defined for authenticator participation.
  
 
====<big>participant</big>====
 
====<big>participant</big>====
  
Used to represent other participants not explicitly mentioned by other classes, that were somehow involved in the documented acts.  
+
[[Image:Participant.png|800px|border|center|participant]]
 +
 
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: participant
 +
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Participation-typeCode-att  typeCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ParticipationType.htm ParticipationType]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Participation-functionCode-att  functionCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CE CE]||[0..1]||[http://cda/infrastructure/vocabulary/voc_ConceptDomains.htm#ParticipationFunction D:ParticipationFunction]|| Open
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Participation-contextControlCode-att contextControlCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ContextControl.htm#_ContextControlPropagating OP]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Participation-time-att time]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TS TS] ||[1..1]||||
 +
|}
 +
 
 +
'''participant.typeCode'''
 +
 
 +
The participant.typeCode is can be any code defined in the ParticipationType domain. Which can be used to represent other participants not explicitly mentioned by other classes, that were somehow involved in the documented acts.  
  
 
{| class='wikitable'   
 
{| class='wikitable'   
Line 611: Line 1,182:
 
! style="text-align:left;"  colspan="5" | v:ParticipationType <small>[2.16.840.1.113883.1.11.10901] (CLOSED)</small>
 
! style="text-align:left;"  colspan="5" | v:ParticipationType <small>[2.16.840.1.113883.1.11.10901] (CLOSED)</small>
 
|-
 
|-
!Code!!Print Name!! !!Code!!Print Name
+
!Code!!Display Name!! !!Code!!Display Name
|-
 
|[http://cda/infrastructure/vocabulary/ParticipationType.htm#PART PART]||Participation||
 
||[http://cda/infrastructure/vocabulary/ParticipationType.htm#ADM ADM]||admitter
 
 
|-
 
|-
 
|[http://cda/infrastructure/vocabulary/ParticipationType.htm#ATND ATND]||attender||
 
|[http://cda/infrastructure/vocabulary/ParticipationType.htm#ATND ATND]||attender||
Line 680: Line 1,248:
 
|-
 
|-
 
|[http://cda/infrastructure/vocabulary/ParticipationType.htm#AUTHEN AUTHEN]||authenticator||
 
|[http://cda/infrastructure/vocabulary/ParticipationType.htm#AUTHEN AUTHEN]||authenticator||
|| ||
+
||[http://cda/infrastructure/vocabulary/ParticipationType.htm#PART PART]||Participation
 
|-
 
|-
 
!colspan="5" |Use the following participations, only if the other participations provided in CDA will not work  
 
!colspan="5" |Use the following participations, only if the other participations provided in CDA will not work  
Line 704: Line 1,272:
 
!style="text-align:left;"  colspan="5" | <small> Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90</small>
 
!style="text-align:left;"  colspan="5" | <small> Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90</small>
 
|}
 
|}
 +
 +
'''participant.functionCode'''
 +
 +
The participant.functionCode is bound to the concept domain ParticipationFunction, which is used to specify the exact function an actor had in a service in all necessary detail. This domain may include local extensions (Open).
 +
 +
'''participant.contextControlCode'''
 +
 +
The participant.contextControlCode is fixed to "OP". It means that the participantType code specified in participant.typeCode will replace the set of author participations that have propagated from ancestor Acts, and will itself be the only author to propagate to any child Acts that allow context to be propagated. 
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for participant.contextControlCode
+
|+Table {{AUTOTABLENUM}}: Fixed participant.contextControlCode
! style="text-align:left;"  colspan="5" | v:ContextControlOverridingPropagating <small>[2.16.840.1.113883.1.11.20034] (CLOSED)</small>
+
!Code!!Display Name
 
|-
 
|-
!Code!!Print Name
+
|[http://cda/infrastructure/vocabulary/ContextControl.htm#_ContextControlPropagating OP] ('''Fixed''')||overriding, propagating
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/ContextControl.htm#OP OP] ('''Fixed''')||overriding, propagating
+
!style="text-align:left;"  colspan="2" | <small> Code System:  ContextControl (HL7) Code System OID: 2.16.840.1.113883.5.1057</small>
 +
|}
 +
 
 +
'''participant.typeCode.time'''
 +
 
 +
The participant.typeCode.time is the date and time the specific participation occurred.
 +
 
 +
=====AssociatedEntity=====
 +
 
 +
A participant is a person or organization in the role of a participating entity (AssociatedEntity class). The entity playing the role is a person (Person class). The entity scoping the role is an organization (Organization class).
 +
 
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: AssociatedEntity
 +
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-classCode-att classCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[1..1]||[http://cda/infrastructure/vocabulary/vs_RoleClass.htm#RoleClassAssociative V:RoleClassAssociative]||Closed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-id-att  id ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-II II]>||[0..*]|| ||
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-code-att  code]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CE CE]||[0..1]||[http://cda/infrastructure/vocabulary/voc_ConceptDomains.htm#RoleCode D:RoleCode]|| Open
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-addr-att  addr ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-AD AD]>||[0..*]|| ||
 
|-
 
|-
!style="text-align:left;" colspan="2" | <small> Code System: ContextControl (HL7) Code System OID: 2.16.840.1.113883.5.1057</small>
+
|[http://cda/infrastructure/rim/rim.htm#Role-telecom-att telecom ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TEL TEL]>||[0..*]|| ||
 
|}
 
|}
  
A participant is a person or organization in the role of a participating entity (AssociatedEntity class). The entity playing the role is a person (Person class). The entity scoping the role is an organization (Organization class).  
+
'''AssociatedEntity.classCode'''
 +
 
 +
When the participating entity is an organization, this is reflected by the presence of a scoping Organization, without a playing entity. Otherwise, the participating entity is considered a person with or without a scoping Organization.  
  
 
{| class='wikitable'   
 
{| class='wikitable'   
Line 722: Line 1,321:
 
! style="text-align:left;"  colspan="5" |  V:RoleClassAssociative <small>[2.16.840.1.113883.1.11.19313] (CLOSED) </small>
 
! style="text-align:left;"  colspan="5" |  V:RoleClassAssociative <small>[2.16.840.1.113883.1.11.19313] (CLOSED) </small>
 
|-
 
|-
!Code!!Print Name!! !!Code!!Print Name
+
!Code!!Display Name!! !!Code!!Display Name
 
|-
 
|-
 
|[http://cda/infrastructure/vocabulary/RoleClass.htm#ROL ROL] ('''Default''')||role||
 
|[http://cda/infrastructure/vocabulary/RoleClass.htm#ROL ROL] ('''Default''')||role||
Line 817: Line 1,416:
 
|}
 
|}
  
When the participating entity is an organization, this is reflected by the presence of a scoping Organization, without a playing entity.
+
'''AssociatedEntity.id'''
 +
 
 +
An identifier for  the associate person (when present) or the organization.
 +
 
 +
'''AssociatedEntity.code'''
 +
 
 +
An optional role code taken from the RoleCode concept domain.  This binding is open so other code systems can be used.
 +
 
 +
'''AssociatedEntity.addr'''
 +
 
 +
The postal address for  the associate person (when present) or the organization.
 +
 
 +
'''AssociatedEntity.telecom'''
 +
 
 +
The phone number for the associated person (when present) or the organization.
 +
 
 +
=====Person @d@=====
 +
 
 +
Refer to [[#div-person|Person]] (&sect; 5.2.2.2.2) as defined for Author participation.
 +
 
 +
=====Organization @c@=====
 +
 
 +
Refer to [[#div-Organization|Organization]] (&sect; 5.2.2.1.3) as defined for authenticator participation.
  
 
====<big>performer</big>====
 
====<big>performer</big>====
  
See [[#ServiceEvent|ServiceEvent]] for a description of the performer participant.
+
See [[#ServiceEvent|ServiceEvent]] (&sect; 5.2.3.2.2) for a description of the performer participant.
  
 
====<big>recordTarget</big>====
 
====<big>recordTarget</big>====
  
The recordTarget represents the medical record that this document belongs to.
 
  
A clinical document typically has exactly one recordTarget participant. In the uncommon case where a clinical document (such as a group encounter note) is placed into more than one patient chart, more than one recordTarget participants can be stated.
+
[[Image:RecordTarget.png|800px|border|center|recordTarget]]
 +
 
 +
The recordTarget identifies the specified patient's medical record that the document belongs to.  
  
The recordTarget(s) of a document are stated in the header and propagate to nested content, where they cannot be overridden (see See [[#CDA_Context|CDA Context]]).  
+
A clinical document typically has exactly one recordTarget participant. In the uncommon case where a clinical document (such as a group encounter note) is placed into more than one patient chart, more than one recordTarget participant can be stated.
 +
 
 +
Note:
 +
The recordTarget(s) of a document are stated in the header and propagate to nested content, where they cannot be overridden.  However, the patient(s) specified by the recordTarget are assumed to be the default ''subjects'' of the clinical document. Unlike the recordTarget, which can not be overridden, the patients or ''subjects'' propagate to nested components, and can be overridden at the section or entry level.  (see See [[#CDA_Context|CDA Context]] (&sect; 5.4)).  
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for recordTarget.typeCode
+
|+Table {{AUTOTABLENUM}}: recordTarget
! style="text-align:left;"  colspan="2" | v:ParticipationRecordTarget <small>[2.16.840.1.113883.1.11.20094] (CLOSED) </small>
+
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 
|-
 
|-
!Code!!Print Name
+
|[http://cda/infrastructure/rim/rim.htm#Participation-typeCode-att  typeCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ParticipationType.htm#RCT RCT]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Participation-contextControlCode-att contextControlCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ContextControl.htm#_ContextControlPropagating OP]||Fixed
 +
|}
 +
 
 +
'''recordTarget.typeCode'''
 +
 
 +
The recordTarget.typeCode is fixed to "RCT" and indicates that this is a record target participation. 
 +
 
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: Fixed recordTarget.typeCode
 +
!Code!!Display Name
 
|-
 
|-
|[http://cda/infrastructure/vocabulary/ParticipationType.htm#RCT RCT] ('''Fixed''')||record target
+
|[http://cda/infrastructure/vocabulary/ParticipationType.htm#RCT RCT]||record target
 
|-
 
|-
 
!style="text-align:left;"  colspan="2" |<small> Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90</small>
 
!style="text-align:left;"  colspan="2" |<small> Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90</small>
 
|}
 
|}
 +
 +
'''recordTarget.contextControlCode'''
 +
 +
The recordTarget.contextControlCode is fixed to "OP". It means that the recordTarget identified in the header will  propagate to any child Acts that allow context to be propagated.
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for recordTarget.contextControlCode
+
|+Table {{AUTOTABLENUM}}: Fixed recordTarget.contextControlCode
! style="text-align:left;"  colspan="2" |  v:ContextControlOverridingPropagating <small>[2.16.840.1.113883.1.11.20034] (CLOSED) </small>
+
!Code!!Display Name
 
|-
 
|-
!Code!!Print Name
+
|[http://cda/infrastructure/vocabulary/ContextControl.htm#_ContextControlPropagating OP]||overriding, propagating
|-
 
|[http://cda/infrastructure/vocabulary/ContextControl.htm#OP OP] ('''Fixed''')||overriding, propagating
 
 
|-
 
|-
 
!style="text-align:left;"  colspan="2" |<small> Code System: ContextControl (HL7) Code System OID: 2.16.840.1.113883.5.1057</small>
 
!style="text-align:left;"  colspan="2" |<small> Code System: ContextControl (HL7) Code System OID: 2.16.840.1.113883.5.1057</small>
Line 855: Line 1,493:
 
A recordTarget is represented as a relationship between a person and an organization, where the person is in a patient role (PatientRole class). The entity playing the role is a patient (Patient class). The entity scoping the role is an organization (Organization class). A patient is uniquely identified via the PatientRole.id attribute.
 
A recordTarget is represented as a relationship between a person and an organization, where the person is in a patient role (PatientRole class). The entity playing the role is a patient (Patient class). The entity scoping the role is an organization (Organization class). A patient is uniquely identified via the PatientRole.id attribute.
  
CDA Release One allowed for additional person identifiers, corresponding to the Patient.id attribute in CDA Release Two. This attribute is included for backwards compatibility and has been deprecated because having two different ways to identify a patient can result in inconsistent usage. Further use of Patient.id is discouraged.
+
=====PatientRole=====
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for PatientRole.classCode (CNE)
+
|+Table {{AUTOTABLENUM}}: PatientRole
!Code!!Definition
+
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-classCode-att classCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/RoleClass.htm#PAT PAT]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-id-att  id ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-II II]>||[1..*]|| ||
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-addr-att  addr ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-AD AD]>||[0..*]|| ||
 
|-
 
|-
|PAT (patient) ['''default''']||A person that receives health care services from a provider.
+
|[http://cda/infrastructure/rim/rim.htm#Role-telecom-att  telecom ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TEL TEL]>||[0..*]|| ||
 
|}
 
|}
 +
 +
'''PatientRole.classCode'''
 +
 +
The PatientRole.classCode is fixed to "PAT" to indicate a person (Patient) as a recipient of health care services from a healthcare provider.
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for Patient.classCode (CNE)
+
|+Table {{AUTOTABLENUM}}: Fixed PatientRole.classCode
!Code!!Definition
+
!Code!!Display Name
 
|-
 
|-
|PSN (person) ['''default''']||A living subject of the species homo sapiens.
+
|[http://cda/infrastructure/vocabulary/RoleClass.htm#PAT PAT]||patient
 +
|-
 +
!style="text-align:left;"  colspan="2" |<small> Code System: RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110</small>
 
|}
 
|}
 +
 +
'''PatientRole.id'''
 +
 +
A unique identifier for the person in this patient role.
 +
 +
'''PatientRole.addr'''
 +
 +
The postal address for the Patient.
 +
 +
'''PatientRole.telecom'''
 +
 +
The phone number for the Patient.
 +
 +
=====Patient=====
 +
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: Patient
 +
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Entity-classCode-att classCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/EntityClass.htm#PSN PSN]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Entity-determinerCode-att determinerCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/EntityDeterminer.htm#INSTANCE  INSTANCE]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Entity-id-att  id] ('''Deprecated''')||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-II II]>||[0..*]|| ||
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Entity-name-att  name]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-PN PN]>||[0..*]|| ||
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Entity-desc-att  desc ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-ED ED]||[0..1]|| ||
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#LivingSubject-administrativeGenderCode-att administrativeGenderCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CE CE]||[0..1]||[http://cda/infrastructure/vocabulary/AdministrativeGender.htm D:administrativeGender]||Open
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#LivingSubject-birthTime-att birthTime]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TS TS]||[0..1]|| ||
 +
|-
 +
|<span class="change-highlight">[http://cda/infrastructure/rim/rim.htm#LivingSubject-deceasedInd-att deceasedInd]</span>||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-BL BL]||[0..1]|| ||
 +
|-
 +
|<span class="change-highlight">[http://cda/infrastructure/rim/rim.htm#LivingSubject-deceasedTime-att deceasedTime]</span>||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TS TS]||[0..1]|| ||
 +
|-
 +
|<span class="change-highlight">[http://cda/infrastructure/rim/rim.htm#LivingSubject-multipleBirthInd-att multipleBirthInd]</span>||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-BL BL]||[0..1]|| ||
 +
|-
 +
|<span class="change-highlight">[http://cda/infrastructure/rim/rim.htm#LivingSubject-multipleBirthOrderNumber-att multipleBirthOrderNumber]</span>||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-INT INT]||[0..1]|| ||
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Person-maritalStatusCode-att maritalStatusCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CE CE]||[0..1]||[http://cda/infrastructure/vocabulary/vs_MaritalStatus.htm#MaritalStatus D:MaritalStatus]||Open
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Person-religiousAffiliationCode-att religiousAffiliationCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CE CE]||[0..1]||[http://cda/infrastructure/vocabulary/ReligiousAffiliation.htm D:ReligousAffiliation]||Open
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Person-raceCode-att raceCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CE CE]>||<span class="change-highlight">[0..*]</span>||[http://cda/infrastructure/vocabulary/Race.htm D:Race]||Open
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Person-ethnicGroupCode-att ethnicGroupCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CE CE]>||<span class="change-highlight">[0..*]</span>||[http://cda/infrastructure/vocabulary/Ethnicity.htm D:Ethnicity]||Open
 +
|}
 +
 +
Note: Not all Patient elements defined in the RIM have been added to CDA's Patient class. Only those originally defined, or added using extensions within actual implementation guides have been included in CDA R2.1.  Implementers are free to use extensions with CDA R2.1 or model missing information using the Observation class within the CDA body.
 +
 +
'''Patient.classCode'''
 +
 +
The Patient.classCode is fixed to "PSN", indicating that the entity is a person.
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for Patient.determinerCode (CNE)
+
|+Table {{AUTOTABLENUM}}: Fixed Patient.classCode
!Code!!Definition
+
!Code!!Display Name
 
|-
 
|-
|INSTANCE (instance) ['''default''']||The INSTANCE determiner indicates an actual occurrence of an entity, as opposed to the KIND determiner, which refers to the general description of a kind of entity. For example, one can refer to a specific car (a car instance), or one can refer to cars in general (a car kind).
+
|[http://cda/infrastructure/vocabulary/EntityClass.htm#PSN PSN]||person
 +
|-
 +
!style="text-align:left;"  colspan="2" | <small> Code System:  EntityClass (HL7) Code System OID: 2.16.840.1.113883.5.41</small>
 
|}
 
|}
  
A patient's language communication skills can be expressed in the associated LanguageCommunication class. A Patient's birthplace is represented as a relationship between a patient and a place. The Birthplace class is played by a place (Place class), and scoped by the patient (Patient class).  
+
'''Patient.determinerCode'''
 +
 
 +
The determinerCode is fixed to "INSTANCE", which indicates a specific person is a patient.  
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for Birthplace.classCode (CNE)
+
|+Table {{AUTOTABLENUM}}: Fixed Patient.determinerCode
!Code!!Definition
+
!Code!!Display Name
 +
|-
 +
|[http://cda/infrastructure/vocabulary/EntityDeterminer.htm#INSTANCE INSTANCE]||specific
 
|-
 
|-
|BIRTHPL (birthplace) ['''default''']||Relates a place as the location where a living subject was born.
+
!style="text-align:left;"  colspan="2" | <small> Code System:  EntityDeterminer (HL7) Code System OID: 2.16.840.1.113883.5.30</small>
 
|}
 
|}
 +
 +
'''Patient.id'''  ('''Deprecated''')
 +
 +
CDA Release 1.0 allowed for additional person identifiers, corresponding to the Patient.id attribute in CDA Release 2.1. This attribute is included for backwards compatibility and has been deprecated because having two different ways to identify a patient can result in inconsistent usage. Further use of Patient.id is discouraged.
 +
 +
'''Patient.name'''
 +
 +
The patient's name. 
 +
 +
Note: The person name data type "PN" supports current, and historical names using validTime, and the specification of different use codes can indicate legal name, tribal name, stage name and others.
 +
 +
'''Patient.desc'''
 +
 +
A textual or multimedia depiction of the patient.
 +
 +
'''Patient.administrativeGenderCode'''
 +
 +
The gender (i.e., the behavioral, cultural, or psychological traits typically associated with one sex) of a living subject as defined for administrative purposes.
 +
 +
'''Patient.birthTime'''
 +
 +
The date and time of the patient's birth.
 +
 +
'''<span class="change-highlight">Patient.deceasedInd</span>'''
 +
 +
<span class="change-highlight">An indication that the subject is dead.</span>
 +
 +
'''<span class="change-highlight">Patient.deceasedTime</span>'''
 +
 +
<span class="change-highlight">The date and time that the patient's death occurred.</span> 
 +
 +
<span class="change-highlight"> Note: If the deceasedTime is valued, then the deceasedInd SHALL be set true. If deceasedInd is set true, the deceasedTime should be valued, if known.</span>
 +
 +
'''<span class="change-highlight">Patient.multipleBirthInd</span>'''
 +
 +
<span class="change-highlight">An indication as to whether the patient was part of a multiple birth.</span>
 +
 +
'''<span class="change-highlight">Patient.multipleBirthOrderNumber</span>'''
 +
 +
<span class="change-highlight">The order within a multiple birth in which this patient was born.</span>
 +
 +
'''Patient.maritalStatusCode'''
 +
 +
The domestic partnership status of the patient.
 +
 +
'''Patient.religiousAffiliationCode'''
 +
 +
The primary religious preference of the patient.
 +
 +
'''Patient.raceCode'''
 +
 +
The race of the patient.
 +
 +
<span class="change-highlight">'''Note:''' More than one race code is now supported in CDA R2.1.</span>
 +
 +
'''Patient.ethnicGroupCode'''
 +
 +
The ethnic group of the patient.
 +
 +
<span class="change-highlight">'''Note:''' More than one ethnic group is now supported in CDA R2.1.</span>
 +
 +
Note: See 2.7 Backwards and Forwards Compatibility, for discussion on sdtc: extensions defined for CDA R2.0 and CDA R2.1.
 +
 +
=====Organization @d@=====
 +
 +
The optional Organization in recordTarget identifies the Patient's healthcare organization. Refer to [[#div-Organization|Organization]] (&sect; 5.2.2.1.3) as defined for authenticator participation for details.
 +
 +
=====LanguageCommunication=====
 +
 +
A patient's language communication skills can be expressed in the associated LanguageCommunication class.
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for Place.classCode (CNE)
+
|+Table {{AUTOTABLENUM}}: LanguageCommunication
!Code!!Definition
+
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#LanguageCommunication-languageCode-att languageCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/voc_ConceptDomains.htm#HumanLanguage D:HumanLanguage]||Open
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#LanguageCommunication-modeCode-att modeCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CE CE]||[0..1]||[http://cda/infrastructure/vocabulary/LanguageAbilityMode.htm D:LanguageAbilityMode]||Open
 
|-
 
|-
|PLC (place) ['''default''']||A physicial place or site with its containing structure.
+
|[http://cda/infrastructure/rim/rim.htm#LanguageCommunication-proficiencyLevelCode-att proficiencyLevelCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CE CE]||[0..1]||[http://cda/infrastructure/vocabulary/LanguageAbilityProficiency.htm D:LanguageAbilityProficiency]||Open
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#LanguageCommunication-preferenceInd-att preferenceInd]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-BL BL]||[0..1]|| ||
 
|}
 
|}
 +
 +
'''LanguageCommunication.languageCode'''
 +
 +
A language for which the patient has some level of proficiency for communication. <br/> Note: Providing a language reference with the LanguageCommunication.languageCode is recommended, when using this class.
 +
 +
'''LanguageCommunication.modeCode'''
 +
 +
The method of expression of the language, e.g. expressed spoken, expressed written, expressed signed, received spoken, received written, received signed
 +
 +
'''LanguageCommunication.proficiencyLevelCode'''
 +
 +
The level of proficiency the patient has in a particular language, e.g. excellent, good, fair, poor
 +
 +
'''LanguageCommunication.preferenceInd'''
 +
 +
An indicator specifying whether the language is preferred by the patient for the associated mode.
 +
 +
=====Birthplace=====
 +
 +
A Patient's birthplace is represented as a relationship between a patient and a place. The Birthplace class is played by a place (Place class), and scoped by the patient (Patient class).
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for Place.determinerCode (CNE)
+
|+Table {{AUTOTABLENUM}}: Birthplace
!Code!!Definition
+
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 
|-
 
|-
|INSTANCE (instance) ['''default''']||The INSTANCE determiner indicates an actual occurrence of an entity, as opposed to the KIND determiner, which refers to the general description of a kind of entity. For example, one can refer to a specific car (a car instance), or one can refer to cars in general (a car kind).
+
|[http://cda/infrastructure/rim/rim.htm#Role-classCode-att classCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/RoleClass.htm#BIRTHPL BIRTHPL]||Fixed
 
|}
 
|}
 +
 +
'''Birthplace.classCode'''
 +
 +
The Birthplace.classCode it fixed to "BIRTHPL" indicating in this context, that the Place referenced is the birth place of the patient.
 +
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: Fixed Birthplace.classCode
 +
!Code!!Display Name
 +
|-
 +
|[http://cda/infrastructure/vocabulary/RoleClass.htm#BIRTHPL BIRTHPL]||birthplace
 +
|-
 +
!style="text-align:left;"  colspan="2" | <small> Code System:  RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110</small>
 +
|}
 +
 +
=====Place=====
 +
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: Place
 +
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Entity-classCode-att classCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/EntityClass.htm#PLC PLC]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Entity-determinerCode-att determinerCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/EntityDeterminer.htm#INSTANCE INSTANCE]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Entity-name-att  name]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-ON ON]>||[0..1]|| ||
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Organization-addr-att  addr]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-AD AD]>||[0..*]|| ||
 +
|}
 +
 +
'''Place.classCode'''
 +
 +
A physical place or site with its containing structure. May be natural or man-made. The geographic position of a place may or may not be constant.
 +
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: Fixed Place.classCode 
 +
!Code!!Display Name
 +
|-
 +
|[http://cda/infrastructure/vocabulary/EntityClass.htm#PLC PLC] ||place||
 +
|-
 +
!style="text-align:left;"  colspan="2" | <small> Code System: EntityClass (HL7) Code System OID: 2.16.840.1.113883.5.41</small>
 +
|}
 +
 +
'''Place.determinerCode'''
 +
 +
 +
The determinerCode is fixed to "INSTANCE", which indicates a specific place is being identified.
 +
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: Fixed Place.determinerCode
 +
!Code!!Display Name
 +
|-
 +
|[http://cda/infrastructure/vocabulary/EntityDeterminer.htm#INSTANCE INSTANCE]||specific
 +
|-
 +
!style="text-align:left;"  colspan="2" | <small> Code System:  EntityDeterminer (HL7) Code System OID: 2.16.840.1.113883.5.30</small>
 +
|}
 +
 +
'''Place.name'''
 +
 +
The name of place of birth (E.g. Queen Mary)
 +
 +
'''Place.addr'''
 +
 +
The postal address for the patient's birthplace.
 +
 +
=====Guardian=====
  
 
A patient's guardian is a person or organization in the role of guardian (Guardian class). The entity playing the role of guardian is a person (Person class) or organization (Organization class). The entity scoping the role is the patient (Patient class).
 
A patient's guardian is a person or organization in the role of guardian (Guardian class). The entity playing the role of guardian is a person (Person class) or organization (Organization class). The entity scoping the role is the patient (Patient class).
Line 906: Line 1,778:
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for Guardian.classCode (CNE)
+
|+Table {{AUTOTABLENUM}}: Guardian
!Code!!Definition
+
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-classCode-att classCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[1..1]||[http://cda/infrastructure/vocabulary/RoleCode.htm#GUARD GUARD]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-id-att  id ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-II II]>||[0..*]|| ||
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-code-att  code]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CE CE]||[0..1]||[http://cda/infrastructure/vocabulary/voc_ConceptDomains.htm#RoleCode D:RoleCode]|| Open
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-addr-att  addr ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-AD AD]>||[0..*]|| ||
 
|-
 
|-
|GUARD (guardian) ['''default''']||An entity (player) that acts or is authorized to act as the guardian of the patient.
+
|[http://cda/infrastructure/rim/rim.htm#Role-telecom-att  telecom ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TEL TEL]>||[0..*]|| ||
 
|}
 
|}
  
====responsibleParty====
+
'''Guardian.classCode'''
  
See [[#EncompassingEncounter|EncompassingEncounter]] for a description of the responsibleParty participant.  
+
The Guardian.classCode is fixed to "GUARD", indicating that the associated person or institution are legally empowered with responsibility for the care of a ward.
  
====Participant Scenarios====
+
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: Fixed Guardian.classCode
 +
!Code!!Display Name
 +
|-
 +
|[http://cda/infrastructure/vocabulary/RoleClass.htm#GUARD GUARD]||guardian
 +
|-
 +
!style="text-align:left;"  colspan="2" |<small> Code System: RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110</small>
 +
|}
 +
 
 +
'''Guardian.code'''
 +
 
 +
An optional role code taken from the RoleCode concept domain. This binding is open so other code systems can be used.
 +
 
 +
'''Guardian.addr'''
 +
 
 +
The guardian's postal address.
 +
 
 +
'''Guardian.telecom'''
 +
 
 +
The guardian's phone number.
 +
 
 +
=====Person @e@=====
 +
 
 +
Refer to [[#div-person|Person]] (&sect; 5.2.2.2.2) as defined for Author participation.
 +
 
 +
=====Organization @e@=====
 +
 
 +
Refer to [[#div-organization|organization]] (&sect; 5.2.2.1.3) as defined for authenticator participation.
 +
 
 +
====<big>responsibleParty</big>====
 +
 
 +
See [[#EncompassingEncounter|EncompassingEncounter]] (&sect; 5.2.3.5) for a description of the responsibleParty participant.
 +
 
 +
====<big>Participant Scenarios</big>====
  
 
Several CDA Header participations can be played by the same person. In such cases, the person should be identified as the player for each appropriate participation. For instance, if a person is both the author and the authenticator of a document, the CDA Header should identify that person as both the author participant and the authenticator participant.
 
Several CDA Header participations can be played by the same person. In such cases, the person should be identified as the player for each appropriate participation. For instance, if a person is both the author and the authenticator of a document, the CDA Header should identify that person as both the author participant and the authenticator participant.
Line 927: Line 1,840:
 
|1. StaffPhysicianOne sees a patient as a consultant, dictates a note, and later signs it.
 
|1. StaffPhysicianOne sees a patient as a consultant, dictates a note, and later signs it.
 
|-
 
|-
| *Author — StaffPhysicianOne
+
|
 +
*Author — StaffPhysicianOne
 
*Encounter Participant — StaffPhysicianOne (typeCode="CONS")
 
*Encounter Participant — StaffPhysicianOne (typeCode="CONS")
 
*Legal Authenticator — StaffPhysicianOne
 
*Legal Authenticator — StaffPhysicianOne
 
|-
 
|-
|2. StaffPhysicianOne sees a patient and dictates a note. StaffPhysicianTwo later signs the note. *
+
|2. StaffPhysicianOne sees a patient and dictates a note. StaffPhysicianTwo later signs the note.&dagger;
 
|-
 
|-
| *Author — StaffPhysicianOne
+
|
 +
*Author — StaffPhysicianOne
 
*Legal Authenticator — StaffPhysicianTwo
 
*Legal Authenticator — StaffPhysicianTwo
 
|-
 
|-
|3. ResidentOne sees a patient with StaffPhysicianOne. ResidentOne dictates a note and later signs it. The note is co-signed by StaffPhysicianOne. *
+
|3. ResidentOne sees a patient with StaffPhysicianOne. ResidentOne dictates a note and later signs it. The note is co-signed by StaffPhysicianOne.&dagger;
 
|-
 
|-
| *Author — ResidentOne
+
|
 +
*Author — ResidentOne
 
*Authenticator — ResidentOne
 
*Authenticator — ResidentOne
 
*Encounter Participant — StaffPhysicianOne (typeCode="ATND")
 
*Encounter Participant — StaffPhysicianOne (typeCode="ATND")
 
*Legal Authenticator — StaffPhysicianOne
 
*Legal Authenticator — StaffPhysicianOne
 
|-
 
|-
|4. ResidentOne sees a patient with StaffPhysicianOne. ResidentOne dictates a note and later signs it. The note is co-signed by StaffPhysicianTwo. *
+
|4. ResidentOne sees a patient with StaffPhysicianOne. ResidentOne dictates a note and later signs it. The note is co-signed by StaffPhysicianTwo.&dagger;
 
|-
 
|-
 
|
 
|
Line 951: Line 1,867:
 
*Legal Authenticator — StaffPhysicianTwo
 
*Legal Authenticator — StaffPhysicianTwo
 
|-
 
|-
|5. ResidentOne sees a patient with StaffPhysicianOne. ResidentOne dictates a note, and goes off on vacation. The note is signed by ResidentTwo and by StaffPhysicianOne. *
+
|5. ResidentOne sees a patient with StaffPhysicianOne. ResidentOne dictates a note, and goes off on vacation. The note is signed by ResidentTwo and by StaffPhysicianOne.&dagger;
 
|-
 
|-
 
|
 
|
Line 959: Line 1,875:
 
*Legal Authenticator — StaffPhysicianOne
 
*Legal Authenticator — StaffPhysicianOne
 
|-
 
|-
|6. ResidentOne sees a patient with StaffPhysicianOne. ResidentOne dictates a note, which is later signed by ResidentTwo and StaffPhysicianTwo. *
+
|6. ResidentOne sees a patient with StaffPhysicianOne. ResidentOne dictates a note, which is later signed by ResidentTwo and StaffPhysicianTwo.&dagger;
 
|-
 
|-
 
|
 
|
Line 967: Line 1,883:
 
*Legal Authenticator — StaffPhysicianTwo
 
*Legal Authenticator — StaffPhysicianTwo
 
|-
 
|-
|7. StaffPhysicianOne receives an abnormal lab result, attempts to contact patient but can't, and writes and signs a progress note.
+
|7. StaffPhysicianOne receives an abnormal laboratory result, attempts to contact patient but can't, and writes and signs a progress note.
 
|-
 
|-
 
|
 
|
Line 981: Line 1,897:
 
*Performer — StaffSurgeonOne (typeCode="PPRF")
 
*Performer — StaffSurgeonOne (typeCode="PPRF")
 
*Performer — ResidentSurgeonOne (typeCode="SPRF")
 
*Performer — ResidentSurgeonOne (typeCode="SPRF")
 +
|-
 +
|9. In Austria, a PET-CT report, is authored and legally authenticated by a radiologist together with a nuclear medicine specialist. The two specialists are working for different medical institutes. Their work and expertise are equal in importance.
 +
|-
 +
|
 +
*Author — Radiologist
 +
*Author — Nuclear Medicine Specialist
 +
*Legal Authenticator — Radiologist
 +
*Legal Authenticator — Nuclear Medicine Specialist
 
|}
 
|}
  
<nowiki>*</nowiki> Note that the ability of one clinician to co-sign or to sign on behalf of another clinician is subject to regulatory and local practice constraints.  
+
&dagger; Note that the ability of one clinician to co-sign or to sign on behalf of another clinician is subject to regulatory and local practice constraints.
  
 
===Header Relationships===
 
===Header Relationships===
Line 989: Line 1,913:
 
This section describes classes related to the root ClinicalDocument class via an ActRelationship.
 
This section describes classes related to the root ClinicalDocument class via an ActRelationship.
  
====ParentDocument====
+
====<big>ParentDocument</big>====
 +
 
 +
[[Image:ParentDocument.png|800px|border|center|ParentDocument]]
 +
 
 +
The ParentDocument represents the source of a document revision, addenda, or transformation.
 +
 
 +
=====relatedDocument=====
 +
 
 +
The optional relatedDocument class is used to associate a ClinicalDocument to a ParentDocument.
  
The ParentDocument represents the source of a document revision, addenda, or transformation. ParentDocument.text is modeled as an ED data type - allowing for the expression of the MIME type of the parent document. It is not to be used to embed the related document, and thus ParentDocument.text.BIN is precluded from use.
+
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: relatedDocument Attributes
 +
!Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#ActRelationship-typeCode-att typeCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[1..1]||[http://cda/infrastructure/vocabulary/vs_ActRelationshipType.htm#x_ActRelationshipDocument x_ActRelationshipDocument]||Closed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#ActRelationship-inversionInd-att inversionInd]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-BL BL]||[0..1]|| ||
 +
|}
 +
 
 +
'''relatedDocument.typeCode'''
  
 
Allowable values for the intervening relatedDocument.typeCode are shown in the following table.
 
Allowable values for the intervening relatedDocument.typeCode are shown in the following table.
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for relatedDocument.typeCode (CNE)
+
|+Table {{AUTOTABLENUM}}: Value set for relatedDocument.typeCode  
!Code!!Definition
+
! style="text-align:left;"  colspan="5" |  v:x_ActRelationshipDocument <small>[2.16.840.1.113883.1.11.11610] (CLOSED) </small>
 +
|-
 +
!Code!!Display Name!! !!Code!!Display Name
 
|-
 
|-
|APND (append)||The current document is an addendum to the ParentDocument.
+
|[http://cda/infrastructure/vocabulary/ActRelationshipType.htm#APND APND]||is appendage ||
 +
||[http://cda/infrastructure/vocabulary/ActRelationshipType.htm#RPLC RPLC]||replaces
 
|-
 
|-
|RPLC (replace)||The current document is a replacement of the ParentDocument.
+
|[http://cda/infrastructure/vocabulary/ActRelationshipType.htm#XFRM XFRM]||transformation || || ||
 
|-
 
|-
|XFRM (transform)||The current document is a transformation of the ParentDocument.
+
!style="text-align:left;"  colspan="5" | <small> Code System: ActRelationshipType (HL7) Code System OID: 2.16.840.1.113883.5.1002</small>
 
|}
 
|}
  
A conformant CDA document can have a single relatedDocument with typeCode "APND"; a single relatedDocument with typeCode "RPLC"; a single relatedDocument with typeCode "XFRM"; a combination of two relatedDocuments with typeCodes "XFRM" and "RPLC"; or a combination of two relatedDocuments with typeCodes "XFRM" and "APND". No other combinations are allowed.
+
A conformant CDA document can have a single relatedDocument with typeCode "APND"; a single relatedDocument with typeCode "RPLC"; a single relatedDocument with typeCode "XFRM"; a combination of two relatedDocuments with typeCodes "XFRM" and "RPLC"; or a combination of two relatedDocuments with typeCodes "XFRM" and "APND". No other combinations are allowed.
 +
 
 +
<span class="change-highlight">'''relatedDocument.inversionInd'''</span>
 +
 
 +
<span class="change-highlight">'''Technical note''': CDA R2.0 design assumes that ClinicalDocument was the source for all typecodes found in relatedDocument, ("APND", "RPLC" and "XFRM"). For "APND" and "RPLC" this is correct, however for "XFRM", the RIM definition indicates that "''it is used when the target Act is a transformation of the source Act...''".  This  technically is an error in CDA R2.0's design, which normally should have required the use of inversionInd to establish the ClinicalDocument as the target and the ParentDocument as the source for the "XFRM" relation.
 +
 
 +
As a result, in CDA R2.1 when "XFRM" is assigned to the relatedDocument.typeCode, the associated inversionInd will be assumed to be fixed to true, but will not be required to be present in the instance document. In all other cases, "APND", "RPLC" the associated inversionInd will not be present and will be assumed to be false. This enables wire format compatibility between CDA R2.0 and CDA R2.1, and ensures proper interpretation of the "XFRM" ActRelationshipType code.</span>
 +
 
 +
=====ParentDocument=====
 +
 
 +
The ParentDocument identifies and optionally provides a reference to the original document serving as the source for the current document revision, addendum or transformation.  
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for ParentDocument.classCode (CNE)
+
|+Table {{AUTOTABLENUM}}: ParentDocument Attributes
!Code!!Definition
+
!Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Act-classCode-att    classCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ActClass.htm#DOCCLIN DOCCLIN]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Act-moodCode-att    moodCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ActMood.htm#EVN EVN]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#InfrastructureRoot-typeId-att  typeId]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-II II]||[1..1]|| ||
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Act-id-att id]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-II II]||[1..*]||||
 +
|- 
 +
|[http://cda/infrastructure/rim/rim.htm#Act-code-att code]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CE CE]||[1..1]||[http://cda/infrastructure/vocabulary/voc_ConceptDomains.htm#DocumentType D:DocumentType]||Open
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Act-text-att text]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-ED ED]||[0..1]||||
 
|-
 
|-
|DOCCLIN (clinical document) ['''default''']||A clinical document.
+
|[http://cda/infrastructure/rim/rim.htm#ContextStructure-setId-att setId]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-II II]||[0..1]||||
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#ContextStructure-versionNumber-att versionNumber]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-ST ST]||[0..1]||||
 
|}
 
|}
 +
 +
'''ParentDocument.classCode'''
 +
 +
The ParentDocument.classCode is fixed to "DOCCLIN".
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for ParentDocument.moodCode (CNE)
+
|+Table {{AUTOTABLENUM}}: Fixed ParentDocument.classCode
!Code!!Definition
+
!Code!!Display Name
 
|-
 
|-
|EVN (event) ['''default''']||An actual occurrence of an event.
+
|[http://cda/infrastructure/vocabulary/ActClass.htm#DOCCLIN DOCCLIN]||clinical document
 +
|-
 +
!style="text-align:left;"  colspan="2" | <small> Code System: ActClass (HL7) Code System OID: 2.16.840.1.113883.5.6</small>
 
|}
 
|}
  
'''Document Identification, Revisions, and Addenda'''
+
'''ParentDocument.moodCode'''
 +
 
 +
The ParentDocument.moodCode is fixed to "EVN".
 +
 
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: Fixed ParentDocument.moodCode
 +
!Code!!Display Name
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActMood.htm#EVN EVN]||event
 +
|-
 +
!style="text-align:left;"  colspan="2" |<small> Code System: ActMood (HL7) Code System OID: 2.16.840.1.113883.5.1001</small>
 +
|}
 +
 
 +
'''ParentDocument.id'''
 +
 
 +
The ParentDocument.id is a required identifier, which uniquely identifies the parent document.
 +
 
 +
'''ParentDocument.code'''
 +
 
 +
The code specifying the particular kind of document (e.g. History and Physical, Discharge Summary, Progress Note). The value set is drawn from LOINC, and has a CWE coding strength.
 +
 
 +
'''ParentDocument.text'''
 +
 
 +
ParentDocument.text is modeled as an ED data type - allowing for the expression of the MIME type of the parent document. It is not to be used to embed the related document, and thus ParentDocument.text.BIN is precluded from use.
 +
 
 +
'''ParentDocument.setId'''
 +
 
 +
Optional setID for the parent document.
 +
 
 +
'''ParentDocument.versionNumber'''
 +
 
 +
Optional versionNumber of the parent document.
 +
 
 +
'''Additional Information on Document Identification, Revisions, and Addenda'''
  
 
A clinical document can be replaced by a new document and/or appended with an addendum.
 
A clinical document can be replaced by a new document and/or appended with an addendum.
Line 1,034: Line 2,041:
 
CDA documents may also contain a ClinicalDocument.setId and a ClinicalDocument.versionNumber, which together support a document identification and versioning scheme used in some document management systems. In this scheme, all documents in a chain of replacements have the same ClinicalDocument.setId and are distinguished by an incrementing ClinicalDocument.versionNumber. The initial version of a document gets, in addition to a new unique value for ClinicalDocument.id, a new value for ClinicalDocument.setId, and has the value of ClinicalDocument.versionNumber set to equal "1". A replacement document gets a new globally unique ClinicalDocument.id value, and uses the same value for ClinicalDocument.setId as the parent report being replaced, and increments the value of ClinicalDocument.versionNumber by 1. (Note that version number must be incremented by one when a report is replaced, but can also be incremented more often to meet local requirements.)
 
CDA documents may also contain a ClinicalDocument.setId and a ClinicalDocument.versionNumber, which together support a document identification and versioning scheme used in some document management systems. In this scheme, all documents in a chain of replacements have the same ClinicalDocument.setId and are distinguished by an incrementing ClinicalDocument.versionNumber. The initial version of a document gets, in addition to a new unique value for ClinicalDocument.id, a new value for ClinicalDocument.setId, and has the value of ClinicalDocument.versionNumber set to equal "1". A replacement document gets a new globally unique ClinicalDocument.id value, and uses the same value for ClinicalDocument.setId as the parent report being replaced, and increments the value of ClinicalDocument.versionNumber by 1. (Note that version number must be incremented by one when a report is replaced, but can also be incremented more often to meet local requirements.)
  
These relationships are illustrated in the following exhibit "Document Identification, Revisions, and Addenda Scenarios". Typical scenarios are a simple relacement (e.g. ClinicalDocument.id "1.2.345.6789.266" replacing ClinicalDocument.id "1.2.345.6789.123") and a simple append (e.g. ClinicalDocument.id "1.2.345.6789.456" appends ClinicalDocument.id "1.2.345.6789.123"). More complex scenarios that might be anticipated include: [1] replacement of an addendum (e.g. ClinicalDocument.id "1.2.345.6789.224" replaces ClinicalDocument.id "1.2.345.6789.456", which itself is an addendum to ClinicalDocument.id "1.2.345.6789.123") - expected behavior would be to render the replacement as the addendum (e.g. render ClinicalDocument.id "1.2.345.6789.224" as the addendum to ClinicalDocument.id "1.2.345.6789.123"); [2] addendum to a replaced document (e.g. ClinicalDocument.id "1.2.345.6789.456" appends ClinicalDocument.id "1.2.345.6789.123", which has been replaced by ClinicalDocument.id "1.2.345.6789.266") - expected behavior would be to render the addendum along with the replacement (e.g. render ClinicalDocument.id "1.2.345.6789.456" as an addendum to ClinicalDocument.id "1.2.345.6789.266").
+
These relationships are illustrated in the following exhibit "Document Identification, Revisions, and Addenda Scenarios". Typical scenarios are:
 +
*A simple relacement (e.g. ClinicalDocument.id "1.2.345.6789.266" replacing ClinicalDocument.id "1.2.345.6789.123")  
 +
*A simple append (e.g. ClinicalDocument.id "1.2.345.6789.456" appends ClinicalDocument.id "1.2.345.6789.123").  
 +
 
 +
More complex scenarios that might be anticipated include:  
 +
 
 +
[1] replacement of an addendum (e.g. ClinicalDocument.id "1.2.345.6789.224" replaces ClinicalDocument.id "1.2.345.6789.456", which itself is an addendum to ClinicalDocument.id "1.2.345.6789.123") - expected behavior would be to render the replacement as the addendum (e.g. render ClinicalDocument.id "1.2.345.6789.224" as the addendum to ClinicalDocument.id "1.2.345.6789.123");  
 +
 
 +
[2] addendum to a replaced document (e.g. ClinicalDocument.id "1.2.345.6789.456" appends ClinicalDocument.id "1.2.345.6789.123", which has been replaced by ClinicalDocument.id "1.2.345.6789.266") - expected behavior would be to render the addendum along with the replacement (e.g. render ClinicalDocument.id "1.2.345.6789.456" as an addendum to ClinicalDocument.id "1.2.345.6789.266").
  
 
'''Document transformations'''
 
'''Document transformations'''
  
A CDA document can be a transformation from some other format, meaning that it has undergone a machine translation from some other format (such as DICOM SR). In this case, relatedDocument.typeCode should be set to "XFRM".
+
A CDA document can be a transformation from some other format, meaning that it has undergone a machine translation from some other format (such as DICOM SR). In this case, relatedDocument.typeCode should be set to "XFRM".  
  
 
A proper transformation must ensure that the human readable clinical content of the report is not impacted. Local business rules determine whether or not a transformed report replaces the source, but typically this would not be the case. If it is, an additional relationship of type "RPLC" is to be used. The "XFRM" relationship can also be used when translating a document in a local format into CDA for the purpose of exchange. In this case, the target of the "XFRM" relationship is the local document identifier.
 
A proper transformation must ensure that the human readable clinical content of the report is not impacted. Local business rules determine whether or not a transformed report replaces the source, but typically this would not be the case. If it is, an additional relationship of type "RPLC" is to be used. The "XFRM" relationship can also be used when translating a document in a local format into CDA for the purpose of exchange. In this case, the target of the "XFRM" relationship is the local document identifier.
  
{{ext|infrastructure/cda/graphics/L-cda_figure1.gif|Link to wide graphic (opens in a new window)}}
+
[[image:cda_figure1.gif|center|400px|Transformation]]
 +
 
 +
====<big>ServiceEvent</big>====
 +
 
 +
[[Image:ServiceEvent.png|800px|border|center|ServiceEvent]]
 +
 
 +
<span class="change-highlight">The ServiceEvent is used to represent the main activity being documented. It may used to represent a specific procedure, such as a colonoscopy, an appendectomy, or other clinical activity. When the ClinicalDocument represents a summary of care, the ServiceEvent.code can be set to "PCPR" to indicate the service is care provisioning.</span>
 +
 
 +
=====documentationOf=====
 +
 
 +
The optional documentationOf class is used to associate a ClinicalDocument to a ServiceEvent.
 +
 
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: documentationOf Attributes
 +
!Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#ActRelationship-typeCode-att typeCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/vs_ActRelationshipType.htm#ActRelationshipDocuments DOC]||Fixed
 +
|}
 +
 
 +
'''documentationOf.typeCode'''
 +
 
 +
The documentationOf.typeCode is fixed to "DOC" which indicates that the ClinicalDocument provides documentation is about ServiceEvent.
 +
 
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: Fixed documentationOf.typeCode
 +
!Code!!Display Name
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActRelationshipType.htm#DOC DOC]||documents
 +
|-
 +
!style="text-align:left;"  colspan="2" | <small> Code System: ActRelationshipType (HL7) Code System OID: 2.16.840.1.113883.5.1002</small>
 +
|}
 +
 
 +
=====ServiceEvent=====
 +
 
 +
In some cases, the ServiceEvent is inherent in the ClinicalDocument.code, such as where ClinicalDocument.code is "History and Physical Report" and the procedure being documented is a "History and Physical". A ServiceEvent can further specialize the act inherent in the ClinicalDocument.code, such as where the ClinicalDocument.code is simply "Procedure Report" and the procedure was a "colonoscopy". If ServiceEvent is included, it must be equivalent to or further specialize the value inherent in the ClinicalDocument.code, and shall not conflict with the value inherent in the ClinicalDocument.code, as such a conflict would constitute an ambiguous situation.
 +
 
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: ServiceEvent Attributes
 +
!Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Act-classCode-att    classCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ActClass.htm V:ActClassRoot]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Act-moodCode-att    moodCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ActMood.htm#EVN EVN]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Act-id-att id]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-II II]||[0..*]||||
 +
|- 
 +
|[http://cda/infrastructure/rim/rim.htm#Act-code-att code]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CD CD]||[0..1]||[http://cda/infrastructure/vocabulary/vs_ActCode.htm#ActCode D:ActCode]||Open
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Act-statusCode-att statusCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/vs_ActStatus.htm#ActStatus D:ActStatus]||Closed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Act-effectiveTime-att effectiveTime]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-IVL IVL]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TS TS]>||[0..1]||||
 +
|}
 +
 
 +
'''ServiceEvent.classCode'''
 +
 
 +
The ServiceEvent.classCode identifies the RIM Act class code of the service event instance.
 +
 
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: Value set for ServiceEvent.classCode
 +
! style="text-align:left;"  colspan="5" | V:ActClassRoot <small> [2.16.840.1.113883.1.11.13856] (CLOSED)</small>
 +
|-
 +
!Code!!Display Name!!  !!Code!!Display Name
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#ACT ACT] ('''Default''')||act||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#COMPOSITION COMPOSITION]||composition, Attestable unit
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#DOC DOC]||document||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#DOCCLIN DOCCLIN]||clinical document
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#CDALVLONE CDALVLONE]||CDA Level One clinical document||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#CONTAINER CONTAINER]||record container
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#CATEGORY CATEGORY]||category||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#DOCBODY DOCBODY]||document body
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#DOCSECT DOCSECT]||document section, Section||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#TOPIC TOPIC]||topic
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#EXTRACT EXTRACT]||extract||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#EHR EHR]||electronic health record
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#FOLDER FOLDER]||folder||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#GROUPER GROUPER]||grouper
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#CLUSTER CLUSTER]||Cluster||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#ACCM ACCM]||accommodation
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#ACCT ACCT]||account||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#ACSN ACSN]||accession
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#ADJUD ADJUD]||financial adjudication, financial adjudication results ||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#CACT CACT]||control act
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#ACTN ACTN]||action||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#INFO INFO]||information
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#STC STC]||state transition control||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#CNTRCT CNTRCT]||contract
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#FCNTRCT FCNTRCT]||financial contract||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#COV COV]||coverage
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#CONS CONS]||consent||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#CONTREG CONTREG]||container registration
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#CTTEVENT CTTEVENT]||clinical trial timepoint event||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#DISPACT DISPACT]||disciplinary action
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#EXPOS EXPOS]||exposure||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#AEXPOS AEXPOS]||acquisition exposure
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#TEXPOS TEXPOS]||transmission exposure||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#INC INC]||incident
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#INFRM INFRM]||inform||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#INVE INVE]||invoice element
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#LIST LIST]||working list||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#MPROT MPROT]||monitoring program
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#OBS OBS]||Observation||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#ALRT ALRT]||detected issue
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#BATTERY BATTERY]||battery||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#CLNTRL CLNTRL]||clinical trial
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#CONC CONC]||concern||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#COND COND]||Condition
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#CASE CASE]||public health case||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#OUTB OUTB]||outbreak
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#DGIMG DGIMG]||diagnostic image||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#GEN GEN]||genomic observation
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#DETPOL DETPOL]||determinant peptide||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#EXP EXP]||expression level
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#LOC LOC]||locus||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#PHN PHN]||phenotype
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#POL POL]||polypeptide||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#SEQ SEQ]||bio sequence
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#SEQVAR SEQVAR]||bio sequence variation||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#INVSTG INVSTG]||investigation
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#OBSSER OBSSER]||observation series||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#OBSCOR OBSCOR]||correlated observation sequences
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#POS POS]||position||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#POSACC POSACC]||position accuracy
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#POSCOORD POSCOORD]||position coordinate||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#SPCOBS SPCOBS]||specimen observation
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#VERIF VERIF]||Verification||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#ROIBND ROIBND]||bounded ROI
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#ROIOVL ROIOVL]||overlay ROI|| 
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#PCPR PCPR]||care provision
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#ENC ENC]||encounter|| 
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#POLICY POLICY]||policy
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#JURISPOL JURISPOL]||jurisdictional policy|| 
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#ORGPOL ORGPOL]||organizational policy
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#SCOPOL SCOPOL]||scope of practice policy|| 
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#STDPOL STDPOL]||standard of practice policy
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#PROC PROC]||procedure||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#SBEXT SBEXT]||Substance Extraction
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#SPECCOLLECT SPECCOLLECT]||Specimen Collection||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#SBADM SBADM]||substance administration
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#REG REG]||registration||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#REV REV]||review
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#SPCTRT SPCTRT]||specimen treatment||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#SPLY SPLY]||supply
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#DIET DIET]||diet||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#STORE STORE]||storage
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#SUBST SUBST]||Substitution||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#TRFR TRFR]||transfer
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#TRNS TRNS]||transportation||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#XACT XACT]|| financial transaction
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#CNOD CNOD] ('''Deprecated''')||Condition Node||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#LLD LLD] ('''Deprecated''')||left lateral decubitus
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#PRN PRN] ('''Deprecated''')||prone ||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#RLD RLD] ('''Deprecated''')||right lateral decubitus
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#SFWL SFWL] ('''Deprecated''')||Semi-Fowler's ||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#SIT SIT] ('''Deprecated''')||sitting
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#STN STN] ('''Deprecated''')||standing ||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#SUP SUP] ('''Deprecated''')||supine
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#RTRD RTRD] ('''Deprecated''')|| reverse trendelenburg ||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#TRD TRD] ('''Deprecated''')||trendelenburg
 +
|-
 +
!style="text-align:left;"  colspan="5" | <small> Code System: ActClass (HL7) Code System OID: 2.16.840.1.113883.5.6</small>
 +
|}
 +
 
 +
'''ServiceEvent.moodCode'''
 +
 
 +
The ServiceEvent.moodCode is fixed to "EVN", which indicates documentation of a past service.
 +
 
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: Fixed ServiceEvent.moodCode
 +
!Code!!Display Name
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActMood.htm#EVN EVN]||event
 +
|-
 +
!style="text-align:left;"  colspan="2" |<small> Code System: ActMood (HL7) Code System OID: 2.16.840.1.113883.5.1001</small>
 +
|}
 +
 
 +
'''ServiceEvent.id'''
 +
 
 +
The optional unique identifier for the ServiceEvent.
 +
 
 +
'''ServiceEvent.code'''
 +
 
 +
The particular kind of service event that the this instance represents within its class code.
 +
The ServiceEvent.code is bound to the [http://cda/infrastructure/vocabulary/vs_ActCode.htm#ActCode D:ActCode] concept domain.
 +
 
 +
'''ServiceEvent.statusCode'''
 +
 
 +
The ServiceEvent.statusCode can take on any of the values defined in the D:[http://cda/infrastructure/vocabulary/ActStatus.htm ActStatus] domain.
  
====ServiceEvent====
+
'''ServiceEvent.effectiveTime'''
  
This class represents the main Act, such as a colonoscopy or an appendectomy, being documented.
+
ServiceEvent.effectiveTime can be used to indicate the time the actual event (as opposed to the encounter surrounding the event) took place.
  
In some cases, the ServiceEvent is inherent in the ClinicalDocument.code, such as where ClinicalDocument.code is "History and Physical Report" and the procedure being documented is a "History and Physical" act. A ServiceEvent can further specialize the act inherent in the ClinicalDocument.code, such as where the ClinicalDocument.code is simply "Procedure Report" and the procedure was a "colonoscopy". If ServiceEvent is included, it must be equivalent to or further specialize the value inherent in the ClinicalDocument.code, and shall not conflict with the value inherent in the ClinicalDocument.code, as such a conflict would constitute an ambiguous situation.
+
=====performer @a@=====
  
ServiceEvent.effectiveTime can be used to indicate the time the actual event (as opposed to the encounter surrounding the event) took place.
+
The performer participant represents clinicians who actually and principally carry out the ServiceEvent.
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for documentationOf.typeCode (CNE)
+
|+Table {{AUTOTABLENUM}}: performer
!Code!!Definition
+
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Participation-typeCode-att  typeCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[1..1]||[http://cda/infrastructure/vocabulary/vs_ParticipationType.htm#x_ServiceEventPerformer x_ServiceEventPerformer]||Closed
 
|-
 
|-
|DOC (documents) ['''default''']||The current document is a documentation of the related ServiceEvent.
+
|[http://cda/infrastructure/rim/rim.htm#Participation-functionCode-att  functionCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CE CE]||[0..1]||[http://cda/infrastructure/vocabulary/voc_ConceptDomains.htm#ParticipationFunction D:ParticipationFunction]|| Open
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Participation-time-att time]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TS TS] ||[1..1]||||
 
|}
 
|}
 +
 +
'''performer.typeCode'''
 +
 +
Allows for the optional identification of performers, primary performers and secondary performers.
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for ServiceEvent.classCode (CNE)
+
|+Table {{AUTOTABLENUM}}: Value set for performer.typeCode
!Code!!Definition
+
! style="text-align:left;"  colspan="5" | v:x_ServiceEventPerformer <small>[2.16.840.1.113883.1.11.19601] (CLOSED)</small>
 +
|-
 +
!Code!!Display Name!! !!Code!!Display Name
 
|-
 
|-
|ACT (act) ['''default''']||A healthcare service.
+
|[http://cda/infrastructure/vocabulary/ParticipationType.htm#PRF PRF]||performer||
 +
||[http://cda/infrastructure/vocabulary/ParticipationType.htm#PPRF PPRF]||primary performer
 
|-
 
|-
|Any ACT subtype||See vocabulary domain "ActClassRoot" for allowable values.
+
|[http://cda/infrastructure/vocabulary/ParticipationType.htm#SPRF SPRF]||secondary performer||
 +
|| ||
 +
|-
 +
!style="text-align:left;"  colspan="5" | <small> Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90</small>
 
|}
 
|}
 +
 +
'''performer.functionCode'''
 +
 +
Performer.functionCode can be used to specify addition detail about the function of the performer (e.g. scrub nurse, third assistant). The functionCode is bound to the D:[http://cda/infrastructure/vocabulary/voc_ConceptDomains.htm#ParticipationFunction ParticipationFunction] concept domain.
 +
 +
'''performer.time'''
 +
 +
Performer.time can be used to specify the time during which the performer is involved in the activity.
 +
 +
=====AssignedEntity @d@=====
 +
 +
A performer is an entity in the role of assigned entity (see [[#div-AssignedEntity|AssignedEntity]] (&sect; 5.2.2.1.1)).
 +
 +
=====Person @f@=====
 +
 +
An assigned entity is a person assigned to the role by the scoping organization (see [[#div-person|Person]] (&sect; 6.2.2.2.2)).
 +
 +
=====Organization @f@=====
 +
 +
The entity scoping the role is an organization (see [[#div-Organization|Organization]] (&sect; 5.2.2.1.3)).
 +
 +
====<big>Order</big>====
 +
 +
[[Image:Order.png|800px|border|center|Order]]
 +
 +
This class represents those requests that are fulfilled by this document. For instance, a provider orders an X-Ray. The X-Ray is performed. A radiologist reads the X-Ray and generates a report. The X-Ray order identifier is transmitted in the Order class, the performed X-Ray procedure is transmitted in the ServiceEvent class, and the ClinicalDocument.code would be valued with "Diagnostic Imaging Report".
 +
 +
=====inFullfillmentOf=====
 +
 +
The optional inFullfillmentOf class is used to associate a ClinicalDocument to an Order.
 +
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: Fixed InFulfillmentOf.typeCode
 +
!Code!!Display Name
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActRelationshipType.htm#FLFS FLFS]||fulfills
 +
|-
 +
!style="text-align:left;"  colspan="2" | <small> Code System: ActRelationshipType (HL7) Code System OID: 2.16.840.1.113883.5.1002</small>
 +
|}
 +
 +
=====Order=====
 +
 +
A reference to the fulfilled order.
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for ServiceEvent.moodCode (CNE)
+
|+Table {{AUTOTABLENUM}}: Order Attributes
!Code!!Definition
+
!Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Act-classCode-att classCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ActClass.htm V:ActClassRoot]||Closed
 
|-
 
|-
|EVN (event) ['''default''']||An actual occurrence of an event.
+
|[http://cda/infrastructure/rim/rim.htm#Act-moodCode-att moodCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ActMood.htm#RQO RQO]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Act-id-att id]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-II II]||[1..*]||||
 +
|- 
 +
|[http://cda/infrastructure/rim/rim.htm#Act-code-att code]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CD CD]||[0..1]||[http://cda/infrastructure/vocabulary/vs_ActCode.htm#ActCode D:ActCode]||Open
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Act-priorityCode-att priorityCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ActPriority.htm V:ActPriority]||Open
 
|}
 
|}
  
The performer participant represents clinicians who actually and principally carry out the ServiceEvent. Performer.time can be used to specify the time during which the performer is involved in the activity. Performer.functionCode can be used to specify addition detail about the function of the performer (e.g. scrub nurse, third assistant). Its value set is drawn from the ParticipationFunction vocabulary domain, and has a CWE coding strength.
+
'''Order.classCode'''
 +
 
 +
The Order.classCode identifies the RIM Act class code of the order instance.
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for performer.typeCode (CNE)
+
|+Table {{AUTOTABLENUM}}: Value set for Order.classCode
!Code!!Definition
+
! style="text-align:left;"  colspan="5" | V:ActClassRoot <small> [2.16.840.1.113883.1.11.13856] (CLOSED)</small>
 +
|-
 +
!Code!!Display Name!!  !!Code!!Display Name
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#ACT ACT] ('''Default''')||act||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#COMPOSITION COMPOSITION]||composition, Attestable unit
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#DOC DOC]||document||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#DOCCLIN DOCCLIN]||clinical document
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#CDALVLONE CDALVLONE]||CDA Level One clinical document||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#CONTAINER CONTAINER]||record container
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#CATEGORY CATEGORY]||category||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#DOCBODY DOCBODY]||document body
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#DOCSECT CATEGORY]||document section, Section||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#TOPIC TOPIC]||topic
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#EXTRACT EXTRACT]||extract||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#EHR EHR]||electronic health record
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#FOLDER FOLDER]||folder||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#GROUPER GROUPER]||grouper
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#CLUSTER CLUSTER]||Cluster||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#ACCM ACCM]||accommodation
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#ACCT ACCT]||account||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#ACSN ACSN]||accession
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#ADJUD ADJUD]||financial adjudication, financial adjudication results ||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#CACT CACT]||control act
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#ACTN ACTN]||action||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#INFO INFO]||information
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#STC STC]||state transition control||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#CNTRCT CNTRCT]||contract
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#FCNTRCT FCNTRCT]||financial contract||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#COV COV]||coverage
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#CONS CONS]||consent||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#CONTREG CONTREG]||container registration
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#CTTEVENT CTTEVENT]||clinical trial timepoint event||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#DISPACT DISPACT]||disciplinary action
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#EXPOS EXPOS]||exposure||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#AEXPOS AEXPOS]||acquisition exposure
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#TEXPOS TEXPOS]||transmission exposure||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#INC INC]||incident
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#INFRM INFRM]||inform||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#INVE INVE]||invoice element
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#LIST LIST]||working list||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#MPROT MPROT]||monitoring program
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#OBS OBS]||Observation||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#ALRT ALRT]||detected issue
 
|-
 
|-
|PRF (performer)||A person who actually and principally carries out an action.
+
|[http://cda/infrastructure/vocabulary/ActClass.htm#BATTERY BATTERY]||battery|| ||[http://cda/infrastructure/vocabulary/ActClass.htm#CLNTRL CLNTRL]||clinical trial
 
|-
 
|-
|PPRF (primary performer)||The principal performer of the ServiceEvent.
+
|[http://cda/infrastructure/vocabulary/ActClass.htm#CONC CONC]||concern|| ||[http://cda/infrastructure/vocabulary/ActClass.htm#COND COND]||Condition
 
|-
 
|-
|SPRF (secondary performer)||A person assisting in the ServiceEvent through their substantial presence and involvement. This may include assistants, technicians, associates, or other performers.
+
|[http://cda/infrastructure/vocabulary/ActClass.htm#CASE CASE]||public health case||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#OUTB OUTB]||outbreak
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#DGIMG DGIMG]||diagnostic image||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#GEN GEN]||genomic observation
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#DETPOL DETPOL]||determinant peptide||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#EXP EXP]||expression level
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#LOC LOC]||locus||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#PHN PHN]||phenotype
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#POL POL]||polypeptide||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#SEQ SEQ]||bio sequence
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#SEQVAR SEQVAR]||bio sequence variation||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#INVSTG INVSTG]||investigation
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#OBSSER OBSSER]||observation series||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#OBSCOR OBSCOR]||correlated observation sequences
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#POS POS]||position||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#POSACC POSACC]||position accuracy
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#POSCOORD POSCOORD]||position coordinate||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#SPCOBS SPCOBS]||specimen observation
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#VERIF VERIF]||Verification||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#ROIBND ROIBND]||bounded ROI
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#ROIOVL ROIOVL]||overlay ROI|| 
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#PCPR PCPR]||care provision
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#ENC ENC]||encounter|| 
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#POLICY POLICY]||policy
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#JURISPOL JURISPOL]||jurisdictional policy|| 
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#ORGPOL ORGPOL]||organizational policy
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#SCOPOL SCOPOL]||scope of practice policy|| 
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#STDPOL STDPOL]||standard of practice policy
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#PROC PROC]||procedure||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#SBEXT SBEXT]||Substance Extraction
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#SPECCOLLECT SPECCOLLECT]||Specimen Collection||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#SBADM SBADM]||substance administration
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#REG REG]||registration||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#REV REV]||review
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#SPCTRT SPCTRT]||specimen treatment||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#SPLY SPLY]||supply
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#DIET DIET]||diet||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#STORE STORE]||storage
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#SUBST SUBST]||Substitution||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#TRFR TRFR]||transfer
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#TRNS TRNS]||transportation||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#XACT XACT]|| financial transaction
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#CNOD CNOD] ('''Deprecated''')||Condition Node||
 +
||[http://cda/infrastructure/vocabulary/ActClass.htm#LLD LLD] ('''Deprecated''')||left lateral decubitus
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#PRN PRN] ('''Deprecated''')||prone ||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#RLD RLD] ('''Deprecated''')||right lateral decubitus
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#SFWL SFWL] ('''Deprecated''')||Semi-Fowler's ||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#SIT SIT] ('''Deprecated''')||sitting
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#STN STN] ('''Deprecated''')||standing ||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#SUP SUP] ('''Deprecated''')||supine
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#RTRD RTRD] ('''Deprecated''')|| reverse trendelenburg ||  ||[http://cda/infrastructure/vocabulary/ActClass.htm#TRD TRD] ('''Deprecated''')||trendelenburg
 +
|-
 +
!style="text-align:left;"  colspan="5" | <small> Code System: ActClass (HL7) Code System OID: 2.16.840.1.113883.5.6</small>
 +
|}
 +
 
 +
'''Order.moodCode'''
 +
 
 +
The Order.moodCode is fixed to "RQO", which indicates we are referencing the actual order instance.
 +
 
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: Fixed Order.moodCode
 +
!Code!!Display Name
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActMood.htm#RQO RQO]||request
 +
|-
 +
!style="text-align:left;"  colspan="2" |<small> Code System: ActMood (HL7) Code System OID: 2.16.840.1.113883.5.1001</small>
 
|}
 
|}
  
A performer is an entity in the role of assigned entity (AssignedEntity class). An assigned entity is a person assigned to the role by the scoping organization. The entity playing the role is a person (Person class). The entity scoping the role is an organization (Organization class).
+
'''Order.id'''
 +
 
 +
The Order.id is a unique identifier for the order that was fulfilled.
 +
 
 +
'''Order.code'''
 +
 
 +
The particular kind of order that the this instance represents within its class code.
 +
The optional Order.code is bound to the [http://cda/infrastructure/vocabulary/vs_ActCode.htm#ActCode D:ActCode] concept domain.
 +
 
 +
'''Order.priorityCode'''
 +
 
 +
The optional Order.priorityCode, identifies the priority requested when the order was placed.  It is bound to the D:ActPriority concept domain.
 +
 
 +
====<big>Consent</big>====
 +
 
 +
[[Image:Consent.png|800px|border|center|Consent]]
 +
 
 +
Provides references to consents on file.  
  
====Order====
+
=====authorization=====
  
This class represents those orders that are fulfilled by this document. For instance, a provider orders an X-Ray. The X-Ray is performed. A radiologist reads the X-Ray and generates a report. The X-Ray order identifier is transmitted in the Order class, the performed X-Ray procedure is transmitted in the ServiceEvent class, and the ClinicalDocument.code would be valued with "Diagnostic Imaging Report".
+
The optional authorization class is used to associate a ClinicalDocument to a Consent.  
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for InFulfillmentOf.typeCode (CNE)
+
|+Table {{AUTOTABLENUM}}: authorization Attributes
!Code!!Definition
+
!Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 
|-
 
|-
|FLFS (fulfills) ['''default''']||The current document fulfills the order stated in ActOrder.
+
|[http://cda/infrastructure/rim/rim.htm#ActRelationship-typeCode-att typeCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ActRelationshipType.htm#AUTH AUTH]||Fixed
 
|}
 
|}
 +
 +
'''authorization.typeCode'''
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for Order.classCode (CNE)
+
|+Table {{AUTOTABLENUM}}: Fixed authorization.typeCode
!Code!!Definition
+
|-
 +
!Code!!Display Name
 
|-
 
|-
|ACT (act) ['''default''']||A healthcare service.
+
|[http://cda/infrastructure/vocabulary/ActRelationshipType.htm#AUTH AUTH]||authorized by
 
|-
 
|-
|Any ACT subtype||See vocabulary domain "ActClassRoot" for allowable values.
+
!style="text-align:left;"  colspan="2" | <small> Code System: ActRelationshipType (HL7) Code System OID: 2.16.840.1.113883.5.1002</small>
 
|}
 
|}
 +
 +
=====Consent=====
 +
 +
This class references the consents associated with this document. 
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for Order.moodCode (CNE)
+
|+Table {{AUTOTABLENUM}}: Consent Attributes
!Code!!Definition
+
!Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 
|-
 
|-
|RQO (request) ['''default''']||A request or order to perform the stated act.
+
|[http://cda/infrastructure/rim/rim.htm#Act-classCode-att classCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ActClass.htm#CONS CONS]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Act-moodCode-att    moodCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ActMood.htm#EVN EVN]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Act-id-att id]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-II II]||[0..*]||||
 +
|- 
 +
|[http://cda/infrastructure/rim/rim.htm#Act-code-att code]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CD CD]||[0..1]||[http://cda/infrastructure/vocabulary/vs_ActCode.htm#ActCode D:ActCode]||Open
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Act-statusCode-att statusCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[1..1]||[http://cda/infrastructure/vocabulary/ActStatus.htm#completed completed]||Fixed
 
|}
 
|}
  
====Consent====
+
'''Consent.classCode'''
  
This class references the consents associated with this document. The type of consent (e.g. a consent to perform the related ServiceEvent, a consent for the information contained in the document to be released to a third party) is conveyed in Consent.code. Consents referenced in the CDA Header have been finalized (Consent.statusCode must equal "completed") and should be on file.
+
The Consent.classCode is fixed to "CONS" to represent a consent. The Consent class represents informed consents and all similar medico-legal transactions between the patient (or his legal guardian) and the provider.  
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for authorization.typeCode (CNE)
+
|+Table {{AUTOTABLENUM}}: Fixed Consent.classCode
!Code!!Definition
+
!Code!!Display Name
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#CONS CONS]||consent
 
|-
 
|-
|AUTH (authorized by) ['''default''']||The consent authorizes or certifies acts specified in the current document.
+
!style="text-align:left;"  colspan="2" | <small> Code System: ActClass (HL7) Code System OID: 2.16.840.1.113883.5.6</small>
 
|}
 
|}
 +
 +
'''Consent.moodCode'''
 +
 +
The Consent.moodCode is fixed to "EVN" (event) which indicates the consent has already been captured and is assumed to be on file.
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for Consent.classCode (CNE)
+
|+Table {{AUTOTABLENUM}}:Fixed Consent.moodCode
!Code!!Definition
+
!Code!!Display Name
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActMood.htm#EVN EVN]||event
 
|-
 
|-
|CONS (consent) ['''default''']||The Consent class represents informed consents and medico-legal transactions.
+
!style="text-align:left;"  colspan="2" |<small> Code System: ActMood (HL7) Code System OID: 2.16.840.1.113883.5.1001</small>
 
|}
 
|}
 +
 +
'''Consent.id'''
 +
 +
Optional identifier for the consent.
 +
 +
'''Consent.code'''
 +
 +
The Consent.code is bound to the [http://cda/infrastructure/vocabulary/vs_ActCode.htm#ActCode D:ActCode] concept domain. It is used to optionally identify the type of consent (e.g. a consent to perform the related ServiceEvent, a consent for the information contained in the document to be released to a third party).
 +
 +
'''Consent.statusCode'''
 +
 +
Consents referenced in the CDA Header have been finalized (Consent.statusCode must equal "completed") and should be on file.
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for Consent.moodCode (CNE)
+
|+Table {{AUTOTABLENUM}}: Fixed Consent.statusCode
!Code!!Definition
+
!Code!!Display Name
 
|-
 
|-
|EVN (event) ['''default''']||An actual occurrence of an event.
+
|[http://cda/infrastructure/vocabulary/ActStatus.htm#completed completed]||completed
 +
|-
 +
!style="text-align:left;"  colspan="2" |<small> Code System: ActStatus (HL7) Code System OID: 2.16.840.1.113883.5.14</small>
 
|}
 
|}
 +
 +
====<big>EncompassingEncounter</big>====
 +
 +
 +
[[Image:EncompassingEncounter.png|800px|border|center|EncompassingEncounter]]
 +
 +
This optional class represents the setting of the clinical encounter during which the documented act(s) or ServiceEvent occurred. Documents are not necessarily generated during an encounter, such as when a clinician, in response to an abnormal laboratory result, attempts to contact the patient but can't, and writes a Progress Note: in such a case, the encompassingEncounter could be omitted.
 +
 +
=====componentOf=====
 +
 +
The optional componentOf class is used to associate the ClinicalDocument to an EncompassingEncounter.
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for Consent.statusCode (CNE)
+
|+Table {{AUTOTABLENUM}}: componentOf Attributes
!Code!!Definition
+
!Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 
|-
 
|-
|completed||The consent being referenced by the CDA document has been finalized and is on file.
+
|[http://cda/infrastructure/rim/rim.htm#ActRelationship-typeCode-att typeCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ActRelationshipType.htm#COMP COMP]||Fixed
 
|}
 
|}
  
====EncompassingEncounter====
+
'''componentOf.typeCode'''
  
This optional class represents the setting of the clinical encounter during which the documented act(s) or ServiceEvent occurred. Documents are not necessarily generated during an encounter, such as when a clinician, in response to an abnormal lab result, attempts to contact the patient but can't, and writes a Progress Note.
+
The componentOf.typeCode is fixed to "COMP", which indicates that the ClinicalDocument was created within the context of an encounter (encompassingEncounter).  
 +
 
 +
{| class='wikitable'
 +
|+Table {{AUTOTABLENUM}}: Fixed componentOf.typeCode
 +
!Code!!Display Name
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActRelationshipType.htm#COMP COMP]||component
 +
|-
 +
!style="text-align:left;"  colspan="2" | <small> Code System: ActRelationshipType (HL7) Code System OID: 2.16.840.1.113883.5.1002</small>
 +
|}
  
In some cases, the setting of the encounter is inherent in the ClinicalDocument.code, such as where ClinicalDocument.code is "Diabetes Clinic Progress Note". The setting of an encounter can also be transmitted in the HealthCareFacility.code attribute. If HealthCareFacility.code is sent, it should be equivalent to or further specialize the value inherent in the ClinicalDocument.code (such as where the ClinicalDocument.code is simply "Clinic Progress Note" and the value of HealthCareFacility.code is "cardiology clinic"), and shall not conflict with the value inherent in the ClinicalDocument.code, as such a conflict would constitute an ambiguous situation.
+
=====EncompassingEncounter=====
  
EncompassingEncounter.dischargeDispositionCode can be used to depict the disposition of the patient at the time of hospital discharge (e.g., discharged to home, expired, against medical advice, etc.).
+
The EncompassingEncounter represents an interaction between a patient and care provider(s) for the purpose of providing healthcare-related service(s).  
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for componentOf.typeCode (CNE)
+
|+Table {{AUTOTABLENUM}}: EncompassingEncounter Attributes
!Code!!Definition
+
!Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Act-classCode-att classCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ActClass.htm#ENC ENC]||Fixed
 
|-
 
|-
|COMP (component) ['''default''']||The current document is a documentation of events that occurred during the EncompassingEncounter.
+
|[http://cda/infrastructure/rim/rim.htm#Act-moodCode-att    moodCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/ActMood.htm#EVN EVN]||Fixed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Act-id-att id]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-II II]||[0..*]||||
 +
|- 
 +
|[http://cda/infrastructure/rim/rim.htm#Act-code-att code]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CD CD]||[0..1]||[http://cda/infrastructure/vocabulary/vs_ActCode.htm#ActEncounterCode V:ActEncounterCode]||Open
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Act-effectiveTime-att effectiveTime]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-IVL IVL]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TS TS]>||[0..1]||||
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#PatientEncounter-admissionReferralSourceCode-att admissionReferralSourceCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CE CE]||[0..1]||[http://cda/infrastructure/vocabulary/voc_ConceptDomains.htm#EncounterReferralSource D:EncounterReferralSourceCode]||Open
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#PatientEncounter-dischargeDispositionCode-att dischargeDispositionCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CE CE]||[0..1]||[http://cda/infrastructure/vocabulary/voc_ConceptDomains.htm#EncounterDischargeDisposition D:EncounterDischargeDisposition]||Open
 +
|}
 +
 
 +
'''EncompassingEncounter.classCode'''
 +
 
 +
The EncompassingEncounter.classCode is fixed to "ENC" to represent a encounter. The encounter class is used to represent an interaction between a patient and healthcare participant(s) for the purpose of providing patient service(s) or assessing the health status of a patient.
 +
 
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: Fixed EncompassingEncounter.classCode
 +
!Code!!Display Name
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActClass.htm#ENC ENC]||encounter
 +
|-
 +
!style="text-align:left;"  colspan="2" | <small> Code System: ActClass (HL7) Code System OID: 2.16.840.1.113883.5.6</small>
 
|}
 
|}
 +
 +
'''EncompassingEncounter.moodCode'''
 +
 +
The EncompassingEncounter.moodCode is fixed to "EVN" (event) which indicates that the encounter is on-going or completed.
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for EncompassingEncounter.classCode (CNE)
+
|+Table {{AUTOTABLENUM}}: Fixed EncompassingEncounter.moodCode
!Code!!Definition
+
!Code!!Display Name
 
|-
 
|-
|ENC (encounter) ['''default''']||An interaction between a patient and healthcare participant(s) for the purpose of providing patient service(s) or assessing the health status of a patient.
+
|[http://cda/infrastructure/vocabulary/ActMood.htm#EVN EVN]||event
 +
|-
 +
!style="text-align:left;"  colspan="2" |<small> Code System: ActMood (HL7) Code System OID: 2.16.840.1.113883.5.1001</small>
 
|}
 
|}
 +
 +
'''EncompassingEncounter.id'''
 +
 +
The optional EncompassingEncounter.id can be used to uniquely identify the encounter.
 +
 +
'''EncompassingEncounter.code'''
 +
 +
The optional EncompassingEncounter.code is bound to the ActEncounterCode value set.
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for EncompassingEncounter.moodCode (CNE)
+
|+Table {{AUTOTABLENUM}}: Value set for EncompassingEncounter.code
!Code!!Definition
+
! style="text-align:left;"  colspan="5" | V:ActEncounterCode <small> [2.16.840.1.113883.1.11.13955] (OPEN)</small>
 +
|-
 +
!Code!!Display Name!!  !!Code!!Display Name
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActCode.htm#AMB AMB]||ambulatory||  ||[http://cda/infrastructure/vocabulary/ActCode.htm#EMER EMER]||emergency
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActCode.htm#FLD FLD]||field||  ||[http://cda/infrastructure/vocabulary/ActCode.htm#HH HH]||home health
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActCode.htm#IMP IMP]||inpatient encounter||  ||[http://cda/infrastructure/vocabulary/ActCode.htm#ACUTE ACUTE]||inpatient acute
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActCode.htm#NONAC NONAC]||virtual||  ||[http://cda/infrastructure/vocabulary/ActCode.htm#SS SS]||short stay
 +
|-
 +
|[http://cda/infrastructure/vocabulary/ActCode.htm#VR VR]||inpatient non-acute||  || ||
 
|-
 
|-
|EVN (event) ['''default''']||An actual occurrence of an event.
+
!style="text-align:left;"  colspan="5" | <small> Code System: ActCode (HL7) Code System OID: 2.16.840.1.113883.5.4</small>
 
|}
 
|}
  
The location participant (location class) relates a healthcare facility (HealthCareFacility class) to the encounter to indicate where the encounter took place. The entity playing the role of HealthCareFacility is a place (Place class). The entity scoping the HealthCareFacility role is an organization (Organization class).
+
'''EncompassingEncounter.effectiveTime'''
 +
 
 +
For Encounters, the effectiveTime is the "administrative" time, i.e., the encounter start and end date as established by business rules. <span class="change-highlight">    For inpatient encounters, the effectiveTime/low value is the admission date and time and the effectiveTime/high value is the discharge date and time.  Note: If the encounter is still active at the time of document creation, the effectiveTime/high element SHALL be omitted to indicate the encounter is on-going. This is preferred over using a nullFlavor.</span>
 +
 
 +
'''EncompassingEncounter.admissionReferralSourceCode'''
  
The setting of an encounter (e.g. cardiology clinic, primary care clinic, rehabilitation hospital, skilled nursing facility) can be expressed in HealthCareFacility.code. Note that setting and physical location are not the same. There is a many-to-many relationship between setting and the physical location where care is delivered. Thus, a particular room can provide the location for cardiology clinic one day, and for primary care clinic another day; and cardiology clinic today might be held in one physical location, but in another physical location tomorrow.
+
The optional EncompassingEncounter.admissionReferralSourceCode can be use to depict the type of place or organization responsible for the patient's care immediately prior to a patient encounter.
  
When the location is an organization, this is indicated by the presence of a scoping Organization, without a playing Place.
+
'''EncompassingEncounter.dischargeDispositionCode'''
 +
 
 +
The optional EncompassingEncounter.dischargeDispositionCode can be used to depict the disposition of the patient at the time of hospital discharge (e.g., discharged to home, expired, against medical advice, etc.).
 +
 
 +
=====location=====
 +
 
 +
The location participant (location class) relates a healthcare facility (HealthCareFacility class) to the encounter to indicate where the encounter took place.
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for location.typeCode (CNE)
+
|+Table {{AUTOTABLENUM}}: location
!Code!!Definition
+
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 
|-
 
|-
|LOC (location) ['''default''']||The location where the service is done. May be a static building (or room therein) or a moving location (e.g., ambulance, helicopter, aircraft, train, truck, ship, etc.)
+
|[http://cda/infrastructure/rim/rim.htm#Participation-typeCode-att  typeCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[1..1]||[http://cda/infrastructure/vocabulary/ParticipationType.htm#LOC LOC]||Fixed
 
|}
 
|}
 +
 +
'''location.typeCode'''
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for HealthCareFacility.classCode (CNE)
+
|+Table {{AUTOTABLENUM}}: Fixed participant.typeCode
!Code!!Definition
+
!Code!!Display Name
 
|-
 
|-
|SDLOC (service delivery location) ['''default''']||A role played by a place at which services may be provided.
+
|[http://cda/infrastructure/vocabulary/ParticipationType.htm#LOC LOC]||location
 
|-
 
|-
|Any SDLOC (RoleClassServiceDeliveryLocation) subtype||See vocabulary domain "RollClassServiceDeliveryLocation" for allowable values.
+
!style="text-align:left;"  colspan="2" | <small> Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90</small>
 
|}
 
|}
 +
 +
=====HealthCareFacility=====
 +
 +
The HealthCareFacility class supports the identification of the service delivery location. The location may be the setting (place) with an optional organizational reference, or a reference to the healthcare organization.
 +
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: HealthCareFacility
 +
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-classCode-att classCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[0..1]||[http://cda/infrastructure/vocabulary/vs_RoleClass.htm#RoleClassServiceDeliveryLocation V:RoleClassServiceDeliveryLocation]||Closed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-id-att  id ]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-SET SET]<[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-II II]>||[0..*]|| ||
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Role-code-att  code]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CE CE]||[0..1]||[http://cda/infrastructure/vocabulary/vs_RoleCode.htm#ServiceDeliveryLocationRoleType V:ServiceDeliveryLocation]|| Open
 +
|}
 +
 +
'''HealthCareFacility.classCode'''
 +
 +
The HealthCareFacility.classCode is bound to the ServiceDeliveryLocation value set and defaulted to the "SDLOC" to indicate the service delivery location.
 +
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: Value set for  HealthCareFacility.classCode
 +
! style="text-align:left;"  colspan="5" |  v:RoleClassServiceDeliveryLocation <small>[2.16.840.1.113883.1.11.16927] (CLOSED) </small>
 +
|-
 +
!Code!!Display Name!! !!Code!!Display Name
 +
|-
 +
|[http://cda/infrastructure/vocabulary/RoleClass.htm#SDLOC SDLOC] ('''Default''')||service delivery location||
 +
||[http://cda/infrastructure/vocabulary/RoleClass.htm#DSDLOC DSDLOC]||dedicated service delivery location, health care facility
 +
|-
 +
|[http://cda/infrastructure/vocabulary/RoleClass.htm#ISDLOC ISDLOC] ||incidental service delivery location|| || ||
 +
|-
 +
!style="text-align:left;"  colspan="5" |<small> Code System: RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110</small>
 +
|}
 +
 +
'''HealthCareFacility.id'''
 +
 +
An optional HealthCareFacility.id can be sent to uniquely identify the health care facility.
 +
 +
'''HealthCareFacility.code'''
 +
 +
The setting of an encounter (e.g. cardiology clinic, primary care clinic, rehabilitation hospital, skilled nursing facility) can be expressed in HealthCareFacility.code. A value set ServiceDeliveryLocationRoleType is provided for the this field.
 +
 +
'''Note:''' In some cases, the setting of the encounter is inherent in the ClinicalDocument.code, such as where ClinicalDocument.code is "Diabetes Clinic Progress Note". The setting of an encounter can also be transmitted in the HealthCareFacility.code attribute. If HealthCareFacility.code is sent, it should be equivalent to or further specialize the value inherent in the ClinicalDocument.code (such as where the ClinicalDocument.code is simply "Clinic Progress Note" and the value of HealthCareFacility.code is "cardiology clinic"), and shall not conflict with the value inherent in the ClinicalDocument.code, as such a conflict would constitute an ambiguous situation.
 +
 +
=====Place @a@=====
 +
 +
The entity playing the role of HealthCareFacility is a place (see [[#Place|Place]] (&sect; 5.2.2.11.6)).
 +
 +
The setting (place) and physical location are not the same. There is a many-to-many relationship between setting and the physical location where care is delivered. Thus, a particular room can provide the setting for cardiology clinic one day, and for primary care clinic another day; and cardiology clinic today might be held in one physical location, but in another physical location tomorrow.
 +
 +
=====Organization @g@=====
 +
 +
The entity scoping the HealthCareFacility role is an organization (see [[#div-Organization|Organization]] (&sect; 5.2.2.1.3)).
 +
When the location is an organization, this is indicated by the presence of a scoping Organization, without a playing Place.
 +
 +
=====responsibleParty=====
  
 
The responsibleParty participant represents the participant having primary legal responsibility for the encounter. This differs from the legalAuthenticator participant in that the legalAuthenticator may or may not be the responsible party, and is serving a medical records function by signing off on the document, moving it into a completed state.
 
The responsibleParty participant represents the participant having primary legal responsibility for the encounter. This differs from the legalAuthenticator participant in that the legalAuthenticator may or may not be the responsible party, and is serving a medical records function by signing off on the document, moving it into a completed state.
 +
 +
'''responsibleParty.typeCode'''
 +
 +
The responsibleParty.typeCode is fixed to "RESP" to indicate the responsible party i.e. The person or organization that has primary responsibility for the encounter. The responsible party is not necessarily present in an action, but is accountable for the action through the power to delegate, and the duty to review actions with the performing actor after the fact. This responsibility may be ethical, legal, contractual, fiscal, or fiduciary in nature.
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for responsibleParty.typeCode (CNE)
+
|+Table {{AUTOTABLENUM}}: Fixed responsibleParty.typeCode
!Code!!Definition
+
!Code!!Display Name
 
|-
 
|-
|RESP (responsible party) ['''default''']||The provider (person or organization) who has primary responsibility for the encounter. The responsible provider is not necessarily present in an encounter, but is accountable for the action through the power to delegate, and the duty to review actions with the performing participant.
+
|[http://cda/infrastructure/vocabulary/ParticipationType.htm#RESP RESP]||responsible party
 +
|-
 +
!style="text-align:left;"  colspan="2" |<small> Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90</small>
 
|}
 
|}
  
 
A responsibleParty is a person or organization in the role of an assigned entity (AssignedEntity class). An assigned entity is a person assigned to the role by the scoping organization. The entity playing the role is a person (Person class). The entity scoping the role is an organization (Organization class).
 
A responsibleParty is a person or organization in the role of an assigned entity (AssignedEntity class). An assigned entity is a person assigned to the role by the scoping organization. The entity playing the role is a person (Person class). The entity scoping the role is an organization (Organization class).
  
When the responsible party is an organization, the value for AssignedEntity.classCode is "ASSIGNED", and the responsible party is reflected by the presence of a scoping Organization, without a playing entity.
+
When the responsible party is an organization, the value for AssignedEntity.classCode is "ASSIGNED", and the responsible party is reflected by the presence of a scoping Organization, without a playing entity.
 +
 
 +
=====AssignedEntity @e@=====
 +
 
 +
A performer is an entity in the role of assigned entity (see [[#div-AssignedEntity|AssignedEntity]] (&sect; 5.2.2.1.1)).
 +
 
 +
=====Person @g@=====
 +
 
 +
An assigned entity is a person assigned to the role by the scoping organization.
 +
The entity playing the role is a person (see [[#div-person|Person]] (&sect; 5.2.2.2.2)).
 +
 
 +
=====Organization @h@=====
 +
 
 +
The entity scoping the role is an organization (see [[#div-Organization|Organization]] (&sect; 5.2.2.1.3)).
 +
 
 +
=====encounterParticipant @a@=====
  
 
The encounterParticipant participant represents clinicians directly associated with the encounter (e.g. by initiating, terminating, or overseeing it).
 
The encounterParticipant participant represents clinicians directly associated with the encounter (e.g. by initiating, terminating, or overseeing it).
  
 
{| class='wikitable'   
 
{| class='wikitable'   
|+Table {{AUTOTABLENUM}}: Value set for encounterParticipant.typeCode (CNE)
+
|+Table {{AUTOTABLENUM}}: performer
!Code!!Definition
+
!style="text-align:left;"|Attribute Name!!Data Type!!Wire Cardinality!!Code Binding!!Binding Type
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Participation-typeCode-att  typeCode]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-CS CS]||[1..1]||[http://cda/infrastructure/vocabulary/vs_ParticipationType.htm#x_EncounterParticipant V:x_EncounterParticipant]||Closed
 +
|-
 +
|[http://cda/infrastructure/rim/rim.htm#Participation-time-att time]||[http://cda/infrastructure/itsxml/datatypes-its-xml.htm#dtimpl-TS TS] ||[0..1]||||
 +
|}
 +
 
 +
'''encounterParticipant.typeCode'''
 +
 
 +
The encounterParticipant typeCode is bound to the x_EncounterParticipant value set. It supports for the following participation: admitter, attender, consultant, discharger, and referrer.
 +
 
 +
{| class='wikitable' 
 +
|+Table {{AUTOTABLENUM}}: Value set for encounterParticipant.typeCode
 +
! style="text-align:left;"  colspan="5" |  V:x_EncounterParticipant <small>[2.16.840.1.113883.1.11.19600] (CLOSED) </small>
 
|-
 
|-
|ADM (admitter)||The practitioner who admits a patient to a hospital stay.
+
!Code!!Display Name!! !!Code!!Display Name
 
|-
 
|-
|ATND (attender)||The primary practitioner that oversees a patient's care during an encounter.
+
|[http://cda/infrastructure/vocabulary/ParticipationType.htm#ADM ADM]||admitter||
 +
||[http://cda/infrastructure/vocabulary/ParticipationType.htm#ATND ATND]||attender
 
|-
 
|-
|CONS (consultant)||An advising practioner participating in the encounter by performing evaluations and making recommendations.
+
|[http://cda/infrastructure/vocabulary/ParticipationType.htm#CON CON]||consultant||
 +
||[http://cda/infrastructure/vocabulary/ParticipationType.htm#DIS DIS]||discharger
 
|-
 
|-
|DIS (discharger)||The practitioner who discharges a patient from a hospital stay.
+
|[http://cda/infrastructure/vocabulary/ParticipationType.htm#REF REF]||referrer| || ||
 
|-
 
|-
|REF (referrer)||A person having referred the patient for services resulting in the encounter.
+
!style="text-align:left;"  colspan="5" |<small> Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90</small>
 
|}
 
|}
 +
 +
'''encounterParticipant.time'''
  
 
An encounterParticipant is an entity in the role of assigned entity (AssignedEntity class). An assigned entity is a person assigned to the role by the scoping organization. The entity playing the role is a person (Person class). The entity scoping the role is an organization (Organization class).
 
An encounterParticipant is an entity in the role of assigned entity (AssignedEntity class). An assigned entity is a person assigned to the role by the scoping organization. The entity playing the role is a person (Person class). The entity scoping the role is an organization (Organization class).
 +
 +
=====AssignedEntity @f@=====
 +
 +
A performer is an entity in the role of assigned entity (see [[#div-AssignedEntity|AssignedEntity]] (&sect;  5.2.2.1.1)).
 +
 +
=====Person @h@=====
 +
 +
An assigned entity is a person assigned to the role by the scoping organization.
 +
The entity playing the role is a person (see [[#div-person|Person]] (&sect; 5.2.2.2.2)).
 +
 +
=====Organization @i@=====
 +
 +
The entity scoping the role is an organization (see [[#div-Organization|Organization]] (&sect; 5.2.2.1.3)).
  
 
==[[Body]]==
 
==[[Body]]==
 
(content on separate page)
 
(content on separate page)
 +
 
=[[CDA Hierarchical Description]]=
 
=[[CDA Hierarchical Description]]=
 
(content on separate page)
 
(content on separate page)

Latest revision as of 14:34, 5 March 2019

Contents

1 CDA Overview

(content on separate page)

2 Introduction to CDA Technical Artifacts

(content on separate page)

3 CDA Document Exchange in HL7 Messages

(content on separate page)

4 CDA Templating

(content on separate page)

5 CDA Design

(remaining content on other page)

5.1 Clinical Document

(remaining content on separate page)

5.2 Header

The purpose of the CDA header is to enable clinical document exchange across and within institutions; facilitate clinical document management; and facilitate compilation of an individual patient's clinical documents into a lifetime electronic patient record. The CDA header sets the context for the document as a whole and the context for understanding the content contained in the document.

5.2.1 ClinicalDocument

The CDA schema was produced by serialization of the CDA model. The starting point for this serialization was the ClinicalDocument class. The ClinicalDocument is the root element in a CDA document instance.

Authenicator

5.2.1.1 ClinicalDocument Attributes

This section describes attributes defined in the ClinicalDocument class.

The table below identifies the attributes of ClinicalDocument. For each item, the name is provided, along with the data type, wire cardinality*, code bindings, and binding type or strength. The links allow will access to the item's definition, data type definition, and when appropriate, the concept domain or value set used with the item.

Table X: ClinicalDocument Attributes
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
classCode CS [0..1] DOCCLIN Fixed
moodCode CS [0..1] EVN Fixed
typeId II [1..1]
templateId II [0..*]
id II [1..1]
code CE [1..1] D:DocumentType Open
title ST [0..1]
effectiveTime TS [0..1]
confidentialityCode SET<CE> [0..*] V:x_BasicConfidentialityKind Open
languageCode CS [0..1] D:HumanLanguage Closed
setId II [0..1]
versionNumber ST [0..1]
copyTime (Deprecated) TS [0..1]

Note*: The wire cardinality represents is the effective cardinality of an element, taking into account 1.3.1 Recipient Responsibilities, relaxation of the requirement to exchange fixed and defaulted values. The logical cardinality expressed in the CDA Hierarchical Description is still present, but assumed by the recipient, not imposed on the wire format of an instance of a CDA document.


ClinicalDocument.classCode

The ClinicalDocument.classCode in the CDA model is fixed to "DOCCLIN". As a result, in the CDA R2.1 Schema, the ClinicalDocument/@classCode has been fixed to "DOCCLIN".

As noted in section 1.3.1 Recipient Responsibilities, fixed and default values asserted in this standard are not required to be present in CDA document instances. However, CDA Implementation Guides can still require them via conformance statements.

Table X: Fixed ClinicalDocument.classCode
Code Display Name
DOCCLIN clinical document
Code System: ActClass (HL7) Code System OID: 2.16.840.1.113883.5.6

ClinicalDocument.moodCode

The ClinicalDocument.moodCode in the CDA model is fixed to "EVN" or event mood to indicate that this is documentation of a past service. In the CDA R2.1 Schema, the ClinicalDocument/@moodCode has been fixed to "EVN".

Table X: Fixed ClinicalDocument.moodCode
Code Display Name
EVN event
Code System: ActMood (HL7) Code System OID: 2.16.840.1.113883.5.1001

The ClinicalDocument class inherits various attributes from the InfrastructureRoot class of the RIM, including ClinicalDocument.templateId and ClinicalDocument.typeId which are discussed here. All CDA classes inherit from infrastructureRoot, which is discussed in Section (link here).

ClinicalDocument.typeId

ClinicalDocument.typeId is a technology-neutral explicit reference to this CDA, Release Two specification, and must be valued as follows: ClinicalDocument.typeId.root = "2.16.840.1.113883.1.3" (which is the OID for HL7 Registered models); ClinicalDocument.typeId.extension = "POCD_HD000040UV20" (which is the unique identifier for the CDA, Release Two Hierarchical Description).

ClinicalDocument.templateId

When a templateId is present in a CDA element, it signals the imposition of a set of template-defined constraints for that element. The templateId is one of the infrastructure attributes added to all CDA classes. It has only been displayed for ClinicalDocument, but is present in all CDA classes, where it can be used to identify constraints defined in an external Implementation Guide template. See 4.3.2 Template Versioning.

ClinicalDocument.id

Represents the unique instance identifier of a clinical document.

ClinicalDocument.code

The code specifying the particular kind of document (e.g. History and Physical, Discharge Summary, Progress Note). The value set is drawn from LOINC, and has a CWE coding strength.

Within the LOINC database, beginning with version 2.09, May 2003, document type codes are those that have a value of "DOC" in the Scale component. This subset of LOINC is described in the appendix (see LOINC Document Codes).

ClinicalDocument.title

Represents the title of the document. It's commonly the case that clinical documents do not have a title, and are collectively referred to by the display name of ClinicalDocument.code (e.g. a "consultation" or "progress note"). Where these display names are rendered to the clinician, or where the document has a unique title, the ClinicalDocument.title component should be used. In the example document in the appendix (see Sample Document), the value of ClinicalDocument.title = "Good Health Clinic Consultation Note".

ClinicalDocument.effectiveTime

Signifies the document creation time, when the document first came into being. Where the CDA document is a transform from an original document in some other format, the ClinicalDocument.effectiveTime is the time the original document was created. The time when the transform occurred is not currently represented in CDA.

ClinicalDocument.ConfidentialityCode

Confidentiality is a required contextual component of CDA, where the value expressed in the header holds true for the entire document, unless overridden by a nested value (as further described in CDA Context). A best practice for clinical documents is to assert the highest level of confidentiality present within a document at the header level.

Table X: Value set for ClinicalDocument.confidentialityCode
x_BasicConfidentialityKind [2.16.840.1.113883.1.11.16926] (OPEN)
Code Display Name Code Display Name
N normal R restricted
V very restricted
Code System: Confidentiality (HL7) Code System OID: 2.16.840.1.113883.5.25

* The codeSystem value is included here because confidentialityCode is of type CE, and therefore must carry both a code and a codeSystem.

ClinicalDocument.languageCode

Specifies the human language of character data (whether they be in contents or attribute values). The values of the attribute are language identifiers as defined by the IETF (Internet Engineering Task Force) RFC 3066 for the Identification of Languages, ed. H. Alvestrand. 1995, which obsoletes RFC 1766. The HL7 code system for these values is "2.16.840.1.113883.6.121". Language is a contextual component of CDA, where the value expressed in the header holds true for the entire document, unless overridden by a nested value (as further described in CDA Context).

ClinicalDocument.setId

Represents an identifier that is common across all document revisions.

ClinicalDocument.versionNumber

A string used to represent the version of the document. For CDA R2.1 we use the ST data type as defined in the HL7 Version 3 Standard: XML Implementation Technology Specification - Wire Format Compatible Release 1 Data Types, Release 1 (XML ITS R2B). We have adopted, for all versionNumber references in CDA R2.1, this data type because it supports an @value attribute, and can support wire format compatibility with the versionNumber in CDA R2.0.

ClinicalDocument.copyTime (Deprecated)

Represents the time a document is released (i.e. copied or sent to a display device) from a document management system that maintains revision control over the document. Once valued, it cannot be changed. The intent is to give the viewer of the document some notion as to how long the document has been out of the safe context of its document management system.

Included for backwards compatibility with CDA, Release One. ClinicalDocument.copyTime has been deprecated because it is not part of the document at the time it is authenticated, but instead represents metadata about the document, applied at some variable time after authentication. Further use is discouraged.

5.2.2 Header Participants

This section describes classes related to the root ClinicalDocument class via a Participation.

5.2.2.1 authenticator

authenicator

Represents a participant who has attested to the accuracy of the document, but who does not have privileges to legally authenticate the document. An example would be a resident physician who sees a patient and dictates a note, then later signs it. (See also legalAuthenticator (§ 5.2.2.8))

A clinical document can have zero to many authenticators. Both authentication and legal authentication require that a document has been signed manually or electronically by the responsible individual.

Table X: Authenicator
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
typeCode CS [0..1] AUTHEN Fixed
time TS [1..1]
signatureCode CV [0..1] S Fixed
signatureText ED [0..1]

authenticator.typeCode

The authenticator.typeCode is fixed to "AUTHEN" to indicate that a participant has attested his participation through a signature.

Table X: Fixed authenticator.typeCode
Code Display Name
AUTHEN authenticator
Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90

authenticator.time

Authenticator has a required authenticator.time indicating the time of authentication.

authenticator.signatureCode

Authenticator has a required authenticator.signatureCode, indicating that a signature has been obtained and is on file.

Table X: Fixed authenticator.signatureCode
Code Display Name
S (Fixed) signed
Code System: ParticipationSignature (HL7) Code System OID: 2.16.840.1.113883.5.89

Note: CDA Release One represented either an intended ("X") or actual ("S") authenticator. CDA Release 2 and 2.1 only represents an actual authenticator, so usage of "X" and "I" are deprecated.

authenticator.signatureText

A new attribute, SignatureText has been added to authenticator. The signature can be represented either inline or by reference according to the ED data type. Typical cases are:

  1. Paper-based signatures: the ED data type may refer to a document or other resource that can be retrieved through an electronic interface to a hardcopy archive.
  2. Electronic signature: this attribute can represent virtually any electronic signature scheme.
  3. Digital signature: this attribute can represent digital signatures by reference to a signature data block that is constructed in accordance to a digital signature standard, such as XML-DSIG, PKCS#7, PGP, etc.
5.2.2.1.1 AssignedEntity

An authenticator is a person in the role of an assigned entity (AssignedEntity class). An assigned entity is a person assigned to the role by the scoping organization. The entity playing the role is a person (Person class). The entity scoping the role is an organization (Organization class). (See here for a description of "player" and "scoper" role associations.)

Table X: AssignedEntity
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
classCode CS [0..1] ASSIGNED Fixed
id SET<II> [1..*]
code CE [0..1] D:RoleCode Open
addr SET<AD> [0..*]
telecom SET<TEL> [0..*]

AssignedEntity.classCode

The classCode is fixed to "ASSIGNED", which is used in this context to indicate that a person in the employ of an organization was acting as their agent.

Table X: Fixed AssignedEntity.classCode
Code Display Name
ASSIGNED assigned entity
Code System: RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110

AssignedEntity.id

In this context, it is a unique identifier for the person in this Role.

AssignedEntity.code

Identifies the specific kind of Role to which an Role-instance belongs. The AssignedEntity.code is bound to D:RoleCode, which enables any code from the HL7 RoleCode vocabulary.

AssignedEntity.addr

A postal address for the Entity while in the Role.

AssignedEntity.telecom

A telecommunication address for the Entity while in the Role.

5.2.2.1.2 Person

Refer to Person (§ 5.2.2.2.2) as defined for Author participation.

5.2.2.1.3 Organization
Table X: Organization
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
classCode CS [0..1] ORG Fixed
determinerCode CS [0..1] INSTANCE Fixed
id SET<II> [0..*]
name SET<ON> [0..1]
telecom SET<TEL> [0..*]
addr SET<AD> [0..*]
standardIndustryClassCode CE [0..1] D:OrganizationIndustryClass

Organization.classCode With the code fixed to "ORG", it indicates we are referencing an Organization.

Table X: Fixed Organization.classCode
Code Display Name
ORG organization
Code System: EntityClass (HL7) Code System OID: 2.16.840.1.113883.5.41

Organization.determinerCode

The determinerCode is fixed to "INSTANCE", which indicates that the scoping organization referenced, is a specific instance of an organization.

Table X: Fixed Organization.determinerCode
Code Display Name
INSTANCE specific
Code System: EntityDeterminer (HL7) Code System OID: 2.16.840.1.113883.5.30

Organization.id

A unique identifier for the Organization.

Organization.name

A non-unique textual identifier or moniker for the organization.

Organization.telecom

A telecommunication address for the Organization.

Organization.addr

The postal or residential address of an organization.

Organization.standardIndustryClassCode

A code which identifies the industrial category of an organization. In the US Realm, it has been bound to the Code System: North American Industry Classification System [2.16.840.1.113883.6.85] (NAICS). The binding type is Open, so other code system and values sets may be used in the US and other realms. D:OrganizationIndustryClass

5.2.2.1.4 OrganizationPartOf

A scoping organization can be part of a larger organization. Where there is a need to include whole-part relationships, the OrganizationPartOf role can be used. OrganizationPartOf.statusCode indicates the state of the whole-part relationship (e.g. "active", "terminated").

Table X: OrganizationPartOf
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
classCode CS [0..1] PART Fixed
id SET<II> [1..*]
code CE [0..1] D:RoleCode Open
statusCode CS [0..1] V:RoleStatus Closed
effectiveTime IVL<TS > [0..1]


OrganizationPartOf.classCode

Table X: Fixed OrganizationPartOf.classCode
Code Display Name
PART part
Code System: RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110

OrganizationPartOf.id

A unique identifier for the player organization in this Role.

OrganizationPartOf.code

The specific kind of Role to which an Role-instance belongs.

OrganizationPartOf.statusCode

The state of this Role as defined in the state-transition model.

Table X: Value set for OrganizationPartOf.statusCode
V:RoleStatus [2.16.840.1.113883.5.1068] (CLOSED)
Code Display Name Code Display Name
normal normal active active
cancelled cancelled pending pending
suspended suspended terminated terminated
nullified nullified
Code System: RoleStatus (HL7) Code System OID: 2.16.840.1.113883.5.1068

OrganizationPartOf.effectiveTime

The OrganizationPartOf.effectiveTime is an interval of time specifying the period during which the whole-part relationhship is in effect, if such time limit is applicable and known.

5.2.2.2 author

Represents the humans and/or machines that authored the document.

Table X: author
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
typeCode CS [0..1] AUT Fixed
functionCode CE [0..1] D:ParticipationFunction Open
contextControlCode CS [0..1] OP Fixed
time TS [1..1]

author.typeCode

The author.typeCode is fixed to "AUT", used to indicate the party that originates the document and is responsible for the information in the document.

Table X: Fixed author.typeCode
Code Display Name
AUT author
Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90

author.functionCode


The author.functionCode is bound to the concept domain ParticipationFunction, which is used to specify the exact function an actor had in a service in all necessary detail. This domain may include local extensions (Open).

In some cases, the role or function of the author is inherent in the ClinicalDocument.code, such as where ClinicalDocument.code is "Medical Student Progress Note". The role of the author can also be recorded in the Author.functionCode or AssignedAuthor.code attribute. If either of these attributes is included, they should be equivalent to or further specialize the role inherent in the ClinicalDocument.code (such as where the ClinicalDocument.code is simply "Physician Progress Note" and the value of Author.functionCode is "rounding physician"), and shall not conflict with the role inherent in the ClinicalDocument.code, as such a conflict would constitute an ambiguous situation.

author.contextControlCode

The author.contextControlCode is fixed to "OP". It means that the author will replace the set of author participations that have propagated from ancestor Acts, and will itself be the only author to propagate to any child Acts that allow context to be propagated.

Table X: Fixed author.contextControlCode
Code Display Name
OP overriding, propagating
Code System: ContextControl (HL7) Code System OID: 2.16.840.1.113883.5.1057

author.time

The author.time is used to capture the time this specific author contributed content to the document.

5.2.2.2.1 AssignedAuthor

An author is a person in the role of an assigned author (AssignedAuthor class). The entity playing the role is a person (Person class) or a device (AuthoringDevice class). The entity scoping the role is an organization (Organization class), and is the organization from which the document originates.

Table X: AssignedAuthor
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
classCode CS [0..1] ASSIGNED Fixed
id SET<II> [1..*]
code CE [0..1] D:RoleCode Open
addr SET<AD> [0..*]
telecom SET<TEL> [0..*]

AssignedAuthor.classCode

The classCode is fixed to "ASSIGNED", which is used in this context to indicate that a person in the employ of an organization was acting as their agent.

Table X: Fixed AssignedAuthor.classCode
Code Display Name
ASSIGNED assigned entity
Code System: RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110

AssignedAuthor.id

In this context, it is a unique identifier for the person in this Role.

AssignedAuthor.code

Identifies the specific kind of Role to which an Role-instance belongs. The AssignedEntity.code is bound to D:RoleCode, which enables any code from the HL7 RoleCode vocabulary.

AssignedAuthor.addr

A postal address for the Entity while in the Role.

AssignedAuthor.telecom

A telecommunication address for the Entity while in the Role.

5.2.2.2.2 Person @a@

A human being.

Table X: Person
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
classCode CS [0..1] PSN Fixed
determinerCode CS [0..1] INSTANCE Fixed
name SET<PN> [0..*]
desc ED [0..1]
birthTime TS [0..1]

Person.classCode

With the code fixed to "PSN", it indicates we are referencing a Person.

Table X: Fixed Person.classCode
Code Display Name
PSN person
Code System: EntityClass (HL7) Code System OID: 2.16.840.1.113883.5.41

Person.determinerCode

The determinerCode is fixed to "INSTANCE", which indicates that we are dealing with a specific person.

Table X: Fixed Person.determinerCode
Code Display Name
INSTANCE (Fixed) specific
Code System: EntityDeterminer (HL7) Code System OID: 2.16.840.1.113883.5.30

Person.name

The person's name.

Note: The person name data type "PN" supports current, and historical names using validTime, and the specification of different use codes can indicate legal name, tribal name, stage name and others.

Person.desc

A textual or multimedia depiction of the person.

Person.birthTime

The date and time of a person's birth.

5.2.2.2.3 AuthoringDevice
Table X: AuthoringDevice
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
classCode CS [0..1] DEV Fixed
determinerCode CS [0..1] INSTANCE Fixed
code CE [0..1] D:EntityCode
manufacturerModelName SC [0..1] D:ManufacturerModelName
softwareName SC [0..1] D:SoftwareName

AuthoringDevice.classCode

The AuthoringDevice.classCode is fixed to "DEV" indicating that a device was used to generate content in the document.

Table X: Fixed AuthoringDevice.classCode
Code Display Name
DEV role
Code System: EntityClass (HL7) Code System OID: 2.16.840.1.113883.5.41

AuthoringDevice.determinerCode

The determinerCode is fixed to "INSTANCE", which indicates we are referencing a specific device.

Table X: Fixed AuthoringDevice.determinerCode
Code Display Name
INSTANCE specific
Code System: EntityDeterminer (HL7) Code System OID: 2.16.840.1.113883.5.30

AuthoringDevice.code

The AuthoringDevice.code is bound to the EntityCode domain.

AuthoringDevice.manufacturerModelName

Is used to convey a coded name for the device.

AuthoringDevice.softwareName

Is used to convey a coded name for the software used to author content.

5.2.2.2.4 MaintainedEntity (Deprecated)
NOTE: In CDA, Release One, it was possible to specify those individuals responsible for the device. This functionality has been deprecated in CDA, Release Two. The MaintainedEntity class is present for backwards compatibility, and its use is discouraged, except where needed to support the transformation of CDA, Release One documents.
Table X: MaintainedEntity
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
classCode CS [0..1] MNT Fixed
effectiveTime IVL<TS> [0..1]

MaintainedEntity.classCode

With the classCode fixed to "MNT", it indicates that AuthoringDevice is maintained by person assuming responsibility for proper operation, quality, and safety.

Table X: Fixed MaintainedEntity.classCode
Code Display Name
MNT maintained entity
Code System: RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110

MaintainedEntity.effectiveTime

An interval of time specifying the period during which the Role is in effect.

5.2.2.3 custodian

Represents the organization that is in charge of maintaining the document. The custodian is the steward that is entrusted with the care of the document. Every CDA document has exactly one custodian.

The custodian participation satisfies the CDA definition of Stewardship (see What is the CDA (§ 1.1)). Because CDA is an exchange standard and may not represent the original form of the authenticated document, the custodian represents the steward of the original source document.

Table X: custodian
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
typeCode CS [0..1] CST Fixed

custodian.typeCode

The custodian.typeCode is fixed to "CST", which indicates in this instance an organization that is in charge of maintaining this document. Examples: Medical Records Dept in hospital, Health Information Management Dept., etc.

Table X:Fixed custodian.typeCode
Code Display Name
CST custodian
Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90

A custodian is a scoping organization in the role of an assigned custodian (AssignedCustodian class). The steward organization (CustodianOrganization class) is an entity scoping the role of AssignedCustodian, and has a required CustodianOrganization.id.

5.2.2.3.1 AssignedCustodian
Table X: AssignedCustodian
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
classCode CS [0..1] ASSIGNED Fixed

AssignedCustodian.classCode

Table X: Fixed AssignedCustodian.classCode
Code Display Name
ASSIGNED assigned entity
Code System: RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110
5.2.2.3.2 CustodianOrganization
Table X: CustodianOrganization
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
classCode CS [0..1] ORG Fixed
determinerCode CS [0..1] INSTANCE Fixed
id SET<II> [1..*]
name SET<ON> [0..1]
telecom SET<TEL> [0..*]
addr SET<AD> [0..*]

CustodianOrganization.classCode With the code fixed to "ORG", it indicates we are referencing an Organization.

Table X: Fixed CustodianOrganization.classCode
Code Display Name
ORG organization
Code System: EntityClass (HL7) Code System OID: 2.16.840.1.113883.5.41

CustodianOrganization.determinerCode

The determinerCode is fixed to "INSTANCE", which indicates that the scoping organization referenced, is a specific instance of an organization.

Table X: Fixed CustodianOrganization.determinerCode
Code Display Name
INSTANCE specific
Code System: EntityDeterminer (HL7) Code System OID: 2.16.840.1.113883.5.30

CustodianOrganization.id

A unique identifier for the Organization.

CustodianOrganization.name

A non-unique textual identifier or moniker for the organization.

CustodianOrganization.telecom

A telecommunication address for the Organization.

CustodianOrganization.addr

The postal or residential address of an organization.

5.2.2.4 dataEnterer (Transcriptionist)

Represents the participant who has transformed a dictated note into text.

Table X: dataEnterer
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
typeCode CS [0..1] ENT Fixed
contextControlCode CS [0..1] OP Fixed
time TS [1..1]

dataEnterer.typeCode

The dataEnterer.typeCode is fixed to "ENT".

Table X: Fixed dataEnterer.typeCode
Code Display Name
ENT data entry person
Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90

dataEnterer.contextControlCode

The dataEnterer.contextControlCode is fixed to "OP".

Table X: Fixed dataEnterer.contextControlCode
Code Display Name
OP overriding, propagating
Code System: ContextControl (HL7) Code System OID: 2.16.840.1.113883.5.1057

dataEnterer.time

The date and time the data was entered into the originating system.

5.2.2.4.1 AssignedEntity @a@

Refer to AssignedEntity (§ 5.2.2.1.1) as defined for authenticator participation.

5.2.2.5 encounterParticipant

See EncompassingEncounter (§ 5.2.3.5) for a description of the encounterParticipant participant.

5.2.2.6 informant

An informant (or source of information) is a person that provides relevant information, such as the parent of a comatose patient who describes the patient's behavior prior to the onset of coma.

Table X: informant
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
typeCode CS [0..1] INF Fixed
contextControlCode CS [0..1] OP Fixed

informant.typeCode The informant.typeCode is fixed to "INF", which indicates the source of reported information (e.g., a next of kin who answers questions about the patient's history).

Table X: Fixed informant.typeCode
Code Display Name
INF informant
Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90

informant.contextControlCode

The informant.contextControlCode is fixed to "OP". It means that the informant will replace the set of informant participations that have propagated from ancestor Acts, and will itself be the only informant to propagate to any child Acts that allow context to be propagated.

Table X: Fixed informant.contextControlCode
Code Display Name
OP overriding, propagating
Code System: ContextControl (HL7) Code System OID: 2.16.840.1.113883.5.1057

An informant can be a person in one of two roles RelatedEntity or AssignedEntity.

5.2.2.6.1 RelatedEntity

The RelatedEntity role is used to represent an informant without a role.id (e.g. a parent or guy on the street). The informant in this case bears some formal or personal relationship to the patient. The role is unscoped, with the assumption that the patient is always the implied scoper. RelatedEntity.code can be used to specify the nature of the relationship.

Table X: RelatedEntity
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
classCode CS [0..1] v:RoleClassMutualRelationship Closed
code CE [0..1] D:PersonalRelationshipRoleType Open
addr SET<AD> [0..*]
telecom SET<TEL> [0..*]
effectiveTime IVL<TS> [0..1]

RelatedEntity.classCode

Table X: Value set for RelatedEntity.classCode
v:RoleClassMutualRelationship [2.16.840.1.113883.1.11.19316] (CLOSED)
Code Display Name Code Display Name
AFFL affiliate AGNT agent
ASSIGNED assigned entity COMPAR commissioning party
SGNOFF signing authority or officer CON contact
ECON emergency contact NOK next of kin
GUARD guardian CIT citizen
COVPTY covered party CLAIM claimant
NAMED named insured DEPEN dependent
INDIV individual SUBSCR subscriber
PROG program eligible CRINV clinical research investigator
CRSPNSR clinical research sponsor EMP employee
MIL military person GUAR guarantor, GuarantorRole
INVSBJ Investigation Subject CASEBJ Case Subject
RESBJ research subject LIC licensed entity
NOT notary public PROV healthcare provider
PAT patient PAYEE payee
PAYOR invoice payor POLHOLD policy holder
QUAL qualified entity SPNSR coverage sponsor
STD student UNDWRT underwriter
CAREGIVER caregiver PRS personal relationship
Code System: RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110

RelatedEntity.code

The RelatedEntity.code is bound to the PersonalRelationshipRoleType concept domain.

RelatedEntity.addr

The RelatedEntity.addr is used to convey the postal address for the informant.

RelatedEntity.telecom

The RelatedEntity.telecom is used to convey the phone number for the informant.

RelatedEntity.effectiveTime

The RelatedEntity.effectiveTime is used to convey the time period that the role is/was in effect.

5.2.2.6.2 AssignedEntity @b@

The AssignedEntity role is used for an identified informant, and is scoped by an Organization.

Refer to AssignedEntity (§ 5.2.2.1.1) as defined for authenticator participation.

5.2.2.7 informationRecipient


Represents a recipient who should receive a copy of the document.

NOTE: The information recipient is an entity to whom a copy of a document is directed, at the time of document authorship. It is not the same as the cumulative set of persons to whom the document has subsequently been disclosed, over the life-time of the patient. Such a disclosure list would not be contained within the document, and it is outside the scope of CDA.
Table X: informationRecipient
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
typeCode CS [1..1] V:x_InformationRecipient Closed


informationRecipient.typeCode

Two values are available for the informationRecipient.typeCode, the default value is primary information recipient an alternative value is tracker.

Table X: Value set for informationRecipient.typeCode
v:x_InformationRecipient [2.16.840.1.113883.1.11.19366] (CLOSED)
Code Display Name Code Display Name
PRCP (Default) primary information recipient TRC tracker
Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90
5.2.2.7.1 IntendedRecipient

Identifies the person(s), organization or health chart to receive the document.

Table X: IntendedRecipient
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
classCode CS [1..1] V:x_InformationRecipientRole Closed
id SET<II> [1..*]
addr SET<AD> [0..*]
telecom SET<TEL> [0..*]

IntendedRecipient.classCode

Where a person is the intended recipient (IntendedRecipient class), the IntendedRecipient.classCode is valued with "ASSIGNED", and the playing entity is a person (Person class), optionally scoped by an organization (Organization class). Where the intended recipient is an organization, the IntendedRecipient.classCode is valued with "ASSIGNED", and the recipient is reflected by the presence of a scoping Organization, without a playing entity. Where a health chart is the intended recipient, the IntendedRecipient.classCode is valued with "HLTHCHRT" (health chart). In this case there is no playing entity, and an optional scoping organization (Organization class).

Table X: Value set for IntendedRecipient.classCode
V:x_InformationRecipientRole [2.16.840.1.113883.1.11.16772] (CLOSED)
Code Display Name Code Display Name
ASSIGNED (Default) assigned entity HLTHCHRT health chart
Code System: RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110


IntendedRecipient.id

Optional identifier of the intended recipient.

IntendedRecipient.addr

Optional postal address of the intended recipient.

IntendedRecipient.telecom

Optional phone number for the intended recipient.

5.2.2.7.2 Person @b@

Refer to Person (§ 5.2.2.2.2) as defined for Author participation.

5.2.2.7.3 Organization @a@

Refer to organization (§ 5.2.2.1.3) as defined for authenticator participation.

5.2.2.8 legalAuthenticator

Represents the participant(s) who has legally authenticated the document.

authenicator

CDA R2.1, now supports [0..*] legal authentications. This enhancement was put into CDA to support the sharing of medical documents needing to take more than one legal authentication signature.

The CDA is a standard that specifies the structure of exchanged clinical documents. In the case where a local document is transformed into a CDA document for exchange, authentication occurs on the local document, and that fact is reflected in the exchanged CDA document. A CDA document can reflect the unauthenticated, authenticated, or legally authenticated state. The unauthenticated state exists when no authentication information has been recorded (i.e., it is the absence of being either authenticated or legally authenticated).

Both authentication and legal authentication require that a document has been signed manually or electronically by the responsible individual. A legalAuthenticator has a required legalAuthenticator.time indicating the time of authentication, and a required legalAuthenticator.signatureCode, indicating that a signature has been obtained and is on file.

Table X: legalAuthenticator[0..*]
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
typeCode CS [0..1] LA Fixed
contextControlCode CS [0..1] OP Fixed
time TS [1..1]
signatureCode CV [0..1] S Fixed
signatureText ED [0..1]

legalAuthenticator.typeCode

The ClinicalDocument.typeCode is fixed to "LA" to indicate that a participant has legally attested his participation through a signature.

Table X: Fixed legalAuthenticator.typeCode
Code Display Name
AUTHEN authenticator
Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90

legalAuthenticator.contextControlCode


The legalAuthenticator.contextControlCode is fixed to "OP". It means that the legalAuthenticator will propagate to any child Acts that allow context to be propagated.

legalAuthenticator.time

legalAuthenticatorhas a required legalAuthenticator.time indicating the time of authentication.

legalAuthenticator.signatureCode

legalAuthenticatorhas a required legalAuthenticator.signatureCode, indicating that a signature has been obtained and is on file.

Table X: Fixed legalAuthenticator.signatureCode
Code Display Name
S (Fixed) signed
Code System: ParticipationSignature (HL7) Code System OID: 2.16.840.1.113883.5.89

Note: CDA Release One represented either an intended ("X") or actual ("S") legalAuthenticator. CDA Release 2 and 2.1 only represents an actual legalAuthenticator, so only S / Signed can be indicated for the signatureCode.

legalAuthenticator.signatureText

A new attribute, SignatureText has been added to legalAuthenticator. The signature can be represented either inline or by reference according to the ED data type. Typical cases are:

  1. Paper-based signatures: the ED data type may refer to a document or other resource that can be retrieved through an electronic interface to a hardcopy archive.
  2. Electronic signature: this attribute can represent virtually any electronic signature scheme.
  3. Digital signature: this attribute can represent digital signatures by reference to a signature data block that is constructed in accordance to a digital signature standard, such as XML-DSIG, PKCS#7, PGP, etc.
Table X: Fixed legalAuthenticator.contextControlCode
Code Display Name
OP overriding, propagating
Code System: ContextControl (HL7) Code System OID: 2.16.840.1.113883.5.1057

A legalAuthenticator is a person in the role of an assigned entity (AssignedEntity class). An assigned entity is a person assigned to the role by the scoping organization. The entity playing the role is a person (Person class). The entity scoping the role is an organization (Organization class).

5.2.2.8.1 AssignedEntity @c@

Refer to AssignedEntity (§ 5.2.2.1.1) as defined for authenticator participation.

5.2.2.8.2 Person @c@

Refer to Person (§ 5.2.2.2.2) as defined for Author participation.

5.2.2.8.3 Organization @b@

Refer to Organization (§ 5.2.2.1.3) as defined for authenticator participation.

5.2.2.8.4 OrganizationPartOf @a@

Refer to OrganizationPartOf (§ 5.2.2.1.4) as defined for authenticator participation.

5.2.2.9 participant

Table X: participant
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
typeCode CS [0..1] ParticipationType Fixed
functionCode CE [0..1] D:ParticipationFunction Open
contextControlCode CS [0..1] OP Fixed
time TS [1..1]

participant.typeCode

The participant.typeCode is can be any code defined in the ParticipationType domain. Which can be used to represent other participants not explicitly mentioned by other classes, that were somehow involved in the documented acts.

Table X: Value set for participant.typeCode
v:ParticipationType [2.16.840.1.113883.1.11.10901] (CLOSED)
Code Display Name Code Display Name
ATND attender ADM admitter
CALLBCK callback contact CON consultant
DIS discharger ESC escort
REF referrer TRANS Transcriber
ENT data entry person WIT witness
CST custodian DIR direct target
BBY baby DEV device
NRD non-reuseable device RDV reusable device
EXPAGNT ExposureAgent EXPART ExposureParticipation
EXPTRGT ExposureTarget EXSRC ExposureSource
IND indirect target BEN beneficiary
CAGNT causative agent COV coverage target
GUAR guarantor party HLD holder
DON donor RCV receiver
IRCP information recipient NOT ugent notification contact
PRCP primary information recipient REFB Referred By
REFT Referred to TRC tracker
LOC location DST destination
ELOC entry location ORG origin
RML remote VIA via
RESP responsible party VRF verifier
AUTHEN authenticator PART Participation
Use the following participations, only if the other participations provided in CDA will not work
RCT record target AUT author (originator)
INF informant CSM consumable
PRD product SBJ subject
SPC specimen PRF performer
DIST distributor PPRF primary performer
SPRF secondary performer LA legal authenticator
Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90

participant.functionCode

The participant.functionCode is bound to the concept domain ParticipationFunction, which is used to specify the exact function an actor had in a service in all necessary detail. This domain may include local extensions (Open).

participant.contextControlCode

The participant.contextControlCode is fixed to "OP". It means that the participantType code specified in participant.typeCode will replace the set of author participations that have propagated from ancestor Acts, and will itself be the only author to propagate to any child Acts that allow context to be propagated.

Table X: Fixed participant.contextControlCode
Code Display Name
OP (Fixed) overriding, propagating
Code System: ContextControl (HL7) Code System OID: 2.16.840.1.113883.5.1057

participant.typeCode.time

The participant.typeCode.time is the date and time the specific participation occurred.

5.2.2.9.1 AssociatedEntity

A participant is a person or organization in the role of a participating entity (AssociatedEntity class). The entity playing the role is a person (Person class). The entity scoping the role is an organization (Organization class).

Table X: AssociatedEntity
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
classCode CS [1..1] V:RoleClassAssociative Closed
id SET<II> [0..*]
code CE [0..1] D:RoleCode Open
addr SET<AD> [0..*]
telecom SET<TEL> [0..*]

AssociatedEntity.classCode

When the participating entity is an organization, this is reflected by the presence of a scoping Organization, without a playing entity. Otherwise, the participating entity is considered a person with or without a scoping Organization.

Table X: Value set for ParticipatingEntity.classCode
V:RoleClassAssociative [2.16.840.1.113883.1.11.19313] (CLOSED)
Code Display Name Code Display Name
ROL (Default) role AFFL affiliate
AGNT agent ASSIGNED assigned entity
COMPAR commissioning party SGNOFF signing authority or officer
CON contact ECON emergency contact
NOK next of kin GUARD guardian
CIT citizen COVPTY covered party
CLAIM claimant NAMED named insured
DEPEN dependent INDIV individual
SUBSCR subscriber PROG program eligible
CRINV clinical research investigator CRSPNSR clinical research sponsor
EMP employee MIL military person
GUAR guarantor INVSBJ Investigation Subject
CASEBJ Case Subject RESBJ research subject
LIC licensed entity NOT notary public
PROV healthcare provider PAT patient
PAYEE payee PAYOR invoice payor
POLHOLD policy holder QUAL qualified entity
SPNSR underwriter STD student
UNDWRT coverage sponsor CAREGIVER caregiver
PRS personal relationship ACCESS access
ADMM Administerable Material BIRTHPL birthplace
DEATHPLC place of death DST distributed material
RET retailed material EXPR exposed entity
HLD held entity HLTHCHRT health chart
IDENT identified entity MANU manufactured product
THER therapeutic agent MNT maintained entity
OWN owned entity RGPR regulated product
SDLOC service delivery location DSDLOC dedicated service delivery location, health care facility
ISDLOC incidental service delivery location TERR territory of authority
USED used entity WRTE warranted product
Code System: RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110

AssociatedEntity.id

An identifier for the associate person (when present) or the organization.

AssociatedEntity.code

An optional role code taken from the RoleCode concept domain. This binding is open so other code systems can be used.

AssociatedEntity.addr

The postal address for the associate person (when present) or the organization.

AssociatedEntity.telecom

The phone number for the associated person (when present) or the organization.

5.2.2.9.2 Person @d@

Refer to Person (§ 5.2.2.2.2) as defined for Author participation.

5.2.2.9.3 Organization @c@

Refer to Organization (§ 5.2.2.1.3) as defined for authenticator participation.

5.2.2.10 performer

See ServiceEvent (§ 5.2.3.2.2) for a description of the performer participant.

5.2.2.11 recordTarget

The recordTarget identifies the specified patient's medical record that the document belongs to.

A clinical document typically has exactly one recordTarget participant. In the uncommon case where a clinical document (such as a group encounter note) is placed into more than one patient chart, more than one recordTarget participant can be stated.

Note: The recordTarget(s) of a document are stated in the header and propagate to nested content, where they cannot be overridden. However, the patient(s) specified by the recordTarget are assumed to be the default subjects of the clinical document. Unlike the recordTarget, which can not be overridden, the patients or subjects propagate to nested components, and can be overridden at the section or entry level. (see See CDA Context (§ 5.4)).

Table X: recordTarget
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
typeCode CS [0..1] RCT Fixed
contextControlCode CS [0..1] OP Fixed

recordTarget.typeCode

The recordTarget.typeCode is fixed to "RCT" and indicates that this is a record target participation.

Table X: Fixed recordTarget.typeCode
Code Display Name
RCT record target
Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90

recordTarget.contextControlCode

The recordTarget.contextControlCode is fixed to "OP". It means that the recordTarget identified in the header will propagate to any child Acts that allow context to be propagated.

Table X: Fixed recordTarget.contextControlCode
Code Display Name
OP overriding, propagating
Code System: ContextControl (HL7) Code System OID: 2.16.840.1.113883.5.1057

A recordTarget is represented as a relationship between a person and an organization, where the person is in a patient role (PatientRole class). The entity playing the role is a patient (Patient class). The entity scoping the role is an organization (Organization class). A patient is uniquely identified via the PatientRole.id attribute.

5.2.2.11.1 PatientRole
Table X: PatientRole
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
classCode CS [0..1] PAT Fixed
id SET<II> [1..*]
addr SET<AD> [0..*]
telecom SET<TEL> [0..*]

PatientRole.classCode

The PatientRole.classCode is fixed to "PAT" to indicate a person (Patient) as a recipient of health care services from a healthcare provider.

Table X: Fixed PatientRole.classCode
Code Display Name
PAT patient
Code System: RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110

PatientRole.id

A unique identifier for the person in this patient role.

PatientRole.addr

The postal address for the Patient.

PatientRole.telecom

The phone number for the Patient.

5.2.2.11.2 Patient
Table X: Patient
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
classCode CS [0..1] PSN Fixed
determinerCode CS [0..1] INSTANCE Fixed
id (Deprecated) SET<II> [0..*]
name SET<PN> [0..*]
desc ED [0..1]
administrativeGenderCode CE [0..1] D:administrativeGender Open
birthTime TS [0..1]
deceasedInd BL [0..1]
deceasedTime TS [0..1]
multipleBirthInd BL [0..1]
multipleBirthOrderNumber INT [0..1]
maritalStatusCode CE [0..1] D:MaritalStatus Open
religiousAffiliationCode CE [0..1] D:ReligousAffiliation Open
raceCode SET<CE> [0..*] D:Race Open
ethnicGroupCode SET<CE> [0..*] D:Ethnicity Open

Note: Not all Patient elements defined in the RIM have been added to CDA's Patient class. Only those originally defined, or added using extensions within actual implementation guides have been included in CDA R2.1. Implementers are free to use extensions with CDA R2.1 or model missing information using the Observation class within the CDA body.

Patient.classCode

The Patient.classCode is fixed to "PSN", indicating that the entity is a person.

Table X: Fixed Patient.classCode
Code Display Name
PSN person
Code System: EntityClass (HL7) Code System OID: 2.16.840.1.113883.5.41

Patient.determinerCode

The determinerCode is fixed to "INSTANCE", which indicates a specific person is a patient.

Table X: Fixed Patient.determinerCode
Code Display Name
INSTANCE specific
Code System: EntityDeterminer (HL7) Code System OID: 2.16.840.1.113883.5.30

Patient.id (Deprecated)

CDA Release 1.0 allowed for additional person identifiers, corresponding to the Patient.id attribute in CDA Release 2.1. This attribute is included for backwards compatibility and has been deprecated because having two different ways to identify a patient can result in inconsistent usage. Further use of Patient.id is discouraged.

Patient.name

The patient's name.

Note: The person name data type "PN" supports current, and historical names using validTime, and the specification of different use codes can indicate legal name, tribal name, stage name and others.

Patient.desc

A textual or multimedia depiction of the patient.

Patient.administrativeGenderCode

The gender (i.e., the behavioral, cultural, or psychological traits typically associated with one sex) of a living subject as defined for administrative purposes.

Patient.birthTime

The date and time of the patient's birth.

Patient.deceasedInd

An indication that the subject is dead.

Patient.deceasedTime

The date and time that the patient's death occurred.

Note: If the deceasedTime is valued, then the deceasedInd SHALL be set true. If deceasedInd is set true, the deceasedTime should be valued, if known.

Patient.multipleBirthInd

An indication as to whether the patient was part of a multiple birth.

Patient.multipleBirthOrderNumber

The order within a multiple birth in which this patient was born.

Patient.maritalStatusCode

The domestic partnership status of the patient.

Patient.religiousAffiliationCode

The primary religious preference of the patient.

Patient.raceCode

The race of the patient.

Note: More than one race code is now supported in CDA R2.1.

Patient.ethnicGroupCode

The ethnic group of the patient.

Note: More than one ethnic group is now supported in CDA R2.1.

Note: See 2.7 Backwards and Forwards Compatibility, for discussion on sdtc: extensions defined for CDA R2.0 and CDA R2.1.

5.2.2.11.3 Organization @d@

The optional Organization in recordTarget identifies the Patient's healthcare organization. Refer to Organization (§ 5.2.2.1.3) as defined for authenticator participation for details.

5.2.2.11.4 LanguageCommunication

A patient's language communication skills can be expressed in the associated LanguageCommunication class.

Table X: LanguageCommunication
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
languageCode CS [0..1] D:HumanLanguage Open
modeCode CE [0..1] D:LanguageAbilityMode Open
proficiencyLevelCode CE [0..1] D:LanguageAbilityProficiency Open
preferenceInd BL [0..1]

LanguageCommunication.languageCode

A language for which the patient has some level of proficiency for communication.
Note: Providing a language reference with the LanguageCommunication.languageCode is recommended, when using this class.

LanguageCommunication.modeCode

The method of expression of the language, e.g. expressed spoken, expressed written, expressed signed, received spoken, received written, received signed

LanguageCommunication.proficiencyLevelCode

The level of proficiency the patient has in a particular language, e.g. excellent, good, fair, poor

LanguageCommunication.preferenceInd

An indicator specifying whether the language is preferred by the patient for the associated mode.

5.2.2.11.5 Birthplace

A Patient's birthplace is represented as a relationship between a patient and a place. The Birthplace class is played by a place (Place class), and scoped by the patient (Patient class).

Table X: Birthplace
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
classCode CS [0..1] BIRTHPL Fixed

Birthplace.classCode

The Birthplace.classCode it fixed to "BIRTHPL" indicating in this context, that the Place referenced is the birth place of the patient.

Table X: Fixed Birthplace.classCode
Code Display Name
BIRTHPL birthplace
Code System: RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110
5.2.2.11.6 Place
Table X: Place
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
classCode CS [0..1] PLC Fixed
determinerCode CS [0..1] INSTANCE Fixed
name SET<ON> [0..1]
addr SET<AD> [0..*]

Place.classCode

A physical place or site with its containing structure. May be natural or man-made. The geographic position of a place may or may not be constant.

Table X: Fixed Place.classCode
Code Display Name
PLC place
Code System: EntityClass (HL7) Code System OID: 2.16.840.1.113883.5.41

Place.determinerCode


The determinerCode is fixed to "INSTANCE", which indicates a specific place is being identified.

Table X: Fixed Place.determinerCode
Code Display Name
INSTANCE specific
Code System: EntityDeterminer (HL7) Code System OID: 2.16.840.1.113883.5.30

Place.name

The name of place of birth (E.g. Queen Mary)

Place.addr

The postal address for the patient's birthplace.

5.2.2.11.7 Guardian

A patient's guardian is a person or organization in the role of guardian (Guardian class). The entity playing the role of guardian is a person (Person class) or organization (Organization class). The entity scoping the role is the patient (Patient class).

Where a guardian is not explicitly stated, the value should default to local business practice (e.g. the patient makes their own health care decisions unless incapacitated in which case healthcare decisions are made by the patient's spouse).

Table X: Guardian
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
classCode CS [1..1] GUARD Fixed
id SET<II> [0..*]
code CE [0..1] D:RoleCode Open
addr SET<AD> [0..*]
telecom SET<TEL> [0..*]

Guardian.classCode

The Guardian.classCode is fixed to "GUARD", indicating that the associated person or institution are legally empowered with responsibility for the care of a ward.

Table X: Fixed Guardian.classCode
Code Display Name
GUARD guardian
Code System: RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110

Guardian.code

An optional role code taken from the RoleCode concept domain. This binding is open so other code systems can be used.

Guardian.addr

The guardian's postal address.

Guardian.telecom

The guardian's phone number.

5.2.2.11.8 Person @e@

Refer to Person (§ 5.2.2.2.2) as defined for Author participation.

5.2.2.11.9 Organization @e@

Refer to organization (§ 5.2.2.1.3) as defined for authenticator participation.

5.2.2.12 responsibleParty

See EncompassingEncounter (§ 5.2.3.5) for a description of the responsibleParty participant.

5.2.2.13 Participant Scenarios

Several CDA Header participations can be played by the same person. In such cases, the person should be identified as the player for each appropriate participation. For instance, if a person is both the author and the authenticator of a document, the CDA Header should identify that person as both the author participant and the authenticator participant.

On other occasions, CDA Header participants are played by different people. The following table shows a number of scenarios and the values for various participants.

Table X: CDA participation scenarios
1. StaffPhysicianOne sees a patient as a consultant, dictates a note, and later signs it.
  • Author — StaffPhysicianOne
  • Encounter Participant — StaffPhysicianOne (typeCode="CONS")
  • Legal Authenticator — StaffPhysicianOne
2. StaffPhysicianOne sees a patient and dictates a note. StaffPhysicianTwo later signs the note.†
  • Author — StaffPhysicianOne
  • Legal Authenticator — StaffPhysicianTwo
3. ResidentOne sees a patient with StaffPhysicianOne. ResidentOne dictates a note and later signs it. The note is co-signed by StaffPhysicianOne.†
  • Author — ResidentOne
  • Authenticator — ResidentOne
  • Encounter Participant — StaffPhysicianOne (typeCode="ATND")
  • Legal Authenticator — StaffPhysicianOne
4. ResidentOne sees a patient with StaffPhysicianOne. ResidentOne dictates a note and later signs it. The note is co-signed by StaffPhysicianTwo.†
  • Author — ResidentOne
  • Authenticator — ResidentOne
  • Encounter Participant — StaffPhysicianOne (typeCode="ATND")
  • Legal Authenticator — StaffPhysicianTwo
5. ResidentOne sees a patient with StaffPhysicianOne. ResidentOne dictates a note, and goes off on vacation. The note is signed by ResidentTwo and by StaffPhysicianOne.†
  • Author — ResidentOne
  • Authenticator — ResidentTwo
  • Encounter Participant — StaffPhysicianOne (typeCode="ATND")
  • Legal Authenticator — StaffPhysicianOne
6. ResidentOne sees a patient with StaffPhysicianOne. ResidentOne dictates a note, which is later signed by ResidentTwo and StaffPhysicianTwo.†
  • Author — ResidentOne
  • Authenticator — ResidentTwo
  • Encounter Participant — StaffPhysicianOne (typeCode="ATND")
  • Legal Authenticator — StaffPhysicianTwo
7. StaffPhysicianOne receives an abnormal laboratory result, attempts to contact patient but can't, and writes and signs a progress note.
  • Author — StaffPhysicianOne
  • Legal Authenticator — StaffPhysicianOne
8. ResidentSurgeonOne is operating on a patient with StaffSurgeonOne. StaffSurgeonOne dictates an operative report and later signs it.
  • Author — StaffSurgeonOne
  • Authenticator — null (need not be included)
  • Legal Authenticator — StaffSurgeonOne
  • Performer — StaffSurgeonOne (typeCode="PPRF")
  • Performer — ResidentSurgeonOne (typeCode="SPRF")
9. In Austria, a PET-CT report, is authored and legally authenticated by a radiologist together with a nuclear medicine specialist. The two specialists are working for different medical institutes. Their work and expertise are equal in importance.
  • Author — Radiologist
  • Author — Nuclear Medicine Specialist
  • Legal Authenticator — Radiologist
  • Legal Authenticator — Nuclear Medicine Specialist

† Note that the ability of one clinician to co-sign or to sign on behalf of another clinician is subject to regulatory and local practice constraints.

5.2.3 Header Relationships

This section describes classes related to the root ClinicalDocument class via an ActRelationship.

5.2.3.1 ParentDocument

The ParentDocument represents the source of a document revision, addenda, or transformation.

5.2.3.1.1 relatedDocument

The optional relatedDocument class is used to associate a ClinicalDocument to a ParentDocument.

Table X: relatedDocument Attributes
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
typeCode CS [1..1] x_ActRelationshipDocument Closed
inversionInd BL [0..1]

relatedDocument.typeCode

Allowable values for the intervening relatedDocument.typeCode are shown in the following table.

Table X: Value set for relatedDocument.typeCode
v:x_ActRelationshipDocument [2.16.840.1.113883.1.11.11610] (CLOSED)
Code Display Name Code Display Name
APND is appendage RPLC replaces
XFRM transformation
Code System: ActRelationshipType (HL7) Code System OID: 2.16.840.1.113883.5.1002

A conformant CDA document can have a single relatedDocument with typeCode "APND"; a single relatedDocument with typeCode "RPLC"; a single relatedDocument with typeCode "XFRM"; a combination of two relatedDocuments with typeCodes "XFRM" and "RPLC"; or a combination of two relatedDocuments with typeCodes "XFRM" and "APND". No other combinations are allowed.

relatedDocument.inversionInd

Technical note: CDA R2.0 design assumes that ClinicalDocument was the source for all typecodes found in relatedDocument, ("APND", "RPLC" and "XFRM"). For "APND" and "RPLC" this is correct, however for "XFRM", the RIM definition indicates that "it is used when the target Act is a transformation of the source Act...". This technically is an error in CDA R2.0's design, which normally should have required the use of inversionInd to establish the ClinicalDocument as the target and the ParentDocument as the source for the "XFRM" relation.

As a result, in CDA R2.1 when "XFRM" is assigned to the relatedDocument.typeCode, the associated inversionInd will be assumed to be fixed to true, but will not be required to be present in the instance document. In all other cases, "APND", "RPLC" the associated inversionInd will not be present and will be assumed to be false. This enables wire format compatibility between CDA R2.0 and CDA R2.1, and ensures proper interpretation of the "XFRM" ActRelationshipType code.

5.2.3.1.2 ParentDocument

The ParentDocument identifies and optionally provides a reference to the original document serving as the source for the current document revision, addendum or transformation.

Table X: ParentDocument Attributes
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
classCode CS [0..1] DOCCLIN Fixed
moodCode CS [0..1] EVN Fixed
typeId II [1..1]
id II [1..*]
code CE [1..1] D:DocumentType Open
text ED [0..1]
setId II [0..1]
versionNumber ST [0..1]

ParentDocument.classCode

The ParentDocument.classCode is fixed to "DOCCLIN".

Table X: Fixed ParentDocument.classCode
Code Display Name
DOCCLIN clinical document
Code System: ActClass (HL7) Code System OID: 2.16.840.1.113883.5.6

ParentDocument.moodCode

The ParentDocument.moodCode is fixed to "EVN".

Table X: Fixed ParentDocument.moodCode
Code Display Name
EVN event
Code System: ActMood (HL7) Code System OID: 2.16.840.1.113883.5.1001

ParentDocument.id

The ParentDocument.id is a required identifier, which uniquely identifies the parent document.

ParentDocument.code

The code specifying the particular kind of document (e.g. History and Physical, Discharge Summary, Progress Note). The value set is drawn from LOINC, and has a CWE coding strength.

ParentDocument.text

ParentDocument.text is modeled as an ED data type - allowing for the expression of the MIME type of the parent document. It is not to be used to embed the related document, and thus ParentDocument.text.BIN is precluded from use.

ParentDocument.setId

Optional setID for the parent document.

ParentDocument.versionNumber

Optional versionNumber of the parent document.

Additional Information on Document Identification, Revisions, and Addenda

A clinical document can be replaced by a new document and/or appended with an addendum.

A replacement document is a new version of the parent document. The parent document is considered superseded, but a system may retain it for historical or auditing purposes. The parent document being replaced is referenced via act relationship relatedDocument, where relatedDocument.typeCode is set to equal "RPLC" (for "replaces"). An example is a report found to contain an error that is subsequently replaced by the corrected report.

An addendum is a separate document that references the parent document, and may extend or alter the observations in the prior document. The parent document remains a current component of the patient record, and the addendum and its parent are both read by report recipients. The parent report (represented by the ParentDocument class) being appended is referenced via act relationship relatedDocument, where relatedDocument.typeCode is set to equal "APND" (for "appends").

Every CDA document must have a unique ClinicalDocument.id, and thus the replacement or addendum documents each have ClinicalDocument.id that is different from that of the parent document.

CDA documents may also contain a ClinicalDocument.setId and a ClinicalDocument.versionNumber, which together support a document identification and versioning scheme used in some document management systems. In this scheme, all documents in a chain of replacements have the same ClinicalDocument.setId and are distinguished by an incrementing ClinicalDocument.versionNumber. The initial version of a document gets, in addition to a new unique value for ClinicalDocument.id, a new value for ClinicalDocument.setId, and has the value of ClinicalDocument.versionNumber set to equal "1". A replacement document gets a new globally unique ClinicalDocument.id value, and uses the same value for ClinicalDocument.setId as the parent report being replaced, and increments the value of ClinicalDocument.versionNumber by 1. (Note that version number must be incremented by one when a report is replaced, but can also be incremented more often to meet local requirements.)

These relationships are illustrated in the following exhibit "Document Identification, Revisions, and Addenda Scenarios". Typical scenarios are:

  • A simple relacement (e.g. ClinicalDocument.id "1.2.345.6789.266" replacing ClinicalDocument.id "1.2.345.6789.123")
  • A simple append (e.g. ClinicalDocument.id "1.2.345.6789.456" appends ClinicalDocument.id "1.2.345.6789.123").

More complex scenarios that might be anticipated include:

[1] replacement of an addendum (e.g. ClinicalDocument.id "1.2.345.6789.224" replaces ClinicalDocument.id "1.2.345.6789.456", which itself is an addendum to ClinicalDocument.id "1.2.345.6789.123") - expected behavior would be to render the replacement as the addendum (e.g. render ClinicalDocument.id "1.2.345.6789.224" as the addendum to ClinicalDocument.id "1.2.345.6789.123");

[2] addendum to a replaced document (e.g. ClinicalDocument.id "1.2.345.6789.456" appends ClinicalDocument.id "1.2.345.6789.123", which has been replaced by ClinicalDocument.id "1.2.345.6789.266") - expected behavior would be to render the addendum along with the replacement (e.g. render ClinicalDocument.id "1.2.345.6789.456" as an addendum to ClinicalDocument.id "1.2.345.6789.266").

Document transformations

A CDA document can be a transformation from some other format, meaning that it has undergone a machine translation from some other format (such as DICOM SR). In this case, relatedDocument.typeCode should be set to "XFRM".

A proper transformation must ensure that the human readable clinical content of the report is not impacted. Local business rules determine whether or not a transformed report replaces the source, but typically this would not be the case. If it is, an additional relationship of type "RPLC" is to be used. The "XFRM" relationship can also be used when translating a document in a local format into CDA for the purpose of exchange. In this case, the target of the "XFRM" relationship is the local document identifier.

5.2.3.2 ServiceEvent

The ServiceEvent is used to represent the main activity being documented. It may used to represent a specific procedure, such as a colonoscopy, an appendectomy, or other clinical activity. When the ClinicalDocument represents a summary of care, the ServiceEvent.code can be set to "PCPR" to indicate the service is care provisioning.

5.2.3.2.1 documentationOf

The optional documentationOf class is used to associate a ClinicalDocument to a ServiceEvent.

Table X: documentationOf Attributes
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
typeCode CS [0..1] DOC Fixed

documentationOf.typeCode

The documentationOf.typeCode is fixed to "DOC" which indicates that the ClinicalDocument provides documentation is about ServiceEvent.

Table X: Fixed documentationOf.typeCode
Code Display Name
DOC documents
Code System: ActRelationshipType (HL7) Code System OID: 2.16.840.1.113883.5.1002
5.2.3.2.2 ServiceEvent

In some cases, the ServiceEvent is inherent in the ClinicalDocument.code, such as where ClinicalDocument.code is "History and Physical Report" and the procedure being documented is a "History and Physical". A ServiceEvent can further specialize the act inherent in the ClinicalDocument.code, such as where the ClinicalDocument.code is simply "Procedure Report" and the procedure was a "colonoscopy". If ServiceEvent is included, it must be equivalent to or further specialize the value inherent in the ClinicalDocument.code, and shall not conflict with the value inherent in the ClinicalDocument.code, as such a conflict would constitute an ambiguous situation.

Table X: ServiceEvent Attributes
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
classCode CS [0..1] V:ActClassRoot Fixed
moodCode CS [0..1] EVN Fixed
id II [0..*]
code CD [0..1] D:ActCode Open
statusCode CS [0..1] D:ActStatus Closed
effectiveTime IVL<TS> [0..1]

ServiceEvent.classCode

The ServiceEvent.classCode identifies the RIM Act class code of the service event instance.

Table X: Value set for ServiceEvent.classCode
V:ActClassRoot [2.16.840.1.113883.1.11.13856] (CLOSED)
Code Display Name Code Display Name
ACT (Default) act COMPOSITION composition, Attestable unit
DOC document DOCCLIN clinical document
CDALVLONE CDA Level One clinical document CONTAINER record container
CATEGORY category DOCBODY document body
DOCSECT document section, Section TOPIC topic
EXTRACT extract EHR electronic health record
FOLDER folder GROUPER grouper
CLUSTER Cluster ACCM accommodation
ACCT account ACSN accession
ADJUD financial adjudication, financial adjudication results CACT control act
ACTN action INFO information
STC state transition control CNTRCT contract
FCNTRCT financial contract COV coverage
CONS consent CONTREG container registration
CTTEVENT clinical trial timepoint event DISPACT disciplinary action
EXPOS exposure AEXPOS acquisition exposure
TEXPOS transmission exposure INC incident
INFRM inform INVE invoice element
LIST working list MPROT monitoring program
OBS Observation ALRT detected issue
BATTERY battery CLNTRL clinical trial
CONC concern COND Condition
CASE public health case OUTB outbreak
DGIMG diagnostic image GEN genomic observation
DETPOL determinant peptide EXP expression level
LOC locus PHN phenotype
POL polypeptide SEQ bio sequence
SEQVAR bio sequence variation INVSTG investigation
OBSSER observation series OBSCOR correlated observation sequences
POS position POSACC position accuracy
POSCOORD position coordinate SPCOBS specimen observation
VERIF Verification ROIBND bounded ROI
ROIOVL overlay ROI PCPR care provision
ENC encounter POLICY policy
JURISPOL jurisdictional policy ORGPOL organizational policy
SCOPOL scope of practice policy STDPOL standard of practice policy
PROC procedure SBEXT Substance Extraction
SPECCOLLECT Specimen Collection SBADM substance administration
REG registration REV review
SPCTRT specimen treatment SPLY supply
DIET diet STORE storage
SUBST Substitution TRFR transfer
TRNS transportation XACT financial transaction
CNOD (Deprecated) Condition Node LLD (Deprecated) left lateral decubitus
PRN (Deprecated) prone RLD (Deprecated) right lateral decubitus
SFWL (Deprecated) Semi-Fowler's SIT (Deprecated) sitting
STN (Deprecated) standing SUP (Deprecated) supine
RTRD (Deprecated) reverse trendelenburg TRD (Deprecated) trendelenburg
Code System: ActClass (HL7) Code System OID: 2.16.840.1.113883.5.6

ServiceEvent.moodCode

The ServiceEvent.moodCode is fixed to "EVN", which indicates documentation of a past service.

Table X: Fixed ServiceEvent.moodCode
Code Display Name
EVN event
Code System: ActMood (HL7) Code System OID: 2.16.840.1.113883.5.1001

ServiceEvent.id

The optional unique identifier for the ServiceEvent.

ServiceEvent.code

The particular kind of service event that the this instance represents within its class code. The ServiceEvent.code is bound to the D:ActCode concept domain.

ServiceEvent.statusCode

The ServiceEvent.statusCode can take on any of the values defined in the D:ActStatus domain.

ServiceEvent.effectiveTime

ServiceEvent.effectiveTime can be used to indicate the time the actual event (as opposed to the encounter surrounding the event) took place.

5.2.3.2.3 performer @a@

The performer participant represents clinicians who actually and principally carry out the ServiceEvent.

Table X: performer
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
typeCode CS [1..1] x_ServiceEventPerformer Closed
functionCode CE [0..1] D:ParticipationFunction Open
time TS [1..1]

performer.typeCode

Allows for the optional identification of performers, primary performers and secondary performers.

Table X: Value set for performer.typeCode
v:x_ServiceEventPerformer [2.16.840.1.113883.1.11.19601] (CLOSED)
Code Display Name Code Display Name
PRF performer PPRF primary performer
SPRF secondary performer
Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90

performer.functionCode

Performer.functionCode can be used to specify addition detail about the function of the performer (e.g. scrub nurse, third assistant). The functionCode is bound to the D:ParticipationFunction concept domain.

performer.time

Performer.time can be used to specify the time during which the performer is involved in the activity.

5.2.3.2.4 AssignedEntity @d@

A performer is an entity in the role of assigned entity (see AssignedEntity (§ 5.2.2.1.1)).

5.2.3.2.5 Person @f@

An assigned entity is a person assigned to the role by the scoping organization (see Person (§ 6.2.2.2.2)).

5.2.3.2.6 Organization @f@

The entity scoping the role is an organization (see Organization (§ 5.2.2.1.3)).

5.2.3.3 Order

This class represents those requests that are fulfilled by this document. For instance, a provider orders an X-Ray. The X-Ray is performed. A radiologist reads the X-Ray and generates a report. The X-Ray order identifier is transmitted in the Order class, the performed X-Ray procedure is transmitted in the ServiceEvent class, and the ClinicalDocument.code would be valued with "Diagnostic Imaging Report".

5.2.3.3.1 inFullfillmentOf

The optional inFullfillmentOf class is used to associate a ClinicalDocument to an Order.

Table X: Fixed InFulfillmentOf.typeCode
Code Display Name
FLFS fulfills
Code System: ActRelationshipType (HL7) Code System OID: 2.16.840.1.113883.5.1002
5.2.3.3.2 Order

A reference to the fulfilled order.

Table X: Order Attributes
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
classCode CS [0..1] V:ActClassRoot Closed
moodCode CS [0..1] RQO Fixed
id II [1..*]
code CD [0..1] D:ActCode Open
priorityCode CS [0..1] V:ActPriority Open

Order.classCode

The Order.classCode identifies the RIM Act class code of the order instance.

Table X: Value set for Order.classCode
V:ActClassRoot [2.16.840.1.113883.1.11.13856] (CLOSED)
Code Display Name Code Display Name
ACT (Default) act COMPOSITION composition, Attestable unit
DOC document DOCCLIN clinical document
CDALVLONE CDA Level One clinical document CONTAINER record container
CATEGORY category DOCBODY document body
CATEGORY document section, Section TOPIC topic
EXTRACT extract EHR electronic health record
FOLDER folder GROUPER grouper
CLUSTER Cluster ACCM accommodation
ACCT account ACSN accession
ADJUD financial adjudication, financial adjudication results CACT control act
ACTN action INFO information
STC state transition control CNTRCT contract
FCNTRCT financial contract COV coverage
CONS consent CONTREG container registration
CTTEVENT clinical trial timepoint event DISPACT disciplinary action
EXPOS exposure AEXPOS acquisition exposure
TEXPOS transmission exposure INC incident
INFRM inform INVE invoice element
LIST working list MPROT monitoring program
OBS Observation ALRT detected issue
BATTERY battery CLNTRL clinical trial
CONC concern COND Condition
CASE public health case OUTB outbreak
DGIMG diagnostic image GEN genomic observation
DETPOL determinant peptide EXP expression level
LOC locus PHN phenotype
POL polypeptide SEQ bio sequence
SEQVAR bio sequence variation INVSTG investigation
OBSSER observation series OBSCOR correlated observation sequences
POS position POSACC position accuracy
POSCOORD position coordinate SPCOBS specimen observation
VERIF Verification ROIBND bounded ROI
ROIOVL overlay ROI PCPR care provision
ENC encounter POLICY policy
JURISPOL jurisdictional policy ORGPOL organizational policy
SCOPOL scope of practice policy STDPOL standard of practice policy
PROC procedure SBEXT Substance Extraction
SPECCOLLECT Specimen Collection SBADM substance administration
REG registration REV review
SPCTRT specimen treatment SPLY supply
DIET diet STORE storage
SUBST Substitution TRFR transfer
TRNS transportation XACT financial transaction
CNOD (Deprecated) Condition Node LLD (Deprecated) left lateral decubitus
PRN (Deprecated) prone RLD (Deprecated) right lateral decubitus
SFWL (Deprecated) Semi-Fowler's SIT (Deprecated) sitting
STN (Deprecated) standing SUP (Deprecated) supine
RTRD (Deprecated) reverse trendelenburg TRD (Deprecated) trendelenburg
Code System: ActClass (HL7) Code System OID: 2.16.840.1.113883.5.6

Order.moodCode

The Order.moodCode is fixed to "RQO", which indicates we are referencing the actual order instance.

Table X: Fixed Order.moodCode
Code Display Name
RQO request
Code System: ActMood (HL7) Code System OID: 2.16.840.1.113883.5.1001

Order.id

The Order.id is a unique identifier for the order that was fulfilled.

Order.code

The particular kind of order that the this instance represents within its class code. The optional Order.code is bound to the D:ActCode concept domain.

Order.priorityCode

The optional Order.priorityCode, identifies the priority requested when the order was placed. It is bound to the D:ActPriority concept domain.

5.2.3.4 Consent

Provides references to consents on file.

5.2.3.4.1 authorization

The optional authorization class is used to associate a ClinicalDocument to a Consent.

Table X: authorization Attributes
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
typeCode CS [0..1] AUTH Fixed

authorization.typeCode

Table X: Fixed authorization.typeCode
Code Display Name
AUTH authorized by
Code System: ActRelationshipType (HL7) Code System OID: 2.16.840.1.113883.5.1002
5.2.3.4.2 Consent

This class references the consents associated with this document.

Table X: Consent Attributes
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
classCode CS [0..1] CONS Fixed
moodCode CS [0..1] EVN Fixed
id II [0..*]
code CD [0..1] D:ActCode Open
statusCode CS [1..1] completed Fixed

Consent.classCode

The Consent.classCode is fixed to "CONS" to represent a consent. The Consent class represents informed consents and all similar medico-legal transactions between the patient (or his legal guardian) and the provider.

Table X: Fixed Consent.classCode
Code Display Name
CONS consent
Code System: ActClass (HL7) Code System OID: 2.16.840.1.113883.5.6

Consent.moodCode

The Consent.moodCode is fixed to "EVN" (event) which indicates the consent has already been captured and is assumed to be on file.

Table X:Fixed Consent.moodCode
Code Display Name
EVN event
Code System: ActMood (HL7) Code System OID: 2.16.840.1.113883.5.1001

Consent.id

Optional identifier for the consent.

Consent.code

The Consent.code is bound to the D:ActCode concept domain. It is used to optionally identify the type of consent (e.g. a consent to perform the related ServiceEvent, a consent for the information contained in the document to be released to a third party).

Consent.statusCode

Consents referenced in the CDA Header have been finalized (Consent.statusCode must equal "completed") and should be on file.

Table X: Fixed Consent.statusCode
Code Display Name
completed completed
Code System: ActStatus (HL7) Code System OID: 2.16.840.1.113883.5.14

5.2.3.5 EncompassingEncounter

This optional class represents the setting of the clinical encounter during which the documented act(s) or ServiceEvent occurred. Documents are not necessarily generated during an encounter, such as when a clinician, in response to an abnormal laboratory result, attempts to contact the patient but can't, and writes a Progress Note: in such a case, the encompassingEncounter could be omitted.

5.2.3.5.1 componentOf

The optional componentOf class is used to associate the ClinicalDocument to an EncompassingEncounter.

Table X: componentOf Attributes
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
typeCode CS [0..1] COMP Fixed

componentOf.typeCode

The componentOf.typeCode is fixed to "COMP", which indicates that the ClinicalDocument was created within the context of an encounter (encompassingEncounter).

Table X: Fixed componentOf.typeCode
Code Display Name
COMP component
Code System: ActRelationshipType (HL7) Code System OID: 2.16.840.1.113883.5.1002
5.2.3.5.2 EncompassingEncounter

The EncompassingEncounter represents an interaction between a patient and care provider(s) for the purpose of providing healthcare-related service(s).

Table X: EncompassingEncounter Attributes
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
classCode CS [0..1] ENC Fixed
moodCode CS [0..1] EVN Fixed
id II [0..*]
code CD [0..1] V:ActEncounterCode Open
effectiveTime IVL<TS> [0..1]
admissionReferralSourceCode CE [0..1] D:EncounterReferralSourceCode Open
dischargeDispositionCode CE [0..1] D:EncounterDischargeDisposition Open

EncompassingEncounter.classCode

The EncompassingEncounter.classCode is fixed to "ENC" to represent a encounter. The encounter class is used to represent an interaction between a patient and healthcare participant(s) for the purpose of providing patient service(s) or assessing the health status of a patient.

Table X: Fixed EncompassingEncounter.classCode
Code Display Name
ENC encounter
Code System: ActClass (HL7) Code System OID: 2.16.840.1.113883.5.6

EncompassingEncounter.moodCode

The EncompassingEncounter.moodCode is fixed to "EVN" (event) which indicates that the encounter is on-going or completed.

Table X: Fixed EncompassingEncounter.moodCode
Code Display Name
EVN event
Code System: ActMood (HL7) Code System OID: 2.16.840.1.113883.5.1001

EncompassingEncounter.id

The optional EncompassingEncounter.id can be used to uniquely identify the encounter.

EncompassingEncounter.code

The optional EncompassingEncounter.code is bound to the ActEncounterCode value set.

Table X: Value set for EncompassingEncounter.code
V:ActEncounterCode [2.16.840.1.113883.1.11.13955] (OPEN)
Code Display Name Code Display Name
AMB ambulatory EMER emergency
FLD field HH home health
IMP inpatient encounter ACUTE inpatient acute
NONAC virtual SS short stay
VR inpatient non-acute
Code System: ActCode (HL7) Code System OID: 2.16.840.1.113883.5.4

EncompassingEncounter.effectiveTime

For Encounters, the effectiveTime is the "administrative" time, i.e., the encounter start and end date as established by business rules. For inpatient encounters, the effectiveTime/low value is the admission date and time and the effectiveTime/high value is the discharge date and time. Note: If the encounter is still active at the time of document creation, the effectiveTime/high element SHALL be omitted to indicate the encounter is on-going. This is preferred over using a nullFlavor.

EncompassingEncounter.admissionReferralSourceCode

The optional EncompassingEncounter.admissionReferralSourceCode can be use to depict the type of place or organization responsible for the patient's care immediately prior to a patient encounter.

EncompassingEncounter.dischargeDispositionCode

The optional EncompassingEncounter.dischargeDispositionCode can be used to depict the disposition of the patient at the time of hospital discharge (e.g., discharged to home, expired, against medical advice, etc.).

5.2.3.5.3 location

The location participant (location class) relates a healthcare facility (HealthCareFacility class) to the encounter to indicate where the encounter took place.

Table X: location
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
typeCode CS [1..1] LOC Fixed

location.typeCode

Table X: Fixed participant.typeCode
Code Display Name
LOC location
Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90
5.2.3.5.4 HealthCareFacility

The HealthCareFacility class supports the identification of the service delivery location. The location may be the setting (place) with an optional organizational reference, or a reference to the healthcare organization.

Table X: HealthCareFacility
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
classCode CS [0..1] V:RoleClassServiceDeliveryLocation Closed
id SET<II> [0..*]
code CE [0..1] V:ServiceDeliveryLocation Open

HealthCareFacility.classCode

The HealthCareFacility.classCode is bound to the ServiceDeliveryLocation value set and defaulted to the "SDLOC" to indicate the service delivery location.

Table X: Value set for HealthCareFacility.classCode
v:RoleClassServiceDeliveryLocation [2.16.840.1.113883.1.11.16927] (CLOSED)
Code Display Name Code Display Name
SDLOC (Default) service delivery location DSDLOC dedicated service delivery location, health care facility
ISDLOC incidental service delivery location
Code System: RoleClass (HL7) Code System OID: 2.16.840.1.113883.5.110

HealthCareFacility.id

An optional HealthCareFacility.id can be sent to uniquely identify the health care facility.

HealthCareFacility.code

The setting of an encounter (e.g. cardiology clinic, primary care clinic, rehabilitation hospital, skilled nursing facility) can be expressed in HealthCareFacility.code. A value set ServiceDeliveryLocationRoleType is provided for the this field.

Note: In some cases, the setting of the encounter is inherent in the ClinicalDocument.code, such as where ClinicalDocument.code is "Diabetes Clinic Progress Note". The setting of an encounter can also be transmitted in the HealthCareFacility.code attribute. If HealthCareFacility.code is sent, it should be equivalent to or further specialize the value inherent in the ClinicalDocument.code (such as where the ClinicalDocument.code is simply "Clinic Progress Note" and the value of HealthCareFacility.code is "cardiology clinic"), and shall not conflict with the value inherent in the ClinicalDocument.code, as such a conflict would constitute an ambiguous situation.

5.2.3.5.5 Place @a@

The entity playing the role of HealthCareFacility is a place (see Place (§ 5.2.2.11.6)).

The setting (place) and physical location are not the same. There is a many-to-many relationship between setting and the physical location where care is delivered. Thus, a particular room can provide the setting for cardiology clinic one day, and for primary care clinic another day; and cardiology clinic today might be held in one physical location, but in another physical location tomorrow.

5.2.3.5.6 Organization @g@

The entity scoping the HealthCareFacility role is an organization (see Organization (§ 5.2.2.1.3)). When the location is an organization, this is indicated by the presence of a scoping Organization, without a playing Place.

5.2.3.5.7 responsibleParty

The responsibleParty participant represents the participant having primary legal responsibility for the encounter. This differs from the legalAuthenticator participant in that the legalAuthenticator may or may not be the responsible party, and is serving a medical records function by signing off on the document, moving it into a completed state.

responsibleParty.typeCode

The responsibleParty.typeCode is fixed to "RESP" to indicate the responsible party i.e. The person or organization that has primary responsibility for the encounter. The responsible party is not necessarily present in an action, but is accountable for the action through the power to delegate, and the duty to review actions with the performing actor after the fact. This responsibility may be ethical, legal, contractual, fiscal, or fiduciary in nature.

Table X: Fixed responsibleParty.typeCode
Code Display Name
RESP responsible party
Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90

A responsibleParty is a person or organization in the role of an assigned entity (AssignedEntity class). An assigned entity is a person assigned to the role by the scoping organization. The entity playing the role is a person (Person class). The entity scoping the role is an organization (Organization class).

When the responsible party is an organization, the value for AssignedEntity.classCode is "ASSIGNED", and the responsible party is reflected by the presence of a scoping Organization, without a playing entity.

5.2.3.5.8 AssignedEntity @e@

A performer is an entity in the role of assigned entity (see AssignedEntity (§ 5.2.2.1.1)).

5.2.3.5.9 Person @g@

An assigned entity is a person assigned to the role by the scoping organization. The entity playing the role is a person (see Person (§ 5.2.2.2.2)).

5.2.3.5.10 Organization @h@

The entity scoping the role is an organization (see Organization (§ 5.2.2.1.3)).

5.2.3.5.11 encounterParticipant @a@

The encounterParticipant participant represents clinicians directly associated with the encounter (e.g. by initiating, terminating, or overseeing it).

Table X: performer
Attribute Name Data Type Wire Cardinality Code Binding Binding Type
typeCode CS [1..1] V:x_EncounterParticipant Closed
time TS [0..1]

encounterParticipant.typeCode

The encounterParticipant typeCode is bound to the x_EncounterParticipant value set. It supports for the following participation: admitter, attender, consultant, discharger, and referrer.

Table X: Value set for encounterParticipant.typeCode
V:x_EncounterParticipant [2.16.840.1.113883.1.11.19600] (CLOSED)
Code Display Name Code Display Name
ADM admitter ATND attender
CON consultant DIS discharger
REF
Code System: ParticipationType (HL7) Code System OID: 2.16.840.1.113883.5.90

encounterParticipant.time

An encounterParticipant is an entity in the role of assigned entity (AssignedEntity class). An assigned entity is a person assigned to the role by the scoping organization. The entity playing the role is a person (Person class). The entity scoping the role is an organization (Organization class).

5.2.3.5.12 AssignedEntity @f@

A performer is an entity in the role of assigned entity (see AssignedEntity (§ 5.2.2.1.1)).

5.2.3.5.13 Person @h@

An assigned entity is a person assigned to the role by the scoping organization. The entity playing the role is a person (see Person (§ 5.2.2.2.2)).

5.2.3.5.14 Organization @i@

The entity scoping the role is an organization (see Organization (§ 5.2.2.1.3)).

5.3 Body

(content on separate page)

6 CDA Hierarchical Description

(content on separate page)

7 CDA XML Implementation

(content on separate page)

8 Appendix

(content on separate page)