Difference between revisions of "PCC-3"

From IHE Wiki
Jump to navigation Jump to search
m
m
Line 6: Line 6:
 
==== Use Case Roles ====
 
==== Use Case Roles ====
 
{{Use Case Roles
 
{{Use Case Roles
|Clinical Data Consumer|Requests a list of diagnostic results for a given patient matching a minimal set of selection criteria from the Diagnostic Data Repository.
+
|Clinical Data Consumer|Requests a list of diagnostic results for a given patient matching a minimal set of selection criteria from the Diagnostic Data Repository.<dl><dt>Cooresponding HL7 Version 3 Application Roles<dd>Care Record Query Placer ([http://www.hl7.org/v3ballot/html/domains/uvpc/uvpc_CareRecordQuery.htm#QUPC_AR004030UV-ar QUPC_AR004030UV])<br/>Query by Parameter Placer ([http://www.hl7.org/v3ballot/html/domains/uvqi/uvqi_QueryByParameter.htm#QUQI_AR000001UV01-ar QUQI_AR000001UV01])</dl>
|Diagnostic Data Repository|Returns diagnostic results for a given patient matching the selection criteria supplied by the Clinical Data Consumer.
+
|Diagnostic Data Repository|Returns diagnostic results for a given patient matching the selection criteria supplied by the Clinical Data Consumer.<dl><dt>Cooresponding HL7 Version 3 Application Roles<dd>Care Record Query Fulfiller  ([http://www.hl7.org/v3ballot/html/domains/uvpc/uvpc_CareRecordQuery.htm#QUPC_AR004040UV-ar QUPC_AR004040UV])<br/>Query by Parameter Fulfiller ([http://www.hl7.org/v3ballot/html/domains/uvqi/uvqi_QueryByParameter.htm#QUQI_AR000002UV01-ar QUQI_AR000002UV01])</dl>
 +
 
 
|Tx=Query Diagnostic Data}}
 
|Tx=Query Diagnostic Data}}
  
Line 33: Line 34:
 
The <value> element of the <careProvisionReason> element may contain a value identifying a specific problem that was the reason for obtaining the result.
 
The <value> element of the <careProvisionReason> element may contain a value identifying a specific problem that was the reason for obtaining the result.
 
A Diagnostic Data Repository Actor that chooses to honor this query parameter shall return only those results that were for the indicated reason.  Should the Diagnostic Data Repository Actor not support the use of the <careProvisionReason> element, it shall indicate this by raising the appropriate alert as decribed in the expected actions recorded in {{ILink|PCC-3|PCC-1}}.
 
A Diagnostic Data Repository Actor that chooses to honor this query parameter shall return only those results that were for the indicated reason.  Should the Diagnostic Data Repository Actor not support the use of the <careProvisionReason> element, it shall indicate this by raising the appropriate alert as decribed in the expected actions recorded in {{ILink|PCC-3|PCC-1}}.
 +
 +
==== WSDL Declarations ====
 +
{{:PCC-1/WSDL|3|Diagnositic|Diagnositic}}

Revision as of 16:49, 22 August 2007

Query Diagnostic Data

This section corresponds to Transaction PCC-3 of the IHE Patient Care Coordination Technical Framework. Transaction Query Diagnostic Data is used by the Clinical Data Consumer and Diagnostic Data Repository Actors.

Transaction Query Diagnostic Data uses the same pattern as transaction PCC-1. Therefore, the Referenced Standards and Interaction Diagrams sections of that transaction also serve to document the standards and interactions used in this transaction. Information specific to this transaction is described in futher detail below in the section on Domain Content.

Use Case Roles

Clinical Data Consumer   Diagnostic Data Repository
Usecase.png
Query Diagnostic Data
Actor
Clinical Data Consumer
Role
Requests a list of diagnostic results for a given patient matching a minimal set of selection criteria from the Diagnostic Data Repository.
Cooresponding HL7 Version 3 Application Roles
Care Record Query Placer (QUPC_AR004030UV)
Query by Parameter Placer (QUQI_AR000001UV01)
Actor
Diagnostic Data Repository
Role
Returns diagnostic results for a given patient matching the selection criteria supplied by the Clinical Data Consumer.
Cooresponding HL7 Version 3 Application Roles
Care Record Query Fulfiller (QUPC_AR004040UV)
Query by Parameter Fulfiller (QUQI_AR000002UV01)


Domain Content

This section lists the requirements specific to the Query Diagnostic Data transaction.


Note: Implementors of a Diagnostic Data Repository Actor, or a Clinical Data Consumer Actor shall publish an HL7 Conformance Profile that indicates the vocabularies and code sets that they support for this transaction.


Note: Diagnostic results include any observations made using specific diagnostic procedures or equipment, including laboratory, imaging, or assessment scales


careProvisionCode

A Clinical Data Consumer may specify the following values from the HL7 ActCode vocabulary (2.16.840.1.113883.5.4) to obtain the observations listed in the table below.

Code Returns Template Id
LABCAT All Lab Results Simple Observations
DICAT All Imaging Results Simple Observations

A Clinical Data Consumer Actor may set the <value> element of the <careProvisionCode> element to identify a specific diagnostic result using LOINC, or it may select a class of diagnostic results using the LOINC values specified in the XD*-Lab profile.

A Diagnostic Data Repository Actor shall respond with <observation> elements cooresponding the specified results. The results shall be returned in the form of clinical statements that conform to the Simple Observation template.

careProvisionReason

The <value> element of the <careProvisionReason> element may contain a value identifying a specific problem that was the reason for obtaining the result. A Diagnostic Data Repository Actor that chooses to honor this query parameter shall return only those results that were for the indicated reason. Should the Diagnostic Data Repository Actor not support the use of the <careProvisionReason> element, it shall indicate this by raising the appropriate alert as decribed in the expected actions recorded in PCC-1.

WSDL Declarations

The following WSDL naming conventions SHALL apply for this transaction:

WSDL Definitions for PCC-3
WSDL Item Value
wsdl:definitions/@name DiagnositicDataSource
Get Care Record Profile Query QUPC_IN043100UV_Message
Get Care Record Profile Response QUPC_IN043200UV_Message
General Query Activate Continue / Cancel QUQI_IN000003UV01_Messsage
portType DiagnositicDataSource_PortType
Query Operation DiagnositicDataSource_QUPC_IN043100UV
Continue Operation DiagnositicDataSource_QUQI_IN000003UV01_Continue
Cancel Operation DiagnositicDataSource_QUQI_IN000003UV01_Cancel
SOAP 1.1 binding DiagnositicDataSource_Binding_Soap11
SOAP 1.1 port DiagnositicDataSource_Port_Soap11
SOAP 1.2 binding DiagnositicDataSource_Binding_Soap12
SOAP 1.2 port DiagnositicDataSource_Port_Soap12

The following WSDL snippets specify the Port Type and Binding definitions, according to the requirements specified in ITI TF-2: Appendix V. A full WSDL example for the Diagnositic Data Source actor implementing the QED profile can be found at ftp://ftp.ihe.net/Patient_Care_Coordination/yr3_2007-2008/resources/Query.zip. For a general description of the WSDLs for QED see the Appendix of the same name in this volume.

Port Type
<portType name="DiagnositicDataSource_PortType">
 <operation name="DiagnositicDataSource_QUPC_IN043100UV">
   <input message="tns:QUPC_IN043100UV_Message"
     wsaw:Action="urn:hl7-org:v3:QUPC_IN043100UV"/>
   <output message="tns:QUPC_IN043200UV_Message" 
     wsaw:Action="urn:hl7-org:v3:QUPC_IN043200UV "/>
 </operation>
 <operation name="DiagnositicDataSource_QUQI_IN000003UV01_Continue">
   <input message="tns:QUQI_IN000003UV01_Message"
     wsaw:Action="urn:hl7-org:v3:QUQI_IN000003UV01"/>
   <output message="tns:QUPC_IN043200UV_Message" 
     wsaw:Action="urn:hl7-org:v3:QUPC_IN043200UV "/>
 </operation>
 <operation name="DiagnositicDataSource_QUQI_IN000003UV01_Cancel">
   <input message="tns:QUQI_IN000003UV01_Message"
     wsaw:Action="urn:hl7-org:v3:QUQI_IN000003UV01"/>
   <output message="tns:QUPC_IN043200UV_Message" 
     wsaw:Action="urn:hl7-org:v3:QUPC_IN043200UV "/>
 </operation>
</portType>
Port Types for PCC-3
Bindings
<binding name="DiagnositicDataSource_Binding_Soap12" 
   type="DiagnositicDataSource_PortType">
 <wsoap12:binding style="document"
   transport="http://schemas.xmlsoap.org/soap/http"/>
 <operation name="DiagnositicDataSource_QUPC_IN043100UV">
   <wsoap12:operation soapAction="urn:hl7-org:v3:QUPC_IN043100UV"/>
   <input>
     <wsoap12:body use="literal"/>
   </input>
   <output>
     <wsoap12:body use="literal"/>
   </output>
 </operation>
</binding>
SOAP 1.2 Binding for PCC-3
<binding name="DiagnositicDataSource_Binding_Soap11" 
   type="DiagnositicDataSource_PortType">
 <wsoap11:binding style="document"
   transport="http://schemas.xmlsoap.org/soap/http"/>
 <operation name="DiagnositicDataSource_QUPC_IN043100UV">
   <wsoap11:operation soapAction="urn:hl7-org:v3:QUPC_IN043100UV"/>
   <input>
     <wsoap11:body use="literal"/>
   </input>
   <output>
     <wsoap11:body use="literal"/>
   </output>
 </operation>
</binding>
SOAP 1.1 Binding for PCC-3