README.md

Exercise 5 - Business Service

Introduction

In the previous exercise you've created the metadata extensions for the travel and the booking projection views (see Exercise 4 or the Fast track version Exercises 1-4).

In this exercise you will expose your projected CDS data model as OData service using business services – i.e. service definition and service binding.

Further information can be found here: Business Service

Exercise 5.1 - Create the Service Definition

The service definition specifies the service scope, i.e. the relevant entity sets to be exposed in the service.

1. In the Project Explorer, right-click on the Travel BO projection view ZC_RAP_TRAVEL_#### and select New Service Definition from the context menu.

   

2. Maintain ZUI_RAP_Travel_#### (where #### is your group ID) as name and a description (e.g. Serv Definition for Travel App ) in the creation wizard and choose Next > to continue.

   

3. Assign a transport request and choose Finish. Replace the code in the editor with the code snippet provided below. Do not forget to replace all the occurrences of #### with your group ID.

   @EndUserText.label: 'Serv Definition for Travel App'
   define service ZUI_RAP_TRAVEL_#### {
     expose ZC_RAP_Travel_#### as Travel;
     expose ZC_RAP_Booking_#### as Booking;
     expose /DMO/I_Agency as Agency;
     expose /DMO/I_Customer as Customer;
     expose /DMO/I_Flight as Flight;
     expose /DMO/I_Carrier as Carrier;
     expose /DMO/I_Connection as Connection;
     expose /DMO/I_Airport as Airport;
     expose I_Currency as Currency;
     expose I_Country as country;
   }
   

   The service definition will look as follows:

   

4. Save and activate the service definition.

Exercise 5.2 - Create the Service Binding

The service binding binds your service definition to the required protocol.

1. Right-click on the just created service definition ZUI_RAP_TRAVEL_#### in the project Explorer and choose New Service Binding from the context menu.

   

2. Maintain ZUI_RAP_TRAVEL_O4_#### (where #### is your group ID) as name and a description (e.g. OData V4 UI service for SAP Fiori Travel App, choose OData V4 - UI as Binding Type and choose Next > to continue.

   

3. Assign a transport request and choose Finish. The editor opens with the created service binding.

   

4. Activate the service binding which enables the Publish button. Click on Publish.

   

5. This locally publishes the service binding, providing access authorization to all users with a developer role. On the right-hand-side of the Service Binding editor, the relative service URL and the exposed entity sets as well as associations are shown.

   

Exercise 5.3 - Preview the Travel App

1. In the service binding, choose the Travel node in Entity Set and Association area and either right-click on it and choose Open Fiori elements App preview from the context menu or simply double-click on it – or choose the Preview button.

   

   Your SAP Fiori elements-based Travel List Report app will open in the browser. You might need to provide your login information (email address / password) to connect to the trial account.

   Note: In case you are getting an Application could not be started due to technical issues., Service group '...' not published error please wait some time and refresh F5 the browser. It may take a while until the app servers are synchronized. There is no need to e.g. unpublish/publish the service again.

2. Press the Go button to load the data.

   

   You can now explore the Travel App. For example,

   • Filter bar: Filter the entries by an AgencyID using the defined value help
   • Perform a full text search (e.g. for Pan)
   • Navigate to the detail object page of a travel record in the travel table list.
   • Check out the travel object page with its two facets Travel and Booking and navigate to the booking object page.

Summary

Now that you've...

• created the service definition specifying the scope of the service exposure,
• created an OData V4 service binding and published it locally, and
• used the SAP Fiori Elements App Preview to run the app,

you can continue with - Exercise 6 - Business Object Behavior

Appendix

Find the source code for the service definition in the sources folder. Don't forget to replace the placeholder #### with your group ID.

• Service Definition ZUI_RAP_TRAVEL_####