如何修改 Fiori Elements 工程包含的本地注解(annotations)文件试读版

本教程前一篇文章：8. 如何找到 SAP Fiori Elements 应用某个字段显示值具体的数据源，笔者试图解答我的知识星球里一个朋友的提问：

在WebIde（SAP UI 版本 1.97.0）生成Fiori Elements 的Overview page并发布后，再次在消费视图中修改UI注解后，本地运行该Overview page应用发现页面已经变动，但是发布后的界面却没有变动。重新发布该Overview page应用或清除缓存后仍然不起作用。

前一篇文章里，我们已经简要介绍了 ListReport 这种类型的 Fiori Elements 应用的布局设计原理，如上图所示，我们想查找的 Products(123)的数据源，实际上绑定路径为：

/dataServices/schema/0/entityType/6/com.sap.vocabularies.UI.v1.HeaderInfo/TypeNamePlural

而 OData 元数据被 Fiori Elements 框架解析成 JavaScript 对象后，我们根据上面找到的路径，找到 JavaScript 对象 entityType 数组索引为 0 的数组元素，发现 TypeNamePlural 字段值为 Products：

本文我们继续介绍，如何通过修改 Visual Studio Code 内本地 Fiori Elements 工程的注解文件，来修改 Products 字符串的显示。

下面是详细的内容。

我们将本教程目前为止开发好的 Fiori Elements ListReport 应用，使用 yarn start 命令行本地运行，然后切换到调试模型，在 Chrome 开发者工具 network 面板能观察到两个 HTTP 请求：

• 请求1：OData 服务元数据请求，url 为 http://localhost:8080/sap/opu/odata/sap/SEPMRA_PROD_MAN/$metadata?sap-value-list=none&sap-language=EN.
• 请求2：OData 注解(annotation) 请求，url 为 http://localhost:8080/sap/opu/odata/IWFND/CATALOGSERVICE;v=2/Annotations(TechnicalName='SEPMRA_PROD_MAN_ANNO_MDL',Version='0001')/$value/?sap-language=EN.

大家注意到上面提到的两个 url，里面都包含了 sap 这个片段。

按照笔者之前教程的文章介绍，这两个请求里虽然主机名为 http://localhost:8080, 实际上被 Fiori Elements 本地开发自带的代理服务器，将请求转发给了部署了 OData 服务的远端服务器 ES5，网址为 https://sapes5.sapdevcenter.com.

代理服务器的配置，定义在 ui5.yaml文件里如下图所示：

• 7. SAP Fiori Elements 应用里的 ui5.yaml 文件详解

我们再把 annotation 注解请求的 HTTP 响应粘贴到一些 XML 查看器里，便于查看：

有了本教程前一篇文章单步调试找到的路径 /dataServices/schema/0/entityType/6/com.sap.vocabularies.UI.v1.HeaderInfo/TypeNamePlural，我们在这个注解请求的响应里，找到了 TypeNamePlural 值为 Products 的字段，位于 SEPMRA_PROD_MAN.SEPMRA_C_PD_ProductType 节点内。

我们在本地工程文件的 localService 文件夹内，能找到一个名叫 SEPMRA_PROD_MAN_ANNO_MDL.xml 的本地注解文件，该文件里同样存在一个层级结构同上图一致的节点，名称也叫 SEPMRA_PROD_MAN.SEPMRA_C_PD_ProductType.

我们将该节点内 TypeNamePlural 字段值从 Products 修改成产品。

因为我们作为 Fiori Elements 应用的本地开发人员，是没有办法也没有权限修改远端服务器上的 OData 服务注解实现的。所以我们需要设法让 Fiori Elements 框架的运行时，也加载这个本地注解文件，这样我们在本地注解文件里的修改，才能影响最终 Fiori Elements 应用的页面渲染效果。

下面是详细的步骤。