Mit Anzeigenereignissen arbeiten

Als HATS-Ereignis wird eine Ressource bezeichnet, die aufgrund eines bestimmten erreichten Status' eine Reihe von Aktionen ausführt. Es gibt zwei Typen von HATS-Ereignissen, nämlich Anwendungsereignisse und Anzeigenereignisse. Weitere Informationen zu Anwendungsereignissen finden Sie unter Anwendungsereignisse. Als Anzeigenereignis gilt ein HATS-Ereignis, das ausgelöst wird, wenn eine Hostanzeige aufgrund einer Übereinstimmung mit bestimmten Kriterien für die Anzeigenerkennung erkannt wird. Es gibt zwei Typen von Anzeigenereignissen, nämlich Anzeigenanpassungen und Anzeigenkombinationen.

Eine Anzeigenanpassung ist ein HATS-Anzeigenereignis, das dazu dient, eine Reihe von Aktionen auszuführen, nachdem eine Hostanzeige erkannt wurde. Zu Beispielen für die Anzeigenanpassung zählen die Erkennung einer Anzeige und ihre Umsetzung in eine grafische Benutzerschnittstelle für den Benutzer oder die Wiedergabe eines Makros, mit dem eine Anzeige übersprungen wird. Die Definition der Anzeigenanpassung enthält eine Reihe von Kriterien für die Anzeigenerkennung sowie eine Liste von Aktionen, die ausgeführt werden sollen, wenn eine Hostanzeige mit diesen Kriterien übereinstimmt. Außerdem umfasst sie globale Regeln auf Anzeigenebene und Einstellungen für das Ersetzen von Text. Zur Erstellung einer neuen Anzeigenanpassung verwenden Sie den Assistenten "Anzeigenanpassung erstellen".

Eine Anzeigenkombination ist ein HATS-Anzeigenereignis, das Ausgabedaten aus aufeinanderfolgenden ähnlichen Hostanzeigen erfasst, diese Daten kombiniert und sie in einer einzigen Ausgabeseite anzeigt. Ein Beispiel für eine Anzeigenkombination ist die Erkennung einer Anzeige, die nur Teilausgabedaten enthält, und die Navigation durch alle nachfolgenden Anzeigen, damit alle übrigen Daten erfasst und für den Benutzer angezeigt werden können. Die Definition der Anzeigenkombination umfasst eine Reihe von Kriterien für die Anzeigenerkennung, die sowohl für die erste als auch für die letzte Anzeige der Kombination angegeben sind. Außerdem beschreibt sie, wie die Navigation in den Anzeigen erfolgen soll und welche Komponente bzw. welches Fensterobjekt für die Erkennung und Wiedergabe der in jeder Anzeige erfassten Daten zu verwenden ist. Wie die Anzeigenanpassung enthält auch die Anzeigenkombination außerdem eine Liste von auszuführenden Aktionen, globale Regeln auf Anzeigenebene sowie Einstellungen für das Ersetzen von Text. Zur Erstellung einer neuen Anzeigenkombination verwenden Sie den Assistenten "Anzeigenkombination erstellen".

Assistent "Anzeigenanpassung erstellen"

Zur Definition von Anzeigenanpassungen in einem HATS-Projekt verwenden Sie den Assistenten Anzeigenanpassung erstellen. Bevor Sie den Assistenten für die Anzeigenanpassung verwenden, müssen Sie das Host-Terminal geöffnet oder eine Anzeigenerfassung erstellt haben. Zur Erstellung von Anzeigenerfassungen für Anzeigenanpassungen können auch BMS-Zuordnungen verwendet werden. Weitere Informationen zu BMS-Zuordnungsgruppen finden Sie unter BMS-Zuordnungsgruppen importieren.

Für den Zugriff auf den Assistenten können Sie eines der folgenden Verfahren verwenden:

Details zu den im Assistenten verfügbaren Einstellungen finden Sie unter Anzeigenereignisse bearbeiten.

Die Einstellungen, die Sie für die Anzeigenanpassung definieren, werden in einer Anzeigenanpassungsdatei (.evnt) gespeichert. Zum Anzeigen dieser Datei erweitern Sie den Ordner Anzeigenanpassungen in der Sicht HATS-Projekte. Mit dem Anzeigenereigniseditor können Sie die Anzeigenanpassungsdatei aufrufen und ändern.

Assistent "Anzeigenkombination erstellen"

Zur Definition von Anzeigenkombinationen in einem HATS-Projekt verwenden Sie den Assistenten Anzeigenkombination erstellen. Bevor Sie den Assistenten für die Anzeigenkombination verwenden, müssen Sie das Host-Terminal geöffnet oder eine Anzeigenerfassung erstellt haben. Zur Erstellung von Anzeigenerfassungen für Anzeigenkombinationen können auch BMS-Zuordnungen verwendet werden. Weitere Informationen zu BMS-Zuordnungsgruppen finden Sie unter BMS-Zuordnungsgruppen importieren.

Für den Zugriff auf den Assistenten können Sie eines der folgenden Verfahren verwenden:

Details zu den im Assistenten verfügbaren Einstellungen finden Sie unter Anzeigenereignisse bearbeiten.

Die Einstellungen, die Sie für die Anzeigenkombination definieren, werden in einer Anzeigenkombinationsdatei (.evnt) gespeichert. Zum Anzeigen dieser Datei erweitern Sie den Ordner Anzeigenkombinationen in der Sicht HATS-Projekte. Mit dem Anzeigenereigniseditor können Sie die Anzeigenkombinationsdatei aufrufen und ändern.

Anzeigenereignisse bearbeiten

Den Anzeigenereigniseditor können Sie aufrufen, indem Sie auf den Namen einer Datei ".event" für eine Anzeigenanpassung oder eine Anzeigenkombination doppelklicken. Die folgenden Abschnitte beschreiben die einzelnen Registerkarten im Anzeigenereigniseditor.

Übersicht

Auf der Registerkarte Übersicht des Anzeigenereigniseditors sind alle Informationen zusammengefasst, die Sie bei der Erstellung des Anzeigenereignisses angegeben haben. Sie enthält den Namen und die Beschreibung des Anzeigenereignisses, den Namen und das Bild der Anzeige, mit der die Kriterien für die Anzeigenerkennung erstellt wurden, eine Zusammenfassung der auszuführenden Aktionen sowie eine Zusammenfassung der Kriterien für die Anzeigenerkennung. Bei Anzeigenkombinationen enthält diese Registerkarte außerdem eine Zusammenfassung der Einstellungen für die Navigation, die Komponenten und die Kriterien zur Erkennung der Endanzeige. Auf dieser Registerkarte können Sie die Beschreibung des Anzeigenereignisses ändern und eine andere Anzeige auswählen, die dem Anzeigenereignis zugeordnet sein soll. Die ausgewählte Anzeige wird immer dann verwendet, wenn Sie Änderungen am Anzeigenereignis vornehmen, also beispielsweise die Kriterien für die Anzeigenerkennung ändern oder Aktionen hinzufügen.

Kriterien für die Anzeigenerkennung oder Startanzeige

Die Registerkarte Kriterien für die Anzeigenerkennung wird angezeigt, wenn Sie ein Anzeigenanpassungsereignis bearbeiten. Die Registerkarte Startanzeige wird bei der Bearbeitung eines Anzeigenkombinationsereignisses angezeigt. In beiden Fällen enthalten die Registerkarten die Kriterien für die Anzeigenerkennung, die Sie für die Übereinstimmung mit Hostanzeigen zum Auslösen des Anzeigenereignisses festgelegt haben. Zur Erkennung von Hostanzeigen kann eine beliebige Kombination von Kriterien verwendet werden, beispielsweise die Gesamtanzahl der Felder oder die Anzahl der Eingabefelder in der Anzeige, die Koordinaten der Cursorposition oder die Zeichenfolgen in einem definierten Ausschnitt der Anzeige bzw. an einer anderen Stelle der Anzeige. Die Kriterien auf dieser Registerkarte können Sie hinzufügen, bearbeiten oder entfernen.

Anmerkung:

Spezielle Hinweise für die Verwendung der DBCS-Unterstützung finden Sie unter Kriterien zur Anzeigenerkennung / Startanzeige.

Zugeordnete Anzeigenerfassung

Diese Option wird nur auf der Registerkarte Startanzeige für ein Anzeigenkombinationsereignis angezeigt. Klicken Sie auf den Knopf Ändern, um eine andere Anzeigenerfassung auszuwählen, die der Startanzeige der Anzeigenkombination zugeordnet werden soll.

Feldkriterien

Als Kriterien für die Anzeigenerkennung können Sie die Gesamtanzahl Felder in einer Anzeige und/oder die Anzahl der Eingabefelder in einer Anzeige verwenden. Die Einstellung Gesamtanzahl Felder schließt Eingabefelder, geschützte Textfelder und verdeckte Felder ein. Diese beiden Kriterien werden als Erstes auf der Registerkarte angezeigt.

Falls Sie die Markierungsfelder für diese Kriterien auswählen, werden sie zur Erkennung der Anzeige verwendet. In den Feldern neben jedem Feldkriterium ist die Gesamtanzahl der Felder und der Eingabefelder für die Anzeige angegeben, die auf der Registerkarte Übersicht angegeben ist. Falls Sie die Anzeige ändern, die für dieses Anzeigenereignis verwendet wird, klicken Sie auf Aktualisieren, um die Werte für die ausgewählte Anzeige zu aktualisieren.

Anmerkung:
Wenn Sie Feldkriterien zur Erkennung von Anzeigen einsetzen, die eine bestimmte Anzahl von Feldern enthalten, und eine Anzeige nicht diese Anzahl von Feldern enthält, wird diese Anzeige nicht erkannt. Beispiel: Eine Anzeige enthält eine Liste von zehn Dateien mit zehn Feldern. Falls der Host eine Anzeige mit nur acht Dateien in der Liste und acht Feldern ausgibt, stimmt die zweite Anzeige nicht mit der Anzahl des Feldkriteriums für das Anzeigenereignis überein, das mit der ersten Anzeige übereinstimmte.

Eine Erläuterung der Markierungsfelder Optional und Umkehren finden Sie unter Optionale und nicht optionale Kriterien für die Anzeigenerkennung bzw. Umgekehrte Übereinstimmung der Kriterien für die Anzeigenerkennung.

Kriterien der Cursorposition

