工序缺省设置

ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › RAP 业务对象供应 › RAP 业务对象行为 › 操作 › 工序缺省设置

使用缺省值函数,您可以缺省设置操作和函数的输入参数,以及用于在 OData 服务中创建和创建按关联操作的字段。这样,缺省值功能将充当最终用户在 UI 上触发相应操作的输入助手。

使用 OData 应用的要求

如果使用 Fiori 元素 UI,则缺省值功能开箱即用。自动为相应的操作调用它们,并且结果值显示在 UI 的参数输入窗口中。

但是,在非 Fiori 元素应用中,您需要自己实施此编排。在这种情况下,框架仅提供 函数作为 OData 元数据的一部分,需要分别由使用 OData 应用处理。

定义缺省值功能

基本行为定义

默认值函数通过在相应操作和参数定义后面添加关键字 { default function GetDefaultsForOperation; } 在基本行为定义中定义。请注意,默认值函数的名称需要以 GetDefaultsFor 开头。可以定义缺省值功能的 OData 公开的外部名称。以下代码块显示现有操作的缺省值函数的示范性定义:

// Create operations (name can be omitted):
create { default function; }

// Create-by-association-operations:
association _Item { with draft; create { default function GetDefaultsForCBA external 'GetDefaultsForCreateByAssociation'; } }

//Actions:
action PlainAction parameter myPlainParameter { default function GetDefaultsForPlainAct; }

//Functions:
function DeepFunction deep parameter myDeepParameter result [0..*] MyEntity { default function GetDefaultsForDeepFct; }

对于缺省值函数,函数类型(实例或静态)派生自由框架分别缺省执行的操作。例如,为实例操作或函数定义的缺省值函数也隐式定义为实例函数。因此,无法在行为定义中手动定义函数类型。

缺省值函数的导入参数类型也由框架派生。对于实例缺省值功能,使用包含相关实体键值字段的表键入导入参数。如果是静态缺省值函数,则使用包含内容标识符的表键入导入参数 %cid 指示相应操作。

缺省值函数的输出参数类型根据相关操作类型派生:如果是相关创建(通过关联)操作,则使用表键入输出参数,以将输入标识符(关键字段或 %cid)映射到相关(目标)实体的字段。如果是相关操作和函数,则使用表键入输出参数,以将输入标识符映射到相关操作的输入参数字段。这样,缺省值函数的提供者可以为结果中每个实例的相应(参数)字段分配缺省值。平面参数和深层参数均可设置为缺省值。

限制

默认值函数始终在结果表中为每个导入的输入标识符提供一组默认参数值,因此其基数始终为 [1]。

投影行为定义

默认值函数需要在业务对象投影层上公开,类似于使用关键字 use function 的非缺省函数。投影相关操作时,不会在投影层自动公开默认值函数。

projection;
strict(2);

define behavior for ...
...
{
  ...
  use function GetDefaultsForCreate;
  use function GetDefaultsForCBA;
  use function GetDefaultsForPlainAct;
  use function GetDefaultsForDeepFct;
}

对于在投影层定义的操作,默认值函数的定义类似于基础层。

实施缺省值功能

通过为所有导入的输入标识符的 (参数)字段分配默认值来实施默认值函数。以下代码块显示缺省值函数的基本实施结构:

METHOD GetDefaultsForRelatedOperation.

* Calculate the default values for all imported input identifiers, e.g. by EML Read for imported keys:
    READ ENTITIES OF ...
    RESULT DATA(read_results).

* Assign these default values to the respective (parameter) fields per input identifier in the result table using the component group %param
    LOOP AT read_results INTO DATA(read_result).

* Example for a related instance action/function/create-by-association:
          APPEND VALUE #( %tky                          = read_result-%tky
                          %param-field_to_be_defaulted  = [default_value] ) TO result.

* Example for a related create operation:
          APPEND VALUE #( %cid                          = read_result-%cid
                          %param-field_to_be_defaulted  = [default_value] ) TO result.

    ENDLOOP.

ENDMETHOD.

错误可以写入到 failed 和 reported 更改参数类似于非缺省函数。

有关缺省值函数的示例实施,请参阅设置操作的输入参数缺省值。

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

← 工序增强 · 确定 →