@linkup-ai/abap-ai 2.0.0

package/dist/knowledge/abap/rap-end-to-end.md

@@ -0,0 +1,486 @@
+# RAP End-to-End — managed BO com draft, OData V4, Fiori Elements
+
+## Stack
+
+```
+DB Tables → CDS Interface (root+child) → BDEF managed with draft → Handler Class
+         → CDS Projection (root+child) → Projection BDEF (use draft)
+         → Service Definition → Service Binding (OData V4 UI)
+         → Metadata Extension (UI annotations)
+```
+
+## 1. Database Tables
+
+```abap
+define table ztravel {
+  key client            : abap.clnt not null;
+  key travel_id         : abap.numc(8) not null;
+  agency_id             : abap.numc(6);
+  customer_id           : abap.numc(6);
+  begin_date            : abap.dats;
+  end_date              : abap.dats;
+  @AbapCatalog.currency.currencyCode : 'ztravel.currency_code'
+  booking_fee           : abap.curr(17,2);
+  @AbapCatalog.currency.currencyCode : 'ztravel.currency_code'
+  total_price           : abap.curr(17,2);
+  currency_code         : abap.cuky(5);
+  description           : abap.char(256);
+  overall_status        : abap.char(1);
+  created_by            : abp_creation_user;
+  created_at            : abp_creation_tstmpl;
+  last_changed_by       : abp_locinst_lastchange_user;
+  last_changed_at       : abp_locinst_lastchange_tstmpl;
+  local_last_changed_at : abp_lastchange_tstmpl;
+}
+
+define table zbooking {
+  key client            : abap.clnt not null;
+  key travel_id         : abap.numc(8) not null;
+  key booking_id        : abap.numc(4) not null;
+  booking_date          : abap.dats;
+  carrier_id            : abap.char(3);
+  connection_id         : abap.numc(4);
+  flight_date           : abap.dats;
+  @AbapCatalog.currency.currencyCode : 'zbooking.currency_code'
+  flight_price          : abap.curr(17,2);
+  currency_code         : abap.cuky(5);
+  booking_status        : abap.char(1);
+  local_last_changed_at : abp_lastchange_tstmpl;
+}
+```
+
+Draft tables sao geradas automaticamente pelo framework.
+
+## 2. CDS Interface — Root
+
+```abap
+@AccessControl.authorizationCheck: #CHECK
+@Metadata.allowExtensions: true
+define root view entity ZI_Travel
+  as select from ztravel
+  composition [0..*] of ZI_Booking as _Booking
+  association [0..1] to /DMO/I_Agency   as _Agency   on $projection.AgencyID = _Agency.AgencyID
+  association [0..1] to /DMO/I_Customer as _Customer on $projection.CustomerID = _Customer.CustomerID
+  association [0..1] to I_Currency      as _Currency  on $projection.CurrencyCode = _Currency.Currency
+{
+  key travel_id             as TravelID,
+      agency_id             as AgencyID,
+      customer_id           as CustomerID,
+      begin_date            as BeginDate,
+      end_date              as EndDate,
+      @Semantics.amount.currencyCode: 'CurrencyCode'
+      booking_fee           as BookingFee,
+      @Semantics.amount.currencyCode: 'CurrencyCode'
+      total_price           as TotalPrice,
+      currency_code         as CurrencyCode,
+      description           as Description,
+      overall_status        as OverallStatus,
+      @Semantics.user.createdBy: true
+      created_by            as CreatedBy,
+      @Semantics.systemDateTime.createdAt: true
+      created_at            as CreatedAt,
+      @Semantics.user.localInstanceLastChangedBy: true
+      last_changed_by       as LastChangedBy,
+      @Semantics.systemDateTime.localInstanceLastChangedAt: true
+      last_changed_at       as LastChangedAt,
+      @Semantics.systemDateTime.lastChangedAt: true
+      local_last_changed_at as LocalLastChangedAt,
+      _Booking,
+      _Agency,
+      _Customer,
+      _Currency
+}
+```
+
+## 3. CDS Interface — Child
+
+```abap
+@AccessControl.authorizationCheck: #CHECK
+@Metadata.allowExtensions: true
+define view entity ZI_Booking
+  as select from zbooking
+  association to parent ZI_Travel    as _Travel  on $projection.TravelID = _Travel.TravelID
+  association [0..1] to /DMO/I_Carrier as _Carrier on $projection.CarrierID = _Carrier.AirlineID
+  association [0..1] to I_Currency     as _Currency on $projection.CurrencyCode = _Currency.Currency
+{
+  key travel_id             as TravelID,
+  key booking_id            as BookingID,
+      booking_date          as BookingDate,
+      carrier_id            as CarrierID,
+      connection_id         as ConnectionID,
+      flight_date           as FlightDate,
+      @Semantics.amount.currencyCode: 'CurrencyCode'
+      flight_price          as FlightPrice,
+      currency_code         as CurrencyCode,
+      booking_status        as BookingStatus,
+      @Semantics.systemDateTime.lastChangedAt: true
+      local_last_changed_at as LocalLastChangedAt,
+      _Travel,
+      _Carrier,
+      _Currency
+}
+```
+
+## 4. BDEF Interface
+
+```abap
+managed implementation in class ZBP_I_TRAVEL unique;
+strict ( 2 );
+with draft;
+
+define behavior for ZI_Travel alias Travel
+persistent table ztravel
+draft table ztravel_d
+etag master LocalLastChangedAt
+lock master total etag LastChangedAt
+authorization master ( global )
+{
+  field ( readonly ) TravelID;
+  field ( readonly ) CreatedBy, CreatedAt, LastChangedBy, LastChangedAt, LocalLastChangedAt;
+  field ( mandatory ) AgencyID, CustomerID;
+
+  create;
+  update;
+  delete;
+
+  draft action Edit;
+  draft action Activate optimized;
+  draft action Discard;
+  draft action Resume;
+  draft determine action Prepare { validation validateDates; validation validateCustomer; }
+
+  validation validateDates on save { create; field BeginDate, EndDate; }
+  validation validateCustomer on save { create; field CustomerID; }
+  determination setTravelID on modify { create; }
+  determination calculateTotalPrice on modify { field BookingFee; }
+
+  action ( features : instance ) acceptTravel result [1] $self;
+  action ( features : instance ) rejectTravel result [1] $self;
+
+  side effects {
+    field BookingFee affects field TotalPrice;
+    determine action Prepare executed on field BeginDate, field EndDate, field CustomerID;
+  }
+
+  mapping for ztravel corresponding;
+  association _Booking { create; with draft; }
+}
+
+define behavior for ZI_Booking alias Booking
+persistent table zbooking
+draft table zbooking_d
+etag master LocalLastChangedAt
+lock dependent by _Travel
+authorization dependent by _Travel
+{
+  field ( readonly ) TravelID, BookingID;
+  field ( mandatory ) CarrierID, ConnectionID, FlightDate;
+
+  update;
+  delete;
+
+  determination setBookingID on modify { create; }
+
+  mapping for zbooking corresponding;
+  association _Travel { with draft; }
+}
+```
+
+## 5. Handler Class
+
+```abap
+CLASS zbp_i_travel DEFINITION PUBLIC ABSTRACT FINAL FOR BEHAVIOR OF ZI_Travel.
+ENDCLASS.
+CLASS zbp_i_travel IMPLEMENTATION.
+ENDCLASS.
+```
+
+### Local handler (lhc_travel):
+
+```abap
+CLASS lhc_travel DEFINITION INHERITING FROM cl_abap_behavior_handler.
+  PRIVATE SECTION.
+    METHODS get_global_authorizations FOR GLOBAL AUTHORIZATION
+      IMPORTING REQUEST requested_authorizations FOR Travel RESULT result.
+    METHODS setTravelID FOR DETERMINE ON MODIFY IMPORTING keys FOR Travel~setTravelID.
+    METHODS calculateTotalPrice FOR DETERMINE ON MODIFY IMPORTING keys FOR Travel~calculateTotalPrice.
+    METHODS validateDates FOR VALIDATE ON SAVE IMPORTING keys FOR Travel~validateDates.
+    METHODS validateCustomer FOR VALIDATE ON SAVE IMPORTING keys FOR Travel~validateCustomer.
+    METHODS acceptTravel FOR MODIFY IMPORTING keys FOR ACTION Travel~acceptTravel RESULT result.
+    METHODS rejectTravel FOR MODIFY IMPORTING keys FOR ACTION Travel~rejectTravel RESULT result.
+    METHODS get_instance_features FOR INSTANCE FEATURES
+      IMPORTING keys REQUEST requested_features FOR Travel RESULT result.
+ENDCLASS.
+
+CLASS lhc_travel IMPLEMENTATION.
+
+  METHOD get_global_authorizations.
+    result = VALUE #( ( %create = if_abap_behv=>auth-allowed
+                        %update = if_abap_behv=>auth-allowed
+                        %delete = if_abap_behv=>auth-allowed ) ).
+  ENDMETHOD.
+
+  METHOD setTravelID.
+    READ ENTITIES OF ZI_Travel IN LOCAL MODE
+      ENTITY Travel FIELDS ( TravelID ) WITH CORRESPONDING #( keys )
+      RESULT DATA(travels).
+    SELECT SINGLE FROM ztravel FIELDS MAX( travel_id ) INTO @DATA(max_id).
+    MODIFY ENTITIES OF ZI_Travel IN LOCAL MODE
+      ENTITY Travel UPDATE FIELDS ( TravelID )
+      WITH VALUE #( FOR t IN travels WHERE ( TravelID IS INITIAL )
+        ( %tky = t-%tky  TravelID = max_id + 1 ) ).
+  ENDMETHOD.
+
+  METHOD calculateTotalPrice.
+    READ ENTITIES OF ZI_Travel IN LOCAL MODE
+      ENTITY Travel FIELDS ( BookingFee CurrencyCode ) WITH CORRESPONDING #( keys )
+      RESULT DATA(travels).
+    READ ENTITIES OF ZI_Travel IN LOCAL MODE
+      ENTITY Travel BY \_Booking FIELDS ( FlightPrice )
+      WITH CORRESPONDING #( keys ) RESULT DATA(bookings).
+    LOOP AT travels ASSIGNING FIELD-SYMBOL(<t>).
+      DATA(total) = <t>-BookingFee.
+      LOOP AT bookings INTO DATA(b) WHERE TravelID = <t>-TravelID.
+        total += b-FlightPrice.
+      ENDLOOP.
+      MODIFY ENTITIES OF ZI_Travel IN LOCAL MODE
+        ENTITY Travel UPDATE FIELDS ( TotalPrice )
+        WITH VALUE #( ( %tky = <t>-%tky  TotalPrice = total ) ).
+    ENDLOOP.
+  ENDMETHOD.
+
+  METHOD validateDates.
+    READ ENTITIES OF ZI_Travel IN LOCAL MODE
+      ENTITY Travel FIELDS ( BeginDate EndDate ) WITH CORRESPONDING #( keys )
+      RESULT DATA(travels).
+    LOOP AT travels INTO DATA(t).
+      APPEND VALUE #( %tky = t-%tky ) TO result.
+      IF t-BeginDate IS INITIAL.
+        APPEND VALUE #( %tky = t-%tky  %state_area = 'VALIDATE_DATES'
+          %msg = NEW /dmo/cm_flight_messages( textid = /dmo/cm_flight_messages=>begin_date_required
+            severity = if_abap_behv_message=>severity-error )
+          %element-BeginDate = if_abap_behv=>mk-on ) TO reported-travel.
+      ENDIF.
+      IF t-EndDate IS NOT INITIAL AND t-EndDate < t-BeginDate.
+        APPEND VALUE #( %tky = t-%tky  %state_area = 'VALIDATE_DATES'
+          %msg = NEW /dmo/cm_flight_messages( textid = /dmo/cm_flight_messages=>end_date_before_begin
+            severity = if_abap_behv_message=>severity-error )
+          %element-EndDate = if_abap_behv=>mk-on ) TO reported-travel.
+      ENDIF.
+    ENDLOOP.
+  ENDMETHOD.
+
+  METHOD validateCustomer.
+    READ ENTITIES OF ZI_Travel IN LOCAL MODE
+      ENTITY Travel FIELDS ( CustomerID ) WITH CORRESPONDING #( keys )
+      RESULT DATA(travels).
+    DATA customers TYPE SORTED TABLE OF /dmo/customer WITH UNIQUE KEY customer_id.
+    customers = CORRESPONDING #( travels DISCARDING DUPLICATES MAPPING customer_id = CustomerID ).
+    SELECT FROM /dmo/customer FIELDS customer_id
+      FOR ALL ENTRIES IN @customers WHERE customer_id = @customers-customer_id
+      INTO TABLE @DATA(valid).
+    LOOP AT travels INTO DATA(t).
+      APPEND VALUE #( %tky = t-%tky ) TO result.
+      IF t-CustomerID IS NOT INITIAL AND NOT line_exists( valid[ customer_id = t-CustomerID ] ).
+        APPEND VALUE #( %tky = t-%tky  %state_area = 'VALIDATE_CUSTOMER'
+          %msg = NEW /dmo/cm_flight_messages( textid = /dmo/cm_flight_messages=>customer_unknown
+            customer_id = t-CustomerID  severity = if_abap_behv_message=>severity-error )
+          %element-CustomerID = if_abap_behv=>mk-on ) TO reported-travel.
+      ENDIF.
+    ENDLOOP.
+  ENDMETHOD.
+
+  METHOD acceptTravel.
+    MODIFY ENTITIES OF ZI_Travel IN LOCAL MODE
+      ENTITY Travel UPDATE FIELDS ( OverallStatus )
+      WITH VALUE #( FOR key IN keys ( %tky = key-%tky  OverallStatus = 'A' ) )
+      FAILED failed REPORTED reported.
+    READ ENTITIES OF ZI_Travel IN LOCAL MODE
+      ENTITY Travel ALL FIELDS WITH CORRESPONDING #( keys ) RESULT DATA(travels).
+    result = VALUE #( FOR t IN travels ( %tky = t-%tky  %param = t ) ).
+  ENDMETHOD.
+
+  METHOD rejectTravel.
+    MODIFY ENTITIES OF ZI_Travel IN LOCAL MODE
+      ENTITY Travel UPDATE FIELDS ( OverallStatus )
+      WITH VALUE #( FOR key IN keys ( %tky = key-%tky  OverallStatus = 'X' ) )
+      FAILED failed REPORTED reported.
+    READ ENTITIES OF ZI_Travel IN LOCAL MODE
+      ENTITY Travel ALL FIELDS WITH CORRESPONDING #( keys ) RESULT DATA(travels).
+    result = VALUE #( FOR t IN travels ( %tky = t-%tky  %param = t ) ).
+  ENDMETHOD.
+
+  METHOD get_instance_features.
+    READ ENTITIES OF ZI_Travel IN LOCAL MODE
+      ENTITY Travel FIELDS ( OverallStatus ) WITH CORRESPONDING #( keys )
+      RESULT DATA(travels).
+    result = VALUE #( FOR t IN travels
+      ( %tky = t-%tky
+        %action-acceptTravel = COND #( WHEN t-OverallStatus = 'A'
+          THEN if_abap_behv=>fc-o-disabled ELSE if_abap_behv=>fc-o-enabled )
+        %action-rejectTravel = COND #( WHEN t-OverallStatus = 'X'
+          THEN if_abap_behv=>fc-o-disabled ELSE if_abap_behv=>fc-o-enabled ) ) ).
+  ENDMETHOD.
+
+ENDCLASS.
+```
+
+## 6. CDS Projection — Root
+
+```abap
+@AccessControl.authorizationCheck: #CHECK
+@Metadata.allowExtensions: true
+@Search.searchable: true
+define root view entity ZC_Travel
+  provider contract transactional_query
+  as projection on ZI_Travel
+{
+  key TravelID,
+      @Search.defaultSearchElement: true
+      AgencyID,
+      @Search.defaultSearchElement: true
+      CustomerID,
+      BeginDate,
+      EndDate,
+      @Semantics.amount.currencyCode: 'CurrencyCode'
+      BookingFee,
+      @Semantics.amount.currencyCode: 'CurrencyCode'
+      TotalPrice,
+      CurrencyCode,
+      @Search.defaultSearchElement: true
+      @Search.fuzzinessThreshold: 0.7
+      Description,
+      OverallStatus,
+      CreatedBy, CreatedAt, LastChangedBy, LastChangedAt, LocalLastChangedAt,
+      _Booking : redirected to composition child ZC_Booking,
+      _Agency, _Customer, _Currency
+}
+```
+
+## 7. CDS Projection — Child
+
+```abap
+@AccessControl.authorizationCheck: #CHECK
+@Metadata.allowExtensions: true
+define view entity ZC_Booking
+  as projection on ZI_Booking
+{
+  key TravelID,
+  key BookingID,
+      BookingDate, CarrierID, ConnectionID, FlightDate,
+      @Semantics.amount.currencyCode: 'CurrencyCode'
+      FlightPrice,
+      CurrencyCode, BookingStatus, LocalLastChangedAt,
+      _Travel : redirected to parent ZC_Travel,
+      _Carrier, _Currency
+}
+```
+
+## 8. Projection BDEF
+
+```abap
+projection;
+strict ( 2 );
+use draft;
+
+define behavior for ZC_Travel alias Travel
+use etag
+{
+  use create; use update; use delete;
+  use action Edit; use action Activate; use action Discard;
+  use action Resume; use action Prepare;
+  use action acceptTravel; use action rejectTravel;
+  use association _Booking { create; with draft; }
+}
+
+define behavior for ZC_Booking alias Booking
+use etag
+{
+  use update; use delete;
+  use association _Travel { with draft; }
+}
+```
+
+## 9. Service Definition
+
+```abap
+@EndUserText.label: 'Travel Service'
+define service ZUI_TRAVEL {
+  expose ZC_Travel   as Travel;
+  expose ZC_Booking  as Booking;
+  expose /DMO/I_Agency   as Agency;
+  expose /DMO/I_Customer as Customer;
+  expose /DMO/I_Carrier  as Carrier;
+  expose I_Currency      as Currency;
+}
+```
+
+## 10. Service Binding
+
+Tipo: OData V4 - UI. Service Definition: ZUI_TRAVEL. Publicar apos criar.
+
+## 11. Metadata Extension
+
+```abap
+@Metadata.layer: #CORE
+annotate entity ZC_Travel with
+{
+  @UI.facet: [
+    { id: 'Travel',  type: #IDENTIFICATION_REFERENCE, label: 'Travel',   position: 10 },
+    { id: 'Booking', type: #LINEITEM_REFERENCE,       label: 'Bookings', position: 20, targetElement: '_Booking' }
+  ]
+
+  @UI.hidden: true
+  TravelID;
+
+  @UI: { lineItem: [{ position: 10 }], selectionField: [{ position: 10 }], identification: [{ position: 10 }] }
+  AgencyID;
+
+  @UI: { lineItem: [{ position: 20 }], selectionField: [{ position: 20 }], identification: [{ position: 20 }] }
+  CustomerID;
+
+  @UI: { lineItem: [{ position: 30 }], identification: [{ position: 30 }] }
+  BeginDate;
+
+  @UI: { lineItem: [{ position: 40 }], identification: [{ position: 40 }] }
+  EndDate;
+
+  @UI.identification: [{ position: 50 }]
+  BookingFee;
+
+  @UI: { lineItem: [{ position: 50 }], identification: [{ position: 60 }] }
+  TotalPrice;
+
+  @UI: { lineItem: [{ position: 60 }], selectionField: [{ position: 30 }], identification: [{ position: 70 }] }
+  OverallStatus;
+
+  @UI: { lineItem: [{ position: 70 }], identification: [{ position: 80 }] }
+  Description;
+}
+```
+
+## Ordem de criacao
+
+1. Tables (TABL) → 2. CDS Interface root+child (DDLS) → 3. BDEF Interface (BDEF) → 4. Handler Class (CLAS) → 5. CDS Projection root+child (DDLS) → 6. Projection BDEF (BDEF) → 7. Service Definition (SRVD) → 8. Service Binding (SRVB) → 9. Metadata Extension (DDLX)
+
+Ativar em lotes: tabelas → CDS → BDEF → service.
+
+## Regras
+- Root CDS usa `define root view entity` + `composition [0..*] of`
+- Child CDS usa `association to parent`
+- BDEF root: `lock master total etag`, child: `lock dependent by`
+- Projection CDS: `provider contract transactional_query` (so na root)
+- Projection CDS: `redirected to composition child` / `redirected to parent`
+- Service Definition expoe projections (ZC_*), nunca interfaces (ZI_*)
+- Service Definition expoe entidades de value help
+- Todas as 5 draft actions devem ser expostas na projection BDEF
+
+## Anti-patterns
+| Errado | Correto |
+|--------|---------|
+| Expor ZI_* no Service Definition | Expor ZC_* |
+| Esquecer `with draft` na association | `association _Child { create; with draft; }` |
+| UI annotations direto no CDS interface | `@Metadata.allowExtensions` + Metadata Extension separada |
+| `lock master` no child | `lock dependent by _Root` |
+| Esquecer `provider contract transactional_query` | Obrigatorio na root projection para Fiori |
+| Nao expor entidade de value help | `expose /DMO/I_Agency as Agency;` |

