内部提前编号

ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › RAP 业务对象供应 › RAP 业务对象行为 › 编号 › 早期编号 › 内部提前编号

在使用内部编号的场景中,运行时框架会在创建新实例时分配主键值。内部编号可由 RAP 运行时管理。也可以由应用程序开发人员进行非托管。

管理的内部提前编号

使用管理的内部提前编号时,RAP 管理的运行时会在 CREATE 请求期间自动绘制 UUID。

备注

管理的提前编号仅适用于实施类型为 managed 的业务对象的 ABAP 类型为 raw(16) (UUID) 的关键字段。

有关详细信息,请参阅在托管业务对象中自动绘制主键值。

实施

托管编号在行为定义中定义。此外,关键字段必须定义为 readonly。

[implementation] managed [implementation in class ABAP_CLASS [unique]];
define behavior for Entity [alias AliasedName]
  lock (master|dependent() )
  ...
{  ...
  field ( readonly, numbering:managed ) KeyField1 [, KeyField2, …, keyFieldn];
  ...}

有关语法的详细信息,请参阅 CDS BDL - 字段编号(ABAP 关键字文档)。

非托管内部提前编号

非托管实施场景中的非托管早期编号

在非托管业务对象中,CREATE 操作在 CREATE 修改期间实施主键值分配。

实施

新编号的分配必须包含在应用程序代码中。

有关详细信息,请参阅为差旅实例实施 CREATE 操作。

具有草稿功能的托管和非托管实施场景中的非托管早期编号。

早期编号在实体级别的行为定义中定义,键值分配在 CREATE 或 CREATE-BY-ASSOCIATION 期间调用的相应处理器方法中实施。然后,非管理的内部编号将应用于业务对象实体的所有主键字段,而不是单个字段级别。因此,必须在 FOR NUMBERING 方法的 MAPPED 结果参数中映射实施中的所有关键字段。

非托管编号在行为定义中定义,early numbering 位于实体级别。对于为所有关键字段分配非管理提前编号的场景,建议将相应的关键字段设置为 readonly,如以下通用示例所示:

define behavior for Entity [alias AliasedName]
  lock (master|dependent() )
  early numbering
  ...
{  ...
  field ( readonly ) KeyField1 [, KeyField2, …, keyFieldn];
  ...}

然后,可以使用以下方法签名在行为池中实施 FOR NUMBERING 方法。由于 FOR NUMBERING 方法在 CREATE 期间执行,因此无法通过 EML 在外部触发,而只能通过 create 操作隐式触发。此外,无法在 CREATE 期间定义任何修改操作。该方法接收需要分配密钥作为导入参数的所有实体:

  METHODS earlyNumbering_Create method FOR NUMBERING
    [IMPORTING] entities FOR CREATE business_object_entity.

有关 FOR NUMBERING 方法的详细信息,请参阅 <方法> FOR NUMBERING。

有关非托管编号语法的详细信息,请参阅 CDS BDL - 早期编号(ABAP 关键字文档)。

有关具有编号范围对象的托管业务对象的特定实施示例,请参阅开发早期非托管编号。

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

← 外部早期编号 · 管理的内部提前编号 →