实例功能控制
ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › RAP 业务对象供应 › RAP 业务对象行为 › 功能控制 › 实例功能控制
您可以在实例级别为字段、标准操作、功能和操作定义功能控制。
实例功能控制适用于业务对象的各个实例。它允许更精细的控制,根据实例的特定条件或属性启用或禁用功能。
例如,您可以控制业务对象实体的实例具有特定状态时是启用还是禁用方法。您可以为 UPDATE 和 DELETE 以及操作定义基于实例的功能控制。由于在这种情况下,您需要业务对象的活动实例,因此 CREATE 操作无法在实例级别具有功能控制。
静态功能控制
个字段
您可以为每个字段定义特定的访问限制。如果访问限制始终对每个实例有效,则可以以静态方式实施限制。
在行为定义中,您可以指定具有特定访问限制的实体的各个字段。
有关语法的详细信息,请参阅 CDS BDL - 字段特征、映射 BDEF(ABAP 关键字文档)。
您可以使用以下字段属性定义静态字段控制:
field (read only) 属性定义指定字段的值不得由使用者创建或更新。您可以在行为定义中设置此属性。
备注
对于操作,业务对象运行时会拒绝包含更新或创建操作的只读字段的外部 EML
MODIFY请求。将忽略包含在用于更新或创建实例的 OData 调用中的只读字段,同时处理其他字段以进行更新和创建操作。
field (mandatory:create) 会在数据持久化之前触发检查。如果未填写注释字段,则拒绝 SAVE。
编辑业务对象实例且无法通过用户界面或通过外部 EML UPDATE 请求更改值时 field (readonly:update) 将字段显示为只读。如果字段仅定义为 readonly:update 而不使用 mandatory:create,则无法在 UI 上编辑这些字段。
备注
如果将字段定义为
readonly:update且您的业务对象已启用草稿,则在为其提供初始值后无法编辑该字段。
field (mandatory:create) 和 field (readonly:update) 的组合结合了两个注释的影响:在这种情况下,必须为 CREATE 请求中的新实例填充一个值,并且无法在 MODIFY 期间通过用户界面或 EML 请求更改此值。典型用例是使用外部编号的标识定义。标识定义一次,在修改实例时不会更改。
field (suppress) 允许您从所有行为定义相关生成组件(例如,派生类型或 EML 字段)中的外观中移除仅出于技术原因添加到 RAP BO 数据模型的字段。这适用于除关键字段、外键字段和当前 BDEF 使用的字段(例如 ETag 字段)之外的所有字段。要从 OData 公开中移除禁止的字段,必须设置 CDS 注释 @Consumption.hidden:true。
注意
请注意,业务对象框架没有隐式验证。作为应用程序开发人员,您必须确保已实施相应的验证。
Web API 中字段的静态功能控制
限制
对于 CREATE 请求中的新实例,field (readonly:create) 会导致特定字段为只读。您可能想要为不合理立即输入的字段定义此访问限制,并且在创建实例之前应保持只读状态。这些字段的值最初无法更改。该值只能在创建实例后更改。仅当实例在技术上可用时,您才能通过动态功能控制对其进行正确控制,并决定字段是否应可编辑。
field (mandatory:update) 表示编辑时字段不得保持初始值。相反,如果修改业务对象实例,则必须输入值。
field (readonly:create) 和 field (mandatory:update) 的组合结合了两个注释的影响。这会导致您无法在 CREATE 请求中填充新实例的字段,但必须在修改业务对象实例时输入值。
操作
在典型事务场景中,必须指定相应实体提供的操作。
业务对象的事务字符在行为定义中定义,其中为业务对象组合树的每个节点指定所有支持的事务操作。每当要创建、更新或删除相应的根或子实体时,必须在行为定义中声明这些操作。通过这种方式,您可以在业务对象实体级别指定是否为每个实例启用创建、更新或删除。有关工序的更多常规信息,请参阅工序。
有关语法的详细信息,请参阅 CDS BDL - 标准操作(ABAP 关键字文档)。
如果在行为定义中为实体声明以下操作,则可以使用这些操作:
createupdatedeleteinternal *operation*_association { create;}
操作和函数
有关语法的详细信息,请参阅 CDS BDL - 操作(ABAP 关键字文档)。
您可以定义操作和内部操作。如果使用静态功能控制定义它们,则它们始终可用于相应的实体。有关更多常规信息,请参阅操作。
操作 |
影响 |
|---|---|
|
如果在行为定义中定义了操作,但没有动态功能控制,则这些操作始终可用于相应的实体。 有关定义和实施操作的常规信息,请参阅操作。 |
|
可以使用操作定义业务对象实体的特定操作。与标准操作类似,您可以通过将内部选项添加到操作名称来定义行为定义中的内部操作。内部操作只能从业务对象实施内的业务逻辑访问,例如通过验证、确定或其他非内部操作。 |
动态功能控制
个字段
您可以为每个字段定义特定的访问限制。如果限制取决于特定操作或条件,则可以以动态方式实施限制。通过动态功能控制,您可以根据条件添加访问限制或指定字段的访问限制。
有关语法的详细信息,请参阅 CDS BDL - 字段特征、映射 BDEF
。
field (features:instance) 需要在行为定义中进行注释,并在行为池中实施。在行为池中,可分配以下字段状态以启用动态字段控制:
UNRESTRICTED– 字段没有限制MANDATORY– 字段为必填字段READONLY– 字段为只读ALL– 请求所有限制
操作
要动态控制工序,必须将选项 (features: instance) 添加到相关工序或关联。这也适用于按关联创建工序。但是,为此,参考类池 ABAP_CLASS 中的实施是必需的。对于每个相关操作,可在 FOR INSTANCE FEATURES 的实施中指定以下值:
ENABLED- 如果已启用操作DISABLED- 如果操作已禁用
非标准工序 - 操作和功能
您可以使用操作和功能为业务对象的实体实施特定操作。与 CUD 操作一样,可以使用动态功能控件启用或禁用操作和功能。如果在行为定义中定义不含功能控制的操作或功能,则这些操作或功能始终可用于其所属的相应业务对象实体。
action (features:instance)function (features:instance)
要动态控制操作或函数,必须将选项 (features: instance) 添加到相关操作。但是,为此,参考类池 ABAP_CLASS 中的实施是必需的。对于每个相关操作,可在 FOR INSTANCE FEATURES 的实施中指定以下值:
ENABLED- 如果启用操作或功能DISABLED- 如果操作或功能已禁用
有关 BDL 语法的详细信息,请参阅 CDS BDL - 功能控制(ABAP 关键字文档)。
有关实施语法的详细信息,请参阅 FOR INSTANCE FEATURES、FEATURES(ABAP 关键字文档)。
来源:SAP Help Portal · 2025 FPS02 (Oct 2026) · 中文为 SAP 官方机器翻译