第 1 章 Service Registry 3 2005Q4 版本說明

本文件提供有關 Service Registry 3 2005Q4 的以下資訊。

• Service Registry 3 2005Q4 的新增功能

• 即將不再支援的功能

• 已知問題和錯誤

• 修補程式和所需的韌體層級

• Service Registry 3 2005Q4 文件

• 本土化問題

• 文件問題

Service Registry 3 2005Q4 的新增功能

本小節介紹 Service Registry 3 2005Q4 的新功能、功能性以及所支援的產品。

為殘障人士提供的無障礙功能

欲獲得此媒體發佈以來已發行的無障礙功能，請向 Sun 索取依據美國「Section 508」法規進行產品評估所得之結果文件，以便決定最適合佈署無障礙功能解決方案的版本。以下網址將提供應用程式的更新版本：http://sun.com/software/javaenterprisesystem/get.html。如需有關 Sun 在無障礙功能方面之成果的資訊，請至 http://sun.com/access。

實作特定的 API

Service Registry 包含 Java API for XML Registries (JAXR) 規格 1.0 版本的實作。編寫 JAXR 1.0 是為了支援 UDDI 和 ebXML Registry 2.0 規格。Service Registry 中的 JAXR 實作包含對 JAXR 1.0 的非標準延伸。這些 API 延伸會用於 JAXR 規格的將來版本，以做為未來 JAXR 標準的補充。

這些 API 延伸在將來的 Service Registry 發行版本中會發生變更。在將來的 Service Registry 發行版本中，Sun 將盡力維護這些 API 的向下相容性。在某些情況下，向下相容性可能是無法實現。建議決定使用這些 API 延伸的用戶瞭解這些延伸可能會在將來發行的 Service Registry JAXR 提供者中發生變更。

即將不再支援的功能

使用者註冊機制

此 Service Registry 發行版本依賴其自己的使用者管理和認證機制。計劃在將來的發行版本中將 Registry 更新基於 SAML 的機制 (如 ebXML Registry 標準中所指定，此元件是該標準的實作)，並使用 Access Manager 在該發行版本及以後的發行版本中進行使用者管理和認證。

在此發行版本中，Service Registry 用戶使用 Service Registry 維護其已註冊的使用者資訊。在以後的發行版本中，用戶將使用 Access Manager 維護此資訊。升級至這些新版 Service Registry 的用戶需要將其使用者資訊遷移至 Access Manager，以維護在已註冊使用者和 Registry 內容之間建立的連線 (例如稽核記錄)。Sun 將提供遷移工具以使此轉換更加方便。

已在此發行版本中修正的錯誤

下表說明測試時報告的錯誤以及已在 Service Registry 3 2005Q4 中修正的錯誤。

表 1–1 已在此發行版本中修正的錯誤

錯誤編號	說明
6253534	[詳細資訊面板] 快顯式視窗錯誤運作 (Web 主控台)
6254054	[槽] 快顯式面板重複 (Web 主控台)
6262387	Web 主控台效能低下
6268023	增加子組織實際會將組織增加至其自身 (Web 主控台)
6268025	SpecificationLink 的 [詳細資訊面板] 缺少 [用法參數] 欄位 (Web 主控台)
6268029	ClassificationScheme [詳細資訊面板] 從不顯示任何子概念 (Web 主控台)
6268048	將子概念增加至 ClassificationScheme 會導致錯誤 (Web 主控台)
6268163、6288713	Web 主控台中的文件連結中斷
6268961	AuditableEvent.getRegistryObject 傳回 AuditableEvent 物件 (JAXR 提供者)
6269991	建立新的 ExtrinsicObject 時顯示錯誤的樹狀結構，無法選取物件類型 (Web 主控台)
6272143	部署至 Application Server 時 JAXR RA 報告錯誤
6272183、6277552	多餘的 Service Registry3 安裝後配置步驟
6273999	重複元件 ID 異常
6276299、6277679	[上傳檔案] 視窗在使用者註冊精靈中掛機 (Web 主控台)
6276674	標籤包含重複的 X (Web 主控台)
6276701	按一下 [連絡人詳細資訊] 會丟出異常 (Web 主控台)
6277675	對於「產生鍵對並下載 PKCS12 金鑰儲存」選項，使用者註冊失敗 (Web 主控台)
6278540	使用者執行禁止的動作時缺少錯誤訊息 (Web 主控台)
6279674	將儲存庫項目增加至儲存的 ExtrinsicObject 時發生錯誤 (Web 主控台)
6280492	Web 主控台需要單獨的 [儲存] 和 [套用] 按鈕 (Web 主控台)
6281089	反覆式查詢重複先前的結果 (JAXR 提供者)
6281292	Admin Tool 需要 UUID 而不是 URN (Administration Tool)
6284357	與 ExtrinsicObject 物件相關的 Web 主控台錯誤

