PCC-7: Difference between revisions
| Line 43: | Line 43: | ||
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'>'''< | <font color='#808080'><font color='black'>'''<REPC_IN004110UV xmlns="urn:hl7-org:v3" ITSVersion="XML_1.0"''' | ||
'''xmlns:xsi="<nowiki>http://www.w3.org/2001/XMLSchema-instance</nowiki>">'''</font> | '''xmlns:xsi="<nowiki>http://www.w3.org/2001/XMLSchema-instance</nowiki>">'''</font> | ||
<id root=' ' extension=' '/> | <id root=' ' extension=' '/> | ||
<creationTime value=' '/> | <creationTime value=' '/> | ||
<font color='black'>'''<interactionId extension=' | <font color='black'>'''<interactionId extension='REPC_IN004110UV|REPC_IN004913UV' root='2.16.840.1.113883.5'/>'''</font> | ||
<processingCode code='D|P|T'/> | <processingCode code='D|P|T'/> | ||
<font color='black'>'''<processingModeCode code='T'/>''' | <font color='black'>'''<processingModeCode code='T'/>''' | ||
| Line 72: | Line 72: | ||
<font color='black'>''See Control Act Wrapper below''</font> | <font color='black'>''See Control Act Wrapper below''</font> | ||
</controlActProcess> | </controlActProcess> | ||
</ | </REPC_IN004110UV></font> | ||
====== <REPC_IN004110UV 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". | |||
To indicate that this interaction is notification of activation of a guideline, the element shall be named: REPC_IN004110UV | |||
To indicate that this interaction is notification of replacement of a guideline, the element shall be named: REPC_IN004913UV | |||
<rule context='/'> | |||
<assert test='/hl7:REPC_IN004110UV|/hl7:REPC_IN004913UV'> | |||
The root element of a PCC-7 transaction shall be REPC_IN004110UV or REPC_IN004913UV from the HL7 namespace (urn:hl7-org:v3). | |||
</assert> | |||
</rule> | |||
====== <interactionId extension='REPC_IN004110UV|REPC_IN004913UV' root='2.16.840.1.113883.5'/> ====== | |||
The identifer for the interaction shall be sent using either the value REPC_IN004110UV or REPC_IN004913UV depending upon whether this interaction describes activation or replacement respectively. This value must be the same as the name of the interaction element being sent. | |||
<rule context='/hl7:REPC_IN004110UV|/hl7:REPC_IN004913UV'> | |||
<assert test='hl7:interactionId/@extension = local-name()'> | |||
The interaction of a PCC-7 transaction shall be REPC_IN004110UV or REPC_IN004913UV and shall coorespond to the interaction being used in the message. | |||
</assert> | |||
</rule> | |||
====== <processingModeCode code='T'/> ====== | ====== <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. | 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. | ||
<rule context='/hl7:REPC_IN004110UV|/hl7:REPC_IN004913UV'> | |||
<assert test='hl7:processingModeCode/@code = "T"'> | |||
The processingModeCode shall use the code value "T" for this message. | |||
</assert> | |||
</rule> | |||
====== <acceptAckCode code='AL'/> ====== | ====== <acceptAckCode code='AL'/> ====== | ||
The acceptAckCode indicates whether the sender wants to recieve an acknowledgement, and shall be sent as shown above. | The acceptAckCode indicates whether the sender wants to recieve an acknowledgement, and shall be sent as shown above. | ||
<rule context='/hl7:REPC_IN004110UV|/hl7:REPC_IN004913UV'> | |||
<assert test='hl7:acceptAckCode/@code = "AL"'> | |||
The acceptAckCode shall use the code "AL" to indicate that the reciever must always acknowledge the message. | |||
</assert> | |||
</rule> | |||
===== Control Act Wrapper ===== | ===== Control Act Wrapper ===== | ||
Revision as of 01:47, 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 | |
- 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
Interaction Diagrams
Guideline Notification
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:
- Activate Care Provision (REPC_TE004110UV)
- Replace Care Provision (REPC_TE004913UV)
Message Semantics
This interaction cooresponds to the HL7 Interactions:
- Activate Care Provision (REPC_IN004110UV) {Schema: [1]}
- Replace Care Provision (REPC_IN004913UV) {Schema: [2]}
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.
<REPC_IN004110UV 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='REPC_IN004110UV|REPC_IN004913UV' 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> </REPC_IN004110UV>
<REPC_IN004110UV 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".
To indicate that this interaction is notification of activation of a guideline, the element shall be named: REPC_IN004110UV To indicate that this interaction is notification of replacement of a guideline, the element shall be named: REPC_IN004913UV
<rule context='/'>
<assert test='/hl7:REPC_IN004110UV|/hl7:REPC_IN004913UV'>
The root element of a PCC-7 transaction shall be REPC_IN004110UV or REPC_IN004913UV from the HL7 namespace (urn:hl7-org:v3).
</assert>
</rule>
<interactionId extension='REPC_IN004110UV|REPC_IN004913UV' root='2.16.840.1.113883.5'/>
The identifer for the interaction shall be sent using either the value REPC_IN004110UV or REPC_IN004913UV depending upon whether this interaction describes activation or replacement respectively. This value must be the same as the name of the interaction element being sent.
<rule context='/hl7:REPC_IN004110UV|/hl7:REPC_IN004913UV'>
<assert test='hl7:interactionId/@extension = local-name()'>
The interaction of a PCC-7 transaction shall be REPC_IN004110UV or REPC_IN004913UV and shall coorespond to the interaction being used in the message.
</assert>
</rule>
<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.
<rule context='/hl7:REPC_IN004110UV|/hl7:REPC_IN004913UV'>
<assert test='hl7:processingModeCode/@code = "T"'>
The processingModeCode shall use the code value "T" for this message.
</assert>
</rule>
<acceptAckCode code='AL'/>
The acceptAckCode indicates whether the sender wants to recieve an acknowledgement, and shall be sent as shown above.
<rule context='/hl7:REPC_IN004110UV|/hl7:REPC_IN004913UV'>
<assert test='hl7:acceptAckCode/@code = "AL"'>
The acceptAckCode shall use the code "AL" to indicate that the reciever must always acknowledge the message.
</assert>
</rule>
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.
