什么是 SAP vocabulary-based annotations

我们在 SAP Fiori Elements 应用的本地注解里，能看到大量如下以 Common 和 UI 为前缀的注解属性：

这些 Common，UI，实际是命名空间(namespace), 定义在本地注解文件(文件夹localService下面) 的开头部分：

<?xml version="1.0" encoding="utf-8"?>
<edmx:Edmx Version="4.0" xmlns:edmx="http://docs.oasis-open.org/odata/ns/edmx">
    <edmx:Reference Uri="../../catalogservice;v=2/Vocabularies(TechnicalName='%2FIWBEP%2FVOC_COMMON',Version='0001',SAP__Origin='LOCAL')/$value">
        <edmx:Include Namespace="com.sap.vocabularies.Common.v1" Alias="Common"/>
    </edmx:Reference>
    <edmx:Reference Uri="../../catalogservice;v=2/Vocabularies(TechnicalName='%2FIWBEP%2FVOC_UI',Version='0001',SAP__Origin='LOCAL')/$value">
        <edmx:Include Namespace="com.sap.vocabularies.UI.v1" Alias="UI"/>
    </edmx:Reference>      

com.sap.vocabularies.Common.v1: Common terms for all SAP vocabularies

https://sap.github.io/odata-vocabularies/vocabularies/Common.html

com.sap.vocabularies.UI.v1:Terms for presenting data in user interfaces

https://sap.github.io/odata-vocabularies/vocabularies/UI.html

SAP 为 Fiori Elements 定义的所有 OData vocabulary 注解，都能在这个链接里找到：

https://sap.github.io/odata-vocabularies/

vocabulary-based annotations 有两种类型：

In-place: 是 OData 服务元数据的一部分。

Ex-place: 在 metadata document 之外，由一个注解提供类Annotation Provider Class，简称 APC 额外提供。APC 同 OData 服务的绑定关系，通过事物码 /IWBEP/REG_VOCAN 维护。

These annotations are available using a query to the SAP Gateway catalog service, /sap/opu/odata/IWFND/CATALOGSERVICE;v=2/. Entity Set: ‚Annotations‘.

例如下图所示：