在測試時報告的以下 JAXR 提供者錯誤優先層級已降級：

• 6245755：未實作 PostalAddress Type 屬性

• 6248218：定版的 RegistryPackage 遺失其內容

• 6248293：Classification 已增加至舊版本和新版本的物件

• 6248418：增加 Classification、ExternalIdentifier 或 Slot 對刪除 ExternalLink 有影響

已知問題和錯誤

以下已知問題和錯誤會影響 Service Registry 3 2005Q4 發行版本的作業。

無法為 Organization 物件擷取 EmailAddress 物件 (6290339)

問題摘要：JAXR 提供者無法從 Organization 物件中擷取電子郵件地址。如果您發佈具有電子郵件地址的 Organization 物件，則發佈顯示為成功，但 OrganizationImpl.getEmailAddresses 方法不傳回任何結果。此問題還會導致 Web 主控台中顯示空白。

執行發佈作業時，ClassificationScheme 顯示保持不變 (6297023)

問題摘要：在 Web 主控台中，如果您發佈涉及從 ClassificationScheme 選擇概念的物件 (例如 ExtrinsicObject 或 ExternalLink)，則下次您發佈其他物件時，ClassificationScheme 視窗會在同一位置開啟，即使第二個物件屬於其他物件類型也會如此。

同樣，如果您依分類執行搜尋，執行關閉搜尋表單的其他作業 (例如發佈作業)，然後再次開啟該搜尋表單，則 ClassificationScheme 顯示與關閉搜尋表單時的顯示相同。

嘗試在 Organization 物件之間建立參照導致錯誤 (6298946)

問題摘要：在 Web 主控台中，如果您為兩個 Organization 物件選取 [挑選] 核取方塊並按一下 [相關]，然後按一下 [儲存] 以儲存預設關係 (物件參照)，則 Web 主控台會報告錯誤，但沒有詳細錯誤訊息。伺服器記錄中會顯示堆疊追蹤。

將新的儲存庫項目增加至 Extrinsic 物件時內容版本註釋遺失 (6301689)

問題摘要：在 Web 主控台中，如果您發佈無儲存庫項目的 ExtrinsicObject，然後增加儲存庫項目並為該儲存庫項目提供內容版本註釋，則您在儲存變更的 ExtrinsicObject 後搜尋項目時，該內容版本註釋不會出現。

重複使用者名稱導致含糊而不清楚的錯誤訊息 (6303812)

問題摘要：在 Web 主控台中，如果使用者嘗試使用已產生的憑證建立使用者帳號，並指定該伺服器已知的別名，則以下錯誤會顯示在 Web 主控台的 [步驟 3] 頁面上：

發生了一個錯誤。請查看伺服器記錄或連絡 Registry 支援。

解決方法：檢查伺服器記錄。根本原因掩藏在堆疊追蹤中：

Caused by: java.lang.Exception: Key pair not generated, alias name already 
exists

某些搜尋傳回非預期結果 (6312083)

問題摘要：在 Web 主控台中依名稱搜尋 Person 或 User 物件時，無法傳回資料庫中預先定義的任何使用者的相應 Person 或 User 物件，或定義了 PersonName (而不是 Name) 的任何 Person 或 User。此外，搜尋名稱中包含特定數目字元的物件 (例如，使用搜尋字串 "__" 尋找兩個字元的名稱) 會傳回多個名稱中字元數目與指定字元數目不同的物件。

建立憑證辨別名稱時註冊精靈忽略必填值 (6312094)

問題摘要：在 Web 主控台中，當使用者註冊精靈為其產生的憑證建立辨別名稱 (DN) 時，會使用您在 [新使用者詳細資訊] 頁面上指定的某些可選值 (國家/地區、州或省以及城市)。然而，除了一個必填值之外，精靈會忽略您在 [使用者認證詳細資訊] 頁面上所有其他必填值。(使用的唯一值是 [名稱] 值。)

