Makros und Host-Terminal

Ein Makro ist ein XML-Script, das eine Gruppe von Anzeigen definiert. Jede Anzeige enthält eine Beschreibung der Anzeige, die Aktionen, die für diese Anzeige auszuführen sind, sowie die Anzeige bzw. Anzeigen, die nach Ausführung der Aktionen angezeigt werden können.

HATS unterstützt eine makrobasierte Anpassung, um den Hostanwendungsprozess zu beschleunigen und anzupassen. Makros können in folgenden Funktionen verwendet werden:

Mithilfe von Makros können beliebige oder alle der folgenden Funktionen ausgeführt werden:

Überspringen von Anzeigen
Makros zum Überspringen von Anzeigen sind Navigationsmakros, die den Benutzer von einer Anzeige zu einer anderen Anzeige führen, ohne dazwischen liegende Anzeigen anzuzeigen.
Eingabeaufforderung
Eingabeaufforderungsmakros enthalten Schritte, die Eingaben von Benutzern während der Hostsitzung anfordern. Sie können außerdem Eingabeaufforderungen aus einer Benutzerliste festlegen. Sie können zum Beispiel mithilfe eines Eingabeaufforderungsmakros einen Benutzer auffordern, eine Benutzer-ID und ein Kennwort einzugeben, bevor die Anmeldung an eine Hostanwendung erfolgt.
Anmerkung:
Eingabeaufforderungen mit Benutzerliste können nur in Verbindungsmakros verwendet werden.

Eingabeaufforderungsmakros können darüber hinaus von Entwicklern verwendet werden, um konstante Werte oder Werte, die aus globalen Variablen abgerufen werden, bereitzustellen.

Extraktion
Extraktionsmakros enthalten Ereignisse zum Extrahieren von Hostanzeigeninformationen in Form einer Zeichenfolge, einer Liste von Zeichenfolgen oder einer Tabelle. Sie können zum Beispiel ein Extraktionsmakro verwenden, um eine Verbindung zu einer verzeichnisartigen Hostanwendung herzustellen und die Ergebnisse der Durchführung einer Suche in dem Verzeichnis extrahieren.

Makros, die in HATS Toolkit aufgezeichnet oder importiert werden, werden in einer HATS-Makrodatei (.hma) gespeichert. Sie können die in Ihrem Projekt definierten Makros anzeigen, indem Sie den Knoten Makros in der Sicht HATS-Projekte von HATS Toolkit erweitern.

HATS stellt drei verschiedene Editoren bereit, mit denen Sie HATS-Makros anzeigen und ändern können: den Makroeditor, den Advanced Macro Editor und den Visual Macro Editor. Der Visual Macro Editor ist der Standardeditor für HATS-Makros. Wenn Sie auf den Namen eines Makros doppelklicken, wird der Visual Macro Editor geöffnet. Weitere Informationen zum Visual Macro Editor enthält das Kapitel Visual Macro Editor im Handbuch HATS Advanced Macro Guide.

Klicken Sie zum Öffnen des Makroeditors mit der rechten Maustaste auf den Namen des Makros und wählen Sie dann die Optionen Öffnen mit > Makroeditor aus.

Advanced Macro Editor, der erweiterte Makroeditor, wird von der Übersichtsseite für Makroeditoren aus geöffnet. Weitere Informationen zum Advanced Macro Editor enthält das Kapitel Advanced Macro Editor im Handbuch HATS Advanced Macro Guide.

Anmerkung:
Die Unterstützung für den Makroeditor und für den Advanced Macro Editor ist in HATS V7.5.1 veraltet. Zwar läuft die Unterstützung derzeit weiter, doch behält IBM sich vor, diese Funktionalität in einem nachfolgenden Release des Produkts zu entfernen. Diese Unterstützung wird ersatzweise von Visual Macro Editor geliefert.

Makroeditor

In den folgenden Abschnitten werden die einzelnen Registerkarten des Makroeditors beschrieben.

Übersicht

Auf der Registerkarte Übersicht des Makroeditors werden die allgemeinen Informationen zu einem Makro, wie zum Beispiel der Name, die Beschreibung und das Datum und die Uhrzeit der letzten Änderung, zusammengefasst. Die Elemente, die Sie auf dieser Registerkarte ändern können, sind die Beschreibung des Makros, die Anhaltezeit, das Zeitlimit und die Verbindung.

Die Anhaltezeit ist die Anzahl Millisekunden der Verzögerung nach Ausführung jeder Aktion. Das Zeitlimit ist die Anzahl Millisekunden, die abzuwarten sind, bevor das Makro beendet wird. Über das Dropdown-Menü Verbindung kann die zu verwendende Verbindung ausgewählt werden.

Die Knöpfe Host-Terminal öffnen und Erweiterter Editor sind nachfolgend detailliert beschrieben.

Abbildung 63. HATS-Makroaufzeichnung
Makroaufzeichnung unter Verwendung des Host-Terminals

Host-Terminal öffnen

Sie können auf Host-Terminal öffnen klicken, um unter Verwendung des Host-Terminals ein Makro zu erstellen oder mit einem Makro zu arbeiten. Wenn das Terminal geöffnet ist, können Sie beliebige der Symbole in der Symbolleiste zum Aufzeichnen und Erstellen des Makros verwenden.

Host-Terminal

