Exercise 9.1 – REST Services

Create a Route

1. 1. From the eiConsole File Management screen, select the Add Route button.
   2. In the dialog that appears, enter the route name Restful Echo Services and select OK.
   3. The Route should now appear in the table on the screen. Double-click it to open.

Document Source System

1. 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 Postman Request.
   3. Select the Choose Source Icon button, and scroll down to select an icon.

Configure the Listener

1. 1. Select the Listener stage in the Route Editing Grid. The configuration panel will appear at the bottom.
   2. Select RESTful Web Service 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 want.
   3. For Rest Service Name, enter PeopleDirectory and for Support Resources, enter Person.
   4. On the Advanced tab, select the Synchronous check box.
   5. On the Advanced tab. Add an HTTP Header. Name it Content-Type with Value application/xml.

Configure the Transport

1. 1. Select the Transport stage in the Route Editing Grid. The configuration panel will appear at the bottom.
   2. Select Synchronous Response from the Transport Type selection box.
   3. Name the Transport Name Get Synchronous Response.
   4. Select Add Target to add an additional Target.
   5. Select Synchronous Response from the Transport Type selection box.
   6. Name the Transport Name Post Synchronous Response.

Document the Target Systems

1. 1. Select each Target System stage in the Route Editing Grid. The configuration panel will appear at the bottom.
   2. Change the System Name to Get Request Echo for the Get Synchronous Response Transport.
   3. Change the System Name to Post Request Echo for the Post Synchronous Response Transport.
   4. Select each Choose Target Icon button, and scroll down to select one of the icons.

Configure the Route Stage

1. 1. Select the Route stage in the Route Editing Grid. The configuration panel will appear at the bottom.
   2. Select the Routing Rules tab.
   3. In the Routing Module dropdown, select XPath/Attribute.
   4. Right Click Rules and select Add Rule. In the Expression dropdown, select Transaction Attribute Query. In the Transport, select the Get Synchronous Response Transport and hit OK.
   5. Select the Attribute under the Rule in the left pane. In the right pane, select com.pilotfish.HttpMethodName as the Attribute Name, Operator to = and Attribute Value type GET.
   6. Right Click Rules and select Add Rule. In the Expression dropdown, select Transaction Attribute Query. In the Transport, select the Post Synchronous Response Transport and hit OK.
   7. Select the Attribute under the Rule in the left pane. In the right pane, select com.pilotfish.HttpMethodName as the Attribute Name, Operator to = and Attribute Value type POST.

Prepare to Test

1. 1. In the menu bar at the top, select Mode -> Testing Mode. Make sure the changes to the Route are saved.

Perform the Test

1. 1. At the top of the Testing Mode screen, select the Execute Test button.
   2. Create a Postman request to the URL. Copy the URL from the screen above.
      http://localhost:9000/eiConsole/rest/
      Remember to add /PeopleDirectory/People to the URL above.
      http://localhost:9000/eiConsole/rest/PeopleDirectory/People
      PeopleDirectory is the Rest Service name from the Listener.
      People is the Supported Resources name from the Listener.
      Select and copy the data from the person.xml file and paste it into the raw Body section of Postman.
      Note: The port number may vary depending on the number of times the test has been launched.
   3. Submit a POST request and a GET request while viewing the Route and data flow.