Um die Startposition des Cursors als Kriterium für die Anzeigenerkennung zu verwenden (entweder als alleiniges Kriterium oder in Kombination mit anderen Kriterien), wählen Sie das Markierungsfeld Cursorposition aus. Die Felder neben dem Kriterium "Cursorposition" zeigen die Zeile und die Spalte der Cursorposition für die Anzeige, die auf der Registerkarte Übersicht angegeben ist. Falls Sie die für dieses Anzeigenereignis verwendete Anzeige ändern, klicken Sie auf Aktualisieren, um die Werte für die Zeile und die Spalte der Startposition des Cursors in der ausgewählten Anzeige zu aktualisieren.

Eine Erläuterung der Markierungsfelder Optional und Umkehren finden Sie unter Optionale und nicht optionale Kriterien für die Anzeigenerkennung bzw. Umgekehrte Übereinstimmung der Kriterien für die Anzeigenerkennung.

Optionale und nicht optionale Kriterien für die Anzeigenerkennung

Sie können auswählen, ob die festgelegten Kriterien für die Anzeigenerkennung optional oder nicht optional sein sollen. Falls Sie das Markierungsfeld Optional nicht auswählen, wird ein Erkennungskriterium als nicht optional betrachtet. Die Verwendung des Markierungsfelds Optional entspricht dem Anzeigendeskriptorattribut optional bei Host On-Demand.

Wenn Sie sowohl optionale als auch nicht optionale Erkennungskriterien verwenden, überprüft HATS zuerst die nicht optionalen Kriterien. Falls alle nicht optionalen Kriterien übereinstimmen, liegt eine Übereinstimmung der Anzeige vor. Weicht mindestens eines der nicht optionalen Kriterien ab, überprüft HATS die optionalen Kriterien. Damit eine Anzeige mit den Kriterien übereinstimmt, muss HATS entweder alle nicht optionalen Kriterien oder mindestens ein optionales Kriterium finden. Andernfalls stimmt die Anzeige nicht überein. Das folgende Beispiel erläutert dieses Konzept in detaillierterer Form.

Anmerkung:
Der Begriff "nicht optional" ist nicht im Sinne von "erforderlich" zu verstehen.

Beispiel: Sie haben die Cursorposition und zwei Zeichenfolgen mit den folgenden Werten definiert:

Cursorpositionserkennung  optional     
                             Zeile: 1   Spalte: 1

Zeichenfolgenerkennung       Nicht optional   
                             Zeichenfolge 1: Willkommen
                             Anfangsposition: Zeile: 1   Spalte: 6
                             Endposition:     Zeile: 1   Spalte: 12

                             Zeichenfolge 2: Benutzername
                             Anfangsposition: Zeile: 20  Spalte: 10
                             Endposition:     Zeile: 20  Spalte: 17

In diesem Beispiel muss HATS beide Zeichenfolgen oder die Cursorposition finden, damit die Anzeige übereinstimmt. Da HATS zuerst die nicht optionalen Kriterien überprüft, sucht HATS zunächst nach den Zeichenfolgen. Falls HATS beide Zeichenfolgen nicht in den angegebenen Bereichen der Hostanzeige finden kann, wird geprüft, ob das optionale Kriterium (Cursorposition) gefunden werden kann.

Umgekehrte Übereinstimmung der Kriterien für die Anzeigenerkennung

Sie können auswählen, ob die festgelegten Kriterien für die Anzeigenerkennung mit der Hostanzeige übereinstimmen oder nicht übereinstimmen sollen. Falls Sie das Markierungsfeld Umkehren auswählen, darf das Erkennungskriterium nicht mit der Anzeige übereinstimmen, damit es als zutreffend gilt.

Wählen Sie hingegen das Markierungsfeld Umkehren ab, muss das Erkennungskriterium mit der Anzeige übereinstimmen, damit es als zutreffend gilt.

Die Verwendung des Markierungsfelds Umkehren entspricht dem Anzeigendeskriptorattribut invertmatch.

Zusätzliche Kriterien

Zeichenfolgenkriterium

Die Kriterien für die Zeichenfolgenposition werden im Abschnitt "Zusätzliche Kriterien" der Registerkarte angezeigt. Wenn Sie eine Zeichenfolgenposition als Kriterium für die Anzeigenerkennung verwenden, ist sie in der Tabelle angegeben. Die Tabelle zeigt den Typ der Anzeigenposition, die den Text enthält, einige Zeichen des ausgewählten Textes und gibt außerdem an, ob der Text die Groß-/Kleinschreibung beachten muss, optional ist oder umgekehrt ist.

Falls Sie in der Tabelle eine Zeile hervorheben, die ein Zeichenfolgenkriterium definiert, und dann auf Bearbeiten klicken, oder falls Sie auf Hinzufügen klicken, wird der Dialog für das Anzeigenkriterium aufgerufen. In der Dialoganzeige können Sie die Informationen zur Zeichenfolge entweder ändern oder angeben. Sie können außerdem Attribute für die Zeichenfolge auswählen (Groß-/Kleinschreibung beachten, Optional, Umkehren). Die Anzeige gibt die Anzeige an, die auf der Registerkarte Übersicht ausgewählt ist.

Sie können jeden beliebigen Text in der Anzeige auswählen, indem Sie ein Rechteck um den Text zeichnen. Stellen Sie hierzu den Cursor auf eine Stelle in der Anzeige, drücken Sie die linke Maustaste, halten Sie die Taste gedrückt, und ziehen Sie den Cursor in eine andere Position der Anzeige. Die Felder auf der rechten Seite des Dialogs zeigen den ausgewählten Text sowie die Nummern der Anfangs- und Endzeile bzw. der Anfangs- und Endspalte für das Rechteck an. Den Teil der Anzeige, der den Text enthalten soll, können Sie angeben, indem Sie auf einen der Radioknöpfe Beliebige Stelle der Anzeige, An angegebener Position oder Innerhalb eines rechteckigen Bereichs klicken. Falls der ausgewählte Text die Groß-/Kleinschreibung beachten muss, um als Übereinstimmung mit den Kriterien für die Anzeigenerkennung erkannt zu werden, wählen Sie das Markierungsfeld Groß-/Kleinschreibung beachten aus.

Eine Erläuterung der Markierungsfelder Optional und Umkehren finden Sie unter Optionale und nicht optionale Kriterien für die Anzeigenerkennung bzw. Umgekehrte Übereinstimmung der Kriterien für die Anzeigenerkennung.

Klicken Sie nach Abschluss Ihrer Auswahl auf OK.

Kriterium für globale Variable

Mit globalen Variablen können Sie die Kriterien für die Anzeigenerkennung definieren, indem Sie auf den Abwärtspfeil neben dem Knopf Hinzufügen klicken und die Option Kriterium für globale Variable auswählen. Falls Sie ein Kriterium für eine globale Variable verwenden, müssen Sie entweder eine globale Variable in der Dropdown-Liste Globale Variable angeben oder den Wert eingeben. Wählen Sie einen der fünf folgenden Listenpunkte aus, um die Prüflogik anzugeben:

Eine Erläuterung der Markierungsfelder Optional und Umkehren im Abschnitt Attribute finden Sie unter Optionale und nicht optionale Kriterien für die Anzeigenerkennung bzw. Umgekehrte Übereinstimmung der Kriterien für die Anzeigenerkennung.

Weitere Informationen zur erweiterten Programmierung von globalen Variablen enthält - je nach Anwendungsumgebung - das Handbuch HATS Web Application Programmer's Guide bzw. HATS Rich Client Platform Programmer's Guide.

Farbkriterium

Sie können Farben als Kriterien für die Anzeigenerkennung definieren, indem Sie auf den Abwärtspfeil neben dem Knopf Hinzufügen klicken und die Option Farbkriterium auswählen. Hierdurch wird eine Anzeige aufgerufen, in der Sie die Zeilen- und Spaltenposition sowie die Vordergrund- und Hintergrundfarbe auswählen können.

Eine Erläuterung der Markierungsfelder Optional und Umkehren finden Sie unter Optionale und nicht optionale Kriterien für die Anzeigenerkennung bzw. Umgekehrte Übereinstimmung der Kriterien für die Anzeigenerkennung.

Kriterium "Bereich mit Wert vergleichen"

Das Kriterium Bereich mit Wert vergleichen ermöglicht den Textvergleich zwischen einem ausgewählten Bereich der Hostanzeige und einem fest codierten Wert.

Zeichnen Sie zunächst ein Rechteck um den Bereich des Terminals, oder geben Sie die Koordinaten für die Erkennung im Abschnitt Bereich definieren ein. Im Textfeld wird außerdem der aktuelle Wert auf dem Terminal angezeigt.

Anschließend können Sie angeben, womit der Bereich verglichen werden soll und wie der Vergleich durchgeführt wird. Wählen Sie im Abschnitt Vergleich definieren aus, wie der Bereich verglichen werden soll. Hierzu wählen Sie einen Eintrag in der Dropdown-Liste neben Bereich aus. Geben Sie dann die zu vergleichende Angabe im Textfeld Wert ein.

Der Vergleichstyp ist entweder Numerisch oder Text (mit einer Markierungsfeldoption Groß-/Kleinschreibung beachten).

Außerdem können Sie Attribute definieren. Eine Erläuterung der Markierungsfelder Optional und Umkehren finden Sie unter Optionale und nicht optionale Kriterien für die Anzeigenerkennung bzw. Umgekehrte Übereinstimmung der Kriterien für die Anzeigenerkennung.

Klicken Sie nach Abschluss Ihrer Auswahl auf OK.

Kriterium "Bereich mit Bereich vergleichen"

Das Kriterium Bereich mit Bereich vergleichen ermöglicht den Vergleich zwischen einem Bereich der Hostanzeige und einem anderen Bereich derselben Hostanzeige.

Wählen Sie zuerst die Registerkarte Erster Bereich aus, und zeichnen Sie ein Rechteck um den Bereich des Terminals, oder geben Sie die Koordinaten für die Erkennung im Abschnitt Bereich definieren ein. Im Textfeld wird außerdem der aktuelle Wert auf dem Terminal angezeigt.

Anschließend können Sie im Abschnitt Vergleich definieren angeben, wie die Bereiche verglichen werden sollen. Hierzu treffen Sie eine Auswahl im Dropdown-Menü zwischen Bereich 1 und Bereich 2.

Der Vergleichstyp ist entweder Numerisch oder Text (mit einer Markierungsfeldoption Groß-/Kleinschreibung beachten).

Außerdem können Sie Attribute definieren. Eine Erläuterung der Markierungsfelder Optional und Umkehren finden Sie unter Optionale und nicht optionale Kriterien für die Anzeigenerkennung bzw. Umgekehrte Übereinstimmung der Kriterien für die Anzeigenerkennung.

Wiederholen Sie diese Schritte auf der Registerkarte Zweiter Bereich, und klicken Sie abschließend auf OK.

