Running the Healthcare: HL7 to HL7 DFDL pattern
This pattern can distribute incoming messages to any number of destinations, but
for ease of development and management each pattern instance contains a maximum
of six destinations.
Before you start:
Read "Using patterns" in the IBM Integration Bus documentation.
The first instance of the pattern determines the total number of destinations
and configures all the parameters, except those that are specific to a
particular destination. For every group of six destinations that you want to use,
you must create a new pattern instance. For example, to create a pattern with 16
destinations, you must have three pattern instances.
For ease of monitoring, each pattern instance name should have a number at the
end. Increment the number by one each time you create a new pattern instance and
ensure the value of the
Part
parameter matches the number of the pattern instance. For example, if the
pattern instance has the number
3
the pattern instance name is PatternInstance3, and the value in the
Part
parameter should also be
3
.
Configuring your pattern
Configuring
a pattern with a maximum of six destinations
To configure a pattern that contains a maximum of six destinations, complete the
following steps:
-
In the
Pattern Specification
tab, click
Create New Instance
. The
New Pattern Instance
window opens.
-
Type in your pattern instance name for the first pattern instance. For ease of
monitoring, include a
1
at the end of the name, for example, PatternInstance1. Click
OK
. The
Configure Pattern Parameters
tab opens.
-
Ensure that the
Part
parameter is set to
1
, and type in the number of destinations that you want to use, for example,
6
. A
Destination n parameters
section is automatically created for each destination, where n is the
number of the destination.
-
Optional: Review the parameters for each destination and edit any that you want
to configure for that destination.
-
Click
Generate
.
-
You can now deploy your flows.
Configuring a pattern with more than six destinations
To configure a pattern that contains more than six destinations, complete the
following steps:
-
In the
Pattern Specification
tab, click
Create New Instance
. The
New Pattern Instance
window opens.
-
Type in your pattern instance name for the first pattern instance. For ease of
monitoring, include a
1
at the end of the name, for example, PatternInstance1. Click
OK
. The
Configure Pattern Parameters
tab opens.
-
Ensure that the
Part
parameter is set to
1
, and type in the total number of destinations that you want to use, for example,
16
. A
Destination n parameters
section is automatically created, where n is the number of the
destination, for each of the first group of six destinations.
-
Optional: Review the parameters for each destination and edit any that you want
to configure for that destination.
-
Click
Generate
.
-
Return to the
Pattern Specification
tab, click
Create New Instance
. The
New Pattern Instance
window opens.
-
Type in your pattern instance name for the next pattern instance, remembering to
increment the number at the end of the name by one, for example,
PatternInstance2. Click
OK
. The
Configure Pattern Parameters
tab opens.
-
Import the configuration file from the first pattern instance by clicking the
Open existing configuration
folder icon at the top of the
Pattern Parameters
table. This action ensures that all the parameters that are set in the first
pattern instance are available to correctly configure the next group of
destinations.
-
Set the
Part
parameter to
2
. A
Destination n parameters
section is automatically created, where n is the number of the
destination, for each of the second group of six destinations, each destination
has its own identifying number 7 - 12.
-
Optional: Review the parameters for each destination and edit any that you want
to configure for that destination. If a pattern parameter inherits its
configuration from the first pattern instance, the parameter is disabled.
-
Click
Generate
.
-
Repeat steps 6 - 11 for each pattern instance that you need to create, replacing
the pattern instance number and the
Part
parameter value as appropriate until you have a pattern instance for each of
your destinations.
-
You can now deploy your flows.
Queue and flow names
The names of the flows and queues are created automatically when you generate
the pattern:
-
Each Sender flow and Destination subflow is named to reflect its destination
number. For example, if the destination number is 8, the flow names also contain
the number 8.
-
The queue name for the TransformAndRoute flow reflects the value of the
Part
parameter. For example, the queue name for the pattern instance that contains
the second group of destinations is QueuePrefix.RXF2
-
The queue name for each Sender flow also contains the number of the destination.
-
Other queues are shared between the pattern instance projects because, although
each pattern instance is identified independently, the pattern instances are
managed as a single pattern instance driven from a single source application.
Deploying your pattern instance
To deploy your pattern instance:
-
In the
Application Development
view, for Part 1 of the pattern, drag the generated HL7toHL7DFDL application onto the integration server in the
Integration Nodes
view.
The pattern is now running, and messages can be sent.