WebSphere Portal und HATS

IBM® WebSphere Portal bietet Ihnen einen zentralen Zugriff auf Webinhalte und Webanwendungen, der jeweils an die Anforderungen des Benutzers angepasst ist.

Die Integration von HATS in WebSphere Portal ermöglicht einen freien Datenfluss zwischen WebSphere Portal und anderen Portal-Anwendungen. Alle relevanten Funktionen von WebSphere Portal stehen auch zur Verwendung in HATS zur Verfügung. Dies wird durch integrierte Tools oder durch einfache Java™-Entwicklung realisiert. Der größte Teil der HATS-Funktionalität bleibt erhalten, wenn HATS in der WebSphere Portal-Umgebung ausgeführt wird. Weitere Informationen finden Sie in Hinweise und Einschränkungen zu HATS-Portlets.

HATS-Anwendungen können direkt in WebSphere Portal als Portlets ausgeführt werden, sodass WebSphere Portal und HATS direkt interagieren können. Sie können HATS-Portlets entwickeln, die der IBM Portlet-API oder der Standard-API Java Portlet Specification (JSR 168) entsprechen, die nachfolgend als Standardportlet-API bezeichnet wird.

Anmerkung:
Im vorliegenden Dokument werden HATS-Portlets, die der Standardportlet-API (JSR 168) entsprechen, als Standardportlets bezeichnet.

Klassen für HATS-Geschäftslogik können die WebSphere Portal-APIs verwenden, und HATS-JSPs können WebSphere Portal JSP-Tagbibliotheken einschließen. Weitere Informationen zur Programmierung von Portlets und zu erweiterten Portalfunktionen finden Sie im Handbuch HATS Web Application Programmer's Guide.

Ein HATS-Portletprojekt ist auf umsetzungsorientierte Anwendungen ausgerichtet. Informationen zur Anpassung von Modell-1-Anwendungen, die auf Integrationsobjekten basieren, zur Ausführung in WebSphere Portal finden Sie im Handbuch HATS Web Application Programmer's Guide. Informationen zur Konvertierung von auf Integrationsobjekten basierenden Struts-Anwendungen für die Ausführung in WebSphere Portal finden Sie im Information Center von WebSphere Portal unter http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp, wenn Sie nach Struts suchen.

Weitere Informationen und Unterstützung in Bezug auf Portal-Tools erhalten Sie über das Menü Hilfe in der Symbolleiste von Rational SDP, indem Sie Hilfe - Inhalt auswählen. Klicken Sie in der Hilfeliste auf der linken Seite auf Portal- und Portletanwendungen entwickeln, um auf die Dokumentation für Portletentwickler zuzugreifen.

HATS-Portlets erstellen

Es gibt zwei Möglichkeiten, ein HATS-Portlet zu erstellen:

Neues HATS-Portletprojekt erstellen

Zur Erstellung eines neuen HATS-Portletprojekts starten Sie den Assistenten "Projekt erstellen" durch eine der folgenden Aktionen:

Führen Sie auf der Anzeige "HATS-Projekt" im Assistenten "Projekt erstellen" die folgenden Schritte aus:

  1. Geben Sie einen Namen für das Portletprojekt ein.
  2. Geben Sie optional eine Beschreibung ein.
  3. Übernehmen Sie die Standardposition.
  4. Wählen Sie Web aus, um anzugeben, dass es sich um ein Webprojekt handelt.
    Anmerkung:
    Wenn die Webimplementierungsoption inaktiviert ist, bedeutet dies, dass keine Serverlaufzeiten definiert sind. Zur Definition von Serverlaufzeiten wählen Sie die Optionen Fenster > Benutzervorgaben > Server > Laufzeitumgebungen aus und fügen Sie mindestens eine Laufzeitdefinition hinzu.
  5. Wählen Sie für das Feld "Zielserver" einen der unterstützten WebSphere Portal-Server aus: WebSphere Portal Version 6.0 oder WebSphere Portal Version 6.1.
    Anmerkungen:
    1. Im Allgemeinen gilt, dass Portlets, deren Ziel mit WebSphere Portal Version 6.0 definiert ist, in WebSphere Portal Version 6.1 implementiert und ausgeführt werden können. Weitere Informationen finden Sie im Information Center von WebSphere Portal unter der Adresse http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp, wenn Sie nach Migration planen suchen.
    2. Standardportlets, die für WebSphere Portal v6.0 oder v6.1 bestimmt sind, können auch unter WebSphere Application Server v6.1 oder v7.0 ausgeführt werden.
  6. Geben Sie in das Feld "Enterprise Application-Projekt" den Namen des EAR-Projekts ein, das zum Testen in der lokalen Testumgebung verwendet werden soll.
    Anmerkung:
    Standard- und IBM Portletprojekte können demselben EAR-Projekt hinzugefügt werden.
  7. Wählen Sie für das Feld "Portlet-API" JSR 168-Portlet oder IBM Portlet aus, um anzugeben, welcher API dieses Portlet entsprechen soll.
    Anmerkung:
    Wenn IBM Portlet ausgewählt wird, wird eine Warnung angezeigt, die besagt, dass diese API veraltet ist.
  8. Wählen Sie aus, ob die Unterstützungsdateien für die Administrationskonsole eingefügt werden sollen.
    Anmerkung:
    Diese Option wird bei HATS-Standardportlets nicht untersützt.
  9. Klicken Sie auf Weiter, und setzen Sie die Erstellung Ihres Projekts normal fort.

