設定配置檔內容

當您建立並命名新的連接器配置檔,或當您開啟現存連接器配置檔時, 「連接器配置程式」會顯示一個配置畫面,其中具有一些用於必要配置值種類的標籤。

對於所有分配管理系統上執行的連接器,「連接器配置程式」需要這些種類的內容值:

註:
若是使用 JMS 傳訊的連接器,則可能會針對將資料轉換成商業物件的資料處理常式配置來顯示其他的種類。

針對執行於ICS 的連接器,也需要這些內容值:

重要事項:
「連接器配置程式」接受英文或非英文字集的內容值。不過,標準和連接器特有內容的名稱,以及支援的商業物件名稱,只能使用英文字集。

標準內容不同於連接器特有內容,如下所示:

標準內容連接器特有內容的欄位皆以色彩標示來顯示哪些是可配置的:

設定標準連接器內容

若要變更標準內容的值:

  1. 按一下想要設定其值的欄位。
  2. 輸入所要設定的值,或從下拉功能表 (若有出現) 中選取值。
  3. 輸入標準內容的所有值之後,您可以執行下列其中一項作業:

設定特定應用程式專用的配置內容

針對特定應用程式專用的配置內容,您可以新增或變更內容名稱、配置值、刪除內容及加密內容。 預設內容長度是 255 個字元。

  1. 用滑鼠右鍵按一下方格左上方。即出現一個蹦現式功能表列。按一下新增來新增內容。若要新增子項內容, 請用滑鼠右鍵按一下母項列號,並按一下新增子項
  2. 輸入內容或子項內容的值。
  3. 若要加密內容,請選取加密方框。
  4. 選擇儲存或捨棄變更,如設定標準連接器內容所述。

針對每一個內容顯示的「更新方法」,可指出元件或代理程式是否需要重新啟動以使變更值生效。

重要事項:
變更預設的特定應用程式連接器內容名稱可能會導致連接器失敗。連接器可能需要某些特定的內容名稱, 才能連接應用程式或正確地執行。

為連接器內容加密

您可以選取編輯內容視窗中的加密勾選框來為特定應用程式內容加密。若要對某個值解密, 請按一下以清除加密勾選框、在驗證對話框中輸入正確值,然後按一下確定。如果輸入的是正確值,則該值會被解密並顯示出來。

每一個連接器的配接器使用手冊都有每一個內容及其預設值的清單和說明。

如果內容具有多重值,則會針對內容的第一個值顯示加密勾選框。當您選取加密時, 該內容的所有值都會被加密。若要對內容的多重值進行解密,請按一下來清除該內容第一個值的加密勾選框,然後在驗證對話框中輸入一個新的值。如果輸入值符合,所有多重值都會被解密。

更新方法

請參閱設定及更新內容值下的連接器的標準配置內容附錄中的更新方法說明。

指定支援的商業物件定義

使用「連接器配置程式」中支援的商業物件標籤,指定此連接器將使用的商業物件。您必須同時指定通用商業物件和特定應用程式專用的商業物件, 而且必須指定商業物件之間的對映關係。

註:
某些連接器需要指定一些支援的商業物件,以便搭配其應用程式來執行事件通知或其他的配置 (使用 Meta 物件)。 如需詳細資訊,請參閱 Connector Development Guide for C++Connector Development Guide for Java

如果 ICS 是您的分配管理系統

若要指定連接器支援的商業物件定義,或變更現有商業物件定義的支援設定,請按一下支援的商業物件標籤並使用下列欄位。

商業物件名稱

若要使用「系統管理程式」來指定連接器支援的商業物件定義,請執行:

  1. 按一下商業物件名稱清單中的空欄位。即顯示一個下拉清單,內容是目前在「系統管理程式」專案中的所有商業物件定義。
  2. 按一下商業物件來新增它。
  3. 為商業物件設定代理程式支援 (如下所述)。
  4. 在「連接器配置程式」視窗的「檔案」功能表中,按一下儲存至專案。已修訂的連接器定義 (包括對新增的商業物件定義指定的支援) 會儲存到「系統管理程式」中的專案。

若要從支援的清單中刪除商業物件:

  1. 要選取商業物件欄位,請按一下商業物件左邊的號碼。
  2. 從「連接器配置程式」視窗的編輯功能表中,按一下刪除列。如此便會從清單顯示畫面移除商業物件。
  3. 檔案功能表中,按一下儲存至專案

