什麼是 OData 的 Deep Create 行為？我們透過一個具體的例子來了解。

下圖是 SAP CRM Fiori 應用之一的 My Opportunities 介面。

我們點選 `+` 按鈕，可以建立新的 Opportunity 例項。

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

在 Opportunity 建立頁面裡，可以維護 Opportunity 抬頭區域的欄位值。所謂抬頭區域，可以理解成 Opportunity OData 模型的根節點：

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

抬頭區域的欄位值維護完畢之後，往下滑動螢幕，看到 Product 區域。點選 `+` 按鈕，新增 Product 資料：

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

下圖高亮區域就是 Product 資料，而從建模的層面來說，這些欄位值，都是 Opportunity OData 模型的子節點，即 Product 子節點上的欄位值。

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

因此，所謂 OData 的 Deep Create 操作，就是 OData 消費者在一個 HTTP 請求裡，同時提供了待建立的根節點和子節點欄位值，這樣 OData 服務提供者在接收到這個 HTTP 請求後，能夠同時建立包含根節點和子節點的業務資料例項。

我們在 Chrome 開發者工具的 Network 頁面裡，觀察到上述場景所觸發的 OData 請求，其 HTTP Payload 明細如下：

```json
{"Description":"deep create","ProcessType":"OPPT","StartDate":"2022-8-28T00:00:00","ClosingDate":"2022-8-28T00:00:00","ExpectedSalesVolume":"0","SalesStageCode":"1","UserStatusCode":"E0001","UserStatusText":"Open","PriorityCode":"","PriorityText":"","ProspectName":"4221711","ProspectNumber":"4221711","MainContactName":"","ChanceOfSuccess":"0","ForecastRelevance":true,"CurrencyCode":"","Guid":"00000000-0000-0000-0000-000000000000","Statuses":[{"HeaderGuid":"00000000-0000-0000-0000-000000000000","StatusProfile":"CRMOPPOR","UserStatusCode":"E0001","UserStatusText":"Open","StatusOrderNumber":"01"}],"Products":[{"HeaderGuid":"00000000-0000-0000-0000-000000000000","ProcessingMode":"A","ProductGuid":"00163EA7-1FFC-1EE1-A7E6-1543AD7395C1","ProductId":"AWEHFOIQF","ProductName":"blabla","Quantity":"1","TotalExpectedNetValue":"11","Unit":""}],"SalesTeam":[{"HeaderGuid":"00000000-0000-0000-0000-000000000000","PartnerFunctionCode":"00000004","PartnerNumber":"4221711","PartnerName":"","PartnerFunctionText":"Payer"}],"EmployeeResponsibleNumber":"4031140","PredecessorGUID":null}
```
![](https://img-blog.csdnimg.cn/img_convert/4bf6ae79f84c2f4dba7faebe2283e530.png)

上圖的 Products，是一個 navigation property，定義在 SEGW 事物碼裡這個位置：

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

SAP ABAP OData 伺服器端的處理，當接收到上述的 HTTP 請求 payload 之後，框架會呼叫  OData DPC_EXT 類的 CREATE_DEEP_ENTITY 方法，其呼叫棧如下圖所示：

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

框架解析出的 lv_expand_string, 包含了 navigation property `Products`:

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

首先使用 `io_data_provider`, 讀取 header 區域的資料：
![](https://img-blog.csdnimg.cn/img_convert/64084d76e2a4b8ca5b964e91c8025c99.png)

讀取出來的 header 資料裡，OData 框架已經幫我們解析好了透過 navigation property 維護的 products 資料：

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

最後 products 指向的資料，透過輸入引數 `it_product_i`, 傳入 One Order API CRM_ORDER_MAINTAIN:

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

該 HTTP Post 請求成功執行後，返回 201 Created 狀態碼：

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

SAP CRM Fiori 應用的 Deep Create 行為和實現分析

相關文章