Condividi tramite


Azioni di emulazione di terminale

Power Automate fornisce l'integrazione con gli emulatori di terminale tramite le azioni Emulazione terminale. Queste azioni permettono di gestire terminali e mainframe e di eseguire operazioni come spostare il cursore, impostare e ricevere testo e inviare chiavi.

Prima di implementare qualsiasi azione del terminale, utilizza l'azione Apri sessione di terminale per aprire una nuova connessione con il provider installato.

Importante

Prima di provare a connetterti a una sessione di terminale, assicurati che quella effettiva sia già aperta sul tuo computer.

Se hai installato Micro Focus Reflection sul computer, scegli la rispettiva opzione nel parametro Provider dell'azione e popola la configurazione richiesta.

Screenshot dell'azione Apri sessione di terminale.

Se hai installato un altro provider, seleziona HLLAPI che funziona con la maggior parte dei provider di emulazione di terminale.

A seconda del provider che stai utilizzando, seleziona il file DLL HLLAPI appropriato che si trova nella relativa cartella di installazione. Nell'elenco seguente, sono elencati i nomi di file DLL HLLAPI di alcuni provider di emulazione di terminale noti:

  • RocketSoftware BlueZone: ehlapi64.dll
  • IBM Personal Communications: EHLAPI32.dll
  • MicroFocus Rumba: System/ehlapi32.Dll
  • Cybelesoft zScope: zHllap32.dll

Nota

La HLLAPI DLL (WinHLLAPI) di Windows non è attualmente supportata.

Screenshot dell'azione Apri sessione di terminale con l'opzione HLLAPI selezionata.

Dopo aver aperto una sessione di terminale e aver completato tutte le operazioni necessarie, termina la connessione utilizzando l'azione Chiudi sessione di terminale. Se non chiudi la connessione, alcuni provider non ti permetteranno di riconnetterti alla sessione già aperta senza riavviare il software o la connessione.

Screenshot dell'azione Chiudi sessione di terminale.

Apri sessione di terminale

Apri una nuova sessione di terminale.

Parametri di input

Argomento Facoltativo Accetta Valore predefinito Descrizione
Provider N/D Micro Focus Reflection, HLLAPI Micro Focus Reflection Emulazione di terminale da utilizzare
HLLAPI DLL path No file DLL HLLAPI del provider. Nome predefinito RocketSoftware BlueZone: "ehlapi64.dll". Nome predefinito IBM Personal Communications: "EHLAPI32.dll". Percorso predefinito MicroFocus Rumba: "System/ehlapi32.Dll". Nome predefinito Cybelesoft zScope default name: "zHllap32.dll" Qualsiasi altro provider che offre una DLL HLLAPI nella sua cartella di installazione.
Installation path No Cartella Percorso di installazione dell'applicazione del provider nel file system dell'utente
Configurazione N/D Profilo esistente, Specifica connessione Profilo esistente Scegli "Profilo esistente" per selezionare un file contenente una connessione di emulazione di terminale preconfigurata. Scegli "Specifica connessione" per specificare il tipo di connessione, l'indirizzo host e la porta.
Session name No Valore di testo Nome della sessione a cui connettersi. Si tratta del nome breve HLLAPI ed è un identificatore univoco della sessione host. È disponibile nelle impostazioni di configurazione dell'emulatore del terminale.
Host type N/D IBM 3270, IBM 5250 IBM 3270 Tipo di host della connessione
Profile No file File che contiene la connessione preconfigurata
Host address No Valore di testo Indirizzo dell'host a cui connettersi
Port No Valore numerico Porta da utilizzare per questa connessione
Attach to running session N/D Valore booleano Falso Specifica se collegare a una sessione di terminale attualmente aperta/in esecuzione

Variabili prodotte

Argomento Type Descrizione
TerminalSession Terminal session Sessione di terminale specifica da utilizzare con i comandi di emulazione terminale successivi

Eccezioni

Eccezione Descrizione
Errore durante la comunicazione con l'emulatore Indica un problema durante la connessione all'emulatore
Errore profilo Errore profilo

Chiudi sessione di terminale

Chiudi una sessione di terminale aperta.

Parametri di input

Argomento Facoltativo Accetta Valore predefinito Descrizione
Terminal session to close No Terminal session Sessione di terminale aperta in precedenza