Durch dieses Verfahren wird ein einzelnes HATS-Portletprojekt generiert, das ein EAR-Projekt enthält, das zum Testen in einer lokalen Testumgebung verwendet werden kann.

Portlets aus HATS-Webprojekten generieren

Damit ein vorhandenes HATS-Webprojekt als Portlet ausgeführt werden kann, muss die Struktur und der Inhalt des HATS-Projekts an die Anforderungen der Portletspezifikation angepasst werden. HATS Toolkit automatisiert den Prozess der Konvertierung eines regulären HATS-Webprojekts in ein Portlet. Für diesen Konvertierungsprozess wird die Komponente der Portaltools (Portal Tools) von Rational SDP vorausgesetzt.

Zur Generierung eines HATS-Portletprojekts aus einem vorhandenen HATS-Webprojekt klicken Sie in der Sicht HATS-Projekte mit der rechten Maustaste auf das Webprojekt und wählen Portletprojekt generieren aus.

Führen Sie im Assistenten Portletprojekt generieren auf der Anzeige "Optionen für Portletprojektgenerierung" die folgenden Schritte aus:

  1. Geben Sie einen Namen für das Portletprojekt ein.
  2. Wählen Sie für das Feld "Zielserver" den WebSphere Portal-Zielserver aus, d. h. WebSphere Portal Version 6.0 oder WebSphere Portal Version 6.1.
    Anmerkungen:
    1. Bei der Generierung eines HATS-Portletprojekts aus einem HATS-Webprojekt bestimmt der Zielserver des Webprojekts die Optionen des Zielservers für das Portletprojekt. Wenn der Zielserver des Webprojekts zum Beispiel WebSphere Application Server Version 6.0 ist, stehen als Zielserveroptionen für das generierte Portlet entweder WebSphere Portal Version 6.0 oder Version 6.1 zur Verfügung. Wenn der Zielserver des Webprojekts WebSphere Application Server Version 6.1 ist, lautet die Zielserveroption für das generierte Portlet WebSphere Portal Version 6.1. Wenn der Zielserver des Webprojekts WebSphere Application Server Version 7.0 ist, gibt es keine Option zum Generieren eines Portlets.
    2. Im Allgemeinen gilt, dass Portlets, deren Ziel mit WebSphere Portal Version 6.0 definiert ist, in WebSphere Portal Version 6.1 implementiert und ausgeführt werden können. Weitere Informationen finden Sie im Information Center von WebSphere Portal unter der Adresse http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp, wenn Sie nach Migration planen suchen.
    3. Standardportlets, die für WebSphere Portal v6.0 oder v6.1 bestimmt sind, können auch unter WebSphere Application Server v6.1 oder v7.0 ausgeführt werden.
  3. Geben Sie in das Feld "Enterprise Application-Projekt" den Namen des EAR-Projekts ein, das zum Testen in der lokalen Testumgebung verwendet werden soll.
    Anmerkung:
    Standard- und IBM Portletprojekte können demselben EAR-Projekt hinzugefügt werden.
  4. Wählen Sie für das Feld "Portlet-API" JSR 168-Portlet oder IBM Portlet aus, um anzugeben, welcher API dieses Portlet entsprechen soll.
    Anmerkung:
    Wenn IBM Portlet ausgewählt wird, wird eine Warnung angezeigt, die besagt, dass diese API veraltet ist.
  5. Wählen Sie in der Liste die Typen von Dateien aus, die automatisch konvertiert werden sollen:
  6. Klicken Sie auf Fertig stellen.

Aus dem ausgewählten Webprojekt wird ein HATS-Portletprojekt erstellt. Nach der Erstellung des Portlets können weitere Anpassungen vorgenommen werden. Weitere Informationen zur Änderung von HATS-Projekten finden Sie in HATS-Projekt ändern.

Anmerkungen:
  1. Wenn Sie ein HATS-Webprojekt in ein HATS-Portletprojekt konvertieren wollen, müssen Sie die Konfigurationsdatei (hatswelcfg.xml) von Web Express Logon (WEL) möglicherweise manuell ändern, wenn die für das Webprojekt konfigurierten Plug-ins für das Portletprojekt nicht unterstützt werden. Es empfiehlt sich, zum Hinzufügen unterstützter Plug-ins die Benutzerschnittstelle der WEL-Konfiguration zu verwenden, damit die WEL-Konfigurationsdatei (hatswelcfg.xml) ordnungsgemäß aktualisiert wird.
  2. Nach der Generierung eines HATS-Portletprojekts aus einem HATS-Webprojekt werden Änderungen, die an einem der Projekte vorgenommen werden, nicht auf das andere Projekt übertragen. Sie haben jedoch immer die Möglichkeit, ein neues HATS-Portletprojekt aus einem geänderten HATS-Webprojekt zu erstellen, um Änderungen, die im Webprojekt vorgenommen wurden, zu übertragen.
  3. Sie können ein HATS-Portletprojekt nicht zurück in ein HATS-Webprojekt konvertieren.
  4. Wenn eine Anwendung aus HATS Version 4, 5, 6, Version 7.0 oder 7.1 vorhanden ist, müssen Sie die Anwendung auf HATS V7.5.1 migrieren, bevor Sie ein Portletprojekt generieren können. Weitere Informationen zum Migrieren auf HATS V7.5.1 finden Sie in Migration auf HATS V7.5.1.