Sie können das Host-Terminal auch zum Bearbeiten eines zuvor aufgezeichneten Makros verwenden, indem Sie mit der rechten Maustaste auf die Knoten in der Makrobaumstruktur klicken und die Option Bearbeiten auswählen. Wenn Sie eine Anzeige zur Bearbeitung auswählen, wird der Editor für die Kriterien zur Anzeigenerkennung gestartet, in dem Sie Ihre Anzeige ändern können. Wenn Sie eine Eingabe bearbeiten, die Sie in Ihre Anzeige eingegeben haben, wird ein Fenster geöffnet, in dem Sie die Eingabe ändern bzw. modifizieren können. Wenn Sie den Knoten Nächste Anzeigen bearbeiten, wird eine Liste der verfügbaren Anzeigen bereitgestellt, die Sie als nächste Anzeige auswählen können. Wählen Sie die Anzeigen in der Liste in der Reihenfolge aus, in der die Anzeigen erscheinen sollen.

Zum Debugging von Makrowiedergabefehlern sind vier Symbole in der Symbolleiste Host-Terminal verfügbar. Die Symbole sind dazu vorgesehen, Ihnen zu helfen, ein Makro schrittweise durchzugehen. Dabei ist ein Schritt als Wiedergabe einer Aktion bzw. als Erkennung einer Anzeige definiert. Bei den Symbolen handelt es sich um Schrittweise ausführen, Schritt überspringen, Schritt zurück und Wieder aufnehmen.

Allen Symbolen sind Funktionstasten zugeordnet. Abhängig von der aktiven Sicht (entweder Makronavigator oder Host-Terminal) funktionieren die Tasten F5, F6, F7 und F8 unterschiedlich. Wenn zum Beispiel die Sicht Makronavigator aktiv ist, führt das Drücken der Taste F5 die Aktion Schrittweise ausführen aus, während das Drücken der Taste F6 die Aktion Schritt überspringen ausführt. Ist die Sicht Host-Terminal aktiv, wird durch Drücken der Taste F5 oder F6 die AID-Taste an den Host gesendet. Weitere Informationen zu diesen und anderen auf Makros bezogenen Symbolen finden Sie in Auf Makros bezogene Symbole.

Anmerkung:
Anmerkungen:
  1. HATS setzt voraus, dass Sie Kriterien zur Anzeigenerkennung für bestimmte Anzeigen definieren. Bei diesen Anzeigen handelt es sich um folgende:
  2. Funktionen zum Ausschneiden, Kopieren und Einfügen werden im Host-Terminal über die folgenden Tastenkombinationen bereitgestellt:

In Tabelle 4 werden die Makrosymbole aufgeführt, die in der Symbolleiste der Host-Terminalanzeige zur Verfügung stehen.

Tabelle 4. Makrosymbole
Symbol Beschreibung
Makro öffnen
Makro öffnen. Wählen Sie ein Makro in der Dropdown-Liste aus.
Makro wiedergeben
Makro wiedergeben. Wählen Sie ein Makro in der Dropdown-Liste aus.
Makro aufzeichnen
Aufzeichnung eines Makros starten.
Makro stoppen
Aufzeichnung eines Makros stoppen.
Makro speichern
Aufgezeichnetes Makro speichern.
Schrittweise ausführen
Makro zu Debugzwecken schrittweise ausführen (F5).
Schritt überspringen
Im Makro einen Schritt beim Debugging überspringen (F6)
Schritt zurück
Im Makro einen Schritt zu Debugzwecken zurückgehen (F7).
Wieder aufnehmen
Wiedergabe des Makros wieder aufnehmen (F8).
Erkennungskriterien für Makroanzeigen definieren
Anzeigenerkennungskriterien für eine Makroanzeige definieren.
Eingabeaufforderungsaktion hinzufügen
Eingabeaufforderungsaktion in das aktuelle Makro einfügen (nur beim Aufzeichnen eines Makros aktiviert).
Extraktionsaktion hinzufügen
Extraktionsaktion in das aktuelle Makro einfügen (nur beim Aufzeichnen eines Makros aktiviert).
Schleifenmakro aufzeichnen
Schleife im aktuellen Makro aufzeichnen (nur beim Aufzeichnen eines Makros aktiviert).
Eingabeaufforderungsaktionen für alle Felder hinzufügen
Eingabeaufforderungsaktionen für alle Felder auf der Anzeige in das aktuelle Makro einfügen (nur beim Aufzeichnen eines Makros aktiviert).
Extraktionsaktionen für alle Felder hinzufügen
Extraktionsaktionen für alle Felder auf der Anzeige in das aktuelle Makro einfügen (nur beim Aufzeichnen eines Makros aktiviert).
Tastenblock ein-/ausblenden
Tastenblock im Fenster des Host-Terminals ein- oder ausblenden.
Text-OIA
Operatorinformationsbereichs (OIA) im Textformat ein- oder ausblenden.
Auf Makros bezogene Symbole

In der nachfolgenden Liste werden Symbole in der Symbolleiste der Sicht Host-Terminal erläutert, die sich auf Makros beziehen:

Makro aufzeichnen

Sie können Makros in HATS Toolkit über den HATS-Host-Terminal aufzeichnen. Klicken Sie auf der HATS-Host-Terminalanzeige auf das Symbol Makro aufzeichnen. Der Assistent "Makro aufzeichnen" wird geöffnet und gibt Ihnen die Möglichkeit, das Zielprojekt auszuwählen, das Makro zu benennen, eine Beschreibung für das Makro anzugeben und zu sehen, wo das Makro gespeichert wird. Mit der Option Screenshots automatisch während der Aufzeichnung erstellen können Sie angeben, dass für jede Anzeige, zu der Sie während der Aufzeichnung des Makros navigiert sind, automatisch eine Anzeigenerfassung erfolgen soll. Diese Anzeigenerfassungen können dann in Visual Macro Editor verwendet werden, falls Sie zu einem späteren Zeitpunkt Änderungen an dem Makro vornehmen müssen. Diese Option ist standardmäßig ausgewählt. Klicken Sie auf Fertig stellen, wenn Sie diese Elemente angegeben haben.