Variabili prodotte

Questa azione non produce variabili.

Eccezioni

Eccezione Descrizione
Errore durante la comunicazione con l'emulatore Indica un problema durante la connessione all'emulatore

Sposta cursore sulla sessione di terminale

Sposta il cursore del terminale alla posizione specificata.

Parametri di input

Argomento Facoltativo Accetta Valore predefinito Descrizione
Terminal session No Sessione terminale Sessione di terminale da utilizzare
Row No Valore numerico Posizione verticale del cursore sulla schermata
Column No Valore numerico Posizione orizzontale del cursore sulla schermata

Variabili prodotte

Questa azione non produce variabili.

Eccezioni

Eccezione Descrizione
Posizione schermata fuori intervallo Indica che la posizione della schermata è fuori intervallo
Comandi di posizione non supportati dall'emulatore Indica che i comandi di posizione utilizzati non sono supportati dall'emulatore
Operazione non disponibile per questo tipo di sessione Indica che l'operazione non è disponibile per questo tipo di sessione
Errore durante la comunicazione con l'emulatore Indica un problema durante la connessione all'emulatore

Ottieni testo da sessione di terminale

Recupera testo da una sessione di terminale.

Parametri di input

Argomento Facoltativo Accetta Valore predefinito Descrizione
Terminal session No Sessione terminale Sessione di terminale da utilizzare
Get text from N/D Campo, Schermo intero, Posizione del cursore, Posizione specifica Campo Posizione da cui ottenere il testo
Get field by N/D Etichetta, Indice, Posizione Label Specifica in che modo cercare il campo
Label No Valore di testo Etichetta del campo da cercare
Index No Valore numerico Indice del campo da cercare
Text length No Valore numerico Lunghezza del testo da ricevere
Row No Valore numerico Posizione verticale del campo sulla schermata
Column No Valore numerico Posizione orizzontale del campo sulla schermata

Variabili prodotte

Argomento Type Descrizione
TerminalText Valore di testo Testo recuperato dalla sessione di terminale

Eccezioni

Eccezione Descrizione
Errore durante la comunicazione con l'emulatore Indica un problema durante la connessione all'emulatore
Indice campo fuori intervallo Indica che l'indice del campo è fuori intervallo
Etichetta campo non trovata Indica che l'etichetta del campo non esiste
Posizione schermata fuori intervallo Indica che la posizione della schermata è fuori intervallo
Nessun campo trovato alla posizione specificata Indica che non esiste un campo alla posizione specificata
Schermata terminale non formattata Indica che la schermata del terminale non è formattata
Comandi di posizione non supportati dall'emulatore Indica che i comandi di posizione utilizzati non sono supportati dall'emulatore
Operazione non disponibile per questo tipo di sessione Indica che l'operazione non è disponibile per questo tipo di sessione

Imposta testo su sessione di terminale

Imposta testo su una sessione di terminale.

Parametri di input

Argomento Facoltativo Accetta Valore predefinito Descrizione
Terminal session No Terminal session Sessione di terminale da utilizzare
Testo No Input crittografato diretto o valore di testo Testo da impostare sulla posizione specificata
Set text N/D Posizione cursore, Campo Campo Posizione su cui impostare il testo
Get field by N/D Etichetta, Indice, Posizione Label Specifica il modo in cui cercare il campo
Label No Valore di testo Etichetta del campo da cercare
Index No Valore numerico Indice del campo sulla schermata
Row No Valore numerico Posizione verticale del campo sulla schermata
Column No Valore numerico Posizione orizzontale del campo sulla schermata
Treat @ character as literal N/A Valore booleano False Seleziona questa casella per inviare il carattere "@" come valore letterale. Lascia questa opzione disabilitata per inviarlo come carattere speciale

Variabili prodotte

Questa azione non produce variabili.

Eccezioni

Eccezione Descrizione
Errore durante la comunicazione con l'emulatore Indica un problema durante la connessione all'emulatore
Indice campo fuori intervallo Indica che l'indice del campo è fuori intervallo
Etichetta campo non trovata Indica che l'etichetta del campo non esiste
Posizione schermata fuori intervallo Indica che la posizione della schermata è fuori intervallo
Nessun campo trovato alla posizione specificata Indica che non esiste un campo alla posizione specificata
Schermata terminale non formattata Indica che la schermata del terminale non è formattata
Comandi di posizione non supportati dall'emulatore Indica che i comandi di posizione utilizzati non sono supportati dall'emulatore
Operazione non disponibile per questo tipo di sessione Indica che l'operazione non è disponibile per questo tipo di sessione
Testo di input rifiutato Indica che il testo di input è stato rifiutato

