PCC-7: Difference between revisions
| Line 114: | Line 114: | ||
===== Control Act Wrapper ===== | ===== Control Act Wrapper ===== | ||
The control act wrapper | The control act wrapper MCAI_MT700201UV01 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. | 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=" | |||
<font style='color: black'>'''<controlActProcess moodCode="EVN">''' | |||
<font color='#808080'><id root=' ' extension=' '/></font> | <font color='#808080'><id root=' ' extension=' '/></font> | ||
'''<code code=' | '''<code code='REPC_TE004110UV|REPC_TE004913UV'/>''' | ||
<font color='#808080'><effectiveTime value=' '/> | <font color='#808080'><effectiveTime value=' '/> | ||
<languageCode code=' '/> | <languageCode code=' '/> | ||
<authorOrPerformer typeCode=' '></authorOrPerformer></font> | <authorOrPerformer typeCode=' '></authorOrPerformer></font> | ||
</controlActProcess></font></font> | </controlActProcess></font></font> | ||
====== <controlActProcess moodCode=" | ====== <controlActProcess moodCode="EVN"> ====== | ||
The controlActProcess element is where information about the business act being performed is recorded. The moodCode is set to " | The controlActProcess element is where information about the business act being performed is recorded. The moodCode is set to "EVN" by the sender to indicate notification of a guideline activation or change event. | ||
====== <code code=' | |||
The trigger event which caused the act to be transmitted is recorded in the code element is recorded | <rule context='//hl7:controlActProcess'> | ||
<assert test='@moodCode="EVN"'> | |||
The controlActProcess of a PCC-7 transaction shall have moodCode="EVN". | |||
</assert> | |||
</rule> | |||
====== <code code='REPC_TE004110UV|REPC_TE004913UV'/> ====== | |||
The trigger event which caused the act to be transmitted is recorded in the code element is recorded. The value of the code attribute shall be REPC_TE004110UV to record an activation event, or REPC_TE004913UV to record a replacement. The code attribute shall coorespond to the correct interaction. | |||
<rule context='//hl7:controlActProcess/hl7:code'> | |||
<assert test='(@code="REPC_TE004110UV" or @code="REPC_TE004913UV) and substring(@code,8,8) = substring(local-name(/),8,8)"'> | |||
The trigger event in a PCC-7 transaction shall be REPC_TE004110UV or REPC_TE004913UV, and shall coorespond to the interaction. | |||
</assert> | |||
</rule> | |||
===== Expected Actions -- Guideline Manager ===== | ===== 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 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. | ||
Revision as of 01:58, 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 MCAI_MT700201UV01 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="EVN"> <id root=' ' extension=' '/><effectiveTime value=' '/> <languageCode code=' '/> <authorOrPerformer typeCode=' '></authorOrPerformer> </controlActProcess>
<controlActProcess moodCode="EVN">
The controlActProcess element is where information about the business act being performed is recorded. The moodCode is set to "EVN" by the sender to indicate notification of a guideline activation or change event.
<rule context='//hl7:controlActProcess'>
<assert test='@moodCode="EVN"'>
The controlActProcess of a PCC-7 transaction shall have moodCode="EVN".
</assert>
</rule>
The trigger event which caused the act to be transmitted is recorded in the code element is recorded. The value of the code attribute shall be REPC_TE004110UV to record an activation event, or REPC_TE004913UV to record a replacement. The code attribute shall coorespond to the correct interaction.
<rule context='//hl7:controlActProcess/hl7:code'>
<assert test='(@code="REPC_TE004110UV" or @code="REPC_TE004913UV) and substring(@code,8,8) = substring(local-name(/),8,8)"'>
The trigger event in a PCC-7 transaction shall be REPC_TE004110UV or REPC_TE004913UV, and shall coorespond to the interaction.
</assert>
</rule>
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.
