Difference between revisions of "PCC-7"

From IHE Wiki
Jump to navigation Jump to search
Line 42: Line 42:
 
The transmission wrapper MCCI_MT000100UV01 provides information about the message transmission and routing.  Transmission wrappers are further described in ITI TF-2: Appendix O.
 
The transmission wrapper MCCI_MT000100UV01 provides information about the message transmission and routing.  Transmission wrappers are further described in ITI TF-2: Appendix O.
 
An example transmission wrapper is given below for this interaction.  Items marked in dark gray are transmitted as specified in ITI TF-2: Appendix O.  Items in bold black text are further constrained by this profile in this interaction.
 
An example transmission wrapper is given below for this interaction.  Items marked in dark gray are transmitted as specified in ITI TF-2: Appendix O.  Items in bold black text are further constrained by this profile in this interaction.
 +
 +
<font color='#808080'><font color='black'>'''<QUPC_IN043100UV xmlns="urn:hl7-org:v3" ITSVersion="XML_1.0"'''
 +
                  '''xmlns:xsi="<nowiki>http://www.w3.org/2001/XMLSchema-instance</nowiki>">'''</font>
 +
  <id root=' ' extension=' '/>
 +
  <creationTime value=' '/>
 +
  <font color='black'>'''<interactionId extension='QUPC_IN043100UV' root='2.16.840.1.113883.5'/>'''</font>
 +
  <processingCode code='D|P|T'/>
 +
  <font color='black'>'''<processingModeCode code='T'/>'''
 +
  '''<acceptAckCode code='AL'/>'''</font>
 +
  <receiver typeCode="RCV">
 +
    <device determinerCode="INSTANCE">
 +
      <id/>
 +
      <name/>
 +
      <telecom value=' ' />
 +
      <manufacturerModelName/>
 +
      <softwareName/>
 +
    </device>
 +
  </receiver>
 +
  <sender typeCode="SND">
 +
    <device determinerCode="INSTANCE">
 +
      <id/>
 +
      <name/>
 +
      <telecom value=' ' />
 +
      <manufacturerModelName/>
 +
      <softwareName/>
 +
    </device>
 +
  </sender>
 +
  <controlActProcess>
 +
  <font color='black'>''See Control Act Wrapper below''</font>
 +
  </controlActProcess>
 +
</QUPC_IN043100UV></font>
 +
 +
====== <QUPC_IN043100UV xmlns="urn:hl7-org:v3" ITSVersion="XML_1.0" xmlns:xsi="<nowiki>http://www.w3.org/2001/XMLSchema-instance</nowiki>"> ======
 +
The HL7 Interaction being sent will control the name of the root element in the message. The namespace of this message shall be urn:hl7-org:v3, and the ITSVersion attribute shall be "XML_1.0".
 +
====== <interactionId extension='QUPC_IN043100UV' root='2.16.840.1.113883.5'/> ======
 +
The identifer for the interaction shall be sent as shown above.
 +
====== <processingModeCode code='T'/> ======
 +
The processingModeCode distinguishes the type of processing being performed. This element shall be present and have the value shown above to indicate that this message is for current processing.
 +
====== <acceptAckCode code='AL'/> ======
 +
The acceptAckCode indicates whether the sender wants to recieve an acknowledgement, and shall be sent as shown above.
 +
 +
===== Control Act Wrapper =====
 +
The control act wrapper QUQI_MT020001UV01 provides information about the business actors related to the transaction, including the author or performer of the act.  Control act wrappers are further described in ITI TF-2: Appendix O.
 +
An example transmission wrapper is given below for this interaction.  Items marked in dark gray are transmitted as specified in ITI TF-2: Appendix O.  Items in bold black text are further constrained by this profile in this interaction.
 +
<font style='color: black'>'''<controlActProcess moodCode="RQO">'''
 +
  <font color='#808080'><id root=' ' extension=' '/></font>
 +
  '''<code code='QUPC_TE043100UV'/>'''
 +
  <font color='#808080'><effectiveTime value=' '/>
 +
  <languageCode code=' '/>
 +
  <authorOrPerformer typeCode=' '></authorOrPerformer></font>
 +
  <font style='font-weight: bold'><!-- Performing a Query -->
 +
  <queryByParameter>
 +
    <id root='&nbsp;' extension='&nbsp;'/>
 +
    <statusCode code='new'/>
 +
    <responseModalityCode code='R'/>
 +
    <responsePriorityCode code='I'/>
 +
    <initialQuantity value=''/>
 +
    <initialQuantityCode code='REPC_RM000100UV' codeSystem='2.16.840.1.113883'>
 +
    <parameterList>
 +
      <font style='font-weight: normal'>''see Query Parameter List below''</font>
 +
    </parameterList>
 +
  </queryByParameter>
 +
