Acciones de emulación de terminal
Power Automate proporciona integración con emuladores de terminal a través de las acciones Emulación de terminal. Estas acciones le permiten manejar terminales y ordenadores centrales, y realizar operaciones, como mover el cursor, configurar y obtener texto, y enviar claves.
Antes de implementar cualquier acción de terminal, use la acción Sbrir sesión de terminal para abrir una nueva conexión con el proveedor instalado.
Importante
Antes de intentar conectarse a una sesión de terminal, asegúrese de que la sesión de terminal real ya esté abierta en su máquina.
Si ha instalado Micro Focus Reflection en su escritorio, elija la opción respectiva en la propiedad Proveedor de la acción y complete la configuración requerida.
Si ha instalado otro proveedor, seleccione HLLAPI, que funciona con la mayoría de los proveedores de emulación de terminales.
Dependiendo del proveedor que esté utilizando, seleccione el archivo DLL HLLAPI apropiado ubicado en su carpeta de instalación. En la siguiente lista, puede ver los nombres de archivo DLL HLLAPI de algunos proveedores populares de emulación de terminales:
- RocketSoftware BlueZone: ehlapi64.dll
- IBM Personal Communications: EHLAPI32.dll
- MicroFocus Rumba: System/ehlapi32.Dll
- Cybelesoft zScope: zHllap32.dll
Nota
La DLL HLLAPI de Windows (WinHLLAPI) no es compatible actualmente.
Después de abrir una sesión de terminal y completar todas las operaciones deseadas, finalice la conexión usando la acción Cerrar sesión de terminal. Si no cierra la conexión, algunos proveedores no le permitirán conectarse nuevamente a la sesión ya abierta sin reiniciar el software o la conexión.
Abrir sesión de terminal
Permite abrir una nueva sesión de terminal.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Provider | N/D | Reflexión de Micro Focus, HLLAPI | Reflexión de Micro Focus | Emulación de terminal para usar |
| HLLAPI DLL path | No | Archivo | DLL HLLAPI del proveedor. Nombre predeterminado de RocketSoftware BlueZone: 'ehlapi64.dll'. Nombre predeterminado de IBM Personal Communications: 'EHLAPI32.dll'. Ruta predeterminada de MicroFocus Rumba: 'System / ehlapi32.Dll'. Nombre predeterminado de Cybelesoft zScope: 'zHllap32.dll'. Cualquier otro proveedor que ofrezca una DLL HLLAPI en su carpeta de instalación. | |
| Installation path | No | Carpeta | Ruta de instalación de la aplicación del proveedor en el sistema de archivos del usuario | |
| Configuración | N/D | Perfil existente, especificar conexión | Perfil existente | Elija 'Perfil existente' para seleccionar un archivo que contenga una conexión de emulación de terminal preconfigurada. Elija 'Especificar conexión' para especificar el tipo de conexión, la dirección del host y el puerto. |
| Session name | No | Valor de texto | Nombre de la sesión a la que se conectará. El nombre corto de HLLAPI y es un identificador único para la sesión de host. Se puede encontrar en los ajustes de configuración del emulador de terminal. | |
| Host type | N/D | IBM 3270, IBM 5250 | IBM 3270 | Tipo de host de la conexión |
| Profile | No | Archivo | Archivo que contiene la conexión preconfigurada | |
| Host address | No | Valor de texto | Dirección de host a la que se conectará | |
| Port | No | Valor numérico | Puerto que se usará para esta conexión | |
| Attach to running session | N/D | Valor booleano | False | Especifica si se va a conectar a una sesión de terminal abierta o en ejecución |
Variables producidas
| Argumento | Type | Descripción |
|---|---|---|
| TerminalSession | Terminal session | Sesión de terminal específica para su uso con comandos de emulación de terminal posteriores |
Excepciones
| Excepción | Descripción |
|---|---|
| Error de comunicación con el emulador | Indica un problema para conectar con emulador |
| Error de perfil | Error de perfil |
Cerrar sesión de terminal
Cerrar una sesión de terminal abierta.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Terminal session to close | No | Terminal session | Sesión de terminal abierta anteriormente |
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
| Excepción | Descripción |
|---|---|
| Error de comunicación con el emulador | Indica un problema para conectar con emulador |
Mover el cursor en la sesión de terminal
Mueve el cursor del terminal en la posición especificada.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Terminal session | No | Sesión de terminal | Sesión de terminal con la que se trabaja | |
| Row | No | Valor numérico | Posición vertical del cursor en la pantalla | |
| Column | No | Valor numérico | Posición horizontal del cursor en la pantalla |
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
| Excepción | Descripción |
|---|---|
| Posición de pantalla fuera de los límites | Indica que la posición de pantalla está fuera de los límites |
| El emulador no admite los comandos de posición | Indica que el emulador no admite los comandos de posición utilizados |
| Operación no disponible para este tipo de sesión | Indica que la operación no está disponible para este tipo de sesión |
| Error de comunicación con el emulador | Indica un problema para conectar con emulador |
Obtener el texto de una sesión de terminal
Obtiene el texto de una sesión de terminal.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Terminal session | No | Sesión de terminal | Sesión de terminal con la que se trabaja | |
| Get text from | N/D | Campo, pantalla completa, posición del cursor, posición específica | Campo | Ubicación desde la que se va a obtener el texto |
| Get field by | N/D | Etiqueta, Índice, Posición | Label | Especifica cómo buscar el campo |
| Label | No | Valor de texto | Etiqueta del campo que se busca | |
| Index | No | Valor numérico | Índice del campo que se busca | |
| Text length | No | Valor numérico | Longitud del texto que se va a recibir | |
| Row | No | Valor numérico | Posición vertical del campo en la pantalla | |
| Column | No | Valor numérico | Posición horizontal del campo en la pantalla |
Variables producidas
| Argumento | Type | Descripción |
|---|---|---|
| TerminalText | Valor de texto | Texto recuperado de la sesión de terminal |
Excepciones
| Excepción | Descripción |
|---|---|
| Error de comunicación con el emulador | Indica un problema para conectar con emulador |
| Índice de campo fuera de los límites | Indica que el índice de campo está fuera de los límites |
| No se encuentra la etiqueta de campo | Indica que la etiqueta de campo no existe |
| Posición de pantalla fuera de los límites | Indica que la posición de pantalla está fuera de los límites |
| No se encontró ningún campo en la posición especificada | Indica que no existe ningún campo en la posición especificada |
| Pantalla de terminal sin formato | Indica que la pantalla de terminal no tiene formato |
| El emulador no admite los comandos de posición | Indica que el emulador no admite los comandos de posición utilizados |
| Operación no disponible para este tipo de sesión | Indica que la operación no está disponible para este tipo de sesión |
Establecer el texto en una sesión de terminal
Establece el texto en una sesión de terminal.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Terminal session | No | Sesión de terminal | Sesión de terminal con la que se trabaja | |
| Texto | No | Entrada directa cifrada o valor de texto | Texto que se va a establecer en la ubicación especificada | |
| Establecer texto | N/D | Posición del cursor, Campo | Campo | Ubicación en la que se va a establecer el texto |
| Get field by | N/D | Etiqueta, Índice, Posición | Label | Especifica la forma en que se buscará el campo |
| Label | No | Valor de texto | Etiqueta del campo que se busca | |
| Index | No | Valor numérico | Índice del campo en la pantalla | |
| Row | No | Valor numérico | Posición vertical del campo en la pantalla | |
| Column | No | Valor numérico | Posición horizontal del campo en la pantalla | |
| Treat @ character as literal | N/A | Valor booleano | False | Marque esta casilla para enviar el carácter '@' literalmente. Deje esta opción deshabilitada para enviarlo como un carácter especial |
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
| Excepción | Descripción |
|---|---|
| Error de comunicación con el emulador | Indica un problema para conectar con emulador |
| Índice de campo fuera de los límites | Indica que el índice de campo está fuera de los límites |
| No se encuentra la etiqueta de campo | Indica que la etiqueta de campo no existe |
| Posición de pantalla fuera de los límites | Indica que la posición de pantalla está fuera de los límites |
| No se encontró ningún campo en la posición especificada | Indica que no existe ningún campo en la posición especificada |
| Pantalla de terminal sin formato | Indica que la pantalla de terminal no tiene formato |
| El emulador no admite los comandos de posición | Indica que el emulador no admite los comandos de posición utilizados |
| Operación no disponible para este tipo de sesión | Indica que la operación no está disponible para este tipo de sesión |
| Se rechazó el texto de entrada | Indica que se rechazó el texto de entrada |
Enviar tecla a sesión de terminal
Envía una tecla de control a una sesión de terminal.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Terminal session | No | Terminal session | Sesión de terminal con la que se trabaja | |
| Control key | N/D | Transmitir, Cursor Alt, Atención, Retroceso, Pestaña Atrás, Alternar bloque, Romper, Cancelar, Centro, Borrar, Borrar comunicación, Borrar pantalla, Borrar línea, Borrar página, Borrar partición, Coma, Línea de comando, Ventana de comando, Redactar, 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 + Mayús + 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, Cursor parpadeante, Cursor select, Decimal, Delete, Delete char, Delete line, Delete word, Destructive back space, Disconnect, Do, Down, Down double, Duplicar, Duplicar, Editar guión, Fin de tecla, Fin de campo, Borrar EOF, Borrar EOL, Borrar EOP, Borrar entrada, 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, campo delimitador, Salida de campo, Marca de campo, Campo menos, Campo más, Buscar, Restablecimiento completo, Ayuda, 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, Mantener, Mantener claro, Mantener configurado, Inicio, Inicio abajo, Inicio arriba, Insertar, Insertar carácter, Insertar aquí, Insertar línea, Insertar modo, tecla no válida, KeyPad0, KeyPad1, KeyPad2, KeyPad3, KeyPad4, KeyPad5, KeyPad6, KeyPad7, KeyPad8, KeyPad9, Left, Left double, Line feed, Minus, Monitor toggle, New line, Next page, Next screen, Next word, Nul, Bloq Num, PA1, PA2, PA3, Página, Página abajo, Página arriba, Desplazamiento a la izquierda, Desplazamiento a la derecha, Salto de partición, PF1, PF2, PF3, PF4, Más Cr, Palabra anterior, PrevPage, PrevScreen, Imprimir, Imprimir línea, Imprimir mensaje, Mostrar pantalla, Eliminar, Reemplazar, Restablecer, Volver, Campo de reserva, Derecha, Doble derecha, Desplazar hacia abajo, Enrollar hacia arriba, Línea de rile, Ejecutar guión, Desplazarse hacia abajo, Desplazarse izquierda, Desplazarse hacia la derecha, Desplazarse hacia arriba, Seleccionar, Enviar, Enviar respuesta, Enviar eliminar, Enviar línea, Enviar mensaje, Mayús + Retroceso, Mayús + Eliminar, Mayús + Abajo, Mayús + F1, Mayús + F2, Mayús + F3, Mayús + 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, Mayús + F17, Mayús + F18, Mayús + F19, Mayús + F20, Mayús + Inicio, Mayús + Insertar, Mayús + Izquierda, Mayús + Imprimir pantalla, Mayús + Derecha, Mayús + Arriba, Restablecimiento parcial, Solicitud del sistema, Tab, Tek Zoom, Término de la página siguiente, Término de la página anterior, Prueba, Ayuda de texto que comienza en negrita, Ayuda de texto al comienzo de la línea, Ayuda de texto al comienzo del subrayado, Ayuda de texto al final de la página, Ayuda de texto al retorno del operador, Centro de ayuda de texto, Ayuda de texto al final en negrita, Ayuda de texto Fin de línea, Ayuda de texto medio índice hacia abajo, Ayuda de texto medio índice hacia arriba, Ayuda de texto insertar símbolos, Ayuda de texto en la siguiente parada, Ayuda de texto en la siguiente columna de texto, Fin de página de ayuda de texto, Espacio requerido de ayuda de texto, Pestaña requerida de ayuda de texto, Parada de ayuda de texto, Ayuda de texto, avance de la pestaña de texto, Ayuda de texto arriba de la página e, Subrayado de palabra de asistencia de texto, Alternar trazo, 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, Arriba, Doble arriba | Transmitir | Clave que se enviará a la sesión |
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
| Excepción | Descripción |
|---|---|
| Error de comunicación con el emulador | Indica un problema para conectar con emulador |
| Clave incompatible | Indica que no se admite la clave |
Esperar el texto en la sesión de terminal
Permite esperar a que aparezca un texto específico en una sesión de terminal.
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Terminal session | No | Sesión de terminal | Sesión de terminal abierta anteriormente | |
| Text to wait for | No | Valor de texto | Texto o expresión regular que se debe esperar que aparezca en la pantalla del terminal o en un campo específico | |
| Regular expression | N/D | Valor booleano | False | Especifica si se esperará por una expresión regular en lugar de texto sin formato |
| Wait for text location | N/D | Pantalla, campo | Pantalla | Ubicación en la que se espera a que aparezca el texto |
| Get field by | N/D | Etiqueta, Índice, Posición | Label | Especifica la forma en que se buscará el campo |
| Label | No | Valor de texto | Etiqueta del campo que se busca | |
| Index | No | Valor numérico | Índice del campo que se busca | |
| Row | No | Valor numérico | Posición vertical del campo en la pantalla | |
| Column | No | Valor numérico | Posición horizontal del campo en la pantalla | |
| Temporización | Sí | Valor numérico | 0 | Tiempo máximo de espera |
Nota
El motor de expresiones regulares de Power Automate es .NET. Puede encontrar más información sobre las expresiones regulares en Lenguaje de expresiones regulares - Referencia rápida.
Variables producidas
Esta acción no produce ninguna variable.
Excepciones
| Excepción | Descripción |
|---|---|
| Error de comunicación con el emulador | Indica un problema para conectar con emulador |
| Índice de campo fuera de los límites | Indica que el índice de campo está fuera de los límites |
| No se encuentra la etiqueta de campo | Indica que la etiqueta de campo no existe |
| Posición de pantalla fuera de los límites | Indica que la posición de pantalla está fuera de los límites |
| No se encontró ningún campo en la posición especificada | Indica que no existe ningún campo en la posición especificada |
| Pantalla de terminal sin formato | Indica que la pantalla de terminal no tiene formato |
| El emulador no admite los comandos de posición | Indica que el emulador no admite los comandos de posición utilizados |
| Operación no disponible para este tipo de sesión | Indica que la operación no está disponible para este tipo de sesión |
| Se ha agotado el tiempo de espera | Indica que ha expirado el tiempo de espera |
Buscar texto en sesión de terminal
Buscar todas las repeticiones de un texto específico en una sesión de terminal
Parámetros de entrada
| Argumento | Opcionales | Acepta | Valor predeterminado | Descripción |
|---|---|---|---|---|
| Terminal session | No | Sesión de terminal | Sesión de terminal abierta anteriormente | |
| Texto que se buscará | No | Valor de texto | Texto o expresión regular que se buscará en la pantalla del terminal | |
| Regular expression | N/A | Valor booleano | False | Especifica si se buscará una expresión regular en lugar de texto sin formato |
| Tamaño de columna | No | Valor numérico | 80 | El número de columnas de la pantalla de terminal |
Nota
El motor de expresiones regulares de Power Automate es .NET. Puede encontrar más información sobre las expresiones regulares en Lenguaje de expresiones regulares - Referencia rápida.
Variables producidas
| Argumento | Type | Descripción |
|---|---|---|
| FindResults | DataTable | Los resultados de la búsqueda recuperados de la pantalla de sesión de terminal |
Excepciones
| Excepción | Descripción |
|---|---|
| Error de comunicación con el emulador | Indica un problema para conectar con emulador |
| Texto no encontrado | Indica que no se encontró el texto de búsqueda |
| Expresión de regex no válida | Indica que la expresión regular usada no es válida |