Als Nächstes wird das Fenster Kriterien für die Anzeigenerkennung definieren angezeigt, da HATS zwingend voraussetzt, dass für die erste Anzeige eine explizite Anzeigenerkennung definiert wird. Sie können anschließend über die HATS-Host-Terminalanzeige durch die Hostanwendung zu einer beliebigen Anzeige zu navigieren.

Falls innerhalb des HATS-Host-Terminals bereits ein Makro geöffnet ist, werden Sie nach dem Klicken auf das Symbol Makro aufzeichnen gefragt, ob Sie ein neues Makro aufzeichnen oder die neue Aufzeichnung an das geöffnete Makro anhängen wollen. Wenn Sie an das geöffnete Makro anhängen wollen, beginnt die Makroaufzeichnung und Ihre Aktionen werden an das aktuelle Makro angehängt. Die Position innerhalb des Makros, an der die Aufzeichnung beginnt, hängt von der Auswahl in der Makronavigator-Baumstruktur auf der linken Seite und davon ab, ob die aktuelle Terminalanzeige mit den Anzeigenerkennungskriterien des ausgewählten Knotens übereinstimmt. Insbesondere gilt:

Erstellen Sie kein Makro, dessen einziger Schritt darin besteht, eine Extraktion einzufügen oder eine Eingabeaufforderung hinzuzufügen. Wenn Sie dies tun, ändert sich bei Eingabe eines Werts durch den Benutzer die Seite nicht, und der Benutzer erhält keine Möglichkeit, zu einer anderen Seite zu gelangen. Wenn ein Makro nicht zum Host zurückkehrt, bleibt es stehen und verursacht eine Zeitlimitüberschreitung.

Anmerkung:
Wenn Sie beabsichtigen, ein Integrationsobjekt aus einem Makro zu erstellen, müssen Sie sicherstellen, dass Sie die folgenden Anforderungen für die Benennung eines Makros einhalten:
  • Der Name des Makros darf nur aus Buchstaben, Ziffern oder Unterstreichungszeichen bestehen.
  • Das erste Zeichen des Namens darf kein numerisches Zeichen sein.
  • Doppelbytezeichen (voller Breite) sind nicht zulässig.
Makro stoppen
Wenn Sie die Aufzeichnung Ihres Makros abgeschlossen haben, klicken Sie auf das Symbol Makro stoppen.
Makro speichern
Wenn Sie die Aufzeichnung eines Makros gestoppt haben, müssen Sie es speichern, indem Sie auf das Symbol Makro speichern klicken.
Schrittweise ausführen (F5)
Durch Klicken auf das Symbol Schrittweise ausführen (F5) können Sie schrittweise von einer Anzeige zur ersten eingeschlossenen Aktion sowie von Aktion zu Aktion voranschreiten. Die Taste F5 auf Ihrer Tastatur führt dieselbe Funktion aus. Diese Funktion dient zu Debugzwecken.
Schritt überspringen (F6)
Durch Klicken auf Schritt überspringen (F6) können Sie von Anzeige zu Anzeige wechseln (wobei alle dazwischen liegenden Aktionen ausgeführt werden). Die Taste F6 auf Ihrer Tastatur führt dieselbe Funktion aus. Diese Funktion dient zu Debugzwecken.
Schritt zurück (F7)
Durch Klicken auf Schritt zurück (F7) können Sie die Wiedergabe der Aktionen unter einer Anzeige beenden und zur nächsten Anzeige wechseln. Die Taste F7 auf Ihrer Tastatur führt dieselbe Funktion aus. Diese Funktion dient zu Debugzwecken.
Wieder aufnehmen (F8)
Zur Wiederaufnahme der Wiedergabe Ihres Makros können Sie entweder auf das Symbol Wieder aufnehmen (F8) klicken oder die Taste F8 auf Ihrer Tastatur drücken. Diese Funktion kann zur Ausführung der übrigen Teile des Makros verwendet werden, wenn Sie es gerade schrittweise durchgehen.
Kriterien für die Anzeigenerkennung definieren

Sie können Kriterien für die Anzeigenerkennungen festlegen, die von HATS zur Ermittlung übereinstimmender Hostanzeigen verwendet werden. Hostanzeigen können durch eine beliebige Kombination von Kriterien erkannt werden. Dazu gehören zum Beispiel die Anzahl der Eingabefelder oder aller Felder der Anzeige, die Koordinaten der Cursorposition sowie Textzeichenfolgen auf der Anzeige in einem definierten Rechteck oder an einer beliebigen Position auf der Anzeige. Weitere Informationen zu diesem Thema finden Sie in Kriterien für die Anzeigenerkennung oder Startanzeige.

Aktion "Eingabeaufforderung" hinzufügen

Wenn Sie wünschen, dass das Makro den Benutzer zur Eingabe von Informationen auffordert, klicken Sie auf Aktion 'Eingabeaufforderung' hinzufügen, um den Assistenten "Aktion 'Eingabeaufforderung' hinzufügen" anzuzeigen. Sie können der Eingabeaufforderung einen Namen und einen Standardwert geben. Wenn die Informationen, die der Benutzer angibt, zum Beispiel ein Kennwort, auf der Hostanzeige nicht sichtbar sein sollen, klicken Sie auf das Markierungsfeld Kennworteingabe schützen.

