IBM WebSphere Development Studio Client for iSeries 第 5.1.2 版移轉手冊


內容

關於本資訊
開始之前
從第 5.0 版或 5.1 版移到第 5.1.2版
先決要件移轉步驟
必須要有 JDK 1.4 的 Java 套裝軟體才能產生精靈
移轉程式呼叫 Bean
將 iSeries Java 和 Web 專案中的「程式呼叫」Bean 從第 5.1 版移轉至第 5.1.2 版
對於 Java 專案中的「程式呼叫」Bean:
對於 Web 專案中的「程式呼叫」Bean:
將 iSeries Java 和 Web 專案中的「程式呼叫」Bean 從第 5.0 版移轉至第 5.1.2 版
對於 Java 專案中的「程式呼叫」Bean:
對於 Web 專案中的「程式呼叫」Bean:
將 iSeries Java 和 Web 專案中的「程式呼叫」Bean 從第 4.0 版移轉至第 5.1.2 版
對於 Java 專案中的「程式呼叫」Bean:
對於 Web 專案中的「程式呼叫」Bean:
移轉「遠端系統瀏覽器」的設定
從第 4.0 版移轉到第 5.1.2 版
移轉 WebFacing 專案
使用 WebFacing 匯入精靈
手動步驟 (若已自訂專案中的檔案)
移轉 iSeries Web 專案
將第 5.0.x 版和第 5.1 版 iSeries Web 專案移轉到第 5.1.2 版
階段 1:使用現有的 5.0.x 或 5.1 工作區來移轉專案
階段 2:移轉 iSeries Web 專案內容
階段 3:處理移轉結束時所產生的錯誤和警告
將第 4.0 版 iSeries Web 專案移轉到第 5.1.2 版
階段 1:使用現有的 V4.0.x 工作區來移轉專案
移轉到 J2EE 1.3
階段 3:移轉 iSeries Web Tools 專案內容
階段 4:處理移轉結束時所產生的錯誤和警告
Web 專案移轉的警告和錯誤訊息
移轉 iSeries 專案
將 iSeries 專案從第 5.0 版移轉到第 5.1.2 版:
將 iSeries 專案從第 4.0 版移轉到第 5.1.2 版:
若您安裝了 Development Studio Client for iSeries 第 4.0 版:
若您已安裝 Development Studio Client for iSeries 第 5.1.2 版,而且您知道自己尚未上載專案至遠端主電腦
注意事項
版權:
程式設計介面資訊
商標和服務標記

關於本資訊

此資訊說明如何從 IBM WebSphere Development Studio Client for iSeries 第 4.0 版、第 5.0 版或第 5.1 版移轉您的專案。

一般來說,移轉為無縫隙且透通。您所要做的是,使用現有的工作區, 以新版本的產品繼續處理您的專案。

針對某些與 Java Tools、Web Tools 與 WebFacing 專案自訂相關的特殊情況,您可能必須使用移轉工具或執行額外的手動步驟。

開始之前

重要事項:如果您目前已安裝 Development Studio Client for iSeries 第 4.0 版、第 5.0 或 5.1 版, 又想安裝 WebSphere Development Studio Client 第 5.1.2 版,則安裝程序會解除安裝前一版本的產品。 解除安裝 Development Studio Client for iSeries 第 4.0 版、第 5.0 版或第 5.1 版之前, 建議您記下第 4.0 版、第 5.0 版或第 5.1 版工作區的位置,並且製作其備份版本。 如果您沒有備份工作區,可能會遺失第 4.0 版、第 5.0 版或第 5.1 版專案。 (依預設,不會解除安裝或刪除這些專案)。

若要找出第 5.0 版或第 5.1 版工作區的位置:

若要找出您第 4.0 版工作區的位置:

從第 5.0 版或 5.1 版移到第 5.1.2 版

快速後置安裝步驟:
  1. 當您啟動第 5.1.2 版產品時 (開始 > 程式集 > IBM WebSphere Studio > Development Studio Client for iSeries), 會開啟 WebSphere Studio 視窗,讓您指定要在階段作業中使用的目錄。 在這個視窗中,指定第 5.0 版或第 5.1 版工作區的目錄位置。
  2. 當系統提示您確認是否要轉換成新的工作區格式時,請按一下確定

此手冊包含您在安裝第 5.1.2 版之前應閱讀的其他資訊。若已安裝, 則可以在 X:\WDSC\install\help\migrate.htm 這類的目錄中找到手冊。

如果您需要特定資訊來瞭解移轉至第 5.1.2 版對工作區或專案所造成的影響, 您可以在基本 WebSphere Studio 產品所提供的移轉手冊中閱讀適用的章節。這份指南的所在位置,視您系統上 Development Studio Client 的版本而定。

在安裝後也可以使用本手冊,位置如下:

先決要件移轉步驟

必須要有 JDK 1.4 的 Java 套裝軟體才能產生精靈

由於 JDK 1.4 中的變更,使用「資料庫網頁」與「Java Bean 網頁」精靈來產生要在第 5.1.x 版上執行的頁面時, 您必須指定 Java(TM) 套裝軟體。若「檢視 Bean」範本用於「Java Bean 網頁」精靈或「IBM(R) Database Access Java Beans-Master 明細型樣」, 則會發生這個問題。這也適用於包含先前使用這些精靈所產生頁面與 .java 檔案的專案 (在建立期間沒有指定套裝軟體)。 針對先前產生的程式碼,將 .java 檔案移到套裝軟體。然後更新 .jsp 檔案、 更新匯入陳述式與類別資訊。在專案的 web.xml 檔案中,更新 servlet-class 項目。

移轉程式呼叫 Bean

