SAP CRM Fiori 应用的 Deep Create 行为

什么是 OData 的 Deep Create 行为？我们通过一个具体的例子来了解。

下图是 SAP CRM Fiori 应用之一的 My Opportunities 界面。

我们点击 + 按钮，可以创建新的 Opportunity 实例。

在 Opportunity 创建页面里，可以维护 Opportunity 抬头区域的字段值。所谓抬头区域，可以理解成 Opportunity OData 模型的根节点：

抬头区域的字段值维护完毕之后，往下滑动屏幕，看到 Product 区域。点击 + 按钮，添加 Product 数据：

下图高亮区域就是 Product 数据，而从建模的层面来说，这些字段值，都是 Opportunity OData 模型的子节点，即 Product 子节点上的字段值。

因此，所谓 OData 的 Deep Create 操作，就是 OData 消费者在一个 HTTP 请求里，同时提供了待创建的根节点和子节点字段值，这样 OData 服务提供者在接收到这个 HTTP 请求后，能够同时创建包含根节点和子节点的业务数据实例。

我们在 Chrome 开发者工具的 Network 页面里，观察到上述场景所触发的 OData 请求，其 HTTP Payload 明细如下：

{"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}

上图的 Products，是一个 navigation property，定义在 SEGW 事物码里这个位置：

SAP ABAP OData 服务器端的处理，当接收到上述的 HTTP 请求 payload 之后，框架会调用 OData DPC_EXT 类的 CREATE_DEEP_ENTITY 方法，其调用栈如下图所示：

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

首先使用 io_data_provider, 读取 header 区域的数据：

读取出来的 header 数据里，OData 框架已经帮我们解析好了通过 navigation property 维护的 products 数据：

最后 products 指向的数据，通过输入参数 it_product_i, 传入 One Order API CRM_ORDER_MAINTAIN:

该 HTTP Post 请求成功执行后，返回 201 Created 状态码：