Terminalemulation-Aktionen
Power Automate bietet die Integration mit Terminalemulatoren durch die Aktionen Terminalemulation. Diese Aktionen ermöglichen es Ihnen, Terminals und Mainframes zu handhaben und Operationen auszuführen, wie z. B. das Bewegen des Cursors, das Einstellen und Abrufen von Text und das Senden von Schlüsseln.
Verwenden Sie vor der Bereitstellung von Terminalaktionen die Terminalsitzung öffnen-Aktion, um eine neue Verbindung mit dem installierten Provider zu öffnen.
Wichtig
Bevor Sie versuchen, eine Verbindung zu einer Terminalsitzung herzustellen, stellen Sie sicher, dass die tatsächliche Terminalsitzung bereits auf Ihrem Computer geöffnet ist.
Wenn Sie Micro Focus Reflection auf Ihrem Computer installiert haben, wählen Sie die entsprechende Option im Anbieter-Parameter der Aktion und füllen Sie die erforderliche Konfiguration aus.
Wenn Sie einen anderen Anbieter installiert haben, wählen Sie HLLAPI, das mit den meisten Terminalemulationsanbietern funktioniert.
Wählen Sie je nach verwendetem Anbieter die entsprechende HLLAPI-DLL-Datei aus, die sich im Installationsordner befindet. In der folgenden Liste sehen Sie die HLLAPI-DLL-Dateinamen einiger beliebter Terminalemulationsanbieter:
- RocketSoftware BlueZone: ehlapi64.dll
- IBM Personal Communications: EHLAPI32.dll
- MicroFocus Rumba: System/ehlapi32.Dll
- Cybelesoft zScope: zHllap32.dll
Anmerkung
Die Windows-HLLAPI-DLL (WinHLLAPI) wird derzeit nicht unterstützt.
Nachdem Sie eine Terminalsitzung geöffnet und alle gewünschten Vorgänge abgeschlossen haben, beenden Sie die Verbindung mit der Terminalsitzung schließen-Aktion. Wenn Sie die Verbindung nicht schließen, können Sie bei einigen Anbietern keine erneute Verbindung zu der bereits geöffneten Sitzung herstellen, ohne die Software oder die Verbindung neu zu starten.
Terminalsitzung öffnen
Öffnet eine neue Terminalsitzung.
Eingabeparameter
| Argument | Optional | Akzeptiert | Standardwert | Beschreibung des Dataflows |
|---|---|---|---|---|
| Anbieter | n/v | Mikrofokus-Reflexion, HLLAPI | Micro Focus Reflection | Die zu verwendende Terminalemulation |
| HLLAPI-DLL-Pfad | Nein | Datei | Die HLLAPI-DLL des Anbieters. RocketSoftware BlueZone Standardname: 'ehlapi64.dll'. IBM Personal Communications Standardname: 'EHLAPI32.dll'. MicroFocus Rumba Standardpfad: 'System/ehlapi32.Dll'. Cybelesoft zScope default name: 'zHllap32.dll'. Jeder andere Anbieter, der eine HLLAPI-DLL in seinem Installationsordner anbietet. | |
| Installationspfad | Nein | Ordner | Der Installationspfad der Anwendung des Anbieters im Dateisystem des Benutzers | |
| Konfiguration | n/v | Vorhandenes Profil, Verbindung spezifizieren | Vorhandenes Profil | Wählen Sie 'Vorhandenes Profil', um eine Datei auszuwählen, die eine vorkonfigurierte Terminalemulationsverbindung enthält. Wählen Sie 'Verbindung angeben', um den Typ der Verbindung, die Host-Adresse und den Port anzugeben. |
| Sitzungsname | Nein | Textwert | Der Sitzungsname, mit dem eine Verbindung hergestellt werden soll. Der HLLAPI-Kurzname ist eine eindeutige Kennung für die Hostsitzung. Er befindet sich in den Konfigurationseinstellungen des Terminalemulators. | |
| Hosttyp | N/V | IBM 3270, IBM 5250 | IBM 3270 | Der Hosttyp der Verbindung |
| Profil | Nein | Datei | Die Datei mit der vorkonfigurierten Verbindung | |
| Hostadresse | Nein | Textwert | Die Hostadresse, mit der eine Verbindung hergestellt werden soll | |
| Port | Nein | Numerischer Wert | Der Port, der für diese Verbindung verwendet wird | |
| An laufende Sitzung anfügen | n/v | Boolescher Wert | Nein | Gibt an, ob an eine derzeit offene/laufende Terminalsitzung angefügt werden soll |
Erzeugte Variablen
| Argument | Type | Beschreibung des Dataflows |
|---|---|---|
| TerminalSession | Terminalsitzung | Die spezifische Terminalsitzung für die Verwendung mit späteren Terminalemulationsbefehlen |
Ausnahmen
| Ausnahme | Beschreibung |
|---|---|
| Fehler bei der Kommunikation mit dem Emulator | Gibt ein Problem beim Herstellen der Verbindung mit dem Emulator an |
| Profilfehler | Profilfehler |
Terminalsitzung schließen
Schließt eine offene Terminalsitzung.
Eingabeparameter
| Argument | Optional | Akzeptiert | Standardwert | Beschreibung des Dataflows |
|---|---|---|---|---|
| Zu schließende Terminalsitzung | Nein | Terminalsitzung | Die zuvor geöffnete Terminalsitzung |
Erzeugte Variablen
Diese Aktion erzeugt keine Variablen.
Ausnahmen
| Ausnahme | Beschreibung des Dataflows |
|---|---|
| Fehler bei der Kommunikation mit dem Emulator | Gibt ein Problem beim Herstellen der Verbindung mit dem Emulator an |
Cursor in Terminalsitzung verschieben
Verschiebt den Cursor des Terminals auf die angegebene Position.
Eingabeparameter
| Argument | Optional | Akzeptiert | Standardwert | Beschreibung des Dataflows |
|---|---|---|---|---|
| Terminalsitzung | Nein | Terminalsitzung | Die zu verwendende Terminalsitzung | |
| Zeile | Nein | Numerischer Wert | Die vertikale Position des Cursors auf dem Bildschirm | |
| Column | Nein | Numerischer Wert | Die horizontale Position des Cursors auf dem Bildschirm |
Erzeugte Variablen
Diese Aktion erzeugt keine Variablen.
Ausnahmen
| Ausnahme | Beschreibung des Dataflows |
|---|---|
| Bildschirmposition außerhalb der Grenzen | Gibt an, dass die Bildschirmposition außerhalb der zulässigen Grenzen liegt |
| Positionsbefehle werden vom Emulator nicht unterstützt | Gibt an, dass die verwendeten Positionsbefehle vom Emulator nicht unterstützt werden |
| Vorgang ist für diesen Sitzungstyp nicht verfügbar | Gibt an, dass der Vorgang für diesen Sitzungstyp nicht verfügbar ist |
| Fehler bei der Kommunikation mit dem Emulator | Gibt ein Problem beim Herstellen der Verbindung mit dem Emulator an |
Text aus Terminalsitzung abrufen
Text aus der Terminalsitzung abrufen.
Eingabeparameter
| Argument | Optional | Akzeptiert | Standardwert | Beschreibung des Dataflows |
|---|---|---|---|---|
| Terminalsitzung | Nein | Terminalsitzung | Die zu verwendende Terminalsitzung | |
| Text abrufen aus | n/v | Feld, Gesamter Bildschirm, Cursorposition, Bestimmte Position | Feld | Der Ort, von dem der Text abgerufen werden soll |
| Feld abrufen nach | n/v | Bezeichnung, Index, Position | Label | Gibt an, wie nach dem Feld gesucht wird |
| Label | Nein | Textwert | Die Beschriftung des zu suchenden Felds | |
| Index | Nein | Numerischer Wert | Der Index des zu suchenden Felds | |
| Textlänge | Nein | Numerischer Wert | Die Länge des zu empfangenden Texts | |
| Zeile | Nein | Numerischer Wert | Die vertikale Position des Felds auf dem Bildschirm | |
| Column | Nein | Numerischer Wert | Die horizontale Position des Felds auf dem Bildschirm |
Erzeugte Variablen
| Argument | Type | Beschreibung des Dataflows |
|---|---|---|
| TerminalText | Text Wert | Text, der aus der Terminalsitzung abgerufen wurde |
Ausnahmen
| Ausnahme | Beschreibung |
|---|---|
| Fehler bei der Kommunikation mit dem Emulator | Gibt ein Problem beim Herstellen der Verbindung mit dem Emulator an |
| Feldindex liegt nicht im zulässigen Bereich | Gibt an, dass der Feldindex außerhalb der zulässigen Grenzen liegt |
| Feldbeschriftung nicht gefunden | Gibt an, dass die Feldbeschriftung nicht vorhanden ist |
| Bildschirmposition außerhalb der Grenzen | Gibt an, dass die Bildschirmposition außerhalb der zulässigen Grenzen liegt |
| An der angegebenen Position wurde kein Feld gefunden. | Gibt an, dass kein Feld an der angegebenen Position vorhanden ist |
| Terminalbildschirm ist unformatiert | Gibt an, dass der Terminalbildschirm unformatiert ist |
| Positionsbefehle werden vom Emulator nicht unterstützt | Gibt an, dass die verwendeten Positionsbefehle vom Emulator nicht unterstützt werden |
| Vorgang ist für diesen Sitzungstyp nicht verfügbar | Gibt an, dass der Vorgang für diesen Sitzungstyp nicht verfügbar ist |
Text in Terminalsitzung festlegen
Text in einer Terminalsitzung festlegen.
Eingabeparameter
| Argument | Optional | Akzeptiert | Standardwert | Beschreibung des Dataflows |
|---|---|---|---|---|
| Terminalsitzung | Nein | Terminalsitzung | Die zu verwendende Terminalsitzung | |
| Text | Nein | Direkte verschlüsselte Eingabe oder Textwert | Der Text, der an der Position festgelegt werden soll | |
| Text festlegen | NICHT ZUTREFFEND | Cursor-Position, Feld | Feld | Der Ort, von dem der Text festgelegt werden soll |
| Feld abrufen nach | n/v | Bezeichnung, Index, Position | Label | Gibt die Art der Suche nach dem Feld an |
| Label | Nein | Textwert | Die Beschriftung des zu suchenden Felds | |
| Index | Nein | Numerischer Wert | Der Index des Felds auf dem Bildschirm | |
| Zeile | Nein | Numerischer Wert | Die vertikale Position des Felds auf dem Bildschirm | |
| Column | Nein | Numerischer Wert | Die horizontale Position des Felds auf dem Bildschirm | |
| @-Zeichen als Literal behandeln | NICHT ZUTREFFEND | Boolescher Wert | False | Aktivieren Sie dieses Kontrollkästchen, um das „@“-Zeichen wörtlich zu senden. Lassen Sie diese Option deaktiviert, um es als Sonderzeichen zu senden |
Erzeugte Variablen
Diese Aktion erzeugt keine Variablen.
Ausnahmen
| Ausnahme | Beschreibung des Dataflows |
|---|---|
| Fehler bei der Kommunikation mit dem Emulator | Gibt ein Problem beim Herstellen der Verbindung mit dem Emulator an |
| Feldindex liegt nicht im zulässigen Bereich | Gibt an, dass der Feldindex außerhalb der zulässigen Grenzen liegt |
| Feldbeschriftung nicht gefunden | Gibt an, dass die Feldbeschriftung nicht vorhanden ist |
| Bildschirmposition außerhalb der Grenzen | Gibt an, dass die Bildschirmposition außerhalb der zulässigen Grenzen liegt |
| An der angegebenen Position wurde kein Feld gefunden. | Gibt an, dass kein Feld an der angegebenen Position vorhanden ist |
| Terminalbildschirm ist unformatiert | Gibt an, dass der Terminalbildschirm unformatiert ist |
| Positionsbefehle werden vom Emulator nicht unterstützt | Gibt an, dass die verwendeten Positionsbefehle vom Emulator nicht unterstützt werden |
| Vorgang ist für diesen Sitzungstyp nicht verfügbar | Gibt an, dass der Vorgang für diesen Sitzungstyp nicht verfügbar ist |
| Eingabetext wurde abgelehnt | Gibt an, dass der Eingabetext abgelehnt wurde |
Tastaturbefehl an Terminalsitzung senden
Sendet einen Tastaturbefehl an eine Terminalsitzung.
Eingabeparameter
| Argument | Optional | Akzeptiert | Standardwert | Beschreibung des Dataflows |
|---|---|---|---|---|
| Terminalsitzung | Nein | Terminalsitzung | Die zu verwendende Terminalsitzung | |
| Steuerungstaste | n/v | Senden, Alt-Cursor, Achtung, Rücktaste, Tabulator zurück, Blockwechsel, Pause, Abbrechen, Zentrieren, Löschen, Kommando löschen, Display löschen, Zeile löschen, Seite löschen, Partition löschen, Komma, Befehlszeile, Befehlsfenster, Compose, Strg+F1, Strg+F2, Strg+F3, Strg+F4, Strg+F5, Strg+F6, Strg+F7, Strg+F8, Strg+F9, Strg+F10, Strg+F11, Strg+F12, Strg+Shift+F1, Strg+Shift+F2, Strg+Shift+F3, Strg+Shift+F4, Strg+Shift+F5, Strg+Umschalt+F6, Strg+Umschalt+F7, Strg+Umschalt+F8, Strg+Umschalt+F9, Strg+Umschalt+F10, Strg+Umschalt+F11, Strg+Umschalt+F12, Cursor blinken, Cursor auswählen, Dezimal, Löschen, Zeichen löschen, Zeile löschen, Wort löschen, Destruktives Rückwärtsleerzeichen, Trennen, Do, Down, Down double, Dup, Duplizieren, Skript bearbeiten, Tastenende, Feldende, EOF löschen, EOL löschen, EOP löschen, Eingabe löschen, Escape, ExtGr, F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12, F13, F14, F15, F16, F17, F18, F19, F20, F21, F22, F23, F24, F25, F26, F27, F28, F29, F30, F31, F32, F33, F34, F35, F36, F37, F38, F39, F40, F41, F42, F43, F44, F45, F46, F47, F48, Feldbegrenzer, Feldausgang, Feldmarkierung, Feldminus, Feldplus, Suchen, Hard Reset, Hilfe, Hex, Hex 00, Hex 01, Hex 02, Hex 03, Hex 04, Hex 05, Hex 06, Hex 07, Hex 08, Hex 09, Hex 0A, Hex 0B, Hex 0C, Hex 0D, Hex 0E, Hex 0F, Hex 10, Hex 11, Hex 12, Hex 13, Hex 14, Hex 15, Hex 16, Hex 17, Hex 18, Hex 19, Hex 1A, Hex 1B, Hex 1C, Hex 1D, Hex 1E, Hex 1F, Hex 7F, Hold, Hold clear, Hold set, Home, Home down, Home up, Insert, Insert char, Insert here, Insert line, Insert mode, Invalid key, KeyPad0, KeyPad1, KeyPad2, KeyPad3, KeyPad4, KeyPad5, KeyPad6, KeyPad7, KeyPad8, KeyPad9, Left, Left double, Zeilenvorschub, Minus, Monitor umschalten, Neue Zeile, Nächste Seite, Nächster Bildschirm, Nächstes Wort, Nul, NumLock, PA1, PA2, PA3, Seite, Seite abwärts, Seite aufwärts, Pan links, Pan rechts, Partitionssprung, PF1, PF2, PF3, PF4, Plus Cr, Vorheriges Wort, PrevPage, PrevScreen, Drucken, Zeile drucken, Print Msg, Prent screen, Entfernen, Ersetzen, Zurücksetzen, Return, Reservefeld, Rechts, Rechts doppelt, Abwärts rollen, Aufwärts rollen, Zeile rollen, Script ausführen, Nach unten rollen, Nach links rollen, Nach rechts rollen, Nach oben rollen, Auswählen, Senden, Antwort zurück senden, Löschen senden, Zeile senden, Msg senden, Umschalt+Rückschritt, Umschalt+Löschen, Umschalt+Ab, Umschalt+F1, Umschalt+F2, Umschalt+F3, Umschalt+F4, Umschalt+F5, Umschalt+F6, Umschalt+F7, Umschalt+F8, Umschalt+F9, Umschalt+F10, Umschalt+F11, Umschalt+F12, Umschalt+F13, Umschalt+F14, Umschalt+F15, Umschalt+F16, Umschalt+F17, Umschalt+F18, Umschalt+F19, Umschalt+F20, Umschalt+Home, Umschalt+Einfügen, Umschalt+Links, Umschalt+Bildschirm drucken, Umschalt+Rechts, Umschalt+Hoch, Soft-Reset, Systemabfrage, Tabulator, Tek-Zoom, Begriff nächste Seite, Begriff vorherige Seite, Test, Texthilfe Beginn fett, Texthilfe Beginn der Zeile, Texthilfe Beginn der Unterstreichung, Texthilfe Ende der Seite, Texthilfe Trägerrücklauf, Texthilfe Mitte, Texthilfe Ende fett, Texthilfe Ende der Zeile, Texthilfe halber Index unten, Texthilfe halber Index oben, Texthilfe Symbole einfügen, Texthilfe nächster Stopp, Texthilfe nächste Textspalte, Texthilfe Seitenende, Texthilfe erforderliches Leerzeichen, Texthilfe erforderlicher Tabulator, Texthilfe Stopp, Texthilfe Texttabulator vorwärts, Texthilfe Seitenanfang, Texthilfe Wortunterstrich, Trace Toggle, Udk 10, Udk 6, Udk 7, Udk 8, Udk 9, Udk 11, Udk 12, Udk 13, Udk 14, Udk 15, Udk 16, Udk 17, Udk 18, Udk 19, Udk 20, Up, Up double | Übertragen | Die Taste, die an die Sitzung gesendet werden soll |
Erzeugte Variablen
Diese Aktion erzeugt keine Variablen.
Ausnahmen
| Ausnahme | Beschreibung des Dataflows |
|---|---|
| Fehler bei der Kommunikation mit dem Emulator | Gibt ein Problem beim Herstellen der Verbindung mit dem Emulator an |
| Taste nicht unterstützt | Gibt an, dass die Taste nicht unterstützt wird |
Auf Text in Terminalsitzung warten
Wartet, bis ein bestimmter Text in einer Terminalsitzung angezeigt wird.
Eingabeparameter
| Argument | Optional | Akzeptiert | Standardwert | Beschreibung des Dataflows |
|---|---|---|---|---|
| Terminalsitzung | Nein | Terminalsitzung | Die zuvor geöffnete Terminalsitzung | |
| Gesuchter Text | Nein | Textwert | Der Text oder reguläre Ausdruck, auf den auf dem Terminalbildschirm oder in einem angegebenen Feld gewartet werden soll | |
| Regulärer Ausdruck | n/v | Boolescher Wert | Nein | Gibt an, ob anstelle des reinen Texts auf einen regulären Ausdruck gewartet werden soll |
| Ort für gesuchten Text | n/v | Bildschirm, Feld | Anzeige | Der Ort, an dem auf Text gewartet werden soll |
| Feld abrufen nach | n/v | Bezeichnung, Index, Position | Label | Gibt die Art der Suche nach dem Feld an |
| Label | Nein | Textwert | Die Beschriftung des zu suchenden Felds | |
| Index | Nein | Numerischer Wert | Der Index des zu suchenden Felds | |
| Zeile | Nein | Numerischer Wert | Die vertikale Position des Felds auf dem Bildschirm | |
| Column | Nein | Numerischer Wert | Die horizontale Position des Felds auf dem Bildschirm | |
| Zeitüberschreitung | Ja | Numerischer Wert | 0 | Die maximale Wartezeit |
Notiz
Das Modul von Power Automate für reguläre Ausdrücke ist .NET. Weitere Informationen zu regulären Ausdrücken finden Sie in Sprache für reguläre Ausdrücke – Kurzübersicht.
Erzeugte Variablen
Diese Aktion erzeugt keine Variablen.
Ausnahmen
| Ausnahme | Beschreibung des Dataflows |
|---|---|
| Fehler bei der Kommunikation mit dem Emulator | Gibt ein Problem beim Herstellen der Verbindung mit dem Emulator an |
| Feldindex liegt nicht im zulässigen Bereich | Gibt an, dass der Feldindex außerhalb der zulässigen Grenzen liegt |
| Feldbeschriftung nicht gefunden | Gibt an, dass die Feldbeschriftung nicht vorhanden ist |
| Bildschirmposition außerhalb der Grenzen | Gibt an, dass die Bildschirmposition außerhalb der zulässigen Grenzen liegt |
| An der angegebenen Position wurde kein Feld gefunden. | Gibt an, dass kein Feld an der angegebenen Position vorhanden ist |
| Terminalbildschirm ist unformatiert | Gibt an, dass der Terminalbildschirm unformatiert ist |
| Positionsbefehle werden vom Emulator nicht unterstützt | Gibt an, dass die verwendeten Positionsbefehle vom Emulator nicht unterstützt werden |
| Vorgang ist für diesen Sitzungstyp nicht verfügbar | Gibt an, dass der Vorgang für diesen Sitzungstyp nicht verfügbar ist |
| Timeout überschritten | Gibt an, dass der Timeout überschritten ist |
Nach Text in einer Terminalsitzung suchen
Suche nach allen Vorkommnissen eines bestimmten Texts in einer Terminalsitzung
Eingabeparameter
| Argument | Optional | Akzeptiert | Standardwert | Beschreibung des Dataflows |
|---|---|---|---|---|
| Terminalsitzung | Nein | Terminalsitzung | Die zuvor geöffnete Terminalsitzung | |
| Text, nach dem gesucht werden soll | Nein | Textwert | Der Text oder reguläre Ausdruck, nach dem im Terminalbildschirm gesucht werden soll | |
| Regulärer Ausdruck | NICHT ZUTREFFEND | Boolescher Wert | False | Gibt an, ob anstelle nach reinem Text nach einem regulären Ausdruck gesucht werden soll |
| Spaltengröße | Nein | Numerischer Wert | 80 | Die Anzahl der Spalten auf dem Terminalbildschirm |
Anmerkung
Das Modul von Power Automate für reguläre Ausdrücke ist .NET. Weitere Informationen zu regulären Ausdrücken finden Sie in Sprache für reguläre Ausdrücke – Kurzübersicht.
Erzeugte Variablen
| Argument | Type | Beschreibung |
|---|---|---|
| FindResults | Datentabelle | Die Suchergebnisse, die vom Terminalsitzungsbildschirm abgerufen werden |
Ausnahmen
| Ausnahme | Beschreibung |
|---|---|
| Fehler bei der Kommunikation mit dem Emulator | Gibt ein Problem beim Herstellen der Verbindung mit dem Emulator an |
| Text nicht gefunden | Gibt an, dass die Textsuche nicht gefunden wurde |
| Ungültiger RegEx-Ausdruck | Gibt an, dass der verwendete reguläre Ausdruck ungültig ist |