IBM WebSphere Development Studio Client for iSeries 5.0 版移轉指南

• 如果您的 WebFacing 專案已使用第 4.0 版 IDE 來轉換，移轉完成後不需要重新轉換專案。
• 如果原來的專案是移轉自 WebSphere Development Tools 5.1 版，您必須重新轉換專案。

移轉 iSeries Web 專案

移轉第 4.0 版 iSeries Web 專案至第 5.0 版

本節說明如何將 Development Studio Client for iSeries 4.0 版建立的 iSeries Web 專案移轉至 5.0 版。

移轉活動包含下列階段：

1. 使用現有的 V4.0.x 工作區移轉專案
2. 將 Web 專案結構移轉至 J2EE 1.3 專案結構

   附註：移轉 Web 專案至 J2EE 1.3 為選擇性使用項目。可是，J2EE 1.2 不支援 JCA (Java Connector Achitecture)。

3. 移轉 iSeries Web Tools 專案內容
4. 找出移轉後所產生的錯誤與警告

階段 1：使用現有的 V4.0.x 工作區移轉專案

這個方法只受到部份的支援，且會造成不完整的移轉。 使用者介面設定值、除錯設定值及大部份的喜好設定都會遺失。 專案名稱、專案原始檔及專案 Java 建置路徑 (類別類徑) 會被保留， 但無法保證一切沒問題。 只有在未使用支援的軟體配置管理 (SCM) 系統時，以及必須保留專案建置路徑資訊時，才會使用這個方法；它會在您從第 4.0 版匯入專案時遺失。 遵循下列方法，您可以使用現有的第 4.0.x 版工作區：

安裝之前

1. 確定 (釋放) 儲存庫的所有擱置變更。
2. 關閉所有視景，並關閉第 4.0 版產品。
3. 備份 workspace_directory 的內容，其中 workspace_directory 是含有第 4.0.x 版工作區的完整目錄名稱。依預設，第 4.0.x 版工作區子目錄是位在產品安裝的同一個目錄中。 如果您想要重新使用第 4.0.x 版產品，則必須執行此備份。一旦從第 5.0 版 IDE 指向第 4.0.x 版工作區，就無法再使用第 4.0.x 版產品中的工作區。
4. 安裝 Development Studio Client for iSeries 5.0 版。

1. 啟動第 5.0 版產品 (開始 > 程式集 > IBM WebSphere Studio > Development Studio Client for iSeries)，即會開啟 WebSphere Studio 視窗，您可以在其中指定要在階段作業中使用的目錄。 在此視窗中，指定第 4.0.x 版工作區的目錄位置。
2. 提示您確認是否要轉換成新的使用者介面格式時，按一下確定。
3. 執行任何重新建置或驗證工作區中的任何專案前，請在「導覽器」檢視畫面中選取「資源」視景內的所有專案，然後從蹦現功能表中選取重新整理。這可確保所有的檔案和它們適當的 meta 資料同步化。
4. 開啟任何關閉的專案 (請參閱下面的已知問題)。
5. 驗證類別路徑變數 (請參閱下面的已知問題)。
6. 這個版本新增、移除或修改了某些建置器和驗證程式。 若要確定顯示的是正確的錯誤與警告，您必須選取專案 > 全部重新建置，然後，針對每一個 Java 專案選取執行驗證，以重新建置所有的專案。
7. 可能保留了部份使用者喜好設定，但是，未保留大部份的設定。檢查第 5.0 版的喜好設定設定值，以確定這些設定值是您想要的。

EAR 及「伺服器配置」絕對路徑參照的「後置移轉」移除

第 4 版 EAR application.xml 檔及伺服器配置檔案均含有絕對路徑參照。 將它們移轉到第 5.0 版後，您必須以它們的編輯器開啟這些檔案 (編輯器會將檔案舊有的絕對路徑參照自動變更為新的相對路徑)。

1. 針對每一個 EAR 專案，請在「導覽器檢視畫面」中， 以滑鼠右鍵按一下 META-INF/application.xml > 開啟方式 > 部署描述子編輯器。
   1. 訊息視窗開啟：「自上一次儲存這個應用程式後，一個或多個模組的絕對路徑已變更.. . 您要自動更正嗎？」
   2. 按一下是。
   3. 儲存並關閉編輯視窗。
2. 對於每一個伺服器配置，請在「伺服器」視景的「伺服器配置」檢視畫面中，以滑鼠右鍵按一下伺服器 > 開啟。
   1. 相似的自動更正視窗開啟。
   2. 按一下是。
   3. 儲存並關閉編輯視窗。

