入口網站工具 - 版本注意事項


1.0 支援的軟體和規格
2.0 限制
   2.1 JSR 168 Portlet 應該有 ID 屬性
   2.2 關聯式記錄和入口網站 5.1 版
   2.3 協同作業 Portlet 限制
   2.4 person 標示限制
   2.5 EIS 工具限制
   2.6 在 WebSphere Portal 伺服器中配置 SAP JCo
   2.7 RedHat Enterprise Linux 3.0 中的協同作業 Portlet 限制
   2.8 在「問題」視圖中顯示中斷鏈結的警告訊息
   2.9 Portal Designer 中的標記支援
   2.10 無法設定內部 URL
   2.11 不可選取管理主題作為預設值
3.0 已知的問題
   3.1 (建立 Portlet)在現有的 IBM API Portlet 專案中建立 Portlet 時,發生 Servlet 參照不正確的錯誤
   3.2(除錯和測試 Portlet)無法啟動 WebSphere Portal 測試環境
   3.3 (Portlet 部署描述子)利用 JSR 168 Portlet 部署描述子編輯器進行編輯
   3.4 使用 <f:subview> 來取代 <f:view> 時,Faces Portlet 無法正確運作
   3.5 在最大化的 Faces Portlet 中,Click-to-Action 無法運作
   3.6(匯入、匯出和部署)無法建立目標為 "localhost" 的匯入、匯出和部署伺服器
   3.7(匯入入口網站)取消匯入作業會使新的入口網站專案無法使用
   3.8(匯入入口網站)WSRP 相關錯誤會顯示在匯入的入口網站專案的「問題」視圖中
   3.9(自訂入口網站)無法開啟匯入之入口網站專案中的 license.html 和 privacy.html 檔
   3.10 Rational Software Architect 新聞群組(討論區)

1.0 支援的軟體和規格

入口網站專案支援 WebSphere Portal 5.0.2.2 版。

2.0 限制

2.1 JSR 168 Portlet 應該有 ID 屬性

當您利用新建 Portlet 精靈來建立 JSR 168 Portlet 時,Rational Developer 會自動指派一個 ID 屬性。ID 屬性應該併入 portlet.xml 檔的 <portlet-app/> 元素中,供伺服器唯一識別 Portlet。 (這個屬性對應於 IBM Portlet API Portlet 所用的 UID 屬性。)

如果 JSR 168 Portlet 的 portlet.xml <portlet-app/> 元素沒有 ID 屬性,請在 Portlet 匯入工作區之後,緊接著新增 ID 屬性及其唯一值。 如果要新增 ID 屬性,請開啟 Portlet 部署描述子,再利用「程式碼」視圖來編輯。 將 JSR 168 Portlet 部署至 Portal Server 之後,或在入口網站專案中使用 JSR 168 Portlet 專案之後,請勿變更 ID 值。

沒有 ID 屬性的 JSR 168 Portlet 會有以下限制:

2.2 關聯式記錄和入口網站 5.1 版

當執行包含關聯式記錄清單或關聯式記錄 (SDO) 的 Portlet 時,伺服器日誌可能會出現下列錯誤:

[04/10/07 17:57:27:172 JST] 4942fbd0 SystemOut O java.lang.LinkageError: org/eclipse/emf/ecore/EClass 類別違反載入器限制:母項和子項載入器的定義不符
您可以忽略這個錯誤。

2.3 協同作業 Portlet 限制

當您建立協同作業來源 Portlet 時,您必須手動將 actionNameParameter 和 name 屬性新增至 WSDL 檔中。比方說:

<portlet:action type="standard" name="myActionName" actionNameParameter="ACTION_NAME"/>

在這個版本中,入口網站工具並不會在 WSDL 檔中產生 caption 屬性。當您使用電話線與 WebSphere Portal 5.1 版連接時, 您需要手動在 WSDL 檔中指定 caption 屬性,並在資源檔中指定 caption 的值。例如:

<portlet:param name="orderId" partname="order_id" caption="order.id" />
如果需要詳細資訊,請參閱 WebSphere Portal 資訊中心中的「開發協同作業的 Portlet」主題。

2.4 person 標示限制