IBM Portlets auf Standardportlets migrieren

Die Migration eines HATS IBM Portlets auf ein HATS-Standardportlet muss manuell ausgeführt werden. Dazu sind die folgenden Schritte erforderlich:

  1. Projektfacetten migrieren
  2. Web- und Portletimplementierungsdeskriptordateien migrieren
  3. Umsetzungen, Schablonen und Makrosteuerroutinen migrieren
  4. HATS-spezifische Dateien migrieren
  5. Sonstige Portalfunktionen migrieren (optional)

Projektfacetten migrieren

  1. Sofern sie enthalten ist, entfernen Sie die Struts-Facette, da Struts von HATS-Standardportlets nicht unterstützt werden.
    1. Klicken Sie in der Sicht "HATS-Projekte" mit der rechten Maustaste auf das Portletprojekt und wählen Sie Eigenschaften aus.
    2. Wählen Sie auf der Seite "Eigenschaften" die Option Projektfacetten aus.
    3. Falls ausgewählt, wählen Sie das Markierungsfeld für Struts für IBM Portlets ab.
    4. Klicken Sie auf OK.
  2. Ersetzen Sie die Facette für IBM Portlets durch die Facette für JSR-Portlets.
    1. Klicken Sie in der Sicht "HATS-Projekte" mit der rechten Maustaste auf das Portletprojekt und wählen Sie Eigenschaften aus.
    2. Wählen Sie auf der Seite "Eigenschaften" die Option Projektfacetten aus.
    3. Wählen Sie das Markierungsfeld für IBM Portlets ab, und wählen Sie das Markierungsfeld für JSR-Portlets aus. Achten Sie darauf, dass in der Spalte Version der Wert 1.0 angezeigt wird. Ist dies nicht der Fall, klicken Sie in die Dropdown-Liste neben der Versionsnummer und ändern Sie den Wert in 1.0.
    4. Klicken Sie auf OK.

Web- und Portletimplementierungsdeskriptordateien migrieren

  1. Bearbeiten Sie in der Navigatorsicht den Webimplementierungsdeskriptor (Webinhalt bzw. Web Content/WEB-INF/web.xml), und führen Sie die folgenden Schritte aus:
    1. Entfernen Sie auf der Registerkarte "Servlets" ihr_portlet sowie HATSAdminServlet-Servlets (falls vorhanden) und die gehörigen Zuordnungen.
    2. Entfernen Sie auf der Registerkarte "Variablen" im Bereich der Referenzen auf Tagbibliotheken die Referenz "admin.tld tag lib", sofern vorhanden.
    3. Fügen Sie auf der Registerkarte "Variablen" im Bereich der Referenzen auf Tagbibliotheken die Referenz "std-portlet.tld tag lib" mit den folgenden Einstellungen hinzu:
      URL: http://java.sun.com/portlet
      Position: /WEB-INF/tld/std-portlet.tld	
  2. Bearbeiten Sie in der Navigatorsicht den Portletimplementierungsdeskriptor (Webinhalt bzw. Web Content/WEB-INF/portlet.xml), und führen Sie die folgenden Schritte aus:
    1. Migrieren Sie auf einen standardkonformen Portletimplementierungsdeskriptor. Informationen dazu, wie dies auszuführen ist, finden Sie im Abschnitt zur Migration von der IBM Portlet-API im Information Center von WebSphere Portal unter der Adresse http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp.
    2. Entfernen Sie das Portlet "EntryPortlet" (Ihr Portlet) und alle zugehörigen Referenzen im Portletimplementierungsdeskriptor.
    3. Fügen Sie Jsr168EntryPortlet zu dem Portletimplementierungsdeskriptor hinzu. Sehen Sie sich dazu den Portletimplementierungsdeskriptor aus einem HATS-JSR 168-Beispielportlet an.

Umsetzungen, Schablonen und Makrosteuerroutinen migrieren

Bearbeiten Sie in der Sicht "HATS-Projekte" alle JSP-Dateien für Umsetzungen, Schablonen und Makrosteuerroutinen, und führen Sie auf der Registerkarte "Quelle" die folgenden Schritte aus:

  1. Fügen Sie den folgenden Code hinzu:
  2. Konvertieren Sie response.encodeUrl("...") in renderResponse.encodeUrl(renderRequest.getContextPath()+"...").
  3. Konvertieren Sie alle Instanzen von request in renderRequest.

HATS-spezifische Dateien migrieren

  1. Importieren Sie alle Dateien aus dem Ordner <gemeinsames_installationsverzeichnis>\plugins\com.ibm.hats_nnn\predefined\ projects\portlet\jsr in ihre entsprechenden Ordner im Portletprojekt. (Dabei ist gemeinsames_installationsverzeichnis das Verzeichnis der gemeinsam genutzten Ressourcen, in dem das HATS-Angebot über IBM Installation Manager installiert wurde, und nnn die Version und die Buildstufe von HATS).
  2. Löschen Sie die folgenden Dateien und Ordner in der Navigatorsicht, sofern sie vorhanden sind:
    1. Die Dateien HATSApplet.cab und HATSApplet.jar im Ordner "Webinhalt" (bzw. Web Content)
    2. Den Ordner "hatsadmin" im Ordner "Webinhalt" (bzw. Web Content)
    3. Die Datei "hatsadmin.tld" im Ordner "Webinhalt" bzw. "Web Content/WEB-INF/tld"

