共用方式為

教學課程：使用 BizTalk Adapter for TIBCO Enterprise Message Service 來接收資料

  • 發行項

您可以使用 BizTalk Adapter for TIBCO Enterprise Message Service (EMS) 接收來自 TIBCO 系統的資料。 這個逐步解說將說明示範這一點的 SDK 範例。

必要條件

  • 若要使用 BizTalk Adapter for TIBCO Enterprise Message Service，您必須將 TIBCO EMS C# API、TIBCO.EMS.dll 新增至全域組件快取 (GAC)。 如需安裝元件的詳細資訊，請參閱 TIBCO Enterprise Message Service Requirements and Limitations。

  • 在配接器執行所在的BizTalk Server上安裝 Visual Studio，以便建置和部署範例。

此範例的用途

此範例會從某個資料夾收取某個 XML 檔案、將該檔案傳送至協調流程，然後使用 BizTalk Adapter for TIBCO Enterprise Message Service 接收來自 TIBCO 系統的資料。 結果會寫入至 XML 檔案。

此範例的設計方式和原因

此範例設計于 Visual Studio 中，說明搭配 BizTalk 協調流程使用 BizTalk Adapter for TIBCO Enterprise Message Service 的基本功能。

注意

此範例假設您已知道如何傳送來自 TIBCO 的訊息以讓應用程式處理。

可在何處找到此範例

此範例的預設位置是

C:\Program Files\Microsoft BizTalk Adapters for Enterprise Applications\TIBCO(r) Enterprise Message Service(TM)\Sdk\OneWayReceive

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

執行階段專案檔案名稱 執行階段專案檔案描述
OneWayReceive.btproj、

OneWayReceive.sln		 應用程式的專案和方案檔。
Schema.xsd、 這個應用程式的結構描述檔案。
Orchestration.odx 這個應用程式使用的協調流程。
TIBCOEMSOneWaySend.snk 強式命名金鑰檔。

如何使用此範例

建立新的 BizTalk Adapter for TIBCO EMS 執行個體

  1. 啟動 BizTalk Server 管理主控台。 按一下[開始]、[程式]、[MicrosoftBizTalk Server]，BizTalk Server [系統管理]。

  2. 在 BizTalk Server 管理主控台中，依序展開 [BizTalk Server系統管理]、[BizTalk 群組]、[平臺設定] 和 [配接器]。

  3. 以滑鼠右鍵按一下 [ 配接器 ]，然後指向 [ 新增]、[配接 器 ] 以顯示 [ 配接器屬性 ] 對話方塊。

  4. 輸入 [ 名稱] 欄位的值，例如 TIBCO EMS。

  5. 從 [配接器] 下拉式清單中可用的配接器清單中選取[TIBCO Enterprise Message System]，然後按一下 [確定]。

建立 BizTalk 接收埠

  1. 在 BizTalk Server 管理主控台中，依序展開 [BizTalk Server系統管理]、[BizTalk 群組]、[應用程式]、[BizTalk 應用程式 1] 和 [接收埠]。

  2. 以滑鼠右鍵按一下 [接收埠] 資料夾，然後按一下 [新增單向接收埠]以顯示 [接收埠內容] 對話方塊。

  3. 輸入 [ 名稱] 欄位的值，例如 TIBCOEMSOneWayRP，然後按一下 [ 確定]。

建立 BizTalk 接收位置

  1. 以滑鼠右鍵按一下新的接收埠，然後按一下 [ 新增]、[ 接收位置] 以顯示 [ 接收位置屬性 ] 對話方塊。

  2. 輸入 [ 名稱] 欄位的值，例如 TIBCOEMSOneWayRL。

  3. 從 [ 類型 ] 下拉式方塊中可用的介面卡清單中選取 TIBCO EMS 配接器，然後按一下 [ 設定 ] 按鈕以顯示 [配接器 傳輸屬性 ] 對話方塊。

    注意

    此值是在 BizTalk Server 管理主控台中建立 TIBCO 配接器時所指定的名稱。

  4. 輸入 伺服器連線定義的值：

    屬性 值
    目的地 伺服器目的地佇列或主題名稱。
    連接埠號碼 TIBCO 伺服器接聽的連接埠。 預設值為 7222。
    Server Name (伺服器名稱) TIBCO EMS 伺服器的名稱。

  5. 輸入 [使用者認證] 的值：

    屬性 值
    密碼 TIBCO EMS 伺服器的密碼。
    使用者名稱 TIBCO EMS 伺服器的使用者名稱。

    如需屬性的詳細資訊，請參閱 建立 TIBCO Enterprise Message Service Receive Handlers。

  6. 按一下 [確定]。

  7. 從 [接收管線] 下拉式方塊中的可用管線清單中選取[XMLReceive]，然後按一下 [確定]。

  8. 以滑鼠右鍵按一下接收位置，然後按一下 [ 啟用]。

