SAP FSM(Field Service Management), 屬於SAP C/4HANA五朵雲裡的Service Cloud.

![](https://img-blog.csdnimg.cn/img_convert/100d72d852d77706959fa7f1ddde103b.png)

本文介紹筆者在工作中經歷過的一個專案，包含 SAP Field Service Management 同微信整合的一個場景的功能需求分析和詳細的技術實現。

我們需要在微信裡能夠顯示FSM的資料，比如FSM裡的產品和客戶主資料：

![image](https://img-blog.csdnimg.cn/img_convert/cff1aec9d168a91727aec89ed666794a.png)
![](https://img-blog.csdnimg.cn/img_convert/ce1c3b44440b2746c49b1e917b24d006.png)

一種簡易的方式就是使用FSM提供的Query API.
開啟FSM官網的幫助文件：
https://docs.coresystems.net/dev-index.html

![](https://img-blog.csdnimg.cn/img_convert/7796bbcb8291380d46094b9207ca0be1.png)

進入Query API的相關部分：

![](https://img-blog.csdnimg.cn/img_convert/bdd9b36285a786efaef11998b76b26c5.png)

透過閱讀文件，得知FSM Query API採用一種和Facebook Query Language，SAP Hybris Flexible Search和ABAP Open SQL類似的思路，即仿SQL語法的查詢方式，從FSM系統裡讀取資料。

下圖是Facebook Query Language的一個例子：

![](https://img-blog.csdnimg.cn/img_convert/4aefa900691e2c0ecd18f5e6e1cd2f68.png)

下圖是SAP Hybris Commerce Flexible Search的例子：

![](https://img-blog.csdnimg.cn/img_convert/25f5f67ffc3939d78e61aea2298021df.png)

ABAP Open SQL的例子我就不貼了，大家太熟悉了。
那麼FSM的Query API如何使用呢？

登入FSM，點選Query API：

![](https://img-blog.csdnimg.cn/img_convert/8eeccdee263fb4895c6b54a68a725b3c.png)

在彈出來的控制檯裡，輸入類SQL語句：
SELECT bp FROM BusinessPartner bp
預設返回了前40條資料：

![](https://img-blog.csdnimg.cn/img_convert/a9eaa6ae1278b9368490b5084ad2446e.png)

那麼如何使用程式碼來觸發Query API查詢呢？官網上給出了一個基於nodejs的SDK，可以輕易實現用程式碼呼叫Query API的需求。

![](https://img-blog.csdnimg.cn/img_convert/fb1f54da8fafb335643c740447d997fe.png)

點選超連結後，會跳轉到github的一個倉庫：

![](https://img-blog.csdnimg.cn/img_convert/14cf23a546fee65499629ad2d7818d4b.png)

按照幫助文件上的示例程式碼，將自己FSM系統裡建立的API client對應的credential維護到程式碼裡，得到一個CoreAPIClient例項。

![](https://img-blog.csdnimg.cn/img_convert/d7cd299e846484a339d7cc9737bf009d.png)

ClientIdentifier和clientSecret等Credential欄位的值，可以透過Admin標籤頁，新建一個Client後獲得：

![](https://img-blog.csdnimg.cn/img_convert/79adcdf933aecb5a4a4187136f3b2f02.png)

使用CoreAPIClient例項的query方法向FSM系統發起Query API請求，輸入引數一為應用程式裡拼接的類SQL查詢語句，引數二為Data Transfer Object的名稱，在幫助文件裡能查到。

![](https://img-blog.csdnimg.cn/img_convert/b9f3f47d5276d8040b326c610bafc8f5.png)

透過Visual Studio Code偵錯程式觀察上面這個API呼叫返回的結果。因為我的752和753行程式碼分別指定了Item和BusinessPartner的查詢，因此API呼叫返回的響應是一個陣列，其內兩個元素分別包含了Item和BusinessPartner各前40條資料。

![](https://img-blog.csdnimg.cn/img_convert/e9023762a359ac5f6523467798075b81.png)

每個Item和Business Partner例項的明細在偵錯程式裡顯示如下：

![](https://img-blog.csdnimg.cn/img_convert/e9cf7288613a6ed137aa0378cc522a56.png)
![](https://img-blog.csdnimg.cn/img_convert/eedb008e9dd18f029432b3a5d5f4463a.png)

假設我們的場景是：希望在微信裡能夠瀏覽SAP FSM裡可用的服務技師，如下圖所示：

![image](https://img-blog.csdnimg.cn/img_convert/4fd3bdbdfedefc9cd1b53fc55c7657ab.png)

那麼首先要設計一個Web應用，在該Web應用裡透過第一篇文章介紹的方式，使用SAP FSM提供的nodejs SDK去呼叫API.

為此，我們開發了一個Vue應用，在Vue生命週期鉤子函式mounted裡，發起對SAP FSM employee(技師)資料的請求：

![](https://img-blog.csdnimg.cn/img_convert/5a91b69cd7fbd016beb8362107643681.png)
![](https://img-blog.csdnimg.cn/img_convert/adbf4429ada7e1a12e5d979df79abc05.png)

在我們微信裡指定的時間段內，SAP FSM有三個可用的技師，其名稱，使用者評分，頭銜，服務年限等資料透過FSM nodejs SDK返回給微信端，如上圖微信開發者偵錯程式裡所示。

比如employeeID為2E9BC784D477CA3DD048E593D853CFF1的這條資料，可以直接在FSM裡透過這個url檢視：

https://de.coresystems.net/master-data-management/#/people/details/2E9BC784D477CA3DD048E593D853CFF1

![](https://img-blog.csdnimg.cn/img_convert/1e4937af5375b3b1eae40f6bd522c5b7.png)
![](https://img-blog.csdnimg.cn/img_convert/4725dfa781ffa1d375af9c6ab34a5970.png)

這個Vue應用做好之後，部署到伺服器上，生成一個url，我們假設為https://www.xxx.com/smart
如何將這個url和微信公眾號繫結起來？

![](https://img-blog.csdnimg.cn/img_convert/a981c9cefec88afb90bdbed26fffebd7.png)

在微信公眾號的自定義選單裡，建立一個新的選單項“預約”，給它維護一個特定的url.
這樣在手機微信裡點選這個選單，就會跳轉到對應的url.

![](https://img-blog.csdnimg.cn/img_convert/3fd698dc3858edaa6b211ed8273a2a8a.png)

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在微信公眾號後臺的公眾號開發資訊裡獲取：

![](https://img-blog.csdnimg.cn/img_convert/666b0717356dc2e389802a66d3978bb8.png)

而redirect_url後面的值，為web應用https://www.xxx.com/smart進行url encode後的值。
這一切設定好之後，從微信公眾號選單跳轉到web應用的場景就能工作了。
如果想在本地模擬微信訪問的方式除錯部署到伺服器上的Web應用，只需要安裝微信開發者工具，將自己的個人微訊號繫結到微信公眾號的開發者微訊號列表中去：

![](https://img-blog.csdnimg.cn/img_convert/9068cc351c84df5d4db8529f1743c27c.png)

然後用個人的微訊號掃碼登入微信開發者工具，在位址列裡輸入上述包含oauth 2.0重定義的那一長串url，點選Allow按鈕：

![](https://img-blog.csdnimg.cn/img_convert/9133a53e9872a78c066bd71545111f8a.png)

就可以像使用Chrome開發者工具那樣，對前端應用程式碼進行單步除錯了：

![](https://img-blog.csdnimg.cn/img_convert/a30b027dd39f0181153cb6e460d8e803.png)

下面我們採用“上門安裝服務”這個場景來說明，假設客戶購買了某公司的某產品，希望透過微信來預約某個時段的上門安裝服務。

從微信公眾號裡點選“預約”按鈕之後，我們開發的前端應用會自動定位出當前使用者的地理位置：武侯花園人民政府，同樣我們也提供了允許客戶手動修改地址的功能，如下圖預約地址欄位尾部的字元2，就是Jerry為了測試手動修改的功能而故意新增上去的。

![](https://img-blog.csdnimg.cn/img_convert/75b56f2bddfb22df6811631cd2139593.png)

維護手機號和希望上門安裝的具體時間段，然後就可以從下拉選單裡選擇該時間段內可以提供服務的安裝技師。這裡我們選擇名叫李小剛的技師：

![](https://img-blog.csdnimg.cn/img_convert/92c72a1665141ece87dce13adb6238d0.png)

點選確定按鈕，執行在微信裡的前端應用就透過我們開發的後臺服務，向SAP FSM發起API呼叫。
先看最後的結果：我們在微信裡收到了公眾號推送的通知訊息，告訴我們預約已成功。

![](https://img-blog.csdnimg.cn/img_convert/a80b459af4feeee95686cc51530ca38f.png)

點選這條訊息可以檢視預約詳情：

![](https://img-blog.csdnimg.cn/img_convert/03b6f1d294b5474162254ab17af6e38e.png)

待李小剛動身前往客戶途中，我們還能在微信裡檢視李小剛的實時位置共享資訊，這是透過SAP FSM提供的技師位置服務加上我們的少許自開發實現的效果。

![](https://img-blog.csdnimg.cn/img_convert/e188e26dd910bf01d4de1d6fd13e3208.png)

我們在微信開發者工具裡重複上述步驟，觀察請求明細：

![](https://img-blog.csdnimg.cn/img_convert/b3e69e47f71df83f526f82e888e0ff2a.png)

這個url指向我們開發的一個後臺服務，/ticket/後面跟著的一串數字與字母組合是Jerry的個人微信open ID，13911111111是我預約時留下的手機號，手機號後面一長串包含%的片段，是預約時留下地址經過url encode後的結果。

![](https://img-blog.csdnimg.cn/img_convert/e68edf9964c08b6624895f0dbdfb10f5.png)

請求正文裡包含了微信裡填入的全部預約資訊，和李小剛在FSM裡的GUID. CustomerID，則是前端應用透過我的微信open ID呼叫微信API獲取到的暱稱，Jerry Wang. “上門安裝機械臂”，是我們為了demo方便，硬編碼的一個預約標題。

![](https://img-blog.csdnimg.cn/img_convert/1f6fb6b246483d31bdf11191a4e8c355.png)

API呼叫成功後，返回一個ID給消費端，這個ID代表了SAP FSM裡成功建立的預約記錄。

![](https://img-blog.csdnimg.cn/img_convert/71f6d9c3f9f75c51f5b3c7f2e8d3ae5c.png)

下面我們到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，記錄下來後面會用到。

![](https://img-blog.csdnimg.cn/img_convert/dd69e601a90be0fe348000d2f1ae1d6d.png)

而我們在微信預約頁面選擇的技師李小剛，在微信開發者工具裡觀察到其GUID為2E9BC784D477CA3DD048E593D853CFF1，這也正是李小剛在SAP FSM裡的明細頁面列表url的片段之一：

![](https://img-blog.csdnimg.cn/img_convert/3aa275f501e43c7eaa24840dc86eb232.png)

而SAP FSM API返回的ID：B0555705B9EC41009739D0111E16CC91，在系統裡實際上是一條Service Call記錄的GUID，這條Call的ID為175，服務的客戶ID是Jerry Wang，Code為36，即前面提到的基於微訊號open ID自動建立的客戶記錄。

這個Service Call有一個同名的Activity，編號為205.

![](https://img-blog.csdnimg.cn/img_convert/f90e47b58b7d7bd628794e9b8a3e68f6.png)

在SAP FSM的Activities頁面可以查到這條編號為205的記錄，其所屬的Service Call為175，即上圖顯示的Call內容。

![](https://img-blog.csdnimg.cn/img_convert/697ecd568dc72fc46c1581d0b422d2e6.png)

Service Call和Activities建立之後，排程員就可以相應地派工，然後李小剛就可以動身出發了。下圖顯示的李小剛在系統中被分配了多個安裝任務，這是Jerry反覆測試時建立的資料，其中任務顯示上標有的白色小旗，代表任務已完成。

![](https://img-blog.csdnimg.cn/img_convert/76ad55b898f36bd1519501e4774442ec.png)

排程員選擇一條我剛剛在微信裡建立的預約，點選Release Assignments, 即可完成派工。

![](https://img-blog.csdnimg.cn/img_convert/8834a215ee7ec145c0a4b015c85d4ded.png)

在我們的後臺服務實現裡，使用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 將其透過微信整合實現的智慧服務場景案例。</appid>

SAP Field Service Management 和微信整合的案例分享和實現介紹

相關文章