Sonstige Portalfunktionen migrieren (optional)

  1. Bei Verwendung von Web Express Logon (WEL) müssen Sie möglicherweise die WEL-Plug-in-Klassen ändern, weil sich bestimmte Plug-in-Klassen bei IBM Portlets und Standardportlets voneinander unterscheiden.

    In IBM Portlets werden beispielsweise folgende WEL-Plug-in-Klassen verwendet:

    In Standardportlets werden folgende WEL-Plug-in-Klassen verwendet:

  2. Wenn Sie einen Vault für Berechtigungsnachweise (Credential Vault) in Ihrer Portletanwendung implementieren, müssen Sie den Code migrieren, der auf den Credential Vault-Service zugreift. Weitere Informationen hierzu finden Sie im Abschnitt zur Portletauthentifizierung im Information Center von WebSphere Portal unter der Adresse http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp.
  3. Bei der Implementierung der Portletkommunikation müssen Sie den verwendeten Kommunikationsmechanismus konvertieren. Weitere Informationen finden Sie in Portletkommunikation.

Mit HATS-Portlets arbeiten

Ein HATS-Portletprojekt bleibt ein HATS-Projekt insofern, als dass alle HATS-Assistenten und HATS-Editoren für das Projekt weiterhin verwendet werden können. Ein HATS-Portletprojekt ist jedoch auch ein Portletprojekt, sodass alle Editoren der Portal-Tools und die Laufzeitkonfiguration für das Projekt verwendet werden können. Ein HATS-Portletprojekt wird in der Baumstruktur mit einem anderen Symbol angezeigt: Symbol für Portletordner.

Überschreibungen von Verbindungsparametern und globalen Variablen

Sie können zulassen, dass Verbindungsparameter und globale Variablen für Ihre Portlets überschrieben werden, indem Sie die Projekteinstellungen anpassen. Weitere Informationen finden Sie in Überschreibungen von Verbindungsparametern und Überschreibungen von globalen Variablen.

IBM Portlets

Wenn Sie Überschreibungen ("override") in den Projekteinstellungen zulassen, kann das Überschreiben für HATS IBM Portlets ausgeführt werden, indem die Klasse "EntryPortlet" erweitert ("extends") und die Methode doView() überschrieben wird. Weitere Informationen zur Erweiterung der Klasse "EntryPortlet" finden Sie im Handbuch HATS Web Application Programmer's Guide.

Standardportlets

Wenn Sie Überschreibungen in den Projekteinstellungen zulassen, kann der Benutzer für HATS-Standardportlets Verbindungsparameter und globale Variablen überschreiben, indem er über die Symbolleiste des Portlets zum Bearbeitungsmodus wechselt. Bei WebSphere Portal Version 6.0 und Version 6.1 wählen Sie Personalisieren im Portletmenü der Symbolleiste aus.

Anmerkung:
HATS unterstützt keinen Portletbearbeitungsmodus unter WebSphere Application Server Version 6.1 oder 7.0. Wenn Sie Ihr HATS-Standardportlet zur direkten Ausführung unter WebSphere Application Server Version 6.1 oder 7.0 implementieren, kann der Benutzer Verbindungsvariablen und globale Variablen in der URL überschreiben, die zum Aufrufen des Portlets verwendet wird, anstatt dafür den Portletbearbeitungsmodus zu verwenden.

Nach dem Wechsel zum Portletbearbeitungsmodus wird dem Benutzer eine Einstellungsseite angezeigt. Auf dieser Seite kann der Benutzer Einstellungen für Verbindungsparameter und globale Variablen überschreiben. Diese Funktionen sind äquivalent zu den HATS-Funktionen für Webanwendungen, die dem Benutzer das Überschreiben von Einstellungen über die URL ermöglichen, wenn zu Anfang auf die Anwendung zugegriffen wird.

Auf der Einstellungsseite im Abschnitt für die Verbindungsparameter werden die Host On-Demand-Sitzungsparameter in der Dropdown-Liste für Verbindungsparameter aufgeführt, deren Überschreibung Sie in den Projekteinstellungen zugelassen haben. Der Benutzer definiert eine Überschreibung, indem er einen Parameter in der Dropdown-Liste auswählt, einen Wert in das Feld Wert eingibt und auf Hinzufügen klickt. Standardmäßig wird die Überschreibungseinstellung aktiviert, wenn sie zuerst hinzugefügt wird. Sie kann dadurch inaktiviert werden, dass falsch in der Dropdown-Liste Aktiviert ausgewählt wird. Eine Überschreibung kann gelöscht werden, indem das Markierungsfeld neben dem Parameternamen ausgewählt und auf Löschen geklickt wird.

Im Abschnitt für globale Variablen definiert der Benutzer eine Überschreibung, indem er den Namen und den Wert einer globalen Variablen eingibt und auf Hinzufügen klickt. Nachdem Hinzufügen einer Überschreibung kann die globale Variable als gemeinsam genutzte globale Variable angegeben werden, indem der Wert wahr im Dropdown-Feld Gemeinsam genutzt ausgewählt wird. Standardmäßig wird die Überschreibungseinstellung aktiviert, wenn sie zuerst hinzugefügt wird. Sie kann dadurch inaktiviert werden, dass falsch in der Dropdown-Liste Aktiviert ausgewählt wird. Eine Überschreibung kann gelöscht werden, indem das Markierungsfeld neben der globalen Variablen ausgewählt und auf Löschen geklickt wird.

