Log out?

Exercise 1.2 – Using a Processor

Purpose:

To practice building a Route using a Processor to perform extra operations on the data.



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 “Using a Processor” and select “OK”.
    3. The Route should now appear in the table on the screen. Double click it to open it.


  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 “XML File”
    3. Select the “Choose Source Icon” button, and scroll down to select one of the XML icons


  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.


  4. Configure the Processor
    1. Select the “Processor Configuration” tab, next to the already selected “Listener Configuration” tab.
    2. Click the “Add Processor” button in the new configuration panel. The “Add Processor” dialog will appear.
    3. Select the “Regular Expression (RegEx)” processor from the “Processor 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. After clicking “Add”, the configuration panel will be updated. The processor will appear in the table in the middle, and its configuration items will appear in the bottom panel.
    5. Add a row to the “Terms and Replacements” table in the processor configuration, using the “+” button below it.
    6. In the “RegEx” cell, set the value to be “Person”
    7. In the “Replacement” cell, set the value to be “Robot”


  5. Configure the 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. Select the “Target Directory”, using the “…” button to open the file chooser.
    4. Set “regex-xml-output” as the “Target File Name”.
    5. Set “xml” as the “Target File Extension”.


  6. Document the 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 “XML File”
    3. Select the “Choose Target Icon” button, and scroll down to select one of the XML icons


  7. 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. Copy the file called “people.xml” from the “Samples” directory provided into the directory chosen as the polling directory.


  8. Perform the Test
    1. At the top of the “Testing Mode” screen, select the “Execute Test” button.
    2. If the “Route” was configured successfully, all the Stages should light up with green checkmarks.
    3. Select the “Transport” stage. The configuration panel will appear at the bottom.
    4. Select the “View Stage Output” button at the bottom. The “Results Viewer” will appear, displaying the outcome of the test.
    5. In the “Results Viewer” should be the output data. All the places where the input data said “Person” should now say “Robot”.


  9. Output Files
    1. Compare the results from the exercise with the following example output files to see if they are correct.
      1. regex-xml-output.xml


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

Thanks!

Our editors are notified.

Close