共用方式為

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

  • 發行項

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

必要條件

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

  • 此範例會使用包含訊息內容屬性的 DLL：Microsoft.BizTalk.Adapters.TibRV.Properties.dll。 您可能需要更新方案對這個程式庫的參考。 如需詳細資訊，請參閱BizTalk Server訊息內容屬性 (傳送處理常式) 。

關於範例

  • 此範例會從某個檔案資料夾收取某個 XML 檔案、將該檔案傳送至協調流程，然後使用 BizTalk Adapter for TIBCO Rendezvous 在 TIBCO 系統中建立一筆記錄。

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

  • 範例的預設位置為 C:\Program Files\Microsoft BizTalk Adapters for Enterprise Applications\TIBCO(r) Rendezvous(r)\Sdk\OneWaySend ，並包含下列檔案：

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

    OneWaySend.sln    		 應用程式的專案和方案檔。
    Schema.xsd

    PropertySchema.xsd    		 這個應用程式的結構描述和屬性結構描述檔案。
    Orchestration.odx 這個應用程式使用的協調流程。
    TIBCORendezvousOneWaySend.snk 強式命名金鑰檔。

步驟 1：將配接器新增至 BizTalk 管理

  1. 在[BizTalk Server管理]中，依序展開[BizTalk 群組]、[平臺設定] 和 [配接器]。

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

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

  4. 從 [配接器]下拉式清單中，選取[TIBCO (r) Rendezvous (r) ]，然後按一下 [確定]。

步驟 2：建立傳送埠

  1. 在[BizTalk Server管理] 中，依序展開 [BizTalk 群組]、[應用程式]、[BizTalk 應用程式 1] 和 [傳送埠]。

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

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

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

    注意

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

  5. 輸入 認證寄件者屬性的值：

    屬性 值
    分類帳檔案名稱 要用於永續性認證訊息傳遞的分類帳檔案名稱。
    可重複使用的名稱 要用於認證訊息傳遞的可重複使用對應名稱。 在網路上所有認證訊息通訊人名稱當中，這必須是唯一名稱。

  6. 輸入 認證的值：

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

  7. 輸入 RendezvousTransport的值：

    屬性 值
    精靈 Rendezvous 傳輸精靈參數。
    網路 Rendezvous 傳輸網路參數。
    服務 Rendezvous 傳輸服務參數。

    如需屬性的詳細資訊，請參閱 建立傳送成品。

  8. 按一下 [確定]。

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

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

步驟 3：建立接收埠

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

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

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

步驟 4：建立接收位置

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

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

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

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

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

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

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

步驟 5：從架構產生檔實例

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

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

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

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

    注意

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

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

步驟 6：更新產生的檔實例

  1. 在文字編輯器中開啟產生的檔實例， (記事本運作) ，並編輯檔實例的內容，以確保資料會在 TIBCO 系統中產生唯一記錄。 例如，下列程式碼會顯示資料檔案的第一個部分：

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

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

步驟 7：建置和部署專案

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

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

  3. 針對[Server]屬性輸入適當的值，並在[BizTalk 群組] 底下輸入 [組態資料庫] 屬性。

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

步驟 8：系結、登記及啟動協調流程

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

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

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

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

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

    參數 值
    主機 BizTalkServerApplication
    FileReceivePort TIBCORndOneWayFileRP
    TibcoRendezvousSend TIBCORndOneWaySP

  6. 按一下 [確定]。

  7. 以滑鼠右鍵按一下協調流程，然後按一下 [ 開始 ] 以登記並啟動協調流程。

步驟 9：卸載檔，並檢查 TIBCO 系統

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

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

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

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

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

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

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

  5. 傳送埠將訊息交給 BizTalk Adapter for TIBCO Rendezvous。

  6. BizTalk Adapter for TIBCO Rendezvous 將訊息傳送至 TIBCO 系統。

另請參閱

教學課程：使用適用於 TIBCO Rendezvous 的 BizTalk 配接器接收資料
教學課程：使用 Microsoft BizTalk Adapter for TIBCO Rendezvous
快速入門