將 iSeries Java 和 Web 專案中的「程式呼叫」Bean 從第 5.1 版移轉至第 5.1.2 版

本節說明如何將 Development Studio Client for iSeries 第 5.0 版中建立的「程式呼叫」Bean 移轉至第 5.1.2 版。

對於 Java 專案中的「程式呼叫」Bean:

安裝之後:
  1. 當您啟動第 5.1.2 版產品時 (開始 > 程式集 > IBM WebSphere Studio > Development Studio Client for iSeries), 會開啟 WebSphere Studio 視窗,讓您指定要在階段作業中使用的目錄。 在這個視窗中,請指定第 5.0 版工作區的目錄位置。
  2. 如果系統提示您確認是否要轉換成新的使用者介面格式,請按一下確定
  3. 變更專案的 Java 建置路徑,可移除舊的類別路徑。
    1. 以滑鼠右鍵按一下 Java 專案,並選取 內容
    2. 在左窗格,選取 Java 建置路徑
    3. 選取程式庫標籤,然後選取下列 JAR 檔案並按一下移除,將它們從類別路徑移除:

      WDSC_HOME/plugins/com.ibm.etools.iseries.toolbox_5.1.0/runtime/jt400.jar
      WDSC_HOME/plugins/com.ibm.etools.iseries.webtools_5.1.0/lib/iwdtrt.jar
      WDSC_ECLIPSE_HOME/plugins/org.apache.xerces_4.1.3/xercesImpl.jar/
      j2ee.jar
    4. 在所有 PCML 檔上重新執行「程式呼叫」精靈。

對於 Web 專案中的「程式呼叫」Bean:

安裝之後:
  1. 當您啟動第 5.1.2 版產品時 (開始 > 程式集 > IBM WebSphere Studio > Development Studio Client for iSeries), 會開啟 WebSphere Studio 視窗,讓您指定要在階段作業中使用的目錄。 在這個視窗中,請指定第 5.0 版工作區的目錄位置。
  2. 如果系統提示您確認是否要轉換成新的使用者介面格式,請按一下確定
  3. 使用「J2EE 移轉」精靈:
    • 將專案結構轉換為第 5.1.2 版
    • 選擇性地移轉 J2EE 層次 1.2 至層次 1.3。
  4. 以滑鼠右鍵按一下 Web 視景中的專案名稱,然後選取移轉 > iSeries Web Tools 專案
  5. 「確認移轉」視窗會指出將移轉的專案結構及內容。若要繼續進行,請按一下確定
  6. 這項移轉將會以第 5.1.2 版的 Jar 檔,取代 WEB-INF\lib 資料夾中的 iwdtrt.jar 和 jt400.jar。
  7. 在所有 PCML 檔上重新執行「程式呼叫」。
  8. 在所有 Web Services Bean 上重新執行 Web Services 精靈。
  9. 此移轉僅適用於 Web Services Bean 本身。Web Services 精靈產生的程式碼必須以手動移轉與清除。

將 iSeries Java 和 Web 專案中的「程式呼叫」Bean 從第 5.0 版移轉至第 5.1.2 版

本節說明如何將 Development Studio Client for iSeries 第 5.0 版中建立的「程式呼叫」Bean 移轉至第 5.1.2 版。

對於 Java 專案中的「程式呼叫」Bean:

安裝之後:
  1. 當您啟動第 5.1.2 版產品時 (開始 > 程式集 > IBM WebSphere Studio > Development Studio Client for iSeries), 會開啟 WebSphere Studio 視窗,讓您指定要在階段作業中使用的目錄。 在這個視窗中,請指定第 5.0 版工作區的目錄位置。
  2. 如果系統提示您確認是否要轉換成新的使用者介面格式,請按一下確定
  3. 變更專案的 Java 建置路徑,可移除舊的類別路徑。
    1. 以滑鼠右鍵按一下 Java 專案,並選取 內容
    2. 在左窗格,選取 Java 建置路徑
    3. 選取程式庫標籤,然後選取下列 JAR 檔案並按一下移除,將它們從類別路徑移除:

      WDSC_HOME/plugins/com.ibm.etools.iseries.toolbox_5.0.0/runtime/jt400.jar
      WDSC_HOME/plugins/com.ibm.etools.iseries.webtools_5.0.0/lib/iwdtrt.jar
      WDSC_ECLIPSE_HOME/plugins/org.apache.xerces_4.0.7/xercesImpl.jar/
      j2ee.jar
    4. 在所有 PCML 檔上重新執行「程式呼叫」精靈。

對於 Web 專案中的「程式呼叫」Bean:

安裝之後:
  1. 當您啟動第 5.1.2 版產品時 (開始 > 程式集 > IBM WebSphere Studio > Development Studio Client for iSeries), 會開啟 WebSphere Studio 視窗,讓您指定要在階段作業中使用的目錄。 在這個視窗中,請指定第 5.0 版工作區的目錄位置。
  2. 如果系統提示您確認是否要轉換成新的使用者介面格式,請按一下確定
  3. 使用「J2EE 移轉」精靈:
    • 將專案結構轉換為第 5.1.2 版
    • 選擇性地移轉 J2EE 層次 1.2 至層次 1.3。
  4. 以滑鼠右鍵按一下 Web 視景中的專案名稱,然後選取移轉 > iSeries Web Tools 專案
  5. 「確認移轉」視窗會指出將移轉的專案結構及內容。若要繼續進行,請按一下確定
  6. 這項移轉將會以第 5.1.2 版的 Jar 檔,取代 WEB-INF\lib 資料夾中的 iwdtrt.jar 和 jt400.jar。
  7. 在所有 PCML 檔上重新執行「程式呼叫」。
  8. 在所有 Web Services Bean 上重新執行 Web Services 精靈。

