ADJUST_NUMBERS

ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › RAP BO 运行时 › 保存序列运行时 › ADJUST_NUMBERS

实施延迟编号。

在不返回点之后的保存序列期间调用 ADJUST_NUMBERS 实施。此时,事务缓冲区处于一致状态,所有实例都可以收到其最终编号。

仅当在行为定义中对延迟编号进行建模时,才能实施 ADJUST_NUMBERS。更多信息,请参见 延迟编号 。该方法必须由应用程序开发人员在后期编号场景中实施。通常,最终键值由编号范围对象分配,然后在映射的响应参数中映射调整后的编号。

在具有延迟编号的场景中,在交互阶段通过事务代码(%tky))识别业务对象实例。在延迟编号场景中 %tky 包含 %pky,其中至少包含两个组件:%pid 和 %key,即实际关键字段。这两个组件都可能包含初步键值,必须将其映射到 ADJUST_NUMBERS 中的最终键值。

在交互阶段用于初步标识的组件组 %pky 的值将分配到 ADJUST_NUMBERS 中的组件组 %pre。要将关键字段中的潜在初步键值与实际最终键值区分开来,可将初步就地键值分配到 ADJUST_NUMBERS %tmp 中的组件组。%key 中的最终键值必须映射到 ADJUST_NUMBERS 中 %pre 中的初始标识符。以下编译说明了交互阶段和 ADJUST_NUMBERS 中的标识符。

ADJUST_NUMBERS 中的映射在映射的响应参数中从 %pre 到 %key 完成。以下示例显示了一个映射,其中 %pky 的两个组件在交互阶段用于唯一标识。这不是必需的,您也可以仅使用 %pid 或关键字段。

示例

  METHOD adjust_numbers.
...
* Fill %key-<key_field> with the adjusted number
    APPEND VALUE #( %pre-%pid               = 'MyPID'
                    %pre-%tmp-<key_field>      = 'MyPreliminaryKey_InPlace'
                    %key-<key_field>           = 'MyFinalKey'
                  ) TO mapped-<entity>.

  ENDMETHOD.

有关派生类型组件的详细信息,请参阅 BDEF 派生类型的组件(ABAP - 关键字文档)。

实施

使用延迟编号时,必须始终实施方法 ADJUST_NUMBERS。

方法 ADJUST_NUMBERS

必须在本地保护程序类中重新定义 ADJUST_NUMBERS 的方法才能实现它。

CLASS lcl_saver DEFINITION INHERITING FROM cl_abap_behavior_saver.

  PROTECTED SECTION.
    METHODS adjust_numbers REDEFINITION.

ENDCLASS.

CLASS lcl_save IMPLEMENTATION.
METHOD adjust_numbers.
// ** implement adjust_numbers here **//
ENDMETHOD.

更改参数

  • MAPPED

  • REPORTED

    可通过隐式更改参数 REPORTED 报告消息。由于消费者错误不得出现在 CHECK_BEFORE_SAVE 之后,因此 REPORTED 应仅包含成功或信息消息,例如物料库存低。

备注

此方法不得失败,因此不需要 FAILED 参数,因为临时标识的交换在不返回点之后进行。如果应用程序需要停止事务,则只能产生短转储。