當您在 WebSphere Portal 5.1 版上的 IBM API 基本 Portlet 中使用 person 標示時,您可以利用下列語法來指定:

<pa:person value="CN=John Smith,OU=SALES,O=ACME" valueType="LDAPDN" displayName="John Smith" />

當您在 WebSphere Portal 5.1 版上的 IBM API Faces Portlet 中使用 person 標示時,您可以利用下列語法來指定:

<pa:person value="CN=John Smith,OU=SALES,O=ACME" />John Smith<pa:person>

JSR 168 Portlet 不支援 person 標示。

2.5 EIS 工具限制

SAP BAPI 和 RFM SDO 精靈限制:如果您在過了「主要和前置/後置函數」頁面之後,試圖在挑選不同主要函數之後返回這個頁面,「前置/後置對映」頁面無法正確運作。

解決辦法:如果您需要新的設定前置和後置函數對映,您必須重新啟動這個精靈。

2.6 在 WebSphere Portal 伺服器中配置 SAP JCo

在測試包含 Portal Server 中的 SAP SDO 的 Portlet 之前,您必須先在 WebSphere Portal 5.1 伺服器中配置 SAP JCo 配接器:

  1. 從 SAP Service Marketplace 的 SAP 下載 SAP 的 JCo 配接器目錄。
  2. 下載軟體 > 下載 > SAP Connector > SAP Java Connector。 根據您的作業系統,選取下載適當的檔案。 請將 ZIP 檔的內容解壓縮在本端目錄中。
  3. 依照您的作業系統來完成下列步驟。 附註:<wps_51> 指 WebSphere Portal 5.1 伺服器的安裝目錄;比方說,C:\WebSphere\PortalServer51TE。
      Windows:
    1. 將 sapjco.jar 和 sapjcorfc.dll 複製到 <wps_51>\shared\app。
    2. 將 librfc32.dll 複製到 c:\windows\system32\。
    3. 您必須重新啟動 WebSphere Portal 5.1 伺服器。

      Linux:
    1. 將 sapjco.jar 和 libsapjcorfc.so 複製到 <wps_51>\shared\app。
    2. 將包含 librfccm.so 檔的資料夾新增至 LD_LIBRARY_PATH 環境變數中。
    3. 您必須重新啟動 WebSphere Portal 5.1 伺服器。

2.7 RedHat Enterprise Linux 3.0 中的協同作業 Portlet 限制

Rational Developer 內部瀏覽器不支援 RedHat Enterprise Linux 3.0 使用協同作業 Portlet。 如果您必須在 RedHat Enterprise Linux 3.0 中使用協同作業 Portlet,請使用 Netscape Communicator。

如果要利用 Netscape Communicator 作為預設瀏覽器,請配置 Rational Developer 來使用外部瀏覽器。 如果要執行這個動作,請從功能表列中,選取視窗 > 喜好設定。 在左側展開網際網路節點,選取 Web 瀏覽器。 在主要區段中,選取內部 Web 瀏覽器以外的任何瀏覽器。

如果需要詳細資訊,請參閱 WebSphere Portal 資訊中心中「協同作業 Portlet 的已知問題和限制」。

2.8 在「問題」視圖中顯示中斷鏈結的警告訊息

當利用「新建入口網站專案」精靈來建立入口網站專案時,或從「範例展示區」中匯入範例入口網站專案時,「問題」視圖會出現中斷鏈結的警告訊息。

2.9 Portal Designer 中的標記支援

在這個版本的 Rational Developer 中,Portal Designer 只會將 HTML、cHTML 和 WML 顯示為支援的標記。 如果您匯入的專案中,指定了其他支援的頁面或標籤標記,則標記會維持在 Rational Developer 中;不過,您不能變更這些標記,且標記不會顯示在「內容」視圖中。

2.10 無法設定內部 URL

在這個版本的 Rational Developer 中,您只能在 Portal Designer 中設定外部 URL。 如果 Portal Server 有內部 URL,且內部 URL 會維持在匯入的專案內,但您不能加以改變。 您只能將內部 URL 重新部署到原始 Portal Server 中。

2.11 不可選取管理主題作為預設值

