非管理的内部延迟编号
ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › RAP 业务对象供应 › RAP 业务对象行为 › 编号 › 延迟编号 › 非管理的内部延迟编号
在使用内部编号的场景中,运行时框架会在创建新实例时分配主键值。缺省情况下,延迟编号是内部的,因为消费者无法在不返回点后影响 SAVE 序列。要定义 late numbering,必须实施方法 ADJUST NUMBERS。有关详细信息,请参阅非管理的内部延迟编号定义。
延迟编号用于需要无间隔编号的场景。由于最终键值是在到数据库的 SAVE 之前设置的,因此会在分配编号之前检查所有内容。
延迟编号可用于有或没有草稿的托管和非托管实施场景。有关具有草稿和 late numbering 的 RAP 业务对象的详细信息,请参阅草稿实例的草稿 UUID 以及源或目标实体中与 late numbering 的草稿实例和关联。
有关使用 ADJUST NUMBERS 方法在延迟编号场景中分配键值时的概览,请参阅保存序列运行时。
延迟编号中的键值处理
新创建的实例必须始终由其事务代码唯一标识,以便在交互阶段进行内部处理。在具有延迟编号的 RAP BO 中(其中最终键值分配仅在保存序列期间进行),事务主键需要添加以满足交互阶段和早期保存阶段的标识要求。这是通过使用初始标识 (%PID) 扩展事务主键来完成的,以确保在多个 ABAP 会话期间(在草稿场景中)也具有唯一性。
然后,组件组 %tky 至少包含两个元素:%pid 和 %key(其中 %key 包含所有关键字段)。对于交互阶段中的事务处理,%tky 必须可全部唯一识别。这意味着您可以使用初步值填充 %pid 或 %key 并将另一个值留空,或同时填充二者以进行唯一标识。以下屏幕截图说明了延迟编号场景中的组件组 %tky 和 %pky。示例场景是草稿场景。因此,%is_draft 包括在 %tky 中。

要将实际和最终键值分配给实例,可在实际 ADJUST_NUMBERS 发生之前 FINALIZE 和 CHECK_BEFORE_SAVE 之后调用方法 SAVE。它返回全局唯一的最终键值,这意味着不再需要通过初步键值识别实例。
使用 EML 检索最终键值
在延迟编号场景中,将在不返回点之后分配最终键值,其中无法进行其他消费者交互。但是,在某些用例中,可能需要检索最终键值,例如,触发另一个业务对象的操作,需要相应的键值作为输入参数。
示例
业务对象 A 在保存实例 A 时触发业务对象 B 的创建。要建立外键关系,必须输入 A 的最终键值。
作为使用者,您可以使用根实体上的 CONVERT KEY 语句检索分配给 ADJUST NUMBERS 中 RAP BO 实例的最终键值,并将其用于进一步处理。如果在业务对象的行为池之外的子实体上使用此语句,则不会返回任何结果。
请注意,您不能将 CONVERT KEY 用于您自己的 RAP BO 的实例,只能用于外部 RAP 业务对象,例如在跨业务对象关系中。分配最终键值后,您只能在 COMMIT 的延迟保存阶段使用 CONVERT KEY。
有关详细信息,请参阅 CONVERT KEY(ABAP - 关键字文档)。
延迟编号和草稿实例
草稿 UUID
由于最终键值仅在不返回点之后分配,因此交互阶段对初步语义键值进行操作。因此,需要附加草稿标识符作为 PID 以唯一标识每个草稿实例。因此,具有草稿功能和 late numbering 的 RAP 业务对象在相应的草稿表中需要强制的 DRAFTUUID 键值字段。
如果为根实体定义了延迟编号,则所有子节点还必须包含 parentdraftuuid 键值字段及其自己的草稿标识符(如果已为它们分配延迟编号)。草稿 UUID 本身的映射由 RAP 框架管理。
备注
如果随后将
late numbering添加到 RAP BO,则必须重新生成草稿表以包含所需的草稿键值字段。
例如,使用草稿场景管理的 Travel 实体的草稿数据库表 /dmo/d_travel_d 在根实体级别扩展如下 late numbering(假设 Booking 实体也使用 late numbering 和 BookingSupplement 实体使用其他编号方法):
示例代码
define table /dmo/d_travel_d {
key mandt : mandt not null;
key travel_id : /dmo/travel_id not null;
key draftuuid : sdraft_uuid not null;
...}
作为直接子实体, Booking 实体的草稿数据库表 /dmo/d_booking_d 也必须使用其自身的草稿 uuid 和父实体的草稿 uuid 进行扩展:
示例代码
define table /dmo/d_booking_d {
key mandt : mandt not null;
key travel_id : /dmo/travel_id not null;
key booking_id : /dmo/booking_id not null;
key draftuuid : sdraft_uuid not null;
parentdraftuuid : sdraft_uuid;
...}
示例代码
define table /dmo/a_bksuppl_d {
key mandt : mandt not null;
key travel_id : /dmo/travel_id not null;
key booking_id : /dmo/booking_id not null;
key booking_supplement_id : /dmo/booking_supplement_id not null;
parentdraftuuid : sdraft_uuid;
...}
源或目标实体中与 late numbering 的草稿实例和关联
由于最终键值仅在延迟保存阶段分配,因此不支持源实体或目标实体中与延迟编号的关联,以及目标实体上具有延迟编号的外键关联,并在源实体上反向具有延迟编号的外键关联。技术上可以定义这些关联,但它们会在行为定义中导致语法警告。为草稿实例执行这些关联会导致短转储。
通常,仅当已保存实例且已分配最终键值时,才能将具有延迟编号的实例定义为关联目标。
在以下场景中,有关关联的限制不适用于 late numbering:
构成、ToParent 关联、ToLockMaster 关联、ToAuthorizationMaster 关联或 ToEtagMaster 关联。
与
early numberingtarget 和late numberingsource 的外键关联。使用
early numbering源和late numbering目标反向外键关联。
非管理的内部延迟编号定义
您可以在行为定义抬头中使用附加项 late numbering 为 RAP 业务对象中的每个 RAP 实体定义延迟编号,该实施类型具有和不具有草稿功能。
有关语法的详细信息,请参阅 CDS BDL - 延迟编号(ABAP 关键字文档)。作为前提条件,您必须为两种实施类型实施 ADJUST_NUMBERS 方法。
有关 ADJUST NUMBERS 方法的详细信息,请参见 ADJUST_NUMBERS。
有关实施示例,请参阅实施交互阶段和保存顺序。
来源:SAP Help Portal · 2025 FPS02 (Oct 2026) · 中文为 SAP 官方机器翻译