Log out?

Exercise 2.1 – Environment Properties

Purpose:

To practice using Environment Properties when building a Route.



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

    C


  3. Configure Environment Properties
    1. From the top menu bar, select “Route” -> “Environment Properties”. The “Environment Properties Dialog” will open.
    2. All properties will be entered in the top table. The “Key” and “Value” cells need to be filled out, the “Ancestor Value” cell is not editable and will be left blank.
    3. The first property should have a “Key” of “input.directory”. The second property should have a “Key” of “output.directory”.
    4. Select the “Value” cell of the first property. At the bottom of the dialog, a button called “Add Folder Path” should now be enabled. Select it to open a file chooser, and select the directory that will be the input directory for the Route.
    5. Select the “Value” cell of the second property, and select “Add Folder Path” to open the file chooser. Select the directory that will be the output directory for the Route.
    6. Select the “Save” button at the bottom of the dialog to save the changes. Selec the “Close” button to close the dialog.

    A

    C-E


  4. Initial Listener Configuration
    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.

    B


  5. Configuring Listener Polling Directory With Environment Properties
    1. For the “Polling Directory”, choose the button on the very far right of the field to open the “Enhanced Settings” panel. New buttons and a new text field should appear.
    2. Of the new buttons, one of them has an icon of a notepad on it. This is the “Environment Properties” button. Select it to open the “Environment Properties Dialog”.
    3. In the “Environment Properties Dialog”, select the “input.directory” property row, and click the “Select” button at the bottom.
    4. The “Polling Directory” field is now populated with the value of the “Environment Property”.

    A

    B

    C

    D


  6. Initial Transport Configuration
    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. Set “environment-property-output” as the “Target File Name”.
    4. Set “xml” as the “Target File Extension”.

    C-D


  7. Configure Transport Target Directory With Environment Properties
    1. For the “Target Directory”, choose the button on the very far right of the field to open the “Enhanced Settings” panel. New buttons and a new text field should appear.
    2. Of the new buttons, one of them has an icon of a notepad on it. This is the “Environment Properties” button. Select it to open the “Environment Properties Dialog”.
    3. In the “Environment Properties Dialog”, select the “output.directory” property row, and click the “Select” button at the bottom.
    4. The value of the property is now populated as the “Target Directory”.

    C

    D


  8. 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

    C


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

    A


  10. 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. In the OS File Explorer, open the directory selected as the “Target Directory”. The file “environment-property-output.xml” should be there, with contents identical to the “people.xml” input file.

    A

    B


  11. Output Files
    1. Compare the results from the exercise with the following example output files to see if they are correct.
      1. environment-property-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