Wenn der Benutzer auf Speichern und Beenden klickt, werden die Einstellungen in den Portletbenutzervorgaben gespeichert.

Anmerkungen:
  1. Die vom Benutzer eingegebenen Werte werden nicht geprüft.
  2. Der Benutzer muss die Verbindung trennen und die Portletanwendung erneut starten, bevor die neuen Werte wirksam werden.

Neben der Option, Benutzern die Definition von Überschreibungen zu ermöglichen, können Sie Überschreibungen für Verbindungsparameter und globale Variablen auch programmtechnisch unterstützen, indem Sie das HATS-JSR 168-Eingangsportlet erweitern. Weitere Informationen dazu finden Sie im Abschnitt zur Erweiterung des Eingangsportlets (Extending the Entry portlet) im Handbuch HATS Web Application Programmer's Guide.

Anmerkung:
Wenn Sie Überschreibungen für Verbindungsparameter oder globale Variablen durch die erweiterte Portletklasse bereitstellen und der Benutzer dieselben Überschreibungen über den Portletbearbeitungsmodus angibt, überschreiben die vom Benutzer im Bearbeitungsmodus angegebenen Werte die Werte, die Sie in der erweiterten Portletklasse angeben.

.

Portletkommunikation

WebSphere Portal unterstützt mehrere Verfahren zum Austausch oder zur gemeinsamen Nutzung von Informationen durch Portlets. Weitere Informationen hierzu finden Sie im Abschnitt zur Portletkommunikation im Information Center von WebSphere Portal unter der Adresse http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp.

In diesem Abschnitt wird die HATS-Unterstützung für die Portletkommunikation in WebSphere Portal beschrieben.

IBM Portlets

HATS IBM Portlets unterstützen die Click-to-Action-Implementierung zur Bereitstellung einer Lösung mit Portletkommunikation. Weitere Informationen finden Sie im Abschnitt zu kooperativen Portlets im Handbuch HATS Web Application Programmer's Guide.

Standardportlets

Die Unterstützung für HATS-Standardportlets (JSR 168-Portlets) stellt mithilfe des WebSphere Portal-Mechanismus für kooperative Portlets eine Lösung mit Portletkommunikation bereit.

JSR 168-Portlets kommunizieren miteinander mithilfe von Eigenschaften. Ein HATS-JSR 168-Portlet unterstützt die Funktionalität zum Senden und Empfangen von Eigenschaften an andere bzw. von anderen JSR 168-Portlets (HATS- und sonstigen Portlets). Portlets müssen verbunden sein, um miteinander kommunizieren zu können.

Eigenschaft von einem HATS-JSR 168-Portlet senden
  1. Erstellen Sie eine globale Variable, die den Wert der zu sendenden Eigenschaft enthält. Dazu haben Sie mehrere Möglichkeiten. Sie können beispielsweise eine Aktion Globale Variable extrahieren oder Globale Variable definieren ausführen. Bei der JSR 168-Portletkommunikation können nur globale Variablen verwendet werden, die null oder mehr Zeichenfolgen (keine anderen Typen) enthalten können. Globale Variablen kann man sich als Wrapper für die Werte von JSR 168-Eigenschaften vorstellen.
  2. Fügen Sie zu einem HATS-Anzeigenereignis oder zu einem Anwendungsereignis bei nicht übereinstimmenden Anzeigen eine Aktion Globale Variable senden hinzu, um den Wert der globalen Variablen als Eigenschaft zu senden. Informationen dazu, wie dies erfolgt, finden Sie unter Aktion "Globale Variable senden".

    Diese Aktion kann in Verbindung mit der Aktion Globale Variable extrahieren verwendet werden, um vom Benutzer eingegebene Werte von einem Portlet an ein anderes Portlet zu senden. Sie können zum Beispiel eine Aktion Globale Variable extrahieren zwischen der Aktion Umsetzung anwenden und der Aktion Globale Variable senden hinzufügen, um die Daten, die der Benutzer eingibt, zu erfassen und an andere Portlets zu senden.

  3. Wenn bei der Ausführung des HATS-JSR 168-Portletprojekts die Aktion Globale Variable senden ausgeführt wird, werden der Eigenschaftsname und der Zeichenfolgeninhalt der angegebenen globalen Variablen an WebSphere Portal übergeben, von wo aus die Portlets, die mit diesem HATS-JSR 168-Portlet verbunden sind, zum Empfang der Eigenschaft aufgefordert werden.
Eigenschaft in einem HATS-JSR 168-Portlet empfangen
  1. Definieren Sie mithilfe der Portleteinstellungen die Eigenschaftsnamen und die entsprechenden globalen Variablen, die die Eigenschaftswerte enthalten sollen, die von diesem Portlet empfangen werden können. Sie können auf die Portleteinstellungen über den Projekteinstellungseditor zugreifen, indem Sie auf die Registerkarte Andere und anschließend auf Portlet klicken. Weitere Informationen dazu, wie dies erfolgt, finden Sie unter Portleteinstellungen.
  2. Sobald WebSphere Portal eine Eigenschaft von einem Quellenportlet empfangen hat, wird das Zielportlet benachrichtigt. Der Laufzeitservice von HATS-JSR 168-Portlets ruft den Eigenschaftswert von WebSphere Portal ab und speichert ihn in der angegebenen globalen Variablen. Auch hier können nur globale Variablen bei der JSR 168-Kommunikation verwendet werden, die eine oder mehrere Zeichenfolgen enthalten.
