功能定义

ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › RAP 业务对象供应 › RAP 业务对象行为 › 操作 › 非标准工序 › 功能 › 功能定义

函数语法

函数被指定为行为定义中的非标准操作,并在 ABAP 行为池中实施。

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

输入参数

有关函数输入参数的详细信息,请参阅 CDS -BDL - 输入参数(ABAP 关键字文档)。

有关在 RAP 中建模参数的详细信息,请参阅非标准操作的建模参数。

对于 OData 服务,您可以使用默认值函数设置函数的输入参数默认值。通过计算缺省值并提供缺省值作为相应函数的结果,可将缺省值功能用作 Fiori UI 上输入参数的输入助手。然后,计算的值将显示在输入参数的弹出窗口中,用户触发函数时会打开这些参数。有关操作的缺省输入参数的概念信息,请参见操作缺省设置。

输出参数

有关输出参数的详细信息,请参阅 CDS BDL - 输出参数(ABAP 关键字文档)。

有关在 RAP 中建模参数的详细信息,请参阅非标准操作的建模参数。

操作和函数的输出参数使用关键字 result 定义。结果参数是可选的。但是,如果在操作定义中声明结果参数,则必须在实施中填充。如果未填充,则即使使用大于 0 的结果基数声明操作,操作也不会返回任何内容。在这种情况下,OData 服务返回初始值。

通过将操作结果声明为 selective,可以定义操作使用者可以决定是完全返回结果还是仅返回部分结果,例如仅返回键值。这有助于提高性能,因为可以从结果中排除使用已计算字段的性能。有关使用选择性结果参数实施的详细信息,请参阅操作导入参数。执行具有选择性结果的操作时,SAP Fiori UI 仅请求结果的键值。

操作和函数的 result cardinality 确定输出的多样性。通过这种方式,它指示该操作是生成 0..1、1、0..n 还是 1..n 个输出实例。因此,基数的可能值为:

[0..1] 、 [1] 、 [0..] 或 [1..] 。

备注

仅对结果实体基数 [0..1] 或 [1] 提供 RAP 场景的端到端支持。

您可以返回结果实体或结果结构:

  • *结果实体:*通过使用 result entity MyBOEntiy 声明操作,操作将返回一个或多个实例 MyBOEntity。result $self 返回操作所分配到的实体的一个或多个实例。

    在 UI 服务中通过 $self 返回结果实体时,当前 UI 行为是它保留在执行操作的同一页面上。对于工厂操作,Fiori 元素 UI 当前导航到新创建实例的对象页面。

    备注

    在服务中,仅公开具有服务定义中包含的输出实体的操作和函数。

    在映射行为定义中,必须使用投影结果实体重新定义 $self 以外的结果实体。有关详细信息,请参阅投影行为定义中的操作。

  • *结果结构:*如果操作结果是抽象实体,则必须在没有关键字 entity 的情况下定义结果,因为抽象实体在 ABAP 中被视为结构。

功能类型

内部功能

缺省情况下,功能可由 OData 请求以及来自其他业务对象或同一业务对象的 EML 执行。要仅为同一业务对象提供功能,可在功能名称之前设置选项 internal。内部功能只能从业务对象实施内的业务逻辑访问,例如通过确定或其他功能。

静态功能

缺省情况下,功能与业务对象实体的实例相关。选项 static 允许您定义未绑定到任何实例但与完整实体相关的静态函数。

可重复功能

附加项 repeatable 允许您定义可在同一 EML 请求或 OData 更改集中的同一实例上多次执行的实例功能。可以使用内容标识 %CID 区分此类功能的不同执行。内容标识包含在可重复函数的派生类型中,需要在每次可重复函数调用中提供。

附加功能

外部功能名称

通过使用语法 external 'ExternalFunctionName',可以重命名函数以供外部使用。这意味着,新名称在 OData 元数据中公开。此外部名称可以是

更长

而不是实际函数名称,但 ABAP 并不知道。

实例功能控制

功能的实例特征控制根据业务对象中的前提条件启用或禁用该功能。

函数的动态实例功能控制使用语法 features: instance 定义。

有关详细信息,请参阅功能控制。

全局功能控制

功能的全局特征控制根据业务对象外部前提条件启用或禁用该功能。

函数的动态全局功能控制使用语法 features: global 定义。

有关详细信息,请参阅全局功能控制。

权限控制

可以检查功能以防止未经授权的执行。如果没有为功能指定权限控制,则权限主数据(global 或 instance 或两者)的权限模式将用于该功能。

您可以通过使用全局或实例权限或两者定义功能,替换每个功能的权限主数据中指定的权限控制:( authorization: global| authorization: instance| authorization: global, authorization: instance )。

要从权限检查中排除该功能,可以使用语法 authorization: none。

您还可以将功能权限委派给 update 的权限。

有关详细信息,请参阅权限定义。

投影行为定义中的操作和函数

您可以在投影级别添加新操作和函数,例如,如果操作仅与一个特定用例相关。对于定义,适用与在基本 RAP 业务对象上定义的操作和函数相同的规则。但是,如果需要权限概念,则必须为每个业务对象节点定义权限概念,且映射 BDEF 必须定义为 strict。有关详细信息,请参阅权限定义。添加到投影 BDEF 的操作和函数自动通过 OData 服务公开,不需要单独公开。

如果要为 OData 服务公开基本行为定义中定义的操作和函数,则必须将其包含在映射行为定义中。使用以下语法:

projection; ...
define behavior for CDSEntity [alias AliasedEntityName]
{...
  use action ActionName [result entity ProjResultEntity] [as ActionAlias] [external ExtActName];
  use function FunctionName [result entity ProjResultEntity] [as FunctionAlias] [external ExtFuncName];
}

有关投影 BDEF 中的操作和函数的详细信息,请参阅 CDS BDL - 实体行为定义(ABAP 关键字文档)。

读取操作中的状态消息

读取操作(包括功能)不会导致业务对象状态发生任何更改,而只是返回数据。因此,读取或函数实施无法发出新的状态消息。

在 OData V4 中,结果类型为实体的函数返回包括相应状态消息在内的相应实体。在 OData V2 中,返回不含状态消息的实体作为缺省行为。

有关消息在 EML 中的行为方式的详细信息,请参阅 EML(实体操作语言)中的消息行为。

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

← 功能 · 功能实施 →