將 iSeries Java 和 Web 專案中的「程式呼叫」Bean 從第 4.0 版移轉至第 5.1.2 版

本節說明如何將 Development Studio Client for iSeries 第 4.0 版中建立的「程式呼叫」Bean 移轉至第 5.1.2 版。

對於 Java 專案中的「程式呼叫」Bean:

安裝之後:
  1. 當您啟動第 5.1.2 版產品時 (開始 > 程式集 > IBM WebSphere Studio > Development Studio Client for iSeries), 會開啟 WebSphere Studio 視窗,讓您指定要在階段作業中使用的目錄。 在這個視窗中,請指定第 4.0 版工作區的目錄位置。
  2. 如果系統提示您確認是否要轉換成新的使用者介面格式,請按一下確定
  3. 變更專案的 Java 建置路徑,可移除舊的類別路徑。
    1. 以滑鼠右鍵按一下 Java 專案,並選取 內容
    2. 在左窗格,選取 Java 建置路徑
    3. 選取程式庫標籤,然後選取下列 JAR 檔案並按一下移除,將它們從類別路徑移除:

         ECLIPSE_HOME/plugins/com.ibm.etools.iseries.toolbox/runtime/jt400.jar
         ECLIPSE_HOME/plugins/com.ibm.etools.iseries.webtools/lib/wdt400rt.jar
         ECLIPSE_HOME/plugins/com.ibm.etools.websphere.runtime/lib/j2ee.jar
         ECLIPSE_HOME/plugins/com.ibm.etools.websphere.runtime/lib/xerces.jar
  4. 在所有 PCML 檔上重新執行「程式呼叫」。
  5. 此移轉僅適用於「程式呼叫」Bean 本身。「程式呼叫」精靈產生的程式碼必須以手動移轉與清除。

對於 Web 專案中的「程式呼叫」Bean:

安裝之後:
  1. 當您啟動第 5.1.2 版產品時 (開始 > 程式集 > IBM WebSphere Studio > Development Studio Client for iSeries), 會開啟 WebSphere Studio 視窗,讓您指定要在階段作業中使用的目錄。 在這個視窗中,請指定第 4.0 版工作區的目錄位置。
  2. 當系統提示您確認是否要轉換成新的工作區格式時,請按一下確定
  3. 使用「J2EE 移轉」精靈:
    • 將專案結構轉換為第 5.1.2 版
    • 選擇性地移轉 J2EE 層次 1.2 至層次 1.3。
  4. 以滑鼠右鍵按一下 Web 視景中的專案名稱,然後選取移轉 > iSeries Web Tools 專案
  5. 重要事項:此時請關閉再重新開啟專案,避免發生與資源刪除相關的異常狀態。
  6. 「確認移轉」視窗會指出將移轉的專案結構及內容。若要繼續進行,請按一下確定
  7. 移轉作業會將 WEB-INF\lib 資料夾中的 wdt400rt.jar 和 wdt400tb.jar 移除, 並將第 5.1.2 版的 iwdtrt.jar 和 jt400.jar 複製到資料夾中。
  8. 在所有 PCML 檔上重新執行「程式呼叫」。
  9. 在所有 Web Services Bean 上重新執行 Web Services 精靈。
  10. 在第 5.0 版中,可在預設套裝軟體中產生 Web Services Bean。 自第 5.1 版起,bean 必須在呼叫 Web Services 精靈之前在命名的套裝軟體中產生。
  11. 此移轉僅適用於 Web Services Bean 本身。Web Services 精靈產生的程式碼必須以手動移轉與清除。

移轉「遠端系統瀏覽器」的設定

從第 4.0 版移轉到第 5.1.2 版

安裝之後:
  1. 當您啟動第 5.1.2 版產品時 (開始 > 程式集 > IBM WebSphere Studio > Development Studio Client for iSeries), 會開啟 WebSphere Studio 視窗,讓您指定要在階段作業中使用的目錄。 在這個視窗中,請指定第 4.0 版工作區的目錄位置。
  2. 當系統提示您確認是否要轉換成新的工作區格式時,請按一下確定
  3. 在主要功能表上,按一下視窗 > 喜好設定
  4. 在左窗格中,展開 LPEX 編輯器,然後選取剖析器
  5. 在右窗格內,選取 ILErpg。在底端的類別名稱欄位中,將類別名稱變更為 com.ibm.etools.iseries.editor.ISeriesEditorRPGILEParser。 按一下設定
  6. 在右窗格內,選取 rpg。在底端的類別名稱欄位中,將類別名稱變更為 com.ibm.etools.iseries.editor.ISeriesEditorRPGOPMParser。 按一下設定
  7. 按一下套用。 按一下確定

移轉 WebFacing 專案

若您具有使用第 4.0 版、第 5.0.x 版或第 5.1.x 版的現有專案, 則當您啟動 5.1.2 工作台時,您可以指定較舊的工作區,並以現有方式執行方案。然而,專案顯示可能不完整。 例如,記錄 JSP 檔案與部份來自先前版本的樣式檔案不會出現在 5.1.2 樹狀檢視畫面中。

第一次轉換 DDS 檔案時,將更新專案結構以反映新的 5.1.2 佈置。 例如,新的執行時間 jar 檔案與範本檔案都會匯入。 如果特別指定「匯入」精靈,也會以同樣的方式執行這些作業。

使用 WebFacing 匯入精靈

如果您具有使用 WebSphere Development Studio Client 第 4.0 版、第 5.0 版或第 5.1 版的 WebFacing 專案, 您可以使用「匯入」精靈將這些專案移轉到 Development Studio Client 第 5.1.2 版。 請遵循下列步驟:

