一旦建立了連接器支援的商業物件定義之後,您必須將其部署至訊息分配管理系統工作區 (針對 WebSphere Business Integration Message Broker),或部署到訊息分配管理系統 (針對 WebSphere MQ Integrator 或 WebSphere MQ Integrator Broker)。您可使用 「系統管理程式」來執行這個動作。 「系統管理程式」會隨 Adapter Framework 安裝, 它提供一個圖形式使用者介面來配置及管理配接器。 (如需關於「系統管理程式」的詳細資訊,請參閱 IBM WebSphere Interchange Server System Administration Guide 及 IBM WebSphere Interchange Server Implementation Guide)。
若要啟動「系統管理程式」,請從 Windows「開始」功能表選取 IBM WebSphere Business Integration Adapters > 工具 > 系統管理程式。 確定您看到的是「系統管理程式」視景。於建立新專案之前,您應完成的首要步驟是 指定匯入器路徑。
如果專案與訊息分配管理系統不在相同的工作區中, 您必須先指定分配管理系統匯入器及訊息分配管理系統工作區目錄的路徑, 才能將專案部署至訊息分配管理系統。
要訣 |
---|
部署之後,「系統管理程式」中的 Broker Application Development 視景就會顯示目的地訊息集專案的項目。當您啟動工作台時,若啟動「系統管理程式」與 Message Broker Toolkit 的外掛程式,那麼它們就會位在相同的工作區。如果您可以在與「系統管理程式」相同的工作台中看到 Broker Application Development 視景,則表示也啟動了 Message Broker Toolkit 外掛程式。 |
若為 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 的任何其他專案的工作區)。
若要建立一個新使用者專案,請遵循下列步驟:
依據您使用哪一個訊息分配管理系統作為整合分配管理系統,部署程序中的剩餘步驟將有不同。
於下一個步驟中,您要用滑鼠右鍵按一下新專案名稱,然後選擇兩個部署類型的
其中之一,如下所示:
若您正使用... | 請選取... | 請參閱... |
---|---|---|
WebSphere Business Integration Message Broker | 部署至訊息分配管理系統工作區 | "部署至訊息分配管理系統工作區" |
WebSphere MQ Integrator | 部署至整合器分配管理系統 | "部署至整合器分配管理系統" |
WebSphere MQ Integrator Broker |
若要將專案部署至訊息分配管理系統工作區 (針對作為整合分配管理系統的 WebSphere Business Integration Message Broker),請從「系統管理程式」執行下列動作:
用來指定這個專案名稱的任何字串。當部署完成時,這個名稱就會出現在「系統管理程式」視窗中。
基本訊息集專案及基本訊息集。 如果您輸入現有基本訊息集專案及基本訊息集的名稱, 那麼就會將基本訊息集的內容當作新目的地專案的基礎。基本專案中所有的訊息集定義都會複製到新目的地專案。此外, 目的地專案也會包括部署期間您在前幾個視窗中選取的任何商業物件。 您可以在 Message Broker Tooling 的 Broker Application Development 視景中,檢視現有訊息集專案和基本訊息集的名稱。
以相同名稱取代現有的專案。如果在輸入訊息集專案名稱欄位中輸入的名稱與現有專案的名稱相同, 則適用這個選項。如果是這樣,則選取這個選項時,會根據您在部署期間的選擇來取代現有專案的內容 (只有名稱會維持相同)。如果不勾選這個選項,而指定的專案名稱與現有專案的名稱相同,那麼專案就會保留它已經包含的所有商業物件, 並新增部署期間所選取的商業物件。將會改寫名稱相同的所有現有商業物件。如果勾選這個選項, 但專案名稱不符合現有專案,則會忽略這個選項並建立新專案。
名稱空間感知及 XML 名稱空間格式。 依預設,XML 名稱空間格式設為 short。選取正確的名稱空間感知與XML 名稱空間格式組合非常重要, 否則部署就會失敗。請參閱"選擇 XML 名稱空間長度",以取得要對此參數選擇 long 或 short 的相關資訊。
若要將專案部署至整合器分配管理系統 (針對作為整合分配管理系統的 WebSphere MQ Integrator 或 WebSphere MQ Integrator Broker),請從「系統管理程式」執行 下列動作:
當您將專案部署至訊息分配管理系統時,您可以選擇 long 或 short 的 XMLNameSpace 格式。 預設值為 short。XMLNameSpaceFormat 為配接器的標準配置連線內容。 您於「系統管理程式」內所做的選擇會置換配接器 配置檔中可能已存在的任何值。 若要部署至 WebSphere Business Integration Message Broker, 選取參數視窗可讓您指定專案為名稱空間感知的。如果專案是名稱空間感知的,則容許 short 或 long 格式。如果專案不是名稱空間感知的,則必須使用 long。若對不是名稱空間感知的專案選取 short,將造成部署失敗。
訊息分配管理系統 | 支援名稱空間? | |
---|---|---|
| 是 | 否 |
WebSphere Business Integration Message Broker | long 或 short | long |
WebSphere MQ Integrator 或 WebSphere MQ Integrator Broker | N/A | long 或 short (若為 short,RFH2messagedomain 必須是 xml) |