Log out?

Exercise 3.2 – Routing Transactions

Purpose:

To practice using routing to determine which Target systems a transaction is sent to



Steps:

  1. Create a Route
    1. From the eiConsole File Management screen, select the “Add Route” button.
    2. In the dialog that appears, enter the name “Routing” and select “OK”.
    3. The Route should now appear in the table on the screen. Double click it to open it.

    C


  2. Document Source System
    1. Select the “Source System” stage in the “Route Editing Grid”. The configuration panel will appear at the bottom.
    2. Change the “System Name” to “Text File”
    3. Select the “Choose Source Icon” button, and scroll down to select one of the generic “File” icons.

    C


  3. Configure the Listener
    1. Select the “Listener” stage in the “Route Editing Grid”. The configuration panel will appear at the bottom.
    2. Select “Directory / File” from the “Listener Type” selection box. Optionally, click the “…” button to open the Module Search Dialog, which provides a faster way to find the module you’re looking for.
    3. Assign a polling directory, using the “…” button to open the file chooser. The polling directory should NOT be the directory with all the sample files, since files will be moved/deleted by the listening process.

    C


  4. Configure the First Transport
    1. Select the “Transport” stage in the “Route Editing Grid”. The configuration panel will appear at the bottom.
    2. Select “Directory / File” from the “Transport Type” selection box. Optionally, click the “…” button to open the Module Search Dialog, which provides a faster way to find the module you’re looking for.
    3. In the “Transport Name” field, change the name to “TransportA”.
    4. Select the “Target Directory”, using the “…” button to open the file chooser.
    5. Set “outputA” as the “Target File Name”.
    6. Set “txt” as the “Target File Extension”.

    C-F


  5. Document the First Target System
    1. Select the “Target System” stage in the “Route Editing Grid”. The configuration panel will appear at the bottom.
    2. Change the “System Name” to “Output File”
    3. Select the “Choose Target Icon” button, and scroll down to select one of the generic “File” icons.

    C


  6. Configure the Second Transport
    1. Click the “Add Target” button at the top of the screen to add a second target path.
    2. Select the “Transport” stage in the “Route Editing Grid” for the second target. The configuration panel will appear at the bottom.
    3. Select “Directory / File” from the “Transport Type” selection box. Optionally, click the “…” button to open the Module Search Dialog, which provides a faster way to find the module you’re looking for.
    4. In the “Transport Name” field, change the name to “TransportB”.
    5. Select the “Target Directory”, using the “…” button to open the file chooser.
    6. Set “outputB” as the “Target File Name”.
    7. Set “txt” as the “Target File Extension”.

    A

    D-G


  7. Document the Second Target System
    1. Select the “Target System” stage in the “Route Editing Grid” for the second target. The configuration panel will appear at the bottom.
    2. Change the “System Name” to “Output File”
    3. Select the “Choose Target Icon” button, and scroll down to select one of the generic “File” icons.

    C


  8. Configure the Routing Module
    1. Select the “Route” stage from the “Route Editing Grid”. The configuration panel will appear at the bottom.
    2. In the configuration panel, select the tab that says “Routing Rules”, to open the configuration for routing to multiple Transports.
    3. Enable the use of “Routing Rules” by selecting the “XPath/Attribute” option from the “Routing Module” selection box. The rules configuration panel will now appear.
    4. The left-hand section of the panel is the “Rules Tree”. It has only one Node right now, which simply says “Rules”.
    5. Right click on the “Rules” node, and select “Add Rule”. A new node, called “Rule”, should appear under it.
    6. Repeat the previous step, so that there are now two “Rule” Nodes beneath the “Rules” node.
    7. Configure the first “Rule”.
      1. Right click on the first “Rule” node. Hover over the “Set Expression” sub-menu, and more options will appear. Select “Transaction Attribute Query” from these new options. A new node will now appear under “Rule”, called “Attribute”.
      2. Select the new “Attribute” node. A new configuration panel will appear to the right.
      3. For “Attribute Name”, enter “com.pilotfish.FileName”. For “Operator”, make sure that “=” is selected. Finally, for “Attribute Value”, enter “A”. The expression is now configured.
      4. Right click on the first “Rule” node again. Hover over “Add Target”, and more options will appear. Select “Transport Target” from the new options. A new node will now appear under “Rule”, called “Transport”.
      5. Select the new “Transport” node. A new configuration panel will appear to the right.
      6. For “Transport Name”, select “TransportA” from the selection box.
      7. The rule is now configured.
    8. Configure the second “Rule”.
      1. Right click on the second “Rule” node. Hover over the “Set Expression” sub-menu, and more options will appear. Select “Transaction Attribute Query” from these new options. A new node will now appear under “Rule”, called “Attribute”.
      2. Select the new “Attribute” node. A new configuration panel will appear to the right.
      3. For “Attribute Name”, enter “com.pilotfish.FileName”. For “Operator”, make sure that “=” is selected. Finally, for “Attribute Value”, enter “B”. The expression is now configured.
      4. Right click on the second “Rule” node again. Hover over “Add Target”, and more options will appear. Select “Transport Target” from the new options. A new node will now appear under “Rule”, called “Transport”.
      5. Select the new “Transport” node. A new configuration panel will appear to the right.
      6. For “Transport Name”, select “TransportB” from the selection box.
      7. The rule is now configured.

    C

    E

    F

    G.i

    G.iii

    G.vi

    H


  9. Prepare to Test
    1. In the menu bar at the top, select “Route” -> “Testing Mode”. Make sure the changes to the Route are saved.
    2. Find the two sample files called “A.txt” and “B.txt”. Do NOT copy them to the polling directory yet.

    A


  10. Test With First File
    1. Copy the “A.txt” file to the polling directory, and select the “Execute Test” button at the top of the “Testing Mode” screen.
    2. If the “Route” was configured successfully, green checkmarks should appear across the screen. However, the path of the green checkmarks should only go to “TransportA”. Nothing should reach “TransportB”.
    3. Stop the test. Copy the “B.txt” file to the polling directory, and then select “Execute Test” again.
    4. If the “Route” was configured successfully, green checkmarks should appear across the screen. However, this time, the path of the green checkmarks should only go to “TransportB”. Nothing should reach “TransportA”.

    B

    D


  11. Output Files
    1. Compare the results from the exercise with the following example output files to see if they are correct.
      1. outputA.txt
      2. outputB.txt

This is a unique website which will require a more modern browser to work! Please upgrade today!

Thanks!

Our editors are notified.

Close