ITPub博客

首页 > 应用开发 > IT综合 > SAP C/4HANA Sales Cloud使用OData服务和第三方系统集成的一个具体例子

SAP C/4HANA Sales Cloud使用OData服务和第三方系统集成的一个具体例子

原创 IT综合 作者:i042416 时间:2019-01-13 11:41:13 0 删除 编辑

出于工作需要,Jerry写了这篇文章,给某些Partner做参考。

以前Jerry曾经介绍过SAP C/4HANA的五朵云到底包含哪些具体产品,其实在SAP官网上有更权威的中文解释:

https://www.sap.com/china/products/crm-commerce/c4-hana-cx-suite.html

其中明确提到销售云包含SAP Cloud for Customer(C4C),SAP Revenue Cloud和Callidus Cloud。

有Partner询问有没有更详细的步骤介绍,关于如何在第三方系统里调用SAP C4C暴露出的Restful API进行集成。本文就给出一个具体的例子,将SAP C4C销售订单的创建功能通过自定义的OData服务暴露出来,然后Partner可以根据项目需要选择合适的编程语言(本文选择JavaScript)来消费。

Jerry以前发布过一个视频,演示了如何在SAP C4C里手动创建一个销售订单,步骤可以说简单易懂。

https://v.qq.com/x/page/d0809f4tswl.html

现在我们通过OData的方式将销售订单的创建功能暴露出来,就能在第三方系统或者应用里完成C4C的订单创建。

大家如果对SAP OData还不太了解,可以先读一读我这篇文章开头的部分:

SAP OData编程指南

下面是详细步骤。

登录C4C系统,访问工作中心Administrator,工作中心视图OData Service Explorer,这里可以在SAP发布的标准OData服务和客户自定义的OData服务之间切换。

因为客户自定义OData服务能够允许客户自行决定从哪一个Business Object的哪一些节点,选择哪一些字段来生成OData模型,通过这种灵活的方式可以避免Business Object上客户业务场景里不需要的字段出现在OData模型中。

点击New按钮新建一个OData服务:

给Work Center View字段指定一个用来做权限控制的视图,只有分配了这个视图的用户才有权限访问这个OData服务。

点击Select Business Object从弹出对话框中选择基于哪一个Business Object创建OData模型。

下图就是一个已经创建好并处于Active状态的OData服务。左边显示的是CustomerQuote这个BO的Root节点的所有字段,每个字段都有一个可以勾选或取消的Select属性,勾选则该BO字段会出现在右侧的OData模型里。

除了Root节点之外,BO的其他子节点上的字段当然也是可以出现在OData模型里的,比如我上图右边OData模型的子节点CustomerQuoteItem, CustomerQuoteParty和CustomerQuoteText等,就是分别从左边BO的同名节点选中后自动带到右边的OData模型中去的。

理论上,完成基于BO模型进行OData模型的创建并激活后,这个OData服务就可以使用了,这体现了SAP C4C OData服务自定义框架的强大之处。然而我也收到了一些朋友从后台给我提的一些问题,罗列如下。

问题1:  仍然以本文销售订单创建这一场景为例,假设我希望我创建的OData服务能够允许消费者调用时指定External Reference的值,但是我找遍整个BO列表,也没发现销售订单的BO上有叫这个名称的字段啊?

Jerry答: External Reference是UI文本,不是BO字段的技术名称。

给C4C系统在浏览器里的url添加参数 debugMode=true , 然后刷新页面,按住Ctrl键再单击External Reference字段,

就能看到这个UI字段绑定到UI模型上哪一个字段了。

在这个UI模型字段上再点击Show Model,就能看到这个UI模型字段绑定到的BO字段名称为BuyerID。

所以我们在OData开发工具里,只需把BO字段BuyerID选中,移动到右边的OData模型里即可。

问题2:我想让我的OData服务支持行项目数据的创建,比如指定产品ID,描述和购买数量等等。我怎么知道哪些BO节点上的字段需要添加到OData模型中去?

Jerry答: 现在我们换一种方法,打开Cloud Application Studio的UI Designer,定位到销售订单创建页面的UI模型COD_SALESORDER_QC, 找到Product ID字段,在它的Properties面板里即可看到这个Product ID字段绑定的BO字段的名称和完整路径:

Root-.ItemProposal- ProductUUID- content

因此我们需要将BO对应路径下面的ProductUUID字段添加到OData模型中去。这里能观察到ProductID的Create和Update是没有勾选上的,而ProductUUID则支持Create和Update,这个行为和C4C销售订单行项目创建的标准实现有关——消费者需要提供待创建行项目包含的产品UUID,然后C4C会根据UUID到系统中查询出对应的产品,显示其ID到UI上。如果消费者在调用OData服务时,没有指定ProductUUID,则行项目创建逻辑不会执行。