從支援的清單中刪除商業物件會變更連接器定義,並使刪除的商業物件無法用於此連接器的這個實作中。 它並不會影響連接器的程式碼,也不會從「系統管理程式」中移除商業物件定義本身。

代理程式支援

如果商業物件有「代理程式支援」,這表示系統將會嘗試使用該商業物件,透過連接器代理程式傳遞資料給應用程式。

一般而言,連接器的特定應用程式商業物件是受到連接器代理程式的支援,但通用商業物件不受其支援。

若要指示商業物件是受到連接器代理程式的支援,請勾選代理程式支援方框。「連接器配置程式」視窗不會驗證您的「代理程式支援」選項。

最大交易層次

連接器的最大交易層次就是連接器支援的最高交易層次。

對大部份的連接器而言,最佳嘗試是唯一的選擇。

您必須重新啟動伺服器才能使交易層次的變更生效。

如果 WebSphere Message Broker 是您的分配管理系統

如果您是在獨立模式下作業 (而非連接到「系統管理程式」),必須以手動方式輸入商業名稱。

如果執行「系統管理程式」,您可以在支援的商業物件標籤中的商業物件名稱欄位下, 選取空的方框。此時會出現組合框,並列出連接器所屬的「整合元件程式庫」專案中可用的商業物件。請在清單中選取想要的商業物件。

訊息集 ID 是 WebSphere Business Integration Message Broker 5.0 的選用欄位,不一定是唯一值 (如果您提供此值)。然而,您必須為 WebSphere MQ Integrator 及 Integrator Broker 2.1 提供唯一的 ID

如果 WAS 是您的分配管理系統

當選取 WebSphere Application Server 做為您的分配管理系統類型,則「連接器配置程式」不需要訊息集 ID。只有在支援商業物件時,支援的商業物件標籤才會顯示出商業物件名稱欄位。

如果您是在獨立式的模式作業 (而非連接到系統管理程式),必須以手動方式輸入商業物件名稱。

如果執行「系統管理程式」,您可以在「支援的商業物件」標籤中的「商業物件名稱」欄位下,選取空對話框。組合框會出現,列出連接器所屬「整合元件程式庫」專案中可用的商業物件。請在此清單中選取想要的商業物件。

相關對映 (僅限 ICS)

每一個連接器皆支援目前在 WebSphere InterChange Server 作用中的商業物件定義及其相關對映的清單。當您選取相關對映標籤時便會顯示此清單。

商業物件清單包含代理程式支援的特定應用程式商業物件,和控制程式傳至訂閱協同作業的對應通用物件。 對映關聯可決定使用哪一種對映來將特定應用程式商業物件轉換成通用商業物件,或將通用商業物件轉換成特定應用程式商業物件。

如果您使用一些專門為特定來源和目標商業物件來定義的對映,則當您開啟顯示畫面時, 這些對映已經與其適當的商業物件相關聯,您不需要 (或不可以) 變更它們。

如果支援的商業物件可使用多個對映,您必須明確地連結該商業物件與其應使用的對映。

相關對映標籤顯示下列欄位:

資源 (ICS)

資源標籤可讓您設定值,來決定連接器代理程式是否使用連接器代理程式平行處理方式來同時處理多重程序,以及決定其處理範圍。
並非所有連接器都支援此項功能。如果您是使用 Java 設計成多執行緒的連接器代理程式,通常不建議使用此功能,因為使用多執行緒的通常比使用多重程序更有效率。

傳訊 (ICS)

唯有在您將 MQ 設為 DeliveryTransport 標準內容的值且將 ICS 設為分配管理系統類型時,才能使用傳訊內容。這些內容將影響您連接器使用佇列的方式。

設定追蹤/日誌檔案值

當開啟連接器配置檔或連接器定義檔時,「連接器配置程式」會使用該檔案的日誌記載和追蹤值作為預設值。您可以在「連接器配置程式」中變更這些值。

若要變更日誌記載和追蹤值:

  1. 按一下追蹤/日誌檔標籤。
  2. 您可以選擇日誌記載或追蹤來將訊息寫入下列其中之一或兩者:

資料處理常式

唯有當您對 DeliveryTransport 指定了 JMS 的值並對 ContainerManagedEvents 指定了 JMS 的值,資料處理常式區段才可用於配置。並非所有的配接器都使用資料處理常式。

有關這些內容使用的值,請參閱「附錄 A. 標準內容」中 ContainerManagedEvents 下的說明。如需其他詳細資料,請參閱 Connector Development Guide for C++Connector Development Guide for Java

Copyright IBM Corp. 1997, 2003