Anmerkung:
Standardwerte, die Sie für Eingabeaufforderungen angeben, werden in Makrodateien unverschlüsselt gespeichert. Die Standardwerte werden im Klartext angezeigt, wenn Sie Eingabeaufforderungen mit dem Makroeditor bearbeiten. Wenn sich also die Verwendung einer Eingabeaufforderung zur Eingabe eines Kennworts als nützlich anbietet, sollten Sie aus Sicherheitsgründen keinen Standardwert für das Kennwort angeben.

Die Felder Zeile und Spalte im Abschnitt Position des Assistenten definiert, an welcher Position auf der Hostanzeige die Informationen, die vom Benutzer eingegeben werden, angezeigt werden. Wenn Sie Ihren Cursor an einer Position auf der Hostanzeige, wie zum Beispiel in einem Feld für ein Kennwort, platzieren, bevor Sie mit der Aufzeichnung des Makros beginnen, werden die Felder Zeile und Spalte mit den entsprechenden Werten gefüllt. Im Abschnitt Makro-Eingabeaufforderung bearbeiten des Assistenten können Sie ermitteln, wie die Eingabeaufforderung verarbeitet wird. Sie können einen der folgenden Radioknöpfe auswählen:

Steuerroutine anzeigen
Für HATS-Webprojekte können Sie eine .jsp-Datei auswählen, um den Benutzer zur Eingabe der erforderlichen Informationen aufzufordern, und auf der Seite einen Knopf zur Übergabe der Informationen durch den Benutzer einfügen. Eine Standardmakrosteuerroutine mit dem Namen "default.jsp" gehört zum Lieferumfang von HATS. Sie finden diese Datei, indem Sie auf die Sicht HATS-Projekte in HATS Toolkit klicken, den Projektnamen erweitern und Webinhalt > Ereignissteuerroutinen für Makros erweitern. Wenn Sie eine eigene Steuerroutine erstellen wollen, stellen Sie sicher, dass die Steuerung an die HATS-Laufzeit zurückgegeben wird.
Anmerkungen:
  1. Integrationsobjekte ignorieren die ausgewählte .jsp-Steuerroutine. Stattdessen wird eine Eingabeseite für das Integrationsobjekt erstellt und eine Eingabeaufforderung für den Wert auf dieser Eingabeseite platziert. Die generierte Ausgabeseite kopiert den von der Eingabeseite angegebenen Wert in das Integrationsobjekt, bevor das Integrationsobjekt ausgeführt wird.
  2. Die Option Steuerroutine anzeigen wird beim Extrahieren aus einer anderen als der Textebene inaktiviert.
Anmerkung:

Für HATS-Rich-Client-Projekte können Sie eine angepasste Makrosteuerroutine angeben oder über "Durchsuchen" eine solche in der Liste der angepassten Makrosteuerroutinen auswählen, die im betreffenden Rich-Client-Projekt definiert sind, um den Benutzer zur Eingabe erforderlicher Informationen aufzufordern und einen Knopf zur Verfügung zu stellen, durch den der Benutzer die Informationen übergeben kann. Zum Lieferumfang von HATS gehört eine Standardmakrosteuerroutine mit dem Namen "DefaultMacroHandler". Sie finden diese Datei in der Sicht HATS-Projekte, wenn Sie den Projektnamen und anschließend Rich-Client-Inhalt > Ereignissteuerroutinen für Makros erweitern. Wenn Sie eine eigene Steuerroutine erstellen wollen, stellen Sie sicher, dass die Steuerung an die HATS-Laufzeit zurückgegeben wird, indem Sie die Methoden "createButtonArea()" und "createButtons()" in der Methode "render()" Ihrer angepassten Makrosteuerroutine aufrufen. Diese Methoden werden in der Standardimplementierung der Methode "RcpMacroHandler.render()" aufgerufen. Weitere Informationen zu "RcpMacroHandler" finden Sie im Abschnitt "HATS RCP API Reference" im Information Center von HATS unter der Adresse http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp?topic=/com.ibm.hats.doc/doc/rcpjavadoc/index.html.

Zeichenfolge für Eingabeaufforderung verwenden
Wenn Sie wissen, welcher Wert von einer Eingabeaufforderung zurückgegeben werden muss, können Sie diese Zeichenfolge in das Feld Zeichenfolge eingeben.
Eingabeaufforderung auf globale Variable setzen
Wenn der Wert der Eingabeaufforderung von einer globalen Variablen bereitgestellt werden soll, geben Sie den Namen der globalen Variablen in das Feld Name ein oder wählen eine vorhandene Variable im Dropdown-Menü neben dem Feld Globale Variable aus. Wenn Sie auf den Knopf Erweitert klicken, können Sie angeben, ob die Variable gemeinsam genutzt wird oder indexiert ist. Wenn es sich um eine indexierte Variable handelt, müssen Sie außerdem angeben, ob alle Indizes oder nur ein einzelner Index angezeigt werden soll. Weitere Informationen finden Sie in Mit globalen Variablen interagieren.
Anmerkung:

Wenn der Wert einer Eingabeaufforderung auf einer globalen Variablen basiert, die durch eine Extraktion festgelegt wird, und für promptall der Wert true angegeben ist, wird die Extraktionsaktion erst ausgeführt, nachdem die Werte der Eingabeaufforderungen abgerufen worden sind. Aus diesem Grund enthält die globale Variable, die von der Eingabeaufforderung verwendet wird, keinen Wert. Wenn Sie globale Variablen mit Extraktionen und Eingabeaufforderungen verwenden, müssen Sie für promptall den Wert false festlegen.