OData模型创建好之后,在用编程语言消费之前,我们可以先用工具Postman(或者C4C自带的测试工具)进行测试。

因为SAP C4C后台对 Cross-site request forgery(跨站请求伪造) 这种攻击采取的防御实现和SAP CRM,SAP S/4HANA一样,采取的是 CSRF token验证 机制,因此我们在调用OData服务进行销售订单创建时,需要将一个合法的CSRF token一并传递给C4C系统。

如何得到一个合法的CSRF token呢?在Postman里构造一个HTTP GET请求,头部字段名为

x-csrf-token , 值为fetch:

发送这个HTTP GET请求,服务器端会生成一个CSRF token,通过HTTP响应结构头部字段x-csrf-token返回给消费者:

sNwnYC9cV4xeGSYZmJ8Dtw==

下面我们再在Postman里新建一个HTTP Post请求,将之前通过HTTP GET拿到的CSRF token,以HTTP Post请求头部字段的方式发送给C4C系统。

关键在于HTTP Post请求的请求体。下图高亮部分是我在HTTP Post请求里指定的创建销售订单的输入数据:

在Postman里发送这个Post请求,几秒钟后得到C4C的响应,订单创建成功,ID为9000000451:

为了方便大家对比,下面是我用Postman消费我创建的OData服务生成的销售订单在系统里的显示。字段1~6对应的Postman输入字段可以在前文找到。

蓝色区域高亮显示的字段,我在Postman里构造的输入里并没有维护,而是通过SAP C4C系统的各种determination配置,自动决定出来的。最典型的有SAP老司机们天天打交道的Partner determination,Organization determination,Pricing determination等。

Postman里测试通过后,就可以写代码消费了。

如果想直接复制粘贴我下面列出的代码,可以从我的github上获得:

https://github.com/i042416/KnowlegeRepository/blob/master/ABAP/C4COData/create_SalesOrder.js

注意本代码只用于演示目的,缺少健壮的出错处理,不能直接用于生产环境中。

下面的代码使用nodejs提供的request模块向C4C请求CSRF token。注意第3行的url和第11行的Authorization头部的值,我都是用的虚假值,请大家替换成自己实际使用的C4C url和认证信息。

Token拿到之后,将其放入第41行构造的HTTP Post请求的头部结构中,作为字段x-csrf-token的值。第47行发送该POST请求,C4C响应的数据存放于JavaScript变量data中。

最后我通过简单的console.log打印出创建成功的销售订单ID:

在命令行里用node执行这个js文件,会打印出从C4C获取到的CSRF token,以及成功创建的订单ID。

我们再回顾一下用SAP C/4HANA Sales Cloud中的C4C OData同外部系统做集成的三个主要步骤:

1. 在C4C的OData模型编辑页面里,根据业务需要,从对应的BO节点里选择合适的字段,添加到OData模型中。

2. 用Postman或者C4C自带的OData测试工具对OData模型进行测试,确保其正常工作。

3. 根据项目需要选择合适的编程语言消费OData服务。

如果对于SAP C4C OData有更多的问题需要讨论,欢迎留言。感谢阅读。

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/

  1. 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/

  1. 基于SAP CDS view生成OData服务

https://blogs.sap.com/2016/03/12/my-cds-view-self-study-tutorial-part-4-how-does-annotation-odatapublish-work/

  1. 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/

  1. 使用ABAP消费SAP C4C标准OData服务

https://blogs.sap.com/2017/08/04/consume-standard-c4c-odata-service-via-abap-code/

  1. SAP CRM,C4C和S/4HANA里OData服务实现的横向比较

https://blogs.sap.com/2017/08/07/odata-service-backend-implementation-in-c4c-crm-and-s4-hana/

  1. 使用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/

  1. 使用C4C OData + ABSL消费自定义BO的逻辑

https://blogs.sap.com/2017/12/07/expose-custom-bo-logic-implemented-by-absl-via-custom-odata-service/

要获取更多Jerry的原创文章,请关注公众号"汪子熙":


来自 “ ITPUB博客 ” ,链接:http://blog.itpub.net/24475491/viewspace-2472103/,如需转载,请注明出处,否则将追究法律责任。

请登录后发表评论 登录
全部评论
SAP成都研究院开发专家,SAP社区导师,SAP中国技术大使。

注册时间:2018-01-20

  • 博文量
    826
  • 访问量
    347687