建立訊息分配管理系統專案

一旦建立了連接器支援的商業物件定義之後,您必須將其部署至訊息分配管理系統工作區 (針對 WebSphere Business Integration Message Broker),或部署到訊息分配管理系統 (針對 WebSphere MQ Integrator 或 WebSphere MQ Integrator Broker)。您可使用 「系統管理程式」來執行這個動作。 「系統管理程式」會隨 Adapter Framework 安裝, 它提供一個圖形式使用者介面來配置及管理配接器。 (如需關於「系統管理程式」的詳細資訊,請參閱 IBM WebSphere Interchange Server System Administration GuideIBM WebSphere Interchange Server Implementation Guide)。

註:
您必須先安裝連接器,才能將專案部署至訊息分配管理系統。如需安裝指示,請參閱 WebSphere Business Integration Adapters Installation Guide

若要啟動「系統管理程式」,請從 Windows「開始」功能表選取 IBM WebSphere Business Integration Adapters > 工具 > 系統管理程式。 確定您看到的是「系統管理程式」視景。於建立新專案之前,您應完成的首要步驟是 指定匯入器路徑。

指定匯入器和工作區路徑

如果專案與訊息分配管理系統不在相同的工作區中, 您必須先指定分配管理系統匯入器及訊息分配管理系統工作區目錄的路徑, 才能將專案部署至訊息分配管理系統。

註:
如果您將商業物件部署至 WebSphere Business Integration Message Broker, 而「系統管理程式」與 Message Broker Toolkit 位於相同的外掛程式目錄, 則您需執行這個步驟。在部署期間,會在現行「系統管理程式」工作區中建立所指定的專案。
要訣

部署之後,「系統管理程式」中的 Broker Application Development 視景就會顯示目的地訊息集專案的項目。當您啟動工作台時,若啟動「系統管理程式」與 Message Broker Toolkit 的外掛程式,那麼它們就會位在相同的工作區。如果您可以在與「系統管理程式」相同的工作台中看到 Broker Application Development 視景,則表示也啟動了 Message Broker Toolkit 外掛程式。

如果分配管理系統匯入器與訊息分配管理系統工作區位於不同的目錄,請指定它們的路徑,如下所示:
  1. 從「系統管理程式」中,選取視窗> 喜好設定 > 系統管理程式喜好設定> 分配管理系統喜好設定。 此時出現下列視窗:
    顯示「分配管理系統喜好設定」視窗的畫面擷取。請依指示填入資料。
  2. 輸入 (或按一下「瀏覽」來尋找) 路徑名稱,如下所示:

    若為 WebSphere MQ Integrator Broker 或 WebSphere MQ Integrator, 請輸入整合器匯入器路徑 (在「Integrator Broker 設定」下)。匯入器的名稱為 mqsilmpXMLSchema.exe,而它應該位於分配管理系統安裝的 bin 目錄中。

    若為 WebSphere Business Integration Message Broker,請輸入訊息分配管理系統匯入器路徑和 訊息分配管理系統工作區目錄 (在「Message Broker 設定」下)。 匯入器的名稱為 mqsicreatemsgdefs.exe,而它應該位於分配管理系統安裝的 eclipse 目錄中。請確定選取訊息分配管理系統工作區,而不是「系統管理程式」工作區。訊息分配管理系統工作區的預設路徑為 eclipse\workspace (訊息分配管理系統工作區就是用來儲存訊息集和訊息流程專案,以及 WebSphere Business Integration Message Broker Tooling 的任何其他專案的工作區)。

    註:
    所輸入的路徑名稱應該是絕對路徑。

建立新使用者專案

