启用数据库表

ABAP RESTful 应用程序编程模型 › 扩展 › RAP 可扩展性启用 › 开发可扩展性启用 › 启用数据模型扩展 › 启用数据库表

本章将指导您完成启用参考业务对象的数据库表的必要步骤,以扩展其数据模型。

所需的赋能步骤

要启用数据模型扩展的数据库表,需要定义扩展包含结构,扩展程序稍后可将其用于结构扩展。扩展包含文件结构随后在活动和草稿数据库表中引用。此外,您需要显式将数据库表和扩展包含文件结构定义为可扩展。

有关启用数据库表以实现可扩展性的详细信息,请参阅数据库表可扩展性启用。

过程

  1. 创建名为 /DMO/S_EXT_INCL_AGENCY 的结构。此扩展 include 结构用作原始业务对象和扩展之间的抽象层,并在后续步骤中作为包含文件添加到数据库表中。

  2. 在扩展 include 结构中,添加虚拟字段并在抬头部分使用以下注释定义结构的启用范围:

    • @AbapCatalog.enhancement.category:使用值 #EXTENSIBLE_ANY 允许扩展 include 结构的任何类型的扩展。

    • @AbapCatalog.enhancement.fieldSuffix:选择字段后缀 ZAG 以避免字段名称冲突。

    • @AbapCatalog.enhancement.quotaMaximumFields:选择可由包含结构的扩展器添加的字段数。

    • @AbapCatalog.enhancement.quotaMaximumBytes:选择为 include 结构的扩展器保留的字节容量。

    @EndUserText.label : 'Extension Include'
    @AbapCatalog.enhancement.category : #EXTENSIBLE_ANY
    @AbapCatalog.enhancement.fieldSuffix : 'ZAG'
    @AbapCatalog.enhancement.quotaMaximumFields : 350
    @AbapCatalog.enhancement.quotaMaximumBytes : 3500
    define structure /dmo/s_ext_incl_agency {
    
      dummy_field : abap.char(1);
    
    }
    

    备注

    我们建议您添加 C0 审批合同以指定此开发对象旨在作为稳定的扩展 API。

  3. 在数据库表 /DMO/AGENCY 和 /DMO/AGENCY_D 的标头中,添加注释 @AbapCatalog.enhancement.category : #EXTENSIBLE_ANY。它允许数据库表的任何类型的扩展。

    ...
    @AbapCatalog.enhancement.category : #EXTENSIBLE_ANY
    define table /dmo/agency {
    ...
    
  4. 将创建的扩展包括结构包含到数据库表 /DMO/AGENCY 和 /DMO/AGENCY_D。

    ...
      include /dmo/s_ext_incl_agency;
    
    }
    

    生成的数据库表 /DMO/AGENCY 如下所示:

    @EndUserText.label : 'Flight Reference Scenario: Managing Agencies'
    @AbapCatalog.enhancement.category : #EXTENSIBLE_ANY
    @AbapCatalog.tableCategory : #TRANSPARENT
    @AbapCatalog.deliveryClass : #A
    @AbapCatalog.dataMaintenance : #RESTRICTED
    define table /dmo/agency {
    
      key client            : abap.clnt not null;
      key agency_id         : /dmo/agency_id not null;
      name                  : /dmo/agency_name;
      street                : /dmo/street;
      postal_code           : /dmo/postal_code;
      city                  : /dmo/city;
      country_code          : land1;
      phone_number          : /dmo/phone_number;
      email_address         : /dmo/email_address;
      web_address           : /dmo/web_address;
      attachment            : /dmo/attachment;
      mime_type             : /dmo/mime_type;
      filename              : /dmo/filename;
      @AbapCatalog.anonymizedWhenDelivered : true
      local_created_by      : abp_creation_user;
      local_created_at      : abp_creation_tstmpl;
      @AbapCatalog.anonymizedWhenDelivered : true
      local_last_changed_by : abp_locinst_lastchange_user;
      local_last_changed_at : abp_locinst_lastchange_tstmpl;
      last_changed_at       : abp_lastchange_tstmpl;
      include /dmo/s_ext_incl_agency;
    
    }
    
  5. 生成的数据库表 /DMO/AGENCY_D 如下所示:

    @EndUserText.label : 'Draft table for entity /DMO/R_AGENCY'
    @AbapCatalog.enhancement.category : #EXTENSIBLE_ANY
    @AbapCatalog.tableCategory : #TRANSPARENT
    @AbapCatalog.deliveryClass : #A
    @AbapCatalog.dataMaintenance : #RESTRICTED
    define table /dmo/agency_d {
    
      key mandt          : mandt not null;
      key agencyid       : /dmo/agency_id not null;
      key draftuuid      : sdraft_uuid not null;
      name               : /dmo/agency_name;
      street             : /dmo/street;
      postalcode         : /dmo/postal_code;
      city               : /dmo/city;
      countrycode        : land1;
      phonenumber        : /dmo/phone_number;
      emailaddress       : /dmo/email_address;
      webaddress         : /dmo/web_address;
      attachment         : /dmo/attachment;
      mimetype           : /dmo/mime_type;
      filename           : /dmo/filename;
      localcreatedby     : abp_creation_user;
      localcreatedat     : abp_creation_tstmpl;
      locallastchangedby : abp_locinst_lastchange_user;
      locallastchangedat : abp_locinst_lastchange_tstmpl;
      lastchangedat      : abp_lastchange_tstmpl;
      "%admin"           : include sych_bdl_draft_admin_inc;
      include /dmo/s_ext_incl_agency;
    
    }
    

结果

现在,您已为数据模型扩展启用数据库表。要使扩展器能够添加新字段,还需要可扩展性启用 CDS 数据模型,请参阅启用 CDS 视图章节。

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

← 启用数据模型扩展 · 启用 CDS 视图 →