WSDLs for QED

Appendix E - WSDLs for QED

The WSDL for QED transactions PCC-1, PCC-2, PCC-3, PCC-4, PCC-5 and PCC-6 are identical except for the actor name. Simply substitute one the following values for the string ACTOR in the following WSDL example.

Transaction	Actor Name
PCC-1	VitalSignsDataRepository
PCC-2	ProblemAndAllergyDataRepository
PCC-3	DiagnosticDataRepository
PCC-4	MedicationDataRepository
PCC-5	ImmunizationDataRepository
PCC-5	ProfessionalServicesDataRepository

These WSDLs are represent interface contracts for the QED profile. Conformance to these contracts is a requirement of the profile. However, the WSDLs representing the these contracts are not necessarily the best WSDLs to use when generating application proxies.

There is a general guideline for generating proxies make application development much easier for complex WSDL/schemas such as the ones included for QED. Use a generic, non-strongly typed WSDL that is for the purpose of generating the proxy. Use of a strongly typed WSDL forces the generation infrastructure to go through all the XML type definitions. It will then generate classes for each of them, which can result in thousands of generated classes and megabytes of generated code. In addition, the mapping between the schema and object oriented constructs is not straightforward. Because of both the size, and complexity of the schema, proxy generators often run into problems with valid instances of strongy typed WSDLs.

A commonly used method for creating non-strongly typed WDSL for HL7 Messages used for generating proxies substitutes the ANY data type for the payload of either the message infrastructure or the control act. This results in much smaller proxies. Applications receiving messages using these proxies may want to validate inputs since they are no longer validated by the proxy. A discussion of this method of proxy generation can be found in this article: http://msdn2.microsoft.com/en-us/library/ms954603.aspx. See the section on Web Services Code Generation.

<?xml version="1.0" encoding="UTF-8"?>
<definitions name="ACTOR" targetNamespace="urn:ihe:pcc:qed:2007" 
		xmlns="http://schemas.xmlsoap.org/wsdl/" xmlns:hl7="urn:hl7-org:v3" 
		xmlns:tns="urn:ihe:pcc:qed:2007"
		xmlns:http="http://schemas.xmlsoap.org/wsdl/http/" 
		xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/"
		xmlns:wsoap11="http://schemas.xmlsoap.org/wsdl/soap/"
		xmlns:wsoap12="http://schemas.xmlsoap.org/wsdl/soap/"
		xmlns:wsaw="http://schemas.xmlsoap.org/ws/2004/08/addressing"
	 	xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" 
		xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
		xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <types>
    <xsd:schema elementFormDefault="qualified" targetNamespace="urn:hl7-org:v3">
      <!-- Query Care Record Event Profile Query -->
      <xsd:import schemaLocation="QUPC_IN043100UV.xsd"/>
		  <xsd:element name="QUPC_IN043100UV"/>
    </xsd:schema>
    <xsd:schema elementFormDefault="qualified" targetNamespace="urn:hl7-org:v3">
      <!-- Query Care Record Event Profile Query Response -->
      <xsd:import schemaLocation="QUPC_IN043200UV.xsd"/>
		  <xsd:element name="QUPC_IN043200UV"/>
    </xsd:schema>
    <xsd:schema elementFormDefault="qualified" targetNamespace="urn:hl7-org:v3">
      <!-- General Query Activate Query Continue / Cancel -->
      <xsd:import schemaLocation="QUQI_IN000003UV01.xsd"/>
		  <xsd:element name="QUQI_IN000003UV01"/>
    </xsd:schema>
  </types>
  <message name="QUPC_IN043100UV_Message"><part element="hl7:QUPC_IN043100UV" name="Body"/></message>
  <message name="QUPC_IN043200UV_Message"><part element="hl7:QUPC_IN043200UV" name="Body"/></message>
  <message name="QUQI_IN000003UV01_Message">
    <part element="hl7:QUQI_IN000003UV01" name="Body"/>
  </message>
	<portType name="ACTOR_PortType">
 		<operation name="ACTOR_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="ACTOR_QUQI_IN000003UV01_Continue">
			<input message="tns:QUQI_IN000003UV01_Message" 
				wsaw:Action="urn:hl7-org:v3:QUQI_IN000003UV01_Continue"/>
			<output message="tns:QUPC_IN043200UV_Message" 
				wsaw:Action="urn:hl7-org:v3:QUPC_IN043200UV "/>
		</operation>
		<operation name="ACTOR_QUQI_IN000003UV01_Cancel">
			<input message="tns:QUQI_IN000003UV01_Message" 
				wsaw:Action="urn:hl7-org:v3:QUQI_IN000003UV01_Cancel"/>
			<output message="tns:QUPC_IN043200UV_Message" wsaw:Action="urn:hl7-org:v3:QUPC_IN043200UV"/>
		</operation>
	</portType>
	<binding name="ACTOR_Binding_Soap12" 
		type="ACTOR_PortType">
		<wsoap12:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
		<operation name="ACTOR_QUPC_IN043100UV">
			<wsoap12:operation soapAction="urn:hl7-org:v3:QUPC_IN043100UV"/>
			<input><wsoap12:body use="literal"/></input>
			<output><wsoap12:body use="literal"/></output>
		</operation>
		<operation name="ACTOR_QUQI_IN000003UV01_Continue">
			<wsoap12:operation soapAction="urn:hl7-org:v3:QUQI_IN000003UV01"/>
			<input><wsoap12:body use="literal"/></input>
			<output><wsoap12:body use="literal"/></output>
		</operation>
		<operation name="ACTOR_QUQI_IN000003UV01_Cancel">
			<wsoap12:operation soapAction="urn:hl7-org:v3:QUQI_IN000003UV01"/>
			<input><wsoap12:body use="literal"/></input>
			<output><wsoap12:body use="literal"/></output>
		</operation>
	</binding>
	<binding name="ACTOR_Binding_Soap11" 
		type="ACTOR_PortType">
		<wsoap11:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
		<operation name="ACTOR_QUPC_IN043100UV">
			<wsoap11:operation soapAction="urn:hl7-org:v3:QUPC_IN043100UV"/>
			<input><wsoap12:body use="literal"/></input>
			<output><wsoap12:body use="literal"/></output>
		</operation>
		<operation name="ACTOR_QUQI_IN000003UV01_Continue">
			<wsoap11:operation soapAction="urn:hl7-org:v3:QUQI_IN000003UV01"/>
			<input><wsoap11:body use="literal"/></input>
			<output><wsoap11:body use="literal"/></output>
		</operation>
		<operation name="ACTOR_QUQI_IN000003UV01_Cancel">
			<wsoap11:operation soapAction="urn:hl7-org:v3:QUQI_IN000003UV01"/>
			<input><wsoap11:body use="literal"/></input>
			<output><wsoap11:body use="literal"/></output>
		</operation>
	</binding>
  <service name="ACTOR_Service">
    <port binding="tns:ACTOR_Binding_Soap11" name="ACTOR_Port_Soap11">
      <wsoap11:address location="http://servicelocation/"/>
    </port>
    <port binding="tns:ACTOR_Binding_Soap12" name="ACTOR_Port_Soap12">
      <wsoap12:address location="http://servicelocation/"/>
    </port>
  </service>
</definitions>

This file, along with the necessary HL7 Schemas, and some skelatal examples can all be found on the Patient Care Coordination FTP site: [1]