Create a Service Consumption Model

1. Create a new package for the mission, by:

   • selecting your project
   • selecting ZLOCAL
   • if necessary, selecting your user package
   • then choosing New > ABAP Package from the context menu.

2. Enter a name, Z_A4C_TO_A4C_XXX, and description, Access service from ABAP Environment and choose Next.

3. If asked, specify the software component ZLOCAL and choose Next.

4. Accept or create a transport request and choose Finish.

5. Add the package to Favorite Packages by choosing this from the context menu.

Now you need to access the OData service metadata. You derive this from the service URL, available from the service binding.
Later you will use the service metadata to create the service consumption model file (EDMX file), for consumption on the client system.

1. First, create a new Service Binding from the Service Definition, /DMO/TRAVEL_U, by selecting /DMO/TRAVEL_U and choosing New Service Binding from the context menu. Search for this object by choosing **Open ABAP Development Object ( Ctrl+Sh+A ).

   

2. In the wizard:

   • Choose the correct package, that is, your package, not /DMO/...
   • Delete the namespace /DMO/ and enter a name: Z_BIND_TRAVELS_XXX and description Bind Travels Service
   • Enter the binding type: ODATA V2 - Web API
   • Choose Next
   

3. Accept the transport request and choose Finish.

The service binding opens in a new editor.

1. Choose Activate.

   On the left is the Service Definition, /DMO/TRAVEL_U.
   Now, on the right, is the active service, including the Entity Set and the Service URL.

   

2. Click on the link Service URL. The XML file is shown in the browser.

3. Add the suffix /$metadata to the Service URL (deleting parameters, such as sap-client).

   

   The service metadata appears.

4. Choose Save As… from the context menu. The file name should be pre-filled as $metadata.xml.

5. Navigate to an appropriate folder and choose Save.

1. As in step 1, create a package in your ZLOCAL package, in the client system: Z_A4C_TO_A4C_XX2.

2. Add it to Favorite Packages.

You will now use the EDMX file that you stored locally to create the necessary ABAP proxy artifacts in the client system.

1. Select your package and choose New > Other ABAP Repository Object from the context menu.

2. Enter the filter text service and choose Service Consumption Model.

3. Enter a name, Z_MODEL_TRAVELS_XXX , and description Consumption model for Travels - client.

4. Using Browse…, navigate to your $metadata file, choose Open, then choose Next.

5. Again, deselect all entity sets except Travel, make sure ETag Support is selected for it, then choose Next.

6. The same list of ABAP artifacts appears. Choose Next.

7. Accept the transport request and choose Finish.

Again, the Service Consumption Model appears in a new editor.

The code for your abstract entity, ZTRAVEL** or **ZTRAVEL<10-digit-GUID>` should look like this:

/********** GENERATED on 01/21/2020 at 12:05:38 by CB0000000016**************/
 @OData.entitySet.name: 'Travel'
 @OData.entityType.name: 'TravelType'
 define root abstract entity ZTRAVELF7FB77AE54 {
 key TravelID : abap.numc( 8 ) ;
 @Odata.property.valueControl: 'AgencyID_vc'
 AgencyID : abap.numc( 6 ) ;
 AgencyID_vc : RAP_CP_ODATA_VALUE_CONTROL ;
 @Odata.property.valueControl: 'AgencyID_Text_vc'
 AgencyID_Text : abap.char( 80 ) ;
 AgencyID_Text_vc : RAP_CP_ODATA_VALUE_CONTROL ;
 @Odata.property.valueControl: 'CustomerID_vc'
 CustomerID : abap.numc( 6 ) ;
 CustomerID_vc : RAP_CP_ODATA_VALUE_CONTROL ;
 @Odata.property.valueControl: 'CustomerID_Text_vc'
 CustomerID_Text : abap.char( 40 ) ;
 CustomerID_Text_vc : RAP_CP_ODATA_VALUE_CONTROL ;
 @Odata.property.valueControl: 'BeginDate_vc'
 BeginDate : RAP_CP_ODATA_V2_EDM_DATETIME ;
 BeginDate_vc : RAP_CP_ODATA_VALUE_CONTROL ;
 @Odata.property.valueControl: 'EndDate_vc'
 EndDate : RAP_CP_ODATA_V2_EDM_DATETIME ;
 EndDate_vc : RAP_CP_ODATA_VALUE_CONTROL ;
 @Odata.property.valueControl: 'BookingFee_vc'
 @Semantics.amount.currencyCode: 'CurrencyCode'
 BookingFee : abap.curr( 17, 3 ) ;
 BookingFee_vc : RAP_CP_ODATA_VALUE_CONTROL ;
 @Odata.property.valueControl: 'TotalPrice_vc'
 @Semantics.amount.currencyCode: 'CurrencyCode'
 TotalPrice : abap.curr( 17, 3 ) ;
 TotalPrice_vc : RAP_CP_ODATA_VALUE_CONTROL ;
 @Odata.property.valueControl: 'CurrencyCode_vc'
 @Semantics.currencyCode: true
 CurrencyCode : abap.cuky ;
 CurrencyCode_vc : RAP_CP_ODATA_VALUE_CONTROL ;
 @Odata.property.valueControl: 'Memo_vc'
 Memo : abap.char( 1024 ) ;
 Memo_vc : RAP_CP_ODATA_VALUE_CONTROL ;
 @Odata.property.valueControl: 'Status_vc'
 Status : abap.char( 1 ) ;
 Status_vc : RAP_CP_ODATA_VALUE_CONTROL ;
 @Odata.property.valueControl: 'LastChangedAt_vc'
 LastChangedAt : tzntstmpl ;
 LastChangedAt_vc : RAP_CP_ODATA_VALUE_CONTROL ;
 ETAG__ETAG : abap.string( 0 ) ;

 }

Since you are implementing the query manually, you need to use a custom entity as your data model.

1. Select your package and choose New > Other > Core Data Services > Data Definition from the context menu.

2. Enter a name, ZCE_TRAVEL_DATA_XXX, and description, Travel data custom entity - client, then choose Next.

3. Accept the transport request and choose Next (not Finish).

4. Choose the template Define custom entity with Parameters, then choose Finish.

   The CDS custom entity appears in a new editor.

5. Remove the parameters statement and paste in the code below, between the curly brackets. Afterwards, your custom entity should now look as follows. Make sure the types of the fields match those in the abstract entity.

   Custom entities do not come with a select on the data source. Therefore, you will later implement the data retrieval logic in a new ABAP class, referenced in an entity annotation.

   ABAP

   Copy

   @EndUserText.label: 'Travel data custom entity - client'
   define custom entity ZCE_TRAVEL_DATA_XXX
    {
      key TravelID               : abap.numc( 8 ) ;
         AgencyID               : abap.numc( 6 ) ;
         CustomerID             : abap.numc( 6 ) ;
         BeginDate              : rap_cp_odata_v2_edm_datetime ;
         EndDate                : rap_cp_odata_v2_edm_datetime ;
         @Semantics.amount.currencyCode: 'CurrencyCode'
         BookingFee             : abap.dec( 17, 3 ) ;
         @Semantics.amount.currencyCode: 'CurrencyCode'
         TotalPrice             : abap.dec( 17, 3 ) ;
         @Semantics.currencyCode: true
         CurrencyCode           : abap.cuky( 5 ) ;
         Description            : abap.char( 1024 ) ;   //renamed element
         Status                 : abap.char( 1 );
         LastChangedAt          : tzntstmpl ;
   
         CalculatedEtag         : abap.string( 0 ) ;  
   }