已知問題及限制

如果您嘗試在第 5.0 版產品中開啟第 4.0 版的工作區進行移轉，則可能會發生下列問題。

JRE_LIB 類別路徑變數的值不正確

若要將 JRE_LIB 類別路徑變數重設為有效的位置，請遵循下列步驟。 當您第一次開啟「喜好設定」視窗時，即使值似乎是正確的，也請執行這項作業。

1. 選取視窗 > 喜好設定 > Java > 安裝的 JRE。
2. 在清單中，選取預設 JRE 位置 (您希望 JRE_LIB 設定的位置) 的勾選框。
3. 選擇編輯，然後按一下確定，關閉「編輯 JRE」對話框。

如果您沒有執行這項作業，則 JRE_LIB 的值可能會不正確，而造成 Java 檔案中許多建置的錯誤。

在一般檢查中，驗證所有其他類別路徑變數的值。

對於之前 SCM 共用的專案，「團隊」功能表含有「共用專案」

在 Eclipse 1.0 及 2.0 之間，團隊支援有明顯的變更。共用專案與儲存庫的方法也已經變更。

• 如果您選取團隊 > 共用專案選項，則精靈會引導您完成移轉程序。完成後， 專案即可共用，且會開啟「同步化」檢視畫面。您會看到每一個檔案中的衝突變更。這是因為以這種方式變更，會將同步資訊儲存在 Eclipse 1.0 及 2.0 之間的同步資訊。
• 如果沒有任何送出的變更 (如果您依照上面的建議升級前，已確定所有送出的變更，則應該不會有任何資料)，則只要在「同步化」檢視畫面中選取專案，然後選取置換及更新，就會從伺服器中載入現行內容。
• 如果有任何送出的變更，可以在「同步化」檢視畫面中將三角形功能表下拉，然後選取比較檔案內容。進行了某些作業後，「同步化」檢視畫面只會顯示確實不同的檔案。 然後，您可以使用「同步化」檢視畫面解決這些衝突。

在工作區目錄以外建立的專案

依預設，專案是建立在工作區目錄中。 如果您置換預設值，而在其他目錄中建立專案， 則在關閉工作區之台，請先開啟所有專案。 這可讓該專案的 .project 檔案寫入適當的位置。 無法開啟其目錄不在工作區內的已關閉專案， 會造成某一專案遮住了實際的專案，而在此專案中卻只有一個 .project 檔案。

階段 2：將 Web 專案結構移轉至 J2EE 1.3 專案結構

請注意，「J2EE 移轉精靈」可以執行兩項功能：

• 從第 4.0 版移轉 Web 專案結構或 J2EE 專案結構至第 5.0 版。
• 選擇性地移轉 J2EE 層次 1.2 至層次 1.3。

若要移轉至 J2EE 專案結構：

1. 如果尚未開啟，請從開始 > 程式集功能表中選取產品，開啟第 5.0 版 IDE。
2. 在 IDE 中，選取視窗 > 開啟視景 > Web 以開啟 Web 視景。
3. 在 Web 視景的「J2EE 導覽器」檢視畫面中，以滑鼠右鍵按一下專案名稱，然後選取移轉 > J2EE 移轉精靈。
4. 請遵循精靈頁面上的指示。如果您要使用 JCA (Java Connector Architecture) 支援，請確定您已選取將專案從版本層次 J2EE 1.2 移轉到 J2EE 1.3 勾選框。
5. 按一下完成以移轉選取的 Web 專案。

階段 3：移轉 iSeries Web Tools 專案內容

下列移轉程序取決於 Web 專案是否已順利移轉至 J2EE 專案結構 (如前面小節中所述)。

若要移轉 iSeries Web Tools 專案內容：

1. 在 Web 視景中，以滑鼠右鍵按一下專案名稱， 然後選取移轉 > iSeries Web Tools 專案 4.0 移轉為 5.0。
2. 重要事項：在這個點上關閉並重新開啟專案，避免有關資源刪除的異常事件發生。
3. 「確認移轉」視窗指出將移轉專案結構及內容。若要繼續進行，請按一下確定。
4. 「進度資訊」視窗開啟，指出正在執行移轉作業，並顯示移轉的進度。
5. 完成移轉程序時，會出現「警告」、「錯誤」或「順利完成」訊息視窗， 指出移轉的結果。
6. 如果移轉程序順利完成，就不需要採取進一步的動作。 如果移轉程序完成，但有發生錯誤或警告，則請繼續參考下面的找出移轉後所產生的錯誤及警告。

移轉程序會執行下列動作：