在這個版本的 Portal Designer 中,Admin 和 AdminLeftNavigation 主題會顯示在「概要」視圖中。不過,這些主題只能用於入口網站的管理,不應該選為入口網站專案的預設主題。

3.0 已知的問題

3.1 (建立 Portlet)在現有的 IBM API Portlet 專案中建立 Portlet 時,發生 Servlet 參照不正確的錯誤

問題:當您在現有的 IBM API Portlet 專案中建立新的 Portlet 時, 如果您在「事件處理」頁面上選取新增 Click-to-Action 傳送端 Portlet 範例新增訊息傳送端 Portlet 範例選項, 則會顯示下列錯誤訊息:

解決辦法:您必須利用下列方法重新開啟 Portlet 專案:

  1. 用滑鼠右鍵按一下 Portlet 專案,然後從蹦現功能表中選取關閉專案
  2. 用滑鼠右鍵按一下 Portlet 專案,然後從蹦現功能表中選取開啟專案
  3. 用滑鼠右鍵按一下 Portlet 專案,然後從蹦現功能表中選取執行驗證

3.2 (除錯和測試 Portlet)無法啟動 WebSphere Portal 測試環境

問題:WebSphere Portal 測試環境無法啟動。

解決辦法:

3.3 (Portlet 部署描述子)利用 JSR 168 Portlet 部署描述子編輯器進行編輯

問題:在 JSR 168 Portlet 部署描述子中,您無法在 Portlet 集合區中編輯 Portlet 名稱。

解決辦法:在「程式碼」頁面中,編輯 Portlet 名稱。

3.4 使用 <f:subview> 來取代 <f:view> 時,Faces Portlet 無法正確運作。

問題:如果您從精靈產生的 Faces JSP 檔中刪除 <f:view> 標示,再將 Faces 元件插入檔案中,這時會插入 <f:subview> 標示,而不是 <f:view> 標示。 當使用這類型的 JSP 檔時,Faces Portlet 無法正確執行。 在伺服器端的處理程序中,會失去瀏覽器的輸入。

問題:如果要修正這個問題,請將 JSP 檔中的 <f:subview> 標示改成 <f:view> 標示。

3.5 在最大化的 Faces Portlet 中,Click-to-Action 無法運作

如果您將包含 Click-to-Action 標示的 Faces Portlet 最大化,就不會顯示 Portlet 的內容。

3.6 (匯入、匯出和部署)無法建立目標為 "localhost" 的匯入、匯出和部署伺服器

問題:如果未安裝入口網站 UTE,您不能建立以 "localhost" 或 "127.0.0.1" 為目標的入口網站匯入、匯出和部署伺服器。

解決辦法:如果您需要建立這種伺服器,請用機器的完整名稱來取代 "localhost"(例如:myhost.mydomain)。

3.7 (匯入入口網站)取消匯入作業會使新的入口網站專案無法使用

問題:如果您在新入口網站專案匯入作業完成之前取消匯入,並不會移除不完整的入口網站專案,且會變成無法使用。

解決辦法:您必須利用「匯入入口網站」精靈中的在改寫時刪除選項來重新匯入入口網站配置和檔案。

3.8 (匯入入口網站)WSRP 相關錯誤會顯示在匯入的入口網站專案的「問題」視圖中

問題:當從 WebSphere Portal 中,將現有入口網站匯入 Rational Developer 時,在針對所匯入之入口站網站專案的「問題」視圖中,會出現 WSRP 的相關驗證錯誤。

解決辦法:請先將 APAR PQ95638 套用在 WebSphere Portal 上,再匯入 Rational Developer。

3.9 (自訂入口網站)無法開啟匯入的入口網站專案中的 license.html 和 privacy.html 檔

問題:無法利用 Page Designer 來開啟已匯入之入口網站專案中的 license.html 或 privacy.html 檔,因為編碼不正確。

解決辦法:請將 APAR PQ93681 套用在 Portal Server 上,再從 Portal Server 中,重新匯入專案。

3.10 Rational Software Architect 新聞群組(討論區)

「新增 SDO 執行時期」會參照 Rational Software Architect 新聞群組。Rational Software Architect 支援網站 (www.ibm.com/software/awdtools/developer/application/support) 將更新為包含新聞群組的鏈結。

返回主 Readme 檔