使用 BizTalk Server 叫用 SAP 中的 RFC
SAP 配接器會將 SAP 系統公開的 RFC 呈現為配接器用戶端可叫用的作業。 本節提供使用 SAP 配接器搭配 Microsoft BizTalk Server 叫用 SAP 系統中 RFC 的指示。 如需 SAP 配接器如何在 SAP 系統中叫用 RFC 的詳細資訊,請參閱 SAP 中 RFC 的作業。 如需叫用 RFC 之 SOAP 訊息結構的詳細資訊,請參閱 RFC 作業的訊息架構。
如何在 SAP 系統中叫用 RFC?
使用 SAP 配接器搭配BizTalk Server在 SAP 系統上執行作業,牽涉到建立 SAP 應用程式的建置組塊中所述的程式性工作。 若要在 SAP 系統中叫用 RFC,這些工作如下:
建立 BizTalk 專案,並為您想要在 SAP 系統中叫用的 RFC 產生架構。
在 BizTalk 專案中建立訊息,以便從 SAP 系統傳送和接收訊息。
建立協調流程以叫用 SAP 系統中的 RFC。
建置和部署 BizTalk 專案。
藉由建立實體傳送和接收埠來設定 BizTalk 應用程式。
啟動 BizTalk 應用程式。
本主題提供執行這些工作的指示。
產生架構
在本主題中,為了示範如何在 SAP 系統中叫用 RFC,我們會產生 RFC_CUSTOMER_GET的架構。 如需如何產生架構的詳細資訊 ,請參閱流覽、搜尋和取得 SAP 中 RFC 作業的中繼資料 。
定義訊息和訊息類型
您稍早產生的架構描述協調流程中訊息所需的「類型」。 訊息通常是變數,其類型是由對應的架構所定義。 您必須從 BizTalk 專案的協調流程檢視將產生的架構連結至訊息。
針對本主題,您必須建立兩個訊息,一個是將要求傳送至 SAP 系統,另一個則用來接收回應。
執行下列步驟來建立訊息,並將其連結至架構。
建立訊息並連結至架構
如果尚未開啟,請開啟協調流程檢視 BizTalk 專案。 按一下 [檢視],指向 [其他視窗],然後按一下 [ 協調流程檢視]。
在協調 流程檢視中,以滑鼠右鍵按一下 [ 訊息],然後按一下 [ 新增訊息]。
以滑鼠右鍵按一下新建立的訊息,然後選取 [ 屬性視窗]。
在Message_1的 [屬性] 窗格中,執行下列動作。
使用 作法 識別碼 輸入 要求。 訊息類型 從下拉式清單中,展開 [ 架構],然後選取 [InvokeRFC.SAPBindingSchema.RFC_CUSTOMER_GET],其中 InvokeRFC 是您 BizTalk 專案的名稱。 SAPBindingSchema 是針對 RFC_CUSTOMER_GET產生的架構。 重複上一個步驟以建立新的訊息。 在新訊息的 [ 屬性 ] 窗格中,執行下列動作。
使用 作法 識別碼 輸入 回應。 訊息類型 從下拉式清單中,展開 [ 架構],然後選取 [InvokeRFC.SAPBindingSchema.RFC_CUSTOMER_GETResponse]。
設定協調流程
您必須建立 BizTalk 協調流程,才能使用BizTalk Server來叫用 SAP 系統中的 RFC。 在此協調流程中,您會在定義的接收位置卸載要求訊息。 SAP 配接器會取用訊息,並將其傳遞至 SAP 系統。 SAP 系統的回應會儲存至另一個位置。 在 SAP 系統中叫用 RFC 的一般協調流程會包含:
傳送和接收圖形以將訊息傳送至 SAP 系統並接收回應。
單向接收埠,用來接收傳送至 SAP 系統的要求訊息。
雙向傳送埠,將要求訊息傳送至 SAP 系統並接收回應。
單向傳送埠,將回應從 SAP 系統傳送至資料夾。
範例協調流程如下所示:
新增訊息圖形
請確定您為每個訊息圖形指定下列屬性。 Shape資料行中所列的名稱是上述協調流程中顯示的訊息圖形名稱。
圖形 | 圖形類型 | 屬性 |
---|---|---|
Receive_Request | 接收 | - 將 [名稱 ] 設定為 [Receive_Request - 將 Activate 設定為 True |
Send_LOB | 傳送 | - 將 [名稱 ] 設定為 [Send_LOB |
Receive_LOB | 接收 | - 將 [名稱] 設定為 [Receive_LOB - 將 Activate 設定為 False |
Send_Response | 傳送 | - 將 [名稱 ] 設定為 [Send_Response |
新增埠
為每個邏輯埠指定下列屬性。 [ 埠] 資料行中所列的名稱是協調流程中顯示的埠名稱。
連接埠 | 屬性 |
---|---|
ReceiveMsgPort | - 將 識別碼 設定為 ReceiveMsgPort - 將 [類型] 設定為 ReceiveMsgPortType - 將 通訊模式 設定為 單向 - 將 通訊方向 設定為 接收 |
SendToLOBPort | - 將 識別碼 設定為 SendToLOBPort - 將 類型 設定為 SendToLOBPortType - 將 通訊模式 設定為 Request-Response - 將 通訊方向 設定為 Send-Receive |
SendMsgPort | - 將 識別碼 設定為 SendMsgPort - 將 [類型] 設定為 SendMsgPortType - 將 通訊模式 設定為 單向 - 設定要傳送的通訊方向 |
指定動作圖形的訊息並連接到埠
下表指定要設定的屬性及其值,以指定動作圖形的訊息,並將其連結至埠。 Shape資料行中所列的名稱是上述協調流程中顯示的訊息圖形名稱。
圖形 | 屬性 |
---|---|
Receive_Request | - 將 訊息 設定為 要求 - 將 作業 設定為 ReceiveMsgPort.Operation_1.Request |
Send_LOB | - 將 訊息 設定為 要求 - 將 作業 設定為 SendToLOBPort.Operation_1.Request |
Receive_LOB | - 將 訊息 設定為 回應 - 將 作業 設定為 SendToLOBPort.Operation_1.Response |
Send_Response | - 將 訊息 設定為 回應 - 將 作業 設定為 SendMsgPort.Operation_1.Request |
指定這些屬性之後,訊息圖形和埠會連線,而且您的協調流程已完成。
您現在必須建置 BizTalk 解決方案,並將其部署至BizTalk Server。 如需詳細資訊,請參閱 建置和執行協調流程。
設定 BizTalk 應用程式
部署 BizTalk 專案之後,您稍早建立的協調流程會列在 BizTalk Server 管理主控台的 [協調流程] 窗格底下。 您必須使用 BizTalk Server 管理主控台來設定應用程式。 如需設定應用程式的詳細資訊,請參閱 如何設定應用程式。
設定應用程式牽涉到:
選取應用程式的主機。
將您在協調流程中建立的埠對應至 BizTalk Server 管理主控台中的實體埠。 針對此協調流程,您必須:
定義硬碟上的位置,以及您將卸載要求訊息的對應檔案埠。 BizTalk 協調流程會取用要求訊息,並將其傳送至 SAP 系統。
定義硬碟上的位置和對應的檔案埠,BizTalk 協調流程將會卸載包含 SAP 系統回應的回應訊息。
定義實體 WCF-Custom 或 WCF-SAP 傳送埠,以將訊息傳送至 SAP 系統。 您也必須在傳送埠中指定動作。 如需如何建立埠的資訊,請參閱 手動設定實體埠系結至 SAP 配接器。
注意
使用取用配接器服務 BizTalk 專案增益集產生架構也會建立系結檔案,其中包含要針對這些埠設定的埠和動作的相關資訊。 您可以從 BizTalk Server 管理主控台匯入此系結檔案,以建立輸出通話的傳送埠 () ,或針對輸入呼叫) 接收埠 (。 如需詳細資訊,請參閱 使用埠系結檔案設定實體埠系結至 SAP。
啟動應用程式
您必須啟動 BizTalk 應用程式,才能叫用 SAP 系統中的 RFC。 如需啟動 BizTalk 應用程式的指示,請參閱 如何啟動協調流程 或 如何啟動應用程式。
在這個階段,請確定:
要接收協調流程要求訊息的 FILE 接收埠正在執行。
從協調流程接收回應訊息的 FILE 傳送埠正在執行。
WCF-Custom 或 WCF-SAP 傳送埠,以將訊息傳送至 SAP 系統正在執行。
作業的 BizTalk 協調流程正在執行。
執行作業
執行應用程式之後,您必須在預先定義的位置卸載協調流程的要求訊息。 請參閱 RFC 作業的訊息架構 ,以瞭解在 SAP 系統中叫用 RFC 的要求訊息架構。 例如,要叫用RFC_CUSTOMER_GET的要求訊息為:
<RFC_CUSTOMER_GET xmlns="http://Microsoft.LobServices.Sap/2007/03/Rfc/">
<KUNNR>0000001390</KUNNR>
<NAME1>*</NAME1>
<CUSTOMER_T/>
</RFC_CUSTOMER_GET>
協調流程會取用訊息,並將其傳送至 SAP 系統。 SAP 系統的回應會儲存在定義為協調流程一部分的其他檔案位置。 例如,上述要求訊息的 SAP 系統回應為:
<?xml version="1.0" encoding="utf-8" ?>
<RFC_CUSTOMER_GETResponse xmlns="http://Microsoft.LobServices.Sap/2007/03/Rfc/">
<CUSTOMER_T>
<RFCCUST xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/">
<KUNNR>0000001390</KUNNR>
<ANRED>Firma</ANRED>
<NAME1>Contoso, Ltd.</NAME1>
<PFACH />
<STRAS>4567 Main Street</STRAS>
<PSTLZ>98052</PSTLZ>
<ORT01>USA</ORT01>
<TELF1>555-0101</TELF1>
<TELFX>555-0102</TELFX>
</RFCCUST>
</CUSTOMER_T>
</RFC_CUSTOMER_GETResponse>
可能的例外狀況
如需使用 BizTalk Server 叫用 SAP 系統中 RFC 時可能會遇到的例外狀況相關資訊,請參閱使用 SAP 配接器處理例外狀況和錯誤處理。
最佳做法
部署並設定 BizTalk 專案之後,您可以將組態設定匯出至稱為系結檔案的 XML 檔案。 產生系結檔案之後,您可以從檔案匯入組態設定,如此就不需要為相同的協調流程建立傳送埠、接收埠等。 如需系結檔案的詳細資訊,請參閱 重複使用 SAP 配接器系結。