• 將 JSP 檔案中的所有設計時間控制項轉換成新的 Web 元件欄位與控制項。
• 新增 Apache Struts 1.02 執行時間檔，以及 Web 互動相關檔案 (以來自 .wit 檔案的支柱組織架構為基礎) 的再生。

階段 4：找出移轉後所產生的錯誤與警告

如果移轉處理發生問題，即會開啟視窗，指出發生的錯誤或警告，並說明這些資訊均記載於 Web 視景中專案名稱下的移轉日誌檔 projectName_MigrationDetails.txt。

移轉日誌檔頂端的「移轉結果」區段會指出移轉的整體結果， 並參照線上資訊的檔案，該檔案說明錯誤和警告，以及更正錯誤和警告時所採取的必要動作。

另請參閱線上說明的「移轉錯誤和警告明細」：

       Development Studio Client for iSeries > Web 應用程式 >
      iSeries Web Development > 參照 > 移轉錯誤和警告明細。

移轉 4.0 版之前的 iSeries Web 專案

本主題說明如何從和 WebSphere Development Tools for iSeries 版本 3.5 搭配使用的 WebSphere Studio 產品進行移轉。在這個主題下，此 WebSphere Studio 產品被稱為 WebSphere Studio classic，以區別現行版本的 WebSphere Studio。 本資訊適用於 WebSphere Studio classic 的「進階版」和「專業版」。

註：下列指示適用於自 WebSphere Studio classic 4.0 版的移轉。 如果要從更早的 WebSphere Studio classic 版本進行移轉， 您應該先移轉到 WebSphere Studio classic 4.0 版之後再繼續。

從 WebSphere Studio classic 的移轉包含下列步驟：

1. 建立新的單一伺服器暫置以進行移轉。
2. 建立 Web 配置描述子檔案。
3. 匯出移轉 JAR 檔。
4. 將移轉 JAR 檔匯入 Web 專案。
5. 完成 iSeries Web 專案移轉。
6. 設定伺服器和測試移轉的應用程式。

您應該先瞭解下列限制，再移轉任何 WebSphere Studio classic 資料：

• WebSphere Studio 現行版本的整合式開發環境，使用 XML 型的 SQL 編輯器，因此，您的 .sql 檔無法在其中使用。
• 專案發佈資訊和暫置資訊都無法移轉。
• WebSphere Studio classic 伺服器配置資訊無法移轉。
• 版本控制資訊無法移轉。

在底下說明的移轉程序中，您針對單一伺服器建立一個 JAR 檔， 而該檔案包含所有您的專案檔、可發佈檔和原始檔。 預設伺服器的「發佈」檢視畫面中能看到的所有檔案， 將包裝到 JAR 檔中。 接著，您可以將 JAR 檔匯入至 WebSphere Development Studio Client for iSeries 5.0 版的 Web 專案內。

當您移轉現有的專案時，會在移轉期間遺失所有專案發佈和暫置資訊。 如果您的暫置有多部伺服器，則只會保留發佈到預設伺服器的檔案。 因此，為了移轉目的，您將建立一個只含有一部伺服器的新暫置。

移轉步驟

步驟 1 - 建立新的單一伺服器暫置以進行移轉

如果您的現行暫置有一部以上的伺服器，則請遵循下列步驟， 建立一個稱為 Migration 的新暫置，且其中僅含有一部伺服器：

1. 開啟您要移轉的專案，並按一下專案 > 自訂發佈暫置功能表。
2. 在暫置名稱欄位中鍵入移轉。
3. 按一下新增。
4. 按一下確定。
5. 按一下專案 > 發佈暫置功能表，並從有效暫置的清單中選取移轉。
6. 在發佈檢視畫面按一下移轉，接著按一下插入 > 伺服器功能表。
7. 鍵入伺服器名稱，如 localhost，並按一下確定。
8. 選用項目：若您定義了 Servlet 對映資訊，請完成這一項作業。此外，請跳至下面步驟 2 的程序。變更伺服器或變更發佈暫置不會衍生 WebSphere Application Server 版本 4.0 的 Servlet 對映資訊。跳至「發佈」檢視畫面，以滑鼠右鍵按一下各個 Servlet 並選取內容。在「內容」視窗的發佈標籤，於 Servlet 對映欄位輸入實際的 Servlet 對映，並按一下確定。Servlet 對映為 URL 型樣與「應用程式伺服器」登錄的 Servlet 之對映。

步驟 2 - 建立 Web 配置描述子檔案

