集成变更文档

ABAP RESTful 应用程序编程模型 › 重用 › 集成变更文档

关于变更文档解决方案

您可以通过将这些更改记录在变更凭证中来记录对业务对象所做的更改,例如时间、内容和更改方式。

有关变更文档解决方案的详细信息,请参阅变更文档解决方案。

RAP 中的变更文档集成

在托管的 RAP 业务对象中,变更文档用于记录对持久化 RAP BO 数据的更改。变更文档解决方案与 RAP 集成,可以使用行为定义中的一些声明语句启用,而无需写入可执行代码。

可以在实体行为定义中为变更文档启用 RAP 业务对象实体。更多日志记录选项在实体行为正文中定义。需要变更文档对象来记录对分配给它的数据库表所做的更改。此外,必须启用应记录其值的字段以进行日志记录。可通过以下方式之一完成此操作:

  • 如果使用简单类型键入视图实体的字段,则必须在相应的简单类型中将注释 @AbapCatalog.typeSpec.changeDocumentRelevant 设置为 true。

  • 如果使用数据字典数据元素键入视图实体的字段,则必须在相应数据元素中设置更改文档的标志。

    备注

    在面向 Eclipse 的 ABAP 开发工具中,在数据元素编辑器的附加属性下,存在更改文档日志记录标志。

在行为定义中使用以下语法元素启用更改文档:

...
define behavior for CDSEntity [alias AliasedEntityName]
implementation in class ABAP_CLASS_NAME [unique]
...
changedocuments master (ChangeDocumentObject) |
changedocuments dependent [by _AssocToMaster]
...
{
  changedocuments(Options);
}

有关 RAP 更改文档语法的详细信息,请参阅 RAP - ChangeDocuments(ABAP 关键字文档)和 RAP - ChangeDocuments,选项(ABAP 关键字文档)。

为活动持久性记录数据更改,而不是针对事务缓冲区中更改的每个步骤记录数据更改。例如,如果在同一 LUW 中创建和更新实例,则变更文档会将此记录为具有更新值的创建操作。

除了将内置解决方案用于变更文档外,还可以通过在附加保存实施中调用变更文档 API 的功能将变更文档集成到 RAP 中。当通用集成未涵盖用例且需要非标准处理时,可以使用此自定义实施。

缺省情况下,对持久业务对象数据的更改记录在 CDS 实体级别,而不是相应持久数据库表级别。这意味着将评估 CDS 实体字段的元数据,例如,有关键入的详细信息、货币或单位代码的参考注释以及字段级别的变更文档设置。可选附加项 for persistent tables 可用于更改缺省行为。使用时,将评估 RAP 持久表字段的字段信息以及表名称。

变更文档主实体

变更文档主数据实体具有自己的变更文档对象,用于记录对持久数据的更改。

变更文档相关实体

变更文档相关实体使用其主实体的变更文档对象进行变更日志记录。更改文档主实体通过与变更文档主数据实体的关联进行标识。此关联可以在行为定义中显式指定,也可以使用祖先关联隐式派生。

备注

在与变更文档主数据实体关联的 ON 条件中使用的字段应在行为定义中声明为 readonly。

变更文档对象

更改文档对象是一个资源库对象,用于记录对分配给它的特定数据库表所做的更改。它可以由面向 Eclipse 的 ABAP 开发工具的快速帮助生成。

变更文档选项

传统上,变更文档对象包含用于生成变更文档的选项。这些在变更文档对象的基于表单的编辑器中定义。在 RAP 中,这些选项不相关,要评估的变更文档对象的唯一信息是其名称,用作变更文档结果中的关键字段。更多选项在启用变更文档的实体的实体行为正文中指定。通过这些选项,您可以为标准操作创建、更新和删除定义日志记录详细信息。有关详细信息,请参阅 RAP - ChangeDocuments,选项(ABAP 关键字文档)。

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

← 实施服务回调类 · 启用变更文档集成 →