Wiedergabe (nur Anzeigenkombination)

Die Registerkarte Wiedergabe wird nur für ein Anzeigenkombinationsereignis angezeigt. Auf dieser Registerkarte legen Sie fest, mit welcher Komponente die Informationen erkannt werden, die durch die Anzeigenkombination erfasst werden sollen. Außerdem geben Sie hier das Fensterobjekt an, mit dem die Komponente wiedergegeben wird. Bei Anzeigenkombinationsereignissen wird eine Teilgruppe der HATS-Komponenten und -Fensterobjekte unterstützt. Weitere Informationen zur Verwendung von HATS-Komponenten und -Fensterobjekten finden Sie unter Hostkomponente einfügen.

Durch Klicken auf den Knopf Bereich ändern können Sie die Anzeigenerfassung und den Bereich der Anzeige ändern, der von der Komponente berücksichtigt werden soll.

Mit der folgenden Einstellung können Sie in Projekten, die keine Portletprojekte sind, außerdem steuern, wann die Ergebnisse der Anzeigenkombination in Bezug auf den Abschluss der Anzeigenkombination zum ersten Mal für den Benutzer angezeigt werden.

Dynamisches Laden zwischengespeicherter Inhalte verwenden  Nur Web 
Wenn Sie dieses Feld nicht auswählen, geben Sie an, dass HATS durch alle Anzeigen der Anzeigenkombination navigieren und alle Ergebnisse kombinieren soll, bevor diese für den Benutzer angezeigt werden. Bei Auswahl dieses Feldes beginnt HATS mit dem Anzeigen der Ergebnisse für den Benutzer, sobald die Ergebnisse in der ersten Anzeige erfasst wurden, und aktualisiert die Anzeige der Ergebnisse kontinuierlich, während die Navigation durch die Anzeigen erfolgt.

Navigation (nur Anzeigenkombination)

Die Registerkarte Navigation wird nur für ein Anzeigenkombinationsereignis angezeigt. Sie enthält die erforderlichen Befehle für die Navigation ausgehend von der Startanzeige über die zwischengeschalteten Anzeigen bis zur Endanzeige der Anzeigenkombination. Mit den Knöpfen Hinzufügen, Bearbeiten und Entfernen können Sie Befehle für die Navigationsrichtungen Bewegung nach oben und Bewegung nach unten festlegen. Im aufgerufenen Dialog Befehl hinzufügen bzw. Befehl bearbeiten stehen drei Befehlsoptionen zur Auswahl. Mehrere Befehle können Sie für eine Navigationsrichtung auswählen, indem Sie mehrmals auf den Knopf Hinzufügen klicken. Die folgenden drei Befehlsoptionen können festgelegt werden:

Taste senden
Verwenden Sie diese Option, um eine Hosttaste auszuwählen, die an das Hostsystem gesendet werden soll.
Text einfügen
Verwenden Sie diese Option, um Text an der aktuellen Cursorposition einzufügen.
Cursorposition festlegen
Verwenden Sie diese Option, um die aktuelle Cursorposition in der Hostanzeige festzulegen.

Endanzeige (nur Anzeigenkombination)

Die Registerkarte Endanzeige wird nur für ein Anzeigenkombinationsereignis angezeigt. Sie enthält die von Ihnen festgelegten Kriterien, die das Ende der Anzeigenkombination definieren. Die Kriterien auf dieser Registerkarte können Sie hinzufügen, bearbeiten oder entfernen. Sie können einen der drei folgenden Typen für die Endkriterien auswählen: Nur Iterationszähler, Nur Anzeigendeskriptor oder Erste Übereinstimmung mit Iterationszähler oder Anzeigendeskriptor.

Endkriterien auswählen

Nur Iterationszähler
Wählen Sie diese Option zusammen mit der Einstellung Anzahl der Iterationen aus, um anzugeben, dass diese Anzeigenkombination nach einer festgelegten Anzahl von Anzeigen endet.
Nur Anzeigendeskriptor
Wählen Sie diese Option zusammen mit den anderen Einstellungen für die Anzeigenerkennung (z. B. Gesamtanzahl Felder, Anzahl Eingabefelder, Cursorposition oder Zusätzliche Kriterien) aus, um die Endanzeige für die Anzeigenkombination zu definieren.
Erste Übereinstimmung mit Iterationszähler oder Anzeigendeskriptor
Wählen Sie diese Option zusammen mit allen anderen Einstellungen aus, um anzugeben, dass die Anzeigenkombination entweder nach einer festgelegten Anzahl von Anzeigen oder bei Erkennung der Endanzeige enden soll (je nachdem, welches Ereignis zuerst eintritt).

Anzahl der Iterationen

Wählen Sie dieses Feld aus, um anzugeben, wie häufig die auf der Registerkarte "Navigation" definierte Navigation ausgeführt werden soll. Wenn die Anzahl erreicht wurde, wird davon ausgegangen, dass die Endanzeige erreicht ist.

Zugeordnete Anzeigenerfassung

Klicken Sie auf den Knopf Ändern, um eine andere Anzeigenerfassung auszuwählen, die der Endanzeige der Anzeigenkombination zugeordnet werden soll.

Einstellungen für Anzeigendeskriptor

Für den Anzeigendeskriptor der Endanzeige können dieselben Einstellungen wie für die Kriterien zur Erkennung der Startanzeige festgelegt werden. Eine Erläuterung dieser Einstellungen können Sie unter Kriterien für die Anzeigenerkennung oder Startanzeige nachlesen.

Aktionen

Auf der Registerkarte Aktionen des Anzeigenereigniseditors werden die konfigurierten Aktionen für das Anzeigenereignis angezeigt.

Wenn Sie die Reihenfolge der Aktionen ändern wollen, wählen Sie eine Aktion aus, und klicken Sie auf Ab oder Auf, um die Aktion in der Liste nach unten bzw. nach oben zu verschieben.

In der Liste angezeigte Aktionen können Sie außerdem bearbeiten oder entfernen. Das Hinzufügen einer neuen Aktion ist ebenfalls möglich.

Die angegebenen Aktionen werden von der HATS-Laufzeit in der aufgelisteten Reihenfolge ausgeführt. Wenn beispielsweise beim Ausgeben der umgesetzten Hostanzeige für den Benutzer einige Felder bereits ausgefüllt angezeigt werden sollen, achten Sie darauf, die Hostanzeige (z. B. mit einer Aktion Daten einfügen) zu ändern, bevor die umgesetzte Hostanzeige (mit einer Aktion Umsetzung anwenden) angezeigt wird. Bei Verwendung einer Aktion Makro wiedergeben oder Taste senden in einem Anzeigenereignis muss diese Aktion der letzte Eintrag in der Liste sein.

Nachdem alle Aktionen im Anzeigenereignis ausgeführt wurden, sendet HATS möglicherweise einen Standardbefehl an den Umsetzungshost, um die Hostanwendung ausgehend von der gegenwärtig erkannten Anzeige zu steuern. Andernfalls könnte in den Aktionen des Anzeigenereignisses eine Endlosschleife auftreten. Mit der Option Hosttaste bei Abschluss der Aktionsliste senden, um Anzeigenänderung zu veranlassen können Sie festlegen, welche Taste nach dem Abschluss der Aktionsliste gesendet werden soll. Am Ende der Aktionsliste sendet die HATS-Laufzeit standardmäßig eine Eingabetaste an den Umsetzungshost. Eine AID-Taste wird in den folgenden Fällen gesendet:

Enthält die Aktionsliste eine Aktion "Umsetzung anwenden", und sendet der Benutzer als Reaktion auf die Umsetzung den Befehl für die Taste F2, wird daher anstelle eines Standardbefehls der Befehl [pf2] gesendet. Analog wird kein Standardbefehl gesendet, wenn das Anzeigenereignis mit einer Aktion Makro wiedergeben endet.

Die Aktionen auf dieser Registerkarte können Sie hinzufügen, bearbeiten oder entfernen. Mögliche Aktionen:

Alle Aktionstypen, die Sie für das Anzeigenereignis definiert haben, werden zusammen mit ihren Beschreibungen in der Tabelle auf der Registerkarte Aktionen angezeigt. Wenn Sie eine Zeile in der Tabelle hervorheben und auf Bearbeiten klicken, wird der Dialog Aktion bearbeiten aufgerufen.

Falls Sie auf Hinzufügen klicken, wird der Assistent "Aktion auswählen" geöffnet. Die erste Anzeige enthält eine Liste aller verfügbaren Aktionen. Sie können die gewünschte Aktion auswählen, indem Sie auf den Radioknopf für diese Aktion und anschließend auf Weiter klicken. Abhängig von der ausgewählten Aktion enthält der Rest der Anzeige Informationen, die Sie für diese Aktion angeben können.

Anmerkung:
Der Aktionstyp kann im Dialog Aktion bearbeiten nicht geändert werden. In diesem Dialog können Sie nur die Informationen ändern, die für die Aktion gelten.

Aktion "Umsetzung anwenden"

Wenn Sie beschließen, dass als Aktion in diesem Anzeigenereignis eine Umsetzung angewendet werden soll, können Sie bei HATS-Webprojekten die anzuwendende Umsetzung in der Dropdown-Liste der Umsetzungen auswählen, die im Projekt definiert sind.

Bei HATS-Rich-Client-Projekten können Sie durch Auswahl des Knopfes Durchsuchen eine Liste der Anzeigenumsetzungen im Klassenpfad des aktuellen Projekts anzeigen. Diese Liste enthält normalerweise nur Umsetzungen im aktuellen Projekt. Sie kann aber auch Umsetzungen aus anderen Plug-ins oder aus Dateien ".jar" enthalten, auf die durch das aktuelle Projekt verwiesen wird.

Weitere Informationen finden Sie in Mit Umsetzungen arbeiten.

Im Feld Schablone ist standardmäßig der Eintrag (Standardschablone) ausgewählt. Sofern Sie keine andere Schablone für die Anwendung auf diese spezielle Umsetzung auswählen, ist die Umsetzung in der grafischen Benutzerschnittstelle in die Schablone eingebettet, die Sie als Standardschablone für das Projekt angegeben haben. Die Dropdown-Liste enthält alle im Projekt definierten Schablonen.

Klicken Sie auf Direkte Hosttasten, wenn bestimmte vom Benutzer gedrückte Hosttasten sofort an den Host gesendet werden sollen, statt die Ausführung aller Aktionen abzuwarten. Wählen Sie die Markierungsfelder der Tasten aus, die sofort an den Host gesendet werden sollen. Falls eine Hosttaste sofort gesendet wird, finden keine anderen Aktionen statt. Das sofortige Senden dieser Tasten gilt nur für die aktuelle Umsetzung und nicht für alle Umsetzungen im Projekt.

