Methods des Robot BlueZone-Emulators

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 6 Minuten Lesedauer

    • Verwenden Sie die Emulatormethoden von Miss BlueZone, um verschiedene Automatisierungsaufgaben im Emulator von Robot BlueZone auszuführen.

    Methoden auf Bildschirmebene

    Verwenden Sie Methoden auf Bildschirmebene, um die Automatisierungsaufgaben auf dem Emulatorbildschirm auszuführen. Sie können beispielsweise einen Befehl auf dem Bildschirm simulieren oder Text aus dem Bildschirm abrufen.

    GetFieldText

    Gibt den Text zurück, den ein Feld enthält, nachdem das Feld anhand der von Ihnen angegebenen Zeilen- und Spaltennummer identifiziert wurde. Die von Ihnen angegebene Zeile und Spalte sind der Ausgangspunkt des Felds. Die -Methode identifiziert das gesamte Feld und gibt dann den Text im Feld zurück. Im folgenden Beispiel ist H der erste Buchstabe und der Startpunkt im Feld, und Host-BS : ist der vollständige Text im Feld.

    Bildschirm, der den ersten Buchstaben im Feld und den vollständigen Text im Feld anzeigt.

    Die GetFieldText-Methode mit ihren Parametern.

    Tabelle : 1. Parameter der GetFieldText-Methode
    Parameter Beschreibung Datenport-Eintragstyp Datentyp Standardwert Obligatorisch Notizen
    Zeile Feldzeilennummer, die das Feld identifiziert. Dateneingang Ganzzahl NA Ja
    Spalte Feldspaltennummer, die das Feld identifiziert. Dateneingang Ganzzahl NA Ja
    Zurück Gibt den Text im Feld zurück. Daten aus Zeichenfolge NA NA

    GetTextFromRect

    Gibt den Text in allen Feldern eines rechteckigen Bereichs zurück, den Sie auf dem Bildschirm definieren. Sie definieren einen Bereich, indem Sie die Nummern der Start- und Endzeilen und -spalten angeben. Die Methode sucht und identifiziert das erste und das letzte Feld und gibt den gesamten Text in allen Feldern innerhalb dieses Bereichs zurück. Das folgende Beispiel zeigt den von Ihnen definierten Bereich.

    Bereich, den Sie so definiert haben, dass die erste Zelle des ersten Felds und die letzte Zelle des letzten Felds angezeigt werden.

    Abbildung der GetTextFromRect-Methode.

    Tabelle : 2. Parameter der GetTextFromRect-Methode
    Parameter Beschreibung Datenport-Eintragstyp Datentyp Standardwert Obligatorisch Notizen
    StartRow Zeilennummer, die das erste Zeichen des ersten Felds im rechteckigen Bereich angibt. Dateneingang Ganzzahl NA Ja
    Startspalte Spaltennummer, die das erste Zeichen des ersten Felds im rechteckigen Bereich enthält. Dateneingang Ganzzahl NA Ja
    EndRow Zeilennummer, die das letzte Zeichen des letzten Felds im rechteckigen Bereich enthält. Dateneingang Ganzzahl NA Ja
    Endspalte Spaltennummer, die das letzte Zeichen des letzten Felds im rechteckigen Bereich enthält. Dateneingang Ganzzahl NA Ja
    Zurück Gibt den Text aus allen Feldern innerhalb des rechteckigen Bereichs zurück. Daten aus Zeichenfolge NA NA

    IstErstellt

    Überprüft, ob der Emulatorbildschirm basierend auf der Bildschirmübereinstimmungsregel vorhanden ist und Eingaben vom Anwender akzeptieren kann. Nach der Überprüfung gibt die Methode den entsprechenden booleschen Wert zurück.

    Methode „IsCreated“.

    Tabelle : 3. Parameter der IsCreated-Methode
    Parameter Beschreibung Datenport-Eintragstyp Datentyp Standardwert Obligatorisch Notizen
    AlleUntergeordnetenAbgleichen Option, um den Emulatorbildschirm durch Abgleichen der von Ihnen erfassten untergeordneten Elemente zu finden. Dateneingang Boolean Falsch Ja
    Warnung:
    Die Verwendung dieser Option kann die -Methode verlangsamen.
    Zurück Gibt den booleschen Wert zurück, abhängig davon, ob der Emulatorbildschirm basierend auf der Bildschirmübereinstimmungsregel vorhanden ist und Eingaben vom Anwender akzeptieren kann. Daten aus Boolean NA NA

    SearchText

    Gibt die Nummern der Zeile und Spalte zurück, die das erste Zeichen des von Ihnen angegebenen Texts enthalten. Wenn Sie beispielsweise den Zeichenfolgenemulator angeben, gibt die Methode die Zeilen- und Spaltennummern des Startpunkts des Wortemulatorszurück, der eist.
    Hinweis:
    Wenn Sie den Text angeben, der mehrere Felder umfasst, geben die Zeilen- und Spaltenports 0 zurück, da die Methode nur den Text aus einem einzelnen Feld unterstützt.
    SearchText-Methode.
    Tabelle : 4. Parameter der SearchText-Methode
    Parameter Beschreibung Datenport-Eintragstyp Datentyp Standardwert Obligatorisch Notizen
    Text Text, den die Methode durchsucht. Dateneingang Zeichenfolge NA Ja Bei dem von Ihnen angegebenen Text kann je nach verwendetem Emulator Groß-/Kleinschreibung beachtet werden.
    Zeile Zeilennummer, die das erste Zeichen des von Ihnen angegebenen Texts enthält. Daten aus Ganzzahl NA NA Wenn der von Ihnen angegebene Text in mehreren Zeilen und Spalten vorkommt, gibt die Methode die erste Zeile und Spalte zurück, die den Text enthält.
    Spalte Spaltennummer, die das erste Zeichen des von Ihnen angegebenen Texts enthält. Daten aus Ganzzahl NA NA Wenn der von Ihnen angegebene Text in mehreren Zeilen und Spalten vorkommt, gibt die Methode die erste Zeile und Spalte zurück, die den Text enthält.

    SendKeys

    Simuliert die Tastenanschläge, die Sie über die Tastatur an der Mausgeräteposition auf dem Emulatorbildschirm eingeben. Sie können beispielsweise das simulieren<enter> Tastenanschlag auf dem Bildschirm.

    SendKeys-Methode

    Tabelle : 5. Parameter der SendKeys-Methode
    Parameter Beschreibung Datenport-Eintragstyp Datentyp Standardwert Obligatorisch Notizen
    Schlüssel Tastenanschläge, die Sie über Ihre Tastatur eingeben. Dateneingang Zeichenfolge Keine Ja
    Tipp:
    Weitere Informationen zu den Tastenanschlägen finden Sie in der jeweiligen Terminalemulatordokumentation.

    SendKeys Secure

    Simuliert die Tastenanschläge, die eine gesicherte Zeichenfolge an der Mausgeräteposition auf dem Emulatorbildschirm sind.

    SendKeysSecure-Methode

    Tabelle : 6. Parameter der SendKeysSecure-Methode
    Parameter Beschreibung Datenport-Eintragstyp Datentyp Standardwert Obligatorisch Notizen
    Schlüssel Tastenanschläge, die Sie als gesicherte Zeichenfolge eingeben. Dateneingang Gesicherte Zeichenfolge Keine Ja
    Tipp:
    Weitere Informationen zu den Tastenanschlägen finden Sie in der jeweiligen Terminalemulatordokumentation.

    CursorPosition festlegen

    Versucht, das Mausgerät auf die von Ihnen angegebene Zeilen- und Spaltennummer festzulegen.

    SetCursorPosition-Methode.

    Tabelle : 7. Parameter der SetCursorPosition-Methode
    Parameter Beschreibung Datenport-Eintragstyp Datentyp Standardwert Obligatorisch Notizen
    Zeile Option zur Angabe der Nummer der Zeile, auf deren Grundlage die Methode versucht, das Mausgerät auf dem Bildschirm festzulegen. Dateneingang Ganzzahl NA NA Die Zeilennummer muss positiv sein und innerhalb der Größe des Emulatorbildschirms liegen. Wenn die Bildschirmgröße beispielsweise 24 x 80 beträgt, können Sie für eine Zeile maximal einen Wert von 24 angeben.
    Spalte Option zur Angabe der Nummer der Zeile, auf deren Grundlage die Methode versucht, das Mausgerät auf dem Bildschirm festzulegen. Dateneingang Ganzzahl NA NA Die Spaltennummer muss positiv sein und innerhalb der Größe des Emulatorbildschirms liegen. Wenn die Bildschirmgröße beispielsweise 24 x 80 beträgt, können Sie für eine Spalte maximal einen Wert von 80 angeben.

    WartenAufErstellen

    Wartet die von Ihnen angegebene Dauer, während der Connector mithilfe der Bildschirm-Übereinstimmungsregel ermittelt, ob der Bildschirm vorhanden ist.

    Methode „WaitForCreate“

    Tabelle : 8. Parameter der Methode „WaitForCreate“.
    Parameter Beschreibung Datenport-Eintragstyp Datentyp Standardwert Obligatorisch Notizen
    timeoutinSekunden Option zur Angabe der Anzahl der Sekunden, für die die Methode wartet, während der Connector die Bildschirmübereinstimmungsregel verwendet, um zu ermitteln, ob der Bildschirm vorhanden ist. Dateneingang Ganzzahl 30 Ja
    AlleUntergeordnetenAbgleichen Option zum Abgleichen aller Bildschirmelemente, die Sie erfasst haben, um festzustellen, ob der Bildschirm vorhanden ist. Dateneingang Boolean Falsch Ja
    Warnung:
    Die Verwendung dieser Option kann die Ausführung der Methode verzögern.
    Zurück Gibt den booleschen Wert zurück, je nachdem, ob der Emulatorbildschirm gefunden wurde. Daten aus Boolean NA NA

    Methoden auf Elementebene

    Methoden auf Elementebene führen Automatisierungsaufgaben für die Emulator-Bildschirmelemente aus, die Sie über den Bildschirm Terminal-Connector hinzufügen. Sie können ein Bildschirmelement als Feld oder Tabelle hinzufügen.

    GetAlsTable

    Gibt den Text zurück, den Sie als Datentabellenobjekt erfasst haben. Verwenden Sie diese Methode, wenn Sie die Daten aus einem Bildschirm als Tabelle erfassen. Sie können die -Methode jedoch auch für die Daten verwenden, die Sie als Feld erfassen. Informationen zum Erfassen der Daten als Tabelle finden Sie unter Konfigurieren Sie den Personal Communications-Emulator IBM ..

    GetAsTable-Methode.

    Tabelle : 9. Parameter der GetAsTable-Methode
    Parameter Beschreibung Datenport-Eintragstyp Datentyp Standardwert Obligatorisch Notizen
    Zurück Gibt den erfassten Text vom Terminalbildschirm als Datentabellenobjekt zurück. Daten aus Datentabelle NA NA Um die Tabelle anzuzeigen, klicken Sie mit der rechten Maustaste auf den Parameter, und wählen Sie Vorschaudatenaus.

    GetText

    Gibt den Text in dem Feld zurück, das Sie im Emulatorbildschirm erfasst haben. Wenn Sie diese Methode für eine von Ihnen erfasste Tabelle verwenden, wird der Text im ersten Feld des Rechtecks zurückgegeben.

    GetText-Methode.

    Tabelle : 10. Parameter der GetText-Methode
    Parameter Beschreibung Datenport-Eintragstyp Datentyp Standardwert Obligatorisch? Notizen
    Zurück Gibt den Text aus dem erfassten Feld zurück. Daten aus Zeichenfolge NA NA

    IstErstellt

    Entspricht den Regeln und überprüft, ob das erfasste Element vorhanden ist.

    Methode „IsCreated“.

    Tabelle : 11. Parameter der IsCreated-Methode
    Parameter Beschreibung Datenport-Eintragstyp Datentyp Standardwert Obligatorisch Notizen
    Zurück Gibt den booleschen Wert basierend darauf zurück, ob das Element aktiv ist. Daten aus Boolean NA NA

    Text festlegen

    Versucht, den Text auf das Feld festzulegen.

    SetText-Methode.

    Tabelle : 12. Parameter der SetText-Methode
    Parameter Beschreibung Datenport-Eintragstyp Datentyp Standardwert Obligatorisch Notizen
    Text Option zum Angeben des Texts, den die Methode im Feld festzulegen versucht. Dateneingang Zeichenfolge NA Ja Sie können diese Methode nicht auf geschützten Emulatorbildschirmen verwenden.

    WartenAufErstellen

    Wartet die von Ihnen angegebene Dauer, während der Connector mithilfe der Übereinstimmungsregel ermittelt, ob das Element vorhanden ist.

    Methode „WaitForCreate“

    Tabelle : 13. Parameter der Methode „WaitForCreate“.
    Parameter Beschreibung Datenport-Eintragstyp Datentyp Standardwert Obligatorisch Notizen
    timeoutinSekunden Option zur Angabe der Anzahl der Sekunden, während der Methode wartet, während der Connector die Übereinstimmungsregel verwendet, um herauszufinden, ob das Element vorhanden ist. Dateneingang Ganzzahl 30 Ja
    Zurück Gibt den booleschen Wert zurück, je nachdem, ob das Element gefunden wurde. Daten aus Boolean NA NA