1. 在「發佈」檢視畫面時，按一下專案 > 建立 Web 配置描述子檔案。
2. 選取所有必要的 Servlets。
3. 選取所有必要的「標籤檔案庫描述子 (TLD)」檔案。
4. 按一下建立。

Web 配置描述子檔名的格式為 serverName_web.xml。對於伺服器 localhost，Web 配置描述子檔名為 localhost_web.xml。除非您指定不同的位置，否則會將 .xml 檔儲存在 WEB-INF 目錄中。

步驟 3 - 匯出移轉 JAR 檔

1. 在「發佈」檢視畫面時，以滑鼠右鍵按一下伺服器 localhost，並按一下內容 > 發佈 功能表。
2. 在 Webapp Web 路徑欄位鍵入 Web 路徑 (環境定義根目錄)。建立專案於 Development Studio Client for iSeries 5.0 版時，此項將作為 Web 專案名稱。 例如，若您鍵入 myproj，它在第 5.0 版被視為 Web 專案名稱。
3. 按一下確定。
4. 在「發佈」檢視畫面時，按一下專案 > 建立移轉檔案。
5. 驗證 localhost 是選取的伺服器。
6. 驗證 localhost_web.xml 是選取的 Web 配置描述子檔案。
7. 按一下確定。
8. JAR 檔名格式為 serverName.jar。對於伺服器 localhost，JAR 檔名是 localhost.jar。視需要更名檔案。
9. 在儲存位置欄位內，指定 JAR 檔的位置，並按一下儲存，建立 JAR 檔。

步驟 4 - 將移轉 JAR 檔匯入 Web 專案

1. 啟動 WebSphere Development Studio Client for iSeries 5.0 版。
2. 按一下視窗 > 開啟視景 > 其他功能表，選取 Web 並按一下確定開啟 Web 視景。
3. 匯入 JAR 檔。
   1. 按一下檔案 > 匯入。
   2. 按一下匯入視窗的 WAR 檔案，並按一下下一步。
4. 在從 WAR 檔案匯入資源視窗，
   1. 在 WAR 檔案欄位鍵入完整路徑和 JAR 檔案名稱。範例，若 JAR 檔案名稱為 localhost.jar，且其位置是 d:\myjar，則鍵入 d:\myjar\localhost.jar 於 WAR 檔案欄位。
      註：您必須使用 WAR 檔案選項匯入 JAR 檔；否則它將無法適當地運作。
   2. 選取 Web 專案的新建圓鈕。
   3. 在新的專案名稱欄位，鍵入 Webapp Web 路徑名稱 (您在步驟 3 定義的Web 專案名稱)。這個名稱自動新增至環境定義根目錄欄位。若未新增，則在環境定義根目錄欄位鍵入專案名稱。
   4. 選取企業應用程式專案的新建圓鈕，並鍵入 EAR 檔的名稱。EAR 檔的預設名稱是 DefaultEAR。您可以變更這項名稱，識別您的新專案。 例如，若您的新專案名稱為 myproj，您可命名 EAR 檔為 myprojEAR。
   5. 按一下完成，解壓縮 JAR 檔並建立 Web 專案。
5. 若要完成 Web 專案的起始設定， 請執行「iSeries Web Tools 執行時間配置」精靈。
   1. 在「J2EE 導覽器」檢視畫面中，以滑鼠右鍵按一下 Web 專案名稱， 然後選取指定 iSeries Web Tools 執行時間配置。
   2. 在精靈頁上按一下完成，不需要在欄位中輸入任何資料。 此動作會將 iSeries Web Tools 所需要的 JAR 檔複製到「Web 專案」的 Web-INF > lib。
6. 您可能含有數個無法分辨的參照或缺少匯入的檔案。它們會出現在「作業」檢視畫面。 若要修正此問題，您必須修改 Web 專案的 Java 建置路徑：
   1. 以滑鼠右鍵按一下專案名稱，並按一下內容，開啟「內容」視窗。
   2. 按一下 Java 建置路徑，並按一下程式庫標籤。
   3. 按一下新增外部 JAR。
   4. 從下列目錄中匯入任何您需要的 JAR：
      x:\WS*D\runtimes\base_v5\lib,
      x:\WS*D\runtimes\aes_v4\lib, and
      x:\WS*D\wstools\eclipse\plugins\com.ibm.etools.websphere.tools\runtime
      其中 x:\WS*D 是基本產品的安裝目錄。
7. 在「J2EE 導覽器」檢視畫面，以滑鼠右鍵按一下專案，並選取重新建置專案。

步驟 5 - 完成 iSeries Web 專案移轉

