共用方式為

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

  • 發行項

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

必要條件

  • BizTalk Adapter for TIBCO EMS 需要您將 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 系統中建立記錄。

此範例的設計方式和原因

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

可在何處找到此範例

此範例的預設位置是

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

下表列出此範例中的檔案並提供描述。

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

OneWaySend.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. 輸入 [ 名稱] 欄位的值，例如 TIBCOEMSOneWaySP。

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

    注意

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

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

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

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

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

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

  7. 按一下 [確定]。

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

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

建立檔案接收埠

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

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

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

建立檔案接收位置

  1. 為檔案接收位置建立一個資料夾來監視，例如 C:\Filesource。

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

  3. 輸入 [ 名稱] 欄位的值，例如 TIBCOEMSOneWayFileRL。

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

  5. 輸入您稍早為 [接收資料夾 ] 屬性建立的資料夾位置，然後按一下 [ 確定]。

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

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

從配接器結構描述產生文件執行個體

  1. 以滑鼠右鍵按一下 方案總管 中的 Schema.xsd，然後按一下 [屬性]。

  2. 在屬性視窗中，按一下以選取 [一般] 類別下的 [輸出實例檔案名] 選項。

  3. 按一下省略號按鈕 (...) 以顯示 [ 選取輸出檔案 ] 對話方塊。

  4. 指定輸出檔案實例的資料夾和名稱，例如 C:\instance.xml 並按一下 [ 儲存]。

    注意

    請勿在這裡指定剛才針對檔案接收位置指定的資料夾位置。

  5. 以滑鼠右鍵按一下 方案總管 中的 Schema.xsd，然後按一下 [產生實例] 以在指定的位置產生檔實例。

修改產生的文件執行個體

  1. 在文字編輯器 (如 [記事本]) 中開啟產生的文件執行個體，然後編輯文件執行個體的內容，以確保資料會在 TIBCO 系統中產生唯一的記錄。 例如，下列程式碼顯示這個資料檔案的第一個部分：

    <ns0:Root xmlns:ns0="http://TibcoEMSOne_WaySend.TibcoEMSOneWaySendSchema">  
  <Name>Punya Palit</Name>  
  <MailAddress>Prose Ware, Inc.</MailAddress>  
</ns0:Root>

  2. 儲存已修改的文件執行個體。

建置和部署專案

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

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

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

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

繫結和登錄協調流程

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

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

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

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

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

    參數 值
    主機 BizTalkServerApplication
    FileReceivePort TIBCOEMSOneWayFileRP
    TibcoEMSOneWaySendPort TIBCOEMSOneWaySP

  6. 按一下 [確定]。

啟動協調流程

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

將文件執行個體拖放到檔案接收位置所監視的資料夾

  • 將稍早建立的文件執行個體複製到應用程式所監視的檔案接收資料夾。

確認 TIBCO 系統已更新

  • 使用 TIBCO Web 介面，確認已從 XML 檔案中的資料建立記錄。

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

  1. 檔案配接器從資料夾擷取到檔案，並將其發佈到 MessageBox 做為 BizTalk 訊息。

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

  3. 協調流程實例會使用協調流程中指定的邏輯來處理訊息，並將訊息發佈回 MessageBox。

  4. TIBCO 傳送埠訂閱這個發佈訊息，因此 BizTalk 傳訊引擎會將訊息傳送至 TIBCO 傳送埠。

  5. 傳送埠將訊息交給 BizTalk Adapter for TIBCO Enterprise Message Service。

  6. BizTalk Adapter for TIBCO Enterprise Message Service 將訊息傳送至 TIBCO 系統。

另請參閱

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