安裝之後:
  1. 選取檔案 > 匯入
  2. 選擇 WebFacing 專案。按一下下一步
  3. 瀏覽至您要移轉到第 5.1.2 版的 WebFacing 專案所在的資料夾。按一下下一步
    附註:
    當您升級到第 5.1.2 版後,WebFacing 專案仍會保留在您原來的工作區目錄中。
    • 如果您是從 Development Studio Client 5.0 或 5.1 移轉而來,請參閱開始之前下面有關尋找您工作區的章節。
  4. 精靈找到的任何 WebFacing 專案都會列在找到的 WebFacing 專案窗格中。選取您要匯入的專案。 精靈會建立專案的 EAR 檔案。EAR 檔案是 J2EE 企業應用程式保存檔。依預設, EAR 檔案會使用 WebFacing 專案的名稱,並在名稱中加上 _EAR。 如果您要使用不同的名稱,或是您想將數個專案合併到一個 EAR 檔中, 可以在企業應用程式專案欄位中變更名稱。
  5. 按一下完成,便可將專案移轉到第 5.1.2 版工作區中。
  6. 若要在 WebFacing 視景看到專案,請選取視窗 > 開啟視景 > WebFacing

手動步驟 (若已自訂專案中的檔案)

原始檔案具有下列格式的新名稱:檔案名稱 +_512_bak

若您自訂 WebFacing 專案,就可能需要將自訂從原始檔案合併到下列檔案:

移轉 iSeries Web 專案

下列方法可以用來移轉 iSeries Web 專案:

將第 5.0.x 版和第 5.1 版 iSeries Web 專案移轉到第 5.1.2 版

下列資訊說明如何將 iSeries Web 專案從 Development Studio Client for iSeries 第 5.0.x 版與第 5.1 版, 移轉到 Development Studio Client for iSeries 第 5.1.2 版。

移轉活動包含下列階段:

  1. 使用現有的 5.0.x 或 5.1 工作區來移轉專案
  2. 移轉 iSeries Web 專案內容
  3. 處理移轉結束時所產生的錯誤和警告

階段 1:使用現有的 5.0.x 或 5.1 工作區來移轉專案

在第 5.1.2 版中,您可以透過喜好設定頁面,來配置新 Web 專案的預設 Web 內容和 Java 原始程式資料夾名稱。 此時的預設名稱是 JavaResources 與 WebContent。這些預設的名稱將只會用於新的 Web 專案。在第 5.1.2 版之前的版本中建立的 Web 專案, 將可繼續使用舊名稱來運作。對於 Static Web 專案也可以繼續使用舊名稱。

安裝之後:
  1. 當您啟動第 5.1.2 版產品時 (開始 > 程式集 > IBM WebSphere Studio > Development Studio Client for iSeries), 會開啟 WebSphere Studio 視窗,讓您指定要在階段作業中使用的目錄。 請在這個視窗中指定第 5.0.x 版或第 5.1 版工作區的目錄位置。
  2. 如果系統提示您確認是否要轉換成新的使用者介面格式,請按一下確定
  3. 選用項目:在主要功能表上,按一下視窗 > 喜好設定。在左窗格中,展開 Web Tools, 然後選取新建專案。在右窗格中,請設定預設資料夾名稱的喜好設定。

您可以在「導覽器」檢視畫面中以滑鼠右鍵按一下資料夾名稱, 再按一下更名,即可在第 5.1.2 版以手動方式變更第 5.0.x 版或第 5.1 版專案的原始檔資料夾名稱。「更名」動作會更改資料夾名稱,並可修正 5.0.x 或 5.1 Web 專案的 Java 建置路徑。 如果您選擇更改第 5.1.2 版中的 JavaResources 和 WebContent 資料夾名稱, 則您所有的自動建置 Script,都必須以新的資料夾名稱以手動方式更新。

階段 2:移轉 iSeries Web 專案內容

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

  1. 在 Web 視景之「專案導覽器」檢視畫面中以滑鼠右鍵按一下專案名稱, 然後選取內容。在左畫面中選取 Web 專案功能。從可用的 Web 專案功能清單中,選取新增 Struts 支援 (若尚未選取)。 按一下確定。在「Web 專案功能」視窗中按一下完成,以接受預設的 Struts 版本 (1.1)。
    附註:
    如果您漏掉此步驟,螢幕上會顯示一個視窗要求您新增 Struts 支援。
  2. 重要事項:此時請關閉再重新開啟專案,以免發生與資源刪除相關的異常狀態。
  3. 以滑鼠右鍵按一下 Web 視景中的專案名稱,然後選取移轉 > iSeries Web Tools 專案。「確認移轉」視窗會指出將移轉的專案結構及內容。
  4. 若要繼續進行,請按一下確定。 在「進度資訊」視窗中會顯示移轉的進度。
  5. 當移轉完成時,會出現一則訊息指示其結果。
  6. 如果移轉程序順利完成,就不需要採取進一步的動作。如果移轉程序完成但出現錯誤或警告, 請繼續階段 3:處理移轉結束時所產生的錯誤及警告
  7. 移轉程序會執行下列動作:

階段 3:處理移轉結束時所產生的錯誤和警告

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

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

針對 5.0.x 移轉,除了日誌檔中所列出的任何移轉警告外, 另外請注意,對於「文字項目 Web 元件」,已不再支援 Maximum length (maxLength) 屬性。這可能會影響到您網頁的視覺化外觀。

將第 4.0 版 iSeries Web 專案移轉到第 5.1.2 版

下列資訊說明如何將 iSeries Web 專案從 Development Studio Client for iSeries 第 4.0 版, 移轉到 Development Studio Client for iSeries 第 5.1.2 版。

