筆者曾經在 SAP 成都研究院 CRM Fiori開發團隊工作時，擔任了德國一個著名的燈具製造商客戶的CRM Fiori專案的dev angel. 當時客戶提出了若干對 CRM Fiori標準應用的增強需求，總的來說分為前臺Fiori UI介面的增強(比如增添新的自定義欄位)以及後臺邏輯的增強。

當時還處於Fiori 1.0時代，還沒有直接在瀏覽器上使用S/4HANA的Key User tool進行新建欄位的辦法，因此對於前臺介面的增強，我給客戶的解決方案是使用UI5 XML檢視中預留的Extension point，而後臺邏輯的增強，則通過UI5 JavaScript controller中的extension hook以及ABAP後臺的BAdI實現。

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

我和客戶四個月的合作非常愉快，最後專案順利上線，我也收到了德國客戶通過郵件傳送的感謝信，客戶還把這個專案他們做的所有增強程式碼打成壓縮包傳送給我，希望SAP能好好分析這些邏輯，評估某些需求是否具有普遍性，將來能否做到SAP標準Fiori應用裡，以便更多的客戶能受益。這個德國客戶在專案實施中的專業程度和一絲不苟的態度，給我留下了深刻的印象。

當時客戶的一個實際需求是，建立一個新的自定義欄位，並能夠讓該欄位在端到端的業務流程中啟用(支援增刪改查). 雖然這個需求現在看起來比較常見，但在五年前的Fiori 1.0時代，實現起來還頗費一番功夫，因為前後臺都得做一些增強。

![](https://img-blog.csdnimg.cn/img_convert/1c1b1901d831fba6e0d6be1939bf62fa.png)
![](https://img-blog.csdnimg.cn/img_convert/745aaef5bfcc93eeda820b01f5bf526d.png)

我當時把完整的增強實現步驟寫成部落格發在了SAP 社群上，因為步驟較多，總共寫了四篇文章才介紹清楚。

最近 Jerry 在 SAP WebIDE 裡偶然看到新建選單裡有個名叫Adaptation Project的選單項，提供了另一種不通過程式設計即可增強Fiori應用某些行為的方式。

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

這種新的增強方式是通過Fiori Adaptation Project完成的，通過一個實際的需求來介紹。

我們說SAP應用，最典型的使用方式就是以搜尋介面作用入口，在搜尋結果的表格控制元件裡點選某條記錄進入明細頁面開始操作。

由於種種原因，並不是所以的表格控制元件都提供將資料匯出成excel格式的功能。

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

如果搜尋結果的表格是通過SAP Fiori Elements技術繪製而成，可以在WebIDE裡使用Fiori Adaption Project將excel匯出功能啟用。

在WebIDE裡新建一個Fiori Adaptation Project：

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

當我們建立適配專案時，實際是在建立現有應用程式的新變體(variant).

應用程式變體指的是原始應用程式，但包含在適配專案中建立的獨立更改集。此外，還為該變體定義了一個應用程式ID，需要在Fiori Launchpad中單獨註冊。

使用 SAP UI5 Visual Editor 建立 variant.

Adaptation Project 支援的功能有：

- 可以對應用程式進行語義更改(例如，根據特定條件隱藏欄位)

- 控制元件屬性和繫結可以更改(例如啟用或禁用Excel匯出智慧表)

- 可以新增自定義XML片段來擴充套件檢視(例如，單擊按鈕開啟自定義對話方塊)

- 可以新增自定義業務邏輯(JavaScript)(例如，單擊按鈕呼叫odata服務)

- 擴充套件I18n文字(例如翻譯自定義按鈕的標籤)

- 移動控制元件/部分(例如，在物件頁面的兩個標準欄位之間放置一個自定義欄位)

Adaptation Project 同 Fiori Breakout 的區別：

- 在Fiori Elements應用程式中，建立了用於向智慧模板新增自定義UI (XML)和業務邏輯(JavaScript)的 breakout.

- Breakout 是實際應用程式的一部分。因此，如果應用程式開發團隊建立了一個Fiori Element 應用程式，而客戶希望通過 breakout 新增自定義邏輯，那麼這將是一種修改。

- Breakout是對智慧模板的擴充套件，是原始應用的一部分，而適應專案是應用的擴充套件。

下一步需要選擇增強哪一個SAP系統的哪一個Fiori應用。如果待增強的Fiori應用位於On-Premises系統，需要預先配置SAP Cloud Connector和SAP雲平臺上的Destination，否則到了這一步，在SAP UI5 ABAP Repository的下拉選單裡將無法看到該系統。

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

On-Premises系統確定之後，在該系統找到要增強的Fiori應用，通過輸入該應用的技術ID來定位。點選Next完成Fiori Adaptation Project的建立嚮導，這裡我們給該project取名s4demo.

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

在WebIDE裡郵件該project，選擇SAPUI5 Visual Editor，開啟這個所見即所得的檢視編輯器，

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

預設是以Preview模式開啟的，點選右上角的Edit按鈕進入編輯模式：

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

在編輯模式裡，選中檢視上的表格控制元件，準備開始做屬性的修改。
我們注意到這個安全模式的提示，引入這種模式的用意和Android系統以及Windows作業系統的安全模式類似。SAP UI5 Visual Editor的安全模式下，開發者只能針對控制元件進行受限制的屬性修改。

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

有付出就有回報，雖然修改受到限制，但在安全模式下進行的修改是升級安全的，即將來S/4HANA系統升級後，這些修改仍然得以保留。

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

為了啟用表格的excel匯出功能，我們得關掉安全模式：

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

然後把Use Export to Excel的標誌位從預設的false設定成true：

![](https://img-blog.csdnimg.cn/img_convert/21462045f408f33cba2579f65ce875af.png)
![](https://img-blog.csdnimg.cn/img_convert/4ee271c3d631d38d9ae886b8d6c5dd2a.png)

儲存修改，在專案資料夾下生成一個名為changes的資料夾，裡面記錄了這次屬性修改的明細。這種將屬性修改通過單獨的檔案儲存下來的思路，和SAP C4C裡通過Key User Tool或者Cloud Application Studio修改UI檢視後生成Change Transaction用來記錄修改明細是一致的。

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

修改完儲存之後，再次開啟應用，就可以測試這個excel匯出功能了。

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

本地測試通過後，採用和部署SAP標準Fiori應用同樣的辦法，將這個Adaptation Project部署到對應的S/4HANA系統上。

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

點選Show Details能得知到底有哪些資源被成功部署了。

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

成功部署的提示資訊：Folder XXXX ( CUSTOMER_BASE) created in LRep.

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

這個LRep即Layed Repository，S/4HANA裡一個分層的儲存系統。所謂Layed，體現在這個儲存系統引入的分層概念，即Customer Layer，Partner Layer，SAP Layer等。不同的操作者——客戶，Partner和SAP標準開發人員，對這些分層儲存的資源具有不同的讀寫許可權。

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

在S/4HANA系統裡，執行報表/UIF/GET_FILES_4_NS，可以檢視到從WebIDE部署到S/4HANA LRep的這些資源：

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

在第一次執行使用Fiori Adaptation Project增強後的Fiori應用時，儲存在LRep Customer Layer的Fiori Adaptation Project裡描述的UI5應用修改資訊，會和Fiori標準應用的資源做一個合併，產生最後客戶在瀏覽器裡看到的，具有Export to Excel按鈕的Fiori應用。

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

希望本文能夠幫助大家對Fiori應用的又一種增強方式有一個最基礎的瞭解，感謝閱讀。

Fiori 應用通過 Adaptation Project 的增強方式分享

相關文章