Mit anderen Portlets als HATS-JSR 168-Portlets kommunizieren

Rational SDP stellt eine GUI-Unterstützung zur Implementierung kooperativer Portlets bereit. Wenn Sie andere Portlets als HATS-JSR 168-Portlets zur Kommunikation mit HATS-JSR 168-Portlets konfigurieren wollen, führen Sie die folgenden Schritte aus:

  1. Öffnen Sie die Projektexplorersicht über die Menüleiste in Rational SDP, indem Sie Fenster > Sicht anzeigen > Andere > Allgemein > Projektexplorer auswählen.
  2. Klicken Sie in der Projektexplorersicht mit der rechten Maustaste auf den Knoten Portletimplementierungsdeskriptor unter dem Portletprojekt.
  3. Wählen Sie Kooperativ > Dieses Portlet zum Senden von Daten aktivieren (Quelle) oder Kooperativ > Dieses Portlet zum Empfangen von Daten aktivieren (Ziel) aus, um den Assistenten zur Aktivierung der Unterstützung für kooperative Portlets für das ausgewählte Portlet zu starten.
  4. Stellen Sie sicher, dass die folgenden Einstellung in diesem Assistenten korrekt angegeben sind:
Datentyp-URI bearbeiten

Wenn Sie eine Aktion "Globale Variable senden" oder eine Portleteinstellung für den Empfang einer Eigenschaft konfigurieren, setzt HATS die Datentyp-URI-Angabe für die Eigenschaft standardmäßig auf den Wert http://com.ibm.hats.portlet.pb#<eigenschaftsname>Type. Diese URI-Angabe wird nur verwendet, wenn Sie das Quellenportlet und das Zielportlet verbinden. WebSphere Portal setzt voraus, dass das Quellen- und das Zielportlet dieselbe URI-Angabe verwenden, um die Eigenschaft senden und empfangen zu können. Wenn Sie die URI-Angabe aus irgendeinem Grund vom Standardwert abweichend konfigurieren müssen, können Sie die URI-Angabe für eine Eigenschaft über Portal Toolkit ändern, indem Sie die folgenden Schritte ausführen:

  1. Öffnen Sie die Projektexplorersicht über die Menüleiste in Rational SDP, indem Sie Fenster > Sicht anzeigen > Andere > Allgemein > Projektexplorer auswählen.
  2. Erweitern Sie in der Projektexplorersicht das Projekt bis zu der Eigenschaft, die Sie ändern wollen. Die Eigenschaften befinden Sie unter dem Knoten Portletimplementierungsdeskriptor.
  3. Klicken Sie mit der rechten Maustaste auf die Eigenschaft, und wählen Sie Datentyp bearbeiten aus.
  4. Ändern Sie den Datentyp-URI im Assistenten "Kooperative Quelle bearbeiten" bzw. "Kooperatives Ziel bearbeiten".

Portlets für Kommunikation verbinden

Portletverbindungen dienen zum Steuern des Informationsflusses zwischen Portlets, die mithilfe der WebSphere Portal-API für kooperative Portlets kommunizieren. Unter einer Portletverbindung versteht man die Verbindung zwischen zwei Portlets über das Verbindungstool des Portalservers mit dem Ziel, eine Eigenschaft eines kooperativen Portlets zu senden und zu empfangen. Portlets werden nur für eine einzige Eigenschaft verbunden und die beiden Portlets müssen dieser Eigenschaft denselben Namen geben, auch wenn sich die Namen der zugehörigen globalen Variablen unterscheiden können. Mit anderen Worten: Wenn zwei Portlets zwei Eigenschaften senden und empfangen wollen, benötigen sie dazu zwei Verbindungen, jeweils eine pro Eigenschaft. Wenn der Verbindungsschritt nicht ausgeführt wird, werden keine Daten übertragen.

Angepasste PDTs und angepasste Tabellen

Bevor Sie ein Portletprojekt mit einer angepassten Druckerdefinitionstabelle (PDT, Printer Definition Table) oder mit angepassten Tabellen in einen Portalserver implementieren, müssen Sie Dateien oder Ordner in das Verzeichnis \Web Content für Webinhalte des HATS-Portletprojekts kopieren. Die Dateien bzw. Ordner für jeden Typ von Hinzufügung sind unten aufgeführt:

Web Services for Remote Portlets

Web Services for Remote Portlets (WSRP) ist ein Standard, mit dem Portale Portlets, Anwendungen und Inhalte in Form von WSRP-Services bereitstellen können, wobei andere Portale die WSRP-Services als ferne Portlets (Remote Portlets) für ihre Benutzer integrieren können. HATS-Standard- und IBM Portlets können als ferne Portlets bereitgestellt werden, die von anderen Portalen genutzt werden können. Weitere Informationen finden Sie im Information Center von WebSphere unter der Adresse http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp, wenn Sie nach WSRP-Services verwenden suchen.

HATS-Portlets testen

Wenn eine WebSphere Portal-Testumgebung in Rational SDP konfiguriert ist, können Sie diese zum Testen Ihrer HATS-Standardportlets bzw. Ihrer IBM Portlets verwenden, bevor Sie sie auf einem Produktionsportalserver implementieren.

Sie können Ihre HATS-Standardportlets vor der Implementierung bei Bedarf auch in der lokalen Testumgebung von WebSphere Application Server Version 6.1 oder Version 7.0 testen.

