Java-Connector-Methoden

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 7 Minuten Lesedauer

    • Der Java-Connector macht Methoden auf Connector-, Bildschirm- und Elementebene verfügbar. Alle Arten von Elementen haben zwar gemeinsame Methoden, aber auch unterschiedliche Methoden.

    Methoden auf Connector-Ebene

    Start

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

    Informationen zur Eingabe von Parametern finden Sie unter Konfigurieren Sie Porteigenschaften.

    Tabelle : 1. Startmethodenparameter
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch? Notizen
    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

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

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

    Rufen Sie MainWindowTitle ab

    Gibt den Titel des Java-Anwendungsfensters zurück.

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

    CloseMainWindow

    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 wird 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 der folgenden Schritte aus.
    1. Konfigurieren Sie den Java-Connector und erfassen 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 die GetFields-Methode aus dem Objekt-Explorer 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. Aktualisieren Sie den Datentyp des Textfelds.
    7. Um das Fenster FORMULARELEMENTE AUSWÄHLEN zu schließen, klicken Sie auf OK.

      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 geöffneten Instanzen der Java-Anwendung zurück.

    Tabelle : 4. Parameter der GetInstanceCount-Methode
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch? Notizen
    Zurück Gibt die Gesamtzahl der geöffneten Instanzen der Java-Anwendung zurück. Datenausgabe 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? Notizen
    Zurück Gibt den Screenshot des Java-Anwendungsbildschirms zurück. Datenausgabe Bitmap Keine Nicht zutreffend

    GetWindowHandle

    Gibt die Handle-Nummer Windows des Java-Anwendungsbildschirmfensters zurück.

    Tabelle : 6. Parameter der GetInstanceCount-Methode
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch? Notizen
    Zurück Gibt die Handle-Nummer Windows des Java-Anwendungsbildschirmfensters zurück. Datenausgabe 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 „Übereinstimmungsregeln“ 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 Konfigurieren Sie Porteigenschaften.

    Tabelle : 7. IsCreated-Methodenparameter
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch? Notizen
    AlleUntergeordneten abgleichen 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 zurück, ob die Regeln des von Ihnen konfigurierten Java-Anwendungsbildschirms übereinstimmen. Datenausgabe Boolean NULL Nicht zutreffend

    Maximieren

    Maximiert das Java-Anwendungsfenster.

    Minimieren

    Minimiert das Java-Anwendungsfenster.

    MouseAction

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

    Informationen zur Eingabe von Parametern finden Sie unter Konfigurieren Sie Porteigenschaften.

    Tabelle : 8. Parameter der MouseAction-Methode
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch? Notizen
    Aktion Gibt die Aktion des Mausgeräts an. Daten in Mausgeräteingabe Keine Ja
    Klicken Sie auf Mitte Ob ein Mittelklick 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 Konfigurieren Sie Porteigenschaften.

    Tabelle : 9. Ändern Sie die Größe der Methodenparameter
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch? Notizen
    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 Konfigurieren Sie Porteigenschaften.

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

    Felder festlegen

    Legen Sie benutzerdefinierten Text in den Textfeldelementen fest, die auf dem Java-Anwendungsbildschirm erfasst wurden.

    Führen Sie die folgenden Schritte aus, um die Methode zu verwenden.
    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. Aktualisieren Sie den Datentyp des Textfelds.
    5. Klicken Sie auf OK.

      Für jedes Textfeld, das Sie auswählen, 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 Konfigurieren Sie Porteigenschaften.

    WartenAufErstellen

    Jeder Bildschirm, den Sie im Java-Connector konfigurieren, wird durch einige Regeln identifiziert, die im Abschnitt „Übereinstimmungsregeln“ 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 Konfigurieren Sie Porteigenschaften.

    Tabelle : 11. Parameter der WaitForCreate-Methode
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch? Notizen
    ZeitüberschreitunginSekunden Zeit, nach der der Vorgang der Methode abläuft. Daten in Ganzzahl Keine Nein
    AlleUntergeordneten abgleichen 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 zurück, ob die Regeln des von Ihnen konfigurierten Java-Anwendungsbildschirms übereinstimmen. Datenausgabe 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 Klickenzurückgegeben.
    Tabelle : 12. GetText-Methodenparameter
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch? Notizen
    Zurück Gibt die Liste der Aktionen zurück, die Sie für ein Element ausführen können. Datenausgabe 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 Instanzanzahl 3.

    Tabelle : 13. GetText-Methodenparameter
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch? Notizen
    Zurück Gibt die Instanzanzahl eines Elementtyps in der Anwendung zurück. Datenausgabe 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. GetText-Methodenparameter
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch? Notizen
    Text Gibt den im Textfeld der Java-Anwendung enthaltenen Text zurück. Datenausgabe Zeichenfolge Keine Nicht zutreffend

    IstErstellt

    Gibt die boolesche Antwort zurück, je nachdem, ob die Regeln des konfigurierten Elements übereinstimmen.

    Tabelle : 15. IsCreated-Methodenparameter
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch? Notizen
    Zurück Gibt die boolesche Antwort zurück, je nachdem, ob die Regeln des konfigurierten Elements übereinstimmen. Datenausgabe Boolean Null Nicht zutreffend

    Mausklick

    Führt einen linken Mausklick auf das erfasste Element aus.

    PerformAction

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

    Informationen zur Eingabe von Parametern finden Sie unter Konfigurieren Sie Porteigenschaften.

    Tabelle : 16. IsCreated-Methodenparameter
    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 „True“ zurück, wenn die Aktion ausgeführt wurde, andernfalls „False“. Datenausgabe Boolean Keine Nicht zutreffend

    Passwort festlegen

    Automatisieren Sie die sichere Passworteingabe im Passwortfeld einer Java-Anwendung.

    Informationen zum Bereitstellen von Eingaben für die Felder finden Sie unter Konfigurieren Sie Porteigenschaften.
    Tabelle : 17. SetPassword-Methodenparameter
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Obligatorisch? Notizen
    Passwort Akzeptiert das Passwort als gesicherte Zeichenfolge. Daten ein 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, Zahlen und Symbolen an Textfelder in einer Anwendung. Daten ein Boolean Falsch Ja
    Tipp:
    Wenn die SetPassword- Methode das Passwort nicht in das Passwortfeld eingibt, legen Sie den Wert auf True fest, und führen Sie die Methode erneut aus.