HC_ADR_A19 Collaboration Template

The HC_ADR_A19 collaboration template processes MTADR business objects. The HC_ADR_A19 collaboration template uses data contained in the MTADR business object to build and populate an MQWF_ADR_A19 workflow response business object. The collaboration is generally used as one of a pair of closely coupled request/response collaborations. Data stored by HC_QRY_A19 (the request) is used by the HC_ADR_A19 collaboration (the response). The QRY/ADR request/response message pair is used to obtain patient identification and demographic data.

WebSphere MQ Workflow context data is stored in the PROCESSCONTEXT table.

This collaboration object performs the following tasks:

HC_ADR_A19 uses the generic MTADR business object to represent an HL7 Patient Query response message.

Collaboration object setup

This section includes information on port bindings and required steps for setting up collaboration objects based on HC_ADR_A19. For information on standard features, ports, and configuration properties for collaboration templates, and for general information on creating collaboration objects, refer to the documents listed in Required Documents for Creating Collaboration Objects.

Port information

The following diagram illustrates HC_ADR_A19's ports:

Note: To keep the collaboration object from using a port, bind that port to the Port connector. Doing so indicates that the port is unused without causing the collaboration object to provide additional functionality.

DestinationAppRetreive
Business object Bound to Function Verbs used
MTADR Source application's connector or calling collaboration object Sends a reference-valued business object to retrieve the full-valued business object. The result determines which verb is used. Retrieve
From
Business object Bound to Function Verbs used
MTADR Source application's connector or calling collaboration object Receives the triggering business object Create
To
Business object Bound to Function Verbs used
MQWF_ADR_A19 Destination application's connector Sends the WebSphere MQ Workflow response business object out of the collaboration object Create
Notify
Business object Bound to Function Verbs used
MTADR_action Notify collaboration object Sends an MTADR-action business object for external processing Create

Setting up HC_ADR_A19 as a stand-alone object

To set up HC_ADR_A19 as a stand-alone collaboration object, complete the following steps:

  1. Create the HC_ADR_A19 collaboration object.
  2. Bind all ports as described in Port information.
  3. Configure HC_ADR_A19 as described in Configuration properties.

Collaboration template processes

This section illustrates the business processing logic for this collaboration template.

Overall process logic

This section illustrates this collaboration template's process logic for the supported verb, Create.

Create

The following diagrams show the process logic for this collaboration template's Create verb.

Diagram showing this collaboration's SyncLogic process

     SYNC_LOGIC diagram

     Diagram showing this collaboration's Process HL7 message

     Process HL7 Message diagram

Diagram showing this collaboration's Retrieve Workflow Process Context flow

     Retrieve Workflow Process Context diagram

Diagram showing this collaboration's Update Process Context Table flow

     Update Process Context Table diagram

Diagram showing this collaboration's Process Query Results flow

     Process Query Results diagram

Diagram showing this collaboration's Create MQ Workflow Response process

     Create WorkFlow Response diagram

Diagram showing this collaboration's Notify process

     Notify diagram

Standard process logic

This collaboration template uses the following standard business processes:

Configuration properties

This section describes the standard and specific configuration properties for this collaboration.

Standard properties

This collaboration template uses the following standard configuration properties:

Collaboration-specific properties

This collaboration template has the following configuration properties specific to it:

DB_CONN_POOL_NAME

This property specifies the database connection pool.

Default value Usage
HEALTHCARE_DB Defines the database connection pool used by the collaboration.

CLEANPROCESSCONTEXT

This property specifies whether the collaboration object should perform a "soft" deletion or "hard" deletion of the process context entry on the PROCESSCONTEXT table. A hard deletion removes the entry. A soft deletion enters a timestamp and status code, which allows database maintenance of used entries as a batch or off-hours operation.

Possible values Usage
true Causes this collaboration object to delete the row
false (default value) Causes this collaboration object to update the row as a soft delete.

Related reference

Copyright IBM Corp. 2002, 2003