Create and Expose Core Data Services Based on a Database Table

0 %

Create and Expose Core Data Services Based on a Database Table

Details

Create and Expose Core Data Services Based on a Database Table

2020-02-13

Beginner

10 min.

Build a list report app with the ABAP RESTful programming model for SAP Fiori and test your UI for demo usage.

You will learn

How to create a database table
How to create Core Data Services

Prerequisites

SAP Cloud Platform ABAP Environment user
Business Catalog SAP_CORE_BC_EXT_TST assigned to your business user
Initial development setup

In this tutorial, wherever XXX appears, use a number (e.g. 000).

Step 1: Open Eclipse

Select to your ABAP package created in tutorial Create Simple Database Table for ABAP Environment and create a Core Data Services (CDS) data definition.
Therefore right-click on your package Z_BOOKING_XXX and select New > Other Repository Object.

Done

Log on to answer question

Step 2: Create data definition

Search for data definition, select it and click Next.
Enter a name and a description for your data definition ZI_BOOKING_XXX.
Select a new transport request and click Next.
Select Define View template and press Finish.

Done

Log on to answer question

Step 3: Specify SQL view

View Full Instructions

Specify the sql view name in the view definition as ZV_BOOKING_XXX.
Specify your data source after the select from statement as ztbooking_xxx.

Specify your data definition as shown below. The keyword key is used to specific a key element and the keyword as is used to define alias names. The two associations I_Country and I_Currency are defined and exposed in the projection. The element CurrencyCode is specified as currency key for the element Cost which is an amount field. The view entity is specified as searchable using the view annotation @Search.searchable: true and the element CustomerName is specified as default search element using the element annotation @Search.defaultSearchElement: true.

@AbapCatalog.sqlViewName: 'ZV_BOOKING_XXX'
@AbapCatalog.compiler.compareFilter : true
@AbapCatalog.preserveKey: true
@AccessControl.authorizationCheck: #CHECK
@EndUserText.label : 'Data Definition Booking'
@Search.searchable : true
define view ZI_BOOKING_XXX
   as select from ztbooking_xxx as Booking
   association [0..1] to I_Country  as _Country  on $projection.country = _Country.country
   association [0..1] to I_Currency as _Currency on $projection.CurrencyCode = _Currency.Currency

   {
     key booking              as Booking,
         @Search.defaultSearchElement: true
         customername         as CustomerName,
         numberofpassengers   as NumberOfPassengers,
         emailaddress         as EmailAddress,
         country,
         dateofbooking        as DateOfBooking,
         dateoftravel         as DateOfTravel,
         @Semantics.amount.currencyCode: 'CurrencyCode'
         cost,
         @Semantics.currencyCode: true
         currencycode          as CurrencyCode,
         lastchangedat         as LastChangedAt,

         _Country,
         _Currency       
}

Save and activate.

Done

Log on to answer question

Step 4: Add UI annotation

View Full Instructions

Go back to the data definition and used the @UI annotations to add the UI-specific semantics. Add following UI annotation in front of your data definition.
```
    @UI: {
  headerInfo: {
  typeName: 'Booking',
  typeNamePlural: 'Bookings',
  title: { type: #STANDARD, value: 'Booking' }
  }
}
```

Replace your code with following:

@AbapCatalog.sqlViewName: 'ZV_BOOKING_XXX'
@AbapCatalog.compiler.compareFilter : true
@AbapCatalog.preserveKey: true
@AccessControl.authorizationCheck: #CHECK
@EndUserText.label : 'Data Definition Booking'
@Search.searchable : true

@UI:
{
 headerInfo:
  {
    typeName: 'Booking',
    typeNamePlural: 'Bookings',
    title: { type: #STANDARD, value: 'Booking' }
  }
 }

define view ZI_Booking_XXX
  as select from ztbooking_xxx as Booking
  association [0..1] to I_Country  as _Country  on $projection.country = _Country.Country
  association [0..1] to I_Currency as _Currency on $projection.CurrencyCode = _Currency.Currency
{

      @UI.facet: [
        {
          id:       'Booking',
          purpose:  #STANDARD,
          type:     #IDENTIFICATION_REFERENCE,
          label:    'Booking',
          position: 10 }
      ]


      @UI: {
          lineItem: [ { position: 10, importance: #HIGH, label: 'Booking ID' } ],
          identification:[ { position: 10, label: 'Booking ID' } ]
          }
  key booking                                as Booking,

      @UI: {
        lineItem: [ { position: 20, label: 'Customer', importance: #HIGH } ],
        identification:[ { position: 10, label: 'Customer' } ]
      }
      @Search.defaultSearchElement: true
      customername                           as CustomerName,

      @UI: {
      lineItem: [ { position: 30, label: 'No of Passengers', importance: #HIGH } ],
      identification:[ { position: 30, label: 'No of Passengers' } ]
      }
      numberofpassengers                     as NumberOfPassengers,

      @UI: {
           identification:[ { position: 40, label: 'Email' } ]
       }
      emailaddress                           as EmailAddress,

      @UI: {
           identification:[ { position: 50, label: 'Country' } ]
       }
      country,

      @UI: {
           identification:[ { position: 60, label: 'Booked On' } ]
       }
      dateofbooking                          as DateOfBooking,

      @UI: {   identification:[ { position: 70, label: 'Traveling on' } ]    }
      dateoftravel                           as DateOfTravel,


      @UI: {
      lineItem: [ { position: 40, label: 'Cost', importance: #HIGH } ],
      identification:[ { position: 80, label: 'Cost' } ]
      }
      @Semantics.amount.currencyCode: 'CurrencyCode'
      cost,

      @UI: { identification:[ { position: 90, label: 'Currency' } ]     }
      @Semantics.currencyCode: true
      currencycode                           as CurrencyCode,

      @UI: { identification:[ { position: 100, label: 'Last Changed At' } ] }
      lastchangedat                          as LastChangedAt,

      //public associations
      _Country,
      _Currency
}

Save and activate your data definition.

Done

Log on to answer question

Step 5: Create service definition

Right-click on your data definition ZI_BOOKING_XXX and select New Service Definition
Create a service definition and call it Z_I_BOOKING_XXX.
Click Finish to complete your transport request.

Done

Log on to answer question

Step 6: Expose entities

View Full Instructions

Expose the ZI_Booking_XXX and the I_Country view entities.

  @EndUserText.label: 'Service Definition for Booking'

  define service Z_I_Booking_XXX {
  expose ZI_Booking_XXX as Booking;
  expose I_Country  as Country;
  }

Save and activate your service definition.

Done

Log on to answer question

Step 7: Create service binding

Right-click on your service definition Z_I_BOOKING_XXX and select New Service Binding.
Create a service binding and name it Z_I_BOOKING_XXX.
Make sure that OData V2 - UI is selected as binding type.

Click Next >.
Click Finish to complete your transport request.

Done

Log on to answer question

Step 8: Activate your service binding

Click Activate to publish your service binding.

Done

Log on to answer question

Step 9: Check your metadata

Click on the Service URL to see your result.
Sign in with your communication user and password.
Check your result:

Done

Log on to answer question

Step 10: Open SAP Fiori elements view

Go back to your service binding Z_I_BOOKING_XXX
Open the preview for SAP Fiori elements app on the right side with double-clicking or right click.
Login with your username and password.
To set some filter click on settings icon.
Select fields that shall be displayed or select all and click on OK.
Click on GO.
Check your result: