Integrationsobjekte verwenden

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.

Anmerkung:
Globale Variablen und Schablonen werden für Integrationsobjekte nicht unterstützt, die in HATS-Standardportlets verwendet werden.

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:

Integrationsobjekt erstellen

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:

Anmerkungen:
  1. Automatisch generierte Integrationsobjekte sind immer nicht verkettet.
  2. Informationen zur Erstellung von Integrationsobjekten bei Verwendung der DBCS-Unterstützung finden Sie in Integrationsobjekt erstellen.

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.

Anmerkung:
Der Ordner Integrationsobjekt ("IntegrationObject") unter Quelle ("Source") wird erst nach der Erstellung des ersten Integrationsobjekts angezeigt.

Verkettung von Integrationsobjekten

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.

Verwendbarkeit der Integrationsobjektverkettung bestimmen

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:

  1. Es muss eine Liste von Dateien abgerufen werden, die dem Benutzer angezeigt werden kann.
  2. Es müssen die Dateidetails für eine ausgewählte Datei abgerufen werden.

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.

Verkettung von Integrationsobjekten verwenden

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.

Abbildung 64. Lebensdauer von Verbindungen mit Verkettung
Lebensdauer von Verbindungen mit Verkettung

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.

  1. Wenn die Ausführung von Integrationsobjekt A beginnt, ruft es die im Makro angegebene Verbindung ab. Wenn eine Freigabeanzeige aktiviert und eine Verbindung verfügbar ist, ist die Verbindung bereits angemeldet und bereit. Wenn die Freigabeanzeige aktiviert, jedoch keine Verbindung verfügbar ist, wird die Verbindung erstellt und das Verbindungsmakro (falls angegeben) ausgeführt. Wenn die Freigabeanzeige inaktiviert ist, wird eine Verbindung erstellt und das Verbindungsmakro (falls angegeben) ausgeführt.
  2. Integrationsobjekt A führt das zugeordnete Makro aus und speichert die Verbindung sowie den aktuellen Status für den nächsten Aufruf. (Diesen Status würden Sie als Endstatuskennsatz bei der Verkettung von Integrationsobjekten definieren.)
  3. Wenn die Ausführung von Integrationsobjekt B beginnt, ruft es eine Verbindung und den zugehörigen Status aus den Verbindungsstatusdaten ab, da es sich um das mittlere Integrationsobjekt handelt. Sie müssen den Anfangsstatuskennsatz von Integrationsobjekt B wie den Endstatuskennsatz von Integrationsobjekt A definiert haben, damit diese Integrationsobjekte verkettet werden können.
  4. Wenn die Ausführung für Integrationsobjekt B abgeschlossen ist, wird die Verbindung und der entsprechende Status in den Verbindungsstatusdaten gespeichert.
  5. Integrationsobjekt C ruft die Verbindung ebenfalls aus den Verbindungsstatusdaten ab. Wenn die Ausführung von Integrationsobjekt C beginnt, ruft es eine Verbindung und den zugehörigen Status aus den Verbindungsstatusdaten ab, da es sich um das letzte Integrationsobjekt handelt. Sie müssen den Anfangsstatuskennsatz von Integrationsobjekt C wie den Endstatuskennsatz von Integrationsobjekt B definiert haben, damit diese Integrationsobjekte verkettet werden können. Integrationsobjekte, die sich an letzter Position in einer Kette befinden, haben keine Endstatuskennsätze, weil die Verbindung immer zurückgegeben wird.
  6. Wenn die Freigabeanzeige aktiviert ist, wird die Verbindung an den Pool zurückgegeben. Anderenfalls wird das Trennungsmakro (falls angegeben) ausgeführt und die Verbindung beendet.
Anmerkung:
Die Einstellungen für die Freigabeanzeige werden über die Registerkarte Makro Ihrer Verbindungseinstellungen definiert. Sie müssen die Poolverwendung aktivieren, damit die Einstellung für die Freigabeanzeige verfügbar ist. Weitere Informationen finden Sie in Verbindungseditor.

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:

  1. Zeichnen Sie die Makros auf.
  2. Erstellen Sie verkettete Integrationsobjekte aus den einzelnen Makros.
  3. Erstellen Sie Webseiten für jedes Integrationsobjekt.
Makro aufzeichnen

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.

Integrationsobjekte aus den einzelnen Makros erstellen
Wenn Sie alle Makros erstellt haben, können Sie zur Registerkarte HATS-Projektsicht in HATS Toolkit wechseln, den Projektnamen erweitern, und den Ordner Makros öffnen.

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.

Webseiten für jedes Integrationsobjekt erstellen
Wenn Sie Ihre Integrationsobjekte erstellt haben, können Sie anschließend Ihre Webseiten erstellen. Informationen zur Erstellung von Webseiten aus Integrationsobjekten finden Sie in Webseiten aus einem Integrationsobjekt erstellen.

Debugging von Anwendungen mit Integrationsobjektverkettung

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.

HPS5075 STATE_PLAY_ERROR bei Wiedergabe des Makros in Datei zzz.macro empfangen.
Dieser Fehler tritt auf, wenn die Wiedergabe des Makros fehlschlägt, weil es die aktuelle Anzeige nicht abgleichen kann. Dies kann geschehen, wenn ein Integrationsobjekt in der Kette in der richtigen Reihenfolge aufgerufen wird (eine Verbindung in einer bestimmten Kette wurde zu seiner Verwendung gefunden), sich das Makro selbst jedoch nicht wiedergeben ließ. Dies kann das Problem sein, wenn Ihre Anfangs- und Endstatuskennsätze alle gleich sind oder zumindest für zwei Integrationsobjekte gleich sind und Sie die Integrationsobjekte außerhalb der logischen Reihenfolge aufrufen.
HPS5035 HttpSession enthält kein Datenquellenobjekt {0}. Eine mögliche Ursache ist die Verwendung mehrerer Browser auf einer Maschine für eine verkettete Anwendung. Weitere Informationen hierzu finden Sie in der Dokumentation.
Dieser Fehler tritt auf, wenn ein Integrationsobjekt mit einem Anfangsstatuskennsatz des letzten Integrationsobjektstatus die Verbindung und deren Status nicht abrufen kann, weil der Anfangsstatuskennsatz des Integrationsobjekts nicht mit dem Endstatuskennsatz des vorhergehenden Integrationsobjekts übereinstimmt.

Wenn dieser Fehler auftritt, ermitteln Sie die Ursache, aus der dieses Integrationsobjekt nicht in der richtigen Reihenfolge aufgerufen wird.

Webseiten aus einem Integrationsobjekt erstellen

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.

Modell-1-Webseiten erstellen

Die traditionelle HATS-Methode zur Erstellung einer JSP wird als "Modell 1" bezeichnet.

Anmerkung:
Dies ist die einzige Methode, die für HATS-Standardportlets unterstützt wird.

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.

Anmerkung:
Wenn Ihr Makro keine Eingabeaufforderungen enthält, wird keine Eingabeseite erstellt.

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.

Anmerkung:
Wenn Sie Modell-1-Webseiten für Integrationsobjekte in HATS-Standardportletprojekten verwenden, beachten Sie die folgenden Hinweise:

Struts-Webseiten erstellen

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.

Anmerkung:
Diese Methode wird für HATS-Standardportlets nicht unterstützt.

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:

Struts Action-Klasse
Diese Klasse ist die Main-Klasse. Sie instanziiert das Integrationsobjekt, legt die Integrationsobjekteigenschaften mit Werten aus der Klasse "ActionForm" fest, legt den Poolnamen des Integrationsobjekts fest und führt das Integrationsobjekt aus. Anschließend wechselt sie zur Ausgabe-JSP oder kehrt im Falle eines Fehlers zur HATS-Laufzeit zurück, sodass die HATS-Laufzeit eine Fehlerbehandlung ausführen kann. Der Entwickler sollte diese Klasse nicht ändern.
ActionForm-Klasse
Diese Klasse enthält die setter- und getter-Methoden für die einzelnen Eingaben in der Eingabe-JSP. Die Eingabe-JSP übergibt an das Struts-Servlet, das die Klasse "ActionForm" instanziiert und alle ihre Eigenschaften auf der Basis des übergebenen Eingabe-JSP-Formulars festlegt. Diese Klasse wird von der Klasse "Action" verwendet, um Werte für alle Eigenschaften des Integrationsobjekts festzulegen. Wenn Sie Eingabeeigenschaften in der Eingabe-JSP hinzufügen oder entfernen, müssen Sie auch die entsprechenden setter- und getter-Methoden in dieser Datei hinzufügen bzw. entfernen.
Eingabe-JSP
Die Eingabe-JSP enthält ein Struts-HTML-Formular, das die Anforderung an den Struts Controller sendet, der eine ActionForm-Klasse erstellt und die Anforderung an die entsprechende Action-Klasse weiterleitet. Wenn das Integrationsobjekt keine Eingaben erfordert oder wenn die Eingaben aus anderen Quellen, zum Beispiel aus globalen Variablen, kommen, wird eine leere Eingabe-JSP erstellt, die nur das HTML-Formular enthält. Die Eingabeseite wird im Ordner Struts-Seiten erstellt. Zum Testen Ihrer Seiten öffnen Sie den Ordner und suchen die Seite heraus, die Sie erstellt haben. Klicken Sie mit der rechten Maustaste auf die Seite, und wählen Sie Ausführen auf Server aus.
Ausgabe-JSP
Die Ausgabe-JSP zeigt die Ausgabeeigenschaften des Integrationsobjekts an. Diese Seite ist einer Modell-1-Ausgabe-JSP ähnlich.
WebDiagram
Diese Seite zeigt den Datenfluss und die Logik der auf Struts basierenden Webseiten an. Weitere Informationen zur Änderung des Webdiagramms finden Sie in der Dokumentation zu Struts-Tools in Rational SDP.

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-Webseiten erstellen

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.

Anmerkung:
Diese Methode wird für HATS-Standardportlets oder HATS IBM Portlets nicht unterstützt.

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.

BasicIOErrorPage.jsp und AdvancedIOErrorPage.jsp

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.

Mit Integrationsobjekten in JSPs arbeiten

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.

Integrationsobjekteigenschaften einfügen

Sie können Ein- und Ausgaben von Integrationsobjekten Ihrer Umsetzungs-JSP hinzufügen.

Eingabe

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.

Ausgabe

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.

Weiterleitung an HATS-Anwendung einfügen

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.