Die Verarbeitung von globalen Regeln auf Projektebene und auf Anzeigenebene können Sie inaktivieren, indem Sie das Markierungsfeld Globale Regeln auf Projektebene und Anzeigenebene anwenden abwählen.

Aktion "Geschäftslogik ausführen"

Wenn als Aktion eines Anzeigenereignisses eine bestimmte Geschäftslogik ausgeführt werden soll, müssen Sie in den bereitgestellten Feldern den vollständig qualifizierten Namen der Java™-Klasse und die Java-Methode für die auszuführende Geschäftslogik angeben. Wenn Sie auf den Knopf Durchsuchen neben dem Feld Klassenname klicken, können Sie eine Klasse auswählen, in der die Methode für die Geschäftslogik definiert ist. Sie können jede beliebige Klasse auswählen, die im Ordner Quelle der Sicht HATS-Projekte von HATS Toolkit definiert ist. Falls Sie für diese Geschäftslogik keinen Java-Code erstellt haben, klicken Sie mit der rechten Maustaste auf eine Stelle in der Sicht HATS-Projekte, und klicken Sie auf die Optionen HATS - neu > Geschäftslogik, um den Assistenten "Geschäftslogik erstellen" aufzurufen.

Weitere Informationen zur Geschäftslogik enthält - je nach Anwendungsumgebung - das Handbuch HATS Web Application Programmer's Guide bzw. HATS Rich Client Platform Programmer's Guide.

Aktion "Globale Variable extrahieren"

Bei der Hostanzeige definieren Sie die Anfangs- und Endzeile bzw. die Anfangs- und Endspalte des Anzeigenbereichs, den Sie als globale Variable zuordnen wollen. Sie können Informationen aus der Anzeige extrahieren und als globale Variable definieren. Bei der Extraktion einer globalen Variablen können Sie einen Namen angeben oder den Namen einer vorhandenen globalen Variablen in der Dropdown-Liste für das Feld Name auswählen.

Um anzugeben, wie extrahierter Text aus mehreren Zeilen der Hostanzeige in einer globalen Variablen definiert werden soll, klicken Sie auf Erweitert. Durch Auswahl eines der Radioknöpfe müssen Sie angeben, ob die Extraktion als eine einzige Zeichenfolge oder aber als (indexierte) Liste von Zeichenfolgen behandelt werden soll. Falls Sie im Feld Name eine vorhandene globale Variable ausgewählt haben, bevor Sie auf den Knopf Erweitert geklickt haben, müssen Sie auf einen der folgenden Radioknöpfe klicken, um anzugeben, wie HATS die extrahierten Daten verarbeiten soll:

Bei den beiden Optionen, die einen angegebenen Index verwenden, müssen Sie die Indexnummer im Feld Index eingeben.

Das folgende Beispiel veranschaulicht, wie sich der Variablenwert je nach ausgewählter Option ändert. Das erste Beispiel verwendet eine vorhandene indexierte Variable namens "sample". Die Werte von „sample" sind „a b c d". Das Element „a" im Wert hat den Index 0, daher entspricht der Wert „sample[0]" dem Element „a". Das Element „b" im Wert hat den Index 1. Daher entspricht der Wert „sample[1]" dem Element „b" usw. Anschließend extrahieren Sie eine neue Gruppe mit den Werten „e f g".

Bei Auswahl des Markierungsfelds Gemeinsam kann die globale Variable gemeinsam genutzt werden.

Weitere Angaben über globale Variablen finden Sie in Mit globalen Variablen interagieren.

Aktion "Daten einfügen"

Mit der Maus oder den Einstellungen Anfangszeile und Anfangsspalte legen Sie den Bereich der Hostanzeige fest, in dem Daten eingefügt werden sollen. Sie können bestimmte Felder in der Hostanzeige hervorheben, indem Sie die verschiedenen Optionen neben Felder hervorheben auswählen. Wenn Sie sehen wollen, wo die Eingabefelder in der Anzeige definiert sind, wählen Sie das Markierungsfeld Eingabe aus. Geschützte Felder zeigen Sie an, indem Sie das Markierungsfeld Geschützt auswählen. Falls Sie alle verdeckten Felder hervorheben wollen, wählen Sie das Markierungsfeld Verdeckt aus. Wenn Sie die Farben der Hervorhebung für Eingabefelder, geschützte Felder oder verdeckte Felder ändern wollen, lesen Sie die Angaben unter HATS-Benutzervorgaben verwenden.

Klicken Sie auf Weiter, und wählen Sie anschließend durch den entsprechenden Radioknopf aus, ob es sich bei den Daten um eine Zeichenfolge oder um eine globale Variable handelt. Um eine Zeichenfolge einzufügen, geben Sie den Text im entsprechenden Eingabefeld ein. Um eine globale Variable einzufügen, wählen Sie den Namen einer vorhandenen globalen Variablen in der Dropdown-Liste aus, oder geben Sie den Namen der globalen Variablen ein. Falls Sie eine gemeinsame globale Variable aus einer anderen Anwendung verwenden wollen, müssen Sie im Feld den Namen eingeben.

Falls der Wert der globalen Variablen indexiert ist (also eine Liste von Zeichenfolgen enthält), klicken Sie auf Erweitert. Anschließend müssen Sie auf einen der Radioknöpfe klicken, um anzugeben, ob alle Zeichenfolgen nacheinander an der definierten Position eingefügt werden sollen oder ob die Zeichenfolgen in einem rechteckigen Bereich der Anzeige als separate Zeilen einzufügen sind.

Bei Auswahl des Markierungsfelds Gemeinsam kann die globale Variable gemeinsam genutzt werden.

Weitere Angaben über globale Variablen finden Sie in Mit globalen Variablen interagieren.

Anmerkung:
Das Einfügen von Informationen in eine Hostanzeige muss erfolgen, bevor eine Umsetzung für die globale Variable stattfindet, die in der grafischen Benutzerschnittstelle angezeigt werden soll. Unter Aktionen können Sie nachlesen, wie Sie die Reihenfolge der Aktionen ändern.

Aktion "Globale Variable definieren"

Sie können globale Variablen definieren, die in Ihrem Projekt, aber auch in anderen Projekten der EAR-Datei verwendet werden können. Bei der Definition einer globalen Variablen können Sie einen Namen angeben oder den Namen einer vorhandenen globalen Variablen in der Dropdown-Liste für das Feld Name auswählen. Falls Sie eine vorhandene indexierte globale Variable auswählen, klicken Sie auf Erweitert, um anzugeben, wie der Wert festgelegt werden soll. Die folgenden Optionen stehen zur Auswahl:

Bei den beiden Optionen, die einen angegebenen Index verwenden, müssen Sie die Indexnummer im Feld Index eingeben.

Ein Beispiel, dass die Festlegung einer Variablen je nach ausgewählter Option veranschaulicht, finden Sie unter Aktion "Globale Variable extrahieren".

Wenn Sie die globale Variable auf einen festen Wert setzen wollen, geben Sie den Wert im Eingabefeld ein.

Wollen Sie die globale Variable auf einen errechneten Wert setzen, geben Sie die zu verwendenden Operanden und die Operation für die Berechnung an. Als Operanden können Sie entweder feste Werte im Feld eingeben oder die Werte von vorhandenen globalen Variablen für die Berechnung verwenden. Wenn Sie einen vorhandenen indexierten globalen Wert verwenden und angeben wollen, dass ein Index der Variablen als Operand verwendet werden soll, klicken Sie auf Erweitert. Geben Sie die Indexnummer im Feld Index ein.

Bei Auswahl des Markierungsfelds Gemeinsam kann die globale Variable gemeinsam genutzt werden.

Weitere Angaben über globale Variablen finden Sie in Mit globalen Variablen interagieren.

Aktion "Globale Variable entfernen"

Mit dieser Aktion können Sie eine oder mehrere globale Variablen entfernen. Sie können eine lokale oder eine gemeinsame globale Variable, alle lokalen globalen Variablen, alle gemeinsamen globalen Variablen oder alle lokalen und gemeinsamen globalen Variablen entfernen. Bei der Option Eine lokale oder Eine gemeinsam genutzte geben Sie den Namen der globalen Variablen, die Sie entfernen wollen, ein, oder wählen Sie den Namen in der entsprechenden Dropdown-Liste aus.

Anmerkung:
Namen von gemeinsamen globalen Variablen, die in einer anderen, in derselben EAR-Datei ausgeführten HATS-Webanwendung oder einer anderen, in derselben Rich-Client-Umgebung ausgeführten HATS-Rich-Client-Anwendung erstellt wurden, werden in der Dropdown-Liste der gemeinsamen globalen Variablen möglicherweise nicht angezeigt. Um eine dieser gemeinsamen globalen Variablen zu entfernen, geben Sie den Namen im Eingabefeld für die Option Eine gemeinsam genutzte ein.

Weitere Angaben über globale Variablen finden Sie in Mit globalen Variablen interagieren.

Aktion "Globale Variable senden"

Diese Aktion kann nur bei HATS-Projekten für HATS-Standardportlets (JSR-168-Portlets) verwendet werden. Sie kann bei der Entwicklung einer Lösung mit Portletkommunikation hilfreich sein. Weitere Informationen finden Sie unter Portletkommunikation.

Mit dieser Aktion können Sie den Wert einer globalen Variablen als Wert des Typs "java.lang.String" in einer Eigenschaft von einem HATS-JSR-168-Portlet an ein anderes JSR-168-Portlet (HATS- oder sonstiges Portlet) auf dem Portalserver senden. Geben Sie im Feld "Eigenschaft" den Namen der gesendeten Eigenschaft ein. Der Name muss mit dem vom empfangenden Portlet verwendeten Eigenschaftsnamen übereinstimmen, beispielsweise mit dem Eigenschaftsnamen, der in einem empfangenden HATS-JSR 168-Portlet auf der Registerkarte Andere in den Einstellungen Portlet definiert ist. Geben Sie im Feld "Globale Variable" den Namen der globalen Variablen ein. Falls der Wert der globalen Variablen indexiert ist, klicken Sie auf Erweitert. Geben Sie anschließend an, ob alle Indizes der Variablen (Alle Indizes senden) gesendet werden sollen (optional durch einen Zeichenfolgebegrenzer getrennt) oder ob nur ein einziger Index (Einzelnen Index senden) gesendet werden soll, wobei auch der zu sendende Index anzugeben ist. Wählen Sie das Markierungsfeld Gemeinsam aus, wenn es sich um eine gemeinsame globale Variable handelt.

Sobald Sie auf Fertig stellen klicken, wird die Aktion zur Ereignisdatei (.evnt) der Anzeige hinzugefügt. Außerdem wird eine WSDL-Datei (Web Services Description Language) erstellt, wenn noch keine solche Datei vorhanden ist, und in der WSDL-Datei wird eine Eigenschaft "send" definiert. Der Name der WSDL-Datei lautet "<projektname>.wsdl". Die WSDL-Datei wird benötigt, um die Portlets mit dem Verbindungstool von WebSphere Portal zu verbinden. Die Datei "portlet.xml" wird so aktualisiert, dass sie auf die Position der WSDL-Datei verweist.

Wenn Sie auf Entfernen klicken, wird die Aktion aus der Ereignisdatei der Anzeige entfernt, aber die Eigenschaft wird nicht aus der WSDL-Datei entfernt. Sie können die WSDL-Datei bearbeiten und die Eigenschaft im WSDL-Editor entfernen.

Anmerkung:
Für den Fall, dass Sie die Eigenschaft nicht aus der WSDL-Datei entfernen, wird das HATS-Portlet dennoch ordnungsgemäß ausgeführt.
Anmerkungen:
  1. Diese Aktion muss nach der Aktion "Umsetzung anwenden" für das Ereignis angegeben werden.
  2. Zwischen der Aktion "Umsetzung anwenden" und der Aktion "Globale Variable senden" werden ausschließlich die folgenden Aktionen unterstützt:
  3. Die oben genannten Aktionen sind nützlich, wenn Sie die globale Variable verarbeiten wollen, bevor Sie sie an andere Portlets senden. Beispiel: Sie wollen die Benutzer-ID, die in der Anmeldeanzeige eingegeben wurde, an andere Portlets senden. Sie fügen zu diesem Zweck eine Aktion "Umsetzung anwenden" hinzu, um die Anmeldeanzeige umzusetzen, sowie eine Aktion "Globale Variable extrahieren", um den Bereich mit dem Eingabefeld für die Benutzer-ID zu extrahieren und in einer globalen Variablen zu speichern. Anschließend fügen Sie eine Aktion "Globale Variable senden" hinzu, um die in der globalen Variablen gespeicherte Benutzer-ID an andere Portlets zu senden.
  4. Die folgenden Aktionen werden zwischen der Aktion "Umsetzung anwenden" und der Aktion "Globale Variable senden" nicht unterstützt. Falls eine dieser Aktionen zwischen den Aktionen "Umsetzung anwenden" und "Globale Variable senden" angegeben wird, werden die Aktionen ganz normal ausgeführt, aber die globale Variable wird nicht gesendet.

Aktion "URL-Adresse oder SWT-Kombination anzeigen"  Nur RCP 

Mit dieser Aktion können Sie eine Webseite oder eine SWT-Kombination im Umsetzungsbereich der Umsetzungssicht anzeigen. Zum Anzeigen einer Webseite geben Sie die URL-Adresse der Webseite im Feld URL ein. Zum Anzeigen einer SWT-Kombination geben Sie deren Klassennamen im Feld Kombinationsklasse ein, oder wählen Sie nach Auswahl des Knopfes Durchsuchen eine SWT-Kombination im Rich-Client-Projekt aus. Die Webseite bzw. SWT-Kombination wird in die Schablone eingebettet, die Sie in der Liste der Schablonen ausgewählt haben. Nachdem die Webseite oder die SWT-Kombination geladen wurde, muss der Benutzer auf einen Knopf Weiter klicken, um zur HATS-Anwendung zurückzukehren.

Anmerkung:
Informationen zur Implementierung der SWT-Kombination mit einem Knopf Weiter enthält das Handbuch HATS Rich Client Platform Programmer's Guide.

Aktion "URL-Adresse anzeigen"  Nur Web 

Wenn als Aktion eines Anzeigenereignisses eine Webseite angezeigt werden soll, müssen Sie die URL-Adresse der Webseite im Feld URL angeben. Die Webseite wird - ähnlich wie beim Anzeigen einer Umsetzung - in die Standardschablone eingebettet. Nachdem die Webseite geladen wurde, kehrt der Benutzer zur HATS-Anwendung zurück, indem er unten in der Webseite auf den Knopf Weiter klickt.

Falls eingebettete Objekte im Browser nicht unterstützt werden oder nicht zulässig sind (z. B. Objekte mit HTML-Datentyp), zeigt diese Aktion anstelle des Inhalts einer Webseite einen Link zur entsprechenden Webseite an. Eine Liste der unterstützten Web-Browser sowie Informationen zu Einschränkungen finden Sie im HATS Information Center unter http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp im Abschnitt "HATS prerequisites" .

Wenn Sie das Ziel der Aktion "URL-Adresse anzeigen" angeben, muss die Workstation des Clients auf die Zielseite zugreifen können. Daher können Sie möglicherweise eine Zielwebseite, die beispielsweise durch die Firewall Ihres Unternehmens geschützt ist, nur dann angeben, wenn die Workstation des Clients direkt auf die Zielseite zugreifen kann. Achten Sie darauf, die vollständige URL-Adresse für das Ziel anzugeben, da der Client andernfalls möglicherweise nicht in der Lage ist, den Hostnamen der Zielseite aufzulösen. Falls sich die Zielseite nicht auf dem Anwendungsserver befindet, der als Host für die HATS-Anwendung dient, also ein domänenübergreifender Zugriff stattfindet, müssen Sie unter Umständen die Browsereinstellungen anpassen, damit die nicht auf dem Server befindliche Zielseite geladen werden kann.

Beispiel: Wählen Sie im Internet Explorer V6.0 oder höher das Menü Extras, die Option Internetoptionen und dann die Registerkarte Sicherheit aus. In der rechten unteren Ecke des Browserfensters wird die Zone für den Webinhalt angezeigt. Stammt die Seite beispielsweise aus der Zone "Internet", müssen Sie die Einstellungen für die Zone "Internet" anpassen, damit das Laden der Zielseite zulässig ist. Wählen Sie die entsprechende Zone und dann den Knopf Stufe anpassen aus. Blättern Sie in den Einstellungen bis zum Abschnitt Verschiedenes vor, und wählen Sie eine Einstellung für Auf Datenquellen über Domänengrenzen hinweg zugreifen aus. Wählen Sie Aktivieren aus, um das Laden der Zielseite zuzulassen. Wählen Sie Bestätigen aus, wenn vor dem Laden der Zielseite eine Bestätigung angefordert werden soll. Bei Auswahl von Inaktivieren kann die Zielwebseite möglicherweise nicht geladen werden.

Aktion "An URL-Adresse weiterleiten"  Nur Web 

Mit der Aktion "An URL-Adresse weiterleiten" können Sie die Steuerung von einer umsetzungsorientierten HATS-Webanwendung an eine JSP übergeben, die eines oder mehrere verkettete Integrationsobjekte aufruft. Auf diese Weise können Sie bereits erstellte Integrationsobjekte einsetzen. Die Integrationsobjekte können die vorhandene Standardverbindung oder eine Hintergrundverbindung verwenden.

Diese Aktion wird in HATS-Webprojekten und HATS-Projekten für Standardportlets, nicht jedoch in HATS-Projekten für IBM® Portlets unterstützt.

Um eine Weiterleitungsaktion zu einem Ereignis hinzuzufügen, müssen Sie die folgenden Parameter angeben:

Anmerkung:
Falls Sie die Ausführung einer umfangreichen JSP planen, setzen Sie die JVM-Systemeigenschaft auf com.sun.tools.javac.main.largebranch=true, und starten Sie dann den Server erneut. Zum Festlegen von JVM-Eigenschaften können Sie die Administrationskonsole verwenden, Argumente für die JVM konfigurieren oder eine angepasste Eigenschaft erstellen.

Die Aktion "An URL-Adresse weiterleiten" bietet mehrere Möglichkeiten für die Verwaltung der Verbindung, die von der JSP-/Integrationsobjektlogik verwendet wird. Beispiel:

Bei Verwendung der Weiterleitungsaktion wird die Steuerung nicht automatisch an die HATS-Anwendung zurückgegeben werden, nachdem die Integrationsobjekte ausgeführt wurden. Die JSP muss die Steuerung explizit an die HATS-Anwendung zurückgeben. Falls die Standardverbindung vor der Weiterleitungsaktion nicht aufgebaut wurde und die Integrationsobjekte die Standardverbindung verwendet haben, müssen Sie die Verbindung zurück an die HATS-Anwendung übergeben, die als Standardverbindung verwendet werden soll. In diesem Fall müssen Sie einen Anforderungsparameter für "HttpServletRequest" festlegen, bevor Sie die Anforderung an die HATS-Anwendung weiterleiten. Der Parameter lautet "CommonConstants.HATS_EXISTING_CONN". Den für diesen Parameter benötigten Wert können Sie durch einen Aufruf der Methode "getHPubEndChainName" für das letzte Integrationsobjekt in der Kette ermitteln.

Die Angabe für FORM könnte bei einem Webprojekt beispielsweise folgendermaßen lauten:

<FORM NAME="exampleLink" METHOD="GET" 
ACTION='<%= response.encodeURL(request.getContextPath()+"/entry")%>'>
<INPUT TYPE="HIDDEN" NAME="<%= CommonConstants.HATS_EXISTING_CONN %>" 
VALUE="<%= ExampleIO.getHPubEndChainName()%>" />
<INPUT TYPE="submit" VALUE="Return to HATS application" />
</FORM>

Sie können auch das Menü HATS-Tools verwenden, um eine Weiterleitung an die HATS-Anwendung einzufügen. Mit der entsprechenden Option wird - abgesehen von einer Ausnahme - der Code automatisch eingefügt. Die folgende Zeile ist nicht enthalten:

<INPUT TYPE="HIDDEN" NAME="<%= CommonConstants.HATS_EXISTING_CONN %>"
       VALUE="<%= IntegrationObjectName.getHPubEndChainName() %>" />

Falls Sie die Verbindung an die HATS-Anwendung übergeben wollen, müssen Sie anschließend die JSP bearbeiten und die Codezeile unmittelbar nach der Codezeile "FORM NAME=" hinzufügen.

In allen anderen Fällen (wenn die Standardverbindung vor dem Aufruf der Weiterleitungsaktion geöffnet wurde oder die Integrationsobjekte die Standardverbindung nicht verwenden) müssen Sie die Verbindung nicht zurückgeben. In diesen Fällen können Sie die erste Anweisung INPUT aus dem Beispiel übergehen.

Anmerkung:
Die JSP-/Integrationsobjektlogik kann der erste Eintrag in der HATS-Anwendung sein. In diesem Fall verwenden Sie den Code, der für die Steuerung der HATS-Anwendung angegeben ist, und übergeben die von der JSP-/Integrationsobjektlogik aufgebaute Verbindung an die HATS-Anwendung, die als Standardverbindung verwendet werden soll (sofern die Verbindung mit der Definition der Standardverbindung erstellt wurde).

Makro wiedergeben

Wenn Sie ein Makro aufgezeichnet haben, können Sie es im Dropdown-Feld auswählen, um es wiederzugeben. Die Wiedergabe des Makros beginnt, wenn dieses Ereignis ausgewählt wird. Bitte beachten Sie, dass die Aktion Makro wiedergeben ein Makro für die aktuelle Verbindung ausführt. Die Aktion Makrotransaktion ausführen erstellt jedoch eine neue Verbindung für die Ausführung des Makros.

Zur Wiedergabe eines Makros wählen Sie den Eintrag Makro wiedergeben in der Liste Aktion hinzufügen und anschließend den Namen des wiederzugebenden Makros in der Dropdown-Liste aus. Falls Sie die Wiedergabe eines Makros als Aktion dieses Anzeigenereignisses definieren, ist dies die letzte angewendete Aktion. Achten Sie darauf, sehr spezielle Kriterien für die Erkennung dieser Anzeige zu verwenden, damit das Makro nicht bei anderen Anzeigen wiedergeben wird. Wenn Sie beispielsweise ein Zeichenfolgekriterium verwenden, geben Sie an, dass es sich in einer genauen Position und nicht an einer beliebigen Stelle der Anzeige befinden muss. Achten Sie darauf, dass die Anzeige, in der das Makro endet, die Kriterien für den Start des Makros nicht erfüllt. Stellen Sie bei der Aufzeichnung eines Makros sicher, dass die letzte Anzeige nicht der Anzeige entspricht, die durch das Anzeigenereignis erkannt wird. Wenn die erkannte Anzeige mit der letzten Anzeige des Makros identisch ist, wird eine Schleife erstellt, und die Option zum Senden einer Taste, mit der eine Änderung der Anzeige erzwungen wird, wird bei der Wiedergabe des Makros nicht ausgeführt.

Für gewöhnlich wird für eine Anzeige nicht gleichzeitig eine Umsetzung und eine Makrowiedergabe ausgeführt. Falls beide Aktionen angegeben sind, wird die Umsetzung angewendet und das Makro erst dann ausgeführt, nachdem eine Benutzerinteraktion mit der umgesetzten Anzeige stattgefunden hat. Die Wiedergabe eines Makros ist immer die letzte auszuführende Aktion. Falls ein Makro bei der Erkennung einer Anzeige automatisch wiedergegeben werden soll, wenden Sie auf diese Anzeige keine Umsetzung an. Bei der Erstellung des Anzeigenereignisses für diese Anzeige sollten Sie das Markierungsfeld Umsetzung anwenden auf der Seite "Aktionen" des Assistenten abwählen. Sie können ein weiteres Anzeigenereignis für die letzte Hostanzeige, zu der das Makro navigiert, erstellen, und eine Umsetzung anwenden, um die Darstellung der Webseite zu steuern, die aus dieser letzten Anzeige abgeleitet wird.

Durch das Einfügen eines Makroknopfes in eine Umsetzung können Sie dem Benutzer die Ausführung eines Makros aus der umgesetzten Anzeige heraus ermöglichen. In diesem Fall kann der Benutzer entweder mit der umgesetzten Anzeige interagieren oder auf den Makroknopf klicken, um die Ausführung eines Makros in der aktuellen Hostanzeige zu starten.

Zur Aufzeichnung von Makros verwenden Sie das Host-Terminal in HATS Toolkit. Weitere Informationen zum Importieren von Makros finden Sie in Makros und Host-Terminal.

Makrotransaktion ausführen

Bei Auswahl dieser Aktion können Sie ein aufgezeichnetes Makro für eine neue Instanz einer angegebenen Verbindung wiedergeben. Dies gilt selbst dann, wenn es sich um eine Verbindung zu einem anderen Host handelt. Klicken Sie auf den Knopf Makrotransaktion ausführen, und wählen Sie dann in der Dropdown-Liste Makro wiedergeben das wiederzugebende Makro sowie in der Dropdown-Liste An Verbindung ausführen die zu verwendende Verbindung aus.

Anmerkung:
Falls für die designierte Verbindung ein Verbindungsmakro definiert ist, wird dieses Makro vor dem ausgewählten Makro ausgeführt.

Taste senden

Diese Aktion sendet eine angegebene Taste an die Hostanzeige. Nachdem Sie die Position in der Anzeige ausgewählt haben, auf die die Aktion angewendet werden soll, wählen Sie die Taste aus, die an die Hostanzeige zu senden ist.

Wählen Sie in der Liste entweder den Punkt PF- und PA-Tasten oder Andere Hosttasten aus. Klicken Sie dann auf das Dropdown-Menü des ausgewählten Listenpunkts, und wählen Sie die Taste aus.

Denken Sie daran, dass die ausgewählte Taste eine Änderung der Hostanzeige bewirken muss, da ansonsten eine Endlosschleife der Aktion entsteht.

Die Aktion Taste senden muss in der Reihenfolge der Aktionsliste immer an letzter Stelle ausgeführt werden.

Trennen

Die Aktion Trennen wird unmittelbar vor dem Ereignis "Trennen" ausgeführt. Das Ereignis "Trennen" trennt standardmäßig die Standardverbindung und gibt sie frei.

Anhalten

Bei der Aktion Anhalten können Sie in Millisekunden einen Zeitraum angeben, nach dessen Ablauf die normale Verarbeitung fortgesetzt wird.

Vorabdarstellung für Portlets

Bei Verwendung der Vorabdarstellung für Portlets können Sie die Begrenzer Vorabdarstellung - Anfang und Vorabdarstellung - Ende hinzufügen. Hierzu verwenden Sie den Knopf Blockbegrenzer hinzufügen auf der Registerkarte Aktionen.

Diese Aktion wird bei HATS-Standardportlets nicht untersützt.

Mit den Begrenzern Vorabdarstellung - Anfang und Vorabdarstellung - Ende können Sie Aktionen einschließen, die bei der Portletverarbeitung in der Phase der Vorabdarstellung ausgeführt werden müssen. Verwenden Sie den Knopf Blockbegrenzer hinzufügen, wenn Sie die Nachrichtenübertragung für Portlets oder kooperative Portlets implementieren. Klicken Sie ein Mal auf den Knopf Blockbegrenzer hinzufügen, um den Begrenzer "Vorabdarstellung - Anfang" einzufügen. Klicken Sie erneut auf den Knopf Blockbegrenzer hinzufügen, um den Begrenzer "Vorabdarstellung - Ende" hinzuzufügen. Mit den Knöpfen Auf und Ab können Sie die Aktion, die im Blockbegrenzer ausgeführt werden muss, in der Liste nach oben oder nach unten verschieben. Der Zeitpunkt, an dem die Aktion aufgerufen werden muss, bestimmt die Position des Vorabdarstellungsblocks. Bei der Ausführung eines Anzeigenereignisses können Sie die Aktion für die Vorabdarstellung zuerst oder am Beginn der Liste Aktionen auslösen. Soll die Aktion für die Vorabdarstellung nach der Benutzerinteraktion mit der Anzeige ausgeführt werden, müssen Sie das Ereignis am Ende der Liste Aktionen auslösen. Weitere Informationen zur Verwendung des Blockbegrenzers bei Portlets enthält das Handbuch HATS Web Application Programmer's Guide.

Globale Regeln

Globale Regeln ermöglichen die Mustererkennung und Umsetzung von Hosteingabefeldern. Sie können bei angepassten und nicht angepassten Anzeigen (also Anzeigen mit Standardwiedergabe) verwendet werden. Globale Regeln können sowohl auf Projektebene als auch auf Anzeigenebene definiert werden. Auf dieser Registerkarte geben Sie globale Regeln auf Anzeigenebene an. Details zur Definition einer globalen Regel können Sie unter Globale Regeln nachlesen.

Mit globalen Regeln auf Anzeigenebene können Sie die Standardwiedergabe für eine Anzeige verwenden und zusätzlich die Eingabefelder in der Anzeige anpassen. Wenn Sie beispielsweise den Mustertyp Eingabefelder innerhalb einer angegebenen Region suchen in einer globalen Regel auf Anzeigenebene verwenden, können Sie ein Eingabefeld, das angepasst werden soll, in einer Anzeige genau lokalisieren (z. B. Daten in einer Tabelle), während gleichzeitig die Standardwiedergabe für die Anzeige verwendet wird.

Wenn für ein Eingabefeld sowohl auf Projektebene als auch auf Anzeigenebene eine globale Regel definiert ist, hat die Regel auf Anzeigenebene Priorität.

Ersetzen von Text

Auf der Registerkarte Ersetzen von Text wird eine Tabelle angezeigt, in der Sie den geschützten Originaltext der Hostanzeige, den Sie ersetzen wollen, sowie den Text, den HTML-Inhalt  Nur Web  oder das Bild angeben können, der/das als Ersetzung verwendet werden soll. Außerdem ist angegeben, ob bei der Textsuche die Groß-/Kleinschreibung beachtet werden muss und ob die Unterstützung für reguläre Ausdrücke verwendet wird. Klicken Sie auf den Knopf Hinzufügen, um die Parameter für die neue Textersetzung zu erstellen.

Sie können entweder den Text, den Sie ersetzen wollen, im Auswahlfenster auswählen oder den Text im Textfeld Ersetzen eingeben.

Bei Auswahl des Markierungsfelds Groß-/Kleinschreibung beachten wird ausschließlich nach exakt dem Text gesucht, den Sie im Textfeld Ersetzen eingegeben haben.

Um eine Ersetzung durch Text anzugeben, geben Sie den Text für die Ersetzung im Fenster unten ein.

Bei Eingabe von HTML-Code  Nur Web  hebt HATS den Code rot hervor, damit Sie erkennen können, ob der Code gültig ist.

Durch Klicken auf das Symbol Einfügen können Sie einen Knopf oder einen Link hinzufügen. Für die Optionen Knopf einfügen und Link einfügen gibt es die folgenden Einstellungen:

Beschriftung
Text, der auf den wiedergegebenen Knöpfen oder Links angezeigt werden soll
Aktionstaste
Host-AID-Taste, die beim Klicken auf den Knopf bzw. Link gesendet werden soll
Darstellungsklasse  Nur Web 
CSS-Klassenname (Cascading Style Sheet) für die Klasse, die die Darstellung des Knopfes oder Links steuert. Der Standardwert für Knöpfe ist 'HATSBUTTON'. Der Standardwert für Links lautet 'HATSLINK'.