</controlActProcess></font></font>
 +
====== <controlActProcess moodCode="RQO"> ======
 +
The controlActProcess element is where information about the business act being performed is recorded. The moodCode is set to "RQO" by the sender to indicate a request to perform an action, in this case, a query. 
 +
====== <code code='QUPC_TE043100UV'/> ======
 +
The trigger event which caused the act to be transmitted is recorded in the code element is recorded as shown above.
 +
===== Expected Actions -- Guideline Manager =====
 +
The clinical data consumer shall send a query as specified in the QUPC_IN043100UV  interaction.  The message shall be sent using web services as specified in the ITI-TF: Appendix V.
 +
 +
The name of the query response message shall be QUPC_IN043100UV_Message in the WSDL.
 +
The following WSDL snippet defines the type for this message:
 +
{|
 +
|+Query Message Type Definition
 +
|-
 +
|
 +
<pre>
 +
<types>
 +
  <xsd:schema elementFormDefault="qualified"
 +
      targetNamespace="urn:hl7-org:v3" xmlns:hl7="urn:hl7-org:v3">
 +
    <!-- Include the message schema -->
 +
    <xsd:import namespace="urn:hl7-org:v3"
 +
      schemaLocation="QUPC_IN043100UV.xsd"/>
 +
    <xsd:element name="QUPC_IN043100UV"/>
 +
  </xsd:schema>
 +
</types>
 +
</pre>
 +
|}
 +
 +
The message type is declared to be of the appropriate type by the following WSDL snippet:
 +
{|
 +
|+Query Message WSDL Declaration
 +
|-
 +
|
 +
<pre>
 +
<message name='QUPC_IN043100UV_Message'>
 +
  <part element='hl7:QUPC_IN043100UV' name="Body"/>
 +
</message>
 +
</pre>
 +
|}
 +
Other WSDL declarations required for this transaction are defined under the Domain Content section.

Revision as of 01:29, 12 May 2008

Guideline Notification

This section corresponds to Transaction PCC-7 of the IHE Patient Care Coordination Technical Framework. Transaction PCC-7 is used by the Guideline Manager and Care Manager Actors.

Use Case Roles

Guideline Manager   Care Manager
Usecase.png
Guideline Notification
Actor
Guideline Manager
Role
Notifies the Care Manager of new and/or updated guidelines for care
Cooresponding HL7 Version 3 Application Roles
Care Provision Informer (REPC_AR004010UV)
Actor
Care Manager
Role
Recieves notification of new and/or updated guidelines for care
Cooresponding HL7 Version 3 Application Roles
Care Provision Tracker (REPC_AR004020UV)

Referenced Standards

CareRecord HL7 Care Provision Care Record (DSTU)
HL7QI HL7 Version 3 Standard: Infrastructure Management – Query Infrastrucure
HL7WS HL7 Version 3 Standard: Transport Specification - Web Services Profile, Release
SOAP Simple Object Access Protocol Version 1.1 (SOAP 1.1)
SOAP12 Simple Object Access Protocol Version 1.2 (SOAP 1.2)

Interaction Diagrams

File:Pcc7id.png

Get Care Record Profile Query

Trigger Events

When a new or updated guideline is released, the Guideline Manager uses this transaction to notify the Care Manager of the new and/or updated guideline. This cooresponds to the HL7 trigger events:

Message Semantics

This interaction cooresponds to the HL7 Interactions:

The schema for these interactions can be found at the links above, and include:

  • the transmission wrapper MCCI_MT000100UV01,
  • the control act wrapper MCAI_MT700201UV01, and
  • the message payload REPC_MT004000UV.

These components of the interaction are specified in the HL7 standards described above.

Transmission Wrapper

