入口網站專案支援 WebSphere Portal 5.0.2.2 版。
當您利用新建 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 會有以下限制:
- 如果您在入口網站專案中使用沒有 ID 屬性的 JSR 168 Portlet,就無法在測試環境中執行入口網站專案。
- 如果您將兩個或更多不含 ID 屬性的 JSR 168 Portlet 關聯於 WebSphere Portal 5.1 測試環境,測試環境會無法啟動。
- 將 JSR 168 Portlet 部署至 Portal Server 之後,或在入口網站專案中使用 JSR 168 Portlet 專案之後,便不應變更專案名稱。
當執行包含關聯式記錄清單或關聯式記錄 (SDO) 的 Portlet 時,伺服器日誌可能會出現下列錯誤:
[04/10/07 17:57:27:172 JST] 4942fbd0 SystemOut O java.lang.LinkageError: org/eclipse/emf/ecore/EClass 類別違反載入器限制:母項和子項載入器的定義不符您可以忽略這個錯誤。
當您建立協同作業來源 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」主題。附註:6.0.0.1 版已修正這個問題。
當您在 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 標示時,您可以利用下列語法來指定:
附註:6.0.0.1 版已修正這個問題。請利用上面所說明的相同語法來處理基本 Portlet。<pa:person value="CN=John Smith,OU=SALES,O=ACME" />John Smith<pa:person>
JSR 168 Portlet 不支援 Person 標示。
SAP BAPI 和 RFM SDO 精靈限制:如果您在過了主要和前置/後置函數頁面之後,試圖在挑選不同主要函數之後返回這個頁面,「前置/後置對映」頁面無法正確運作。
解決方案:如果您需要新的設定前置和後置函數對映,您必須重新啟動這個精靈。
附註:6.0.0.1 版已修正這個問題。
在測試包含 Portal Server 中的 SAP SDO 的 Portlet 之前,您必須先在 WebSphere Portal 5.1 伺服器中配置 SAP JCo 配接器:
- 從 SAP Service Marketplace 的 SAP 下載 SAP 的 JCo 配接器目錄。
- 按下載軟體 > 下載 > SAP Connector > SAP Java Connector。 根據您的作業系統,選取下載適當的檔案。 請將 ZIP 檔的內容解壓縮在本端目錄中。
- 依照您的作業系統來完成下列步驟。 附註:<wps_51> 指 WebSphere Portal 5.1 伺服器的安裝目錄;比方說,C:\WebSphere\PortalServer51TE。
Windows:
- 將 sapjco.jar 和 sapjcorfc.dll 複製到 <wps_51>\shared\app。
- 將 librfc32.dll 複製到 c:\windows\system32\。
- 您必須重新啟動 WebSphere Portal 5.1 伺服器。
Linux:
- 將 sapjco.jar 和 libsapjcorfc.so 複製到 <wps_51>\shared\app。
- 將包含 librfccm.so 檔的資料夾新增至 LD_LIBRARY_PATH 環境變數中。
- 您必須重新啟動 WebSphere Portal 5.1 伺服器。
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 的已知問題和限制」主題。
當利用「新建入口網站專案」精靈來建立入口網站專案時,或從「範例展示區」中匯入範例入口網站專案時,「問題」視圖會出現中斷鏈結的警告訊息。
在這個版本的 Rational Developer 中,Portal Designer 只會將 HTML、cHTML 和 WML 顯示為支援的標記。 如果您匯入的專案中,指定了其他支援的頁面或標籤標記,則標記會維持在 Rational Developer 中;不過,您不能變更這些標記,且標記不會顯示在「內容」視圖中。
在這個版本的 Rational Developer 中,您只能在 Portal Designer 中設定外部 URL。 如果 Portal Server 有內部 URL,且內部 URL 會維持在匯入的專案內,但您不能加以改變。 您只能將內部 URL 重新部署到原始 Portal Server 中。
附註:6.0.0.1 版已修正這個問題。
在這個版本的 Portal Designer 中,Admin 和 AdminLeftNavigation 主題會顯示在「概要」視圖中。不過,這些主題只能用於入口網站的管理,不應該選為入口網站專案的預設主題。
附註:6.0.0.1 版已修正這個問題。
問題:當您在現有的 IBM API Portlet 專案中建立新的 Portlet 時, 如果您在「事件處理」頁面上選取新增 Click-to-Action 傳送端 Portlet 範例或新增訊息傳送端 Portlet 範例選項, 則會顯示下列錯誤訊息:
- IWAL0008E Portlet 的 Servlet 參照不正確。(portlet.xml)
- CHKJ4014W: 類型 Servlet 名稱的項目是空的。(web.xml)
解決方案:您必須利用下列方法重新開啟 Portlet 專案:
- 用滑鼠右鍵按一下 Portlet 專案,然後從蹦現功能表中選取關閉專案。
- 用滑鼠右鍵按一下 Portlet 專案,然後從蹦現功能表中選取開啟專案。
- 用滑鼠右鍵按一下 Portlet 專案,然後從蹦現功能表中選取執行驗證。
附註:6.0.0.1 版已修正這個問題。
問題:WebSphere Portal 測試環境無法啟動。
解決方案:
- 驗證順利安裝:這個問題有可能是因為安裝期間的失敗所造成。 請檢查 WebSphere Portal 測試環境安裝期間的問題,再依照需要來補救。
- 消除太長的檔案名稱:伺服器會因為 Portlet 專案中的檔案名稱太長而無法啟動。 如果要解決這個問題,請縮短專案名稱、套件字首,和/或類別字首,使產生的檔案名稱長度成為可接受。 另外,您也可以將個別檔案名稱本身縮短至可接受的長度。 另外,如果利用預設目錄來作為工作區,使用目錄名稱長度較短的不同工作區也有效。 您可以啟動 Rational Developer 來指定工作區目錄,再變更所提供之對話框中的名稱。 如果指定工作區的對話框沒有出現,請移至命令提示字元,先輸入 Rational Developer 執行指令,再輸入 -data [workspace_name]。
問題:在 JSR 168 Portlet 部署描述子中,您無法在 Portlet 集合區中編輯 Portlet 名稱。
解決方案:在「程式碼」頁面中,編輯 Portlet 名稱。
問題:如果您從精靈產生的 Faces JSP 檔中刪除 <f:view> 標示,再將 Faces 元件插入檔案中,這時會插入 <f:subview> 標示,而不是 <f:view> 標示。 當使用這類型的 JSP 檔時,Faces Portlet 無法正確執行。 在伺服器端的處理程序中,會失去瀏覽器的輸入。
問題:如果要修正這個問題,請將 JSP 檔中的 <f:subview> 標示改成 <f:view> 標示。
如果您將包含 Click-to-Action 標示的 Faces Portlet 最大化,就不會顯示 Portlet 的內容。
附註:6.0.0.1 版已修正這個問題。
問題:如果未安裝入口網站 UTE,您不能建立目標為 "localhost" 或 "127.0.0.1" 的入口網站匯入、匯出和部署伺服器。
解決方案:如果您需要建立這種伺服器,請用機器的完整名稱來取代 "localhost"(如:myhost.mydomain)。
附註:6.0.0.1 版已修正這個問題。
問題:如果您在新入口網站專案匯入作業完成之前取消匯入,並不會移除不完整的入口網站專案,且會變成無法使用。
解決方案:您必須利用「匯入入口網站」精靈中的在改寫時刪除選項來重新匯入入口網站配置和檔案。
附註:6.0.0.1 版已修正這個問題。
問題:當從 WebSphere Portal 中,將現有入口網站匯入 Rational Developer 時,在針對所匯入之入口站網站專案的「問題」視圖中,會出現 WSRP 的相關驗證錯誤。
解決方案:請先將 APAR PQ95638 套用在 WebSphere Portal 上,再匯入 Rational Developer。
附註:已修正 WP5.1 的這個問題,但未修正 WP5.0 的這個問題。
問題:無法利用 Page Designer 來開啟已匯入之入口網站專案中的 license.html 或 privacy.html 檔,因為編碼不正確。
解決方案:請將 APAR PQ93681 套用在 Portal Server 上,再從 Portal Server 中,重新匯入專案。
附註:已修正 WP5.1 的這個問題,但未修正 WP5.0 的這個問題。
「新增 SDO 執行時期」會參照 Rational Application Developer 新聞群組。 您可以從 IBM developerWorks 網站進入 Rational Application Developer 的討論區,網址如下:www.ibm.com/developerworks/forums/dw_forum.jsp?forum=430&cat=24&hideBody=true。