PCC-4

From IHE Wiki
Revision as of 16:53, 22 August 2007 by Kboone (talk | contribs)
Jump to navigation Jump to search

Query Medications

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

Transaction Query Medications uses the same pattern as transaction PCC-1. Therefore, the Referenced Standards and Interaction Diagrams sections 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   Medication Data Repository
Usecase.png
Query Medications
Actor
Clinical Data Consumer
Role
Requests Requests a list of medications for a given patient matching a minimal set of selection criteria from the Medication Data Repository.
Cooresponding HL7 Version 3 Application Roles
Care Record Query Placer (QUPC_AR004030UV)
Query by Parameter Placer (QUQI_AR000001UV01)
Actor
Medication Data Repository
Role
Returns medications 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 Medications transaction.


Note: Implementors of a Medications 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.


Get Care Record Profile Query
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
RXCAT All Medications Medications
MEDLIST All Medications Medications
CURMEDLIST All active medications Medications
DISCHMEDLIST Discharge Medications Medications
HISTMEDLIST All Historical Medications Medications

A Clinical Data Consumer Actor may make requests using other codes to obtain information about specific medications, however, the Medication Data Repository Actor need not honor these codes.

Codes for medications may be found in RxNorm (2.16.840.1.113883.6.88), NDC (2.16.840.1.113883.6.69) and SNOMED CT (2.16.840.1.113883.6.96).


Note: The code value specified in the query may represent a code found in <code> of the <substanceAdministration>, or any of its components, and thus may identify an act or a substance


careProvisionReason

The <value> element of the <careProvisionReason> element may contain a value identifying a specific problem that was the reason for the medication.

A Medication 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.

Get Care Record Profile Response

A Medication Data Repository Actor shall respond to a query request by returning clinical statements matching the query parameter returned within <pertinentInformation3> data elements.

The clinical statements that are returned for by this transaction shall conform to the Medications template.

WSDL Declarations

The following WSDL naming conventions SHALL apply for this transaction:

WSDL Definitions for PCC-4
WSDL Item Value
wsdl:definitions/@name MedicationDataSource
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 MedicationDataSource_PortType
Query Operation MedicationDataSource_QUPC_IN043100UV
Continue Operation MedicationDataSource_QUQI_IN000003UV01_Continue
Cancel Operation MedicationDataSource_QUQI_IN000003UV01_Cancel
SOAP 1.1 binding MedicationDataSource_Binding_Soap11
SOAP 1.1 port MedicationDataSource_Port_Soap11
SOAP 1.2 binding MedicationDataSource_Binding_Soap12
SOAP 1.2 port MedicationDataSource_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 Medication 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="MedicationDataSource_PortType">
 <operation name="MedicationDataSource_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="MedicationDataSource_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="MedicationDataSource_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-4
Bindings
<binding name="MedicationDataSource_Binding_Soap12" 
   type="MedicationDataSource_PortType">
 <wsoap12:binding style="document"
   transport="http://schemas.xmlsoap.org/soap/http"/>
 <operation name="MedicationDataSource_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-4 
<binding name="MedicationDataSource_Binding_Soap11" 
   type="MedicationDataSource_PortType">
 <wsoap11:binding style="document"
   transport="http://schemas.xmlsoap.org/soap/http"/>
 <operation name="MedicationDataSource_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-4
Retrieved from "http://wiki.ihe.net/index.php?title=PCC-4&oldid=8854"