Sie können Text auch durch Bilder ersetzen. Hierzu klicken Sie auf den Radioknopf Bild, und wählen Sie ein Bild in der Dropdown-Liste aus, oder klicken Sie auf den Knopf Importieren.

Bei Auswahl des Markierungsfelds Regulärer Ausdruck können Sie die Unterstützung für reguläre Java-Ausdrücke im Algorithmus für das Ersetzen von Text verwenden. Reguläre Ausdrücke sind Muster von Zeichen, die eine Gruppe von Zeichenfolgen beschreiben. Sie können reguläre Ausdrücke zur Ermittlung und Änderung von Vorkommen eines Musters verwenden. Geben Sie beispielsweise Folgendes an:

Replace: ([\.\-|_\w]+)@([\-\_\.\w]+)
With: <a href="mailto:$1@$2" class="HATSLINK">$1@$2</a>

In diesem Fall findet die folgende Ersetzung statt, die eine E-Mail-Adresse in einer Hostanzeige in einen Link konvertiert:

Ursprünglicher Text der Hostanzeige: user@company.com
Ersetzungstext: 
<a href="mailto:user@company.com" class="HATSLINK">user@company.com</a>

Alle Angaben für das Ersetzen von Text können Sie mit den Knöpfen rechts neben der Wertetabelle ändern. Der Text kann auf der Projektebene, auf der Wiedergabeelementebene, auf der Umsetzungsebene sowie auf der Komponentenebene ersetzt werden.

Falls eine Liste mit Textersetzungen vorhanden ist, kann ein Text oder eine HTML-Angabe, der/die durch eine Textersetzung erstellt wurde, durch eine nachfolgende Textersetzung ersetzt werden. Beispiel: Falls Sie eine Zeichenfolge in der Hostanzeige durch <img src="yourImage.jpg"> ersetzen und eine nachfolgende Textersetzung die Angabe sr durch eine andere Zeichenfolge ersetzt, funktioniert der Tag <img> nicht mehr einwandfrei, weil der Parameter src geändert wurde. Diese Situation können Sie vermeiden, indem Sie die Einträge für die Textersetzung anders anordnen oder spezifischer definieren. Auf diese Weise stellen Sie sicher, dass vorherige Zeichenfolgen nicht unbeabsichtigt ersetzt werden.

Anmerkungen:
  1. Bei der Verwendung der Textersetzung sollten Sie sorgfältig vorgehen. Die Textersetzung mit einer unterschiedlichen Anzahl von Zeichen in der Zeichenfolge kann dazu führen, dass die Darstellung der Anzeige in der grafischen Benutzerschnittstelle geändert wird. Abhängig von dem Fensterobjekt, das für die Darstellung eines Anzeigenbereichs verwendet wird, kann es sein, dass Text in einer Zeile der Anzeige komprimiert, erweitert oder in eine neue Zeile umgebrochen wird. Außerdem ist es generell nicht effizient, Zeichenfolgen, die aus einem einzelnen Zeichen bestehen, oder Text zu ersetzen, in den geschützte Felder eingefügt sind.
  2. Standardmäßig werden beim Ersetzen von Text Zeichenfolgen abgeschnitten, die länger als der Ersetzungstext sind. Manchmal wird der Text abgeschnitten, um das Layout der ursprünglichen Hostanzeige in der Umsetzung beizubehalten. Das Abschneiden findet nur bei Text statt, der mit dem Fensterobjekt "Feld" (bzw. in manchen Fällen mit dem Fensterobjekt "Tabelle") wiedergegeben wird.

    Um bei Text das Ersetzen von kürzeren Zeichenfolgen durch längere Zeichenfolgen zu aktivieren, können Sie die Quelleneinstellung truncateToPreserveLength hinzufügen. Die Werte für diese Einstellung sind true und false. Der Standardwert, auch wenn diese Einstellung nicht angegeben ist, lautet true und hat keinen Einfluss auf Ihr Projekt. Durch Angabe von false wird das Ersetzen von längerem Text aktiviert. Damit diese Einstellung verwendet werden kann, darf die Standardwiedergabe nicht verwendet werden. Bei Verwendung der Standardwiedergabe wird die Einstellung ignoriert.

    Bei truncateToPreserveLength handelt es sich um eine Einstellung auf Projektebene. Sie betrifft sämtliche Textersetzungen in dem Projekt. Wenn Sie diese Einstellung verwenden, überprüfen Sie, ob alle Wiedergaben in der gewünschten Form erfolgen und stellen Sie sicher, dass eventuell auftretende Verschiebungen bei der Ausrichtung keine Probleme darstellen.

    Um die Einstellung für das gesamte Projekt zu aktivieren, öffnen Sie die Quellensicht der Datei "application.hap". Suchen Sie die Klasse für die Umsetzung und fügen Sie die hervorgehobene Einstellung wie im folgenden Beispiel dargestellt hinzu:

    <class name="com.ibm.hats.transform">
       <setting name="truncateToPreserveLength" value="false" />
    </class>
  3. Die Verwendung des Auswahltextfensters kann sehr hilfreich sein. Ersetzt wird jedoch tatsächlich der Text, der im Feld Ersetzen angegeben ist. Das Ersetzen von Text kann nicht zeilenübergreifend oder bei nicht geschützten Felder angewendet werden. Unter Verwendung des Feldes "Voranzeige" können Sie nicht mehrere Textzeilen auswählen und ersetzen.
  4. Das Ersetzen von Text durch Bilder in Kombination mit bestimmten SWT-Fensterobjekten ist in Rich-Client-Anwendungen nur eingeschränkt möglich. Weitere Informationen finden Sie in Spezielle Hinweise und Einschränkungen für HATS-Rich-Client-Anwendungen.

Nächste Anzeige

Auf der Registerkarte Nächste Anzeige können Sie angeben, welche Anzeigen wahrscheinlich nach der aktuellen Anzeige ausgegeben werden.

Klicken Sie auf den Knopf Hinzufügen, um Anzeigen in die Liste aufzunehmen. Mit dem Knopf Auf oder Ab können Sie die Reihenfolge ändern, in der die Anzeigen verglichen werden. Mit dem Knopf Entfernen können Sie eine Anzeige entfernen.

Falls eine der nächsten wahrscheinlichen Anzeigen in der Liste übereinstimmt, kann die Anwendung entweder die Prioritätenliste für Anwendungsereignisse durchsuchen oder das Anwendungsereignis ausführen.

Die Option Prioritätenliste für Anwendungsereignisse durchsuchen sucht in der Ereignisprioritätenliste der Projekteinstellungen nach der nächsten Anzeige. Dies ist die Standardeinstellung. In der Dropdown-Liste Anwendungsereignis ausführen können Sie ein Ereignis "Fehler" (oder ein anderes Ereignis) auswählen, falls keine der nächsten wahrscheinlichen Anzeigen in der Liste übereinstimmt. Die folgenden Ereignisse sind aufgelistet:

Weitere Informationen finden Sie unter Anwendungsereignisse.

Mit Hilfe der Registerkarte Nächste Anzeige können Sie die Leistung verbessern, falls Sie vorhersehen können, welche Anzeige wahrscheinlich als Nächste ausgegeben wird.

Quelle

Auf der Registerkarte Quelle werden die Tags und Werte in der Datei "anzeigenereignisname.evnt" für alle Informationen angezeigt, die für das Anzeigenereignis bereitgestellt wurden. Hierbei steht anzeigenereignisname für den Namen, den Sie für das Anzeigenereignis bei seiner Erstellung vergeben haben. Wenn Sie auf den anderen Registerkarten im Anzeigenereigniseditor Änderungen vornehmen, ändern sich die auf der Registerkarte Quelle angezeigten Tags und Werte entsprechend.

Sie können die Tags und Werte auch in der Quellendatei ändern. Dann werden die Änderungen auf den entsprechenden Registerkarten des Anzeigenereigniseditors wiedergegeben.

Unterdrückte Anzeigen

Der Status im Operatorinformationsbereich (OIA) für eine HATS-Verbindung ist eines der Übereinstimmungskriterien für Anzeigen, mit denen HATS ermittelt, ob eine Anzeige mit einem der konfigurierten Anzeigenereignisse übereinstimmt. Falls der OIA-Status abweicht, stellt HATS keine Übereinstimmung mit dem entsprechenden Anzeigenereignis fest, und anstelle der angepassten Umsetzung oder Aktion wird die Standardumsetzung angezeigt. Der vorliegende Abschnitt erläutert Methoden zur Verarbeitung von Anzeigen mit unterdrückter Eingabe (gesperrter Tastatur) oder mit einem abweichenden OIA-Status.

Erkennungskriterien

HATS fügt standardmäßig zu allen Anzeigenereignissen die folgenden Erkennungskriterien für den OIA-Status hinzu:

<oia invertmatch="false" optional="false" status="NOTINHIBITED"/>

Dies bedeutet, dass neben den anderen Übereinstimmungskriterien der OIA-Status NOTINHIBITED lauten muss, damit HATS die Anzeige als Übereinstimmung bewertet. Bei einem anderen OIA-Status wird die Anzeige selbst dann nicht als übereinstimmend betrachtet, wenn die anderen Kriterien erfüllt werden. Infolgedessen wird im Browser die Standardumsetzung angezeigt.

Damit HATS den OIA-Status bei einem bestimmten Anzeigenereignis ignoriert, ändern Sie einfach die Erkennungskriterien von NOTINHIBITED in DONTCARE. Dazu gehen Sie wie folgt vor:

  1. Erweitern Sie in der Sicht "HATS-Projekte" das Projekt und die Liste der Anzeigenereignisse (Anzeigenanpassungen oder Anzeigenkombinationen).
  2. Doppelklicken Sie auf das Anzeigenereignis, um den Anzeigenereigniseditor zu starten.
  3. Klicken Sie unten im Editor auf die Registerkarte Quelle.
  4. Suchen Sie nach der Zeile, die die Zeichenfolge status="NOTINHIBITED" enthält. Ändern Sie die Angabe NOTINHIBITED in DONTCARE.
  5. Speichern Sie die Änderung, indem Sie auf die Optionen Datei > Speichern klicken oder die Tastenkombination Strg+S drücken.

Falls die Hostanzeige tatsächlich unterdrückt (also gesperrt) ist, müssen Sie eine bestimmte Taste oder Tastenkombination wie beispielsweise Strg+R (Host zurücksetzen) oder Esc (Host löschen) drücken, um die Anzeige zu entsperren oder zur nächsten Anzeige zu wechseln.