移轉活動包含下列階段:

  1. 使用現有的 V4.0.x 工作區移轉專案
  2. 移轉 Web 專案結構及選擇性地移轉專案的 J2EE 版本
    附註:
    移轉 Web 專案至 J2EE 1.3 是選用的作業。 不過,J2EE 1.2 並不支援 JCA (Java Connector Architecture)。
  3. 移轉 iSeries Web Tools 專案內容
  4. 處理移轉結束時所產生的錯誤和警告

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

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

安裝之前:
  1. 確定 (釋放) 儲存庫的所有擱置變更。
  2. 關閉所有視景,並關閉第 4.0 版產品。
  3. 請備份 workspace_directory 的內容, 其中 workspace_directory 是包含第 4.0.x 版工作區的完整目錄名稱。 依預設,第 4.0.x 版工作區子目錄是位在產品安裝的同一個目錄中。 如果您想要重新使用第 4.0.x 版產品,則必須執行此備份。一旦從第 5.1.2 版 IDE 指向第 4.0.x 版工作區後, 就無法再回到使用第 4.0.x 版產品中的工作區。
  4. 安裝 Development Studio Client for iSeries 第 5.1.2 版。
安裝之後:
  1. 當您啟動第 5.1.2 版產品時 (開始 > 程式集 > IBM WebSphere Studio > Development Studio Client for iSeries), 會開啟 WebSphere Studio 視窗,讓您指定要在階段作業中使用的目錄。 在這個視窗中,請指定第 4.0 版工作區的目錄位置。
  2. 當系統提示您確認是否要更新前版產品所建立的工作區時,請按一下確定
  3. 在執行任何重新建置或驗證工作區中的任何專案之前, 請在「資源」視景中的「導覽器」檢視畫面中選取所有的專案, 然後再從蹦現功能表中選取重新整理。 如此即可確保所有的檔案能和其適當的 meta 資料進行同步化。
  4. 開啟任何關閉的專案 (請參閱已知的問題和限制)。
  5. 驗證您的類別路徑變數 (請參閱已知的問題和限制)。
  6. 這個版本新增、移除或修改了某些建置器和驗證程式。 若要確定顯示的錯誤與警告是否正確, 您必須選取專案 > 全部重新建置,然後針對每個 Java 專案選取執行驗證,即可重新建置所有專案。
  7. 可能保留了部份使用者喜好設定,但是,未保留大部份的設定。檢查第 5.1.2 版的喜好設定值,以確定這些設定值是您想要的。

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

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

  1. 針對每一個 EAR 專案,請更新 application.xml 檔。
    1. 在「導覽器」檢視畫面中,以滑鼠右鍵按一下 META-INF/application.xml, 然後選取開啟方式 > 部署描述子編輯器
    2. 針對訊息按一下
      The IBM extensions file contains deprecated absolute paths.
      This can be auto-corrected... Would you like to autocorrect?
    3. 儲存並關閉編輯視窗。
  2. 針對每一項伺服器配置,請更新配置檔。
    1. 在「伺服器」視景的「伺服器配置」檢視畫面中,以滑鼠右鍵按一下伺服器名稱, 然後選取開啟
    2. 相似的自動更正視窗開啟。
    3. 按一下
    4. 儲存並關閉編輯視窗。

已知的問題和限制

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

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

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

  1. 選取視窗 > 喜好設定 > Java > 安裝的 JRE
  2. 在清單中選取正確的勾選框,以使用用來設定 JRE_LIB 的預設 JRE 位置。
  3. 選擇編輯,然後按一下確定,以關閉「編輯 JRE」對話框。

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

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

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

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

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

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

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

請注意,「J2EE 移轉精靈」可以執行下列兩項功能:

若要移轉至 J2EE 專案結構:

  1. 如果尚未開啟,請從開始 > 程式集功能表選取產品,即可開啟第 5.1.2 版 IDE。
  2. 在 IDE 中,選取視窗 > 開啟視景 > Web,以開啟 Web 視景。
  3. 在 Web 視景的「專案導覽器」檢視畫面中以滑鼠右鍵按一下專案名稱, 然後選取移轉 > 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 視景之「專案導覽器」檢視畫面中以滑鼠右鍵按一下專案名稱, 然後選取內容。在左畫面中選取 Web 專案功能。從可用的 Web 專案功能清單中,選取新增 Struts 支援 (若尚未選取)。 按下確定。在「Web 專案功能」視窗中按一下完成,以接受預設的 Struts 版本 (1.1)。
    附註:
    如果您漏掉此步驟,螢幕上會顯示一個視窗要求您新增 Struts 支援。
  2. 重要事項:此時請關閉再重新開啟專案,避免發生與資源刪除相關的異常狀態。
  3. 在 Web 視景的「專案導覽器」檢視畫面中以滑鼠右鍵按一下專案名稱, 然後選取移轉 > iSeries Web Tools 專案
  4. 「確認移轉」視窗會指出將移轉的專案結構及內容。若要繼續進行,請按一下確定
  5. 「進度資訊」視窗便會開啟,指出正在執行移轉作業,並顯示這項移轉的進度。
  6. 完成移轉程序時,會分別出現「警告」、「錯誤」或「順利完成」訊息視窗,指出移轉的結果。
  7. 如果移轉程序順利完成,就不需要採取進一步的動作。如果移轉程序完成但出現錯誤或警告, 請繼續階段 4:處理移轉結束時所產生的錯誤及警告

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

階段 4:處理移轉結束時所產生的錯誤和警告

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

移轉日誌檔頂端的「移轉結果」區段會指出移轉的整體結果, 並參照線上資訊的檔案,該檔案說明錯誤和警告,以及更正錯誤和警告時所採取的必要動作。另請參閱 Development Studio Client for iSeries > Web 應用程式 > iSeries Web Development > 參照 > 移轉錯誤與警告明細下的線上說明。