The transmission wrapper MCCI_MT000100UV01 provides information about the message transmission and routing. Transmission wrappers are further described in ITI TF-2: Appendix O. An example transmission wrapper is given below for this interaction. Items marked in dark gray are transmitted as specified in ITI TF-2: Appendix O. Items in bold black text are further constrained by this profile in this interaction.

<QUPC_IN043100UV xmlns="urn:hl7-org:v3" ITSVersion="XML_1.0"
                 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 <id root=' ' extension=' '/>
 <creationTime value=' '/>
 <interactionId extension='QUPC_IN043100UV' root='2.16.840.1.113883.5'/>
 <processingCode code='D|P|T'/>
 <processingModeCode code='T'/>
 <acceptAckCode code='AL'/>
 <receiver typeCode="RCV">
   <device determinerCode="INSTANCE">
     <id/>
     <name/>
     <telecom value=' ' />
     <manufacturerModelName/>
     <softwareName/>
   </device>
 </receiver>
 <sender typeCode="SND">
   <device determinerCode="INSTANCE">
     <id/>
     <name/>
     <telecom value=' ' />
     <manufacturerModelName/>
     <softwareName/>
   </device>
 </sender>
 <controlActProcess>
  See Control Act Wrapper below
 </controlActProcess>
</QUPC_IN043100UV>
<QUPC_IN043100UV xmlns="urn:hl7-org:v3" ITSVersion="XML_1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

The HL7 Interaction being sent will control the name of the root element in the message. The namespace of this message shall be urn:hl7-org:v3, and the ITSVersion attribute shall be "XML_1.0".

<interactionId extension='QUPC_IN043100UV' root='2.16.840.1.113883.5'/>

The identifer for the interaction shall be sent as shown above.

<processingModeCode code='T'/>

The processingModeCode distinguishes the type of processing being performed. This element shall be present and have the value shown above to indicate that this message is for current processing.

<acceptAckCode code='AL'/>

The acceptAckCode indicates whether the sender wants to recieve an acknowledgement, and shall be sent as shown above.

Control Act Wrapper

The control act wrapper QUQI_MT020001UV01 provides information about the business actors related to the transaction, including the author or performer of the act. Control act wrappers are further described in ITI TF-2: Appendix O. An example transmission wrapper is given below for this interaction. Items marked in dark gray are transmitted as specified in ITI TF-2: Appendix O. Items in bold black text are further constrained by this profile in this interaction.

<controlActProcess moodCode="RQO">
  <id root=' ' extension=' '/>
  
  <effectiveTime value=' '/>
  <languageCode code=' '/>
  <authorOrPerformer typeCode=' '></authorOrPerformer>
  
  <queryByParameter>
    <id root=' ' extension=' '/>
    <statusCode code='new'/>
    <responseModalityCode code='R'/>
    <responsePriorityCode code='I'/>
    <initialQuantity value=/>
    <initialQuantityCode code='REPC_RM000100UV' codeSystem='2.16.840.1.113883'>
    <parameterList>
      see Query Parameter List below
    </parameterList>
  </queryByParameter>
</controlActProcess>
<controlActProcess moodCode="RQO">

The controlActProcess element is where information about the business act being performed is recorded. The moodCode is set to "RQO" by the sender to indicate a request to perform an action, in this case, a query.

The trigger event which caused the act to be transmitted is recorded in the code element is recorded as shown above.

Expected Actions -- Guideline Manager

The clinical data consumer shall send a query as specified in the QUPC_IN043100UV interaction. The message shall be sent using web services as specified in the ITI-TF: Appendix V.

The name of the query response message shall be QUPC_IN043100UV_Message in the WSDL. The following WSDL snippet defines the type for this message:

Query Message Type Definition
<types>
   <xsd:schema elementFormDefault="qualified" 
      targetNamespace="urn:hl7-org:v3" xmlns:hl7="urn:hl7-org:v3">
    <!-- Include the message schema -->
    <xsd:import namespace="urn:hl7-org:v3"
      schemaLocation="QUPC_IN043100UV.xsd"/>
    <xsd:element name="QUPC_IN043100UV"/>
  </xsd:schema>
</types>

The message type is declared to be of the appropriate type by the following WSDL snippet:

Query Message WSDL Declaration
<message name='QUPC_IN043100UV_Message'>
  <part element='hl7:QUPC_IN043100UV' name="Body"/>
</message>

Other WSDL declarations required for this transaction are defined under the Domain Content section.