筆者之前的文章[如何使用 Restful ABAP Programming 程式設計模型開發一個支援增刪改查的 Fiori 應用](https://xie.infoq.cn/article/6055ea38a8628e7f5babd6683)，已經對 SAP Restful ABAP Programming 程式設計模型(以下簡稱 RAP)進行了一個最基本的介紹。

我們簡單回顧一下之前文章的內容：在SAP雲平臺ABAP程式設計環境裡建立了一個Z表，然後基於這張自定義資料庫表建立了CDS view，基於該view建立Service Definition，把view暴露成服務，然後透過Behavior Definition實現對Z表的增刪改查。

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

雙擊Service Binding裡的TravelProcessor或者右鍵選單裡選擇Open Fiori Elements App Preview, 就可以訪問Fiori應用。

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

稍稍有點經驗的 SAP 顧問朋友們都明白，一個模型只有增刪改查的功能是不能滿足客戶實際需求的。在SAP Cloud for Customer裡，開發顧問可以在Cloud Application Studio裡建立beforeSave和afterModify這些指令碼檔案並實現業務邏輯，筆者也曾經介紹過，它們相當於S/4HANA BOPF框架裡建立的determination.

除了上述在執行時特定的時間點才能觸發(beforeSave，afterModify)的邏輯外，Action機制則提供了自由度更高的業務邏輯編寫機制。體現在UI上，Action邏輯一般透過UI按鈕觸發。

Validation比較容易理解——自定義的資料校驗邏輯。

本文按照順序介紹 RAP 的 Action和Validation.

為了介紹在Restful ABAP Programming模型下如何開發Action，我們在前一篇文章建立的SFLIGHT表增添一個表示航班預訂狀態的欄位，並開發一個Action，當其被呼叫時，修改這個狀態。

(1）在資料庫表裡增添一個OVERALL_STATUS欄位：

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

當然在對應的CDS view上也要透過 `@UI`相關的註解把這個欄位配置到UI上。透過註解lineItem和identification分別把view的這個欄位顯示在搜尋結果的table控制元件和航班資訊明細頁面的欄位上。透過label指定UI上顯示的標籤，透過註解的dataAction把這個狀態欄位繫結到一個名為acceptTravel的Action上。

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

重新啟用CDS view後，我們就能在工具欄上看到CDS view裡透過label維護的標籤文字為Accept Travel了：

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

因為缺乏實現，此時點選無效果。

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

(2) 在Behavior Definition的宣告部分，新增如下三行程式碼：

![](https://img-blog.csdnimg.cn/img_convert/dd7c843cc0a7b7ac78499290fa3183f5.png)
```abap
action ( features: instance ) acceptTravel result [1] $self;
validation validateCustomer on save { field customer_id; }
validation validateDates on save { field begin_date, end_date;
```

上面的程式碼除了定義一個Action外，還宣告瞭兩個Validation，在特定欄位發生變化並儲存時觸發校驗邏輯，欄位名稱維護在大括號內。
剩下的就是ABAP程式設計實現了。在Behavior Definition的ABAP實現類裡，宣告下面這些ABAP類方法，來實現Behavior Definition裡的定義。

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

首先看Action的實現，位於ABAP方法SET_STATUS_COMPLETED裡：

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

將輸入引數travel_id指定的航班預訂記錄的狀態欄位置為A - Accepted.
現在我選中ID為22這條記錄，點選Accept Travel按鈕：

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

點選之後，狀態成功被置為A了：

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

再來加上對航班日期的校驗：如果航班結束日期在起始日期之前，顯然不合理，需要彈一條錯誤訊息。

第87行到第91行把輸入引數包含的航班資訊讀到內表lt_travel_result裡，然後第95行把結束日期和起始日期做比較，如果後者早於前者，進入97行開始的IF分支，彈一個錯誤資訊到UI.

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

錯誤資訊仍然和傳統的ABAP程式設計一樣，透過ABAP Message類定義：

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

現在把結束日期維護成起始日期之前，儲存的時候就看到了期望的錯誤訊息：

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

至此，我們這個SFLIGHT模型除了增刪改查之外，又增添了Action和Validation的功能。

應用開發完成後，我們就可以開始除錯了。

我選中ID為103這條記錄，點選Accept Travel按鈕後，期望透過該Action將其狀態設定為Accepted：

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

不幸的是，我沒能看到期望中的狀態變化，而是下面這個所有ABAP程式設計人員都不願意看見的ABAP執行時錯誤提示介面。

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

不過，大家注意到了上圖右下角的Debug超連結麼？和SAPGUI一樣，點選之後立即就能開啟偵錯程式，能夠觀察發生這個執行時錯誤的呼叫棧，引起錯誤的詳細程式碼位置和相關變數的值。

回到ABAP Development Tool裡，我們先點選Show超連結，就可以看到執行時錯誤明細：Short Text告訴我們，我們點選Accept按鈕後，相關的處理框架有意地丟擲一個CX_CSP_ACT_RESPONSE的異常。丟擲異常的位置是在程式CL_CSP_ACT_CHECK_FEATS_ACTIONS裡，這暗示我們，這個錯可能和Action執行前的檢查(CHECK)有關。

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

繼續向下滑動滑鼠，發現在框架程式碼內，因為從第353行內表it_feature_result裡沒有讀出任何內容，因此sy-subrc不為0，導致進入第355行的RAISE SHORTDUMP分支。

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

在SAP Cloud Platform ABAP環境下當前登入使用者發生的所有執行時錯誤，可以在ABAP Development Tool的Feed Reader檢視下檢視，這個功能相當於SAP GUI裡的ST22事務碼。

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

現在我們關於這個執行時錯誤的靜態資訊瞭解得差不多了，下一步在偵錯程式裡觀察。
重新啟動Fiori應用，再次點選Accept按鈕，出現執行時錯誤後點選Debug超連結，ABAP偵錯程式自動彈出，引起執行時錯誤的那一行程式碼被高亮，同時左邊顯示出呼叫棧。

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

把滑鼠放在it_feature_result上，發現這個內表是空的，當然無法從裡面讀出資料了。這個內表是當前ABAP類CL_CSP_ACT_CHECK_FEATS_ACTIONS的方法handle_rejected_instances的輸入引數，需要搞清楚為啥這個輸入引數為空。

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

從丟擲執行時異常的棧幀往外看一幀，就知道這個輸入的內表是透過第291行的execute_feature_controllers生成的，這個方法會透過回撥函式的方式，呼叫我們在Behavior Definition實現的一個get_features方法裡：

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

這裡我們就找到了引起這個執行時錯誤的根源：因為之前筆者出於測試目的，註釋了一段程式碼，導致get_features被框架回撥時，沒有返回框架期望的資料：

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

當Jerry把這段需要的程式碼重新enable然後設定斷點，點選Accept按鈕，透過呼叫棧可以清晰看到框架的execute_feature_controllers是如何呼叫到我們實現的get_features回撥方法的。

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

# 總結

本文首先在一個支援增刪改查四種基礎操作的 RAP 應用上，增添了 Action 和 Validation 實現，二者都是雲端 ABAP 程式設計環境裡進行業務邏輯編寫的重要手段。其次介紹了雲端 ABAP 程式設計環境中進行開發的必備技巧，即程式碼的單步除錯。

SAP Restful ABAP Programming 程式設計模型的 Action 實現和雲端除錯介紹

相關文章