HOST-Module erstellen

Tosca kann Labels, TextBoxes und Tabellen in HOST-Applikationen erkennen und mit ihnen interagieren. Dazu müssen Sie zunächst Ihre HOST-Applikation aufzeichnen. In diesem Kapitel erfahren Sie, wie Sie HOST-Applikationen aufzeichnen, um Module zu erstellen.

HOST-Aufzeichnung vorbereiten

In diesem Abschnitt erfahren Sie, welche zusätzlichen Schritte erforderlich sind, bevor Sie HOST-Controls mit dem XScan aufzeichnen.

Session-Modus auswählen

Die HOST Engine 3.0 unterstützt die folgenden Session-Modi:

  • HOST-Emulator-Sessions. Eine Emulator-Session verwendet eine aktive HOST-Emulatorverbindung, um Ihre Mainframe-Applikation über Ihren Emulator zu navigieren. Emulator-Sessions unterstützen ASCII sowie japanische Zeichensätze, wenn Sie die Unterstützung japanischer Zeichen in Ihren Projekteinstellungen aktivieren. Möglicherweise zeigt der Scan Zeichen an, die im Emulator nicht sichtbar sind.

  • HOST-Headless-Sessions. Eine Headless-Session verwendet eine aktive HOST-Headless-Verbindung, um Ihre Mainframe-Applikation über das Fenster Host Scan zu navigieren. Headless-Sessions unterstützen nur den ASCII-Zeichensatz.

Wählen Sie Ihren Anwendungsfall:

Um eine Emulator-Session zu starten, führen Sie diese Schritte aus:

  1. Stellen Sie sicher, dass Ihr Emulator mit einer Session verbunden ist.

  2. Wählen Sie im Menüband des Aufzeichnungsfensters Connection Settings aus.

  3. Wählen Sie in der Dropdown-Liste Connection name die Option Connect to Emulator Session aus.

  4. Wählen Sie Connect aus.

Um eine Headless-Session zu starten, führen Sie diese Schritte aus:

  1. Wählen Sie im Menüband des Aufzeichnungsfensters Connection Settings aus.

  2. Füllen Sie die Einstellungen aus und wählen Sie anschließend Connect aus.

    Die Timeout-Einstellungen definieren die maximal zulässige Zeit in Millisekunden für jegliche Kommunikation zwischen Tosca und dem HOST-Server.

Unterstützung japanischer Zeichen aktivieren

Um die Unterstützung japanischer Zeichen für HOST-Emulator-Sessions zu verwenden, führen Sie diese Schritte aus:

  1. Gehen Sie zu Project->Settings.

  2. Erstellen Sie eine neue Kategorie mit dem Namen Host unter Settings->TBox->Engines.

  3. Erstellen Sie eine neue Einstellung mit dem Namen CodePage und dem Wert 932.

Starten Sie die Aufzeichnung

Um HOST-Module zu erstellen, zeichnen Sie eine aktive und verbundene HOST-Session mit dem Tosca XScan auf.

Klicken Sie dazu mit der rechten Maustaste auf einen Modulordner und wählen Sie Scan->Remote Terminal. Alternativ können Sie das dynamische Menü Modules öffnen und  Scan->Remote Terminal auswählen oder die Tastenkombination Strg + Umschalt + T verwenden.

Controls auswählen

Tosca misst alle Höhen und Breiten von HOST-Controls in Zeichen.