Unterdrückte Anzeigen automatisch verarbeiten

Sie können HATS in die Lage versetzen, eine unterdrückte (gesperrte) Anzeige automatisch zu erkennen und zu verarbeiten. Hierzu erstellen Sie eine spezielle Anzeigenanpassung für diesen Zweck. So gehen Sie hierbei vor:

  1. Entfernen Sie auf der Registerkarte "Kriterien für die Anzeigenerkennung" der Anzeigenanpassung alle Kriterien bzw. löschen Sie deren Inhalt.
  2. Ändern Sie auf der Registerkarte "Quelle" für die Anzeigenanpassung die OIA-Zeile in invertmatch="true". Anschließend sollte die Quelle folgendermaßen aussehen:
    <oia invertmatch="true" optional="false" status="NOTINHIBITED"/>
  3. Fügen Sie auf der Registerkarte "Aktionen" der Anzeigenanpassung eine Aktion hinzu, die den OIA-Status entfernt und auf NOTINHIBITED zurücksetzt. Welche Aktion hierzu ausgeführt werden muss, variiert von Fall zu Fall. Manchmal muss beispielsweise lediglich eine Hosttaste für die Eingabe (oder eine andere Hosttaste) gesendet werden, damit der OIA-Status entfernt und auf NOTINHIBITED zurückgesetzt wird. Es gibt jedoch auch Fälle, in denen möglicherweise ein Makro ausgeführt werden muss, das die Cursorposition ändert oder eine Sequenz aus mehreren Hosttasten sendet, damit die Hostverbindung in einen Zustand zurückversetzt wird, in dem der OIA-Status NOTINHIBITED lautet.
  4. Wählen Sie im HATS-Editor "Projekteinstellungen" die Registerkarte Ereignisse aus, und sortieren Sie anschließend die Liste "Prioritäten für Anzeigenereignisse" so, dass sich die spezielle Anzeigenanpassung am Anfang der Liste befindet. Dies stellt sicher, dass HATS Anzeigen mit dem OIA-Status INHIBITED zuerst erkennt und verarbeitet, bevor versucht wird, andere Anzeigenereignisse abzugleichen.

Mehrere unterdrückte Anzeigen verarbeiten

Manchmal kann es mehrere unterdrückte (gesperrte) Anzeigen geben, bei denen jeweils eine andere Aktion benötigt wird, um diese Bedingung aufzuheben. Es kann daher erforderlich sein, mehrere spezielle Anzeigenanpassungen zu erstellen und einzusetzen, um solche Situationen zu verarbeiten. Möglicherweise müssen Sie nicht nur die Angabe invertmatch in der OIA-Zeile auf der Registerkarte "Quelle" in true ändern, sondern außerdem weitere Kriterien auf der Registerkarte "Kriterien für die Anzeigenerkennung" hinzufügen, damit jede Anzeigenanpassung eindeutig ist und nur in passenden Situationen ausgelöst wird.

Beispiel: Eine Hostanzeige wird möglicherweise gesperrt, wenn der Benutzer versucht, Text in ein geschütztes Feld einzugeben. In diesem Fall wird eventuell die Nachricht ausgegeben, dass sich der Cursor im geschützten Bereich der Anzeige befindet. Um diese Bedingung aufzuheben, muss der Benutzer den Cursor in einen nicht geschützten Bereich versetzen. Sie können eine spezielle Anzeigenanpassung erstellen, um diesen Vorgang zu automatisieren. Hierzu müsste nicht nur für den OIA-Bereich invertmatch="true" angegeben sein, sondern auch nach dem Text der entsprechenden Nachricht gesucht werden. Falls eine Übereinstimmung vorliegt, kann in der Anpassung die Aktion zur Ausführung eines Makros definiert sein, das den Cursor aus dem geschützten Bereich versetzt und auf diese Weise den OIA-Status entfernt.

Möglicherweise besteht auf demselben System eine zweite Bedingung, in der die Anzeige gesperrt wird, beispielsweise weil ein Benutzer eine ungültige Funktionstaste gedrückt hat. In diesem Fall lautet der Text in der Fehleranzeige vielleicht Ungültige Funktionstaste gedrückt. Um diese Bedingung aufzuheben, muss der Benutzer die Eingabetaste drücken. Zu diesem Zweck könnten Sie nun eine weitere Anzeigenanpassung erstellen. Diese würde nicht nur invertmatch="true" für den OIA-Bereich angeben, sondern auch eine Übereinstimmung mit dem Text Ungültige Funktionstaste gedrückt. Als Aktion würde die Anzeigenanpassung die Eingabetaste an den Host senden.

Abhängig von der jeweiligen Umgebung kann es am einfachsten sein, zur Verarbeitung von unterdrückten Anzeigen lediglich die OIA-Kriterien auf DONTCARE zu setzen und dem Benutzer die Verarbeitung der Situation wie bei einem Terminalemulator zu ermöglichen. Sie können aber auch HATS in die Lage versetzen, unterdrückte Anzeigen zu erkennen und zu verarbeiten, indem Sie eine oder mehrere spezielle Anzeigenanpassungen erstellen.

BMS-Zuordnungsgruppen importieren

Mit HATS können Sie Anzeigenerfassungen aus BMS-Zuordnungsgruppen (Basic Mapping Support - Anzeigeformatierungsunterstützung) von einem CICS-System (Customer Information Control System) erstellen. BMS-Zuordnungen sind Anzeigendefinitionsdateien für CICS. Jede Zuordnung definiert den Teil einer Anzeige oder eine gesamte Anzeige. Normalerweise zeigt eine CICS-Anwendung eine oder mehrere Zuordnungen an und erstellt so ein vollständiges Anzeigenabbild. Zuordnungen enthalten sowohl statische als auch dynamische Bereiche oder Felder.

Die Quelle für BMS-Zuordnungen ist in Form von Gruppen organisiert, die als "Zuordnungsgruppen" bezeichnet werden. Eine Zuordnungsgruppe enthält eine oder mehrere Zuordnungen. Zuordnungsgruppen sind in Quellenform als eine Zuordnungsgruppe pro Quellendatei vorhanden. Wenn HATS BMS-Zuordnungen importiert, findet der Import auf der Ebene der Zuordnungsgruppe statt. Der Import einer einzelnen Zuordnung ist nicht möglich.

Zuordnungen sind zunächst auf dem Hostsystem vorhanden und müssen in das lokale Dateisystem gestellt werden (oder sich scheinbar im lokalen Dateisystem befinden). Damit sie von HATS importiert werden können, müssen sie außerdem die Erweiterung ".bms" besitzen.

Sie müssen zuerst die BMS-Zuordnungsgruppen vom Host in das lokale Dateisystem kopieren. Dieser manuelle Schritt, der außerhalb von HATS erfolgen muss, kann ausgeführt werden, indem entweder die Dateien physisch in das Dateisystem kopiert werden oder das Dateisystem unter Verwendung einer Netzsoftware mit dem Host verbunden wird. Die entsprechende Datei darf nicht als Binärdatei übertragen werden. Sie muss lokal auf der Workstation lesbar sein.

  1. Klicken Sie auf Datei > Importieren > HATS > BMS-Zuordnungsgruppen in HATS, um den Importassistenten zu öffnen.
  2. Wählen Sie die Dateien der BMS-Zuordnungsgruppen, die Sie importieren wollen, in der Liste sowie das Ziel der importierten Dateien aus.
  3. Klicken Sie auf den Pfeil für das Pulldown-Menü, um das Land und die Host-Codepage auszuwählen. Dies ist die Codepage, die bei der Erstellung der BMS-Zuordnung auf dem Host verwendet wurde.
  4. Klicken Sie auf den Pfeil für das Pulldown-Menü, um die BMS-Dateicodepage auszuwählen. Dies ist die Codepage, die für die BMS-Datei bei ihrer Übertragung an die Workstation verwendet wurde.
  5. Sie können außerdem die Optionen Vorhandene Zuordnungen ohne Warnung überschreiben und Eine Anzeigenerfassung pro Zuordnung mit Zuordnungsnamen als Anzeigenerfassungsnamen generieren auswählen.
    Anmerkung:
    Die automatische Erstellung von Anzeigenerfassungen ist unter Umständen nicht sinnvoll, wenn Zuordnungen mit anderen Zuordnungen kombiniert werden müssen, um eine Anzeige zu bilden.
  6. Außerdem können Sie die Option Vorhandene Anzeigenerfassungen ohne Warnung überschreiben auswählen.
  7. Klicken Sie auf Fertig stellen.

BMS-Erfassungsdateien werden im HATS-Projekt in einem separaten Ordner namens Zuordnungen gespeichert. Der Ordner Zuordnungen ist in der Sicht "HATS-Projekte" standardmäßig nur dann sichtbar, wenn Zuordnungen importiert wurden. Im Ordner Zuordnungen gibt es für jede Zuordnungsgruppe einen eigenen Ordner, und in jedem Ordner befindet sich für jede Zuordnung eine separate Datei (Erweiterung ".bmc"). Außerdem wird die ursprüngliche Quelle im Dateisystem gespeichert (Erweiterung ".bms") und im Ordner mit ihren entsprechenden Zuordnungen angezeigt. Sie könne die Quelle bearbeiten, indem Sie auf die Datei doppelklicken. Falls die Quelle bearbeitet und gespeichert wird, werden die Zuordnungen automatisch neu generiert und überschrieben (außer bei Zuordnungen, die in der Sicht Eigenschaften geändert wurden).

Zum Import einer BMS-Zuordnung können Sie alternativ in der Navigatorsicht auch eine BMS-Quellendatei in den Ordner "<projekt>/bmsmaps" ziehen. Die Datei muss direkt in den Ordner "bmsmaps" und nicht in einen seiner Unterordner gestellt werden. Falls bei einem derartigen Import von Zuordnungen Fehler auftreten, werden Nachrichten in der Sicht Fehler ausgegeben.

Anmerkung:
Die Quelle wird nur als Referenz gespeichert. Sie wird im Editor angezeigt, hat im Projekt ansonsten jedoch keine Funktion. Beim Anzeigen wird die gesamte Zuordnungsgruppe angezeigt. Hierbei wird nicht versucht, die Definition der jeweils im Editor angezeigten Zuordnung hervorzuheben.

Nach dem Import von BMS-Zuordnungen können in der Sicht "HATS-Projekte" mehrere Aktionen ausgeführt werden:

Sobald die Anzeigenerfassungen erstellt wurden, können Sie mit der Erstellung von HATS-Anzeigenereignissen beginnen.