RAP Code Generation: Using ADT Generator and Fiori Tools

1. Database table
2. Draft table
3. Interface CDS View
4. Projection CDS View
5. Metadata Extension
6. Behavior Definition
7. Behavior Implementation
8. Service Definition
9. Service Binding

Right-click on database table
→ Generate ABAP Repository Objects
→ Generate RAP BO

Right-click on package
→ New → Other ABAP Repository Object
→ Business Services → Generate RAP BO

Table: ZFLIGHT_BOOK

Implementation Type: Managed
Draft Handling: Yes
Data Model: Single BO
Projection: Yes

Table:             ZFLIGHT_BOOK
Interface View:    ZI_FLIGHTBOOK
Projection View:   ZC_FLIGHTBOOK
Behavior Def:      ZI_FLIGHTBOOK
Service Definition: ZUI_FLIGHTBOOK
Service Binding:   ZUI_FLIGHTBOOK_O4

I_ = Interface Layer
C_ = Consumption/Projection Layer
UI_ = UI Service
_O4 = OData V4

┌─────────────────────────────────────────────────────────┐
│              Generated Objects                           │
├─────────────────────────────────────────────────────────┤
│ ✓ ZDRAFT_FLIGHT_BOOK    (Draft table)                   │
│ ✓ ZI_FLIGHTBOOK         (Interface CDS View)            │
│ ✓ ZI_FLIGHTBOOK         (Behavior Definition)           │
│ ✓ ZBP_I_FLIGHTBOOK      (Behavior Implementation)       │
│ ✓ ZC_FLIGHTBOOK         (Projection CDS View)           │
│ ✓ ZC_FLIGHTBOOK         (Projection Behavior)           │
│ ✓ ZUI_FLIGHTBOOK        (Service Definition)            │
│ ✓ ZUI_FLIGHTBOOK_O4     (Service Binding)               │
└─────────────────────────────────────────────────────────┘

@AccessControl.authorizationCheck: #CHECK
@EndUserText.label: 'Flight Booking'
define root view entity ZI_FlightBook
  as select from zflight_book
{
  key booking_uuid,
      flight_id,
      customer_id,
      booking_date,
      seat_number,
      status,
      price,
      currency_code,
      @Semantics.user.createdBy: true
      created_by,
      @Semantics.systemDateTime.createdAt: true
      created_at,
      @Semantics.user.lastChangedBy: true
      last_changed_by,
      @Semantics.systemDateTime.lastChangedAt: true
      last_changed_at,
      @Semantics.systemDateTime.localInstanceLastChangedAt: true
      local_last_changed
}

managed implementation in class zbp_i_flightbook unique;
strict ( 2 );
with draft;

define behavior for ZI_FlightBook alias FlightBook
persistent table zflight_book
draft table zdraft_flight_book
etag master LocalLastChanged
lock master total etag LastChangedAt
authorization master ( global )
{
  field ( readonly )
    BookingUUID,
    CreatedBy,
    CreatedAt,
    LastChangedBy,
    LastChangedAt,
    LocalLastChanged;

  field ( numbering : managed )
    BookingUUID;

  create;
  update;
  delete;

  draft action Activate optimized;
  draft action Discard;
  draft action Edit;
  draft action Resume;
  draft determine action Prepare;
}

CLASS lhc_FlightBook DEFINITION INHERITING FROM cl_abap_behavior_handler.
  PRIVATE SECTION.
    METHODS:
      get_global_authorizations FOR GLOBAL AUTHORIZATION
        IMPORTING REQUEST requested_authorizations FOR FlightBook
        RESULT result.
ENDCLASS.

CLASS lhc_FlightBook IMPLEMENTATION.
  METHOD get_global_authorizations.
    " Implement your own authorization checks here
  ENDMETHOD.
ENDCLASS.

@UI.headerInfo: {
  typeName: 'Flight Booking',
  typeNamePlural: 'Flight Bookings',
  title: { value: 'FlightID' }
}

@UI.lineItem: [{ position: 10 }]
@UI.identification: [{ position: 10 }]
FlightID;

@UI.lineItem: [{ position: 20 }]
@UI.selectionField: [{ position: 10 }]
BookingDate;

define behavior for ZI_FlightBook alias FlightBook
...
{
  validation validateBookingDate on save { field BookingDate; }
  validation validateSeat on save { field SeatNumber; }
}

METHOD validateBookingDate.
  READ ENTITIES OF zi_flightbook IN LOCAL MODE
    ENTITY FlightBook
    FIELDS ( BookingDate )
    WITH CORRESPONDING #( keys )
    RESULT DATA(bookings).

  LOOP AT bookings INTO DATA(booking).
    IF booking-BookingDate < cl_abap_context_info=>get_system_date( ).
      APPEND VALUE #( %tky = booking-%tky ) TO failed-flightbook.
      APPEND VALUE #( %tky = booking-%tky
                      %msg = new_message_with_text(
                        severity = if_abap_behv_message=>severity-error
                        text     = 'Booking date must be in the future' )
                      %element-BookingDate = if_abap_behv=>mk-on
      ) TO reported-flightbook.
    ENDIF.
  ENDLOOP.
ENDMETHOD.

define behavior for ZI_FlightBook alias FlightBook
...
{
  action confirmBooking result [1] $self;
  action cancelBooking result [1] $self;
}

1. Open Command Palette (F1)
2. Enter "Fiori: Open Application Generator"
3. Select template: "List Report Page" or "Worklist"
4. Data source: Select OData V4 Service
5. Enter Service Binding: ZUI_FLIGHTBOOK_O4
6. Select main entity: FlightBook
7. Assign project name

flight-booking-app/
├── webapp/
│   ├── manifest.json       # App configuration
│   ├── Component.js        # UI5 Component
│   ├── index.html          # Start page
│   └── localService/       # Mock data
├── package.json            # Dependencies
└── ui5.yaml               # Build configuration

{
  "sap.app": {
    "title": "{{appTitle}}",
    "description": "{{appDescription}}"
  },
  "sap.ui5": {
    "routing": {
      "targets": {
        "FlightBookList": {
          "options": {
            "settings": {
              "initialLoad": true,
              "variantManagement": "Page"
            }
          }
        }
      }
    }
  }
}

Customize after generation:

□ Interface View
  □ @EndUserText.label for all fields
  □ Associations to other entities
  □ @ObjectModel.text for text fields

□ Projection View
  □ Define @UI.headerInfo
  □ @UI.lineItem for List Report
  □ @UI.identification for Object Page
  □ @UI.selectionField for filters

□ Behavior Definition
  □ Add validations
  □ Determinations for default values
  □ Define custom actions
  □ Configure authorization checks

□ Service Binding
  □ Activate publish
  □ Test preview in browser

Generator → Scaffold → Customization → Testing → Refinement

Z = Customer namespace
I_ = Interface Layer
C_ = Consumption Layer
A_ = Abstract Entity
UI_ = UI Service
_O4 = OData V4