CDS, EML

While all examples and snippets in our documentation are designed for compatibility without requiring CDS or EML, you can leverage these modern ABAP features in your abap2UI5 applications if you're using the latest ABAP releases.

ABAP CDS

ABAP Core Data Services (CDS) enable you to define powerful views and consume data directly from the database. The following example demonstrates how to fetch sales orders using the I_SalesOrder view from the Virtual Data Model (VDM) and display them in a UI5 table:

CLASS z2ui5_cl_sample_cds DEFINITION PUBLIC CREATE PUBLIC.

  PUBLIC SECTION.
    INTERFACES z2ui5_if_app.
    DATA mt_salesorder TYPE STANDARD TABLE OF I_SalesOrder WITH EMPTY KEY.

ENDCLASS.

CLASS z2ui5_cl_sample_cds IMPLEMENTATION.
  METHOD z2ui5_if_app~main.

    SELECT FROM I_SalesOrder
     FIELDS salesorder, salesordertype, salesorganization
     INTO TABLE @mt_salesorder
     UP TO 10 ROWS.

    DATA(view) = z2ui5_cl_xml_view=>factory( )->page( ).
    DATA(table) = view->table( client->_bind( mt_salesorder ) ).
    table->columns(
         )->column( )->text( 'SalesOrder' )->get_parent(
         )->column( )->text( 'SalesOrderType' )->get_parent(
         )->column( )->text( 'SalesOrganization' ).

    table->items( )->column_list_item( )->cells(
       )->text( '{SALESORDER}'
       )->text( '{SALESORDERTYPE}'
       )->text( '{SALESORGANIZATION}' ).

    client->view_display( view->stringify( ) ).

  ENDMETHOD.
ENDCLASS.

EML

The Entity Manipulation Language simplifies working with RAP business objects by providing a consistent way to perform operations such as reading, creating, updating, and deleting entities.

Read

Here’s how to use READ ENTITIES to fetch sales orders and display them in a UI5 table:

CLASS z2ui5_cl_sample_eml_read DEFINITION PUBLIC CREATE PUBLIC.

  PUBLIC SECTION.
    INTERFACES z2ui5_if_app.
    DATA mt_salesorder TYPE TABLE FOR READ RESULT i_salesordertp\\salesorder.

ENDCLASS.

CLASS z2ui5_cl_sample_eml_read IMPLEMENTATION.
  METHOD z2ui5_if_app~main.

    READ ENTITIES OF I_SalesOrderTP
      ENTITY SalesOrder
      ALL FIELDS WITH
      VALUE #( ( SalesOrder = `0000000001` ) )
      RESULT mt_salesorder.

    DATA(view) = z2ui5_cl_xml_view=>factory( )->page( ).
    DATA(table) = view->table( client->_bind( mt_salesorder ) ).
    table->columns(
         )->column( )->text( 'SalesOrder' )->get_parent(
         )->column( )->text( 'SalesOrderType' )->get_parent(
         )->column( )->text( 'SalesOrganization' ).

    table->items( )->column_list_item( )->cells(
       )->text( '{SALESORDER}'
       )->text( '{SALESORDERTYPE}'
       )->text( '{SALESORGANIZATION}' ).

    client->view_display( view->stringify( ) ).

  ENDMETHOD.
ENDCLASS.

Modify

The following example demonstrates how to create a sales order using MODIFY in an abap2UI5 application:

METHOD z2ui5_if_app~main.

    MODIFY ENTITIES OF i_salesordertp
           ENTITY salesorder
           CREATE
           FIELDS ( salesordertype
                    salesorganization
                    distributionchannel
                    organizationdivision
                    soldtoparty )
           WITH VALUE #( ( %cid  = '0001'
                           %data = VALUE #(
                SalesOrderType       = 'TA'
                SalesOrganization    = '1010'
                DistributionChannel  = '10'
                OrganizationDivision = '00'
                SoldToParty          = '0033500056' ) ) )
           MAPPED   DATA(ls_mapped)
           FAILED   DATA(ls_failed)
           REPORTED DATA(ls_reported_modify).

    COMMIT ENTITIES BEGIN
           RESPONSE OF i_salesordertp
           FAILED   DATA(ls_save_failed)
           REPORTED DATA(ls_save_reported).
    COMMIT ENTITIES END.

ENDMETHOD.

Key Considerations:

• EML calls in abap2UI5 applications are executed outside the RAP framework. Therefore, explicit transaction commits (COMMIT ENTITIES) are necessary
• Restrictions within the RAP framework, such as disallowing direct calls to posting function modules or explicit commits, do not apply to abap2UI5 EML operations. This provides greater flexibility in managing commits and other actions