其他的移轉注意事項

除了上面階段 4 中說明之日誌檔中所列出的任何移轉錯誤之外,您還需要處理下列的項目:

除了上面階段 4 中說明之日誌檔中所列出的任何移轉警告之外,您還需要知道下列的變更,可能會影響到您網頁的視覺化外觀:

Web 專案移轉的警告和錯誤訊息

錯誤碼 說明 動作
E100 移轉 JSP 檔案時發生無法判斷的錯誤。 解決或處理移轉日誌檔中所有其他的錯誤或警告,然後重新執行移轉工具。
E101 JSP 檔案中的 iSeries Web 元件有錯誤。 解決 iSeries Web 元件錯誤。
E200 處理 .wit 檔時造成無法判斷的錯誤。 按兩下錯誤的 .wit 檔,以呼叫「Web 互動」精靈。 繼續進行精靈中所有的頁面,並進行必要的變更。 按一下「完成」。
E201 在頁面中定義且用於此互動的一或多個 Web 元件名稱無效。 按兩下錯誤的 .wit 檔,以呼叫「Web 互動」精靈。 螢幕中會開啟一個視窗,指出 Web 元件名稱無效,並詢問您是否要變更名稱。 按一下「是」。繼續進行精靈頁「對映並將輸入參數鏈結到輸入欄位」(對之前的精靈頁進行必要的變更)。 對已變更名稱的 Web 元件 (輸入欄位) 指定「階段作業中的名稱」、 「儲存到階段作業」及「鏈結」等選項。 繼續進行精靈頁「對映並將輸出參數鏈結到輸出欄位」。 對已變更名稱的 Web 元件 (輸出欄位) 指定「階段作業中的名稱」、 「從階段作業還原」及「鏈結」等選項。 繼續進行精靈中所有的頁面,並進行必要的變更。 按一下「完成」。
E202 此互動中定義的「輸出參數」已將「訊息指示器」值設為 True。 本版中已大幅變更進階訊息處理。 您必須重新定義「訊息處理」選項。 按兩下錯誤的 .wit 檔,以呼叫「Web 互動」精靈。 繼續進行精靈頁「對映並將輸出參數鏈結到輸出欄位」。 在「訊息控制器」值設為 True 的「輸出參數」內容視窗中, 選取 True 值。這將使按鈕成為可見的按鈕 -- 按一下此按鈕以定義訊息控制規格。
E300 處理 DTC 及/或產生的 iSeries Web 元件時,發生無法判斷的錯誤。 解決或處理移轉日誌檔中所有其他的錯誤或警告。 重新命名移轉日誌檔,然後重新執行移轉工具。
E301-E302 不再支援 Pushbutton DTC 內容「下一個/前一個」。 Button Web 元件「按鈕」類型屬性將定義為「提出」。 使用「Web 互動」精靈建立互動,以將包含「下一個/前一個」按鈕的頁面指定為輸入 JSP 頁, 並將「下一個」按鈕的目標頁指定為輸出 JSP 頁。 在第 4.0 版中,「下一個/前一個」按鈕使用於多個輸入頁中。 請參閱說明 > 說明內容下的資訊, 然後參閱說明系統中的參照 > 使用者介面參照 > iSeries Web 應用程式 > 多個輸入與輸出頁
警告碼 說明 動作
W100 JSP 頁上的 iSeries Web 元件有警告。 處理 iSeries Web 元件警告。
W300 Listbox 或 Combobox 的「區隔字元」內容有多個字元。 「區隔字元」內容中的第一個字元,將使用於對應 iSeries Web 元件區隔字元屬性中。 請確定 Selection Box 或 Combo Box Web 元件的所有選項都已定義正確的「名稱」與「值」屬性。
W301-W302 Listbox 或 Combobox 在「資料」內容 [key] 或 [value] 中包含預先選取字元 *。 請確定 Selection Box 或 Combo Box Web 元件的所有選項都已定義正確的「名稱」與「值」屬性。
W303 JSP 檔內所有具有相同「群組名稱」內容的「圓鈕 DTC」, 此時都顯示為「圓鈕群組 Web」元件的選項。 針對 JSP 頁中的第一個圓鈕,在「字型」標籤與「顏色」標籤上定義的內容, 將作為「圓鈕群組」的「顏色」與「字型」屬性使用。也就是說,「顏色」標籤和「字型」標籤內容, 在相同群組後續的圓鈕中不會出現。 選取相關的 JSP 檔並在伺服器上執行檔案, 讓「圓鈕群組」能確實在 JSP 頁內以您所屬意的方式顯示。 選取相關的 JSP 檔並在伺服器上執行, 讓圓鈕群組「字型」與「顏色」屬性能確實以您所屬意的方式顯示。
W304 不再支援 Pushbutton 內容標籤。 Pushbutton 內容值已對映到對應「按鈕 Web」元件的「標籤」屬性。 「按鈕 Web」元件上出現的文字與 Pushbutton DTC 上出現的不同。 若「按鈕 Web」元件上顯示的文字不適合,請變更「標籤」屬性的值。
W305 「子檔案」或「表格」DTC 目前顯示於 HTML FORM 標籤外。 「表格 Web」元件無法在 HTML FORM 標籤內出現。 若 DTC 類型為「子檔案」,則對應的 iSeries Web 元件為「表格 Web」元件。 請確定「表格 Web」元件可在 JSP 頁上以您所屬意的方式顯示。
W306-W320 不再支援 DTC 事件內容。 必要的話,請以其它事件定義相關的動作。
W306 OnDblClick
W307 OnMouseDown
W308 OnMouseOut
W309 OnMouseOver
W310 OnSelect
W312 圓鈕的 OnChange
W313 勾選框的 OnChange
W314 OnMouseUp
W315 圓鈕的 OnKeyDown
W316 圓鈕的 OnKeyPress
W317 圓鈕的 OnKeyUp
W318 按鈕的 OnKeyDown
W319 按鈕的 OnKeyPress
W320 按鈕的 OnKeyUp
W321 Web 元件定義了不受支援的屬性, 因為 1) 大部分瀏覽器不支援相關的 CSS 屬性 2) 相關的 HTML 屬性在 HTML 4.0 中已棄用,且大部分的瀏覽器都不支援 無。

