Crear Objetos

Para defiinir o crear objetos en STELA, primero debemos comprender que es un Objeto. Un objeto es una unidad que agrupa datos (características) y comportamientos (acciones que puede realizar).

Si estás automatizando pruebas o procesos en STELA, los objetos son los elementos de la página web, de la aplicación móvil, de escritorio o web con los que interactúa el robot y que realizan una acción.

Los 2 pilares de un Objeto:

Un objeto se compone de dos elementos fundamentales:

1. Atributos (Propiedades): Son las características o los datos que describen al objeto. (Responden a la pregunta: ¿Cómo es?).
2. Métodos (Funciones): Son las acciones que el objeto puede ejecutar o que se pueden realizar sobre él. (Responden a la pregunta: ¿Qué hace?).

El objeto es el elemento de la interfaz (previamente capturado con el selector de STELA en el repositorio de objetos). Ejemplo:

• Objeto: botón Buscar
• Atributos (Propiedades): texto, clase, id, name, xPath, etc.
• Acciones (Métodos): Click, Valor, Espera Objeto, Si (Obj), Mientras (Obj)

En STELA, al ser una herramienta para automatización de procesos y pruebas (RPA/QA), la gran mayoría de los comandos están diseñados para interactuar con la pantalla. Por lo tanto, todos los comandos que realizan una acción directa sobre la interfaz de usuario necesitan un objeto (también llamado elemento de interfaz o localizador).

• Comandos de Acción Directa (Requieren Objeto OBLIGATORIAMENTE): estos comandos no pueden ejecutarse si no les dices exactamente sobre qué elemento de la pantalla deben actuar.  Ejemplo: Click, Click derecho, Teclear, , Valor, Frame, Drag, etc.
• Comandos de Verificación y Control (Requieren Objeto para Validar). Estos comandos se utilizan para comprobar el estado de la aplicación o para controlar el flujo lógico (como los condicionales que mencionamos antes). Ejemplo: SI (Obj), Mientras (Obj), Propiedad, Espera Objeto, etc.

¿Como crear objetos en STELA? #

Para crear un objeto en los comandos que lo requieren, se da clic en el primer parámetro del mismo.

Al dar clic en el Parámetro «Objeto» se mostrará el formulario «Nuevo Objeto«, donde podremos crearlo.

Para crear un objeto se completa todo los campos requeridos y se da clic en el botón “CREAR”

Nuevo Objeto: Explicación de los campos #

1. Nombre

Identificador alfanumérico único asignado al objeto (con un límite de 50 caracteres). Debe estar alineado con la función lógica que cumple el control en la pantalla.

Para optimizar el orden y agilizar el mantenimiento de la automatización, se recomienda utilizar la nomenclatura estandarizada de prefijos

Objeto / Elemento	Prefijo Recomendado	Ejemplo de Nombre	Propósito Funcional
Botón	btn	btnBuscar	Ejecuta acciones directas.
Casilla de Selección (Checkbox)	chx	chxAsistir	Activa o desactiva un estado binario (Sí/No).
Campo de Valor / Entrada	txt	txtNombre	Caja de texto para la captura de datos.
Lista Desplegable (Combobox)	cmb / sel	cmbPais	Lista / Menú con opciones para seleccionar.
Enlace / Hipervínculo	lnk	lnkTerminos	Dirige al usuario a una sección o sitio externo.

2. Tipo

Menú desplegable obligatorio donde se clasifica la naturaleza técnica del objeto (elemento web o desktop), ej. botón, etiqueta, texto, imagen, frame. Esto le indica a STELA el tipo de etiqueta nativa con la que está tratando.

3. Categoría

Permite agrupar y organizar el objeto según el módulo funcional, pantalla o sección de negocio a la que pertenece, facilitando su localización en repositorios con cientos de elementos.

Si la categoría ya existe, puede seleccionarla directamente de la lista; de lo contrario, puede crear una nueva haciendo clic en “AGREGAR CATEGORÍA”.

4. Adjuntar imagen o video

Mediante el botón «seleccionar archivo», se puede subir una captura visual o multimedia (video) del elemento en la aplicación. Sirve como documentación de soporte y ayuda visual para el equipo de automatización.

5. Objeto padre y Checkbox «Shadow host»

Define la jerarquía de nodos en la interfaz. El campo Objeto padre permite seleccionar este elemento a un contenedor superior. 

Para relacionar un objeto “padre” al objeto, se da clic en el botón “flecha” hacia abajo y se selecciona el objeto, este debe estar previamente creado.

La casilla Shadow host es una opción avanzada de alto impacto técnico:

• Al marcar este Check, se le indica a STELA que este objeto en particular sirve como la «puerta de entrada» a un Shadow DOM (un árbol web encapsulado y aislado).
• Esta configuración permite que el robot sepa que debe atravesar la barrera del aislamiento e ingresar a la raíz del Shadow Root para poder interactuar correctamente con los botones, textos o campos internos que estén ocultos para los selectores convencionales de automatización.

6. Propiedades

Permite seleccionar el localizador (ej. XPath, ID, CSS Selector, Name) e introducir el texto correspondiente en el campo Valor. Cuenta con botones complementarios para añadir nuevas filas correlativas (+) o importar parámetros de captura.

Para asociar la propiedad, seleccione la opción que corresponda al elemento y complete el campo Valor.

Agregar Propiedades

Para agregar propiedades adicionales, dar clic en el botón “+” y completar el campo Valor

Agregar propiedades desde el Inspector e STELA

Es posible importar las propiedades directamente desde el Inspector de STELA (la extensión del navegador). Para ello, utilice el botón «Pegar».

Para vincular rápidamente las propiedades de un elemento utilizando el inspector de STELA (extensión del navegador), siga estos pasos:

1. Haga clic en el botón «Pegar».
2. En la ventana emergente que aparece, pegue la información (localizador) copiada desde el Inspector de STELA.

3. Haga clic en el botón «GUARDAR CAMBIOS»; la propiedad del objeto se cargará y asociara de forma automática.

4. Tras verificar que todos los campos del formulario estén correctos, haga clic en «CREAR».

Buenas Prácticas #

1. No usar nombres genéricos: Evite identificadores automáticos como objeto_1 o campo_texto. Si la aplicación cambia, será imposible identificar qué elemento está fallando.
2. Uso estratégico del Shadow Host: Utilice la casilla de Shadow host únicamente en el elemento contenedor raíz (el anfitrión). Los elementos hijos internos se buscan normalmente una vez que STELA ha entrado con éxito al espacio privado del Shadow DOM.
3. Consistencia: Mantenga los mismos criterios de nombres y prefijos entre los diferentes integrantes del equipo para asegurar la reutilización de objetos.