iSeries-Webprojekte migrieren
Die folgenden Methoden können verwendet werden, um iSeries-Webprojekte zu migrieren:
- Migration von iSeries-Webprojekten unter Verwendung eines vorhandenen
Arbeitsbereichs von WebSphere Development
Studio Client Version 5.1.x
Bei dieser Migration müssen Sie Ihren vorhandenen Arbeitsbereich
in der Workbench in Version 6.0.1 verwenden und die Migrationsroutine der iSeries-Webtools ausführen.
- Migration von iSeries-Webprojekten unter Verwendung eines vorhandenen
Projekts von WebSphere Development
Studio Client Version 5.0
Bei dieser Migration müssen
Sie den Projektinhalt aus dem Dateisystem importieren und dann die Migrationsroutine der
iSeries-Webtools
ausführen.
- Migration von iSeries-Webprojekten unter Verwendung eines vorhandenen
Projekts von WebSphere Development
Studio Client Version 4.0
Bei dieser Migration müssen
Sie den Projektinhalt aus dem Dateisystem importieren und dann die Migrationsroutine der
iSeries-Webtools
ausführen.
Wichtig:
Stellen Sie sicher, dass alle Serverinstanzen gestoppt
werden, bevor Sie mit der Migration fortfahren.
iSeries-Webprojekte von Version 5.1.x auf Version 6.0.1 migrieren
Die folgenden Informationen beschreiben die Migration von iSeries-Webprojekten von Development Studio Client für iSeries Version 5.1.x
auf WebSphere Development Studio Client für iSeries Version 6.0.1.
Die Migrationsaktivitäten umfassen die folgenden Phasen:
- Migration von Projekten unter Verwendung eines vorhandenen
Arbeitsbereichs der Version 5.1.x
- Migration des Inhalts von iSeries-Webprojekten
- Adressierung von Fehlern und Warnungen, die infolge der Migration generiert wurden
Phase 1: Migration von Projekten
unter Verwendung eines vorhandenen Arbeitsbereichs der Version 5.1.x
In Version 6.0.1 können die Standardordnernamen für Webinhalte und Java-Quelle für neue Webprojekte über eine Seite mit Einstellungen
konfiguriert werden. Die Standardnamen sind jetzt WebContent und JavaSource. Diese Standardnamen
werden nur für neue Webprojekte verwendet. Webprojekte, die in Versionen vor Version 6.0.1 erstellt
wurden, können weiterhin mit den alten Namen verwendet werden.
- Beim Starten des Produkts der Version 6.0.1 (Start > Programme > IBM Rational > WebSphere Development Studio Client für iSeries) wird das Rational Software Developer Platform-Fenster
geöffnet, in dem Sie das Verzeichnis angeben können, das für die Sitzung
verwendet werden soll. Geben
Sie die Verzeichnisposition Ihres Arbeitsbereichs der Version 5.1.x in diesem Fenster an.
- Werden Sie aufgefordert zu bestätigen, dass die Konvertierung in das neue
Benutzerschnittstellenformat erfolgen soll, klicken Sie
OK an.
- Optional: Klicken Sie im Hauptmenü Fenster >
Einstellungen an. Erweitern Sie im linken Teilfenster Webtools und
wählen Sie Neues J2EE-Projekt aus. Definieren Sie im rechten
Teilfenster die Einstellungen für Ihre Standardordnernamen.
Sie können die Quellenordnernamen für Projekte der
Version 5.1.x in Version 6.0.1 manuell ändern, indem Sie mit der rechten Maustaste
den Ordnernamen in der Sicht "Projektexplorer" anklicken und "Refactoring"
auswählen und dann Umbenennen anklicken. Die
Aktion "Umbenennen" benennt die Ordnernamen um und legt den Java-Erstellungspfad
für die Webprojekte der Version 5.1.x fest. Wenn Sie die JavaSource- und
WebContent-Ordnernamen in Version 6.0.1 umbenennen möchten, müssen alle automatisierten
Erstellungsscripts, die Sie haben, manuell mit den neuen Ordnernamen aktualisiert werden.
Optional: Webprojekte nach Struts 1.1 konvertieren
Haben Sie Struts 1.1 Betaversion 2-Webprojekte in IBM WebSphere Studio Application Developer Version
5 erstellt, können Sie sie nach Struts 1.1 konvertieren. Dies ist jedoch
nicht erforderlich, da Struts 1.1 Betaversion 2 noch unterstützt wird.
Gehen Sie wie folgt vor, wenn Sie Struts 1.1 Betaversion 2-Webprojekte haben,
die nach Struts 1.1 konvertiert werden sollen:
- Erstellen Sie ein neues Struts 1.1-Webprojekt mit dem Namen Struts11. Damit
wird ein geeigneter Zugriff auf die Struts 1.1-Artefakte zur Verfügung gestellt,
die während der Konvertierung der realen Projekte erforderlich sind. Anschließend
können Sie dieses Projekt löschen.
- Führen Sie für jedes Struts 1.1 Betaversion 2-Projekt, das nach Struts
1.1 konvertiert werden soll, die folgenden Schritte aus:
- Löschen Sie die folgenden .jar-Dateien aus dem Verzeichnis Web Content/WEB-INF/lib Ihres Projekts: commons-*.jar und struts.jar.
- Kopieren Sie die folgenden .jar-Dateien aus dem Verzeichnis Struts11/WebContent/WEB-INF/lib in das Verzeichnis Web Content/WEB-INF/lib Ihres Projekts: commons-*.jar und struts.jar.
- Löschen Sie die folgenden .tld-Dateien aus dem Verzeichnis Web Content/WEB-INF Ihres Projekts: struts-*.tld.
- Kopieren Sie die folgenden .tld-Dateien aus dem Verzeichnis Struts11/WebContent/WEB-INF in das Verzeichnis Web Content/WEB-INF Ihres Projekts: struts-*.tld.
Phase 2: Migration des Inhalts von
iSeries-Webprojekten
Um den Inhalt eines iSeries-Webtoolsprojekts zu migrieren, gehen Sie wie
folgt vor:
- Klicken Sie mit der rechten Maustaste den Projektnamen in der Sicht
"Projektnavigator" der Webperspektive an und wählen Sie
Merkmale aus. Wählen Sie in der linken Anzeige
Funktionen des Webprojekts aus. Wählen Sie in der
Liste Verfügbare Funktionen des Webprojekts die
Option Struts aus, sofern diese noch nicht ausgewählt ist. Klicken
Sie OK an. Klicken Sie im Fenster "Funktionen des Webprojekts" Fertig
stellen an, um die standardmäßige Struts-Version (1.1) zu akzeptieren.
Anmerkung:
Wird dieser Schritt nicht ausgeführt, werden Sie in einem
Fenster aufgefordert, Struts-Unterstützung hinzuzufügen.
- Wichtig: An diesem Punkt müssen Sie das Projekt schließen und erneut
öffnen, um eine Ausnahmebedingung zu verhindern, die sich auf das Löschen von
Ressourcen bezieht, und um sicherzustellen, dass das Projekt auf keinen Servern
ausgeführt wird.
- Klicken Sie mit der rechten Maustaste den Projektnamen in der
Webperspektive an und wählen Sie Migrieren > iSeries-Webtoolsprojekt aus. Das Fenster "Migration bestätigen" zeigt
an, dass die Projektstruktur und der Projektinhalt migriert werden.
- Um den Prozess fortzusetzen, klicken Sie OK
an. In einem Fenster wird der Fortschritt der Migration angezeigt.
- Nach Abschluss der Migration zeigt eine Nachricht die Ergebnisse an.
- Wurde der Migrationsprozess erfolgreich abgeschlossen, ist keine weitere
Aktion erforderlich. Wurde der Migrationsprozess mit Fehlern oder Warnungen
beendet, fahren Sie mit Phase 3: Adressierung von Fehlern
und Warnungen, die infolge der Migration generiert wurden fort.
- Der Migrationsprozess führt die folgenden Aktionen aus:
- Er aktualisiert iSeries-Webkomponenten, Tag-Bibliotheken und JavaScript-Dateien (und aktualisiert alle JSP-Dateien entsprechend).
- Er regeneriert Dateien, die sich auf die Webinteraktion beziehen, auf der
Basis des Struts-Gerüsts aus den .wit-Dateien, und aktualisiert Laufzeitdateien
für die Webinteraktion.
- Er fügt Unterstützung für neue iSeries-Webtoolsfunktionen hinzu, die
in Version 6.0.1 verfügbar sind.
Phase 3: Adressierung von Fehlern
und Warnungen, die infolge der Migration generiert wurden
Treten während des Migrationsprozesses Fehler auf, wird ein Fenster
geöffnet, das angibt, dass Fehler oder Warnungen aufgetreten sind. Die
Migrationsprotokolldatei Projektname_MigrationDetails.txt,
die die Fehler beschreibt und die sich unter dem Projektnamen in der Webperspektive
befindet, wird ebenfalls geöffnet.
Der Abschnitt "Migrationsergebnis" am Anfang der Migrationsprotokolldatei
gibt den Gesamtstatus der Migration an und verweist auf eine Onlineversion der Tabelle
mit Warnungen und Fehlern weiter unten mit Beschreibungen und Korrekturmaßnahmen. Siehe Warnungen und Fehlernachrichten bei der Migration von Webprojekten.
iSeries-Webprojekte von Version 5.0 auf Version 6.0.1 migrieren
Die folgenden Informationen beschreiben die Migration von iSeries-Webprojekten von Development Studio Client für iSeries Version 5.0
auf WebSphere Development Studio Client für iSeries Version 6.0.1.
Die Migrationsaktivitäten umfassen die folgenden Phasen:
- Migration von Projekten unter Verwendung eines vorhandenen Webprojekts der
Version 5.0 in dem Dateisystem
- Migration des Inhalts von iSeries-Webprojekten
- Adressierung von Fehlern und Warnungen, die infolge der Migration generiert wurden
Phase 1: Migration eines vorhandenen Projekts der Version 5.0 in dem Dateisystem
auf Version 6.0.1
In Version 6.0.1 können die Standardordnernamen für Webinhalte und Java-Quelle für neue Webprojekte über eine Seite mit Einstellungen
konfiguriert werden. Die Standardnamen sind jetzt WebContent und JavaSource. Diese Standardnamen
werden nur für neue Webprojekte verwendet. Webprojekte, die in Versionen vor Version 6.0.1 erstellt
wurden, können weiterhin mit den alten Namen verwendet werden.
Führen Sie folgende Schritte aus, um den Inhalt des
Ordners mit Webinhalten zu migrieren:
- Beim Starten des Produkts der Version 6.0.1 (Start > Programme > IBM Rational > WebSphere Development Studio Client für iSeries) wird das Fenster des Startprogramms
für den Arbeitsbereich geöffnet, in dem Sie das Verzeichnis angeben können, das für die Sitzung
verwendet werden soll. Verwenden Sie die Standardposition als Arbeitsbereich.
- Wechseln Sie in die Ressourcenperspektive.
- Erstellen Sie ein neues dynamisches Webprojekt mit dem Namen und der Servletversion Ihres
vorhandenen Webprojekts der Version 5.0. Suchen Sie Ihre Servletversion in der Datei
.websettings Ihres vorhandenen Projekts der Version 5.0 und suchen Sie nach einem Tag jsp-level. Lautet der Wert für "jsp level" 1.2, setzen Sie die Servletversion auf
2.3. Andernfalls setzen Sie die Servletversion auf 2.2. Klicken Sie Fertig stellen an. Wechseln Sie nicht in die Webperspektive, wenn Sie aufgefordert werden.
- Wählen Sie den Ordner mit Webinhalten des neu erstellten Projekts aus, klicken Sie mit der
rechten Maustaste und wählen Sie Importieren aus dem Kontextmenü aus.
- Wählen Sie Dateisystem als Importquelle aus und klicken Sie
Weiter an. Klicken Sie den Knopf Durchsuchen an und wählen
Sie den Ordner mit Webinhalten (Standardname: Web Content) des vorhandenen
Webprojekts der Version 5.0 aus. Klicken Sie OK an.
- Wählen Sie den Ordner mit Webinhalten aus, aber markieren Sie nicht das
Kästchen. Klicken Sie Alles auswählen an. Wählen Sie im rechten
Fenster eine der Dateien ab und wählen Sie dann dieselbe Datei erneut aus. Dies hat den
Effekt, dass alles unter dem Ordner mit Webinhalten importiert wird, aber der Ordner mit
Webinhalten selbst nicht importiert wird.
- Wählen Sie im rechten Fenster die folgenden Dateien ab, wenn sie in der Liste erscheinen:
- \WebContent\WEB-INF\struts-*.tld
- \WebContent\WEB-INF\lib\struts.jar
- \WebContent\WEB-INF\lib\commons-*.jar
- \WebContent\WEB-INF\lib\jdbc2_0-stdext.jar
- Wählen Sie die Optionen Nur ausgewählte Ordner erstellen und Vorhandene Ressourcen ohne Warnung überschreiben aus und klicken Sie Fertig stellen an. Der Ordner mit Webinhalten des neu erstellten Projekts
sollte jetzt ähnliche Ressourcen und eine ähnliche Ordnerstruktur wie der Ordner mit Webinhalten
der Version 5.0 enthalten.
Führen Sie folgende Schritte aus, um den Inhalt des Java-Quellenordners zu migrieren:
- Wählen Sie den Java-Quellenordner des neu erstellten Projekts aus, klicken Sie mit der
rechten Maustaste und wählen Sie Importieren aus dem Kontextmenü aus.
- Wählen Sie Dateisystem als Importquelle aus und klicken Sie
Weiter an. Klicken Sie den Knopf Durchsuchen an und wählen
Sie den Java-Quellenordner (Standardname: Java Source) des vorhandenen Webprojekts der Version 5.0 aus. Klicken Sie OK an.
- Wählen Sie den Java-Quellenordner aus, aber markieren Sie nicht das
Kästchen. Klicken Sie Alles auswählen an. Wählen Sie im rechten
Fenster eine der Dateien ab und wählen Sie dann dieselbe Datei erneut aus. Dies hat den
Effekt, dass alles unter dem Java-Quellenordner importiert wird, aber der Java-Quellenordner
selbst nicht importiert wird.
- Wählen Sie die Optionen Nur ausgewählte Ordner erstellen und Vorhandene Ressourcen ohne Warnung überschreiben aus und klicken Sie Fertig stellen an. Der Java-Quellenordner des neu erstellten Projekts
sollte jetzt ähnliche Ressourcen und eine ähnliche Ordnerstruktur wie der Java-Quellenordner der Version 5.0 enthalten.
Führen Sie folgende Schritte aus, um den Inhalt des
Webprojektordners zu migrieren:
- Wählen Sie jetzt das neu erstellte Projekt aus, klicken Sie mit der rechten Maustaste
und wählen Sie Importieren aus dem Kontextmenü aus.
- Wählen Sie Dateisystem als Importquelle aus und klicken Sie
Weiter an. Klicken Sie den Knopf Durchsuchen an und wählen
Sie das vorhandene Webprojekt der Version 5.0 aus.
- Wählen Sie den Projektordner im linken Fenster aus und klicken Sie Alles auswählen an. Wählen Sie im rechten Fenster eine der Dateien ab und wählen Sie
dann dieselbe Datei erneut aus. Wählen Sie im linken Fenster den Ordner mit Webinhalten
und den Java-Quellenordner
ab. Dies hat den Effekt, dass alles unter dem Webprojektordner importiert wird, aber der Ordner
mit Webinhalten und der Java-Quellenordner sowie der
Webprojektordner selbst nicht importiert werden.
- Wählen Sie im rechten Fenster die folgenden Dateien ab, wenn sie in der Liste erscheinen:
- \WebContent\.classpath
- \WebContent\.project
- \WebContent\.websettings
- \WebContent\.serverPreference
Diese Dateien enthalten Informationen zu dem Projekt, die zur
Entwicklungszeit erforderlich sind. Die Informationen können nicht auf Version 6.0.1
migriert werden. Die Dateien werden daher bei Bedarf erneut erstellt.
- Wählen Sie die Optionen Nur ausgewählte Ordner erstellen und Vorhandene Ressourcen ohne Warnung überschreiben aus und klicken Sie Fertig stellen an. Der neu erstellte Webprojektordner sollte jetzt ähnliche
Ressourcen und eine ähnliche Ordnerstruktur wie der Webprojektordner der Version 5.0 enthalten.
Artefakte alter Struts-Stufen entfernen
- Klicken Sie mit der rechten Maustaste WebContent/WEB-INF/web.xml an. Wählen Sie
Öffnen mit > Editor für Implementierungsdeskriptor aus.
- Gehen Sie zur Registerkarte Servlets.
- Entfernen Sie den Servleteintrag, der dem Aktionsservlet der Servletklasse
org.apache.struts.action zugeordnet ist (Standardname action.
Phase 2: Migration des Inhalts von
iSeries-Webprojekten
Um den Inhalt eines iSeries-Webtoolsprojekts zu migrieren, gehen Sie wie
folgt vor:
- Klicken Sie mit der rechten Maustaste den Projektnamen in der Sicht
"Projektnavigator" der Webperspektive an und wählen Sie
Merkmale aus. Wählen Sie in der linken Anzeige
Funktionen des Webprojekts aus. Wählen Sie in der
Liste Verfügbare Funktionen des Webprojekts die
Option Struts aus, sofern diese noch nicht ausgewählt ist. Klicken
Sie OK an. Klicken Sie im Fenster "Funktionen des Webprojekts" Fertig
stellen an, um die standardmäßige Struts-Version (1.1) zu akzeptieren.
Anmerkung:
Wird dieser Schritt nicht ausgeführt, werden Sie in einem
Fenster aufgefordert, Struts-Unterstützung hinzuzufügen.
- Wichtig: An diesem Punkt müssen Sie das Projekt schließen und erneut
öffnen, um eine Ausnahmebedingung zu verhindern, die sich auf das Löschen von
Ressourcen bezieht, und um sicherzustellen, dass das Projekt auf keinen Servern
ausgeführt wird.
- Klicken Sie mit der rechten Maustaste den Projektnamen in der
Webperspektive an und wählen Sie Migrieren > iSeries-Webtoolsprojekt aus. Das Fenster "Migration bestätigen" zeigt
an, dass die Projektstruktur und der Projektinhalt migriert werden.
- Um den Prozess fortzusetzen, klicken Sie OK
an. In einem Fenster wird der Fortschritt der Migration angezeigt.
- Nach Abschluss der Migration zeigt eine Nachricht die Ergebnisse an.
- Wurde der Migrationsprozess erfolgreich abgeschlossen, ist keine weitere
Aktion erforderlich. Wurde der Migrationsprozess mit Fehlern oder Warnungen
beendet, fahren Sie mit Phase 3: Adressierung von Fehlern
und Warnungen, die infolge der Migration generiert wurden fort.
- Der Migrationsprozess führt die folgenden Aktionen aus:
- Er aktualisiert iSeries-Webkomponenten, Tag-Bibliotheken und JavaScript-Dateien (und aktualisiert alle JSP-Dateien entsprechend).
- Er regeneriert Dateien, die sich auf die Webinteraktion beziehen, auf der
Basis des Struts-Gerüsts aus den .wit-Dateien, und aktualisiert Laufzeitdateien
für die Webinteraktion.
- Er fügt Unterstützung für neue iSeries-Webtoolsfunktionen hinzu, die
in Version 6.0 verfügbar sind.
Phase 3: Adressierung von Fehlern
und Warnungen, die infolge der Migration generiert wurden
Treten während des Migrationsprozesses Fehler auf, wird ein Fenster
geöffnet, das angibt, dass Fehler oder Warnungen aufgetreten sind. Die
Migrationsprotokolldatei Projektname_MigrationDetails.txt,
die die Fehler beschreibt und die sich unter dem Projektnamen in der Webperspektive
befindet, wird ebenfalls geöffnet.
Der Abschnitt "Migrationsergebnis" am Anfang der Migrationsprotokolldatei
gibt den Gesamtstatus der Migration an und verweist auf eine Onlineversion der Tabelle
mit Warnungen und Fehlern weiter unten mit Beschreibungen und Korrekturmaßnahmen. Siehe Warnungen und Fehlernachrichten bei der Migration von Webprojekten.
Bei der 5.0.x.-Migration sollten Sie zusätzlich zu den Migrationswarnungen
in der Protokolldatei beachten, dass das Attribut für die maximale Länge
(maxLength) für die Webkomponente "Texteintrag" nicht mehr unterstützt wird. Dies
kann Auswirkungen auf die visuelle Darstellung Ihrer Webseiten haben.
iSeries-Webprojekte von Version 4.0 auf Version 6.0.1 migrieren
Die folgenden Informationen beschreiben die Migration von iSeries-Webprojekten von Development Studio Client für iSeries Version 4.0
auf WebSphere Development Studio Client für iSeries Version 6.0.1.
Die Migrationsaktivitäten umfassen die folgenden Phasen:
- Migration von Projekten unter Verwendung eines vorhandenen Webprojekts der
Version 4.0 in dem Dateisystem
- Migration des Inhalts von iSeries-Webprojekten
- Adressierung von Fehlern und Warnungen, die infolge der Migration generiert wurden
Phase 1: Migration eines vorhandenen Projekts der Version 4.0 in dem Dateisystem
auf Version 6.0.1
In Version 6.0.1 können die Standardordnernamen für Webinhalte und Java-Quelle für neue Webprojekte über eine Seite mit Einstellungen
konfiguriert werden. Die Standardnamen sind jetzt WebContent und JavaSource. Diese Standardnamen
werden nur für neue Webprojekte verwendet. Webprojekte, die in Versionen vor Version 6.0.1 erstellt
wurden, können weiterhin mit den alten Namen verwendet werden.
Führen Sie folgende Schritte aus, um den Inhalt des
Ordners mit Webinhalten zu migrieren:
- Beim Starten des Produkts der Version 6.0.1 (Start > Programme > IBM Rational > WebSphere Development Studio Client für iSeries) wird das Fenster des Startprogramms
für den Arbeitsbereich geöffnet, in dem Sie das Verzeichnis angeben können, das für die Sitzung
verwendet werden soll. Verwenden Sie die Standardposition als Arbeitsbereich.
- Wechseln Sie in die Ressourcenperspektive.
- Erstellen Sie ein neues dynamisches Webprojekt mit dem Namen und der Servletversion Ihres
vorhandenen Webprojekts der Version 4.0. Suchen Sie Ihre Servletversion in der Datei
.websettings Ihres vorhandenen Projekts der Version 4.0 und suchen Sie nach einem Tag jsp-level. Lautet der Wert für "jsp level" 1.2, setzen Sie die Servletversion auf
2.3. Andernfalls setzen Sie die Servletversion auf 2.2. Klicken Sie Fertig stellen an. Wechseln Sie nicht in die Webperspektive, wenn Sie aufgefordert werden.
- Wählen Sie den Ordner mit Webinhalten des neu erstellten Projekts aus, klicken Sie mit der
rechten Maustaste und wählen Sie Importieren aus dem Kontextmenü aus.
- Wählen Sie Dateisystem als Importquelle aus und klicken Sie
Weiter an. Klicken Sie den Knopf Durchsuchen an und wählen
Sie den Ordner mit Webinhalten (Standardname webApplication) des vorhandenen Webprojekts der Version 4.0 aus. Klicken Sie OK an.
- Wählen Sie den Ordner mit Webinhalten aus, aber markieren Sie nicht das
Kästchen. Klicken Sie Alles auswählen an. Wählen Sie im rechten
Fenster eine der Dateien ab und wählen Sie dann dieselbe Datei erneut aus. Dies hat den
Effekt, dass alles unter dem Ordner mit Webinhalten importiert wird, aber der Ordner mit
Webinhalten selbst nicht importiert wird.
- Wählen Sie die Optionen Nur ausgewählte Ordner erstellen und Vorhandene Ressourcen ohne Warnung überschreiben aus und klicken Sie Fertig stellen an. Der Ordner mit Webinhalten des neu erstellten Projekts
sollte jetzt ähnliche Ressourcen und eine ähnliche Ordnerstruktur wie der Ordner mit Webinhalten
der Version 4.0 enthalten.
Führen Sie folgende Schritte aus, um den Inhalt des Java-Quellenordners zu migrieren:
- Wählen Sie den Java-Quellenordner des neu erstellten Projekts aus, klicken Sie mit der
rechten Maustaste und wählen Sie Importieren aus dem Kontextmenü aus.
- Wählen Sie Dateisystem als Importquelle aus und klicken Sie
Weiter an. Klicken Sie den Knopf Durchsuchen an und wählen
Sie den Java-Quellenordner (Standardname: source)
des vorhandenen Webprojekts der Version 4.0 aus. Klicken Sie OK an.
- Wählen Sie den Java-Quellenordner aus, aber markieren Sie nicht das
Kästchen. Klicken Sie Alles auswählen an. Wählen Sie im rechten
Fenster eine der Dateien ab und wählen Sie dann dieselbe Datei erneut aus. Dies hat den
Effekt, dass alles unter dem Java-Quellenordner importiert wird, aber der Java-Quellenordner
selbst nicht importiert wird.
- Wählen Sie die Optionen Nur ausgewählte Ordner erstellen und Vorhandene Ressourcen ohne Warnung überschreiben aus und klicken Sie Fertig stellen an. Der Java-Quellenordner des neu erstellten Projekts
sollte jetzt ähnliche Ressourcen und eine ähnliche Ordnerstruktur wie der Java-Quellenordner der Version 4.0 enthalten.
Führen Sie folgende Schritte aus, um den Inhalt des
Webprojektordners zu migrieren:
- Wählen Sie jetzt das neu erstellte Projekt aus, klicken Sie mit der rechten Maustaste
und wählen Sie Importieren aus dem Kontextmenü aus.
- Wählen Sie Dateisystem als Importquelle aus und klicken Sie
Weiter an. Klicken Sie den Knopf Durchsuchen an
und wählen Sie das vorhandene Webprojekt der Version 4.0 aus.
- Wählen Sie den Projektordner im linken Fenster aus und klicken Sie Alles auswählen an. Wählen Sie im rechten Fenster eine der Dateien ab und wählen Sie
dann dieselbe Datei erneut aus. Wählen Sie im linken Fenster den Ordner mit Webinhalten
und den Java-Quellenordner
ab. Dies hat den Effekt, dass alles unter dem Webprojektordner importiert wird, aber der Ordner
mit Webinhalten und der Java-Quellenordner sowie der
Webprojektordner selbst nicht importiert werden.
- Wählen Sie im rechten Fenster die folgenden Dateien ab, wenn sie in der Liste erscheinen:
- \WebContent\.classpath
- \WebContent\.project
- \WebContent\.websettings
- \WebContent\.serverPreference
Diese Dateien enthalten Informationen zu dem Projekt, die zur
Entwicklungszeit erforderlich sind. Die Informationen können nicht auf Version 6.0.1
migriert werden. Die Dateien werden daher bei Bedarf erneut erstellt.
- Wählen Sie die Optionen Nur ausgewählte Ordner erstellen und Vorhandene Ressourcen ohne Warnung überschreiben aus und klicken Sie Fertig stellen an. Der neu erstellte Webprojektordner sollte jetzt ähnliche
Ressourcen und eine ähnliche Ordnerstruktur wie der Webprojektordner der Version 4.0 enthalten.
Phase 2: Migration des Inhalts von
iSeries-Webprojekten
Um den Inhalt eines iSeries-Webtoolsprojekts zu migrieren, gehen Sie wie
folgt vor:
- Klicken Sie mit der rechten Maustaste den Projektnamen in der Sicht
"Projektnavigator" der Webperspektive an und wählen Sie
Merkmale aus. Wählen Sie in der linken Anzeige
Funktionen des Webprojekts aus. Wählen Sie in der
Liste Verfügbare Funktionen des Webprojekts die
Option Struts aus, sofern diese noch nicht ausgewählt ist. Klicken
Sie OK an. Klicken Sie im Fenster "Funktionen des Webprojekts" Fertig
stellen an, um die standardmäßige Struts-Version (1.1) zu akzeptieren.
Anmerkung:
Wird dieser Schritt nicht ausgeführt, werden Sie in einem
Fenster aufgefordert, Struts-Unterstützung hinzuzufügen.
- Wichtig: An diesem Punkt müssen Sie das Projekt schließen und erneut
öffnen, um eine Ausnahmebedingung zu verhindern, die sich auf das Löschen von
Ressourcen bezieht, und um sicherzustellen, dass das Projekt auf keinen Servern
ausgeführt wird.
- Klicken Sie mit der rechten Maustaste den Projektnamen in der
Webperspektive an und wählen Sie Migrieren > iSeries-Webtoolsprojekt aus. Das Fenster "Migration bestätigen" zeigt
an, dass die Projektstruktur und der Projektinhalt migriert werden.
- Um den Prozess fortzusetzen, klicken Sie OK
an. In einem Fenster wird der Fortschritt der Migration angezeigt.
- Nach Abschluss der Migration zeigt eine Nachricht die Ergebnisse an.
- Wurde der Migrationsprozess erfolgreich abgeschlossen, ist keine weitere
Aktion erforderlich. Wurde der Migrationsprozess mit Fehlern oder Warnungen
beendet, fahren Sie mit Phase 3: Adressierung von Fehlern
und Warnungen, die infolge der Migration generiert wurden fort.
- Der Migrationsprozess führt die folgenden Aktionen aus:
- Er aktualisiert iSeries-Webkomponenten, Tag-Bibliotheken und JavaScript-Dateien (und aktualisiert alle JSP-Dateien entsprechend).
- Er regeneriert Dateien, die sich auf die Webinteraktion beziehen, auf der
Basis des Struts-Gerüsts aus den .wit-Dateien, und aktualisiert Laufzeitdateien
für die Webinteraktion.
- Er fügt Unterstützung für neue iSeries-Webtoolsfunktionen hinzu, die
in Version 6.0 verfügbar sind.
Phase 3: Adressierung von Fehlern
und Warnungen, die infolge der Migration generiert wurden
Treten während des Migrationsprozesses Fehler auf, wird ein Fenster
geöffnet, das angibt, dass Fehler oder Warnungen aufgetreten sind. Die
Migrationsprotokolldatei Projektname_MigrationDetails.txt,
die die Fehler beschreibt und die sich unter dem Projektnamen in der Webperspektive
befindet, wird ebenfalls geöffnet.
Der Abschnitt "Migrationsergebnis" am Anfang der Migrationsprotokolldatei
gibt den Gesamtstatus der Migration an und verweist auf eine Onlineversion der Tabelle
mit Warnungen und Fehlern weiter unten mit Beschreibungen und Korrekturmaßnahmen. Siehe Warnungen und Fehlernachrichten bei der Migration von Webprojekten.
Zusätzliche Überlegungen zur Migration
Zusätzlich zu den Migrationsfehlern, die in der oben beschriebenen Protokolldatei aufgelistet
sind, müssen Sie auch die folgenden Punkte beachten (sofern zutreffend):
- Stellen Sie sicher, dass Sie eine neue Version des Subdateiserviceprogramms
QDTSSFL auf Ihren iSeries-Host zurückspeichern. Dieses Serviceprogramm ist zum Bearbeiten
des Subdateibenutzeradressbereichs mit den Subdatei-APIs erforderlich.
Anweisungen zum Zurückspeichern des Serviceprogramms befinden sich unter
dem Hilfethema "Subdateiserviceprogramm QDTSSFL". Klicken Sie Hilfe > Inhaltsverzeichnis der Hilfetexte an. Klicken Sie dann Referenz
> Benutzerschnittstellenreferenz > iSeries-Webanwendungen > iSeries-Webkomponenten
> Subdatei-APIs an.
- Der Datenformatbereich, der von einem Hostprogramm für eine Webkomponente
"Kombiniertes Feld" zurückgegeben wird, kann jetzt eines von zwei Formaten haben. Daher
müssen Sie möglicherweise Ihr Programm ändern, um das gewünschte Datenformatergebnis
in dem kombinierten Feld zu erhalten. Weitere Informationen zu Datenformaten
enthält der Abschnitt "Registerkarte Daten" in der Onlinehilfe unter
Referenz > Benutzerschnittstellenreferenz
> iSeries-Webanwendungen > iSeries-Webkomponenten > Webkomponente "Kombiniertes Feld".
Zusätzlich zu den Migrationswarnungen, die in der Protokolldatei aufgelistet
sind, die in Phase 4 beschrieben wurde, sollten Sie die folgenden Änderungen
beachten, die die visuelle Darstellung Ihrer Webseiten beeinflussen können:
- Die folgenden Merkmale der Entwurfszeitsteuerangabe für Tabellen
werden in der entsprechenden Webkomponente "Tabelle" nicht mehr
unterstützt:
- Zellenauffüllung
- Zellenabstand
- Rahmengröße
- Ausrichtung
- Tabellenbreite
- Tabellenhöhe
- Die Merkmale "Zellenvordergrund" und "Zellenhintergrund" eines Tabellen-DTC
gelten nicht individuell für die Spaltenfarben einer Webkomponente "Tabelle".
Die Farbe, die für alle Spalten verwendet wird, ist die Farbe, die für die
erste Spalte der Tabelle definiert ist.
- Die Merkmale "Sichtbare Breite", "Großschreibung" und "Lesezugriff", die
einer Spalte "Eingabefeld" in einem Tabellen-DTC zugeordnet sind, werden in der
entsprechenden Spalte "Texteintrag" in einer Webkomponente "Tabelle" nicht
unterstützt.
- Der Knopf zum Zurückblättern, der Knopf zum Vorblättern und der Knopf für
Auswahlspalte im Subdatei-DTC werden in der entsprechenden Webkomponente
"Tabelle" nicht unterstützt.
- Feldnamenwerte, die in DTCs angegeben wurden, werden in Namenswerte in den entsprechenden
Webkomponenten migriert. Alle Punkte (.) werden in dem Namenswert durch
Unterstreichungszeichen (_) ersetzt. Außerdem kann das erste Zeichen des
Feldnamens für ein DTC im Namenswert für die entsprechende Webkomponente in
Kleinbuchstaben konvertiert werden.
- Sie können nicht mehr ein Webkomponentenattribut zur Laufzeit ändern, wenn eine
angegebene Bedingung auftritt. Wenn Sie mit der Registerkarte für die
DTC-Laufzeitattribute eine Bedingung definiert haben, die (wenn sie eintritt) ein
DTC-Attribut zur Laufzeit ändert (beispielsweise eine Änderung in der Schriftgröße),
wird das entsprechende Webkomponentenattribut nicht mehr geändert, wenn diese Bedingung
auftritt.
Warnungen und Fehlernachrichten bei der Migration von Webprojekten
Fehlercode |
Beschreibung |
Aktion |
E100 |
Während der Migration der JSP-Datei ist ein unbestimmter
Fehler aufgetreten. |
Beheben oder adressieren Sie alle anderen Fehler oder
Warnungen in der Migrationsprotokolldatei und führen Sie das Migrationstool
erneut aus. |
E101 |
Für eine iSeries-Webkomponente in der JSP-Datei liegt ein
Fehler vor. |
Beheben Sie den Fehler in der iSeries-Webkomponente. |
E200 |
Die Verarbeitung der .wit-Datei hatte einen unbestimmten
Fehler zur Folge. |
Klicken Sie die fehlerhafte .wit-Datei doppelt an, um den
Assistenten für Webinteraktion aufzurufen. Durchlaufen Sie
alle Seiten des Assistenten und führen Sie alle erforderlichen Änderungen durch. Klicken
Sie "Fertig stellen" an. |
E201 |
Ein oder mehrere Webkomponentennamen, die auf den in dieser
Interaktion verwendeten Seiten definiert sind, sind ungültig. |
Klicken Sie die fehlerhafte .wit-Datei doppelt an, um den
Assistenten für Webinteraktion aufzurufen. Ein Fenster, das angibt, dass
Webkomponentennamen ungültig sind, wird geöffnet, und Sie werden gefragt, ob die Namen geändert
werden sollen. Klicken Sie Ja an. Nehmen Sie alle erforderlichen Änderungen
vor. Für alle Webkomponenten, die geänderte Eingabe- oder Ausgabeparameter haben, geben Sie
die Optionen "Name in Sitzung", "In Sitzung sichern" und "Verbinden" an. Durchlaufen Sie
alle Seiten des Assistenten und führen Sie alle erforderlichen Änderungen durch. Klicken Sie "Fertig stellen"
an. |
E202 |
Für einen in dieser Interaktion definierten Ausgabeparameter
war der Wert für "Nachrichtenanzeiger" auf "wahr" gesetzt. Die erweiterte
Nachrichtenbehandlung hat sich in diesem Release entscheidend geändert. Sie
müssen die Optionen zur Nachrichtenbehandlung erneut definieren. |
Klicken Sie die fehlerhafte .wit-Datei doppelt an, um den
Assistenten für Webinteraktion aufzurufen. Setzen Sie auf der Seite
"Ausgabeparameter den Ausgabefeldern zuordnen und mit den Feldern verbinden"
den Wert für den Nachrichtenanzeiger auf "wahr". Sie können jetzt den Knopf sehen;
klicken Sie den Knopf an und definieren Sie die Nachrichtensteuerungsspezifikationen. |
E300 |
Beim Verarbeiten des DTC und/oder der resultierenden
iSeries-Webkomponente
ist ein unbestimmter Fehler aufgetreten. |
Beheben oder adressieren Sie alle anderen Fehler oder
Warnungen in der Migrationsprotokolldatei. Benennen Sie die
Migrationsprotokolldatei um und führen Sie das Migrationstool erneut aus. |
E301–E302 |
Das Merkmal der Entwurfszeitsteuerangabe für Druckknöpfe und
"Nächste/Vorherige" wird nicht mehr unterstützt. Das Attribut für die Knopfart der Webkomponente
"Knopf" wird mit "Übergeben" definiert. |
Erstellen Sie mit Hilfe des Assistenten für Webinteraktion
eine Interaktion, um die Seite, die den Knopf Nächste/Vorherige enthielt, als
Eingabe-JSP-Seite und die Zielseite des Knopfs "Nächste" als Ausgabe-JSP-Seite
anzugeben. In Version 4.0 wurde der Knopf Nächste/Vorherige mit mehreren
Eingabeseiten verwendet. Klicken Sie Hilfe >
Inhaltsverzeichnis der Hilfetexte an, um das Hilfesystem zu öffnen. Klicken Sie dann Referenz > Benutzerschnittstellenreferenz > iSeries-Webanwendungen > Mehrere Eingabe- und Ausgabeseiten an. |
E400 |
Während der Migration der Codegenerierungsschablonendatei
ist ein unbestimmter Fehler aufgetreten. |
Stellen Sie sicher, dass die Codegenerierungsschablonen nicht
schreibgeschützt sind. Adressieren Sie alle anderen Fehler oder
Warnungen in der Migrationsprotokolldatei und führen Sie das Migrationstool
erneut aus. |
E401 |
Die Codegenerierungsschablonendatei wurde angepasst.
Verwenden Sie die neuere Version der Schablone. |
Stellen Sie sicher, dass die Anpassungen, die Sie an der älteren Version
der Schablone vorgenommen haben, auch an der neueren Version der Schablone vorgenommen wurden.
Beispielsweise muss der angepasste Inhalt in <Position_des_Arbeitsbereichs>\metadata\ plugins\com.ibm.etools.iseries. webtools\iseriesPgmCallAction.
template.bak korrekt in <Position_des_Arbeitsbereichs>\metadata\ plugins\com.ibm.etools.iseries. webtools\iseriesPgmCallAction.
template eingefügt werden. |
Warncode |
Beschreibung |
Aktion |
W100 |
Für eine iSeries-Webkomponente auf der JSP-Seite liegt eine
Warnung vor. |
Adressieren Sie die Warnung für die iSeries-Webkomponente. |
W300 |
Ein Listenfenster oder ein kombiniertes Feld enthielt mehr
als ein Zeichen für das Merkmal "Begrenzer". Das erste im Merkmal "Begrenzer"
gefundene Zeichen wird für das entsprechende Attribut für den Begrenzer der
iSeries-Webkomponente
verwendet. |
Stellen Sie sicher, dass für alle Optionen der Webkomponente
"Auswahlfenster" oder "Kombiniertes Feld" die Attribute für den Namen und den Wert
korrekt definiert sind. |
W301–W302 |
Ein Listenfenster oder ein kombiniertes Feld enthielt das
Vorauswahlzeichen * in einem Datenmerkmal [Schlüssel] oder [Wert]. |
Stellen Sie sicher, dass für alle Optionen der Webkomponente
"Auswahlfenster" oder "Kombiniertes Feld" die Attribute für den Namen und den Wert
korrekt definiert sind. |
W303 |
Alle Radioknopf-DTCs in einer JSP-Datei, die dasselbe
Merkmal "Gruppenname" haben, werden jetzt als eine Option einer Webkomponente
"Radioknopfgruppe" angezeigt. Die auf der Registerkarte "Schriftart" und auf
der Registerkarte "Farbe" definierten Merkmale für den ersten auf der JSP-Seite
gefundenen Radioknopf werden als die Attribute für die Farbe und die Schriftart
für die Radioknopfgruppe verwendet. Das heißt, die Merkmale auf der
Registerkarte "Farbe" und der Registerkarte "Schriftart" gehen für nachfolgende
Radioknöpfe in derselben Gruppe verloren. |
Stellen Sie sicher, dass die Radioknopfgruppe wie gewünscht
auf der JSP-Seite angezeigt wird, indem Sie die zugehörige JSP-Datei auswählen
und die Datei auf dem Server ausführen. Stellen Sie sicher, dass die Attribute
für die Schriftart und die Farbe für die Radioknopfgruppe wie gewünscht
erscheinen, indem Sie die zugehörige JSP-Datei auswählen und auf dem Server
ausführen. |
W304 |
Das Merkmal "Bezeichnung" für den Druckknopf wird nicht mehr
unterstützt. Das Merkmal "Wert" für den Druckknopf wurde dem Attribut
"Bezeichnung" der zugehörigen Webkomponente "Knopf" zugeordnet. Der Text, der
auf der Webkomponente "Knopf" angezeigt wird, ist nicht mit dem Text für die
Entwurfszeitsteuerangabe "Druckknopf" identisch. |
Ändern Sie den Wert des Attributs "Bezeichnung", wenn der
auf der Webkomponente "Knopf" angezeigte Text nicht geeignet ist. |
W305 |
Die Entwurfszeitsteuerangabe "Subdatei" oder "Tabelle"
wird jetzt außerhalb des HTML-Tags FORM angezeigt. Eine Webkomponente "Tabelle" kann nicht innerhalb
eines HTML-Tags FORM angezeigt werden. War der Typ der Entwurfszeitsteuerangabe "Subdatei",
ist die entsprechende iSeries-Webkomponente eine Webkomponente "Tabelle". |
Stellen Sie sicher, dass die Webkomponente "Tabelle" wie
gewünscht auf der JSP-Seite angezeigt wird. |
W306–W320 |
Ein DTC-Ereignismerkmal wird nicht mehr unterstützt.
- W306 - OnDblClick
- W307 - OnMouseDown
- W308 - OnMouseOut
- W309 - OnMouseOver
- W310 - OnSelect
- W312 - OnChange für Radioknöpfe
- W313 - OnChange für Markierungsfelder
- W314 - OnMouseUp
- W315 - OnKeyDown für Radioknöpfe
- W316 - OnKeyPress für Radioknöpfe
- W317 - OnKeyUp für Radioknöpfe
- W318 - OnKeyDown für Druckknöpfe
- W319 - OnKeyPress für Druckknöpfe
- W320 - OnKeyUp für Druckknöpfe
|
Definieren Sie, falls erforderlich, die zugehörige Aktion
mit einem anderen Ereignis. |
W321 |
Für die Webkomponente war ein Attribut definiert, das nicht
mehr unterstützt wird, da 1) das zugehörige CSS-Attribut von den meisten
Browsern nicht unterstützt wird 2) das zugehörige HTML-Attribut bereits in
HTML 4.0 veraltet ist und von den meisten Browsern nicht unterstützt wird. |
Keine. |
(C) Copyright IBM Corporation 1992, 2006. All Rights Reserved.