📚 Architectural Blueprint

SAP Clean Core RAP BDEF Extension Guide

A definitive guide to Developer Extensibility in SAP S/4HANA: Extending standard SAP Business Objects (BODEs) with custom validations, determinations, and actions without core modification.

1. The Foundation of Developer Extensibility (Tier-1)

In legacy SAP ECC, extending standard business transactions (such as VA01 for Sales Orders or ME21N for Purchase Orders) was achieved via modifications, user exits (MV45AFZZ), or implicit enhancement spots. These modifications were the #1 cause of upgrade friction and system breakage.

In SAP S/4HANA Clean Core (Developer Extensibility), standard business logic is encapsulated in RAP Business Objects. SAP releases standard Business Object Interfaces (Contract C1) specifically designed to be extended via BDEF Extensions (`extension for interface ...`).

2. Core Extensibility Capabilities in BDEF Extensions

Capability	Syntax Construct	Execution Lifecycle
Custom Validation	validation zCheck on save { field custom_fld; }	Executed in check phase of save sequence; can reject commit.
Custom Determination	determination zCalc on modify { field custom_fld; }	Auto-populates fields immediately when dependent attributes change.
Custom Action	action ( features : instance ) zCustomAction	Exposed as an interactive button on the standard Fiori app.
Draft Extension	extend draft table z_custom_d	Persists custom field draft state across user editing sessions.

3. Reporting Errors on Standard Entities (`failed` and `reported`)

When custom validations fail on standard SAP entities, developers must map the error keys to standard structures using %tky (Transactional Key):

METHOD zValidateCustomFields.
  LOOP AT lt_orders INTO DATA(ls_order).
    IF ls_order-zz_custom_field IS INITIAL.
      APPEND VALUE #( %tky = ls_order-%tky ) TO failed-salesorder.
      APPEND VALUE #( %tky = ls_order-%tky
                      %msg = new_message_with_text(
                               severity = if_abap_behv_message=>severity-error
                               text     = 'Mandatory customer field missing.' )
                    ) TO reported-salesorder.
    ENDIF.
  ENDLOOP.
ENDMETHOD.