解決方法：若要在憑證 DN 中包含城市、州或省或國家/地區，除了要在 [使用者認證詳細資訊] 頁面上指定這些值，還要在 [新使用者詳細資訊] 頁面上指定這些值。

嘗試為 ExternalLink 和 ServiceBinding 物件設定 URI 失敗 (6312531)

問題摘要：如果管理員在配置 Service Registry 之後忘記了為部署 Registry 的 Application Server 實例之 Java^TM Virtual Machine (JVM) 設定代理主機和連接埠，則 Web 主控台使用者無法為 ExternalLink 物件指定外部 URI 或為 ServiceBinding 物件指定存取 URI。錯誤訊息報告 URI 格式無效，但實際上是正確的。

解決方法：按照「Service Registry 3 2005Q4 管理指南」中的「允許存取外部網站」所述設定代理主機和連接埠。

重新安裝後，Service Registry 配置失敗 (6313327)

問題摘要：如果您使用 Java Enterprise System 解除安裝程式解除安裝 Service Registry，然後重新安裝並執行安裝後配置，則配置程序檔會因發生以下錯誤而失敗：

Domain registry already exists. Please specify a different domain.

問題在於解除安裝程式不會停止或移除 Registry 的 Application Server 網域。必須手動執行此作業。

解決方法：解除安裝 Service Registry 之前，停止 Registry 的 Application Server 網域，然後刪除該網域。請參閱「Service Registry 3 2005Q4 管理指南」中的「重新安裝 Service Registry」，以獲得詳細資訊。

管理工具在使用 [-alias] 選項時失敗 (6313791)

問題摘要：如果您嘗試使用 Admin Tool 執行需要管理員權限的作業，則會發生堆疊追蹤和 NoClassDefFoundError。該錯誤的原因是 Admin Tool JAR 檔案的清單類別路徑中遺失某個檔案。

解決方法：按照「Service Registry 3 2005Q4 管理指南」中的「允許使用 Administration Tool」說明進行操作。

建立具有無效概念的 ExtrinsicObject 或 ExternalLink 後發生錯誤 (6318002)

問題摘要：在 Web 主控台中，如果您建立 ExtrinsicObject 時選取的概念並非 ExtrinsicObject 的子概念，則建立顯示為成功，但實際已發生錯誤。如果您建立 ExternalLink 時選取的概念並非 ExternalLink 的子概念，則會發生相同錯誤。

該錯誤在伺服器記錄中顯示為 NullPointerException。

如果該概念是 RegistryObject 下的其他子概念，則主要的影響是搜尋新物件時找不到該物件。如果該概念在 ClassificationScheme (而不是 ObjectType) 之下，則會毀壞資料庫。重新啟動伺服器時發生執行階段錯誤 (InvocationTargetException)。

物件類型概念必須是 ExtrinsicObject 或 ExternalLink 概念中的子概念，但 Web 主控台不強制此需求。

解決方法：使用 Admin Tool 尋找使用錯誤概念的某個或多個物件。使用 select 指令尋找物件，使用 rm 刪除物件。此作業的步驟如下：

1. 按照「Service Registry 3 2005Q4 管理指南」中的「停止並重新啟動 Registry 的 Application Server 網域」所述重新啟動 Service Registry。

2. 按照「Service Registry 3 2005Q4 管理指南」中的「啟動 Admin Tool」所述，做為 Registry 管理員或已毀壞物件的所有者啟動 Admin Tool。

3. 移至資料庫中的頂層位置：

   admin> cd /

4. 使用 select 指令列出要移除的物件。如果您做為 Registry 管理員啟動此工具，請使用以下指令 (全部在一行)：

   admin> select ro.* FROM RegistryObject ro, ClassificationNode cn WHERE ro.objectType = cn.id AND NOT ( cn.path = '/urn:oasis:names:tc:ebxml-regrep:classificationScheme:ObjectType/RegistryObject' or cn.path like '/urn:oasis:names:tc:ebxml-regrep:classificationScheme:ObjectType/RegistryObject/%' )

   如果您做為物件的所有者啟動此工具，請使用以下指令 (全部在一行)：

   admin> select ro.* FROM RegistryObject ro, ClassificationNode cn, AffectedObject ao, AuditableEvent ae WHERE ro.objectType = cn.id AND ae.user_ = $currentUser AND ao.id = ro.id AND ao.eventId = ae.id AND NOT ( cn.path = '/urn:oasis:names:tc:ebxml-regrep:classificationScheme:ObjectType/RegistryObject' or cn.path like '/urn:oasis:names:tc:ebxml-regrep:classificationScheme:ObjectType/RegistryObject/%' )

