OrderedSample (BizTalk Server 範例)
OrderedSample 範例會示範如何使用協調流程，以往返方式接收和傳送已排序的訊息序列。
此範例的用途
此範例會假設 MQSeries 佇列中有訊息存在，以便從其中接收訊息。 當配接器從 MQSeries 佇列讀取訊息時，會依序讀取訊息並將其提交至 BizTalk Server。
協調流程 mqreceive中的接收埠已將其 [已排序傳遞 ] 屬性設定為 True。
至於傳送端，協調流程會傳送訊息並等待傳遞通知，收到通知後才會傳送下一則訊息。 mqsend的傳送埠已將其傳遞通知屬性設定為[已傳輸]。 為了讓此範例簡單好用，協調流程將使用無限迴圈。
協調流程可以接收批次訊息和單一訊息。
可在何處找到此範例
< Samples Path >\AdaptersUsage\MQSeriesAdapter\OrderedSample
下表顯示此範例中的檔案，並描述其用途。
| 檔案 | 描述 |
|---|---|
| OrderedReceiveSend.btproj、 OrderedReceiveSend.sln |
應用程式的專案和方案檔。 |
| OrderedReceiveSendOrchestration.odx | 應用程式的協調流程。 |
| OrderedSample.snk | 強式命名金鑰檔。 |
| Setup.bat | 建置並初始化此範例。 |
建置並執行範例
若要建置和部署範例
在命令視窗中，瀏覽至下列資料夾：
<Samples Path>\AdaptersUsage\MQSeriesAdapter\OrderedSample執行檔案 Setup.bat，這會執行下列動作：
為專案建立強式名稱金鑰。
編譯和部署協調流程專案。
如果您有 MQSeries Server for Windows 安裝的必要權限，則可以透過配接器對話方塊建立 MQSeries 佇列並略過下一個程序。 如果您沒有這類存取權限，可以使用 IBM WebSphere MQ Explorer 來建立佇列。 若要透過 WebSphere MQ Explorer 建立佇列，請完成下列步驟：
透過 WebSphere MQ Explorer 建立 MQSeries 佇列
若要透過 WebSphere MQ Explorer 建立 MQSeries 佇列
依序按一下 [開始]、[ 所有程式] 和 [ IBM WebSphere MQ]，然後按一下 [ WebSphere MQ 總管]。
按兩下 [ 佇列管理員]，然後按兩下 預設佇列管理員。 預設佇列管理員通常會命名為QM_ < machine_name其中 > machine_name是您電腦的名稱。
以滑鼠右鍵按一下 [ 佇列]，指向 [ 新增]，然後按一下 [ 本機佇列]。
在 [建立本機佇列 ] 對話方塊的 [ 佇列名稱] 中，輸入 「queue1」，然後按一下 [ 確定]。
以滑鼠右鍵按一下 [ 佇列]，按一下 [ 新增]，然後按一下 [ 本機佇列]。
在 [ 建立本機佇列 ] 對話方塊的 [ 佇列名稱] 中，輸入 「queue2」，然後按一下 [ 確定]。
建立接收位置與 MQSeries 佇列
此程序會建立傳送埠和接收位置，以傳送訊息至 MQSeries 以及接收來自 MQSeries 的相互關聯訊息。 如果您還沒有建立 MQSeries 佇列，則在建立接收位置時，也會建立 MQSeries 佇列。
建立接收位置與 MQSeries 佇列
開啟 BizTalk Server 管理主控台。
依序展開 [BizTalk Server管理]、[BizTalk 群組]、[應用程式] 和 [必要應用程式]。
以滑鼠右鍵按一下 [接收埠]，指向 [ 新增]，然後按一下 [單向接收埠]。
在 [單向接收埠屬性 ] 對話方塊中，于 [ 名稱 ] 方塊中輸入 OrderedSampleReceive ，然後按一下 [ 確定]。
在左窗格中，按一下 [ 接收位置] 索引標籤，然後按一下 [ 新增]。
在 [ 接收位置屬性 ] 對話方塊的 [ 名稱 ] 方塊中，輸入 「OrderedSampleReceiveLocation」。
在 [ 傳輸類型] 方塊中，選取 [MQSeries]。
在 [ 接收處理常式] 方塊中，選取 [BizTalkServerApplication]。
在 [ 接收管線 ] 方塊中，選取 [Microsoft.BizTalk.DefaultPipelines.PassThruReceive]。
按一下 [設定] 。
在 [MQSeries 傳輸屬性] 對話方塊的 [輪詢間隔] 方塊中，輸入「10」。
在 [ 佇列定義 ] 方塊中，按一下 省略號 (...) 按鈕。
在 [ 佇列定義 ] 對話方塊的 [ 伺服器名稱 ] 方塊中，輸入您的電腦名稱稱。
在 [ 佇列管理員] 方塊中，選取 預設佇列管理員。
在 [ 佇列 ] 方塊中，輸入 「 queue1」，然後按一下 [ 匯出]。
在 [ 匯出 ] 對話方塊中，按一下 [ 建立佇列]，然後按一下 [ 確定 ] 或 [ 完成 ]，直到您結束所有對話方塊為止。
建立傳送埠和 MQSeries 佇列
若要建立傳送埠和 MQSeries 佇列
以滑鼠右鍵按一下 [傳送埠]，指向 [ 新增]，然後按一下 [ 靜態單向傳送埠]。
在 [ 靜態埠屬性 ] 對話方塊的 [ 名稱 ] 方塊中，輸入 「OrderedSampleSend」。
在 [ 傳輸類型] 方塊中，選取 [MQSeries]。
在 [ 傳送管線 ] 方塊中，選取 [Microsoft.BizTalk.DefaultPipelines.PassThruTransmit]。
按一下 [設定] 。
在 [ MQSeries 傳輸屬性 ] 對話方塊的 [ 佇列定義 ] 方塊中，按一下 省略號 (...) 按鈕。
在 [ 佇列定義 ] 對話方塊的 [ 伺服器名稱 ] 方塊中，輸入您的電腦名稱稱。
在 [ 佇列管理員] 方塊中，選取 預設佇列管理員。
在 [ 佇列] 方塊中，輸入 「 queue2」，然後按一下 [ 匯出]。
在 [ 匯出 ] 對話方塊中，按一下 [ 建立佇列]，然後按一下 [ 確定 ] 或 [ 完成 ]，直到您結束所有對話方塊為止。
啟用接收位置和啟動傳送埠
在 BizTalk Server 管理主控台中，按一下 [接收埠]。
在詳細資料窗格中，以滑鼠右鍵按一下 MQIn 接收位置，然後按一下 [ 啟用]。
在詳細資料窗格中，以滑鼠右鍵按一下 MQOut 傳送埠，然後按一下 [ 啟動]。
若要繫結並啟動協調流程
在 BizTalk Server 管理主控台中，展開[協調流程]資料夾。
按兩下 OrderedSampleOrchestration 協調流程，然後按一下 [ 系結]。
將協調流程連接埠繫結至下列傳送埠和接收位置：
協調流程連接埠 傳送埠/接收位置 mqreceive OrderedSampleReceive mqsend OrderedSampleSend 按一下 [ 主機]。
在 [ 主機] 方塊中，選取 [BizTalkServerApplication]，然後按一下 [ 確定]。
以滑鼠右鍵按一下 協調流程 ，然後按一下 [啟動]。
執行範例
啟動協調流程。
將訊息放入您已設定接收位置要從中讀取的 MQSeries 佇列。
使用 WebSphere MQ Explorer 檢視傳送佇列 (您已設定傳送埠要將訊息傳送至此佇列) 內的訊息。