Integrationsobjekte greifen auf globale Variablen nicht direkt zu. Stattdessen rufen die Ein- und Ausgabeseiten für das Integrationsobjekt den Wert der globalen Variablen ab und setzen ihn in das Integrationsobjekt ein, bevor dieses ausgeführt wird. Integrationsobjekte können nur auf gemeinsam genutzte globale Variablen zugreifen.

Eingabeaufforderung auf Eigenschaft aus Benutzerliste setzen
Wenn die Eingabeaufforderung auf eine Benutzerliste zugreifen soll, wählen Sie Benutzerprofil in der Dropdown-Liste aus. Das Benutzerprofil dient als Schlüssel zur Bestimmung, ob die Benutzer-ID (userid) oder das Kennwort (password) als Eigenschaft aus Benutzerliste zu verwenden ist. Weitere Informationen finden Sie in Benutzerliste.
Anmerkung:
Eingabeaufforderungen mit Benutzerliste können nur in Verbindungsmakros verwendet werden.
Web Express Logon verwenden
Wenn Sie Ihre HATS-Anwendung zur Verwendung von Web Express Logon konfiguriert haben, geben Sie für den Typ der Eingabeaufforderung entweder die Benutzer-ID oder das Kennwort in der Dropdown-Liste Typ der Eingabeaufforderung und die Anwendungs-ID in das Feld Anwendungs-ID ein.
Anmerkung:
Das Feld Typ der Eingabeaufforderung sollte bereits mit dem richtigen Wert gefüllt sein.

Klicken Sie auf OK, wenn Sie Ihre Optionen ausgewählt haben.

Aktion "Extraktion" hinzufügen

Wenn das Makro Informationen aus der Hostanzeige extrahieren soll, wählen Sie einen Bereich auf der Hostanzeige aus und klicken anschließend auf Aktion 'Extraktion' hinzufügen, um den Assistenten "Aktion 'Extraktion' hinzufügen" anzuzeigen. Sie können einen Namen für die Extraktion angeben. Die Felder Anfangszeile, Anfangsspalte, Endzeile und Endspalte des Abschnitts Position des Assistenten definieren, aus welchem Bereich der Hostanzeige die Informationen extrahiert werden. Wenn Sie einen Bereich der Hostanzeige mit einem Rechteck markieren und anschließend auf Aktion 'Extraktion' hinzufügen klicken, werden die Felder im Abschnitt Position mit den entsprechenden Werten gefüllt, wenn der Assistent "Aktion 'Extraktion' hinzufügen" angezeigt wird.

Sie können das Extraktionsformat wie folgt angeben:

Im Abschnitt Makro-Extraktion bearbeiten des Assistenten können Sie festlegen, wie die Eingabeaufforderung verarbeitet wird. Sie können die folgenden Markierungsfelder auswählen:

Steuerroutine anzeigen
Für HATS-Webanwendungen können Sie eine .jsp-Datei auswählen, um dem Benutzer die extrahierten Informationen anzuzeigen. Eine Standardmakrosteuerroutine mit dem Namen "default.jsp" gehört zum Lieferumfang von HATS. Sie finden diese Datei in der Sicht HATS-Projekte, wenn Sie den Projektnamen und anschließend Webinhalt > Ereignissteuerroutinen für Makros erweitern. Wenn Sie eine eigene Steuerroutine erstellen wollen, stellen Sie sicher, dass die Steuerung an die HATS-Laufzeit zurückgegeben wird.
Anmerkung:
Diese Option wird von Integrationsobjekten nicht verwendet. Stattdessen ruft die Ausgabeseite die extrahierten Daten aus dem Integrationsobjekt ab und zeigt sie an.

Für HATS-Rich-Client-Projekte können Sie eine angepasste Makrosteuerroutine angeben oder über "Durchsuchen" eine solche in der Liste der angepassten Makrosteuerroutinen auswählen, die im betreffenden Rich-Client-Projekt definiert sind, um den Benutzer zur Eingabe erforderlicher Informationen aufzufordern und einen Knopf zur Verfügung zu stellen, durch den der Benutzer die Informationen übergeben kann. Eine Standardmakrosteuerroutine mit dem Namen "DefaultMacroHandler" gehört zum Lieferumfang von HATS. Sie finden diese Datei in der Sicht HATS-Projekte, wenn Sie den Projektnamen und anschließend Rich-Client-Inhalt > Ereignissteuerroutinen für Makros erweitern. Wenn Sie eine eigene Steuerroutine erstellen wollen, stellen Sie sicher, dass die Steuerung an die HATS-Laufzeit zurückgegeben wird, indem Sie die Methoden "createButtonArea()" und "createButtons()" in der Methode "render()" Ihrer angepassten Makrosteuerroutine aufrufen. Diese Methoden werden in der Standardimplementierung der Methode "RcpMacroHandler.render()" aufgerufen. Weitere Informationen zu "RcpMacroHandler" finden Sie im Abschnitt "HATS RCP API Reference" im Information Center von HATS unter der Adresse http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp?topic=/com.ibm.hats.doc/doc/rcpjavadoc/index.html.

