[課程地址](https://open.sap.com/courses/fiori-ea1/items/4uWJtD7MhCRY85P9ct7dZO)

很多 SAP 從業者反映，open SAP 上的影片，因為網路原因無法訪問，所以我會陸續在我的個人微 信 號“汪子熙”上面，把這些影片配上中文字幕併發布出來，敬請關注。

![](https://img-blog.csdnimg.cn/img_convert/25420f56d2427fce26936d5612be80e1.png)

本單元的話題是 SAP OData 和註解的深入講解。

![](https://img-blog.csdnimg.cn/img_convert/24d5d83cc9f79c8ead11ed32dfba32af.png)

下面是本單元影片講解的中文字幕，均由 Jerry 人工翻譯而成。

====

歡迎大家來到 Open SAP Fiori Elements 公開課第三單元。本單元介紹 OData 和註解

我是 Stefan Engelhardt, 是 SAP Fiori Elements 的開發架構師

在第二單元，Marcel 已經簡單介紹了 OData. 每個 Fiori Elements 應用都需要一個 OData 服務

Fiori Elements 對 OData 服務的後臺技術棧沒有特殊要求，因為 OData 協議本身就是對後臺實現細節的抽象

![](https://img-blog.csdnimg.cn/img_convert/83b924473c8c8e04303875852eb62d7b.png)

現在我們將深入介紹 OData 服務的核心概念。從資料模型的元描述開始

每個 OData 服務都有其資料模型的元描述資訊。螢幕右邊是一個例子

我們通常簡稱為 OData 後設資料。在 OData url 後面加上 $metadata 即可檢視其後設資料

螢幕左邊底部的超連結是 該 OData 後設資料的完整 url

後設資料定義了業務模型及其屬性

下圖右邊是一個 OData V4 的例子，定義了一個 Person 模型

![](https://img-blog.csdnimg.cn/img_convert/0ebc596b3000db3d83f3dd86273c590f.png)

包含使用者名稱，FirstName 等欄位

後設資料中屬性也具有進一步的定義

這些進一步的定義包含屬性的資料型別，比如 Edm.String, 是否允許儲存 null 值，欄位最大長度等

描述實體與其他實體關係的欄位被稱為導航欄位

模型的導航欄位指明瞭模型和其導航目標模型的基數關係，即"一對一"還是"一對多"

例如螢幕中名為 Trips 的導航屬性，指向的目標模型 Trip，型別是 Collection, 說明 Person 和 Trip 兩個模型是一對多的關係

此外，後設資料還可以包含複雜型別，actions 和 singleton 等等的定義

Marcel 在上一個單元中已經介紹過，OData 支援增刪改查操作

讓我們來看一些例子

這裡我們能看到對一個 OData 服務發起的 HTTP 請求和響應

第一個場景是讀取所有的 People. People 的型別是 Person, 定義在後設資料裡

HTTP 響應包含對應的資料集。結果列表裡的第一條記錄是 Russell Whyte

我們還可以透過指定 key, 來查詢某條特定的 Person 記錄

把鍵值 russellwhyte 新增到花括號裡，在響應中您可以看到, 該請求只返回了一條對應的資料

讓我們再來看看一些更復雜的查詢

使用 $top，只返回前兩條記錄。使用 $select, 只讀取 FirstName 和 LastName 欄位

對結果集再次過濾，條件為至少擁有一條 Trip 記錄，且費用超過3000

如大家看到的， 我們可以非常靈活地構造複雜查詢語句

現在展示如何建立一條 Person 記錄

使用 HTTP POST 請求，在請求正文中維護 Person 資料

響應返回 HTTP 201 狀態碼，表明資料建立成功

![](https://img-blog.csdnimg.cn/img_convert/e30fe6267c18aeec78f1bd1e9a10202f.png)

為提高 Fiori 使用者體驗，SAP 定義了一種標準化的支援文件 Draft 版本的處理機制

有了 Draft 機制，使用者對文件的編輯可以隨時中斷並隨時繼續

![](https://img-blog.csdnimg.cn/img_convert/c41027d66f6826ae297cc6ea1c93127a.png)

只有當使用者完成編輯之後，文件資料才會儲存到對應的資料庫表裡

在 SAP Fiori Elements 應用裡，每當使用者在編輯模式下新增或者更改資訊時，Draft 版本的資料都會自動被儲存

這種自動儲存的請求響應，可能會包含一些提示訊息，比如 SalesArea 的 sold-to party 沒有維護

當 sold-to party 資料發生變化時，HTTP 響應包含了該 party 所有資料，以便顯示在 UI 上

比如地址和聯絡人資訊。Draft 機制使應用具備動態互動的特性

![](https://img-blog.csdnimg.cn/img_convert/8a002115c15d7cd85dce9fb97b629102.png)

注意，Draft 機制應該透過框架提供開箱即用的支援

如果在應用程式層面重新實現整套 Draft 處理機制，工作量相當巨大

上一單元 Marcel 也介紹過 OData 註解。這些註解從行為和消費方式兩方面，對模型提供更多描述資訊

現在我將解釋 OData 註解的工作原理，並舉例說明

註解是 OData 額外的後設資料，格式為 XML

註解定義於 OData 和 SAP 維護的詞彙表中

註解都是一些抽象的定義，因此較穩定，不會頻繁變動，能夠被包括 SAP UI5 在內的消費端解析

SAP Fiori Elements 解析註解並生成對應的 UI 頁面

看一個具體的例子：Travel App 裡的 Total Price 欄位

![](https://img-blog.csdnimg.cn/img_convert/24c27d256cbbf2e8d45397f8769d9e9e.png)

在 OData Measures 詞彙表裡，存在一個 ISOCurrency 註解

OData 後設資料裡的 TotalPrice 型別被其註解，指向目標欄位 CurrencyCode

因而框架程式碼能夠理解，TotalPrice 是一個貨幣金額，而 CurrencyCode 欄位包含了貨幣單位

於是 Fiori Elements 在金額欄位的右邊顯示貨幣單位

該註解還用於根據貨幣單位顯示對應的小數，並保證在表格中讓金額的顯示也能正確對齊

註解當然還能夠定義更復雜的 UI 元素

例如，這些 UI 可以是透過 UI.LineItem 定義的表格

透過 UI.FieldGroup 定義的 form, 透過 UI.Chart 定義的圖表等等

![](https://img-blog.csdnimg.cn/img_convert/edc6f1b29e41628f57fab4b7e38c47dc.png)

此外，註解還可以從行為方面來對應用程式進行描述

一個例子是在應用程式中提供增刪改查等功能

比如透過註解，可以指定 Travel 模型可以被編輯，於是 Fiori Elements 在 UI 上繪製 Edit 按鈕

工具欄其他按鈕的顯示或隱藏邏輯也以此類推

![](https://img-blog.csdnimg.cn/img_convert/cde7a7c65a0f2380b6fe627ea46dcb60.png)

另一個場景是所謂 Side Effect 的定義

例如，當表格行專案級別的產品單價發生變化時，UI 需要重新從後臺讀取最新的訂單抬頭級別的總價資訊

SAP 系統後臺可以提供基於 ABAP CDS 或者 CAP CDS 的註解

或者也可以使用本地檔案定義的註解。對於 UI 來說，它不關心註解來自後臺伺服器或是本地檔案

CDS View 中的註解被後臺伺服器翻譯成 XML 格式的註解

後者被 Fiori Elements 框架解析

XML 格式的註解可以被任何型別的後臺伺服器使用

這些後臺伺服器可以是 SAP 傳統的 ABAP 程式設計模型，SAP BW 和非 SAP 伺服器。下圖右邊是 ABAP CDS 註解的一個例子

![](https://img-blog.csdnimg.cn/img_convert/38469d44f94edfed910b7166f075be48.png)

您平時對於開發工具的偏好，可能會影響您對註解型別的選擇

在 SAP Fiori Tools 中，其提供的嚮導式建立步驟，能幫助我們建立正確的註解

![](https://img-blog.csdnimg.cn/img_convert/a3eb8fabac412f3a8aeacc612f8e824a.png)

XML 和 CAP CDS 註解都能被 SAP Fiori Tools 支援

如果您使用 ABAP Development Tool, 可以直接在 ABAP CDS 中維護註解

生命週期管理和功能可用性同樣會影響註解型別的選取

![](https://img-blog.csdnimg.cn/img_convert/ee77bed36d840ecbbe9773e177613c6a.png)

UI 專案本地檔案提供的註解，其生命週期同應用程式一致。CDS 註解的生命週期同 OData 服務實現一致

如果我們是在一個比較低版本的 ABAP 伺服器上開發，某些註解可能無法被支援。如果有疑問，請查詢文件

讓我們總結一下本單元的內容

我們介紹了 OData 概念的核心部分，OData 後設資料，OData 請求，以及 Draft 機制

![](https://img-blog.csdnimg.cn/img_convert/2fc294549f800d08f450d056567fc498.png)

我們也學習了什麼是 OData 註解，以及它是如何影響 Fiori Elements 應用的

現在大家可以期待下一單元的內容了。屆時我們將介紹如何搭建 Fiori Elements 應用的開發環境。感謝收看本影片，下期再見

SAP Fiori Elements 公開課第三單元學習筆記 - OData 和註解深入講解

相關文章