步驟 2:設定 Wcf-Custom 單向接收埠
完成時間: 10 分鐘
目的: 在此步驟中,您會設定 WCF-Custom 埠,以從 SAP 系統接收一般檔案 IDOC。 設定埠之後,您會將 BizTalk 應用程式設定為使用 WCF-Custom 接收埠。
必要條件
您必須已建置並部署 vPrev BizTalk 專案,才能從 SAP 系統接收IDOC。
設定單向接收埠 WCF-Custom
啟動 BizTalk Server 管理主控台。
在主控台樹中,展開 [BizTalk 群組],然後展開 [ 應用程式]。
展開您要在其中建立接收埠的應用程式。
以滑鼠右鍵按一下 [接收埠],指向 [ 新增],然後按一下 [單向接收埠]。
在 [ 接收埠屬性] 對話方塊的 [ 一般 ] 索引標籤上,輸入接收埠的名稱。
在 [ 接收位置] 索引標籤上,按一下 [ 新增]。 [ 接收位置屬性] 對話方塊隨即出現。
在 [ 接收位置屬性 ] 對話方塊中,執行下列動作:
指定接收位置的名稱。
從 [ 類型 ] 下拉式清單中,選取 [WCF-Custom],然後按一下 [ 設定]。
在 [WCF-自訂傳輸屬性] 對話方塊中,執行下列動作:
按一下 [ 一般 ] 索引標籤,然後在 [ 位址 (URI) ] 欄位中,指定要從 SAP 系統接收訊息的連線 URI。 從 SAP 系統接收訊息的連線 URI 必須具有下列格式:
sap://Client=800;lang=EN@A/YourSAPHOST/00?ListenerGwHost=YourSAPHOST&ListenerGwServ=SAPGW00&ListenerProgramId=MyProgramId
下圖顯示具有指定 URI 的埠屬性對話方塊:
接收訊息的連接 URI
如需連線 URI 的詳細資訊,請參閱 建立 SAP 系統的連線。
按一下 [ 系結] 索引標籤,然後從 [系 結類型 ] 下拉式清單中,選取 [sapBinding]。 請確定您為接收埠指定下列系結屬性。
Binding 屬性 將值設定為 flatFileSegmentIndicator SegmentType。 這表示一般檔案應該包含 IDOC 中每個區段的區段類型。 padReceivedIdocWithSpaces True。 指定 IDOC 中的每個行是否以空格填補到正確的長度。 receiveIDocFormat 字串。 這會指定 IDOC 訊息應該以單一字串欄位表示。 For more information about binding properties, see Read about BizTalk Adapter for mySAP Business Suite Binding Properties.
按一下 [ 其他] 索引標籤,並指定要連線到 SAP 系統的認證。
按一下 [ 訊息] 索引標籤,然後在 [ 輸入 BizTalk 訊息本文 ] 區段中,選擇 [ 路徑 ] 選項。
在 [ 本文路徑運算式 ] 文字方塊中,指定要從 XML 訊息擷取一般檔案 IDOC 的 XPath 查詢。 如此一來,接收埠會從 IDOC 擷取資料,並修剪屬於 WCF 型 SAP 配接器 ReceiveIdoc 作業的 XML 標籤。 如需 ReceiveIdoc 作業之訊息架構的詳細資訊,請參閱 IDOC 作業的訊息架構。
的 XPath 查詢
您必須指定下列 XPath 查詢:
/*[local-name()='ReceiveIdoc']/*[local-name()='idocData']
從 [ 節點編碼 ] 下拉式清單中,選取 [ 字串]。
按一下 [套用],然後按一下 [確定]。
在 [接收位置屬性] 對話方塊中,從 [ 接收處理常式 ] 下拉式清單中,選取 [BizTalkServerApplication]。
從 [ 接收管線 ] 下拉式清單中,選取 [ConvertToXML]。 這個一般檔案反組譯程式管線已經是 vPrev BizTalk 專案的一部分,可將一般檔案 IDOC 轉換成 XML IDOC。
按一下 [確定]。
設定 BizTalk 應用程式
在 BizTalk Server 管理主控台中,依序展開[BizTalk 群組]、[應用程式],以及部署協調流程的 BizTalk 應用程式。
以滑鼠右鍵按一下 BizTalk 應用程式,然後選取 [ 設定]。
從左窗格中,按一下要設定的協調流程。 從右窗格的 [ 主機 ] 下拉式清單中,選取 BizTalk 主機實例。
在 [系結]方塊下,將 BizTalk 協調流程的邏輯埠對應至 BizTalk Server 管理主控台中的實體埠。
選取本主題稍早建立的 WCF-Custom 接收埠。
選取您將會收到一般檔案 IDOC 的檔案埠。
按一下 [確定]。
如需在 BizTalk Server 中設定應用程式的詳細資訊,請參閱如何設定應用程式。
後續步驟
您現在已完成將 vPrev BizTalk 專案移轉至使用 WCF 型 SAP 配接器從 SAP 系統接收IDOC 的 BizTalk 專案。 您現在必須藉由接收一般檔案 IDOC 來測試已移轉的 BizTalk 應用程式,如 步驟 3:測試已移轉的應用程式中所述。