移轉 iSeries 專案

將 iSeries 專案從第 5.0 版移轉到第 5.1.2 版:

安裝之後:
  1. 當您啟動第 5.1.2 版產品時 (開始 > 程式集 > IBM WebSphere Studio > Development Studio Client for iSeries), 會開啟 WebSphere Studio 視窗,讓您指定要在階段作業中使用的目錄。 在這個視窗中,請指定第 5.0 版工作區的目錄位置。
  2. 當系統提示您確認是否要轉換成新的使用者介面格式時,請按一下確定

若您讓「5.0 建置狀態」檢視畫面在 5.0 工作台中保持開啟, 5.1.2 將發生下列錯誤:

無法還原工作台佈置

按一下確定以繼續。 這是因為,使用「遠端系統瀏覽器」視景中的「iSeries 工作狀態」檢視畫面, 已取代「iSeries 專案」視景中的「建置狀態」檢視畫面。 任何出現在原始「建置狀態」檢視畫面中的建置,都不會出現在新的檢視畫面中。 重新建置相關的 iSeries 專案時,新建置會出現在「工作狀態」檢視畫面中, 且進行中的功能不受影響。

在移轉後,如果在 iSeries 專案上出現紅色旗標,這是因為與您專案相關的「遠端系統瀏覽器」連線已不存在。 若要解決此問題:

  1. 以滑鼠右鍵按一下 iSeries 專案,然後選取內容 > iSeries 專案
  2. 設定遺漏的連線,再按一下確定

將 iSeries 專案從第 4.0 版移轉到第 5.1.2 版:

若您安裝了 Development Studio Client for iSeries 第 4.0 版:

解除安裝 Development Studio Client 4.0 版之前,您應該匯出專案內容至主電腦機器。 接著,請安裝 Development Studio Client 第 5.1.2 版。在安裝之後,從「遠端系統瀏覽器」中執行一項動作,便可以重建這些專案。

安裝之前:

若您已安裝 Development Studio Client for iSeries 第 5.1.2 版, 而且您知道自己尚未上載專案至遠端主電腦,請略過本節。

  1. 在第 4.0 版中,以滑鼠右鍵按一下 iSeries 專案,然後選取推送變更。這樣會上載所有的程式碼變更至專案相關聯的程式庫。 (若您不確定何者為此專案的目標主電腦和檔案庫,請以滑鼠右鍵按一下專案, 然後選取內容 > iSeries 專案。)
  2. 關閉 4.0 版並進行解除安裝。
  3. 請繼續安裝 Development Studio Client for iSeries 第 5.1.2 版。
安裝之後:
  1. 在第 5.1.2 版中,請開啟「遠端系統瀏覽器」視景:按一下視窗 > 開啟視景 > 遠端系統瀏覽器
  2. 導覽至 iSeries 專案相關的檔案庫。這個程式庫中包含所有您從 iSeries 專案上載而來的原始檔。
  3. 選取這個檔案庫的原始實體檔 (iSeries 專案的一部份),以滑鼠右鍵按一下它們, 然後選取設成可離線瀏覽。這樣會重建與這個程式庫對映的 iSeries 專案,並下載所有本端的原始成員至您的專案。 您可以繼續開發。

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

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

安裝之後:
  1. 在主要功能表上,按一下視窗 > 開啟視景 > 資源。按一下確定
  2. 按一下檔案 > 新建 > 其他 > 簡易 > 專案以建立簡易專案,並將其命名為 Temp。這個專案是一個儲存區,可以將第 4.0 版專案匯入第 5.1.2 版的工作區。
  3. 選取檔案 > 匯入 > 檔案系統。按一下下一步
  4. 請導覽至您舊的工作區,再匯入您要重建的專案。(請參閱「開始之前」下方有關尋找工作區的章節。)
  5. 建立 iSeries 專案,對映第 4.0 版專案 (您剛匯入的專案) 的檔案庫和主電腦。
    • 以滑鼠右鍵按一下「導覽器」檢視畫面中的任何位置,然後選取新建 > 專案 > iSeries > 本端 > iSeries 專案
    • 若您不記得檔案庫和主電腦, 您可以在 Temp 專案下名為 .iseries_project_properties 的 XML 檔案中找到此資訊。
  6. 重建第 4.0 版專案的原始實體檔:
    • 按一下檔案 > 新建 > 其他 > iSeries > 本端 > iSeries 原始實體檔
    • 若您不確定檔案的 CCSID 及記錄長度,可以在各原始實體檔下一個名稱為 .iseries_srcpf_properties 的 XML 檔中,找到這項資訊。
  7. 現在,請從舊的專案中將原始成員拖放至新的 5.1.2 版專案。
  8. 刪除您不再需要的 Temp 專案,並開啟「iSeries 專案」視景: 按一下視窗 > 開啟視景 > iSeries 專案

注意事項

Note to U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