若要建立一個新使用者專案,請遵循下列步驟:

  1. 從「使用者專案」功能表中,選取訊息分配管理系統專案, 然後選取 新建訊息分配管理系統專案,如下列圖例所示:


    顯示已選取的「分配管理系統專案」和子項目「新建分配管理系統」專案的 「系統管理程式」畫面擷取。

  2. 此時出現一個「新建使用者專案」視窗。請輸入專案名稱。例如:
    「系統管理程式」之「新建使用者專案」視窗的畫面擷取。
  3. 於「可用的整合元件程式庫」視窗中,您將看到已偵測到的整合元件程式庫清單。 (附註:安裝「系統管理程式」時必須輸入程式庫路徑)。選取加號 (+) 以展開「可用的 整合元件程式庫」視窗中的勾選框,然後選取您要加入專案中的商業物件定義和連接器。
    註:
    選取「商業物件」旁的勾選框 (如範例所示),將會選取所有可用的商業物件定義。 選取「連接器」旁邊的勾選框 (如範例所示),將會選取所有可用的連接器。
  4. 按一下「完成」。「系統管理程式」的「分配管理系統專案」清單中將出現新專案的名稱。
  5. 於「使用者專案」畫面中,展開新專案的名稱及出現的「商業物件」和「連接器」項目, 您會看到所選取的「商業物件」和「連接器」的名稱。

依據您使用哪一個訊息分配管理系統作為整合分配管理系統,部署程序中的剩餘步驟將有不同。 於下一個步驟中,您要用滑鼠右鍵按一下新專案名稱,然後選擇兩個部署類型的 其中之一,如下所示:
若您正使用... 請選取... 請參閱...
WebSphere Business Integration Message Broker 部署至訊息分配管理系統工作區 "部署至訊息分配管理系統工作區"
WebSphere MQ Integrator 部署至整合器分配管理系統 "部署至整合器分配管理系統"
WebSphere MQ Integrator Broker

部署至訊息分配管理系統工作區

若要將專案部署至訊息分配管理系統工作區 (針對作為整合分配管理系統的 WebSphere Business Integration Message Broker),請從「系統管理程式」執行下列動作:

  1. 於「使用者專案」畫面中,以滑鼠右鍵按一下新專案的名稱,然後選取 「部署至訊息分配管理系統工作區」,如下列圖例所示:
    顯示「部署至訊息分配管理系統工作區」選項的畫面擷取
    此時出現下列視窗,顯示可用的商業物件:
    顯示「部署至訊息分配管理系統工作區」的畫面擷取
  2. 於清單中選擇所要的商業物件 (或「選取所有商業物件」或「僅顯示最上層商業物件」)。
  3. 按「下一步」。此時出現下列視窗:
    顯示「選取參數」視窗的畫面擷取
  4. 輸入「訊息集」專案的名稱 (必要的) 及其他任何參數 (選用的)。以下詳細說明參數:

    訊息集專案名稱

    用來指定這個專案名稱的任何字串。當部署完成時,這個名稱就會出現在「系統管理程式」視窗中。

    基本訊息集專案及基本訊息集。 如果您輸入現有基本訊息集專案及基本訊息集的名稱, 那麼就會將基本訊息集的內容當作新目的地專案的基礎。基本專案中所有的訊息集定義都會複製到新目的地專案。此外, 目的地專案也會包括部署期間您在前幾個視窗中選取的任何商業物件。 您可以在 Message Broker Tooling 的 Broker Application Development 視景中,檢視現有訊息集專案和基本訊息集的名稱。

    註:
    您必須輸入基本訊息集專案及基本訊息集;如果只指定這些參數中的其中之一, 系統就會忽略它,而只將部署期間所選取的商業物件併入專案。

    以相同名稱取代現有的專案。如果在輸入訊息集專案名稱欄位中輸入的名稱與現有專案的名稱相同, 則適用這個選項。如果是這樣,則選取這個選項時,會根據您在部署期間的選擇來取代現有專案的內容 (只有名稱會維持相同)。如果不勾選這個選項,而指定的專案名稱與現有專案的名稱相同,那麼專案就會保留它已經包含的所有商業物件, 並新增部署期間所選取的商業物件。將會改寫名稱相同的所有現有商業物件。如果勾選這個選項, 但專案名稱不符合現有專案,則會忽略這個選項並建立新專案。

    名稱空間感知及 XML 名稱空間格式。 依預設,XML 名稱空間格式設為 short。選取正確的名稱空間感知XML 名稱空間格式組合非常重要, 否則部署就會失敗。請參閱"選擇 XML 名稱空間長度",以取得要對此參數選擇 long 或 short 的相關資訊。

    以詳細模式部署 選取這個選項會在部署期間顯示或記載部署程序的更多詳細資料。

  5. 按一下「完成」。如果順利部署專案,視窗就會顯示訊息,指出部署成功。此外, 部署的結果也會記錄在位於匯入器目錄 (預設目錄 eclipse) 的預設日誌檔 mqsicreatemsgdefs.report.txt 中。另請參閱「系統管理程式」的主控台畫面; 它會顯示已經順利部署了哪些商業物件。
    註:
    當您按一下「完成」以進行部署時,Message Broker Toolkit 必須是關閉的。如果那時 Toolkit 是開啟的,您就會收到訊息, 指出部署部份或所有商業物件及訊息集已失敗。您必須從程序開頭處重新部署,並確定已關閉 Toolkit。