5. 使用 rm 指令刪除物件。指定要刪除之各物件的 URN。

   admin> rm urn1 urn2 ...

6. 再次執行 select 指令以驗證物件已不在 Registry 中。

刪除物件建立作業的 AuditableEvent 將導致異常 (6323057)

問題摘要：如果您刪除 AuditableEvent 並且其 [受影響的物件] 清單中包含您所擁有的一個或多個物件，則會毀壞受影響物件的稽核記錄。尤其是，如果刪除您自己的 User 物件之 [已建立] 事件，則會發生嚴重問題。例如，刪除此事件後，只要您執行 FindAllMyObjects 搜尋便會發生執行階段異常。

嘗試在按一下 [套用] 按鈕之前檢視儲存庫項目導致發生錯誤 (6324423)

問題摘要：在 Web 主控台中，如果建立 ExtrinsicObject 並增加儲存庫項目，則在您按一下 [儲存] 或 [套用] 按鈕之前，上傳檔案時 [檢視儲存庫項目內容] 連結即會變為可使用的狀態。如果您在按一下 [套用] 之前按一下該連結，螢幕上將顯示錯誤 404 訊息。該連結在成為有效連結之前不應變為可使用的狀態。

解決方法：請勿嘗試在按一下 [套用] 之前檢視儲存庫項目。

已固定的物件在後續搜索中重複出現 (6324437)

問題摘要：如果您使用 Web 主控台的 [固定] 功能將物件固定到位，則在執行其他搜尋時，該物件會多次顯示在 [搜尋結果] 區域。

解決方法：透過按一下 [登出] 按鈕或 [結束階段作業] 按鈕來結束目前的階段作業。啟動新的階段作業後，搜尋會傳回正確的結果。

檔案總管顯示不正確的資料 (6325095)

問題摘要：使用 [管理] 功能表檢視 ClassificationScheme 概念時，尾節點 XML 和 Registry 會顯示具有兩個概念，而不是一個。在這兩種情況下，顯示會包含緊接在正確節點 (分別為 XMLSchema 和 RegistryPackage) 之後的節點。

重新安裝 Service Registry 會刪除現有儲存庫資料庫 (6329272)

問題摘要：用於重新安裝 Service Registry 的 ant install 指令還會刪除並重新安裝儲存庫資料庫。如果管理員未提前備份該資料庫，則會導致無法挽救的使用者資料遺失。

管理員應按照「Service Registry 3 2005Q4 管理指南」中的「重新安裝 Service Registry」的說明進行操作：在重新安裝之前備份資料庫。

伺服器重新啟動後立即登入導致異常 (6330540)

問題摘要：如果使用者在管理員重新啟動 Service Registry 之後立即存取 Web 主控台，並且執行的第一個動作是登入，則當使用者嘗試搜尋時會發生異常。異常如下：

An error has occurred. See below for details:
Could not initialize the Search panel. java.lang.NullPointerException Check
the server log for more details or contact your Registry Administrator.

解決方法：如果您在伺服器重新啟動之後立即存取 Web 主控台，請先執行搜尋，然後再登入。

無法將 ClassificationNode 增加至現有節點 (6331538)

問題摘要：如果您使用 Web 主控台將新概念 (ClassificationNode) 增加至現有的 ClassificationScheme 或您尚未建立的 ClassificationNode，則螢幕上將顯示錯誤表明目前使用者不具有增加新節點的權限。

解決方法：管理員具有將 ClassificationNode 增加至任何 ClassificationScheme 或 ClassificationNode 的權限。按照「Service Registry 3 2005Q4 管理指南」中的「建立管理員」的說明使自己成為管理員並增加概念，或要求您的 Service Registry 安裝管理員增加概念。

修補程式和所需的韌體層級

無。

Service Registry 3 2005Q4 文件

