--- sourceDocument: Zürich-Daten und Automatisierung sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/zurich/integrate-applications Release : - zurich ft:locale : - de-DE ft:publication_title : - Zürich-Daten und Automatisierung ft:clusterId : - crint bundleId : - crint workflow : - Creator --- # IBM Emulatormethoden für persönliche Kommunikation # IBM Emulatormethoden für persönliche Kommunikation {#ariaid-title1} * Freigeben Version: Zurich * * Aktualisiert 31. Juli 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 Minuten Lesedauer Verwenden Sie IBM Emulatormethoden für persönliche Kommunikation zum Ausführen verschiedener Automatisierungsaufgaben auf dem IBM Emulator für persönliche Kommunikation. ## Methoden auf Bildschirmebene {#pcomm-terminal-methods__section_dkr_1db_51c} 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 vom Bildschirm abrufen. ## GetFieldText {#pcomm-terminal-methods__section_xqk_wfb_51c} Gibt den Text zurück, den ein Feld enthält, nachdem es das Feld anhand der von Ihnen angegebenen Zeilen- und Spaltennummer identifiziert hat. 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: `H `Ist der erste Buchstabe und der Ausgangspunkt im Feld und `Host-BS: `Ist der vollständige Text im Feld. {#pcomm-terminal-methods__table_ubn_ggb_51c__entry__7} | Parameter | Beschreibung | Datenport-Eintragstyp | Datentyp | Standardwert | Obligatorisch | Notizen | |-|-|-|-|-|-|-| | Zeile | Feldzeilennummer, die das Feld identifiziert. | Daten In | Ganzzahl | NA | Ja | | | Spalte | Feldspaltennummer, die das Feld identifiziert. | Daten In | Ganzzahl | NA | Ja | | | Zurück | Gibt den Text im Feld zurück. | Daten Aus | Zeichenfolge | NA | NA | | [Tabelle : 1. GetFieldText-Methodenparameter] {#pcomm-terminal-methods__table_ubn_ggb_51c} ## GetTextFromRect {#pcomm-terminal-methods__section_u4c_mhb_51c} Gibt den Text in allen Feldern eines rechteckigen Bereichs zurück, den Sie auf dem Bildschirm definieren. Sie definieren einen Bereich, indem Sie die Zeilen und Spaltennummern für den Anfang und das Ende angeben. Die Methode sucht und identifiziert das erste und das letzte Feld und gibt den gesamten Text in allen Feldern in diesem Bereich zurück. Das folgende Beispiel zeigt den von Ihnen definierten Bereich. {#pcomm-terminal-methods__table_e4p_x4b_51c__entry__7} | Parameter | Beschreibung | Datenport-Eintragstyp | Datentyp | Standardwert | Obligatorisch | Notizen | |-|-|-|-|-|-|-| | StartRow | Zeilennummer, die das erste Zeichen des ersten Felds im rechteckigen Bereich angibt. | Daten In | Ganzzahl | NA | Ja | | | Startspalte | Spaltennummer, die das erste Zeichen des ersten Felds im rechteckigen Bereich enthält. | Daten In | Ganzzahl | NA | Ja | | | Eintritt | Zeilennummer, die das letzte Zeichen des letzten Felds im rechteckigen Bereich enthält. | Daten In | Ganzzahl | NA | Ja | | | Endspalte | Spaltennummer, die das letzte Zeichen des letzten Felds im rechteckigen Bereich enthält. | Daten In | Ganzzahl | NA | Ja | | | Zurück | Gibt den Text aus allen Feldern im rechteckigen Bereich zurück. | Daten Aus | Zeichenfolge | NA | NA | | [Tabelle : 2. GetTextFromRect-Methodenparameter] {#pcomm-terminal-methods__table_e4p_x4b_51c} ## Ist erstellt {#pcomm-terminal-methods__section_whb_jsc_51c} Überprüft, ob der Emulatorbildschirm basierend auf der Bildschirmabgleichsregel vorhanden ist und Eingaben vom Anwender akzeptieren kann. Nach der Verifizierung gibt die Methode den entsprechenden booleschen Wert zurück. {#pcomm-terminal-methods__table_scg_qsc_51c__entry__7} | Parameter | Beschreibung | Datenport-Eintragstyp | Datentyp | Standardwert | Obligatorisch | Notizen | |-|-|-|-|-|-|-| | Übereinstimmungalle untergeordneten Elemente | Option zum Suchen des Emulatorbildschirms durch Abgleichen der von Ihnen erfassten untergeordneten Elemente. | Daten In | 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 | | [Tabelle : 3. IsCreated-Methodenparameter] {#pcomm-terminal-methods__table_scg_qsc_51c} ## SearchText {#pcomm-terminal-methods__section_uvz_rtc_51c} Gibt die Nummern der Zeile und Spalte zurück, die das erste Zeichen des von Ihnen angegebenen Texts enthalten. Beispiel: Wenn Sie die Zeichenfolge angeben `Emulator `, Die Methode gibt die Zeilen- und Spaltennummern des Startpunkts des Worts zurück `Emulator `Was ist `E `. Hinweis: Wenn Sie den Text angeben, der sich über mehrere Felder erstreckt, geben die Ports „Zeile" und „Spalte" 0 zurück, da die Methode den Text nur aus einem einzelnen Feld unterstützt. {#pcomm-terminal-methods__table_lhf_vtc_51c__entry__7} | Parameter | Beschreibung | Datenport-Eintragstyp | Datentyp | Standardwert | Obligatorisch | Notizen | |-|-|-|-|-|-|-| | Text | Text, den die Methode durchsucht. | Daten In | Zeichenfolge | NA | Ja | Bei dem von Ihnen angegebenen Text wird die Groß-/Kleinschreibung je nach verwendetem Emulator unterschieden. | | 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 auftritt, gibt die Methode die erste Zeile und Spalte zurück, die den Text enthalten. | | 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 auftritt, gibt die Methode die erste Zeile und Spalte zurück, die den Text enthalten. | [Tabelle : 4. SearchText-Methodenparameter] {#pcomm-terminal-methods__table_lhf_vtc_51c} ## SendKeys {#pcomm-terminal-methods__section_zwz_z21_w1c} Simuliert die Tastenanschläge, die Sie über die Tastatur an der Position des Mausgeräts auf dem Emulatorbildschirm eingeben. Sie können beispielsweise simulieren \[Eingabetaste\] Tastenanschlag auf dem Bildschirm. {#pcomm-terminal-methods__table_qwx_cdc_w1c__entry__7} | Parameter | Beschreibung | Datenport-Eintragstyp | Datentyp | Standardwert | Obligatorisch | Notizen | |-|-|-|-|-|-|-| | Keys | Tastenanschläge, die Sie über Ihre Tastatur eingeben. | Daten In | Zeichenfolge | Keine | Ja | Tipp: Weitere Informationen zu den Tastenanschlägen finden Sie in der Dokumentation zum entsprechenden Terminal-Emulator. | [Tabelle : 5. SendKeys-Methodenparameter] {#pcomm-terminal-methods__table_qwx_cdc_w1c} ## SendKeysSecure {#pcomm-terminal-methods__section_jvn_pr4_w1c} Simuliert die Tastenanschläge, bei denen es sich um eine gesicherte Zeichenfolge an der Position des Mausgeräts auf dem Emulatorbildschirm handelt. {#pcomm-terminal-methods__table_ews_ps4_w1c__entry__7} | Parameter | Beschreibung | Datenport-Eintragstyp | Datentyp | Standardwert | Obligatorisch | Notizen | |-|-|-|-|-|-|-| | Keys | Tastenanschläge, die Sie als gesicherte Zeichenfolge eingeben. | Daten In | Gesicherte Zeichenfolge | Keine | Ja | Tipp: Weitere Informationen zu den Tastenanschlägen finden Sie in der Dokumentation zum entsprechenden Terminal-Emulator. | [Tabelle : 6. Parameter der SendKeysSecure-Methode] {#pcomm-terminal-methods__table_ews_ps4_w1c} ## SetCursorPosition {#pcomm-terminal-methods__section_yrg_y5c_51c} Versucht, das Mausgerät an der von Ihnen angegebenen Zeilen- und Spaltennummer festzulegen. {#pcomm-terminal-methods__table_pxr_dvc_51c__entry__7} | Parameter | Beschreibung | Datenport-Eintragstyp | Datentyp | Standardwert | Obligatorisch | Notizen | |-|-|-|-|-|-|-| | Zeile | Option zur Angabe der Anzahl der Zeile, basierend auf der die Methode versucht, das Mausgerät auf dem Bildschirm festzulegen. | Daten In | Ganzzahl | NA | NA | Die Zeilennummer muss positiv sein und innerhalb der Größe des Emulatorbildschirms liegen. Wenn die Bildschirmgröße beispielsweise 24X80 ist, ist der Höchstwert, den Sie für eine Zeile angeben können, 24. | | Spalte | Option zur Angabe der Anzahl der Zeile, basierend auf der die Methode versucht, das Mausgerät auf dem Bildschirm festzulegen. | Daten In | Ganzzahl | NA | NA | Die Spaltennummer muss positiv sein und innerhalb der Größe des Emulatorbildschirms liegen. Wenn die Bildschirmgröße beispielsweise 24X80 ist, beträgt der Höchstwert, den Sie für eine Spalte angeben können, 80. | [Tabelle : 7. SetCursorPosition-Methodenparameter] {#pcomm-terminal-methods__table_pxr_dvc_51c} ## Warten auf Erstellen {#pcomm-terminal-methods__section_ykp_lvc_51c} Wartet für die von Ihnen angegebene Dauer, während der Connector die Bildschirmabgleichsregel verwendet, um festzustellen, ob der Bildschirm vorhanden ist. {#pcomm-terminal-methods__table_trs_cwc_51c__entry__7} | Parameter | Beschreibung | Datenport-Eintragstyp | Datentyp | Standardwert | Obligatorisch | Notizen | |-|-|-|-|-|-|-| | ZeitüberschreitinSekunden | Option zur Angabe der Anzahl der Sekunden, für die die Methode wartet, während der Connector die Bildschirmabgleichsregel verwendet, um zu ermitteln, ob der Bildschirm vorhanden ist. | Daten In | Ganzzahl | 30 | Ja | | | Übereinstimmungalle untergeordneten Elemente | Option zum Abgleichen aller erfassten Bildschirmelemente, um zu ermitteln, ob der Bildschirm vorhanden ist. | Daten In | Boolean | Falsch | Ja | Warnung: Die Verwendung dieser Option kann die Ausführung der Methode verzögern. | | Zurück | Gibt den booleschen Wert basierend darauf zurück, ob der Emulatorbildschirm gefunden wurde. | Daten Aus | Boolean | NA | NA | | [Tabelle : 8. WaitForCreate-Methodenparameter] {#pcomm-terminal-methods__table_trs_cwc_51c} ## Methoden auf Elementebene {#pcomm-terminal-methods__section_ph5_pzh_51c} Methoden auf Elementebene führen Automatisierungsaufgaben für die Elemente des Emulatorbildschirms durch, die Sie über den Bildschirm Terminal Connector hinzufügen. Sie können ein Bildschirmelement als Feld oder Tabelle hinzufügen. ## GetAsTable {#pcomm-terminal-methods__section_gsf_jb3_51c} 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 IBM Emulator für persönliche Kommunikation](https://www.servicenow.com/docs/SzZJA_NienPz1g1xwi6Bag "Konfigurieren Sie IBM Emulator für persönliche Kommunikation (PCOMM) auf der RPA Desktop Design Studio Durch Erfassen der PCOMM-Emulatorbildschirme und ihrer Elemente. Nach der Erfassung der Bildschirme können Sie die Bildschirm- und Elementmethoden verwenden, um Aktionen für die Bildschirme und Elemente zu automatisieren."). {#pcomm-terminal-methods__table_i1k_yb3_51c__entry__7} | Parameter | Beschreibung | Datenport-Eintragstyp | Datentyp | Standardwert | Obligatorisch | Notizen | |-|-|-|-|-|-|-| | Zurück | Gibt den erfassten Text vom Terminal-Bildschirm 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 aus Vorschau Der Daten Anzeigen . | [Tabelle : 9. Parameter der GetAsTable-Methode] {#pcomm-terminal-methods__table_i1k_yb3_51c} ## Gettext {#pcomm-terminal-methods__section_jrs_gc3_51c} Gibt den Text in dem Feld zurück, den Sie über den 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. {#pcomm-terminal-methods__table_umt_jc3_51c__entry__7} | Parameter | Beschreibung | Datenport-Eintragstyp | Datentyp | Standardwert | Obligatorisch? | Notizen | |-|-|-|-|-|-|-| | Zurück | Gibt den Text aus dem erfassten Feld zurück. | Daten Aus | Zeichenfolge | NA | NA | | [Tabelle : 10. Parameter der gettext-Methode] {#pcomm-terminal-methods__table_umt_jc3_51c} ## Ist erstellt {#pcomm-terminal-methods__section_nyk_nc3_51c} Entspricht den Regeln und überprüft, ob das erfasste Element vorhanden ist. {#pcomm-terminal-methods__table_oyk_nc3_51c__entry__7} | 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 | | [Tabelle : 11. IsCreated-Methodenparameter] {#pcomm-terminal-methods__table_oyk_nc3_51c} ## SetText {#pcomm-terminal-methods__section_cnd_tc3_51c} Versucht, den Text für das Feld festzulegen. {#pcomm-terminal-methods__table_xrt_5c3_51c__entry__7} | Parameter | Beschreibung | Datenport-Eintragstyp | Datentyp | Standardwert | Obligatorisch | Notizen | |-|-|-|-|-|-|-| | Text | Option zum Angeben des Texts, den die Methode im Feld festlegen möchte. | Daten In | Zeichenfolge | NA | Ja | Sie können diese Methode nicht auf geschützten Emulatorbildschirmen verwenden. | [Tabelle : 12. SetText-Methodenparameter] {#pcomm-terminal-methods__table_xrt_5c3_51c} ## Warten auf Erstellen {#pcomm-terminal-methods__section_z1s_yl3_51c} Wartet für die von Ihnen angegebene Dauer, während der Connector die Übereinstimmungsregel verwendet, um festzustellen, ob das Element vorhanden ist. {#pcomm-terminal-methods__table_abs_yl3_51c__entry__7} | Parameter | Beschreibung | Datenport-Eintragstyp | Datentyp | Standardwert | Obligatorisch | Notizen | |-|-|-|-|-|-|-| | ZeitüberschreitinSekunden | Option zur Angabe der Anzahl der Sekunden, für die die Methode wartet, während der Connector die Übereinstimmungsregel verwendet, um zu ermitteln, ob das Element vorhanden ist. | Daten In | Ganzzahl | 30 | Ja | | | Zurück | Gibt den booleschen Wert zurück, abhängig davon, ob das Element gefunden wurde. | Daten Aus | Boolean | NA | NA | | [Tabelle : 13. WaitForCreate-Methodenparameter] {#pcomm-terminal-methods__table_abs_yl3_51c}