OData与SAP Annotation

1. 简介

在博客《Odata基础概念详解》中，介绍了OData中的各种基础概念。一个重要的概念就是Metadata Document (元结构文档)，在Metadata Document 中描述了OData的数据类型以及相关属性，例如属性的名称，属性的类型等等，这些信息属于OData基础的技术信息。

除了此类信息外，其实还可以通过Annotation（注解）的方式为OData添加更加丰富的描述信息，在Metatdata Document中，还可以添加下面几类Annotation - 

1）数据处理控制（Data Processing）：描述哪些操作允许的

2）显示控制（Display）：描述UI的显示属性

3）分析控制（Analytical） ：用于指定属性的分析属性，例如是“dimention”还是“measure”

2. OData中的Annotation

SAP的各种Fiori元素，其实就是一系列基于UI5的动态UI组件，这些组件都是通过Annotation这种方式进行驱动和控制的。

我们可以通过下面三种方式来为OData添加Annotation - 

1）在Entity Type定义中直接添加Annotation。

可以看到在Medata Document中，对于Entiry Type 'Supplie' 中的各种Property, 通过Name，Type等属性为此Property指定了基本的技术属性；于此同时，还可以通过SAP的一系列Namespace例如label, creatable, updatable等一系列Annotation来丰富对于某一属性的控制。

2)  在Metadata document中单独创建Annotation声明

在Metadata document中，除了将Annotation直接嵌入到Property的定义中，还可以通过<Annotation></Annotation>这种方式开辟单独的Annotation描述，进而控制某一Property的UI属性。

3）在Metadata外，创建单独的Annotation文件

除了在OData的Metadata document中声明Annotation，在应用的开发过程中，我们可以为OData创建单独的Annotation File来控制OData的UI属性。

在SAP WebIDE中可以通过Annotation Modelor或Code Editor两种方式来维护这种Local Annotation File。下图展示了Annotation Modelor的操作界面，通过这种图形化的操作，可以方便地对OData的UI属性进行控制。

3. 小结

本文简介了OData与SAP Annotation的基本概念和应用场景，Annotation在SAP Fiori应用程序的开发应用十分广泛。

关于在OData中可以使用的SAP Namespace，可以进一步参照链接http://www.sap.com/Protocols/SAPData，

关于Annotation在SAP Fiori元素中的使用方法，可以访问SAP Fiori 的SAP Community来查找更多相关的资料。