Acties voor terminalemulatie
Power Automate biedt integratie met terminalemulators via de acties Terminalemulatie. Met deze acties kunt u werken met terminals en mainframes en bewerkingen uitvoeren zoals de cursor verplaatsen, tekst instellen en ophalen, en sleutels verzenden.
Voordat u terminalacties implementeert, gebruikt u de actie Terminalsessie openen om een nieuwe verbinding met de geïnstalleerde provider te openen.
Belangrijk
Voordat u verbinding probeert te maken met een terminalsessie, moet u ervoor zorgen dat de daadwerkelijke terminalsessie al geopend is op uw computer.
Als u Micro Focus Reflection op uw machine hebt geïnstalleerd, kiest u de desbetreffende optie in de parameter Aanbieder van de actie en vul de vereiste configuratie in.
Als u een andere provider hebt geïnstalleerd, selecteert u HLLAPI dat werkt met de meeste terminalemulatieproviders.
Selecteer, afhankelijk van de provider die u gebruikt, het juiste HLLAPI DLL-bestand in de installatiemap. In de volgende lijst ziet u de HLLAPI DLL-bestandsnamen van enkele populaire providers van terminalemulatie:
- RocketSoftware BlueZone: ehlapi64.dll
- IBM Personal Communications: EHLAPI32.dll
- MicroFocus Rumba: System/ehlapi32.Dll
- Cybelesoft zScope: zHllap32.dll
Opmerking
De Windows HLLAPI DLL (WinHLLAPI) wordt momenteel niet ondersteund.
Na het openen van een terminalsessie en het voltooien van alle gewenste bewerkingen beëindigt u de verbinding met de actie Terminalsessie sluiten. Als u de verbinding niet verbreekt, laten sommige providers u niet opnieuw verbinding maken met de reeds geopende sessie zonder de software of de verbinding opnieuw te starten.
Terminalsessie openen
Hiermee wordt een nieuwe terminalsessie geopend.
Invoerparameters
| Argument | Optioneel | Accepteert | Standaardwaarde | Omschrijving |
|---|---|---|---|---|
| Provider | N.v.t. | Micro Focus Reflection, HLLAPI | Micro Focus Reflection | De terminalemulatie die wordt gebruikt |
| HLLAPI DLL path | Nee | Bestand | De HLLAPI-DLL van de provider. Standaardnaam van RocketSoftware BlueZone: 'ehlapi64.dll'. Standaardnaam voor IBM Personal Communications: 'EHLAPI32.dll'. Standaardpad van MicroFocus Rumba: 'System/ehlapi32.Dll'. Standaardnaam van Cybelesoft zScope: 'zHllap32.dll'. Elke andere provider die een HLLAPI DLL aanbiedt in zijn installatiemap. | |
| Installation path | Nee | Map | Het installatiepad van de toepassingsprovider op het bestandssysteem van de gebruiker | |
| Configuratie | N.v.t. | Bestaand profiel, Verbinding opgeven | Bestaand profiel | Kies Bestaand profiel om een bestand te selecteren dat een vooraf geconfigureerde terminalemulatieverbinding bevat. Kies Verbinding opgeven om het type verbinding, het hostadres en de poort op te geven. |
| Session name | Nee | Tekstwaarde | De sessienaam waarmee verbinding wordt gemaakt. De korte HLLAPI-naam, een unieke identificatie voor de hostsessie. Het is te vinden in de configuratie-instellingen van de terminalemulator. | |
| Host type | N.v.t. | IBM 3270, IBM 5250 | IBM 3270 | Het hosttype van de verbinding |
| Profile | Nee | Bestand | Het bestand dat de vooraf geconfigureerde verbinding bevat | |
| Host address | Nee | Tekstwaarde | Het hostadres waarmee verbinding wordt gemaakt | |
| Port | Nee | Numerieke waarde | De poort die moet worden gebruikt voor deze verbinding | |
| Attach to running session | N.v.t. | Booleaanse waarde | Onwaar | Geeft aan of er moet worden gekoppeld met een geopende of actieve terminalsessie |
Variabelen gemaakt
| Argument | Type | Omschrijving |
|---|---|---|
| TerminalSession | Terminalsessie | De specifieke terminalsessie voor gebruik met latere opdrachten voor terminalemulatie |
Uitzonderingen
| Uitzondering | Beschrijving |
|---|---|
| Fout bij het communiceren met de emulator | Duidt op een probleem bij het maken van verbinding met de emulator |
| Profielfout | Profielfout |
Een terminalsessie sluiten
Hiermee wordt een geopende terminalsessie gesloten.
Invoerparameters
| Argument | Optioneel | Accepteert | Standaardwaarde | Omschrijving |
|---|---|---|---|---|
| Terminal session to close | Nee | Terminalsessie | De eerder geopende terminalsessie |
Variabelen gemaakt
Deze actie levert geen variabelen op.
Uitzonderingen
| Uitzondering | Omschrijving |
|---|---|
| Fout bij het communiceren met de emulator | Duidt op een probleem bij het maken van verbinding met de emulator |
Cursor verplaatsen in terminalsessie
Hiermee wordt de cursor van de terminal verplaatst naar de opgegeven positie.
Invoerparameters
| Argument | Optioneel | Accepteert | Standaardwaarde | Omschrijving |
|---|---|---|---|---|
| Terminal session | Nee | Terminalsessie | De terminalsessie waarmee wordt gewerkt | |
| Row | Nee | Numerieke waarde | De verticale positie van de cursor op het scherm | |
| Column | Nee | Numerieke waarde | De horizontale positie van de cursor op het scherm |
Variabelen gemaakt
Deze actie levert geen variabelen op.
Uitzonderingen
| Uitzondering | Omschrijving |
|---|---|
| Schermpositie valt buiten de grenzen | Geeft aan dat de schermpositie buiten de grenzen valt |
| Positieopdrachten worden niet ondersteund door de emulator | Geeft aan dat gebruikte positieopdrachten niet worden ondersteund door de emulator |
| Bewerking is niet beschikbaar voor dit sessietype | Geeft aan dat de bewerking niet beschikbaar is voor dit sessietype |
| Fout bij het communiceren met de emulator | Duidt op een probleem bij het maken van verbinding met de emulator |
Tekst ophalen van terminalsessie
Tekst ophalen van een terminalsessie.
Invoerparameters
| Argument | Optioneel | Accepteert | Standaardwaarde | Omschrijving |
|---|---|---|---|---|
| Terminal session | Nee | Terminalsessie | De terminalsessie waarmee wordt gewerkt | |
| Get text from | N.v.t. | Veld, Volledig scherm, Cursorpositie, Specifieke positie | Veld | De locatie voor het ophalen van de tekst |
| Get field by | N.v.t. | Label, Index, Positie | Etiket | Geeft aan hoe naar het veld moet worden gezocht |
| Label | Nee | Tekstwaarde | Het label van het veld dat moet worden gezocht | |
| Index | Nee | Numerieke waarde | Het index van het veld dat moet worden gezocht | |
| Text length | Nee | Numerieke waarde | De lengte van de te ontvangen tekst | |
| Row | Nee | Numerieke waarde | De verticale positie van het veld op het scherm | |
| Column | Nee | Numerieke waarde | De horizontale positie van het veld op het scherm |
Variabelen gemaakt
| Argument | Type | Omschrijving |
|---|---|---|
| TerminalText | Tekstwaarde | De opgehaalde tekst ophalen uit de terminalsessie |
Uitzonderingen
| Uitzondering | Beschrijving |
|---|---|
| Fout bij het communiceren met de emulator | Duidt op een probleem bij het maken van verbinding met de emulator |
| Veldindex buiten de grenzen | Geeft aan dat de veldindex buiten de grenzen valt |
| Veldlabel niet gevonden | Geeft aan dat het veldlabel niet bestaat |
| Schermpositie valt buiten de grenzen | Geeft aan dat de schermpositie buiten de grenzen valt |
| Geen veld gevonden op de opgegeven positie | Geeft aan dat er geen veld bestaat op de opgegeven positie |
| Terminalscherm is niet opgemaakt | Geeft aan dat het terminalscherm niet is opgemaakt |
| Positieopdrachten worden niet ondersteund door de emulator | Geeft aan dat gebruikte positieopdrachten niet worden ondersteund door de emulator |
| Bewerking is niet beschikbaar voor dit sessietype | Geeft aan dat de bewerking niet beschikbaar is voor dit sessietype |
Tekst instellen in terminalsessie
Stel de tekst in een terminalsessie in.
Invoerparameters
| Argument | Optioneel | Accepteert | Standaardwaarde | Omschrijving |
|---|---|---|---|---|
| Terminal session | Nee | Terminalsessie | De terminalsessie waarmee wordt gewerkt | |
| Tekst | Nee | Directe versleutelde invoer of tekstwaarde | De tekst die wordt ingesteld op de opgegeven locatie | |
| Tekst instellen | N.v.t. | Cursorpositie, Veld | Veld | De locatie waarop de tekst wordt ingesteld |
| Get field by | N.v.t. | Label, Index, Positie | Etiket | Geeft aan met welke methode het veld wordt gezocht |
| Label | Nee | Tekstwaarde | Het label van het veld dat moet worden gezocht | |
| Index | Nee | Numerieke waarde | De index van het veld op het scherm | |
| Row | Nee | Numerieke waarde | De verticale positie van het veld op het scherm | |
| Column | Nee | Numerieke waarde | De horizontale positie van het veld op het scherm | |
| Treat @ character as literal | N.v.t. | Booleaanse waarde | False | Schakel dit selectievakje in om het @-teken letterlijk te verzenden. Laat deze optie uitgeschakeld voor verzending als speciaal teken |
Variabelen gemaakt
Deze actie levert geen variabelen op.
Uitzonderingen
| Uitzondering | Omschrijving |
|---|---|
| Fout bij het communiceren met de emulator | Duidt op een probleem bij het maken van verbinding met de emulator |
| Veldindex buiten de grenzen | Geeft aan dat de veldindex buiten de grenzen valt |
| Veldlabel niet gevonden | Geeft aan dat het veldlabel niet bestaat |
| Schermpositie valt buiten de grenzen | Geeft aan dat de schermpositie buiten de grenzen valt |
| Geen veld gevonden op de opgegeven positie | Geeft aan dat er geen veld bestaat op de opgegeven positie |
| Terminalscherm is niet opgemaakt | Geeft aan dat het terminalscherm niet is opgemaakt |
| Positieopdrachten worden niet ondersteund door de emulator | Geeft aan dat gebruikte positieopdrachten niet worden ondersteund door de emulator |
| Bewerking is niet beschikbaar voor dit sessietype | Geeft aan dat de bewerking niet beschikbaar is voor dit sessietype |
| Invoertekst is afgewezen | Geeft aan dat de invoertekst is afgewezen |
Toets naar terminalsessie verzenden
Hiermee wordt een Ctrl-toets naar een terminalsessie verzonden.
Invoerparameters
| Argument | Optioneel | Accepteert | Standaardwaarde | Omschrijving |
|---|---|---|---|---|
| Terminal session | Nee | Terminalsessie | De terminalsessie waarmee wordt gewerkt | |
| Control key | N.v.t. | Verzenden, Alt-cursor, Attentie, Backspace, Tab Terug, Wisselknop blokkeren, Onderbreken, Annuleren, Centreren, Wissen, Communicatie wissen, Weergave wissen, Regel wissen, Pagina wissen, Partitie wissen, Komma, Opdrachtregel, Opdrachtvenster, Samenstellen, Ctrl+F1, Ctrl+F2, Ctrl+F3, Ctrl+F4, Ctrl+F5, Ctrl+F6, Ctrl+F7, Ctrl+F8, Ctrl+F9, Ctrl+F10, Ctrl+F11, Ctrl+F12, Ctrl + Shift+F1, Ctrl + Shift+F2, Ctrl + Shift+F3, Ctrl + Shift+F4, Ctrl + Shift+F5, Ctrl + Shift+F6, Ctrl + Shift+F7, Ctrl + Shift+F8, Ctrl + Shift+F9, Ctrl + Shift+F10, Ctrl + Shift+F11, Ctrl + Shift+F12, Knipperende cursor, Cursor selecteren, Decimaal, Verwijderen, Teken verwijderen, Regel verwijderen, Woord verwijderen, Destructieve backspace, Verbinding verbreken, Doen, Omlaag, Twee keer omlaag, Dupliceren, Script bewerken, Toets Einde, Einde van veld, EOF wissen, EOL wissen, EOP wissen, Invoer wissen, 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, Scheidingsteken veld, Veld afsluiten, Veld markeren, Veld min, Veld plus, Zoeken, Harde reset, Help, 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, Vasthouden, Wissen vasthouden, Instellen vasthouden, Start, Start omlaag, Start omhoog, Invoegen, Teken invoegen, Hier invoegen, Regel invoegen, Invoegmodus, Ongeldige toets, KeyPad0, KeyPad1, KeyPad2, KeyPad3, KeyPad4, KeyPad5, KeyPad6, KeyPad7, KeyPad8, KeyPad9, Links, Dubbel links, Nieuwe regel, Minus, Monitor wisselen, Nieuwe regel, Volgende pagina, Volgend scherm, Volgend woord, Nul, NumLock, PA1, PA2, PA3, Pagina, Pagina omlaag, Pagina omhoog, Links pannen, Rechts pannen, Partitiesprong, PF1, PF2, PF3, PF4, Plus Cr, Vorig woord, Vorige pagina, Vorig scherm, Afdrukken, Regel afdrukken, Bericht afdrukken, Scherm afdrukken, Verwijderen, Vervangen, Opnieuw instellen, Retourneren, Veld reserveren, Rechts, Dubbel rechts, Uitvouwen, Samenvouwen, Regel re-li, Script uitvoeren, Omlaag schuiven, Naar links schuiven, Naar rechts schuiven, Omhoog schuiven, Selecteren, Verzenden, Antwoord terug verzenden, Verwijderen verzenden, Regel verzenden, Bericht verzenden, Shift+Backspace, Shift+Delete, Shift+Down, Shift+F1, Shift+F2, Shift+F3, Shift+F4, Shift+F5, Shift+F6, Shift+F7, Shift+F8, Shift+F9, Shift+F10, Shift+F11, Shift+F12, Shift+F13, Shift+F14, Shift+F15, Shift F16, Shift+F17, Shift+F18, Shift+F19, Shift+F20, Shift+Home, Shift+Insert, Shift+Left, Shift+Print screen, Shift+Right, Shift+Up, Zachte reset, Systeemverzoek, Tab, Tek zoom, Term volgende pagina, Term vorige pagina, Test, Tekstassistent begin vet, Tekstassistent begin regel, Tekstassistent begin onderstrepen, Tekstassistent einde pagina, Tekstassistent terugloop, Tekstassistent centreren, Tekstassistent einde vet, Tekstassistent einde regel, Tekstassistent halve index omlaag, Tekstassistent halve index omhoog, Tekstassistent symbolen invoegen, Tekstassistent volgende stop, Tekstassistent volgende tekstkolom, Tekstassistent paginaeinde, Tekstassistent vereiste spatie, Teksthulp vereiste tab, Tekstassistent stop, Tekstassistent tekst tab vooruit, Tekstassistent begin pagina, Tekstassistent woord onderstrepen, Wisselknop traceren, 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, Omhoog, Dubbel omhoog | Verzenden | De sleutel om te verzenden naar de sessie |
Variabelen gemaakt
Deze actie levert geen variabelen op.
Uitzonderingen
| Uitzondering | Omschrijving |
|---|---|
| Fout bij het communiceren met de emulator | Duidt op een probleem bij het maken van verbinding met de emulator |
| Sleutel niet ondersteund | Geeft aan dat de sleutel niet wordt ondersteund |
Wachten op tekst in terminalsessie
Hiermee wordt gewacht tot een specifieke tekst wordt weergegeven in een terminalsessie.
Invoerparameters
| Argument | Optioneel | Accepteert | Standaardwaarde | Omschrijving |
|---|---|---|---|---|
| Terminal session | Nee | Terminalsessie | De eerder geopende terminalsessie | |
| Text to wait for | Nee | Tekstwaarde | De tekst of gewone uitdrukking die moet worden weergegeven op het terminalscherm of in een opgegeven veld | |
| Regular expression | N.v.t. | Booleaanse waarde | Onwaar | Geeft aan om wel of niet wachten op een gewone uitdrukking in plaats van tekst zonder opmaak |
| Wait for text location | N.v.t. | Scherm, Veld | Scherm | De locatie waarop wordt gewacht voordat de tekst wordt weergegeven |
| Get field by | N.v.t. | Label, Index, Positie | Etiket | Geeft aan met welke methode het veld wordt gezocht |
| Label | Nee | Tekstwaarde | Het label van het veld dat moet worden gezocht | |
| Index | Nee | Numerieke waarde | Het index van het veld dat moet worden gezocht | |
| Row | Nee | Numerieke waarde | De verticale positie van het veld op het scherm | |
| Column | Nee | Numerieke waarde | De horizontale positie van het veld op het scherm | |
| Timeout | Ja | Numerieke waarde | 0 | De maximum hoeveelheid wachttijd |
Notitie
De engine voor reguliere expressies in Power Automate is .NET. Ga naar Reguliere expressietaal - Beknopte naslag voor meer informatie over reguliere expressies.
Variabelen gemaakt
Deze actie levert geen variabelen op.
Uitzonderingen
| Uitzondering | Omschrijving |
|---|---|
| Fout bij het communiceren met de emulator | Duidt op een probleem bij het maken van verbinding met de emulator |
| Veldindex buiten de grenzen | Geeft aan dat de veldindex buiten de grenzen valt |
| Veldlabel niet gevonden | Geeft aan dat het veldlabel niet bestaat |
| Schermpositie valt buiten de grenzen | Geeft aan dat de schermpositie buiten de grenzen valt |
| Geen veld gevonden op de opgegeven positie | Geeft aan dat er geen veld bestaat op de opgegeven positie |
| Terminalscherm is niet opgemaakt | Geeft aan dat het terminalscherm niet is opgemaakt |
| Positieopdrachten worden niet ondersteund door de emulator | Geeft aan dat gebruikte positieopdrachten niet worden ondersteund door de emulator |
| Bewerking is niet beschikbaar voor dit sessietype | Geeft aan dat de bewerking niet beschikbaar is voor dit sessietype |
| Time-out verlopen | Geeft aan dat de time-out is verlopen |
Zoeken naar tekst in terminalsessie
Zoeken naar alle exemplaren van specifieke tekst in een terminalsessie
Invoerparameters
| Argument | Optioneel | Accepteert | Standaardwaarde | Omschrijving |
|---|---|---|---|---|
| Terminal session | Nee | Terminalsessie | De eerder geopende terminalsessie | |
| Tekst om naar te zoeken | Nee | Tekstwaarde | De tekst of gewone uitdrukking waarnaar moet worden gezocht op het terminalscherm | |
| Regular expression | N.v.t. | Booleaanse waarde | False | Geeft aan of er moet worden gezocht naar een reguliere expressie in plaats van tekst zonder opmaak |
| Kolomgrootte | Nee | Numerieke waarde | 80 | Het aantal kolommen op het terminalscherm |
Notitie
De engine voor reguliere expressies in Power Automate is .NET. Ga naar Reguliere expressietaal - Beknopte naslag voor meer informatie over reguliere expressies.
Geproduceerde variabelen
| Argument | Type | Omschrijving |
|---|---|---|
| FindResults | Gegevenstabel | De zoekresultaten die zijn opgehaald van het terminalsessiescherm |
Uitzonderingen
| Uitzondering | Omschrijving |
|---|---|
| Fout bij het communiceren met de emulator | Duidt op een probleem bij het maken van verbinding met de emulator |
| Tekst niet gevonden | Geeft aan dat de tekst waarnaar werd gezocht niet is gevonden |
| Ongeldige reguliere expressie | Geeft aan dat de gebruikte reguliere expressie ongeldig is |