遵循移轉第 4.0 版 iSeries Web 專案內階段 2、3 和 4 說明的作業，完成專案移轉：

1. 選用項目：若您要在第 4.x 版的 WebSphere Application Server 執行 Web 應用程式，則無須階段 2 的作業。 可是，若您要在第 5.0 版的 WebSphere Application Server 執行 Web 應用程式，您必須完成階段 2 的作業，從 J2EE 1.2 移轉 Web 專案至 J2EE 1.3。
2. 階段 3 說明如何移轉 Web 專案內容。
3. 階段 4 提供移轉 Web 專案內容時，找出所產生的錯誤和警告的相關資訊。

這些作業完成時，跳至下方的步驟 6。

步驟 6 - 在測試伺服器上測試移轉的應用程式。

您現在已準備好測試應用程式。 若要在預設的測試伺服器上測試它，請遵循下列步驟：

1. 以滑鼠右鍵按一下 Web 應用程式的起始頁。
2. 選取在伺服器上執行。

若要在其他伺服器執行時間環境中測試您的應用程式， 請參照「伺服器工具」功能的線上說明。

從第 4.0 版移轉 iSeries 專案至第 5.0 版

如果您安裝了 Development Studio Client for iSeries 4.0 版：

解除安裝 Development Studio Client 4.0 版之前，您應該匯出專案內容至主電腦機器。 接著，安裝 Development Studio Client 5.0 版。安裝完成之後，從「遠端系統瀏覽器」執行一項動作，可以重建專案：

1. 在第 4.0 版，以滑鼠右鍵按一下「iSeries 專案」，並選取推送變更。這樣會上載所有的程式碼變更至專案相關聯的的程式庫。 (若您不確定專案作為目標的主電腦和程式庫，請以滑鼠右鍵按一下專案，並選取內容 > iSeries 專案。)
2. 關閉 4.0 版並進行解除安裝。
3. 繼續 Development Studio Client for iSeries 5.0 版的安裝。

1. 在第 5.0 版，開啟「遠端系統瀏覽器」視景：按一下視窗 > 開啟視景 > 遠端系統瀏覽器。
2. 導覽「iSeries 專案」相關聯的程式庫。 這個程式庫包含了所有從 iSeries 專案上載的原始檔。
3. 選取這個程式庫的原始實體檔 (iSeries 專案的一部份)，以滑鼠右鍵按一下它們，並選取設成可離線瀏覽。這樣會重建與這個程式庫對映的 iSeries 專案，並下載所有本端的原始成員至您的專案。 您可以繼續開發。

   附註：重建專案另一個快速的方法，即從「遠端系統瀏覽器」的程式庫選取建立 iSeries 專案，但是，這樣不會從程式庫下載任何原始成員。 它只是建立和設定對映至程式庫和主電腦的 iSeries 專案。

若您已安裝 Development Studio Client for iSeries 5.0 版，且您知道自己尚未上載專案至遠端主電腦：

1. 啟動第 5.0 版。
2. 在主要功能表上，按一下視窗 > 開啟視景 > 資源。按一下確定。
3. 按一下檔案 > 新建 > 其他 > 單元 > 專案來建立一個單元專案，並命名為 Temp。這個專案是一個儲存區，可匯入第 4.0 版專案至第 5.0 版工作區。
4. 選取檔案 > 匯入 > 檔案系統。按一下下一步。
5. 導覽舊的工作區 (例如：X:\WDSC\WSSD\workspace，其中 X 是安裝第 4.0 版的磁碟機)，並匯入您要重建的專案。
6. 建立「iSeries 專案」，對映第 4.0 版專案 (您剛匯入的專案) 的程式庫和主電腦。
   • 以滑鼠右鍵任意按一下「導覽器」檢視畫面，並選取新建 > 專案 > iSeries > 本端 > iSeries 專案。
   • 若您不記得程式庫和主電腦，您可以在 Temp 專案下，一個名稱為 .iseries_project_properties 的 XML 檔內找到這項資訊。
7. 重建第 4.0 版專案的原始實體檔：
   • 按一下檔案 > 新建 > 其他 > iSeries > 本端 > iSeries 原始實體檔。
   • 若您不確定檔案的 CCSID 及記錄長度，您可以在各個原始實體檔下，名稱為 .iseries_srcpf_properties 的 XML 檔內找到這項資訊。
8. 從舊的第 4.0 版拖放原始成員至新的第 5.0 版。
9. 刪除您不再需要的 Temp 專案，並開啟「iSeries 專案視景」： 按一下視窗 > 開啟視景 > iSeries 專案。