最近Jerry由於專案需要,又得學習一個新工具:SAP Cloud Platform Integration,簡稱CPI,以前又叫做HCI - HANA Cloud Platform Integration Service.
儘管距離Jerry開始接觸CPI還不到48小時,我仍然想把我剛使用這個工具的第一手體會分享給曾經用過SAP CRM中介軟體,但尚未有機會接觸到CPI的朋友們。
之所以文章標題裡把SAP CRM中介軟體和SAP CPI關聯在一起,是因為二者同廣義上說,扮演的都是系統整合裡中介軟體的角色。
SAP ERP和CRM透過qRFC進行業務資料同步,而中介軟體能夠提供佇列機制,錯誤處理,重試,傳輸監控等功能。關於Jerry在SAP CRM中介軟體上的工作經驗分享,請參考我的文章 Jerry的CRM Middleware(中介軟體)文章合集。
而SAP CPI顧名思義,則是雲時代下SAP推薦的SAP產品同第三方雲產品進行整合的雲端中介軟體解決方案。Jerry的S4CRM同事童丹之前文章 S/4HANA Service Management和SAP Field Service Management的整合 裡提到的場景就是SAP CPI的一個典型整合應用。
作為學習筆記,Jerry這裡把我學習SAP CPI時做的一個Hello World級別的練習步驟記錄下來。
這個練習的場景是,假設有一個部署在第三方雲平臺上的OData服務,提供了產品主資料查詢的功能。我們需要在SAP系統裡消費這個OData服務。SAP開發人員不希望直接去消費第三方雲平臺上的OData服務,而是期望SAP CPI能暴露一個更加容易訪問的API endpoint出來,例如透過postman傳一個Product ID給CPI,CPI拿到這個ID後,由CPI向第三方雲平臺發起OData請求,拿到請求響應後,CPI把結果返回給位於SAP產品的消費端。
用於這個場景的OData服務地址:https://espmrefapps.hana.onde...$metadata
SAP CPI是一個SaaS應用,在SAP雲平臺控制檯的Subscriptions皮膚裡訂閱和訪問。點選Go to Applications進入主操作頁面。
我們為了實現這個整合場景需要在CPI裡開發一個整合流 - integration flow(下文簡寫為iFlow), 用於定義當其收到消費者傳入的product ID後,應該進行何種處理。
和ABAP裡的程式需要儲存在一個開發包裡一樣,iFlow也需要儲存在一個包裡,稱為Content package.
進入CPI後在此處建立一個Content package:
然後點選上圖的Artifacts進入iFlow建立介面:
取名Jerry first integration flow, 再點選就能進入iFlow的圖形化編輯介面了。
一個新的iFlow建立之後的預設介面如下:
點選上圖最左邊的Sender圖示,將其拖拽到上圖中間integration process矩形框內的Start圖示內,這個動作會幫助我們建立一個inbound adapter,型別我們選擇HTTPS,意思是這個iFlow期望其被消費的方式是HTTPS.
在Adapter的Address裡維護一個url片段/CloudIntegrationTrials, 等到最後該iFlow正式部署後,生成的endpoint就是以該片段結尾,屆時我們可以在postman等工具裡使用該endpoint消費這個iFlow.
考慮到現在流行的Restful API實現都期望其消費者以JSON格式傳輸請求內容,我們也沿用這個最佳實踐,因此首先拖拽一個JSON to XML Converter到iFlow integration process建模區域的矩形框裡,將JSON
格式的使用者輸入轉換成XML格式:
然後再使用Content Modifier,將XML格式裡的product ID的值提取出來。
下圖展示了Content Modifier透過XPath將XML格式的輸入裡的productIdentifier這個欄位的值提取出來。
有了product ID,可以進行OData呼叫了。從iFlow建模的工具箱裡拖拽一個External Call出來:
型別選擇成OData V2:
指定前面提過的OData服務的url:
選擇該OData服務的Products節點作為消費的物件:
將OData Product節點的ProductId欄位繫結到前一步驟透過Content Modifier解析出來的包含了使用者輸入的productIdentifier欄位。
就像小朋友們搭積木一樣,我們把iFlow工具箱裡提供的元素,透過拖拽的方式組合成了一個圖形化的流程。點選Deploy進行部署:
部署成功之後,抄下這個生成的endpoint:
在Postman裡向這個endpoint傳送一個GET請求:
部署在SAP Cloud Platform上的CPI iFlow接收到了請求後,就會按照我們維護好的邏輯,解析出Product ID,呼叫OData服務,將該ID對應的Product明細資料作為結果返回給消費端。
和SAP CRM中介軟體有各種透過事務碼比如SMW01訪問的監控應用一樣,SAP CPI也有類似的監控程式:
希望這個最簡單的例子能讓還沒有接觸過SAP CPI的朋友對其作用有個最直觀的瞭解,感謝閱讀。
要獲取更多Jerry的原創文章,請關注公眾號"汪子熙":