MethodCall (BizTalk Server 範例)

MethodCall 範例示範如何從 BizTalk Server 呼叫 .NET 方法。

此範例的用途

此範例使用下列步驟順序和 .NET 方法進行互動：

此範例示範下列功能：

在協調程式中利用升級的屬性。 InputSchema.xsd 中的三個項目會升級為辨別欄位。當協調流程收到輸入訊息時，它會取得這三個欄位的值，並將它們指派至協調流程中宣告的對應變數。
使用決定圖形在協調流程中表達「if-then-else」邏輯。協調流程將辨別欄位的值指派給內部變數之後，它會輸入決定圖形來檢查是否應該執行加法或減法。如果沒有需要執行的作業，協調流程就會終止。
從協調流程呼叫外部組件。如果要執行加法，協調流程會呼叫外部 C# 組件，並傳入兩個參數來執行加法。相同的程序也適用於減法。

注意

您必須先將組件安裝至全域組件快取後，才能從協調流程呼叫此組件；否則，您將在執行階段收到 XLANG 錯誤。
使用 訊息指派 圖形來建構輸出訊息。

將下列程式碼放到「運算式」圖形中，來偵錯協調流程：

System.Diagnostics.Debug.WriteLine(iResult);

您也可以使用下列程式碼將結果寫入事件記錄：

System.Diagnostics.EventLog.WriteEntry("MethodCall SDK Sample Debug", System.String.Format("Result = {0}", iResult);

< 範例路徑>\Orchestrations\MethodCall\

下表顯示此範例中的檔案，並描述其用途。

檔案	Description
Cleanup.bat	用來解除部署組件，以及將它從全域組件快取中移除。移除傳送埠和接收埠。視需要移除 Microsoft Internet Information Services (IIS) 虛擬目錄。
Input.xml	範例輸入檔案。
Setup.bat	用來建置和初始化此範例。
在 \MathLibrary 資料夾中： AssemblyInfo.cs, MathHelper.cs, MathLibrary.csproj	此範例所使用之數學程式庫的專案和來源檔案。
在 \MethodCallSample 資料夾中： InputSchema.xsd, OutputSchema.xsd	分別為輸入和輸出 .xml 檔案的結構描述。
在 \MethodCallSample 資料夾中： MethodCallSample.btproj, MethodCallSample.sln	這個範例的專案及解決方案檔案。
在 \MethodCallSample 資料夾中： MethodCallSampleBinding.xml	用於自動化設定，例如連接埠繫結。
在 \MethodCallSample 資料夾中： MethodCallService.odx	呼叫數學程式庫執行要求之計算的 BizTalk Server 協調流程。

在命令視窗中，瀏覽至下列資料夾：

< 範例路徑>\Orchestrations\MethodCall
執行檔案 Setup.bat，這會執行下列動作：
- 在 MethodCall 中建立此範例的輸入 (In) 和輸出 (Out) 資料夾。
- 編譯此範例的 Visual Studio 專案，並部署產生的組件。
- 建立 BizTalk Server 接收位置以及傳送埠和接收埠，並將其繫結至協調流程。
- 啟用接收位置並啟動傳送埠。登錄和啟動協調流程。

注意

在嘗試執行此範例之前，您應該確認 BizTalk Server 沒有在建置和初始化程序期間報告任何錯誤。

將檔案 Input.xml 的複本貼到 In 資料夾。
觀察在 Out 資料夾中建立的 .xml 檔案。此檔案包含要求的加法或減法計算的結果。此檔案名的格式為 <MessageID>.xml，其中< MessageID >是產生以唯一識別訊息的 GUID。
您可修改輸入檔案，要求不同的加法或減法計算。

在 Visual Studio 命令提示字元中，將目錄 (cd) 變更為 <Samples Path> \Orchestrations\MethodCall\。
執行 Cleanup.bat。