Java-Connector-Methoden

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

    • Der Java-Connector stellt Methoden auf Connector-, Bildschirm- und Elementebene bereit. Obwohl alle Arten von Elementen gemeinsame Methoden verwenden, gibt es auch unterschiedliche Methoden.

    Methoden auf Connector-Ebene

    Start

    Startet die Java-Anwendung an ihrem Speicherort und rückt sie in den Fokus.
    Hinweis:
    Sie müssen diese Methode zuerst ausführen.

    Informationen zur Eingabe von Parametern finden Sie unter Porteigenschaften konfigurieren.

    Tabelle : 1. Startmethodenparameter
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch?
    Pfad Pfad zur Java-Anwendung auf dem lokalen Laufwerk. Daten in Zeichenfolge Keine Ja
    Argumente Argumente für den Pfad. Daten in Zeichenfolge Keine Nein

    GetMainWindowHandle abrufen

    Gibt das Fenster-Handle der Java-Anwendung zurück, die mit der Start-Methode gestartet wurde.

    Tabelle : 2. Parameter der GetMainWindowHandle-Methode
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch?
    Zurück Gibt das Fenster-Handle der Anwendung zurück. Daten aus Ganzzahl Keine Nicht zutreffend

    Rufen Sie den Hauptfenstertitel ab

    Gibt den Titel des Java-Anwendungsfensters zurück.

    Tabelle : 3. Parameter der GetMainWindowTitle-Methode
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch?
    Zurück Gibt den Titel des Fensters der Anwendung zurück. Daten aus Zeichenfolge Keine Nicht zutreffend

    Hauptfenster schließen

    Schließt das Hauptfenster der Java-Anwendung.

    Beenden

    Beendet das Hauptfenster der Java-Anwendung.

    Methoden auf Bildschirmebene

    Schließen

    Schließt das aktive Java-Anwendungsfenster.

    Fokus

    Wenn das Java-Anwendungsfenster minimiert ist oder im Hintergrund ausgeführt wird, stellt die -Methode den Fokus wieder her.

    GetFields

    Ruft die Daten aus den Textfeldern in einer Java-Anwendung ab. Sie müssen zuerst die Textfelder konfigurieren. Führen Sie zum Konfigurieren die folgenden Schritte aus.
    1. Konfigurieren Sie den Java-Connector und erfassen Sie ein oder mehrere Textfelder.
    2. Machen Sie die Methoden auf Bildschirmebene verfügbar. Weitere Informationen finden Sie unter Verwenden Sie die Connector-Methode.
    3. Ziehen Sie aus dem Objekt-Explorer die Methode GetFields auf die Designoberfläche.
    4. Klicken Sie auf das Symbol für Methodeneinstellungen (Symbol für Methodeneinstellungen).
    5. Wählen Sie ein oder mehrere Textfelder aus.
    6. Aktualisiert den Datentyp des Textfelds.
    7. Klicken Sie auf OK, um das Fenster „FORMULARELEMENTE AUSWÄHLEN“ zu schließen.

      Für jedes ausgewählte Textfeld wird ein Datenausgangsport erstellt.

    Die GetFields-Methode kann jetzt die in den Textfeldern enthaltenen Daten zurückgeben.

    GetInstanceCount

    Gibt die Gesamtzahl der Instanzen der geöffneten Java-Anwendung zurück.

    Tabelle : 4. Parameter der GetInstanceCount-Methode
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch?
    Zurück Gibt die Gesamtzahl der Instanzen der geöffneten Java-Anwendung zurück. Daten aus Ganzzahl Keine Nicht zutreffend

    GetScreenSshot

    Erfasst den Screenshot des Java-Anwendungsbildschirms und gibt ihn zurück.

    Tabelle : 5. Parameter der GetInstanceCount-Methode
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch?
    Zurück Gibt den Screenshot des Java-Anwendungsbildschirms zurück. Daten aus Bitmap Keine Nicht zutreffend

    GetWindowHandle

    Gibt die Handle-Nummer Windows des Bildschirmfensters der Java-Anwendung zurück.

    Tabelle : 6. Parameter der GetInstanceCount-Methode
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch?
    Zurück Gibt die Handle-Nummer Windows des Bildschirmfensters der Java-Anwendung zurück. Daten aus Ganzzahl Keine Nicht zutreffend

    IstErstellt

    Gibt die boolesche Antwort basierend darauf zurück, ob die Regeln für ein konfiguriertes Fenster übereinstimmen. Wenn Sie einen Java-Anwendungsbildschirm konfigurieren, werden im Abschnitt MATCH RULES des Java Connector-Fensters bestimmte Regeln angezeigt, die dem konfigurierten Bildschirm entsprechen. Die Methode entspricht denselben Regeln.

    Informationen zur Eingabe von Parametern finden Sie unter Porteigenschaften konfigurieren.

    Tabelle : 7. Parameter der IsCreated-Methode
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch? Notizen
    AlleUntergeordnetenAbgleichen Gibt die boolesche Antwort zurück, nachdem die Regeln der Elemente des Bildschirms abgeglichen wurden. Daten in Boolean Keine Nein Dieser Parameter ist relevant, wenn Sie ein oder mehrere Elemente erfassen.
    Zurück Gibt die boolesche Antwort darauf zurück, ob die Regeln des von Ihnen konfigurierten Java-Anwendungsbildschirms übereinstimmen. Daten aus Boolean NULL Nicht zutreffend

    Maximieren

    Maximiert das Java-Anwendungsfenster.

    Minimieren

    Minimiert das Java-Anwendungsfenster.

    Mausaktion

    Führt verschiedene Mausgeräteaktionen in der Java-Anwendung aus, z. B. Linksklick, Rechtsklick und Mittelklick.

    Informationen zur Eingabe von Parametern finden Sie unter Porteigenschaften konfigurieren.

    Tabelle : 8. Parameter der MouseAction-Methode
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch?
    Aktion Gibt die Mausgeräteaktion an. Daten in Mausgeräteeingabe Keine Ja
    Klicken Sie auf Mitte Ob ein Klick mit der mittleren Maustaste ausgeführt wird. Daten in Boolean Keine Nein

    Größe ändern

    Ändert die Breite, Höhe und Position des Java-Anwendungsfensters entlang der X- und Y-Achse.

    Informationen zur Eingabe von Parametern finden Sie unter Porteigenschaften konfigurieren.

    Tabelle : 9. Ändern Sie die Größe der Methodenparameter
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch?
    xPos Position des Fensters auf dem Bildschirm entlang der X-Achse. Daten in Ganzzahl Keine Nein
    yPos Position des Fensters auf dem Bildschirm entlang der Y-Achse. Daten in Ganzzahl Keine Nein
    Breite Breite des Fensters. Daten in Ganzzahl Keine Nein
    Höhe Höhe des Fensters. Daten in Ganzzahl Keine Nein

    Wiederherstellung

    Stellt die ursprünglichen Abmessungen des Java-Anwendungsfensters wieder her. Sie können die -Methode verwenden, nachdem Sie Methoden wie Maximieren und Minimieren ausgeführt haben.

    SendKeys

    Senden Sie Daten oder Tastatureingaben an das aktive Feld in der Java-Anwendung. Sie können beispielsweise Zeichenfolgendaten „RPA“ oder eine Tastatureingabe [Leertaste] senden, um ein Kontrollkästchen zu deaktivieren.

    Informationen zur Eingabe von Parametern finden Sie unter Porteigenschaften konfigurieren.

    Tabelle : 10. Parameter der Methode „WaitForCreate“.
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch?
    Schlüssel Sendet die Daten- oder Tastatureingabe an das aktive Feld. Daten in Zeichenfolge Keine Ja
    ClearExistingValue Vor dem Senden von Daten oder Tastatureingaben löscht alle vorhandenen Werte im Feld „Aktiv“. Daten in Boolean Keine Nein
    TypeDelay Legt eine Verzögerung fest, bevor Daten oder Tastatureingaben an das aktive Feld gesendet werden. Daten in Ganzzahl Keine Nein

    Felder festlegen

    Legen Sie anwenderdefinierten Text in den Textfeldelementen fest, die im Java-Anwendungsbildschirm erfasst wurden.

    Um die Methode zu verwenden, führen Sie die folgenden Schritte aus.
    1. Ziehen Sie die SetFields-Methode aus dem Objekt-Explorer auf die Designoberfläche.
    2. Klicken Sie auf das Symbol für Methodeneinstellungen (Symbol für Methodeneinstellungen).
    3. Wählen Sie ein oder mehrere Textfelder aus.
    4. Aktualisiert den Datentyp des Textfelds.
    5. Klicken Sie auf OK.

      Für jedes ausgewählte Textfeld wird ein Dateneingangsport erstellt. Sie können die in den Feldern der Java-Anwendung festzulegende Zeichenfolge übergeben.

      Informationen zur Eingabe von Parametern finden Sie unter Porteigenschaften konfigurieren.

    WartenAufErstellen

    Jeder Bildschirm, den Sie im Java-Connector konfigurieren, wird durch bestimmte Regeln identifiziert, die im Abschnitt MATCH RULES des Java-Connector-Fensters angezeigt werden. Die Methode gibt eine boolesche Antwort basierend darauf zurück, ob die Regeln des von Ihnen konfigurierten Bildschirms übereinstimmen.

    Informationen zur Eingabe von Parametern finden Sie unter Porteigenschaften konfigurieren.

    Tabelle : 11. Parameter der Methode „WaitForCreate“.
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch?
    timeoutinSekunden Zeit, nach der der Vorgang der Methode abläuft. Daten in Ganzzahl Keine Nein
    AlleUntergeordnetenAbgleichen Gibt die boolesche Antwort zurück, nachdem die Regeln der Elemente des Bildschirms abgeglichen wurden. Daten in Boolean Keine Nein
    Zurück Gibt die boolesche Antwort darauf zurück, ob die Regeln des von Ihnen konfigurierten Java-Anwendungsbildschirms übereinstimmen. Daten aus Boolean Keine Nein

    Methoden auf Elementebene

    GetAccessibleActions

    Gibt die Liste der Aktionen zurück, die Sie für ein Element ausführen können. Für eine Schaltfläche wird beispielsweise Clickzurückgegeben.
    Tabelle : 12. Parameter der GetText-Methode
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch?
    Zurück Gibt die Liste der Aktionen zurück, die Sie für ein Element ausführen können. Daten aus Liste Keine Nicht zutreffend

    GetInstanceCount

    Gibt die Gesamtanzahl eines Elementtyps in der Java-Anwendung zurück. Wenn beispielsweise drei Textfelder in einer Anwendung vorhanden sind, beträgt die Anzahl der Instanzen 3.

    Tabelle : 13. Parameter der GetText-Methode
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch?
    Zurück Gibt die Instanzanzahl eines Elementtyps in der Anwendung zurück. Daten aus Ganzzahl Keine Nicht zutreffend

    GetText

    Gibt den Text aus dem erfassten Textfeldelement in der Java-Anwendung zurück. Um mehrere Texte aus mehreren Textfeldern zu erfassen, müssen Sie mehrere Textfeldelemente konfigurieren.

    Tabelle : 14. Parameter der GetText-Methode
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch?
    Text Gibt den Text zurück, der im Textfeld der Java-Anwendung enthalten ist. Daten aus Zeichenfolge Keine Nicht zutreffend

    IstErstellt

    Gibt die boolesche Antwort in Abhängigkeit davon zurück, ob die Regeln des von Ihnen konfigurierten Elements übereinstimmen.

    Tabelle : 15. Parameter der IsCreated-Methode
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch?
    Zurück Gibt die boolesche Antwort in Abhängigkeit davon zurück, ob die Regeln des von Ihnen konfigurierten Elements übereinstimmen. Daten aus Boolean Null Nicht zutreffend

    Mausklick

    Klickt mit der linken Maustaste auf das erfasste Element.

    AusführenAktion

    Führt die angegebene Aktion für ein Element aus. Klicken Sie beispielsweise auf eine Schaltfläche. Jedes Element lässt eine Reihe von Aktionen zu, die Sie durch Ausführen der GetAccessibleActions-Methode abrufen können.

    Informationen zur Eingabe von Parametern finden Sie unter Porteigenschaften konfigurieren.

    Tabelle : 16. Parameter der IsCreated-Methode
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch? Notizen
    Aktion Akzeptiert die Aktion, die für das Element ausgeführt werden soll. Daten in Zeichenfolge Keine Ja

    Sie müssen die Aktion genau in dem Format angeben, das von der GetAccessibleActions-Methode angegeben wird.
    Zurück Gibt „Wahr“ zurück, wenn die Aktion ausgeführt wurde, andernfalls „Falsch“. Daten aus Boolean Keine Nicht zutreffend

    Passwortfestlegen

    Automatisieren Sie die sichere Eingabe von Passwörtern im Passwortfeld einer Java-Anwendung.

    Eingaben für die Felder finden Sie unter Porteigenschaften konfigurieren.
    Tabelle : 17. Parameter der SetPassword-Methode
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch? Notizen
    Passwort Akzeptiert das Passwort als gesicherte Zeichenfolge. Dateneingang Gesicherte Zeichenfolge Keine Ja Da das Passwort als gesicherte Zeichenfolge akzeptiert wird, wird die Länge der Zeichenfolge nur angezeigt, wenn Sie mit der rechten Maustaste auf den Parameter klicken und dann auf Vorschaudatenklicken.
    VerwendenSendKeys SendKeys ist eine Methode zum Senden von Tastatureingaben wie Zeichen, Ziffern und Symbole an Textfelder in einer Anwendung. Dateneingang Boolean Falsch Ja
    Tipp:
    Wenn die Methode SetPassword das Passwort nicht in das Passwortfeld eingibt, legen Sie den Wert auf true fest, und führen Sie die Methode erneut aus.