本資訊是針對 IBM 在美國所提供之產品與服務開發出來的。 而在其他國家中,IBM 不見得有提供本文件中所提的各項產品、服務、或功能。 若要取得您所在區域目前是否可使用這些產品與服務的相關資訊,請向當地 IBM 業務代表查詢。 本文件在提及 IBM 的產品、程式或服務時,不表示或暗示只能使用該產品、程式或服務。 只要未侵犯 IBM 的智慧財產權,任何功能相當的產品、程式或服務都可以取代 IBM 的產品、程式或服務。 不過,非 IBM 產品、程式、或服務在運作上的評價與驗證,其責任屬於使用者。

在本文件中可能包含著 IBM 所擁有之專利或專利申請案。 本文件使用者並不享有前述專利之任何授權。 您可以用書面方式,將授權查詢傳送到:

IBM Director of Licensing
 IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

如需雙位元組 (DBCS) 資訊的授權查詢,請聯絡您本國的 IBM 智慧財產部門, 您可以用書面方式,將授權查詢傳送到:

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan

下列段落若與當地之法令抵觸,則作廢: IBM 僅以現狀提供本出版品,而不為任何明示或默示之保證 (包括但 不限於產品未涉侵權、可售性或符合特定效用的保證)。 倘若干地區在特定交易中並不許可相關明示或默示保證之棄權聲明,則於該等地區之特定交易,此項聲明不適用之。

本資訊中可能包含技術上或排版印刷上的錯誤。因此,IBM 會定期修訂; 並將修訂後的內容納入新版中。同時,IBM 得隨時修改及 (或) 變更本出版品中所提及的產品及 (或) 程式,不必另行通知。

本資訊中任何對非本 IBM 所擁有的網站之敘述僅供參考,IBM 對該等網站並不提供保證。 該等網站上的資料,並非本 IBM 產品所用資料的一部分,如因使用該等網站 而造成損害,其責任由 貴客戶自行負責。

IBM 得以其認定之各種適當方式使用或散布由 貴客戶提供的任何資訊,而無需對您負責。

希望擁有本程式相關資訊的授權者,其目的為: (i) 在單獨建立的程式與其他程式 (包含本程式) 之間可交換資訊, 以及 (ii) 共用已交換的資訊,應該聯絡:

Lab Director
IBM Canada Ltd. Laboratory
8200 Warden Avenue
Markham, Ontario, Canada L6G 1C7

在適當的條款與條件下,這類資訊可用於部份狀況,酌收服務費。

本文件提到的授權程式以及可使用的所有授權工具皆由 IBM 提供, 主要依據 IBM Customer Agreement、IBM International Program License Agreement 或與 IBM 之間等同合約的條款。

本文件所提及之非 IBM 產品資訊,係由產品的供應商,或其出版的聲明或其他 公開管道取得。 IBM 並未測試過這些產品,也無法確認這些非 IBM 產品的執行效能、 相容性、或任何對產品的其他主張是否完全無誤。 如果您對非 IBM 產品的性能有任何的疑問,請逕向該產品的供應商查詢。

本資訊包含日常商業活動所用的資料及報告範例。 為了提供完整的說明, 這些範例包括個人、公司、廠牌和產品的名稱。這些名稱全屬虛構,若與任何公司的名稱和住址雷同,純屬巧合。

版權:

本資訊包含以原始語言撰寫的範例應用程式, 說明了各種作業平台上的程式設計技術。您可以針對開發、使用、銷售或分送應用程式到符合應用程式介面 (該介面為撰寫範例程式的作業平台) 之目的, 進而複製、修改並以各種形式分送這些範例程式,毋需付費給 IBM。 尚未在各種條件之下完整測試這些範例。 不過,IBM 並不保證或默示這些程式的穩定性、服務性與功能性。 您可以針對開發、使用、銷售或分送應用程式到符合 IBM 應用程式介面之目的, 進而複製、修改並以各種形式分送這些範例程式,毋需付費給 IBM。

這些範例程式或衍生程式的每個複本或部份,皆必須包含如下所示的版權聲明:

(C) (公司名稱) (年份)。此程式碼部份衍生自 IBM 公司。 範例程式。(C) Copyright IBM Corp. 1992, 2002. All rights reserved.

程式設計介面資訊

程式設計介面資訊主要為協助您使用此程式建立應用軟體。

一般使用的程式設計介面可讓您撰寫取得此程式工具服務的應用軟體。

然而,本資訊也可能含有診斷、修改與調整資訊。 提供診斷、修改與調整資訊可協助您除錯應用軟體。

警告:請勿使用此診斷、修改與調整資訊作為程式設計介面, 因為隨時有可能變更本資訊。

商標和服務標記

下列術語是 IBM 公司在美國及 (或) 其它國家的商標:

* AIX * DB2 Extenders * Operating System/400
* AIX windows * DB2 Universal Database * OS/2
* Application System/400 * eserver graphic * Open Class
* AS/400 * IBM * OS/390
* AS/400e * IBMLink * OS/400
* C Set ++ * Integrated Language Environment * RPG/400
* COBOL/2 * iSeries * SQL/400
* COBOL/400 * Language Environment * VisualAge
* DB2 * MQSeries * WebSphere

InstallShield 是 InstallShield 公司的商標。

Intel 與 Pentium 是 Intel 公司在美國及 (或) 其它國家的商標。

Java 與所有 Java 型商標和標誌是 Sun Microsystems, Inc. 在美國及其他國家的商標或註冊商標。

Rational 是 IBM 公司與 Rational Software 公司在美國及 (或) 其它國家的商標。

ActiveX、Microsoft、SourceSafe、Visual C++、Visual SourceSafe、Windows、 Windows NT、Win32、Win32s 與 Windows 標誌是 Microsoft 公司在美國及 (或) 其它國家的商標。

UNIX 是 The Open Group 的註冊商標。

其他公司、產品和服務的名稱可能是其他公司的商標或服務標記。