逐步解說：建立使用 MQSeries 配接器的 BizTalk 應用程式

發行項
10/14/2023

本節將引導您建立使用 MQSeries 配接器的簡單 Microsoft BizTalk Server 應用程式。

注意

此應用程式假設您已經在與 BizTalk Server 相同的電腦上安裝 IBM WebSphere MQ (適用於 Windows 平台的伺服器元件)。它也假設您尚未建立任何傳送埠或接收位置。若您有現有的傳送埠或接收位置，當逐步進行這些步驟時請以適當的名稱來替代。

此應用程式是一個簡單以內容為基礎的路由應用程式，只使用一個接收位置和傳送埠。接收位置會從 IBM WebSphere MQ 佇列讀取。傳送埠會從接收位置取得訊息，並將它傳送到不同的 IBM WebSphere MQ 佇列。

若要建立此應用程式，您必須建立 IBM WebSphere MQ 佇列、設定 BizTalk Server 接收位置與傳送埠、啟動傳送埠和啟用接收位置，並將測試訊息放在佇列中。

若您擁有 IBM WebSphere MQ 安裝所需的權限，您可以透過配接器對話方塊建立 IBM WebSphere MQ 佇列，並可略過下一個程序。若您沒有這類存取權限，您可以使用 IBM WebSphere MQ (適用於 Windows 平台總管的用戶端元件) 來建立佇列。若要透過 IBM WebSphere MQ Explorer 嵌入式管理單元來建立佇列，請執行下列程序。

透過 IBM WebSphere MQ Explorer 建立 IBM WebSphere MQ 佇列

請依照以下步驟執行，透過 IBM WebSphere MQ Explorer 建立 IBM WebSphere MQ 佇列：

按一下 [開始]，指向 [ 程式]，指向 [IBM WebSphere MQ]，然後按一下 [ WebSphere MQ 總管]。
按兩下 [ 佇列管理員]，然後按兩下預設佇列管理員。預設佇列管理員通常會命名為QM_< machine_name >其中machine_name是您電腦的名稱。
以滑鼠右鍵按一下 [ 佇列]，指向 [ 新增]，然後按一下 [ 本機佇列]。
在 [建立本機佇列 ] 對話方塊的 [ 佇列名稱] 中，輸入 BTStoMQS，然後按一下 [ 確定]。
以滑鼠右鍵按一下 [ 佇列]，指向 [ 新增]，然後按一下 [ 本機佇列]。
在 [建立本機佇列 ] 對話方塊的 [ 佇列名稱] 中，輸入 MQStoBTS，然後按一下 [ 確定]。

接下來的步驟會建立接收位置和傳送埠，並啟動傳送埠及啟用接收位置。並且也會建立 IBM WebSphere MQ 佇列。

建立接收位置與 MQSeries 佇列

請依照以下步驟執行，建立接收位置與 MQSeries 佇列：

在 BizTalk Server 管理主控台中，依預設展開[BizTalk Server系統管理]、[BizTalk 群組]、[應用程式]，然後依預設展開預設應用程式 (BizTalk 應用程式 1) 。
以滑鼠右鍵按一下 [ 接收埠] 節點，按一下 [ 新增]，然後選取 [單向埠]。
在 [ 接收埠屬性 ] 對話方塊的 [ 名稱 ] 方塊中，輸入 MQStoBTS。
在左窗格中，按一下 [ 接收位置]，然後在右窗格中，按一下 [ 新增]。
在 [ 接收位置屬性 ] 對話方塊的 [ 名稱 ] 方塊中，輸入 MQStoBTS。
從 [類型] 選項旁邊的下拉式清單中選取[MQSeries]。
在 [ 傳輸] 區段中，按一下 [ 設定]。
在 [ MQSeries 傳輸屬性 ] 對話方塊的 [ 輪詢間隔 ] 方塊中，輸入 1。
在 [ 佇列定義 ] 方塊中，按一下省略號 (...) 按鈕。
在 [ 佇列定義 ] 對話方塊的 [ 伺服器名稱 ] 方塊中，輸入您的電腦名稱稱。
在 [ 佇列管理員] 方塊中，選取預設佇列管理員。
在 [ 佇列] 方塊中，輸入 MQStoBTS，然後按一下 [ 匯出]。
在 [ 匯出 ] 對話方塊中，按一下 [ 建立佇列]，然後按一下 [ 確定 ] 和 [ 確定 ] 再次返回 [ 接收位置屬性 ] 對話方塊。
在 [ 接收處理常式] 方塊中，選取 [BizTalkServerApplication]。
在 [ 接收管線 ] 方塊中，選取 [PassThruReceive]。
按一下 [確定 ] 以套用變更。

