--- sourceDocument: Xanadu: Integrationen mit Anwendungen erstellen sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/integrate-applications Release : - xanadu ft:locale : - de-DE ft:publication_title : - Xanadu: Integrationen mit Anwendungen erstellen ft:clusterId : - crint bundleId : - crint workflow : - Creator --- # Java-Connector-Methoden # Java-Connector-Methoden {#ariaid-title1} * Freigeben Version: Xanadu * * Aktualisiert 1. August 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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 {#java-connector-methods__section_qbh_klh_ntb} ## Start {#java-connector-methods__section_sk4_cxh_ntb} 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](https://servicenow-prod.fluidtopics.net/inkwzmXhYoxpYR_STKUQmA "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in RPA Desktop Design Studioübergeben werden."). {#java-connector-methods__table_vbt_5zy_mtb__entry__6} | 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 | [Tabelle : 1. Startmethodenparameter] {#java-connector-methods__table_vbt_5zy_mtb} ## GetMainWindowHandle abrufen {#java-connector-methods__section_xwq_jyh_ntb} Gibt das Fenster-Handle der Java-Anwendung zurück, die mit der Start-Methode gestartet wurde. {#java-connector-methods__table_rqj_tyh_ntb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Obligatorisch? | |-|-|-|-|-|-| | Zurück | Gibt das Fenster-Handle der Anwendung zurück. | Daten aus | Ganzzahl | Keine | Nicht zutreffend | [Tabelle : 2. Parameter der GetMainWindowHandle-Methode] {#java-connector-methods__table_rqj_tyh_ntb} ## Rufen Sie den Hauptfenstertitel ab {#java-connector-methods__section_idb_rc3_ntb} Gibt den Titel des Java-Anwendungsfensters zurück. {#java-connector-methods__table_hcn_vc3_ntb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Obligatorisch? | |-|-|-|-|-|-| | Zurück | Gibt den Titel des Fensters der Anwendung zurück. | Daten aus | Zeichenfolge | Keine | Nicht zutreffend | [Tabelle : 3. Parameter der GetMainWindowTitle-Methode] {#java-connector-methods__table_hcn_vc3_ntb} ## Hauptfenster schließen {#java-connector-methods__section_imk_qlh_ntb} Schließt das Hauptfenster der Java-Anwendung. ## Beenden {#java-connector-methods__section_s1s_dd3_ntb} Beendet das Hauptfenster der Java-Anwendung. ## Methoden auf Bildschirmebene {#java-connector-methods__section_crj_pq3_ntb} ## Schließen {#java-connector-methods__section_cl5_5q3_ntb} Schließt das aktive Java-Anwendungsfenster. ## Fokus {#java-connector-methods__section_vvv_vq3_ntb} Wenn das Java-Anwendungsfenster minimiert ist oder im Hintergrund ausgeführt wird, stellt die -Methode den Fokus wieder her. ## GetFields {#java-connector-methods__section_b2r_dr3_ntb} 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](https://servicenow-prod.fluidtopics.net/5qHcyyO8dW201fmtmOB51Q "Konfigurieren Sie den Java-Connector, um die Java-Anwendungsbildschirme und -elemente einzurichten, für die die Automatisierung ausgeführt wird. Nach dem Setup von können Sie Methoden auf Connector-, Bildschirm- und Elementebene verfügbar machen.") 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](https://servicenow-prod.fluidtopics.net/jd1PPZSyXo7GKGzXpVQF4g "Machen Sie die Methoden in einem Connector verfügbar, und verwenden Sie dann, um alle Aktionen auszuführen, die der Connector ausführen kann."). 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. {#java-connector-methods__ol_p5d_2jn_ntb} Die GetFields-Methode kann jetzt die in den Textfeldern enthaltenen Daten zurückgeben. ## GetInstanceCount {#java-connector-methods__section_awc_xmn_ntb} Gibt die Gesamtzahl der Instanzen der geöffneten Java-Anwendung zurück. {#java-connector-methods__table_wmd_knn_ntb__entry__6} | 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 | [Tabelle : 4. Parameter der GetInstanceCount-Methode] {#java-connector-methods__table_wmd_knn_ntb} ## GetScreenSshot {#java-connector-methods__section_yqf_snn_ntb} Erfasst den Screenshot des Java-Anwendungsbildschirms und gibt ihn zurück. {#java-connector-methods__table_ex3_14n_ntb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Obligatorisch? | |-|-|-|-|-|-| | Zurück | Gibt den Screenshot des Java-Anwendungsbildschirms zurück. | Daten aus | Bitmap | Keine | Nicht zutreffend | [Tabelle : 5. Parameter der GetInstanceCount-Methode] {#java-connector-methods__table_ex3_14n_ntb} ## GetWindowHandle {#java-connector-methods__section_vbl_24n_ntb} Gibt die Handle-Nummer Windows des Bildschirmfensters der Java-Anwendung zurück. {#java-connector-methods__table_lqh_k4n_ntb__entry__6} | 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 | [Tabelle : 6. Parameter der GetInstanceCount-Methode] {#java-connector-methods__table_lqh_k4n_ntb} ## IstErstellt {#java-connector-methods__section_r2p_n4n_ntb} 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](https://servicenow-prod.fluidtopics.net/inkwzmXhYoxpYR_STKUQmA "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in RPA Desktop Design Studioübergeben werden."). {#java-connector-methods__table_fyl_4rn_ntb__entry__7} | 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 | | [Tabelle : 7. Parameter der IsCreated-Methode] {#java-connector-methods__table_fyl_4rn_ntb} ## Maximieren {#java-connector-methods__section_m22_hsn_ntb} Maximiert das Java-Anwendungsfenster. ## Minimieren {#java-connector-methods__section_utg_3sn_ntb} Minimiert das Java-Anwendungsfenster. ## Mausaktion {#java-connector-methods__section_tyh_zsn_ntb} 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](https://servicenow-prod.fluidtopics.net/inkwzmXhYoxpYR_STKUQmA "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in RPA Desktop Design Studioübergeben werden."). {#java-connector-methods__table_o2h_pbj_4tb__entry__6} | 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 | [Tabelle : 8. Parameter der MouseAction-Methode] {#java-connector-methods__table_o2h_pbj_4tb} ## Größe ändern {#java-connector-methods__section_wkg_xtn_ntb} Ä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](https://servicenow-prod.fluidtopics.net/inkwzmXhYoxpYR_STKUQmA "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in RPA Desktop Design Studioübergeben werden."). {#java-connector-methods__table_c1j_g5n_ntb__entry__6} | 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 | [Tabelle : 9. Ändern Sie die Größe der Methodenparameter] {#java-connector-methods__table_c1j_g5n_ntb} ## Wiederherstellung {#java-connector-methods__section_gxy_czn_ntb} 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 {#java-connector-methods__section_ggj_qzn_ntb} 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](https://servicenow-prod.fluidtopics.net/inkwzmXhYoxpYR_STKUQmA "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in RPA Desktop Design Studioübergeben werden."). {#java-connector-methods__table_jsm_rdj_4tb__entry__6} | 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 | [Tabelle : 10. Parameter der Methode „WaitForCreate".] {#java-connector-methods__table_jsm_rdj_4tb} ## Felder festlegen {#java-connector-methods__section_pbn_t14_ntb} 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](https://servicenow-prod.fluidtopics.net/inkwzmXhYoxpYR_STKUQmA "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in RPA Desktop Design Studioübergeben werden."). {#java-connector-methods__ol_fhp_db4_ntb} ## WartenAufErstellen {#java-connector-methods__section_wjj_xb4_ntb} 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](https://servicenow-prod.fluidtopics.net/inkwzmXhYoxpYR_STKUQmA "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in RPA Desktop Design Studioübergeben werden."). {#java-connector-methods__table_tyw_hc4_ntb__entry__6} | 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 | [Tabelle : 11. Parameter der Methode „WaitForCreate".] {#java-connector-methods__table_tyw_hc4_ntb} ## Methoden auf Elementebene {#java-connector-methods__section_rmv_rtp_ntb} ## GetAccessibleActions {#java-connector-methods__section_zpq_t1c_4tb} 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. {#java-connector-methods__table_t5k_thj_4tb__entry__6} | 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 | [Tabelle : 12. Parameter der GetText-Methode] {#java-connector-methods__table_t5k_thj_4tb} ## GetInstanceCount {#java-connector-methods__section_yzx_mbc_4tb} 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. {#java-connector-methods__table_bxd_v3j_4tb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Obligatorisch? | |-|-|-|-|-|-| | Zurück | Gibt die Instanzanzahl eines Elementtyps in der Anwendung zurück. | Daten aus | Ganzzahl | Keine | Nicht zutreffend | [Tabelle : 13. Parameter der GetText-Methode] {#java-connector-methods__table_bxd_v3j_4tb} ## GetText {#java-connector-methods__section_k14_kcc_4tb} 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. {#java-connector-methods__table_akh_pcc_4tb__entry__6} | 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 | [Tabelle : 14. Parameter der GetText-Methode] {#java-connector-methods__table_akh_pcc_4tb} ## IstErstellt {#java-connector-methods__section_qbp_dlc_4tb} Gibt die boolesche Antwort in Abhängigkeit davon zurück, ob die Regeln des von Ihnen konfigurierten Elements übereinstimmen. {#java-connector-methods__table_xzk_lmc_4tb__entry__6} | 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 | [Tabelle : 15. Parameter der IsCreated-Methode] {#java-connector-methods__table_xzk_lmc_4tb} ## Mausklick {#java-connector-methods__section_zf2_yvc_4tb} Klickt mit der linken Maustaste auf das erfasste Element. ## AusführenAktion {#java-connector-methods__section_c3s_swc_4tb} 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](https://servicenow-prod.fluidtopics.net/inkwzmXhYoxpYR_STKUQmA "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in RPA Desktop Design Studioübergeben werden."). {#java-connector-methods__table_wpx_2wj_4tb__entry__7} | 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 | | [Tabelle : 16. Parameter der IsCreated-Methode] {#java-connector-methods__table_wpx_2wj_4tb} ## Passwortfestlegen {#java-connector-methods__section_c2b_zss_vzb} Automatisieren Sie die sichere Eingabe von Passwörtern im Passwortfeld einer Java-Anwendung. Eingaben für die Felder finden Sie unter [Porteigenschaften konfigurieren](https://servicenow-prod.fluidtopics.net/inkwzmXhYoxpYR_STKUQmA "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in RPA Desktop Design Studioübergeben werden.").{#java-connector-methods__table_jrs_nts_vzb__entry__7} | 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. | [Tabelle : 17. Parameter der SetPassword-Methode] {#java-connector-methods__table_jrs_nts_vzb}