Invia tasto a sessione di terminale

Invia un tasto di controllo a una sessione di terminale.

Parametri di input

Argomento Facoltativo Accetta Valore predefinito Descrizione
Terminal session No Sessione terminale Sessione di terminale da utilizzare
Control key N/D Trasmetti, Cursore Alt, Attenzione, Backspace, Tabulazione indietro, Attiva/disattiva blocco, Interruzione, Annulla, Centro, Cancella, Cancella comm, Cancella visualizzazione, Cancella riga, Cancella pagina, Cancella partizione, Virgola, Riga di comando, Finestra di comando, Componi, 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 + Maiusc + F1, Ctrl + Maiusc + F2, Ctrl + Maiusc + F3, Ctrl + Maiusc + F4, Ctrl + Maiusc + F5, Ctrl + Maiusc + F6, Ctrl + Maiusc + F7, Ctrl + Maiusc + F8, Ctrl + Maiusc + F9, Ctrl + Maiusc + F10, Ctrl + Maiusc + F11, Ctrl + Maiusc + F12, Intermittenza cursore, Selezione cursore, Decimale, Elimina, Elimina carattere, Elimina riga, Elimina parola, Backspace distruttivo, Disconnetti, Esegui, Giù, Doppia in basso, Dup, Duplica, Modifica script, Fine chiave, Fine campo, Cancella EOF, Cancella EOL, Cancella EOP, Cancella input, Esc, 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, Delimitatore campo, Uscita campo, Contrassegno campo, Campo meno, Campo più, Trova, Hard reset, Guida, 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, Mantieni, Mantieni cancella, Mantieni imposta, Home, Home in basso, Home in alto, Ins, Inserisci car, Insert here, Inserisci qui, Inserisci riga, Modalità di inserimento, Chiave non valida, KeyPad0, KeyPad1, KeyPad2, KeyPad3, KeyPad4, KeyPad5, KeyPad6, KeyPad7, KeyPad8, KeyPad9, Sinistra, Doppia a sinistra, Avanzamento riga, Meno, Attiva/disattiva monitor, Nuova riga, Pagina successiva, Schermata successiva, Parola successiva, Nul, Bloc Num, PA1, PA2, PA3, Pagina, Pagina giù, Pagina su, Panoramica a sinistra, Panoramica a destra, Jump di partizione, PF1, PF2, PF3, PF4, Plus CR, Parola precedente, PaginaPrecedente, SchermataPrecedente, Stampa, Stampa riga, Stampa messaggio, Stampa schermata, Rimuovi, Sostituisci, Reimposta, Torna, Riserva campo, Destra, Doppia a destra, Scorri in basso, Scorri in alto, Linea della regola, Esegui script, Scorri verso il basso, Scorri a sinistra, Scorri a destra, Scorri verso l'alto, Seleziona, Invia, Invia risposta, Invia eliminazione, Invia riga, Invia messaggio, Maiusc + Backspace, Maiusc + Elimina, Maiusc + Giù, Maiusc + F1, Maiusc + F2, Maiusc + F3, Maiusc + F4, Maiusc + F5, Maiusc + F6, Maiusc + F7, Maiusc + F8, Maiusc + F9, Maiusc + F10, Maiusc + F11, Maiusc + F12, Maiusc + F13, Maiusc + F14, Maiusc + F15, Maiusc F16, Maiusc + F17, Maiusc + F18, Maiusc + F19, Maiusc + F20, Maiusc + Home, Maiusc + Insert, Maiusc + Sinistra, Maiusc + Stampa schermo, Maiusc + Destra, Maiusc + Su, Soft reset, Richiesta di sistema, Tabulazione, Zoom Tek, Pagina successiva term, Pagina precedente term, Test, Assistenza testo inizio grassetto, Assistenza testo inizio riga, Assistenza testo inizio sottolineatura, Assistenza testo inizio sottolineatura, Assistenza testo ritorno a capo, Assistenza testo centratura testo, Assistenza testo fine grassetto, Assistenza testo fine riga, Assistenza testo mezzo indice in giù, Assistenza testo mezzo indice in su, Assistenza testo inserimento simboli, Assistenza testo arresto successivo, Assistenza testo colonna di testo successiva, Assistenza testo fine pagina, Assistenza testo spazio necessario, Assistenza testo tabulazione richiesta, Assistenza testo arresto, Assistenza testo avanzamento tabulazione testo, Assistenza testo inizio pagina, Assistenza testo sottolineatura a parola, Attiva/disattiva traccia, 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, Su, Doppia in alto Trasmetti Tasto da inviare alla sessione

