當您建立並命名新的連接器配置檔,或當您開啟現存連接器配置檔時, 「連接器配置程式」會顯示一個配置畫面,其中具有一些用於必要配置值種類的標籤。
對於所有分配管理系統上執行的連接器,「連接器配置程式」需要這些種類的內容值:
針對執行於 ICS 的連接器,也需要這些內容值:
標準內容不同於連接器特有內容,如下所示:
標準內容與連接器特有內容的欄位皆以色彩標示來顯示哪些是可配置的:
若要變更標準內容的值:
若要取得特定標準內容的詳細資訊,請按一下「標準內容」已加上標籤之表單上,該內容「說明」直欄中的項目。如果安裝了「延伸說明」, 右方會出現箭頭按鈕。按一下按鈕時,「說明」視窗會開啟並顯示標準內容的詳細資料。
如果已安裝,「延伸說明」檔案放置在 <ProductDir>\bin\Data\Std\Help\<RegionalSetting>\ 中。
若為連接器特有的配置內容,您可以新增或變更內容名稱、配置值、刪除內容及加密內容。預設內容長度是 255 個字元。
如果安裝了「延伸說明」檔案且 AdapterHelpName 內容為空白, 則「連接器配置程式」將指向位於 <ProductDir>\bin\Data\App\Help\<RegionalSetting>\ 中的配接器特有的「延伸說明」檔案。否則, 「連接器配置程式」將指向位於 <ProductDir>\bin\Data\App\Help\<AdapterHelpName>\<RegionalSetting>\ 的配接器特有的「延伸說明」檔案。請參閱附錄「標準內容」中所說明的 AdapterHelpName 內容。
針對每一個內容顯示的「更新方法」,可指出元件或代理程式是否需要重新啟動以使變更值生效。
您可以選取「連接器特有內容」視窗中的加密勾選框來為特定應用程式內容加密。若要對某個值解密, 請按一下以清除加密勾選框、在驗證對話框中輸入正確值,然後按一下確定。如果輸入的是正確值,則該值會被解密並顯示出來。
每一個連接器的配接器使用手冊都有每一個內容及其預設值的清單和說明。
如果內容具有多重值,則會針對內容的第一個值顯示加密勾選框。當您選取加密時, 該內容的所有值都會被加密。若要對內容的多重值進行解密,請按一下來清除該內容第一個值的加密勾選框,然後在驗證對話框中輸入一個新的值。如果輸入值符合,所有多重值都會被解密。
請參閱在標準內容附錄中所找到的更新方法說明。
使用「連接器配置程式」中支援的商業物件標籤,指定此連接器將使用的商業物件。您必須同時指定通用商業物件和特定應用程式專用的商業物件, 而且必須指定商業物件之間的對映關係。
若要指定連接器支援的商業物件定義,或變更現有商業物件定義的支援設定,請按一下支援的商業物件標籤並使用下列欄位。
若要使用「系統管理程式」來指定連接器支援的商業物件定義,請執行:
若要從支援的清單中刪除商業物件:
從支援的清單中刪除商業物件會變更連接器定義,並使刪除的商業物件無法用於此連接器的這個實作中。 它並不會影響連接器的程式碼,也不會從「系統管理程式」中移除商業物件定義本身。
如果商業物件有「代理程式支援」,這表示系統將會嘗試使用該商業物件,透過連接器代理程式傳遞資料給應用程式。
一般而言,連接器的特定應用程式商業物件是受到連接器代理程式的支援,但通用商業物件不受其支援。
若要指示商業物件是受到連接器代理程式的支援,請勾選代理程式支援方框。「連接器配置程式」視窗不會驗證您的「代理程式支援」選項。
連接器的最大交易層次就是連接器支援的最高交易層次。
對大部份連接器而言,最佳嘗試是唯一的可能選擇。
您必須重新啟動伺服器才能使交易層次的變更生效。
如果您是在獨立式的模式作業 (而非連接到系統管理程式),必須以手動方式輸入商業物件名稱。
如果執行「系統管理程式」,則您可以在支援的商業物件標籤的商業物件名稱欄位下,選取空方框。會出現組合框, 並列出連接器所屬之「整合元件程式庫」專案中可用的商業物件。請在該清單中選取想要的商業物件。
訊息集 ID 為 WebSphere Business Integration Message Broker 5.0 的選用欄位,且 (若提供) 無需是唯一的。不過,對於 WebSphere MQ Integrator 及 Integrator Broker 2.1,您必須提供唯一的 ID。
當選取 WebSphere Application Server 做為您的分配管理系統類型,則「連接器配置程式」不需要訊息集 ID。只有在支援商業物件時,支援的商業物件標籤才會顯示出商業物件名稱欄位。
如果您是在獨立式的模式作業 (而非連接到系統管理程式),必須以手動方式輸入商業物件名稱。
如果執行「系統管理程式」,您可以在「支援的商業物件」標籤中的「商業物件名稱」欄位下,選取空對話框。組合框會出現,列出連接器所屬「整合元件程式庫」專案中可用的商業物件。請在此清單中選取想要的商業物件。
每一個連接器皆支援目前在 WebSphere InterChange Server 作用中的商業物件定義及其相關對映的清單。當您選取相關對映標籤時便會顯示此清單。
商業物件清單包含代理程式支援的特定應用程式商業物件,和控制程式傳至訂閱協同作業的對應通用物件。 對映關聯可決定使用哪一種對映來將特定應用程式商業物件轉換成通用商業物件,或將通用商業物件轉換成特定應用程式商業物件。
如果您使用一些專門為特定來源和目標商業物件來定義的對映,則當您開啟顯示畫面時, 這些對映已經與其適當的商業物件相關聯,您不需要 (或不可以) 變更它們。
如果支援的商業物件可使用多個對映,您必須明確地連結該商業物件與其應使用的對映。
相關對映標籤顯示下列欄位:
這些商業物件是指支援的商業物件標籤中所指出由此連接器支援的商業物件。 如果您在「支援的商業物件」標籤下指定其他的商業物件,則在「連接器配置程式」視窗的檔案功能表中選擇儲存至專案來儲存變更之後,這些指定的商業物件將反映到此清單中。
此顯示畫面顯示所有已安裝到系統中來搭配連接器受支援商業物件使用的對映。 在商業物件名稱顯示畫面中,每一個對映的來源商業物件會在對映名稱左邊顯示。
在某些情形下,您需要明確地連結相關對映。
唯有在特定支援的商業物件有多個對映時,才需要明確連結。當 ICS 啟動時, 它會嘗試自動將某個對映連結到每個連接器的每一個受支援商業物件。如果不止一個對映使用相同商業物件作為它的輸入,則伺服器會嘗試尋找和連結本身是其他對映超集的一個對映。
如果沒有對映的超集, 則伺服器無法將商業物件連結到單一對映,所以您必須明確地設定連結。
若要明確地連結對映:
資源標籤可讓您設定值,來決定連接器代理程式是否使用連接器代理程式平行處理方式來同時處理多重程序,以及決定其處理範圍。
並非所有連接器都支援此項功能。如果您是使用 Java 設計成多執行緒的連接器代理程式,通常不建議使用此功能,因為使用多執行緒的通常比使用多重程序更有效率。
傳訊標籤可讓您配置傳訊內容。唯有在您將 MQ 設為 DeliveryTransport 標準內容的值且將 ICS 設為分配管理系統類型時,才能使用傳訊內容。這些內容將影響您連接器使用佇列的方式。
在驗證傳訊佇列之前,您必須:
若要驗證佇列,請使用「傳訊」標籤上「傳訊類型」與「主機名稱」欄位右方的「驗證」按鈕。
可使用「連接器配置程式」中的安全標籤,設定訊息的各種私密性層次。 您只能在 DeliveryTransport 內容設定為 JMS 時使用這個功能。
依預設,「私密性」為關閉。請勾選私密性框以啟用。
金鑰儲存庫目標系統絕對路徑名稱為:
<ProductDir>\connectors\security\<connectorname>.jks
opt/IBM/WebSphereAdapters/connectors/security/<connectorname>.jks
此路徑及檔案必須位在規劃啟動連接器的系統,也就是目標系統。
只有在目標系統為目前正在執行的系統時,才可以使用右方的「瀏覽」按鈕。除非啟用私密性以及功能表列中的目標系統設定為 Windows,否則它會呈現灰色。
訊息私密性層次可以如下設定三種訊息種類 (所有訊息、所有管理訊息及所有商業物件訊息):
與預設值不同:使用這個選項以對訊息種類故意設定為「無」私密性層次。
金鑰維護功能讓您產生、匯入、及匯出伺服器及配接器的公開金鑰。
可以將憑證匯入配接器金鑰儲存庫之前,您必須將其從伺服器金鑰儲存庫匯出。選取匯出配接器公開金鑰時, 「匯出配接器公開金鑰」對話框會出現。
選取匯入伺服器公開金鑰時, 「匯入伺服器公開金鑰」對話框會出現。
配接器存取控制功能只有在 DeliveryTransport 的值為 IDL 時啟用。依預設, 配接器將以訪客身分登入。如果使用訪客身分框未勾選, 將啟用配接器身分與配接器密碼欄位。
當開啟連接器配置檔或連接器定義檔時,「連接器配置程式」會使用該檔案的日誌記載和追蹤值作為預設值。您可以在「連接器配置程式」中變更這些值。
若要變更日誌記載和追蹤值:
將日誌記載或追蹤訊息寫入 STDOUT 顯示畫面。
將日誌記載或追蹤訊息寫入指定的檔案。若要指定檔案,請按一下目錄按鈕 (省略符號)、導覽至偏好的位置、 提供檔案名稱,然後按一下儲存。日誌記載或追蹤訊息會被寫入您指定的檔案和位置。
唯有當您對 DeliveryTransport 指定了 JMS 的值並對 ContainerManagedEvents 指定了 JMS 的值,資料處理常式區段才可用於配置。並非所有的配接器都使用資料處理常式。
有關這些內容使用的值,請參閱「附錄 A. 標準內容」中 ContainerManagedEvents 下的說明。如需其他詳細資料,請參閱 Connector Development Guide for C++ 或 Connector Development Guide for Java。