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如何将这个 url 和微信公众号绑定起来？

在微信公众号的自定义菜单里，创建一个新的菜单项“预约”，给它维护一个特定的 url.这样在手机微信里点击这个菜单，就会跳转到对应的 url.

url 格式：https://open.weixin.qq.com/connect/oauth2/authorize?appid=<appid>&redirect_uri=https%3a%2f%2fwww.xxx.com%2fsmart&response_type=code&scope=snsapi_userinfo&state=123#wechat_redirect 其中 appid 在微信公众号后台的公众号开发信息里获取：

而 redirect_url 后面的值，为 web 应用https://www.xxx.com/smart进行 url encode 后的值。这一切设置好之后，从微信公众号菜单跳转到 web 应用的场景就能工作了。如果想在本地模拟微信访问的方式调试部署到服务器上的 Web 应用，只需要安装微信开发者工具，将自己的个人微信号绑定到微信公众号的开发者微信号列表中去：

然后用个人的微信号扫码登录微信开发者工具，在地址栏里输入上述包含 oauth 2.0 重定义的那一长串 url，点击 Allow 按钮：

就可以像使用 Chrome 开发者工具那样，对前端应用代码进行单步调试了：

下面我们采用“上门安装服务”这个场景来说明，假设客户购买了某公司的某产品，希望通过微信来预约某个时段的上门安装服务。

从微信公众号里点击“预约”按钮之后，我们开发的前端应用会自动定位出当前用户的地理位置：武侯花园人民政府，同样我们也提供了允许客户手动修改地址的功能，如下图预约地址字段尾部的字符 2，就是 Jerry 为了测试手动修改的功能而故意添加上去的。

维护手机号和希望上门安装的具体时间段，然后就可以从下拉列表里选择该时间段内可以提供服务的安装技师。这里我们选择名叫李小刚的技师：

点击确定按钮，运行在微信里的前端应用就通过我们开发的后台服务，向 SAP FSM 发起 API 调用。先看最后的结果：我们在微信里收到了公众号推送的通知消息，告诉我们预约已成功。

点击这条消息可以查看预约详情：

待李小刚动身前往客户途中，我们还能在微信里查看李小刚的实时位置共享信息，这是通过 SAP FSM 提供的技师位置服务加上我们的少许自开发实现的效果。

我们在微信开发者工具里重复上述步骤，观察请求明细：

这个 url 指向我们开发的一个后台服务，/ticket/后面跟着的一串数字与字母组合是 Jerry 的个人微信 open ID，13911111111 是我预约时留下的手机号，手机号后面一长串包含 %的片段，是预约时留下地址经过 url encode 后的结果。

请求正文里包含了微信里填入的全部预约信息，和李小刚在 FSM 里的 GUID. CustomerID，则是前端应用通过我的微信 open ID 调用微信 API 获取到的昵称，Jerry Wang. “上门安装机械臂”，是我们为了 demo 方便，硬编码的一个预约标题。

API 调用成功后，返回一个 ID 给消费端，这个 ID 代表了 SAP FSM 里成功创建的预约记录。

下面我们到 SAP FSM 里根据这些 GUID，去详细查看 API 到底在系统里生成了哪些记录。

首先, 如果一个微信用户在 SAP FSM 里不存在对应的 Business Partner 记录，是无法进行业务流程的，因此我们的后台服务实现里，会首先检测该微信用户在 SAP FSM 里是否存在对应的 BP 记录，如果没有，就自动创建一个。

下图是 Jerry 的个人微信号在 SAP FSM 里生成的对应 BP 记录，Additional name 即是我微信号的 open ID，我们的原型开发里，通过微信号的 open ID 同 SAP FSM BP 模型的 Additional name 这一对字段来维护微信用户和 SAP FSM BP 一一对应的关系。这个 BP 的 ID 为 36，记录下来后面会用到。

而我们在微信预约页面选择的技师李小刚，在微信开发者工具里观察到其 GUID 为 2E9BC784D477CA3DD048E593D853CFF1，这也正是李小刚在 SAP FSM 里的明细页面列表 url 的片段之一：

而 SAP FSM API 返回的 ID：B0555705B9EC41009739D0111E16CC91，在系统里实际上是一条 Service Call 记录的 GUID，这条 Call 的 ID 为 175，服务的客户 ID 是 Jerry Wang，Code 为 36，即前面提到的基于微信号 open ID 自动创建的客户记录。

这个 Service Call 有一个同名的 Activity，编号为 205.

在 SAP FSM 的 Activities 页面可以查到这条编号为 205 的记录，其所属的 Service Call 为 175，即上图显示的 Call 内容。

Service Call 和 Activities 创建之后，调度员就可以相应地派工，然后李小刚就可以动身出发了。下图显示的李小刚在系统中被分配了多个安装任务，这是 Jerry 反复测试时创建的数据，其中任务显示上标有的白色小旗，代表任务已完成。

调度员选择一条我刚刚在微信里创建的预约，点击 Release Assignments, 即可完成派工。

在我们的后台服务实现里，使用 SAP FSM nodejs SDK，依次调用了 Service Call，Activity 的创建 API 来创建对应的记录。同时安装技师和安装任务的分配关系，是通过创建一个新的 ServiceAssignment 对象来维护的。这三个 API 的说明在 SAP FSM 官方网站上有文档：https://docs.coresystems.net/dev-index.html

总结

本文首先简单介绍了 SAP Field Service Management 的技术架构和 Restful API，接着详细分享了笔者工作项目中一个实际的通过 SAP FSM API 将其通过微信集成实现的智能服务场景案例。