业务对象结构示例

ABAP RESTful 应用程序编程模型 › 开发 › 开发单个业务对象功能 › 在 UI 和消息映射上公开消息 › 业务对象结构示例

示例

以下消息实施示例的数据模型基于具有草稿功能的业务对象的数据模型,但已减少以突出显示与消息相关的要点。此示例的业务对象模型包含两个实体 Travel 和 Booking。有关注释和语法的更多上下文信息,请参阅创建 CDS 视图实体。此示例侧重于消息的相关点。

数据定义:/DMO/I_Travel_Messages

差旅根视图的数据源是数据库表 /DMO/A_TRAVEL_D。数据库表中的所有字段均用于数据模型。

展开以下代码示例以查看 /DMO/I_Travel_Messages 的源代码。

示例代码

@EndUserText.label: 'Travel View Entity for Messages.'
@AccessControl.authorizationCheck: #NOT_REQUIRED

define root view entity /DMO/I_Travel_Messages
  as select from /dmo/a_travel_d

  composition [0..*] of /DMO/I_BOOKING_Messages 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

{ ///dmo/a_travel_d
  key travel_uuid           as TravelUUID,

      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
      local_created_by      as LocalCreatedBy,
      @Semantics.systemDateTime.createdAt: true
      local_created_at      as LocalCreatedAt,
      @Semantics.user.lastChangedBy: true
      local_last_changed_by as LocalLastChangedBy,
      //local ETag field --> OData ETag
      @Semantics.systemDateTime.localInstanceLastChangedAt: true
      local_last_changed_at as LocalLastChangedAt,

      //Associations
      _Booking,

      _Agency,
      _Customer,
      _Currency
}

数据定义:/DMO/I_Booking_Messages

预订视图的数据源是数据库表 /DMO/A_BOOKING_D。数据库表中的所有字段均用于数据模型。

展开以下代码示例以查看 /DMO/I_Booking_D 的源代码。

示例代码

@EndUserText.label: 'Booking View Entity for Messages'
@AccessControl.authorizationCheck: #NOT_REQUIRED

define view entity /DMO/I_Booking_Messages
  as select from /dmo/a_booking_d

  association        to parent /DMO/I_Travel_Messages        as _Travel     on  $projection.TravelUUID   = _Travel.TravelUUID

  association [1..1] to        /DMO/I_Customer        as _Customer   on  $projection.CustomerID   = _Customer.CustomerID
  association [1..1] to        /DMO/I_Carrier         as _Carrier    on  $projection.AirlineID    = _Carrier.AirlineID
  association [1..1] to        /DMO/I_Connection      as _Connection on  $projection.AirlineID    = _Connection.AirlineID
                                                                     and $projection.ConnectionID = _Connection.ConnectionID

{ ///dmo/a_booking_d
  key booking_uuid          as BookingUUID,
      parent_uuid           as TravelUUID,

      booking_id            as BookingID,
      booking_date          as BookingDate,
      customer_id           as CustomerID,
      carrier_id            as AirlineID,
      connection_id         as ConnectionID,
      flight_date           as FlightDate,
      @Semantics.amount.currencyCode: 'CurrencyCode'
      flight_price          as FlightPrice,
      currency_code         as CurrencyCode,
      booking_status        as BookingStatus,

      //local ETag field --> OData ETag
      @Semantics.systemDateTime.localInstanceLastChangedAt: true
      local_last_changed_at as LocalLastChangedAt,

      //Associations
      _Travel,
      _BookingSupplement,

      _Customer,
      _Carrier,
      _Connection
}

行为定义:/DMO/I_Travel_Messages

此数据模型侧重于说明消息在不同上下文中的工作方式。因此,行为定义对两个实体使用缩减的功能范围。每个实体实施一个操作和验证,以说明每个情况的状态消息和转换消息行为。

Travel

差旅实体实施:

  • 验证 validateCustomer:检查使用者输入的客户标识是否有效

  • 操作 setToBooked:将预订状态从 N(新)更改为 B(已预订)

Booking

登记实体实施:

  • 验证 validateDates:检查输入的预订日期是否有效

  • 确定 validateBookingDate:检查所选预订日期是否在父差旅实体的开始日期和结束日期之间。

展开以下代码示例以查看 /DMO/I_Travel_Messages 的源代码。

示例代码

managed;
with draft;

define behavior for /DMO/I_Travel_Messages alias Travel
implementation in class dmo_travel_messages_demo unique
persistent table /dmo/a_travel_d
draft table zfdtravelmessage
lock master
total etag LocalLastChangedAt
//authorization master ( instance )
etag master LocalLastChangedAt
{
  create;
  update;
  delete;
  association _Booking { create; with draft; }

  field ( numbering : managed, readonly ) TravelUUID;
  validation validateCustomer on save { field CustomerID; }
  validation validateDates on save { create; field BeginDate, EndDate; }
  action setToBooked result [1] $self;

  draft determine action Prepare
  {
    validation validateCustomer;
    validation validateDates;
    validation booking~validateDates ;
    determination booking~setBookingDate;
  }

  mapping for /dmo/a_travel_d
  { AgencyID = agency_id;
    BeginDate = begin_date;
    BookingFee = booking_fee;
    CurrencyCode = currency_code;
    CustomerID = customer_id;
    Description = description;
    EndDate = end_date;
    LocalCreatedAt = local_created_at;
    LocalCreatedBy = local_created_by;
    LocalLastChangedAt = local_last_changed_at;
    LocalLastChangedBy = local_last_changed_by;
    OverallStatus = overall_status;
    TotalPrice = total_price;
    TravelID = travel_id;
    TravelUUID = travel_uuid; }
}

define behavior for /DMO/I_Booking_Messages_DEMO alias Booking
implementation in class DMO_i_booking_messages_demo unique
persistent table /dmo/a_booking_d
draft table zfdbookinmessage
lock dependent by _Travel
//authorization dependent by <association>
etag master LocalLastChangedAt
{
  update;
  delete;

  association _Travel { with draft; }

  field ( readonly ) TravelUUID;
  field ( numbering : managed, readonly ) BookingUUID;

  validation validateDates on save { field BookingDate; create; }

  determination setBookingNumber on save { create; }

  mapping for /dmo/a_booking_d
  { AirlineID = carrier_id;
    BookingDate = booking_date;
    BookingID = booking_id;
    BookingStatus = booking_status;
    BookingUUID = booking_uuid;
    ConnectionID = connection_id;
    CurrencyCode = currency_code;
    CustomerID = customer_id;
    FlightDate = flight_date;
    FlightPrice = flight_price;
    LocalLastChangedAt = local_last_changed_at;
    TravelUUID = parent_uuid; }

}

来源:SAP Help Portal · 2025 FPS02 (Oct 2026) · 中文为 SAP 官方机器翻译

← 在 UI 和消息映射上公开消息 · 在 UI 上显示消息 →