Variabili prodotte

Questa azione non produce variabili.

Eccezioni

Eccezione Descrizione
Errore durante la comunicazione con l'emulatore Indica un problema durante la connessione all'emulatore
Tasto non supportato Indica che il tasto non è supportato

Attendi testo su sessione di terminale

Attendi che venga visualizzato un testo specifico in una sessione di terminale.

Parametri di input

Argomento Facoltativo Accetta Valore predefinito Descrizione
Terminal session No Sessione terminale Sessione di terminale aperta in precedenza
Text to wait for No Valore di testo Testo o espressione regolare da attendere che venga visualizzato sulla schermata del terminale o su un campo specificato
Regular expression N/D Valore booleano Falso Specifica se attendere un'espressione regolare anziché un testo normale
Wait for text location N/D Schermo, Campo Schermo Posizione in cui si attende venga visualizzato il testo
Get field by N/D Etichetta, Indice, Posizione Label Specifica il modo in cui cercare il campo
Label No Valore di testo Etichetta del campo da cercare
Index No Valore numerico Indice del campo da cercare
Row No Valore numerico Posizione verticale del campo sulla schermata
Column No Valore numerico Posizione orizzontale del campo sulla schermata
Timeout Valore numerico 0 Tempo massimo di attesa

Nota

Il motore delle espressioni regolari di Power Automate è .NET. Per ulteriori informazioni sulle espressioni regolari, vedi Linguaggio di espressioni regolari - Riferimento rapido.

Variabili prodotte

Questa azione non produce variabili.

Eccezioni

Eccezione Descrizione
Errore durante la comunicazione con l'emulatore Indica un problema durante la connessione all'emulatore
Indice campo fuori intervallo Indica che l'indice del campo è fuori intervallo
Etichetta campo non trovata Indica che l'etichetta del campo non esiste
Posizione schermata fuori intervallo Indica che la posizione della schermata è fuori intervallo
Nessun campo trovato alla posizione specificata Indica che non esiste un campo alla posizione specificata
Schermata terminale non formattata Indica che la schermata del terminale non è formattata
Comandi di posizione non supportati dall'emulatore Indica che i comandi di posizione utilizzati non sono supportati dall'emulatore
Operazione non disponibile per questo tipo di sessione Indica che l'operazione non è disponibile per questo tipo di sessione
Timeout scaduto Indica che il timeout è scaduto

Cerca il testo nella sessione del terminale

Cerca tutte le occorrenze di un testo specifico in una sessione del terminale

Parametri di input

Argomento Facoltativo Accetta Valore predefinito Descrizione
Terminal session No Sessione terminale Sessione di terminale aperta in precedenza
Testo da cercare No Valore di testo Testo o espressione regolare da cercare nella schermata del terminale
Regular expression N/A Valore booleano False Specifica se cercare un'espressione regolare anziché un testo normale
Dimensioni colonna No Valore numerico 80 Numero di colonne sulla schermata del terminale

Nota

Il motore delle espressioni regolari di Power Automate è .NET. Per ulteriori informazioni sulle espressioni regolari, vedi Linguaggio di espressioni regolari - Riferimento rapido.

Variabili prodotte

Argomento Type Descrizione
FindResults DataTable Risultati della ricerca recuperati dalla schermata della sessione del terminale

Eccezioni

Eccezione Descrizione
Errore durante la comunicazione con l'emulatore Indica un problema durante la connessione all'emulatore
Testo non trovato Indica che il testo cercato non è stato trovato
Espressione regex non valida Indica che l'espressione regolare usata non è valida