Verwenden Sie zum Testen eines HATS-Portletprojekts dieselbe Prozedur wie für das Testen von HATS-Webprojekten. Weitere Informationen finden Sie unter Übersicht.

HATS-Portlets exportieren

Zum Exportieren eines HATS-Portlets zur Implementierung klicken Sie in der Sicht "HATS-Projekte" mit der rechten Maustaste auf das Portletprojekt und wählen Projekt exportieren aus. Geben Sie den Zieldateinamen für die zu exportierende .war-Datei in das Dropdown-Feld Ziel ein, und klicken Sie auf Fertig stellen. Es wird nur die WAR-Datei exportiert. Die EAR-Datei wird nur zum Testen in der lokalen Testumgebung verwendet.

Wenn Sie die WAR-Datei Ihres HATS-Portlets exportiert haben, installieren Sie sie mithilfe der WebSphere Portal-Verwaltungstools in WebSphere Portal.

Wenn Sie ein Standardportlet in WebSphere Application Server Version 6.1 oder Version 7.0 installieren, müssen Sie die WebSphere Application Server-Administrationskonsole verwenden und folgende Anweisungen beachten:

HATS-Portlets verwalten

Sie können HATS-Portlets über die HATS-Administrationskonsole verwalten. HATS-Standardportlets können unabhängig davon, ob Sie unter Portal Server oder WebSphere Application Server installiert sind, über eine eigenständige HATS-Verwaltungsanwendung verwaltet werden. HATS IBM Portlets können entweder über eine eigenständige HATS-Verwaltungsanwendung oder durch die im Portlet selbst enthaltene Unterstützung für die Administrationskonsole verwaltet werden.

Eigenständige HATS-Verwaltungsanwendung verwenden

