Instancia

Descripción General: #

Este comando es tu aliado perfecto cuando STELA encuentra varios elementos que parecen ser el mismo objeto. Imagina que estás buscando un botón en una página web, pero hay varios botones iguales. El comando «Instancia» te permite decirle a tu robot digital cuál de esos botones exactamente quieres usar.

Ejemplo de Uso Rápido #

Imagina que estás automatizando un proceso donde necesitas hacer clic en un botón que dice «Enviar». Sin embargo, en la pantalla hay dos botones idénticos que dicen «Enviar». Por defecto, STELA podría interactuar siempre con el primero que encuentra. Con el comando Instancia, puedes indicarle a STELA que, en esta ocasión, necesitas interactuar con el segundo botón «Enviar». Simplemente le dirías al comando Instancia que el objeto es el botón «Enviar» y el número de instancia es 2. ¡Así, tu robot digital sabrá exactamente qué botón usar!

Parámetros y Opciones #

El comando Instancia tiene dos parámetros principales que debes configurar:

• Objeto: Aquí debes especificar el objeto al que quieres asignarle un número de instancia. Este parámetro es muy flexible y puede aceptar diferentes tipos de entradas que ya conoces en STELA:

  • Objeto: Un elemento directamente identificado en la interfaz de la aplicación que estás automatizando.
  • Variable: Una variable que contenga la referencia a un objeto.
  • Constante: Un valor fijo que represente un objeto.
  • Editor Extendido: Una forma avanzada de definir o seleccionar un objeto utilizando expresiones o criterios más complejos.

• Instancia: Este es el número que identifica la instancia específica del objeto que quieres utilizar, este parámetro es obligatorio. Solo acepta números enteros positivos (lo que llamamos «naturales»), pero al igual que el parámetro Objeto, puedes ingresar este valor de diferentes maneras:

  • Natural: Un número entero positivo directamente (1, 2, 3, etc.).
  • Variable: Una variable que contenga un número entero positivo.
  • Constante: Un valor numérico fijo que sea un entero positivo.
  • Editor Extendido: Una forma avanzada de definir el número de instancia utilizando expresiones o cálculos.

Cuando configuras estos dos parámetros, el comando Instancia le indica a STELA que, para el objeto especificado, debe utilizar la instancia con el número que has proporcionado. Esta información se guarda internamente para que los siguientes comandos dentro de tu flujo de trabajo sepan a qué elemento exacto referirse.

Ejemplos de Uso Avanzado #

1. Selección Dinámica de Filas en una Tabla: Imagina que estás automatizando la extracción de datos de una tabla en una aplicación. Esta tabla siempre tiene la misma estructura de columnas, por lo que cada fila podría ser considerada una «instancia» del objeto «fila de la tabla». Si necesitas interactuar con la tercera fila específicamente, podrías identificar el objeto como «fila de la tabla» y usar el comando Instancia con el valor 3 en el parámetro Instancia.

2. Manejo de Múltiples Ventanas o Pestañas: En algunos casos, una aplicación puede abrir varias ventanas o pestañas que tienen elementos con nombres similares. Por ejemplo, podrías tener varias ventanas de «Detalle del Producto». Si necesitas interactuar con la segunda ventana que se abrió, podrías identificar el objeto como «Ventana Detalle del Producto» y usar el comando Instancia con el valor 2. Esto aseguraría que tu robot digital esté trabajando en la ventana correcta.

3. Iteración sobre Elementos Repetitivos: Aunque el comando Instancia por sí solo no realiza una iteración, puedes combinarlo con otras funcionalidades de STELA (como un bucle o una variable que se incrementa) para procesar múltiples instancias de un mismo objeto de forma secuencial. Por ejemplo, podrías tener una lista de elementos con la misma estructura y, dentro de un bucle, usar una variable como el valor del parámetro Instancia para acceder a cada elemento uno por uno.

Errores Comunes y Soluciones #

• Ingresar un número de instancia no válido (no natural): Recuerda que el parámetro Instancia solo acepta números enteros positivos. Si ingresas un cero, un número negativo o un decimal, STELA mostrará un error.

Solución: Asegúrate de ingresar un número entero mayor que cero.

• La instancia especificada no existe: Si indicas un número de instancia que es mayor que la cantidad de objetos encontrados, STELA no podrá encontrar esa instancia y tu automatización podría fallar.

Solución: Verifica cuántas instancias del objeto existen realmente.

Casos de Uso #

• Automatización de tareas repetitivas con múltiples elementos similares: Cuando necesitas interactuar con varios elementos que se ven iguales pero son distintos (como elementos en una lista, filas en una tabla o resultados de una búsqueda).
• Selección precisa de elementos en interfaces complejas: En aplicaciones donde hay muchos elementos visualmente idénticos, este comando te permite especificar exactamente con cuál quieres interactuar, evitando clics o interacciones incorrectas.
• Captura de datos visuales específicos: Si necesitas obtener información de una instancia particular de un objeto (por ejemplo, el precio del tercer producto en una lista), el comando Instancia te asegura que estás obteniendo los datos del elemento correcto.