共用方式為


產生 SAP 解決方案成品的 WCF 用戶端或 WCF 服務合約

您可以使用新增配接器服務參考 Visual Studio 外掛程式來產生 WCF 用戶端類別或 WCF 服務合約 (介面) 以 SAP 成品上所選作業為目標。 您也可以使用 ServiceModel 中繼資料公用程式工具 (svcutil.exe) 來產生 WCF 用戶端類別或 WCF 服務合約;不過,新增配接器服務參考外掛程式會透過標準 Microsoft Windows 介面公開 ServiceModel 中繼資料公用程式工具的功能。 它也提供 svcutil.exe 工具無法使用的流覽和搜尋功能,並根據連線至 SAP 系統時選取的系結屬性產生組態檔。

使用新增配接器服務參考外掛程式產生用戶端類別

執行下列步驟,以使用新增配接器服務參考外掛程式來產生 WCF 用戶端類別。

產生 WCF 用戶端類別

  1. 在 Visual Studio 方案總管中,以滑鼠右鍵按一下您的專案,然後按一下 [新增配接器服務參考]。

  2. 開啟 [ 新增配接器服務參考 ] 對話方塊之後,請遵循 在 Visual Studio 中取得 SAP 作業的中繼資料 中的步驟,連線到 SAP 系統並流覽和搜尋作業。 若要為您所選取的作業建立 WCF 用戶端類別,請確定已從 [選取合約類型] 下拉式清單中選取 [用戶端 (輸出) 作業], (這是預設) 。

  3. 選取您想要鎖定的所有作業之後,按一下 [ 確定 ] 以產生 WCF 用戶端類別。

    [新增配接器服務參考外掛程式] 會將兩個檔案新增至您的專案:

  • SAPBindingClient.cs。 此檔案包含您所選取之作業的產生的 WCF 用戶端類別和協助程式程式碼。

  • App.config。此檔案包含系結組態和用戶端端點組態。 這些設定是根據您在設定 [新增配接器服務參考外掛程式] 的系結和連線時所做的選擇。

    重要

    使用 [新增配接器服務參考外掛程式] 時,如果您未為字串類型的系結屬性指定值,且其預設值為 null,則該系結屬性將無法在 app.config 檔案中使用。 如有必要,您必須在 app.config 檔案中手動新增系結屬性及其值。

使用新增配接器服務參考外掛程式產生 WCF 服務合約

當您使用 SAP 配接器從 SAP 系統接收IDOC、RFC 和 TRFC 時,您的程式碼會作為介面卡的服務。 也就是說,配接器會從 SAP 系統接收適當的成品,然後在程式碼上叫用 (輸入) 作業,以將成品傳遞至您的應用程式。

因此,您必須實作可從配接器接收此輸入作業的 WCF 服務。 若要這樣做,您可以使用 [新增配接器服務參考外掛程式] 來產生 .NET 介面,代表配接器針對作業呈現的服務合約。 這個 .NET 介面也稱為 WCF 服務合約。 [新增配接器服務參考外掛程式] 也會產生類別,其中包含 WCF 服務的 Stubbed 實作。 接著,您可以實作此介面來建立可用來接收作業的 WCF 服務。

執行下列步驟,以使用新增配接器服務參考外掛程式來產生 WCF 服務合約。

產生 WCF 服務合約

  1. 在 Visual Studio 方案總管中,以滑鼠右鍵按一下您的專案,然後按一下 [新增配接器服務參考]。

  2. 開啟 [ 新增配接器服務參考 ] 對話方塊之後,請遵循 在 Visual Studio 中取得 SAP 作業的中繼資料 中的步驟,連線到 SAP 系統並流覽和搜尋作業。 若要為您所選取的作業建立 WCF 服務合約,請確定已從 [選取合約類型] 下拉式清單中選取 [服務 (輸入作業)

  3. 選取您想要鎖定的所有作業之後,按一下 [ 確定 ] 以產生 WCF 服務合約。

    [新增配接器服務參考外掛程式] 會將三個檔案新增至您的專案:

  • SAPBindingInterface.cs。 此檔案包含所產生 WCF 服務合約 (介面) 和您所選取作業的協助程式碼。

  • SAPBindingService.cs。 此檔案包含 Stubbed WCF 服務類別,可實作 SAPBindingInterface.cs 中定義的介面。 您可以實作商務邏輯,直接在此類別的方法中處理 RFC、tRFC 或 IDOC。

  • App.config。此檔案包含系結組態、端點行為和服務端點組態,以您在設定 [新增配接器服務參考外掛程式] 的系結和連線時所做的選項為基礎。

    重要

    使用 [新增配接器服務參考外掛程式] 時,如果您未為字串類型的系結屬性指定值,且其預設值為 null,則該系結屬性將無法在 app.config 檔案中使用。 如有必要,您必須在 app.config 檔案中手動新增系結屬性及其值。

注意

當您設定 [新增配接器服務參考外掛程式] 的連線 URI 以產生 WCF 服務合約時,不需要指定 RFC 伺服器參數。 SAP 配接器會透過用戶端連線從 SAP 系統擷取中繼資料。

使用 svcutil.exe 產生 WCF 用戶端類別或 WCF 服務合約

您可以使用 svcutil.exe 為您的應用程式產生 WCF 用戶端類別或 WCF 服務合約。 您必須將 svcutil.exe 設定為將它與 SAP 配接器搭配使用。 如需設定及搭配 SAP 配接器使用 svcutil.exe 的詳細資訊,請參閱 搭配 BizTalk Adapter for mySAP Business Suite 使用 ServiceModel 中繼資料公用程式工具

Svcutil.exe 會在輸出檔中產生 WCF 用戶端類別或 WCF 服務合約。 預設檔案名為 output.cs。 您必須在 Visual Studio 專案中手動包含此檔案。

另請參閱

使用 WCF 通道模型開發 SAP 應用程式