Wenn Sie HATS-Standardportlets und HATS IBM Portlets über eine eigenständige HATS-Verwaltungsanwendung verwalten wollen, führen Sie die folgenden Schritte aus:

  1. Erstellen Sie ein eigenständiges HATS-Verwaltungsprojekt in HATS Toolkit, indem Sie Datei > Neu > Projekt > HATS > HATS-Verwaltungsprojekt auswählen. Das HATS-Verwaltungsprojekt wird nur in HATS Toolkit auf der Registerkarte Navigator angezeigt.
  2. Exportieren Sie das HATS-Verwaltungsprojekt (.ear) in eine EAR-Datei, indem Sie mit der rechten Maustaste auf das EAR-Projekt klicken und Exportieren > Java EE > EAR auswählen.
  3. Implementieren Sie die EAR-Datei für die eigenständige HATS-Verwaltungsanwendung mithilfe der WebSphere Application Server-Administrationskonsole in WebSphere Application Server.
    Anmerkungen:
    1. Installieren Sie die EAR-Datei auf demselben WebSphere Application Server-System, auf dem auch WebSphere Portal Server installiert ist. Wenn ein HATS-Standardportlet direkt auf dem WebSphere Application Server installiert wird, müssen Sie die EAR-Datei auf demselben Server installieren.
    2. Stellen Sie sicher, dass das Modul dem WebSphere Application Server, zum Beispiel als "server1", und nicht dem WebSphere Portal Server zugeordnet ist.
    3. Stellen Sie unter WebSphere Application Server V6.x sicher, dass für die Rolle des HATS-Administrators in der Anzeige Sicherheitsaufgabenbereiche zu Benutzern oder Gruppen zuordnen die Option Alle authentifizierten ausgewählt ist. Stellen Sie unter WebSphere Application Server V7.x sicher, dass in der Anzeige Sicherheitsaufgabenbereiche zu Benutzern oder Gruppen zuordnen in der Dropdown-Liste Sondersubjekte zuordnen die Option Alle Authentifizierten im Realm der Anwendung ausgewählt ist.
  4. Die Benutzer-ID, mit der die Verwaltung von Portlets erfolgt, muss als Benutzer der WebSphere Application Server-Administrationskonsole mit Administratorberechtigung definiert sein. Gehen Sie hierfür anhand der folgenden Schritte vor:
    1. Wählen Sie in der Administrationskonsole von WebSphere Application Server die Optionen Benutzer und Gruppen > Aufgabenbereiche für Benutzer mit Verwaltungsaufgaben > Hinzufügen aus. (Wenn es sich um eine ältere Version als WebSphere Application Server Version 6.1 handelt, wählen Sie die Optionen Systemverwaltung > Konsoleneinstellungen > Konsolenbenutzer > Hinzufügen aus.)
    2. Geben Sie die Benutzer-ID ein, mit der die Verwaltung von Portlets erfolgt, und ordnen Sie die Benutzer-ID dem Aufgabenbereich (der Rolle) Administrator zu.
    Anmerkung:
    Weitere Informationen finden Sie unter HATS-Administrationskonsole und WebSphere-Sicherheit.
  5. Starten Sie die HATS-Verwaltungsanwendung über die WebSphere Application Server-Administrationskonsole.
  6. Greifen Sie auf die eigenständige HATS-Verwaltungskonsole zu. Verwenden Sie zum Beispiel die URL-Adresse http://<was-hostname>/<hats-verwaltungsprojektname>/hatsadmin/admin.
    Anmerkung:
    Für den Zugriff auf die HATS-Administrationskonsole müssen Sie einen anderen Browser verwenden als den, der für den Zugriff auf die Portlets verwendet wird.
    1. Wählen Sie Erste Schritte > Verwaltungsbereich aus.
    2. Klicken Sie auf Neu.
    3. Geben Sie in das Feld Host den Hostnamen Ihres WebSphere Application Server-Zielhosts ein.
    4. Geben Sie in das Feld Port den BOOTSTRAP_ADDRESS-Port für Ihren Zielserver ein. Sie finden den BOOTSTRAP_ADDRESS-Port für Ihren Zielserver, indem Sie in der WebSphere Application Server-Administrationskonsole die folgenden Schritte ausführen:
      1. Wählen Sie Server > Anwendungsserver aus.
      2. Klicken Sie auf Ihren Zielserver (entweder WebSphere Portal Server oder WebSphere Application Server, beispielsweise "server1", wenn ein HATS-Standardportlet direkt auf dem WebSphere Application Server installiert wird.
      3. Erweitern Sie auf der Registerkarte "Konfiguration" unter "Übertragungen" den Knoten Ports.
      4. Notieren Sie den BOOTSTRAP_ADDRESS-Port für Ihren Zielserver.
    5. Klicken Sie auf OK.
    6. Wählen Sie den neu hinzugefügten Host aus.
    7. Wählen Sie nicht die Option Alle Anwendungen innerhalb des oben ausgewählten Bereichs verwalten aus.
    8. Nun wird eine Liste von HATS-Portlets angezeigt. Verwalten Sie über die HATS-Administrationskonsole jeweils nur eine einzige Portletanwendung, indem Sie den gewünschten Eintrag in der Liste auswählen.

Im Portlet enthaltene Verwaltungsunterstützung verwenden

Wenn Sie HATS IBM Portlets mithilfe eines Portlets verwalten wollen, das die Unterstützung für die HATS-Administrationskonsole enthält, führen Sie die nachfolgenden Schritte aus.

Anmerkung:
Diese Option wird bei HATS-Standardportlets nicht untersützt.

  1. Erstellen Sie ein HATS IBM Portletprojekt in HATS Toolkit, indem Sie Datei > Neu > HATS-Projekt auswählen. Wählen Sie im Assistenten "Projekt erstellen" für Ihr IBM Portlet die Option Unterstützung für Administrationskonsole hinzufügen.
  2. Exportieren Sie das Portletprojekt in eine WAR-Datei, indem Sie in der Sicht "HATS-Projekte" mit der rechten Maustaste auf das Projekt klicken und Projekt exportieren auswählen.
  3. Implementieren Sie die WAR-Datei für das HATS IBM Portlet in Ihrem WebSphere Portal Server.
  4. Greifen Sie auf die WebSphere Application Server-Administrationskonsole zu, in der Ihr WebSphere Portal Server installiert ist.
    1. Wählen Sie Anwendungen > Enterprise-Anwendungen aus.
    2. Klicken Sie auf den Namen Ihres HATS-Verwaltungsportlets und anschließend auf Deployment-Deskriptor anzeigen.
    3. Beachten Sie den Wert PA_wert im Implementierungsdeskriptor, zum Beispiel PA_#uaj0rfu (WebSphere Portal Version 6.0) oder PA_projektname (WebSphere Portal Version 6.1).
    4. Wählen Sie Server > Anwendungsserver aus.
    5. Klicken Sie auf Ihren WebSphere Portal Server, und erweitern Sie auf der Registerkarte "Konfiguration" unter "Übertragungen" den Knoten Ports.
    6. Notieren Sie den BOOTSTRAP_ADDRESS-Port für Ihren Portalserver.
  5. Greifen Sie auf die HATS-Administrationskonsole zu, die in Ihrem Portlet enthalten ist, indem Sie den PA_wert verwenden, den Sie oben notiert haben. Verwenden Sie zum Beispiel die URL-Adresse http://<portalhostname>/wps/PA_value/hatsadmin/admin.
    Anmerkung:
    Für den Zugriff auf die HATS-Administrationskonsole müssen Sie einen anderen Browser verwenden als den, der für den Zugriff auf die Portlets verwendet wird.
    1. Wählen Sie Erste Schritte > Verwaltungsbereich aus.
    2. Klicken Sie auf Neu, geben Sie in das Feld Host den Hostnamen Ihres WebSphere Portal Server-Hosts ein, und geben Sie in das Feld Port den BOOTSTRAP_ADDRESS-Port für Ihren WebSphere Portal Server ein, den Sie oben notiert haben. Klicken Sie auf OK.
    3. Wählen Sie den neu hinzugefügten Host aus.
    4. Wählen Sie nicht die Option Alle Anwendungen innerhalb des oben ausgewählten Bereichs verwalten aus.
    5. Nun wird eine Liste von HATS-Portlets angezeigt. Verwalten Sie über die HATS-Administrationskonsole nur die Portletanwendung, in der die Konsole enthalten ist.

Hinweise und Einschränkungen zu HATS-Portlets

Allgemeine Hinweise und Einschränkungen

Die nachfolgende Liste enthält Hinweise und Einschränkungen für die Arbeit mit HATS IBM Portlets bzw. HATS-Standardportlets:

Hinweise und Einschränkungen für IBM Portlets

Beachten Sie bei der Arbeit mit HATS IBM Portlets die Hinweise und Einschränkungen der folgenden Liste:

Hinweise und Einschränkungen zu Standardportlets

Beachten Sie bei der Arbeit mit HATS-Standardportlets die Hinweise und Einschränkungen der folgenden Liste: