此資訊說明如何從 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.1.2 版之前應閱讀的其他資訊。若已安裝, 則可以在 X:\WDSC\install\help\migrate.htm 這類的目錄中找到手冊。
如果您需要特定資訊來瞭解移轉至第 5.1.2 版對工作區或專案所造成的影響, 您可以在基本 WebSphere Studio 產品所提供的移轉手冊中閱讀適用的章節。這份指南的所在位置,視您系統上 Development Studio Client 的版本而定。
在安裝後也可以使用本手冊,位置如下:
由於 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 項目。
本節說明如何將 Development Studio Client for iSeries 第 5.0 版中建立的「程式呼叫」Bean 移轉至第 5.1.2 版。
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
本節說明如何將 Development Studio Client for iSeries 第 5.0 版中建立的「程式呼叫」Bean 移轉至第 5.1.2 版。
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
本節說明如何將 Development Studio Client for iSeries 第 4.0 版中建立的「程式呼叫」Bean 移轉至第 5.1.2 版。
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.0 版、第 5.0.x 版或第 5.1.x 版的現有專案, 則當您啟動 5.1.2 工作台時,您可以指定較舊的工作區,並以現有方式執行方案。然而,專案顯示可能不完整。 例如,記錄 JSP 檔案與部份來自先前版本的樣式檔案不會出現在 5.1.2 樹狀檢視畫面中。
第一次轉換 DDS 檔案時,將更新專案結構以反映新的 5.1.2 佈置。 例如,新的執行時間 jar 檔案與範本檔案都會匯入。 如果特別指定「匯入」精靈,也會以同樣的方式執行這些作業。
如果您具有使用 WebSphere Development Studio Client 第 4.0 版、第 5.0 版或第 5.1 版的 WebFacing 專案, 您可以使用「匯入」精靈將這些專案移轉到 Development Studio Client 第 5.1.2 版。 請遵循下列步驟:
原始檔案具有下列格式的新名稱:檔案名稱 +_512_bak。
若您自訂 WebFacing 專案,就可能需要將自訂從原始檔案合併到下列檔案:
下列方法可以用來移轉 iSeries Web 專案:
此移轉作業包括在第 5.1.2 版的 IDE 中使用現有的工作區, 以及執行 iSeries Web Tools 移轉常式。
此移轉作業包括在第 5.1.2 版的 IDE 中使用現有的工作區, 以及執行 iSeries Web Tools 移轉常式。這項常式可將您的 Web 專案轉換成最新的 J2EE 層次。
下列資訊說明如何將 iSeries Web 專案從 Development Studio Client for iSeries 第 5.0.x 版與第 5.1 版, 移轉到 Development Studio Client for iSeries 第 5.1.2 版。
移轉活動包含下列階段:
在第 5.1.2 版中,您可以透過喜好設定頁面,來配置新 Web 專案的預設 Web 內容和 Java 原始程式資料夾名稱。 此時的預設名稱是 JavaResources 與 WebContent。這些預設的名稱將只會用於新的 Web 專案。在第 5.1.2 版之前的版本中建立的 Web 專案, 將可繼續使用舊名稱來運作。對於 Static Web 專案也可以繼續使用舊名稱。
您可以在「導覽器」檢視畫面中以滑鼠右鍵按一下資料夾名稱, 再按一下更名,即可在第 5.1.2 版以手動方式變更第 5.0.x 版或第 5.1 版專案的原始檔資料夾名稱。「更名」動作會更改資料夾名稱,並可修正 5.0.x 或 5.1 Web 專案的 Java 建置路徑。 如果您選擇更改第 5.1.2 版中的 JavaResources 和 WebContent 資料夾名稱, 則您所有的自動建置 Script,都必須以新的資料夾名稱以手動方式更新。
若要移轉 iSeries Web Tools 專案內容:
如果移轉處理發生問題,即會開啟視窗,指出發生的錯誤或警告,並說明這些資訊均記載於 Web 視景中專案名稱下的移轉日誌檔 projectName_MigrationDetails.txt。
移轉日誌檔頂端的「移轉結果」區段會指出移轉的整體結果, 並參照線上資訊的檔案,該檔案說明錯誤和警告,以及更正錯誤和警告時所採取的必要動作。請參閱 Web 專案移轉的警告和錯誤訊息。
針對 5.0.x 移轉,除了日誌檔中所列出的任何移轉警告外, 另外請注意,對於「文字項目 Web 元件」,已不再支援 Maximum length (maxLength) 屬性。這可能會影響到您網頁的視覺化外觀。
下列資訊說明如何將 iSeries Web 專案從 Development Studio Client for iSeries 第 4.0 版, 移轉到 Development Studio Client for iSeries 第 5.1.2 版。
移轉活動包含下列階段:
這個方法只受到部份的支援,且會造成不完整的移轉。 使用者介面設定值、除錯設定值及大部份的喜好設定都會遺失。 專案名稱、專案原始檔及專案 Java 建置路徑 (類別類徑) 會被保留, 但無法保證一切沒問題。 請在未使用支援的軟體配置管理 (SCM) 系統,以及必須保留專案建置路徑資訊 (該資訊會在您將專案從第 4.0 版匯入第 5.1.2 版時遺失) 時, 才使用這個方法。 遵循下列方法,您可以使用現有的第 4.0.x 版工作區:
第 4 版 EAR application.xml 檔及伺服器配置檔案均含有絕對路徑參照。 在您將它們移轉到第 5.1.2 版後,必須以其編輯器開啟這些檔案 (編輯器會將檔案舊有的絕對路徑參照,自動變更為新的相對參照)。
The IBM extensions file contains deprecated absolute paths. This can be auto-corrected... Would you like to autocorrect?
如果您嘗試在第 5.1.2 版產品中開啟第 4.0 版的工作區以進行移轉,則可能產生下列問題。
若要將 JRE_LIB 類別路徑變數重設為有效的位置,請遵循下列步驟。 當您第一次開啟「喜好設定」視窗時,即使值似乎是正確的,也請執行這項作業。
如果您沒有執行這項作業,則 JRE_LIB 的值可能會不正確,而造成 Java 檔案中許多建置的錯誤。
在一般檢查中,驗證所有其他類別路徑變數的值。
在 Eclipse 1.0 及 2.0 之間,團隊支援有明顯的變更。共用專案與儲存庫的方法也已經變更。
依預設,專案是建立在工作區目錄中。 如果您置換預設值,而在其他目錄中建立專案, 則在關閉工作區之台,請先開啟所有專案。 這可讓該專案的 .project 檔案寫入適當的位置。 無法開啟其目錄不在工作區內的已關閉專案, 會造成某一專案遮住了實際的專案,而在此專案中卻只有一個 .project 檔案。
請注意,「J2EE 移轉精靈」可以執行下列兩項功能:
若要移轉至 J2EE 專案結構:
下列移轉程序取決於 Web 專案是否已順利移轉至 J2EE 專案結構 (如前面小節中所述)。
若要移轉 iSeries Web Tools 專案內容:
移轉程序會執行下列動作:
如果移轉處理發生問題,即會開啟視窗,指出發生的錯誤或警告,並說明這些資訊均記載於 Web 視景中專案名稱下的移轉日誌檔 projectName_MigrationDetails.txt。
移轉日誌檔頂端的「移轉結果」區段會指出移轉的整體結果, 並參照線上資訊的檔案,該檔案說明錯誤和警告,以及更正錯誤和警告時所採取的必要動作。另請參閱 Development Studio Client for iSeries > Web 應用程式 > iSeries Web Development > 參照 > 移轉錯誤與警告明細下的線上說明。
除了上面階段 4 中說明之日誌檔中所列出的任何移轉錯誤之外,您還需要處理下列的項目:
除了上面階段 4 中說明之日誌檔中所列出的任何移轉警告之外,您還需要知道下列的變更,可能會影響到您網頁的視覺化外觀:
錯誤碼 | 說明 | 動作 |
---|---|---|
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 中已棄用,且大部分的瀏覽器都不支援 | 無。 |
若您讓「5.0 建置狀態」檢視畫面在 5.0 工作台中保持開啟, 5.1.2 將發生下列錯誤:
無法還原工作台佈置
按一下確定以繼續。 這是因為,使用「遠端系統瀏覽器」視景中的「iSeries 工作狀態」檢視畫面, 已取代「iSeries 專案」視景中的「建置狀態」檢視畫面。 任何出現在原始「建置狀態」檢視畫面中的建置,都不會出現在新的檢視畫面中。 重新建置相關的 iSeries 專案時,新建置會出現在「工作狀態」檢視畫面中, 且進行中的功能不受影響。
在移轉後,如果在 iSeries 專案上出現紅色旗標,這是因為與您專案相關的「遠端系統瀏覽器」連線已不存在。 若要解決此問題:
解除安裝 Development Studio Client 4.0 版之前,您應該匯出專案內容至主電腦機器。 接著,請安裝 Development Studio Client 第 5.1.2 版。在安裝之後,從「遠端系統瀏覽器」中執行一項動作,便可以重建這些專案。
若您已安裝 Development Studio Client for iSeries 第 5.1.2 版, 而且您知道自己尚未上載專案至遠端主電腦,請略過本節。
附註:重建專案另一個快速的方法,即從「遠端系統瀏覽器」的檔案庫選取建立 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 | *
![]() |
* 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 的註冊商標。
其他公司、產品和服務的名稱可能是其他公司的商標或服務標記。