Dieses Kapitel bietet eine Einführung in Integrationsobjekte. Dabei handelt es sich um Java™-Beans, die Interaktionen mit einer Hostanwendung einbinden. Integrationsobjekte werden nur von HATS-Webanwendungen, einschließlich HATS-Portlets, unterstützt.
Wenn Sie mit IBM® WebSphere Host Publisher gearbeitet haben, sind Sie mit den meisten Aspekten von Integrationsobjekten bereits vertraut. Sie benötigen allerdings noch Kenntnisse, wie Integrationsobjekte in HATS verwendet werden. Sie brauchen jedoch kein erfahrener Host Publisher-Entwickler zu sein, um Integrationsobjekte in HATS erstellen und verwenden zu können.
Wenn Ihre HATS-Anwendung darauf ausgelegt ist, nur eine Hostanwendung ohne sekundäre Verbindungen umzusetzen, ist keine Verwendung von Integrationsobjekten erforderlich. Sie benötigen Integrationsobjekte möglicherweise dann, wenn eine der folgenden Aussagen zutrifft:
Wenn Sie ein Integrationsobjekt erstellt haben, können Sie es auf viele Arten verwenden:
Informationen über weitere erweiterte Tasks, die mit Integrationsobjekten ausgeführt werden können, finden Sie im Handbuch HATS Web Application Programmer's Guide. Neben anderen werden zum Beispiel die folgenden Tasks erläutert:
Ein Integrationsobjekt wird aus einem Makro erstellt. Führen Sie die in Makros und Host-Terminal beschriebenen Schritte zur Aufzeichnung eines Makros aus.
Klicken Sie mit der rechten Maustaste auf das Makro in der Sicht "HATS-Projekte", und wählen Sie Integrationsobjekt erstellen aus. Das Integrationsobjekt erhält denselben Namen wie das Makro. Sie können außerdem eine Benutzervorgabe in HATS angeben, um automatisch ein Integrationsobjekt zu generieren, wenn ein Makro aufgezeichnet wird. Klicken Sie auf Fenster > Benutzervorgaben, erweitern Sie HATS in der Baumstruktur auf der linken Seite, und klicken Sie auf Integrationsobjekt. Wählen Sie das Markierungsfeld Integrationsobjekt beim Speichern eines Makros automatisch generieren aus, und klicken Sie anschließend auf Anwenden.
Stellen Sie sicher, dass Sie bei der Auswahl eines Namens für ein Makro, das zur Erstellung eines Integrationsobjekts verwendet werden soll, die folgenden Voraussetzungen erfüllen:
Integrationsobjekte können nicht aus verketteten Makros generiert werden. Die Verkettung von Integrationsobjekten unterscheidet sich von der Verkettung von Makros insofern grundsätzlich, als dass jedes Integrationsobjekt in einer Kette bis zum Abschluss ausgeführt wird, bevor das nächste Integrationsobjekt in der Kette die Steuerung übernimmt. Bei der Makroverkettung unter Verwendung der HATS-Aktion Makro wiedergeben wird das aktuelle Makro (dasjenige, in dem die Aktion Makro wiedergeben erfolgt) beendet und die Verarbeitung der angegebenen Makroanzeige des Zielmakros gestartet. Wenn Sie ein Host On-Demand-Makro importieren, das den Tag <playmacro name="nameDesVerkettetenMakros"/> enthält, können Sie nur dieses Makro in den HATS-Aktionen Makro wiedergeben und Makrotransaktion ausführen verwenden. Weitere Informationen zur Verkettung von Makros finden Sie im Handbuch HATS Advanced Macro Guide.
Wenn ein Makro mithilfe des Makroeditors verkettet wird, nachdem ein Integrationsobjekt aus diesem Makro generiert wurde, muss das Integrationsobjekt erneut generiert werden, um die Änderung präzise nachzuvollziehen. Wenn die Benutzervorgabe Integrationsobjekt beim Speichern eines Makros automatisch generieren ausgewählt ist, wird das Integrationsobjekt automatisch aktualisiert.
Sie können eine Liste der von Ihnen erstellten Integrationsobjekte anzeigen, indem Sie auf die Registerkarte HATS-Projekte in HATS Toolkit klicken und den Projektnamen erweitern. Wechseln Sie zu Quelle > Integrationsobjekt, und klicken Sie doppelt auf den Ordner, um den Inhalt anzuzeigen.
Die Verkettung von Integrationsobjekten bietet Ihnen die Möglichkeit, mehrere Integrationsobjekte zu erstellen, die zu einer größeren Task innerhalb Ihrer Host Access Transformation Services-Anwendung zusammengruppiert werden können. Jedes Integrationsobjekt führt eine Subtask aus, und die größere Gesamttask wird durch eine Kette von Integrationsobjekten ausgeführt. Wenn die Anwendung ausgeführt wird, werden die Integrationsobjekte nacheinander ausgeführt, wobei jedes dieselbe Verbindung verwendet.
Wenn Sie mit der rechten Maustaste auf das Makro klicken, um das Integrationsobjekt zu erstellen, wählen Sie Verkettetes Integrationsobjekt erstellen aus. Geben Sie anschließend an, ob sich das Integrationsobjekt an erster, mittlerer oder letzter Position in der Kette befinden soll. Es können mehrere Integrationsobjekte an mittlerer Position in einer Kette vorhanden sein. Geben Sie die Kennsätze ein, die den Anfangs- und Endstatus für dieses Integrationsobjekt angeben. Für ein Integrationsobjekt, das sich an erster Position in der Kette befindet, ist kein Anfangsstatuskennsatz vorhanden. Für ein Integrationsobjekt, das sich an letzter Position in der Kette befindet, ist kein Endstatuskennsatz vorhanden. Statuskennsätze sind erforderlich, um sicherzustellen, dass die Integrationsobjekte in einer Kette in der richtigen Reihenfolge verarbeitet und jedes Mal die richtigen Daten übergeben werden.
In diesem Abschnitt wird die Verkettung von Integrationsobjekten im Detail beschrieben und erläutert, wie Sie sie in Ihren HATS-Anwendungen nutzen.
Zur Ermittlung, wie viele Integrationsobjekte in der Kette benötigt werden, beginnen Sie damit, dass Sie alle Subtasks auflisten, die ausgeführt werden müssen. Stellen Sie sich zum Beispiel vor, dass eine Hostanwendung mit dem Namen fileview eine Liste von Dateien anzeigt, wenn sie aufgerufen wird. In der Liste von Dateien kann ein Benutzer eine beliebige Datei auswählen, indem er "1" neben den Namen der Datei eingibt und auf die Eingabetaste drückt, sodass anschließend der Inhalt der Datei angezeigt wird. Bei diesem Prozess sind zwei Tasks auszuführen:
Es sind zwei Makros erforderlich, weil der Benutzer eine Entscheidung treffen muss, bevor das zweite Makro ausgeführt werden kann. Das zweite Makro muss auf die Benutzereingabe warten. Das Definieren der Stellen, an denen Benutzereingaben erforderlich sind, ist der erste Schritt bei der Aufteilung Ihrer Tasks in einzelne Integrationsobjekte.
Wenn der Benutzer mehrere Auswahlmöglichkeiten hat und jede Auswahlmöglichkeit andere Hostaktionen bewirkt, muss für jede Auswahlmöglichkeit ein separates Integrationsobjekt vorgesehen werden. Anschließend können Sie die Integrationsobjekte abhängig von der Auswahl des Benutzers dynamisch zusammensetzen. Ein Beispiel für einen solchen Fall ist ein Menü mit fünf Menüpunkten. Wenn der Benutzer eine beliebige der fünf Auswahlmöglichkeiten auswählen darf, muss jede Auswahlmöglichkeit als unabhängiges Integrationsobjekt erstellt werden.
Wenn Sie die Anzahl der separaten Tasks in Ihrer Anwendung definiert haben, können Sie entscheiden, wie sich die Verkettung auf Ihre Anwendung auswirken soll. Wenn Sie mehr als zwei Tasks haben, kann die Verkettung zur Verbesserung der Antwortzeit Ihrer Anwendung oder zur Verringerung des erforderlichen Makroaufzeichnungsaufwands beitragen, sodass sich Ihre Integrationsobjekte insgesamt vereinfachen lassen.
Ein Integrationsobjekt in einer Kette belässt die Verbindung in einem Status (d. h. auf einer bestimmten Anzeige). Wenn die Ausführung eines Integrationsobjekts beendet ist, kann ein anderes Integrationsobjekt, das in diesem Status (d. h. auf dieser Anzeige) beginnt, ausgeführt werden.
Durch die Verkettung können Sie eine komplexe Anwendung in mehrere Tasks zerlegen, die jeweils durch ein Integrationsobjekt dargestellt werden. Sie müssen die richtige Reihenfolge der Integrationsobjekte sicherstellen.
Wenn Sie zum Beispiel drei Integrationsobjekte in einer Kette (A, B und C) haben, müssen Sie A zuerst, dann B und anschließend C verwenden. Wenn das Integrationsobjekt C vor dem Integrationsobjekt B aufgerufen wird und C daraufhin seine Verbindung anfordert, ist die Verbindung nicht im richtigen Status verfügbar und die Ausführung des Integrationsobjekts schlägt fehl.