建立單向檔案傳送埠

  1. 建立傳送埠所要使用的目標資料夾，例如 C:\FilesOut。

  2. 在 BizTalk Server 管理主控台中，依序展開 [BizTalk Server系統管理]、[BizTalk 群組]、[應用程式]、[BizTalk 應用程式 1]，然後按一下 [傳送埠]。

  3. 以滑鼠右鍵按一下 [傳送埠 ]，並指向 [ 新增]、[ 靜態單向傳送埠 ] 以顯示 [ 傳送埠內容] 對話方塊。

  4. 輸入 [ 名稱] 欄位的值，例如 TIBCOEMSOneWayFileSP。

  5. 從 [類型] 下拉式方塊中可用的配接器清單中選取[檔案]，然後按一下 [設定] 按鈕以顯示 [配接器傳輸屬性] 對話方塊。

  6. 針對 [目的地資料夾 ] 屬性，輸入您稍早建立的資料夾位置，然後按一下 [ 確定]。

  7. 從 [傳送管線] 下拉式清單中可用的管線清單中選取[XMLTransmit管線]，然後按一下 [確定]。

  8. 以滑鼠右鍵按一下傳送埠，然後按一下 [ 開始] 以登記並啟動傳送埠。

建置和部署專案

  1. 以滑鼠右鍵按一下 方案總管 中的 OneWayReceive 專案，然後按一下 [屬性] 以啟動專案的 [專案Designer]。

  2. 按一下 [ 部署] 索引 標籤。

  3. 在[BizTalk 群組] 類別下輸入伺服器屬性和 [組態資料庫] 屬性的適當值。

  4. 以滑鼠右鍵按一下 方案總管 中的 OneWayReceive 專案，然後按一下 [部署] 來建置專案，並將元件部署至BizTalk Server組態資料庫。

繫結和登錄協調流程

  1. 在 BizTalk Server 管理主控台中，依序展開 [BizTalk Server系統管理]、[BizTalk 群組]、[應用程式]、[BizTalk 應用程式 1] 和 [協調流程]。

  2. 按一下 [BizTalk Server 管理主控台] 工具列中的 [重新整理] 按鈕，或按鍵盤上的F5鍵來重新整理BizTalk Server管理主控台檢視。

  3. 按兩下協調流程以顯示 [ 協調流程屬性] 對話方塊。

  4. 按一下對話方塊左窗格中的 [系結]，以顯示協調流程的 [系結] 選項。

  5. 指定適當的繫結選項值，例如：

    參數 值
    主機 BizTalkServerApplication
    FileSendPort TIBCOEMSOneWayFileSP
    TibcoEMSOneWayReceiveOperation TIBCOEMSOneWayRP

  6. 按一下 [確定]。

啟動協調流程

  • 在BizTalk Server管理主控台中，以滑鼠右鍵按一下協調流程，然後按一下 [開始] 以登記並啟動協調流程。

確認應用程式收到訊息

  • 開啟檔案傳送埠進行傳送時依設定要使用的目標資料夾，然後確認已產生輸出文件。 此檔案應包含 BizTalk Adapter for TIBCO Enterprise Message Service 處理查詢的結果。

    如果文件執行個體處理成功，則會發生以下一系列的事件：

  1. TIBCO EMS 配接器接收來自 TIBCO 系統的訊息，並以 BizTalk 訊息的形式將其發佈至 MessageBox。

  2. 協調流程訂閱這個發佈訊息，因此 BizTalk 傳訊引擎會啟動協調流程的執行個體，然後將訊息傳送至這個協調流程執行個體。

  3. 協調流程執行個體將訊息發佈回 MessageBox。

  4. 檔案傳送埠訂閱這個訊息，因此 BizTalk 會將訊息傳送至檔案配接器。

  5. 檔案配接器將包含結果集的訊息寫入至指定的輸出資料夾。

另請參閱

教學課程：使用 BizTalk Adapter for TIBCO Enterprise Message Service 來傳送資料
教學課程：使用 Microsoft BizTalk Adapter for TIBCO Enterprise Message Service
快速入門