Als globale Variable speichern
Sie können einen Namen für die globale Variable in das Feld Name eingeben oder eine vorhandene Variable über das Dropdown-Menü auswählen. Wenn Sie eine vorhandene globale Variable im Feld Name auswählen, müssen Sie angeben, wie die vorhandene Variable verarbeitet werden soll, indem Sie einen der folgenden Radioknöpfe auswählen:
  • Vorhandenen Wert mit diesem neuen Wert überschreiben
  • Vorhandenen Wert mit diesem neuen Wert überschreiben, dabei am angegebenen Index beginnen
  • Diesen neuen Wert nach dem letzten Index des vorhandenen Werts anfügen
  • Diesen neuen Wert am angegebenen Index in den vorhandenen Wert einfügen
Sie können außerdem angeben, ob diese Variable gemeinsam genutzt wird, indem Sie das Markierungsfeld Gemeinsam genutzt auswählen.
Anmerkung:
Wenn Sie einen Wert extrahieren und einer globalen Variablen zuordnen, die durch eine Extraktion festgelegt wird, und beabsichtigen, den Wert der globalen Variablen für eine Eingabeaufforderung zu verwenden, sollten Sie für promptall den Wert false angeben. Wenn für promptall der Wert true definiert ist, wird die Extraktionsaktion nicht ausgeführt, bis die Werte der Eingabeaufforderung abgerufen werden. Aus diesem Grund enthält die globale Variable, die von der Eingabeaufforderung verwendet wird, keinen Wert.

Integrationsobjekte extrahieren keine Werte direkt in globale Variablen. Stattdessen ruft die Ausgabeseite für das Integrationsobjekt die Daten aus dem Integrationsobjekt ab, nachdem es ausgeführt wurde, und legt dann die globalen Variablen fest. Beachten Sie, dass Integrationsobjekte nur auf gemeinsam genutzte globale Variablen zugreifen können.

Klicken Sie auf OK, wenn Sie Ihre Optionen ausgewählt haben.

Eine Schleife aufzeichnen

Wenn Sie eine Schleife in Ihrem Makro aufzeichnen wollen, klicken Sie auf Eine Schleife aufzeichnen und navigieren zu der Anzeige, bei der die Schleife beginnen soll. Klicken Sie auf Weiter, um die Kriterien für die Anzeigenerkennung für die erste Anzeige in der Schleife zu definieren. Klicken Sie auf Weiter, um weitere Kriterien zu definieren, oder auf Fertig stellen, um zum Hauptterminal zurückzukehren. Führen Sie im Hauptterminal die Aktionen aus, die während jedes Zyklus der Schleife ausgeführt werden sollen, und klicken Sie anschließend auf Weiter. Bestimmen Sie, wie Ihre Schleife enden soll, indem Sie entweder Bei Erkennung einer bestimmten Anzeige enden oder Nach einer festen Anzahl von Iterationen enden auswählen, und die Anzahl der Schleifen darunter eingeben. Klicken Sie auf Weiter, navigieren Sie dann zur letzten Anzeige der Schleife, und klicken Sie auf Fertig stellen, um die Schleife abzuschließen.

Anmerkung:
Den Kriterien für die Anzeigenerkennung für die Anfangs- und Endanzeige der Schleife sollte große Aufmerksamkeit beigemessen werden. In einigen Fällen kann die Anfangsanzeige mit der Endanzeige nahezu identisch sein. Sie müssen diese Anzeigen sorgfältig voneinander unterscheiden.
Eingabeaufforderungsaktionen für alle Felder hinzufügen
Wenn Sie dieses Symbol auswählen, wird das Fenster Alle Felder aus globalen Variablen einfügen geöffnet. In diesem Fenster können Sie einen Namen in der Dropdown-Liste für das Feld Name der gespeicherten Anzeige auswählen. Sie können außerdem die Option zur Erstellung einer Anzeigenerfassung aktivieren, indem Sie das Markierungsfeld Anzeigenerfassung erstellen auswählen. Durch Auswählen des Markierungsfelds Gemeinsam genutzt wird die globale Variable der Liste der gemeinsam genutzten Variablen entnommen.
Anmerkungen:
  1. Standardwerte, die Sie für Eingabeaufforderungen angeben, werden in Makrodateien unverschlüsselt gespeichert. Die Standardwerte werden im Klartext angezeigt, wenn Sie Eingabeaufforderungen im Makroeditor des Host-Terminals oder im Advanced Macro Editor bearbeiten. Wenn sich also die Verwendung einer Eingabeaufforderung zur Eingabe eines Kennworts als nützlich anbietet, sollten Sie aus Sicherheitsgründen keinen Standardwert für das Kennwort angeben.
  2. Wenn Sie diese Option mit Integrationsobjekten verwenden, fügt HATS dem Integrationsobjekt Felder für alle definierten globalen Variablen hinzu. Sie müssen Code schreiben, um die Werte der globalen Variablen festzulegen und sie in das Integrationsobjekt zu kopieren, bevor dieses ausgeführt wird. Dies kann in der JSP-Seite geschehen, die das Integrationsobjekt ausführt. Weitere Informationen finden Sie in Integrationsobjekteigenschaften einfügen. Beachten Sie, dass Integrationsobjekte nur auf gemeinsam genutzte globale Variablen zugreifen können.
