iSeries-Webprojekte migrieren

Die folgenden Methoden können verwendet werden, um iSeries-Webprojekte zu migrieren:

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:

  1. Migration von Projekten unter Verwendung eines vorhandenen Arbeitsbereichs der Version 5.1.x
  2. Migration des Inhalts von iSeries-Webprojekten
  3. 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.

  1. 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.
  2. Werden Sie aufgefordert zu bestätigen, dass die Konvertierung in das neue Benutzerschnittstellenformat erfolgen soll, klicken Sie OK an.
  3. 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:

  1. 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.
  2. Führen Sie für jedes Struts 1.1 Betaversion 2-Projekt, das nach Struts 1.1 konvertiert werden soll, die folgenden Schritte aus:
    1. Löschen Sie die folgenden .jar-Dateien aus dem Verzeichnis Web Content/WEB-INF/lib Ihres Projekts: commons-*.jar und struts.jar.
    2. 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.
    3. Löschen Sie die folgenden .tld-Dateien aus dem Verzeichnis Web Content/WEB-INF Ihres Projekts: struts-*.tld.
    4. 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:

  1. 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.
  2. 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.
  3. 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.
  4. Um den Prozess fortzusetzen, klicken Sie OK an. In einem Fenster wird der Fortschritt der Migration angezeigt.
  5. Nach Abschluss der Migration zeigt eine Nachricht die Ergebnisse an.
  6. 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.
  7. Der Migrationsprozess führt die folgenden Aktionen aus:

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:

  1. Migration von Projekten unter Verwendung eines vorhandenen Webprojekts der Version 5.0 in dem Dateisystem
  2. Migration des Inhalts von iSeries-Webprojekten
  3. 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:

  1. 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.
  2. Wechseln Sie in die Ressourcenperspektive.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. Wählen Sie im rechten Fenster die folgenden Dateien ab, wenn sie in der Liste erscheinen:
  8. 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:

  1. 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.
  2. 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.
  3. 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.
  4. 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:

  1. Wählen Sie jetzt das neu erstellte Projekt aus, klicken Sie mit der rechten Maustaste und wählen Sie Importieren aus dem Kontextmenü aus.
  2. 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.
  3. 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.
  4. Wählen Sie im rechten Fenster die folgenden Dateien ab, wenn sie in der Liste erscheinen:

    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.

  5. 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

  1. Klicken Sie mit der rechten Maustaste WebContent/WEB-INF/web.xml an. Wählen Sie Öffnen mit > Editor für Implementierungsdeskriptor aus.
  2. Gehen Sie zur Registerkarte Servlets.
  3. 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:

  1. 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.
  2. 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.
  3. 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.
  4. Um den Prozess fortzusetzen, klicken Sie OK an. In einem Fenster wird der Fortschritt der Migration angezeigt.
  5. Nach Abschluss der Migration zeigt eine Nachricht die Ergebnisse an.
  6. 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.
  7. Der Migrationsprozess führt die folgenden Aktionen aus:

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:

  1. Migration von Projekten unter Verwendung eines vorhandenen Webprojekts der Version 4.0 in dem Dateisystem
  2. Migration des Inhalts von iSeries-Webprojekten
  3. 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:

  1. 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.
  2. Wechseln Sie in die Ressourcenperspektive.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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:

  1. 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.
  2. 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.
  3. 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.
  4. 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:

  1. Wählen Sie jetzt das neu erstellte Projekt aus, klicken Sie mit der rechten Maustaste und wählen Sie Importieren aus dem Kontextmenü aus.
  2. 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.
  3. 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.
  4. Wählen Sie im rechten Fenster die folgenden Dateien ab, wenn sie in der Liste erscheinen:

    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.

  5. 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:

  1. 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.
  2. 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.
  3. 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.
  4. Um den Prozess fortzusetzen, klicken Sie OK an. In einem Fenster wird der Fortschritt der Migration angezeigt.
  5. Nach Abschluss der Migration zeigt eine Nachricht die Ergebnisse an.
  6. 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.
  7. Der Migrationsprozess führt die folgenden Aktionen aus:

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):

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:

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.