出于工作需要&＃xff0c;Jerry写了这篇文章&＃xff0c;给某些Partner做参考。
以前Jerry曾经介绍过SAP C/4HANA的五朵云到底包含哪些具体产品&＃xff0c;其实在SAP官网上有更权威的中文解释&＃xff1a;
https://www.sap.com/china/products/crm-commerce/c4-hana-cx-suite.html
其中明确提到销售云包含SAP Cloud for Customer(C4C)&＃xff0c;SAP Revenue Cloud和Callidus Cloud。
有Partner询问有没有更详细的步骤介绍&＃xff0c;关于如何在第三方系统里调用SAP C4C暴露出的Restful API进行集成。本文就给出一个具体的例子&＃xff0c;将SAP C4C销售订单的创建功能通过自定义的OData服务暴露出来&＃xff0c;然后Partner可以根据项目需要选择合适的编程语言(本文选择Javascript)来消费。
Jerry以前发布过一个视频&＃xff0c;演示了如何在SAP C4C里手动创建一个销售订单&＃xff0c;步骤可以说简单易懂。
现在我们通过OData的方式将销售订单的创建功能暴露出来&＃xff0c;就能在第三方系统或者应用里完成C4C的订单创建。
大家如果对SAP OData还不太了解&＃xff0c;可以先读一读我这篇文章开头的部分&＃xff1a;
SAP OData编程指南
下面是详细步骤。
登录C4C系统&＃xff0c;访问工作中心Administrator&＃xff0c;工作中心视图OData Service Explorer&＃xff0c;这里可以在SAP发布的标准OData服务和客户自定义的OData服务之间切换。
因为客户自定义OData服务能够允许客户自行决定从哪一个Business Object的哪一些节点&＃xff0c;选择哪一些字段来生成OData模型&＃xff0c;通过这种灵活的方式可以避免Business Object上客户业务场景里不需要的字段出现在OData模型中。
点击New按钮新建一个OData服务&＃xff1a;
给Work Center View字段指定一个用来做权限控制的视图&＃xff0c;只有分配了这个视图的用户才有权限访问这个OData服务。
点击Select Business Object从弹出对话框中选择基于哪一个Business Object创建OData模型。
下图就是一个已经创建好并处于Active状态的OData服务。左边显示的是CustomerQuote这个BO的Root节点的所有字段&＃xff0c;每个字段都有一个可以勾选或取消的Select属性&＃xff0c;勾选则该BO字段会出现在右侧的OData模型里。
除了Root节点之外&＃xff0c;BO的其他子节点上的字段当然也是可以出现在OData模型里的&＃xff0c;比如我上图右边OData模型的子节点CustomerQuoteItem, CustomerQuoteParty和CustomerQuoteText等&＃xff0c;就是分别从左边BO的同名节点选中后自动带到右边的OData模型中去的。
理论上&＃xff0c;完成基于BO模型进行OData模型的创建并激活后&＃xff0c;这个OData服务就可以使用了&＃xff0c;这体现了SAP C4C OData服务自定义框架的强大之处。然而我也收到了一些朋友从后台给我提的一些问题&＃xff0c;罗列如下。
问题1&＃xff1a; 仍然以本文销售订单创建这一场景为例&＃xff0c;假设我希望我创建的OData服务能够允许消费者调用时指定External Reference的值&＃xff0c;但是我找遍整个BO列表&＃xff0c;也没发现销售订单的BO上有叫这个名称的字段啊&＃xff1f;
Jerry答&＃xff1a;External Reference是UI文本&＃xff0c;不是BO字段的技术名称。
给C4C系统在浏览器里的url添加参数debugMode&＃61;true, 然后刷新页面&＃xff0c;按住Ctrl键再单击External Reference字段&＃xff0c;
就能看到这个UI字段绑定到UI模型上哪一个字段了。
在这个UI模型字段上再点击Show Model&＃xff0c;就能看到这个UI模型字段绑定到的BO字段名称为BuyerID。
所以我们在OData开发工具里&＃xff0c;只需把BO字段BuyerID选中&＃xff0c;移动到右边的OData模型里即可。
问题2&＃xff1a;我想让我的OData服务支持行项目数据的创建&＃xff0c;比如指定产品ID&＃xff0c;描述和购买数量等等。我怎么知道哪些BO节点上的字段需要添加到OData模型中去&＃xff1f;
Jerry答&＃xff1a;现在我们换一种方法&＃xff0c;打开Cloud Application Studio的UI Designer&＃xff0c;定位到销售订单创建页面的UI模型COD_SALESORDER_QC&＃xff0c; 找到Product ID字段&＃xff0c;在它的Properties面板里即可看到这个Product ID字段绑定的BO字段的名称和完整路径&＃xff1a;
Root-.ItemProposal-~ProductUUID-~content
因此我们需要将BO对应路径下面的ProductUUID字段添加到OData模型中去。这里能观察到ProductID的Create和Update是没有勾选上的&＃xff0c;而ProductUUID则支持Create和Update&＃xff0c;这个行为和C4C销售订单行项目创建的标准实现有关——消费者需要提供待创建行项目包含的产品UUID&＃xff0c;然后C4C会根据UUID到系统中查询出对应的产品&＃xff0c;显示其ID到UI上。如果消费者在调用OData服务时&＃xff0c;没有指定ProductUUID&＃xff0c;则行项目创建逻辑不会执行。
OData模型创建好之后&＃xff0c;在用编程语言消费之前&＃xff0c;我们可以先用工具Postman(或者C4C自带的测试工具)进行测试。
因为SAP C4C后台对Cross-site request forgery(跨站请求伪造)这种攻击采取的防御实现和SAP CRM&＃xff0c;SAP S/4HANA一样&＃xff0c;采取的是CSRF token验证机制&＃xff0c;因此我们在调用OData服务进行销售订单创建时&＃xff0c;需要将一个合法的CSRF token一并传递给C4C系统。
如何得到一个合法的CSRF token呢&＃xff1f;在Postman里构造一个HTTP GET请求&＃xff0c;头部字段名为
x-csrf-token, 值为fetch&＃xff1a;
发送这个HTTP GET请求&＃xff0c;服务器端会生成一个CSRF token&＃xff0c;通过HTTP响应结构头部字段x-csrf-token返回给消费者&＃xff1a;
sNwnYC9cV4xeGSYZmJ8Dtw&＃61;&＃61;
下面我们再在Postman里新建一个HTTP Post请求&＃xff0c;将之前通过HTTP GET拿到的CSRF token&＃xff0c;以HTTP Post请求头部字段的方式发送给C4C系统。
关键在于HTTP Post请求的请求体。下图高亮部分是我在HTTP Post请求里指定的创建销售订单的输入数据&＃xff1a;
在Postman里发送这个Post请求&＃xff0c;几秒钟后得到C4C的响应&＃xff0c;订单创建成功&＃xff0c;ID为9000000451&＃xff1a;
为了方便大家对比&＃xff0c;下面是我用Postman消费我创建的OData服务生成的销售订单在系统里的显示。字段1&＃xff5e;6对应的Postman输入字段可以在前文找到。
蓝色区域高亮显示的字段&＃xff0c;我在Postman里构造的输入里并没有维护&＃xff0c;而是通过SAP C4C系统的各种determination配置&＃xff0c;自动决定出来的。最典型的有SAP老司机们天天打交道的Partner determination&＃xff0c;Organization determination&＃xff0c;Pricing determination等。
Postman里测试通过后&＃xff0c;就可以写代码消费了。
如果想直接复制粘贴我下面列出的代码&＃xff0c;可以从我的github上获得&＃xff1a;
https://github.com/i042416/KnowlegeRepository/blob/master/ABAP/C4COData/create_SalesOrder.js
注意本代码只用于演示目的&＃xff0c;缺少健壮的出错处理&＃xff0c;不能直接用于生产环境中。
下面的代码使用nodejs提供的request模块向C4C请求CSRF token。注意第3行的url和第11行的Authorization头部的值&＃xff0c;我都是用的虚假值&＃xff0c;请大家替换成自己实际使用的C4C url和认证信息。
Token拿到之后&＃xff0c;将其放入第41行构造的HTTP Post请求的头部结构中&＃xff0c;作为字段x-csrf-token的值。第47行发送该POST请求&＃xff0c;C4C响应的数据存放于Javascript变量data中。
最后我通过简单的console.log打印出创建成功的销售订单ID&＃xff1a;
在命令行里用node执行这个js文件&＃xff0c;会打印出从C4C获取到的CSRF token&＃xff0c;以及成功创建的订单ID。
我们再回顾一下用SAP C/4HANA Sales Cloud中的C4C OData同外部系统做集成的三个主要步骤&＃xff1a;
1. 在C4C的OData模型编辑页面里&＃xff0c;根据业务需要&＃xff0c;从对应的BO节点里选择合适的字段&＃xff0c;添加到OData模型中。
2. 用Postman或者C4C自带的OData测试工具对OData模型进行测试&＃xff0c;确保其正常工作。
3. 根据项目需要选择合适的编程语言消费OData服务。
如果对于SAP C4C OData有更多的问题需要讨论&＃xff0c;欢迎留言。感谢阅读。
Jerry关于OData的更多文章
1. SAP OData编程指南
2. OData服务同步模式和异步模式的讨论
https://blogs.sap.com/2015/06/19/a-test-on-fiori-odata-request-synchronous-mode-vs-asynchronous-mode/
3. OData服务的性能分析
https://blogs.sap.com/2015/07/01/how-to-find-odata-performance-trace-and-payload-trace-functionality/
https://blogs.sap.com/2016/01/13/measure-the-performance-of-your-odata-service/
4. 基于SAP CDS view生成OData服务
https://blogs.sap.com/2016/03/12/my-cds-view-self-study-tutorial-part-4-how-does-annotation-odatapublish-work/
5. OData的offline支持
5.1 https://blogs.sap.com/2016/08/04/how-is-odata-request-routed-to-offline-data-store-by-odata-offline-plugin/
5.2 https://blogs.sap.com/2016/08/04/how-is-Javascript-code-in-odata-offline-plugin-delegated-to-native-java-code-in-android/
5.3 https://blogs.sap.com/2016/08/05/how-is-odata-offline-store-opened-in-android-platform/
6. 使用ABAP消费SAP C4C标准OData服务
https://blogs.sap.com/2017/08/04/consume-standard-c4c-odata-service-via-abap-code/
7. SAP CRM&＃xff0c;C4C和S/4HANA里OData服务实现的横向比较
https://blogs.sap.com/2017/08/07/odata-service-backend-implementation-in-c4c-crm-and-s4-hana/
8. 使用Java和jMeter对需要支持CSRF验证的OData服务进行高并发性能测试
https://blogs.sap.com/2017/08/28/odata-service-parallele-performance-measurement-how-to-deal-with-xsrf-token-in-java-program-and-jmeter/
9. 使用C4C OData &＃43; ABSL消费自定义BO的逻辑
https://blogs.sap.com/2017/12/07/expose-custom-bo-logic-implemented-by-absl-via-custom-odata-service/
京公网安备 11010802041100号