Extraktionsaktionen für alle Felder hinzufügen
Wenn Sie dieses Symbol auswählen, wird das Fenster Alle Felder in globale Variablen extrahieren geöffnet. In diesem Fenster können Sie einen Namen in der Dropdown-Liste für das Feld Name der gespeicherten Anzeige auswählen. Dieser Name wird als Präfix für alle globalen Variablen verwendet, die für die Felder erstellt werden. Wenn der Text der geschützten Felder zur Laufzeit erfasst werden soll, wählen Sie die Option Alle Felder aus. Wenn der Text für die geschützten Felder in der Umsetzungs-JSP statisch sein soll, wählen Sie die Option Eingabefelder aus. Durch Auswählen des Markierungsfelds Gemeinsam genutzt wird die globale Variable der Liste der gemeinsam genutzten Variablen entnommen.
Anmerkung:
Wenn Sie diese Option mit Integrationsobjekten verwenden, fügt HATS dem Integrationsobjekt Felder für alle definierten globalen Variablen hinzu. Sie müssen Code schreiben, um die Daten aus dem Integrationsobjekt in die gemeinsam genutzten globalen Variablen zu kopieren, nachdem das Integrationsobjekt ausgeführt wurde. Dies kann in der JSP-Seite geschehen, die das Integrationsobjekt ausführt. Weitere Informationen finden Sie in Integrationsobjekteigenschaften einfügen. Beachten Sie, dass Integrationsobjekte nur auf gemeinsam genutzte globale Variablen zugreifen können.
Tastatur ein-/ausblenden

Mit diesem Symbol können Sie entweder die Terminaltastatur einblenden oder die Terminaltastatur ausblenden.

Text-OIA anzeigen

Über das Symbol Text-OIA anzeigen (OIA, Operatorinformationsbereich) können Sie die exakte Zeilen- und Spaltenposition des Cursors auf Ihrer Terminalanzeige ablesen. Darüber hinaus können Sie erkennen, ob die Eingabe gesperrt ist oder nicht.

Hostvoranzeige

Wenn Sie prüfen wollen, wie die aktuelle Hostanzeige aussehen würde, wenn sie vom Server umgesetzt würde, klicken Sie auf die Registerkarte Hostvoranzeige oben im Host-Terminalfenster. Die Voranzeige stellt die Hostanzeige, auf der Sie sich befinden, in Form einer Webseite dar.

Die Hostvoranzeige wendet zunächst jede Anzeigenanpassung an, die für die aktuelle Anzeige definiert ist. Wenn für die aktuelle Anzeige keine Anzeigenanpassungen definiert sind, werden die auf Projektebene geltenden Schablonen- und Standardwiedergaberegeln auf die Anzeige angewendet.

Die Hostvoranzeige wendet die Reihenfolge von Anzeigenanpassungen an, die auf der Registerkarte Ereignisse Ihrer Projekteinstellungen aufgeführt ist. Sobald sie eine Übereinstimmung mit den Anzeigenerkennungskriterien feststellt, zeigt sie Ihnen die entsprechende Anzeige so an, wie sie durch die in der betreffenden Anzeigenanpassung definierte Umsetzung (falls vorhanden) generiert würde. Falls keine Übereinstimmung gefunden wird, wird die Standardumsetzung angezeigt.

Die Hostvoranzeige verarbeitet keine Anzeigenanpassungen, die in der Liste der nächsten Anzeigen definiert sind. Nächste Anzeigen werden in der Hostvoranzeige nicht verarbeitet. Weitere Informationen finden Sie in Nächste Anzeige.

Anmerkung:
Die Registerkarte Hostvoranzeige wird nur angezeigt, wenn Ihr aktueller Host-Terminal der Standardverbindung zugeordnet ist. Wenn Sie ein Host-Terminal über eine Hintergrundverbindung öffnen, wird diese Voranzeige nicht zur Verfügung gestellt.

Erweiterter Editor

Sie haben auch die Möglichkeit, auf Erweiterter Editor auf der Registerkarte Übersicht zu klicken, um die erweiterten Funktionen des HATS-Makroeditors zu starten und Einstellungen für das Makro zu ändern. Für den Makroeditor wird ein separates Fenster mit den folgenden Registerkarten geöffnet:

Weitere Informationen zu den erweiterten Editorfunktionen des Makroeditors finden Sie im Handbuch HATS Advanced Macro Guide.

Eingabeaufforderungen und Extraktionen

Auf der Registerkarte Eingabeaufforderungen und Extraktionen des Makroeditors werden die konfigurierten Eingabeaufforderungen und Extraktionen des Makros sowie ihre Verarbeitung bei der Wiedergabe des Makros aufgeführt. Sie können die HATS-spezifischen Eigenschaften einer Eingabeaufforderung oder einer Extraktion bearbeiten, indem Sie sie in der Tabelle auswählen und auf Bearbeiten klicken.

Quelle

Auf der Registerkarte Quelle werden die Tags in der Datei makroname.hma für alle Attribute und Werte für das Makro angezeigt. Der Makroname ist in diesem Fall der Name, den Sie dem Makro beim Erstellen oder Importieren des Makros gegeben haben. Wenn Sie Änderungen auf anderen Registerkarten im Projekteditor vornehmen, ändern sich die Tags und Attribute entsprechend, die in der Quellendatei angezeigt werden. Sie können auch Änderungen an den Tags und Attributen in der Quellendatei vornehmen. Auch diese Änderungen werden auf den entsprechenden Registerkarten des Makroeditors nachvollzogen.

Eingabeaufforderungen und Extraktionen werden in der Makroquellendatei in der Reihenfolge angezeigt, in der sie aufgezeichnet wurden. Darüber hinaus wird der Cursor beim Öffnen des Makros im Editor nicht am Anfang der Makrodatei, sondern in der Zeile angezeigt, in der er sich befand, als das Makro zuletzt gespeichert wurde.

Mit Makrofehlern arbeiten

Fehler in einem Makro werden in der Sicht Probleme zusammengefasst, unabhängig davon, ob Sie mit dem Makroeditor, dem Texteditor oder dem XML-Editor arbeiten. Der Quellcode des Makros zeigt eine Markierung in Form eines roten Kreises mit einem weißen X in allen Zeilen an, die einen Fehler enthalten.

