Migration von WebSphere Portal V4.2-Portlets auf V5.x

Rational Application Developer V6.0 unterstützt nicht die Entwicklung von Portlets unter WebSphere Portal V4.2. Portletprojekte aus WebSphere Portal V4.2 müssen auf V5.x migriert werden.

Die meisten für WebSphere Portal V4.2 geschriebenen Portlets können ohne Änderungen in WebSphere Portal V5.x ausgeführt werden. Einige der Portlet 4.2.x-APIs sind nun als veraltet markiert, stehen jedoch weiterhin in WebSphere Portal V5.x zur Verfügung.

Anmerkung: Migrierte Portletanwendungsprojekte sind nicht abwärts kompatibel.
Gehen Sie wie folgt vor, um Portletanwendungen für WebSphere Portal V4.2 auf V5.x zu migrieren:
  1. Migrieren Sie die Portal V4.2-Portletprojekte auf Portal V5.x-Portletprojekte:
    1. Klicken Sie mit der rechten Maustaste auf das Portletanwendungsprojekt, das Sie migrieren wollen.
    2. Wählen Sie Eigenschaften > Portlet-API aus, um die Seite für Portlet-APIs aufzurufen.
    3. Wählen Sie in der Dropdown-Liste für die Portlet-API-Stufe WebSphere Portal Version 5.x aus.
    4. Klicken Sie auf OK. Es werden automatisch die folgenden Änderungen vorgenommen:
      • Die TLD-Datei (TLD, Tag Library Descriptor) für die Portlet-API wird entfernt, falls vorhanden.
      • Die Webstufe wird von 2.2 in 2.3 geändert.
      • Die portletspezifischen Klassenpfadeinträge werden entfernt, da sie vom WebSphere Portal-JRE-Container und vom WebSphere Portal-Laufzeitzielcontainer dynamisch hinzugefügt werden.
  2. Wenn Ihr Portletprojekt einem Unternehmensanwendungsprojekt zugeordnet ist, wird empfohlen, dass Sie die J2EE-Stufe des EAR-Projekts auf J2EE 1.3 migrieren. Für WebSphere Portal V5.x erstellte Portletanwendungen sollten den Spezifikationen der J2EE-Stufe 1.3 entsprechen.
    Anmerkung: Bevor Sie Ihr Unternehmensanwendungsprojekt auf J2EE 1.3 migrieren, lesen Sie die Informationen in Migration der J2EE-Projekte. Informationen zur Verwendung des J2EE-Migrationsassistenten finden Sie in der Onlinehilfe.
    1. Wenn das migrierte Portletprojekt nur dem Unternehmensanwendungsprojekt zugeordnet ist, führen Sie folgende Schritte aus:
      1. Schließen Sie alle Editoren in der Workbench.
      2. Klicken Sie mit der rechten Maustaste auf das Unternehmensanwendungsprojekt, dem das migrierte Portletprojekt zugeordnet ist.
      3. Wählen Sie Migrieren > J2EE-Migrationsassistent... aus, und klicken Sie auf Weiter.
      4. Wählen Sie J2EE Version 1.3 und als Zielserver WebSphere Portal aus.
      5. Klicken Sie auf Fertig stellen.
    2. Wenn dem Unternehmensanwendungsprojekt andere Portletprojekte zugeordnet sind, müssen Sie das migrierte Portletprojekt entfernen und es zu einem anderen Unternehmensanwendungsprojekt hinzufügen.
      1. Entfernen Sie das Modul des migrierten Portletprojekts aus dem Unternehmensanwendungsprojekt.
        1. Erweitern Sie das Unternehmensanwendungsprojekt, und wählen Sie den Implementierungsdeskriptor aus.
        2. Wählen Sie Öffnen mit > Editor für Implementierungsdeskriptor aus.
        3. Wählen Sie die Registerkarte Module aus. Wählen Sie auf der Modulseite des Editors die WAR-Datei des migrierten Portletprojekts aus.
        4. Klicken Sie auf Entfernen.
        5. Wählen Sie Datei > Speichern aus, um die Änderungen zu speichern.
      2. Erstellen Sie ein neues Unternehmensanwendungsprojekt, und fügen Sie das Portletprojekt hinzu.
        1. Wählen Sie Datei > Neu > Projekt aus.
        2. Wählen Sie das Markierungsfeld Alle Assistenten anzeigen aus.
        3. Erweitern Sie J2EE, und wählen Sie Unternehmensanwendungsprojekt aus.
        4. Füllen Sie das Feld für den Namen des Projekts aus, wählen Sie J2EE Version 1.3 und als Zielserver WebSphere Portal aus, und klicken Sie auf Weiter.
        5. Wählen Sie auf der Seite EAR-Modulprojekte das migrierte Portletprojekt aus, und klicken Sie auf Fertig stellen.
Das Portletprojekt ist nun auf WebSphere Portal V5.x migriert.

Übergeordnetes Thema: Migration auf die Portaltools in Rational Application Developer V6.0

Zugehörige Tasks
Migration auf die Portaltools in Rational Application Developer V6.0
Migration von Faces-Ressourcen in einem Portletprojekt

(C) Copyright IBM Corporation 2000, 2004. All Rights Reserved. (C) Copyright IBM Deutschland GmbH und andere 2000, 2004. Alle Rechte vorbehalten.