入口網站專案支援 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 中,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 版已修正這個問題。
問題:Rational Developer 安裝作業無法安裝 WebSphere Portal 測試環境。
解決方案:請檢查安裝日誌,進行適當的方法來更正問題。
WebSphere Portal 5.0 測試環境 RD_installdir\runtimes\portal_v50\log\wpsinstalllog.txt,其中 RD_installdir 是 Rational Developer 的安裝目錄。
WebSphere Portal 5.1 測試環境 WP51TE_installdir\PortalServer\log\wpsinstalllog.txt,其中 WP51TE_installdir 是 WebSphere Portal 5.1 測試環境的安裝目錄。
如果無法從日誌檔中找出問題,請嘗試手動解除安裝 WebSphere Portal 測試環境。之後,再重新安裝。 如果需要手動解除安裝的相關資訊,請參閱 Rational Developer 安裝手冊。
問題:您可以利用 Rational Developer 來建置 WebSphere Portal 5.0 版的 Portlet。 如果您將 WebSphere Portal 服務套用在您的 Portal Server 上,在建置 Portlet 時,可能會出現編譯錯誤。 在這個情況下,您必須手動更新編譯所需要的檔案。
解決方案:如果要正確編譯 Portlet,請遵循下列步驟:
WebSphere Portal 5.0.2.x 版
附註:您必須先將這些檔案還原成原始狀態,之後,才能解除安裝 WebSphere Portal 測試環境。 如果您沒有執行這個動作,可能不會刪除 "portal_v50_stub" 資料夾,且您必須手動刪除。
- 複製 WebSphere Portal 5.0.2.x PortalServer\*.* 目錄中的最新版本,來更新下列目錄下的所有檔案。
- WS_installdir\runtimes\portal_v50_stub\*.*,其中 WS_installdir 是 Rational Developer 的安裝目錄。
- 如果要除錯 Portlet,請確定您也已將服務套用在 WebSphere Portal 測試環境上。 您必須將服務套用在 WebSphere Portal 5.0.2.x 版 WS_installdir\runtimes\portal_v50 目錄上。
WebSphere Portal 5.1 版
附註:您必須先將這些檔案還原成原始狀態,之後,才能解除安裝 WebSphere Portal 測試環境。 如果您沒有執行這個動作,可能不會刪除 "portal_v51_stub" 資料夾,且您必須手動刪除。
- 遵循服務指示,將服務套用在 WebSphere Portal 5.1 版測試環境上。
- 複製 WebSphere Portal 5.1 Test Environment PortalServer\*.* 目錄中的最新版本,來更新下列目錄下的所有檔案。
- RD_installdir\runtimes\portal_v51_stub\*.*,其中 RD_installdir 是 Rational Developer 的安裝目錄。
Portlet 部署描述子編輯器和「專案瀏覽器」視圖會顯示 Portlet 圖示及其名稱。 圖示會指出 Portlet 的狀態。Portlet 狀態有:正常、已啟用來源、已啟用目標,以及已啟用來源和目標。
問題:當您將 Portlet 轉換成 Click-to-Action 來源 Portlet 時,只應變更已轉換的 Portlet 圖示。 不過,有時會變更多個 Portlet 圖示,比方說,當單一 Servlet 有多個相關聯的 Portlet 時,便是如此。在這些情況下,除了所需的 Click-to-Action Portlet 圖示,所有 Portlet 圖示的顯示都不正確。 當您將 Portlet 轉換成 Click-to-Action 目標 Portlet 時,會有相同的狀況。
解決方案:這會變更多個 Portlet 圖示,但只會變更一個 Portlet。 轉換會順利完成,Portlet 專案不會毀損。
問題:當您在現有的 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]。
問題:在 WebSphere Portal 測試環境伺服器中,利用管理 Portlet 安裝 Portlet 失敗。
解決方案:不支援在 WebSphere Portal 測試環境伺服器中,利用管理 Portlet 來安裝 Portlet。 如果要在 WebSphere Portal 測試環境中部署 Portlet,您必須使用 Rational Developer 中的「發佈」功能。 如果要使用「發佈」功能,請用滑鼠右鍵按一下 Portlet 應用程式專案,再選取執行 > 在伺服器中執行,或在伺服器視圖中,用滑鼠右鍵按一下伺服器,再選取發佈。
問題:如果您的 Portlet 應用程式使用 Cloudscape 以外的資料庫,可能會發生錯誤。
解決方案:您必須將 JDBC 驅動程式新增至 WebSphere Portal 測試環境的 WebSphere 專用類別路徑中。請遵循下列步驟:
- 在「伺服器」視圖中,按兩下 WebSphere Portal 測試環境伺服器。 這時會開啟伺服器編輯器。
- 在編輯器底端,按一下環境標籤。
- 在 ws.ext.dirs 區段中,新增 JDBC 驅動程式。比方說,新增 DB2 的 SQLLIB\java12\db2java.zip 檔,其中 SQLLIB 是 DB2 的安裝目錄。
- 按 Ctrl+S 鍵來儲存您的變更。
問題:在 JSR 168 Portlet 部署描述子中,您無法在 Portlet 集合區中編輯 Portlet 名稱。
解決方案:在「程式碼」頁面中,編輯 Portlet 名稱。
問題:在某些使用 WebSphere Portal 5.0 版的配置中,當利用遠端伺服器連接伺服器來執行專案或進行專案的除錯時,入口網站或 Portlet 專案的變更不會自動顯示在瀏覽器中。
解決方案:處理方式有兩種:
- 利用瀏覽器來明確登出 WebSphere Portal,再重新登入。 登入之後,便會顯示這些變更。 請注意,瀏覽器視窗的關閉無法運作,每次發佈更新的入口網站專案時,都必須執行這個動作。
- 另外,您也可以配置 Rational Developer 來使用外部瀏覽器。 如果要執行這個動作,請從「視窗」功能表中選取「喜好設定...」。 在左側展開「網際網路」節點,選取「Web 瀏覽器」。 在主要區段中,選取內部 Web 瀏覽器以外的任何瀏覽器。
之後,在每次「在伺服器中執行」或「在伺服器中除錯」之前,您都必須先關閉外部瀏覽器,再執行這項作業。
問題:如果您從精靈產生的 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 版已修正這個問題。
問題:如果類別路徑的長度太長,變更 Portlet API 層次會失敗。
解決方案:您必須更正已移轉的 Portlet 專案的 Java 建置路徑。 對於必要的 Java 建置路徑,您可以參照「新建 Portlet 專案」精靈所產生的基本 Portlet 專案。 請將遺漏的必要 JAR 檔新增至已移轉的 Portlet 專案的 Java 建置路徑中。
問題:如果未安裝入口網站 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 的這個問題。
問題:當您試圖執行下列動作時,無法啟動 WebSphere Portal 5.0 測試環境。
- 利用沒有與 Portlet 專案相關聯的入口網站專案來啟動測試環境,再執行下一個動作:
- 將 Portlet 專案新增至入口網站專案中,再嘗試在測試環境中執行這個入口網站專案。
解決方案:您必須重新配置 WebSphere Portal 5.0 測試環境。
現在,您應該能夠在測試環境中執行您的入口網站專案及其新的相關 Portlet 專案。
- 在「伺服器」視圖中,用滑鼠右鍵按一下伺服器,再選取「新增和移除專案...」。
- 從「配置的專案」中,移除 "wps" 專案。
- 用滑鼠右鍵按一下入口網站專案,再選取「執行 > 在伺服器中執行」。
附註:6.0.0.1 版已修正這個問題。
「新增 SDO 執行時期」會參照 Rational Application Developer 新聞群組。 您可以從 IBM developerWorks 網站進入 Rational Application Developer 的討論區,網址如下:www.ibm.com/developerworks/forums/dw_forum.jsp?forum=430&cat=24&hideBody=true。