SAP FSM 學習筆記(一) : 使用API消費FSM的數據

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

關於其綜述，能夠參考Jerry同事許聚龍2018年的文章：SAP成都研究院許聚龍：Hello, Coresystems！

由於項目須要，Jerry得學習使用FSM。今天剛拿到系統帳號，下午學習了三個小時，用組內同事Li Cris編寫的代碼在系統裏作了一些測試，把學習筆記寫下來。

本文沒有介紹任何高深的東西，純粹是記錄我我的的學習筆記，方便未來查閱。

以前Jerry推送的視頻 SAP FSM和微信集成的智能服務場景 介紹的原型開發裏，須要在微信裏可以顯示FSM的數據，好比FSM裏的產品和客戶主數據：

一種簡易的方式就是使用FSM提供的Query API.

打開FSM官網的幫助文檔：
https://docs.coresystems.net/...

進入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實例的明細在調試器裏顯示以下：

後續Jerry會繼續學習FSM並把所學分享給你們，感謝閱讀。

要獲取更多Jerry的原創文章，請關注公衆號"汪子熙":