package/dist/knowledge/abap/rap-feature-control.md

@@ -0,0 +1,185 @@
+# RAP Feature Control — dynamic field and action enablement
+
+## BDEF Declaration
+
+```abap
+define behavior for ZI_Order alias Order
+{
+  " Instance feature control — per-record dynamic enablement
+  action ( features : instance ) acceptOrder result [1] $self;
+  action ( features : instance ) rejectOrder result [1] $self;
+
+  " Field-level feature control
+  field ( features : instance ) Status, Description;
+
+  " Static operation feature control
+  create ( features : global );
+  update;
+  delete;
+}
+```
+
+## Instance Features — Handler Method
+
+```abap
+CLASS lhc_order DEFINITION INHERITING FROM cl_abap_behavior_handler.
+  PRIVATE SECTION.
+    METHODS get_instance_features FOR INSTANCE FEATURES
+      IMPORTING keys REQUEST requested_features FOR Order RESULT result.
+ENDCLASS.
+
+CLASS lhc_order IMPLEMENTATION.
+  METHOD get_instance_features.
+    READ ENTITIES OF ZI_Order IN LOCAL MODE
+      ENTITY Order FIELDS ( Status ) WITH CORRESPONDING #( keys )
+      RESULT DATA(orders).
+
+    result = VALUE #( FOR order IN orders
+      ( %tky = order-%tky
+
+        " Action control
+        %action-acceptOrder = COND #(
+          WHEN order-Status = 'A'  " Already accepted
+          THEN if_abap_behv=>fc-o-disabled
+          ELSE if_abap_behv=>fc-o-enabled )
+
+        %action-rejectOrder = COND #(
+          WHEN order-Status = 'X'  " Already rejected
+          THEN if_abap_behv=>fc-o-disabled
+          ELSE if_abap_behv=>fc-o-enabled )
+
+        " Field control
+        %field-Status = COND #(
+          WHEN order-Status = 'A' OR order-Status = 'X'
+          THEN if_abap_behv=>fc-f-read_only
+          ELSE if_abap_behv=>fc-f-mandatory )
+
+        %field-Description = if_abap_behv=>fc-f-unrestricted
+
+        " Standard operation control
+        %update = COND #(
+          WHEN order-Status = 'A'
+          THEN if_abap_behv=>fc-o-disabled
+          ELSE if_abap_behv=>fc-o-enabled )
+
+        %delete = COND #(
+          WHEN order-Status = 'A'
+          THEN if_abap_behv=>fc-o-disabled
+          ELSE if_abap_behv=>fc-o-enabled )
+      ) ).
+  ENDMETHOD.
+ENDCLASS.
+```
+
+## Feature Control Constants
+
+### Operations (actions, create, update, delete)
+
+| Constant | Value | Effect |
+|----------|:-----:|--------|
+| `if_abap_behv=>fc-o-enabled` | 01 | Action/operation available |
+| `if_abap_behv=>fc-o-disabled` | 00 | Action/operation greyed out |
+
+### Fields
+
+| Constant | Value | Effect |
+|----------|:-----:|--------|
+| `if_abap_behv=>fc-f-unrestricted` | 01 | Editable (default) |
+| `if_abap_behv=>fc-f-read_only` | 02 | Read-only |
+| `if_abap_behv=>fc-f-mandatory` | 03 | Mandatory (required) |
+| `if_abap_behv=>fc-f-unrestricted_or_hidden` | 04 | Hidden or editable |
+
+## Global Features — Static Operation Control
+
+```abap
+" BDEF:
+create ( features : global );
+
+" Handler:
+METHODS get_global_features FOR GLOBAL FEATURES
+  IMPORTING REQUEST requested_features FOR Order RESULT result.
+
+METHOD get_global_features.
+  " Example: disable create outside business hours
+  DATA(lv_hour) = CONV i( sy-uzeit(2) ).
+  result = VALUE #(
+    %create = COND #(
+      WHEN lv_hour < 8 OR lv_hour > 18
+      THEN if_abap_behv=>fc-o-disabled
+      ELSE if_abap_behv=>fc-o-enabled ) ).
+ENDMETHOD.
+```
+
+## Combining with Side Effects
+
+```abap
+" BDEF — refresh feature control when status changes
+side effects {
+  field Status affects action acceptOrder, action rejectOrder;
+}
+```
+
+When `Status` changes, Fiori recalculates `get_instance_features` → buttons enable/disable dynamically.
+
+## Complex Example — Multi-field, Multi-action
+
+```abap
+METHOD get_instance_features.
+  READ ENTITIES OF ZI_Travel IN LOCAL MODE
+    ENTITY Travel FIELDS ( OverallStatus BeginDate )
+    WITH CORRESPONDING #( keys )
+    RESULT DATA(travels).
+
+  result = VALUE #( FOR t IN travels
+    LET is_accepted = xsdbool( t-OverallStatus = 'A' )
+        is_rejected = xsdbool( t-OverallStatus = 'X' )
+        is_open     = xsdbool( t-OverallStatus = 'O' )
+        is_past     = xsdbool( t-BeginDate < sy-datum )
+    IN
+    ( %tky = t-%tky
+
+      %action-acceptTravel = COND #(
+        WHEN is_accepted = abap_true OR is_past = abap_true
+        THEN if_abap_behv=>fc-o-disabled ELSE if_abap_behv=>fc-o-enabled )
+
+      %action-rejectTravel = COND #(
+        WHEN is_rejected = abap_true
+        THEN if_abap_behv=>fc-o-disabled ELSE if_abap_behv=>fc-o-enabled )
+
+      %update = COND #(
+        WHEN is_accepted = abap_true
+        THEN if_abap_behv=>fc-o-disabled ELSE if_abap_behv=>fc-o-enabled )
+
+      %delete = COND #(
+        WHEN is_accepted = abap_true OR is_open = abap_false
+        THEN if_abap_behv=>fc-o-disabled ELSE if_abap_behv=>fc-o-enabled )
+
+      %field-OverallStatus = if_abap_behv=>fc-f-read_only
+      %field-BeginDate = COND #(
+        WHEN is_accepted = abap_true
+        THEN if_abap_behv=>fc-f-read_only ELSE if_abap_behv=>fc-f-mandatory )
+      %field-EndDate = COND #(
+        WHEN is_accepted = abap_true
+        THEN if_abap_behv=>fc-f-read_only ELSE if_abap_behv=>fc-f-unrestricted )
+    ) ).
+ENDMETHOD.
+```
+
+## Rules
+- `( features : instance )` on action/field in BDEF enables instance-level control
+- `( features : global )` on operation enables class-level control (no per-record logic)
+- Handler method name is always `get_instance_features` / `get_global_features`
+- READ ENTITIES with IN LOCAL MODE to avoid authorization loops
+- Use LET in VALUE expressions for cleaner multi-condition logic
+- Combine with `side effects { field X affects action Y }` for dynamic UI refresh
+- `%field-X` only works if field declared with `field ( features : instance )` in BDEF
+
+## Anti-Patterns
+| Anti-Pattern | Correct |
+|---|---|
+| `field ( readonly ) Status` when control should be dynamic | `field ( features : instance ) Status` |
+| Feature control without IN LOCAL MODE | Always use IN LOCAL MODE in handler |
+| Hardcoded `if_abap_behv=>fc-o-disabled` for all records | Check per-record state |
+| Missing side effect for status field | `field Status affects action X` for UI refresh |
+| `get_instance_features` without reading entity data | Always READ ENTITIES first |
+| Complex IF/ELSEIF chains | Use COND with LET for readability |