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來查找更多相關的資料。