El Editor Extendido es una herramienta de edición de texto que se puede utilizar dentro de los comandos de STELA, es una forma dinámica de ingresar texto plano combinado con variables y/o constantes. Su función principal es permitir al usuario configurar datos, variables y expresiones de una manera visual y controlada.
Usos más comunes #
- Gestión de Variables y Constantes: Permite invocar Objetos de Valor Compartido (OVC) sin riesgo de errores de sintaxis. Puedes seleccionar variables y/o constantes previamente definidas y combinarlas con texto estático, como por ejemplo en ciclos o procesos de lectura/escritura.
- Creación del cuerpo del correo: utilizando etiquetas HTML en combinación con texto, variables y/o constantes
- Manipulación de Datos Dinámicos: Es ideal para configurar comandos que requieren entradas complejas, como rutas de archivos o construir atributos capturados (ID, XPath, CSS) de los objetos para asegurar que el robot sea robusto ante cambios en la interfaz de la aplicación.
- Soporte para Expresiones Regulares: En comandos de procesamiento de texto (como Split), el editor extendido facilita la inserción de patrones complejos para dividir o filtrar información.
Uso del Editor extendido en el parámetro valor del comando #
Para acceder al editor se debe dar clic en el menú lateral del parámetro (Objeto o Valor)
Al dar clic en Editor Extendido se muestra el Editor
- La lista de variables se despliega escribiendo “@”. Dar clic en la variable que se requiera para seleccionarla.
- La lista de constantes se despliega escribiendo “#”
Para combinar texto con elementos dinámicos, siempre se debe dejar un espacio después del texto antes de escribir los disparadores (@ para variables o # para constantes). Una vez que el elemento se ha seleccionado del listado, el cursor se puede desplazar hacia la izquierda para eliminar el espacio si la lógica de la cadena de texto así lo requiere.
Para buscar la variable que se desea seleccionar, podemos escribir las primeras letras y si existe, se mostrará en el listado
Una vez seleccionada ya se puede eliminar el espacio a la izquierda si así se requiere.
Uso del Editor extendido para construir atributos en objetos #
Ideal para objetos de una aplicación Web que comparten un mismo atributo como por ejemplo la clase “class” pero cambia el texto o el valor, como es el caso muchas veces de las listas desplegables, grupo de opciones y tablas.
Escenarios comunes
- Listas Desplegables: Por ejemplo todas las opciones tienen la clase select-option, pero solo una tiene el texto «México».
- Grupos de Radio Buttons: Comparten el name, pero cambia el Value.
- Tablas de Datos: Todas las celdas son <td>, pero necesitas la que contiene un número de factura específico.
¿Cómo se utiliza?
En el comando damos clic al parámetro Objeto para crearlo. Se abrirá el formulario de creación de objeto “Nuevo Objeto”
- Se selecciona la propiedad del objeto y el editor extendido
- Se construye el xPath o el atributo seleccionado. Se puede combinar con variables, constantes y/o texto
Uso del editor extendido en comandos Mail #
Cuando utilizas comandos Mail (Enviar Mail, Responder Mail), el campo «Mensaje» suele ser limitado. Sin embargo, al abrir el Editor Extendido, puedes construir un cuerpo de correo más estructurado.
Escenarios comunes
- Personalización Dinámica: Puedes saludar al cliente por su nombre usando una variable: «<p>Hola @nombreCliente,</p>».
- Tablas de Datos: Puedes insertar tablas HTML para mostrar resultados de un proceso que el robot acaba de ejecutar.
- Formato Profesional: Permite añadir negritas, colores corporativos y enlaces rastreables.
Ejemplo con HTML en el Editor Extendido #
Imagina que quieres enviar un correo de confirmación de pedido. En el recuadro del Editor Extendido escribirías algo como esto:
Recordatorio de Uso #
Para que el Editor Extendido reconozca tus etiquetas y variables sin errores
- Escribe la etiqueta HTML (ej. <b>) o un texto.
- Da un espacio.
- Escribe @ para invocar tu variable (ej. @primer_nombre).
- Cierra la etiqueta (ej. </b>).
- Opcional: Regresa con el cursor y elimina el espacio si quieres que el texto quede pegado a la variable.