SAP FSM(Field Service Management), 属于SAP C/4HANA五朵云里的Service Cloud.
本文介绍笔者在工作中经历过的一个项目,包含 SAP Field Service Management 同微信集成的一个场景的功能需求分析和详细的技术实现。
我们需要在微信里能够显示FSM的数据,比如FSM里的产品和客户主数据:
一种简易的方式就是使用FSM提供的Query API.
打开FSM官网的帮助文档:
https://docs.coresystems.net/dev-index.html
进入Query API的相关部分:
通过阅读文档,得知FSM Query API采用一种和Facebook Query Language,SAP Hybris Flexible Search和ABAP Open SQL类似的思路,即仿SQL语法的查询方式,从FSM系统里读取数据。
下图是Facebook Query Language的一个例子:
下图是SAP Hybris Commerce Flexible Search的例子:
ABAP Open SQL的例子我就不贴了,大家太熟悉了。
那么FSM的Query API如何使用呢?
登录FSM,点击Query API:
在弹出来的控制台里,输入类SQL语句:
SELECT bp FROM BusinessPartner bp
默认返回了前40条数据:
那么如何使用代码来触发Query API查询呢?官网上给出了一个基于nodejs的SDK,可以轻易实现用代码调用Query API的需求。
点击超链接后,会跳转到github的一个仓库:
按照帮助文档上的示例代码,将自己FSM系统里创建的API client对应的credential维护到代码里,得到一个CoreAPIClient实例。
ClientIdentifier和clientSecret等Credential字段的值,可以通过Admin标签页,新建一个Client后获得:
使用CoreAPIClient实例的query方法向FSM系统发起Query API请求,输入参数一为应用程序里拼接的类SQL查询语句,参数二为Data Transfer Object的名称,在帮助文档里能查到。
通过Visual Studio Code调试器观察上面这个API调用返回的结果。因为我的752和753行代码分别指定了Item和BusinessPartner的查询,因此API调用返回的响应是一个数组,其内两个元素分别包含了Item和BusinessPartner各前40条数据。
每个Item和Business Partner实例的明细在调试器里显示如下:
假设我们的场景是:希望在微信里能够浏览SAP FSM里可用的服务技师,如下图所示:
那么首先要设计一个Web应用,在该Web应用里通过第一篇文章介绍的方式,使用SAP FSM提供的nodejs SDK去调用API.
为此,我们开发了一个Vue应用,在Vue生命周期钩子函数mounted里,发起对SAP FSM employee(技师)数据的请求:
在我们微信里指定的时间段内,SAP FSM有三个可用的技师,其名称,用户评分,头衔,服务年限等数据通过FSM nodejs SDK返回给微信端,如上图微信开发者调试器里所示。
比如employeeID为2E9BC784D477CA3DD048E593D853CFF1的这条数据,可以直接在FSM里通过这个url查看:
https://de.coresystems.net/master-data-management/#/people/details/2E9BC784D477CA3DD048E593D853CFF1
这个Vue应用做好之后,部署到服务器上,生成一个url,我们假设为https://www.xxx.com/smart