REST Reference Tutorial

The REST reference tutorial shows you how to create a simple REST Invoke to an existing REST Service defined by a Swagger specification.

You cannot convert REST reference to SOAP or vice versa.

Prerequisites

The REST service which you want to consume has to be deployed in your Cloud Foundry environment.

Creating a New Application

  1. Open TIBCO Business Studio™ for BusinessWorks™.
  2. Open the Design perspective by clicking the Design icon in the upper right corner.
  3. Click File > New > Other > BusinessWorks > BusinessWorks Application Module and click Next.
  4. Enter in the Project Name text box. Do not change the remaining default settings. Click Finish. This will create a new application module with an empty process.
Note: The REST service for which you want to obtain the Swagger file must be running. In this example the tibco.bwce.sample.binding.rest.BookStore.application should be deployed in your Cloud Foundry environment.
To obtain a Swagger file for a REST service, do the following:
  1. Append swagger to the routable URL to access the Swagger doc. The format is http://<routable url>/swagger.
  2. Enter http://<routable url>/swagger/swagger.json in the browser and copy entire JSON file to Books.json file.

Importing the JSON File into your Project

  1. In the Project Explorer, expand tibco_bwce_sample_binding_rest application module.
  2. Right-click Service Descriptors and select Import > Import... > General > File System and click Next.
  3. In the File system dialog, click the Browse button and browse to the location of the Books.json file.
  4. Select the check box next to Books.json in the left pane and click Finish.

Creating the REST Reference

  1. In the Project Explorer, expand the tibco_bwce_sample_binding_rest Service Descriptors folder completely .
  2. Select the /books under Books.json and drag and drop it to the right side of the process in the Process Editor. The references are added to the process. The purple chevron indicates the service and its operations.

  3. In the Process Editor, right-click Add Activity > General Activities > Timer. Optionally, you can configure the Sleep activity with IntervalInMillisec as 3000 in a similar manner and connect the Timer with Sleep.
  4. Drag the get operation under the purple chevron and drop it on the right of Timer activity (or Sleep if configured) and connect the Timer activity with the get activity.
  5. Drag the post operation under the purple chevron and drop it on the right of the get activity , connect the get activity with the post activity .
  6. Right-click the get activity select Show Properties View.
  7. In the Properties view, select the Input tab and click Show Check and Repair icon in the icon bar on the upper right corner of the Properties view.
  8. Select the check box under Fix and click OK.
  9. Click Show Check and Repair icon again. Select the check box under Fix and click OK.
  10. Select the post activity and right click and select Show Properties View. In the Properties View, select the Input tab and select Data Source tab.
  11. Expand $getin the Data Source tab completely.
  12. In the XPath Expression pane, expand the post-input completely.
  13. Drag and drop Book* from the Data Source tab to the Book* under post-input in the XPath Expression pane.
  14. In the Drop dialog, select Make a copy of each "book" radio button and click Finish.
  15. Click Show Check and Repair icon in the icon bar on the upper right corner of the Properties view.
  16. Select the check box under Fix and click OK.
  17. Click Show Check and Repair icon again. Select the check box under Fix and click OK.
  18. In the Project Explorer, select Books.json under Service Descriptors of tibco_bwce_sample_binding_rest_basic application module, and right click Open With > Text Editor and locate the "host" attribute. Make a note of the host name and port number.

  19. Expand the Resources folder under the tibco_bwce_sample_binding_rest_basic application module completely.
  20. Double-click HttpClientResource.httpClientResource.
  21. In the HTTP Client section, change the Default Host and Default Port to the values in the Books.json file you obtained in step 18 above.

  22. Click File > Save All.

Testing the REST Reference

You can now test the REST service using the built-in tester and the Swagger UI. To do so follow these steps:
  1. Click Run > Debug Configuration.
  2. In the left pane of the Debug Configuration wizard, expand BusinessWorks Application and select BWApplication.
  3. Click the Applications tab and then click Deselect All if you have multiple applications. Select the check boxes next to tibco_bw_sample_binding_rest_basic_application.
  4. Click Debug. This runs the sample in debug mode. The Console view is opened and shows engine messages similar to: Started BW Application [ tibco_bwce_sample_binding_rest_basic_application:1.0]
  5. In the Debug view, expand BWApplication [BusinessWorks Application] > <launched> BWEclipseAppNode > tibco_bwce_sample_binding_rest_Process and select get.
  6. In the JobData view, you can see the job data of the get activity.