Abb. 64 stellt die Lebensdauer einer Verbindung während der Ausführung von drei Integrationsobjekten dar. Integrationsobjekt A ist als erstes, Integrationsobjekt B als mittleres und Integrationsobjekt C als letztes Element der Kette konfiguriert. Die Verbindungsstatusdaten stellen die Verbindung und den Statuskennsatz der letzten Ausführung eines Integrationsobjekts dar.
Zur Erstellung einer Anwendung mit Verkettung von Integrationsobjekten in HATS müssen Sie zunächst die Integrationsobjekte und anschließend Ihre Webseiten aus den Integrationsobjekten erstellen.
Führen Sie die folgenden Schritte zur Erstellung Ihrer Anwendung aus:
Sie können Makros in HATS Toolkit über das HATS-Host-Terminal aufzeichnen. Klicken Sie auf der HATS-Host-Terminalanzeige auf das Symbol Makro aufzeichnen. Informationen zur Aufzeichnung von Makros finden Sie in Auf Makros bezogene Symbole.
Wiederholen Sie diese Schritte für jedes Integrationsobjekt, das Sie erstellen wollen.
Klicken Sie mit der rechten Maustaste auf die einzelnen Makros, und wählen Sie Verkettetes Integrationsobjekt erstellen aus. Sie haben die Option, die Position in der Objektkette als Erstes, Mittleres oder Letztes auszuwählen. Wenn Sie Erstes auswählen, ist der Status der Endstatus bei der Verkettungskonfiguration für Integrationsobjekte. Wenn Sie Mittleres auswählen, ist der Status entweder der Anfangsstatus oder der Endstatus. Die Position Letzte der Objektkette verwendet den Anfangsstatus.
Diese Konfiguration muss für alle Integrationsobjekte ausgeführt werden, die Teil der Kette sind.
Die Verkettung von Integrationsobjekten ist zwar ein leistungsfähiges Tool zur Modellierung der komplexesten Hostanwendungen, jedoch müssen Sie bei der Zusammensetzung Ihrer Anwendungen sehr sorgfältig vorgehen. Es besteht die Gefahr, dass Sie eine Java EE-Anwendung mit Integrationsobjekten erstellen, die nicht in der richtigen Reihenfolge aufgerufen werden. Daher sollten Sie die Fehler kennen, die Sie auf dem Server empfangen, wenn dies der Fall ist.
Wenn Sie die Integrationsobjekte nicht richtig verketten, treten Probleme bei der Ausführung von Integrationsobjekten auf. Nachfolgend werden einige Fehlernachrichten aufgeführt, die auf dem Server ausgegeben werden können, und erläutert, wie Sie die Fehler beheben können.
Wenn dieser Fehler auftritt, ermitteln Sie die Ursache, aus der dieses Integrationsobjekt nicht in der richtigen Reihenfolge aufgerufen wird.
Sie können eine JSP aus einem beliebigen Integrationsobjekt erstellen. Es gibt drei Erstellungsmethoden für solche Seiten: Modell 1, JSF und Struts. In den folgenden Abschnitten werden diese drei Methoden und die Erstellung von Seiten mit diesen Methoden beschrieben.
Die traditionelle HATS-Methode zur Erstellung einer JSP wird als "Modell 1" bezeichnet.
In diesem Modell enthält eine einzelne JSP-Seite folgende Elemente:
Klicken Sie in der Sicht HATS-Projekte mit der rechten Maustaste auf den Namen eines Integrationsobjekts, und wählen Sie Modell-1-Webseiten erstellen aus. Geben Sie Namen für die Ein- und die Ausgabeseite sowie für das Ziel an, oder übernehmen Sie die Standardnamen, die aus dem Namen des Integrationsobjekts erstellt werden. Sie können auch Seitengenerierungsoptionen angeben, indem Sie An vorhandene Dateien anhängen oder Vorhandene Dateien überschreiben auswählen. Klicken Sie auf Weiter, wenn Sie Ihre Optionen ausgewählt haben.
Wenn Sie Modell-1-Webseiten erstellen, definieren Sie zwei Seiten: eine Eingabeseite, die die Daten erfasst, die vom Integrationsobjekt benötigt werden, und eine Ausgabeseite, die die Ergebnisse darstellt, nachdem das Integrationsobjekt ausgeführt wurde.
Auf der Seite Eingaben definieren können Sie für jede Eingabeeigenschaft ein Eingabesteuerelement definieren. Wählen Sie zum Ändern eines Steuerelements eine Eingabeeigenschaft aus und klicken Sie auf Bearbeiten. Sie können den führenden Text für das Steuerelement hinzufügen und bei Bedarf das ausgewählte Steuerelement konfigurieren. Anstatt ein Eingabesteuerelement zu verwenden, können Sie auswählen, dass die Eingabeeigenschaft auf den Wert einer globalen Variable eingestellt wird. Sie können den Wert für die Eingabeeigenschaft auch als globale Variable speichern (globale Variablen, die von Integrationsobjekten verwendet werden, sind gemeinsam genutzte Variablen). Wenn die Eingabeseite ausgeführt wird, übergibt sie die Steuerung nicht direkt an die Ausgabeseite. Sie gibt die Steuerung vielmehr an die HATS-Anwendung zurück, sodass globale Variablen festgelegt und andere Aktionen nach Bedarf ausgeführt werden können.
Auf der Seite Ausgaben definieren wählen Sie die Ausgabeeigenschaften des Integrationsobjekts aus, die angezeigt werden sollen. Wählen Sie zum Ändern eines Steuerelements eine Ausgabeeigenschaft aus und klicken Sie auf Bearbeiten. Sie können den führenden Text für das Steuerelement hinzufügen. Die Ausgabe-JSP enthält Code zur Initialisierung des Integrationsobjekts, zur Festlegung von Integrationsobjekteigenschaften mit Werten aus globalen Variablen, zur Ausführung des Integrationsobjekts sowie zum Anzeigen der Ausgabe des Integrationsobjekts.
Die von Ihnen erstellten Seiten werden in der Sicht HATS-Projekte im Ordner Webinhalt/Modell-1-Seiten gespeichert. Zum Bearbeiten einer Webseite doppelklicken Sie auf den Namen der Seite, um den Page Designer zu starten. Klicken Sie zum Testen Ihrer Seiten mit der rechten Maustaste auf die Eingabeseite (bzw. Ausgabeseite, falls keine Eingaben benötigt werden) und wählen Sie die Option Debug auf Server oder Ausführen auf Server aus.
SignOn.setHPubStartPoolName("<neuer_projektname>/<standardverbindung>");Wenn die Struts-Tools-Komponente von Rational SDP installiert ist, bietet Ihnen HATS die Möglichkeit, Struts zur Erstellung von Webseiten auf der Basis von Integrationsobjekten zu verwenden.
Klicken Sie in der Sicht HATS-Projekte mit der rechten Maustaste auf den Namen eines Integrationsobjekts, und wählen Sie Struts-Webseiten erstellen aus. Geben Sie Namen für die Ein- und die Ausgabeseite an, oder übernehmen Sie die Standardnamen, die aus dem Namen des Integrationsobjekts erstellt werden. Klicken Sie auf Fertig stellen.
Wenn Sie Struts-Webseiten erstellen, generiert HATS fünf neue Dateien:
HATS fügt außerdem der Datei "struts-config.xml" eine Aktionszuordnung hinzu, um die Action-Klasse der ActionForm-Klasse zuzuordnen.
Struts wurde im Rahmen des Jakarta-Projekts der Apache Software Foundation entwickelt. Detaillierte Informationen zu Struts finden Sie unter http://jakarta.apache.org/struts sowie unter "Hilfe - Inhalt" in Rational SDP.
JSF (JavaServer Faces) ist ein Framework zur Entwicklung von Benutzerschnittstellen (UI) für Webanwendungen, die auf einem Java-Server ausgeführt werden. Sie können rasch Webanwendungen erstellen, indem Sie wiederverwendbare UI-Komponenten auf einer Seite zusammensetzen. Wenn Sie JSF-Webseiten erstellt haben, können Sie mithilfe von Tools wie dem Page Designer (Seitendesigner) oder der Palette Änderungen und Bearbeitungen vornehmen.
Klicken Sie in der Sicht HATS-Projekte mit der rechten Maustaste auf den Namen eines Integrationsobjekts, und wählen Sie JSF-Webseiten erstellen aus. Geben Sie Namen für die Ein- und die Ausgabeseiten sowie für das Ziel an, oder übernehmen Sie die Standardnamen, die aus dem Namen des Integrationsobjekts erstellt werden. Sie können auch das Markierungsfeld Vorhandene Dateien überschreiben auswählen, wenn vorhandene Dateien überschrieben werden sollen. Klicken Sie auf Weiter, wenn Sie Ihre Optionen ausgewählt haben.
Wenn Sie JSF-Webseiten erstellen, definieren Sie zwei Seiten: eine Eingabeseite, die die Daten erfasst, die vom Integrationsobjekt benötigt werden, und eine Ausgabeseite, die die Ergebnisse darstellt, nachdem das Integrationsobjekt ausgeführt wurde.
Für die Eingabeseite können Sie für jede Eingabeeigenschaft ein Eingabesteuerelement definieren. Wählen Sie zum Ändern eines Steuerelements eine Eingabeeigenschaft aus und klicken Sie auf Bearbeiten. Sie können den führenden Text für das Steuerelement hinzufügen und bei Bedarf das ausgewählte Steuerelement konfigurieren. Klicken Sie auf Weiter.
Für die Ausgabeseite wählen Sie die Ausgabeeigenschaften des Integrationsobjekts aus, die angezeigt werden sollen. Wählen Sie zum Ändern eines Steuerelements eine Ausgabeeigenschaft aus und klicken Sie auf Bearbeiten. Sie können den führenden Text für das Steuerelement hinzufügen. Klicken Sie auf Fertig stellen.
Die von Ihnen erstellten Seiten werden in der Sicht HATS-Projekte im Ordner Webinhalt/JSF-Seiten gespeichert. Zum Bearbeiten einer Webseite doppelklicken Sie auf den Namen der Seite, um den Page Designer zu starten. Klicken Sie zum Testen Ihrer Seiten mit der rechten Maustaste auf die Eingabeseite (bzw. Ausgabeseite, falls keine Eingaben benötigt werden) und wählen Sie die Option Debug auf Server oder Ausführen auf Server aus.
Die Seite "BasicIOErrorPage" ist die Standardfehlerseite, die von JSPs verwendet wird, die Integrationsobjekte steuern. Falls ein Fehler auftritt, werden Basisinformationen über die Art des Fehlers an den Browser zurückgegeben. Die Back-End-Verbindung wird bei dieser Verarbeitung automatisch verworfen.
Die Seite "AdvancedIOErrorPage.jsp" ermöglicht die Übergabe der Verbindung an das HATS-Eingangsservlet für eine Standardumsetzung, wenn die Verbindung aus der Definition der Standardverbindung erstellt wurde. Diese Verarbeitung bietet Ihnen die Möglichkeit, mit der Back-End-Verbindung zu interagieren und die Ursache des Fehlers möglicherweise zu ermitteln. Die Standardumsetzung bietet Ihnen außerdem die Möglichkeit, die Verbindung zu trennen. Im Wesentlichen stellt die Seite "AdvancedIOErrorPage.jsp" mehr Steuerungsmöglichkeiten für die Verarbeitung bereit, wenn ein Integrationsobjekt einen Fehler feststellt.
Sie finden diese Fehlerseiten im Ordner Webinhalt der Sicht Navigator Ihres Projekts.
Diese Funktionen der HATS-Tools gelten für die Arbeit mit Integrationsobjekten in JSPs. Sie können die nachfolgend aufgeführten Elemente über das Menü HATS-Tools in der Menüleiste von HATS Toolkit auswählen.
Sie können Ein- und Ausgaben von Integrationsobjekten Ihrer Umsetzungs-JSP hinzufügen.
Wählen Sie Integrationsobjekteigenschaften einfügen > Eingabe aus, wenn Sie einer JSP eine Integrationsobjekteingabe hinzufügen wollen. Geben Sie auf der Seite "Integrationsobjektklasse auswählen" den Klassennamen des Integrationsobjekts, das Sie verwenden wollen, und anschließend die Zielseite ein, die angezeigt wird, wenn der Benutzer das Eingabeformular übergibt. Klicken Sie auf Weiter. Wählen Sie auf der Seite "Eingaben definieren" zum Ändern eines Steuerelements eine Eingabeeigenschaft aus und klicken Sie auf Bearbeiten. Hier können Sie den führenden Text definieren, ein geeignetes Eingabesteuerelement auswählen und bei Bedarf konfigurieren sowie den Wert als globale Variable speichern.
Wählen Sie Integrationsobjekteigenschaften einfügen > Ausgabe aus, wenn Sie einer JSP eine Integrationsobjektausgabe hinzufügen wollen. Geben Sie auf der Seite "Integrationsobjektklasse auswählen" den Klassennamen des Integrationsobjekts ein, das Sie verwenden wollen, und klicken Sie auf das Markierungsfeld Transaktionsmethoden für das Integrationsobjekt einfügen, um die Transaktionsmethoden hinzuzufügen, die Integrationsobjekte ausführen. Klicken Sie auf Weiter. Wählen Sie auf der Seite "Ausgaben definieren" zum Ändern eines Steuerelements eine Ausgabeeigenschaft aus und klicken Sie auf Bearbeiten. Hier können Sie den führenden Text definieren und ein geeignetes Eingabesteuerelement auswählen.
Eine globale HATS-Variable enthält einen Wert, der zur Übergabe von Informationen aus einem HATS-Objekt an ein anderes verwendet werden kann. Wenn Sie Ausgabedaten eines Integrationsobjekts an ein anderes HATS-Objekt übergeben wollen, müssen Sie der Ausgabe-JSP, die zur Ausführung des Integrationsobjekts verwendet wird, Code hinzufügen. Sie müssen den Code nach der erfolgreichen Ausführung des Integrationsobjekts hinzufügen. Beispiel:
<% IOGV.setGlobalVariableString(session, "exampleGV", exampleIO.getOutputData()); %>
In diesem Beispiel wird der gemeinsam genutzten globalen Variablen mit dem Namen "exampleGV" der Wert der Eigenschaft "OutputData" des Integrationsobjekts "exampleIO" zugewiesen.
Die globale Variable, die in einer Integrationsobjektumgebung verwendet wird, muss als gemeinsam genutzte globale Variable definiert sein. Der Code in diesem Beispiel erstellt die gemeinsam genutzte Variable, wenn sie nicht bereits vorhanden ist.
Wählen Sie die Option Weiterleitung an HATS-Anwendung einfügen aus, um Ihrer Umsetzung einen Knopf hinzuzufügen, der JSP-Steuerinformationen zurück an die HATS-Anwendung (Webanwendung oder Standardportlet) weiterleitet, die Ihr Benutzer gestartet hat. Es kann zum Beispiel wünschenswert sein, die Steuerung an die HATS-Anwendung zurückzugeben, wenn eine JSP ein Integrationsobjekt ausgerufen hat und eine vorgesehene Task ausführt. Sie können die Attribute dieses Knopfs in der Sicht Entwurf bearbeiten, indem Sie den Knopf hervorheben, mit der rechten Maustaste darauf klicken und Attribute auswählen.