Wenn Sie einen Control-Bereich im Fenster Host Scan auswählen, vermeiden Sie es, Zeichen mit doppelter Breite zu trennen. Ein Zeichen mit doppelter Breite belegt anstelle des Standardzeichens zwei Zeicheneinheiten. Um eine korrekte Aufzeichnung der HOST-Controls zu gewährleisten, ist es wichtig, dies zu beachten. Führen Sie hierzu diese Schritte aus:

  1. Wählen Sie im Menüband des XScan den Typ des Controls aus, das Sie Ihrem Modul hinzufügen möchten: Label, TextBox oder Table.

  2. Erstellen Sie das Control.

    Wählen Sie Ihren Anwendungsfall:

    Markieren Sie für ein Label-Control in der Content Preview die Zeile, in der sich der Text befindet.

    Tosca verwendet automatisch die folgenden Eigenschaften, um Ihr Control zu definieren:

    Eigenschaften

    Beschreibung

    Height

    Gesamthöhe der Tabelle.

    Width

    Gesamtbreite des Labels.

    Column

    Bildschirmposition der ersten Spalte des Labels.

    Row

    Bildschirmposition der ersten Zeile des Labels.

    Markieren Sie für ein HOST TextBox-Control den Inhalt in der Content Preview oder verwenden Sie den Menübandeintrag Search TextBoxes. Stellen Sie sicher, dass die Content Preview dem Bildschirm entspricht, den Sie aufzeichnen möchten. Sie können die Vorschau auf den aktuellen Emulatorbildschirm aktualisieren, indem Sie Refresh auswählen.

    Für Headless-HOST-Sessions können Sie für vertrauliche Daten den Menübandeintrag Input Password verwenden. So können Sie diese Daten in ein separates Feld eingeben, woraufhin diese sicher an den Mainframe gesendet werden, ohne dass Ihre Eingabe auf dem Bildschirm angezeigt wird.

    Tosca verwendet automatisch die folgenden Eigenschaften, um Ihr Control zu definieren:

    Eigenschaften

    Beschreibung

    Height

    Gesamthöhe der Tabelle.

    Width

    Gesamtbreite des Labels.

    Column

    Bildschirmposition der ersten Spalte des Labels.

    Row

    Bildschirmposition der ersten Zeile des Labels.

    Wählen Sie für ein HOST Table-Control im Menüband der Aufzeichnung Area aus. Markieren Sie anschließend den äußeren Bereich Ihrer Table in der Content Preview. Alternativ können Sie den Bereich manuell im Bereich Properties definieren.

    Achten Sie beim Markieren des Tabellenbereichs in der Content Preview darauf, die Spaltengrenzen korrekt zu definieren. Diese Spalten definieren die Eingabefelder Ihrer Module. Daher muss Text, der zu einer Spalte gehört, in den definierten Spaltenbereich passen. Wenn Sie den Ausgangspunkt des Eingabefelds nicht korrekt erfassen, funktioniert der Eingabeschritt in Ihrem Testfall nicht.

    Tosca verwendet automatisch die folgenden Eigenschaften, um Ihr Control zu definieren:

    Eigenschaft

    Beschreibung

    Height

    Gesamthöhe der Tabelle.

    Width

    Gesamtbreite der Tabelle.

    Column

    Bildschirmposition der ersten Spalte der Tabelle.

    Row

    Bildschirmposition der ersten Zeile der Tabelle.

    ColStartList

    Durch Komma getrennte Liste der jeweils ersten Zeichen aller Spalten relativ zu den Koordinaten des Controls. Diese Eigenschaft beginnt immer mit 1.

    HeaderHeight

    Höhe der Kopfzeile, gemessen ab dem oberen Tabellenrand. Der Standardwert ist 0.

    RowHeight

    Gibt die Zeilenhöhe an. Der Standardwert ist 1. Das bedeutet, dass Tosca jede Zeile als Tabellenzeile zählt.

    HeaderRow

    Gibt an, ob die Tabelle eine Kopfzeile hat:

    • -1: Die Tabelle hat keine Kopfzeile.

    • 1: Die Tabelle hat eine Kopfzeile.

    NoScroll

    Gibt an, ob sich die Tabelle über mehrere Bildschirme erstreckt. Der Standardwert ist False.

    ScrollForwardKey

    Gibt die Taste an, mit der Sie in der Tabelle vorwärts scrollen. Der Standardwert ist {F8}.

    ScrollBackwardsKey

    Gibt die Taste an, mit der Sie in der Tabelle rückwärts scrollen. Der Standardwert ist {F7}.

  3. Wiederholen Sie diesen Vorgang, um Ihrem Modul weitere Controls hinzuzufügen.

  4. Wenn Sie HOST aufzeichnen und Controls von einem anderen Bildschirm hinzufügen möchten, empfehlen wir, Finish screen auszuwählen, bevor Sie zum neuen Bildschirm navigieren. Tosca speichert jedes Modul mit einem Screenshot entsprechend der Content Preview, wenn Sie Finish screen auswählen. Wir empfehlen, mit Refresh die Content Preview zu aktualisieren, wenn Sie für verschiedene Bildschirme separate Module erstellen. So bleiben die Screenshots der Module mit den Controls in HOST konsistent und Sie vermeiden spätere Unklarheiten.

  5. Nachdem Sie alle Controls ausgewählt haben, die Sie dem Modul hinzufügen möchten, wählen Sie Finish screen aus. Dadurch speichert das System das Modul in Ihrem Arbeitsbereich. Wählen Sie anschließend Close aus.

Sie können jetzt HOST-Controls steuern, einen Testfall erstellen und dazu HOST-Module aus der Standard-Untermenge verwenden.