部署至整合器分配管理系統

若要將專案部署至整合器分配管理系統 (針對作為整合分配管理系統的 WebSphere MQ Integrator 或 WebSphere MQ Integrator Broker),請從「系統管理程式」執行 下列動作:

  1. 於「使用者專案」畫面中,以滑鼠右鍵按一下新專案的名稱,然後選取 「部署至整合器分配管理系統」,如下列圖例所示:
    顯示「部署至整合器分配管理系統」視窗的畫面擷取
    此時出現下列視窗,顯示可用的商業物件:
    顯示「部署至整合器分配管理系統」視窗的畫面擷取
  2. 於清單中選擇所要的商業物件 (或「選取所有商業物件」或「僅顯示最上層商業物件」)。
  3. 按「下一步」。此時出現「參數選項」視窗。此視窗可讓您變更 WebSphere MQ Integrator 值及選取連接器的 XML 名稱空間格式。例如:
    顯示 WebSphere MQ Integrator 值之「參數選擇」畫面的畫面擷取。
  4. 輸入要從預設值變更的「密碼」(DB_PW 內容) 及其他任何值。 (先前使用此視窗所輸入的值已儲存並將顯示為預設。) 請注意:XML 名稱空間格式預設為 short。選取正確的名稱空間感知XML 名稱空間格式組合非常重要, 否則部署就會失敗。請參閱選擇 XML 名稱空間長度,以取得要對此參數選擇 long 或 short 的相關資訊。
  5. 按一下「完成」。如果順利完成部署,視窗就會顯示訊息,指出順利完成部署。另請參閱「系統管理程式」的主控台畫面; 它會顯示已經順利部署了哪些商業物件。

選擇 XML 名稱空間長度

當您將專案部署至訊息分配管理系統時,您可以選擇 longshortXMLNameSpace 格式。 預設值為 shortXMLNameSpaceFormat 為配接器的標準配置連線內容。 您於「系統管理程式」內所做的選擇會置換配接器 配置檔中可能已存在的任何值。 若要部署至 WebSphere Business Integration Message Broker, 選取參數視窗可讓您指定專案為名稱空間感知的。如果專案是名稱空間感知的,則容許 shortlong 格式。如果專案不是名稱空間感知的,則必須使用 long。若對不是名稱空間感知的專案選取 short,將造成部署失敗。

註:
IBM 建議將任何新專案設為支援名稱空間 (namespace-aware) 模式, 以相容於目前的業界標準。 如有可能,IBM 建議將 XMLNameSpace 格式設定為 short, 以達到較佳的執行效能。
若要部署至 WebSphere MQ Integrator 或 WebSphere MQ Integrator Broker, 則可選擇 longshort。然而,若選擇了 short, 連接器的 RFH2messagedomain 內容必須設為 xmlRFH2messagedomain 設為 mrm,僅可處理 long 名稱空間格式的 XML 訊息。

註:
WebSphere MQ Integrator 及 WebSphere MQ Integrator Broker 不支援名稱空間。因此,您無法為部署至這些分配管理系統的專案指定名稱空間感知。
表 11 顯示可用的 XMLNameSpace 格式替代方案:

表 11. XMLNameSpace 格式替代方案
訊息分配管理系統 支援名稱空間?

WebSphere Business Integration Message Broker long 或 short long
WebSphere MQ Integrator 或 WebSphere MQ Integrator Broker N/A long 或 short (若為 short,RFH2messagedomain 必須是 xml)

Copyright IBM Corp. 1997, 2003