Das Makro kann auch mit Fehlern gespeichert werden, sodass Sie die Fehler später ermitteln und beheben können, falls erforderlich. Makros mit Fehlern können jedoch während der Laufzeit oder im Host-Terminal nicht wiedergegeben werden.

Makro importieren

Sie können auch Makros importieren, die mit anderen Programmen, wie zum Beispiel IBM® WebSphere Host Publisher oder IBM Host On-Demand aufgezeichnet wurden. Zum Importieren solcher Makros wählen Sie die Optionen Datei > Importieren > HATS > Host Publisher/HOD-Makro aus und klicken auf Weiter, um den Dialog Host Publisher-/HOD-Makro importieren anzuzeigen. Klicken Sie auf Hinzufügen, und navigieren Sie zur Position des Makros im Dateisystem.

Anmerkung:
Host Publisher-Makros mit festgelegten Iterationsschleifen erkennen fortlaufend dieselbe Anzeige und führen verschiedene Aktionen aus. In HATS können Sie keine Anzeigenanpassung erstellen, die dieselbe Anzeige ein zweites Mal erkennt und eine andere Aktion als bei der ersten Erkennung ausführt. Wenn Sie versuchen, ein Host Publisher-Makro mit einer festgelegten Iterationsschleife zu verwenden, kann Ihr Projekt in eine Endlosschleife geraten. Host Publisher-Makros mit festgelegten Iterationsschleifen lassen sich durch Prüfen des Quellcodes für das Makro erkennen. Das Makro enthält Tags customreco mit den ID-Attributen HPubFixedIterationLoop und Tags custom mit den ID-Attributen HPubIncrementLoop.

Makro exportieren

Sie können HATS-Makros sowie IBM WebSphere Host Publisher- oder IBM Host On-Demand-Makros exportieren. Zum Exportieren solcher Makros wählen Sie die Optionen Datei > Exportieren > HATS > HATS-Makro bzw. Datei > Exportieren > HATS > Host Publisher/HOD-Makro aus und klicken auf Weiter. Host Publisher-Makros befinden sich in der Regel in dem Verzeichnispfad \hostpub\Studio\IntegrationObjects. Diese Makros werden als .macro-Dateien exportiert. Diese Dateierweiterung funktioniert für Host Publisher-Makros und für Host On-Demand-Makros, jedoch verwendet Host On-Demand standardmäßig die Erweiterung .mac und sucht dementsprechend nach .mac-Dateien. Sie müssen die Host On-Demand-Filtereinstellung in "*.macro" oder "*.*" ändern.

Wählen Sie die zu exportierenden Makrodateien zusammen mit dem Ziel aus. Sie können die vorhandenen Ressourcen überschreiben, indem Sie das Markierungsfeld Vorhandene Ressourcen ohne Warnung überschreiben auswählen.

Klicken Sie anschließend auf Fertig stellen.

Anmerkung:

Hinweise zur Verwendung der DBCS-Unterstützung finden Sie in Makro aufzeichnen.

Hinweise und Tipps zu Makros

Endlosschleife vermeiden

Das Ausführen eines Makros ist eine der Aktionen, deren Ausführung Sie angeben können, wenn eine Hostanzeige mit den Erkennungskriterien einer Anzeigenanpassung übereinstimmt. Stellen Sie bei der Aufzeichnung eines Makros sicher, dass die letzte Anzeige nicht die Anzeige ist, die von der Anzeigenanpassung, für die das Makro als Aktion definiert ist, erkannt wird. Wenn die erkannte Anzeige die letzte Anzeige des Makros ist, entsteht eine Endlosschleife.

Übergangsanzeigen verarbeiten

Sie können für Makros neben permanenten Anzeigen auch Übergangsanzeigen definieren. Zur Laufzeit wird jedoch möglicherweise entgegen den Erwartungen eine der Übergangsanzeigen erkannt.

Beim Vergleich von Deskriptoren für die nächste Anzeige in Makros werden zuerst die Deskriptoren der permanenten Anzeigen und danach die Deskriptoren der Übergangsanzeigen verglichen. Wenn die aktuellen Anzeigeinformationen aktualisiert werden, nachdem der Vergleich der Deskriptoren der permanenten Anzeigen begonnen hat, werden die aktualisierten Anzeigeinformationen für den Vergleich der Deskriptoren der Übergangsanzeigen verwendet. Wenn in diesem Fall eine Anzeige zu Beginn des Vergleichs der permanenten Anzeigen gesperrt ist (also die Eingabe in den OIA gesperrt ist) und danach entsperrt wird, bevor der Vergleich der Übergangsanzeigen beginnt und ohne dass sonstige Änderungen eintreten, werden die permanenten Anzeigen unter Umständen nicht erkannt, während anschließend die Übergangsanzeigen erkannt werden. Dies ist nicht das erwartete Verhalten.

Um dieses nicht erwartete Verhalten zu verhindern, können Sie steuern, ob beim Vergleich der Deskriptoren der permanenten Anzeigen und der Übergangsanzeigen dieselben Anzeigeinformationen verwendet werden sollen. Fügen Sie dazu die erweiterte Verbindungseinstellung screenRecoUseOIASnapshot hinzu und legen Sie ihren Wert auf true fest. Informationen zum Festlegen der erweiterten Verbindungseinstellungen finden Sie unter Konfigurieren Sie optionale erweiterte Verbindungseinstellungen.