Service Registry 文件集可從 http://docs.sun.com/app/docs/coll/1314.1 和 http://docs.sun.com/app/docs/coll/1413.1 取得。若要瞭解 Service Registry，請參閱下表中列出的書籍。

表 1–2 Service Registry 文件

文件標題	內容
「Service Registry 3 2005Q4 版本說明」	含有有關 Service Registry 的最新資訊 (包含已知問題)。
「Service Registry 3 2005Q4 管理指南」	說明在安裝後如何配置 Service Registry，以及如何使用與 Registry 一起提供的管理工具，還說明如何執行其他管理作業。
「Service Registry 3 2005Q4 使用者指南」	說明如何使用 Service Registry Web 主控台搜尋 Service Registry 和向其發佈資料。
「Service Registry 3 2005Q4 Developer’s Guide」	說明如何使用 Java API for XML Registries (JAXR) 搜尋 Service Registry 和向其發佈資料。

本土化問題

Service Registry 3 2005Q4 中的以下錯誤與本土化相關。

Web 主控台中缺少本土化的字串 (6276676)

問題摘要：在 Web 主控台中，某些應本土化的字串以英文顯示。包括 [建立新的 Registry 物件] 頁面中的標籤；[自訂] 頁面中支援語言的清單；[歡迎] 頁面、版權文字和標題區域；電話號碼和電子郵件地址類型的下拉式清單以及記錄訊息。另外，切換瀏覽器語言環境並重設語言後，某些標籤仍以先前的語言顯示。

Extrinsic 物件不支援多位元組檔案名稱 (6298088)

問題摘要：在 Web 主控台中，當您為 ExtrinsicObject 選擇具有多位元組名稱的檔案做為儲存庫項目時，會毀壞檔案名稱，且無法檢視該檔案。

UDDI 資源束未本土化 (6305138)

問題摘要：Service Registry 的 UDDI 介面資源束尚未本土化。此介面的錯誤訊息僅以英文顯示。

如果 Application Server 網域使用非英文語言環境，則 Registry 無法使用英文語言環境 (6305210)

問題摘要：如果使用非英文語言環境啟動 Service Registry 的 Application Server 網域，則無法將 Web 主控台預設語言變更為英文，即使在您變更 Web 瀏覽器中的預設語言環境時也不可以。

解決方法：使用 Application Server 網域的管理主控台變更語言環境。

1. 開啟管理主控台；請參閱「Service Registry 3 2005Q4 管理指南」中的「使用 Application Server Admin Console」，以獲得相關說明。

2. 展開獨立實例節點，然後按一下 [伺服器] (管理伺服器)。

3. 按一下 [進階] 標籤。

4. 按一下 [網域屬性] 標籤。

5. 在 [語言環境] 欄位中，鍵入 en。

6. 按一下 [儲存]。

線上說明字串的法語翻譯不正確 (6313372)

問題摘要：在 Web 主控台中，如果使用法語語言環境，則 [Registry 物件] 區域右上角的 [說明] 連結會顯示「Objets du registre Aide」，應該顯示「Aide Objets du Registre」或「Aide pour les Objets du Registre」。

在非預設語言環境中建立的物件沒有名稱 (6316300)

問題摘要：如果預設語言環境不同於您的語言環境，並且使用 Web 主控台建立物件，則當您按一下 [套用] 時，物件名稱會顯示為 null，即使您已在該物件的 [名稱] 欄位中鍵入了值。

Web 主控台中包含非英文語言環境的未本土化字串 (6317212、6317242、6317489、6317568、6322668、6325023)

問題摘要：Web 主控台中的大量字串尚未本土化為非英文語言環境之外的語言環境或是本土化翻譯錯誤。

Admin Tool 使用 -locale 選項啟動不正確 (6325116)

問題摘要：如果您使用 -locale 選項啟動 Admin Tool 以指定非英文語言環境，則訊息以英文而非指定的語言環境顯示。

文件問題

以下 Service Registry 3 2005Q4 中的錯誤與文件相關。

依名稱查詢對每個標準 ClassificationScheme 都擷取多個副本 (6307262)

問題摘要：「開發者指南」中的程式範例 JAXRGetCanonicalSchemes.java 應該從 Registry 中擷取 18 種標準分類方案及其概念。但此程式實際上對每種分類方案擷取 8 個副本，總計為 144 個。此問題應是本土化的問題，因為程式會擷取每個支援的語言環境的分類方案之副本。