建立傳送埠與 MQSeries 佇列

請依照以下步驟執行，建立傳送埠與 MQSeries 佇列：

以滑鼠右鍵按一下 [傳送埠]，按一下 [ 新增]，然後選取 [靜態單向傳送埠]。
在 [ 傳送埠屬性 ] 對話方塊的 [ 名稱 ] 方塊中，輸入 BTStoMQS。
從 [類型] 選項旁邊的下拉式清單中選取[MQSeries]。
在 [ 傳輸] 區段中，按一下 [ 設定]。
在 [ MQSeries 傳輸屬性 ] 對話方塊的 [ 佇列定義 ] 方塊中，按一下省略號 (...) 按鈕。
在 [ 佇列定義 ] 對話方塊的 [ 伺服器名稱 ] 方塊中，輸入您的電腦名稱稱。
在 [ 佇列管理員] 方塊中，選取預設佇列管理員。
在 [ 佇列] 方塊中，輸入 BTStoMQS，然後按一下 [ 匯出]。
在 [ 匯出 ] 對話方塊中，按一下 [ 建立佇列]，然後按一下 [ 確定 ] 並再次按一下 [ 確定 ] 以返回 [ 傳送埠屬性 ] 對話方塊。
在 [ 傳送管線 ] 方塊中，選取 [PassThruTransmit]。
按一下以選取左窗格中的 [ 篩選 ]，然後在右窗格中設定篩選選項。
在 [ 屬性 ] 下拉式清單中，選取 [BTS]。ReceivePortName。
在 [ 值 ] 方塊中，輸入 MQStoBTS。
按一下 [確定 ] 以套用變更。

啟用接收位置和啟動傳送埠

請依照以下步驟執行，啟用接收位置和啟動傳送埠：

以滑鼠右鍵按一下 MQStoBTS 接收位置，然後按一下 [ 啟用]。
以滑鼠右鍵按一下 BTStoMQS 傳送埠，然後按一下 [ 啟動]。

下一步是藉由傳送測試訊息到接收佇列，以測試應用程式。

若要測試應用程式

請依照以下步驟執行來測試應用程式：

按一下 [開始]，指向 [ 程式]，指向 [IBM WebSphere MQ]，然後按一下 [ WebSphere MQ 總管]。
以滑鼠右鍵按一下 [MQStoBTS]，然後按一下 [ 放置測試訊息]。
在 [ 訊息資料] 方塊中，輸入測試訊息。按一下 [確定]。

輸入資料之後，MQStoBTS佇列的目前深度是 1 (1) 。當應用程式處理訊息時，計數會傳回零 (0) ，而BTStoMQS的目前深度會變成 1 (1) 。您也可以檢視訊息內容。

檢視訊息

請依照以下步驟執行來檢視訊息：

按兩下 BTStoMQS 佇列。
按兩下訊息，然後選取 [資料 工作表]。您可以在 [ 訊息資料 ] 方塊中檢視訊息的文字。
按一下 [確定] 。

另請參閱

何謂 MQSeries 配接器？
MQSeries 配接器架構

共用方式為