Un iterador de bucle es una variable que realiza un seguimiento de la iteración actual dentro de un bucle. Se utiliza para controlar la cantidad de veces que se ejecuta el bucle y para acceder a los elementos de una lista o matriz durante cada iteración.

Por ejemplo, si está pasando un bucle en una lista de elementos, el iterador de bucle le ayudará a acceder a cada elemento uno por uno hasta que el bucle se complete. El Loop package ofrece varias condiciones de iterador para controlar la iteración de bucles.
Tabla 1. Iteradores de bucle
Iterador Descripción
Para cada fila en CSV/TXT Repite el conjunto de actions para cada fila en el archivo especificado CSV o de texto y asigna los valores en la fila actual a una variable de Registro. Consulte Uso del iterador Para cada fila en CSV/TXT.
Para cada fila en Data Table Repite el conjunto de actions para cada fila en la tabla especificada y asigna los valores en la fila actual a una variable de Registro. Consulte Seleccione el iterador Para cada fila de la tabla.
Para cada fila de un conjunto de datos de consulta SQL Repite el conjunto de actions para cada fila en el conjunto de datos de consultas SQL especificado y asigna los valores en la fila actual a una variable de Registro. Proporcione el nombre de sesión que ha utilizado para establecer una conexión con la base de datos.
Para cada clave en Dictionary Repite el conjunto de actions para cada clave en la variable del diccionario especificada y asigna el nombre de la clave actual a una variable.
Nota: Cuando un bot ejecuta una action de Bucle que contiene una action Diccionario > Colocar, el bot solo itera sobre el número original de elementos en un diccionario; ignora los elementos insertados mediante la action Colocar.
Para cada valor en Dictionary Repite el conjunto de actions para cada valor en la variable de diccionario especificada y asigna el valor actual a una variable. Dado que este tipo de variable puede contener varios subtipos (string, número, booleano, etc.), si crea rápidamente una variable mientras configura la acción, la variable es del tipo Cualquiera.
Nota: Cuando un bot ejecuta una action de Bucle que contiene una action Diccionario > Colocar, el bot solo itera sobre el número original de elementos en un diccionario; ignora los elementos insertados mediante la action Colocar.
Para cada correo en el buzón de correo Repite el conjunto de actions para cada correo electrónico en el buzón especificado. Consulte Iterador para cada correo del buzón de correo.
Para cada fila de la hoja de cálculo (Excel basic o Excel advanced) Repite el conjunto de actions para cada fila que contenga datos en una hoja de trabajo y asigna los valores en la fila actual a una variable de registro. Proporcione el nombre de sesión que ha utilizado para abrir la Excel basic o la hoja de cálculo Excel advanced. Especifique si desea repetir las actions para todas las filas, filas especificadas o un rango de celdas especificado. Seleccione una variable de registro de la lista Asignar la fila actual a esta variable o cree una nueva. Consulte Variable de registro.
Este iterador recupera los valores de celda como tipos de datos de cadena. Admite formatos de celdas de Excel, incluidos Número, Porcentaje, Moneda, Científico y Fecha. Por ejemplo, un valor de una celda de formato de moneda conserva el símbolo de moneda cuando se pasa a una variable de tabla o registro.
  • Debe convertir los valores para realizar operaciones que no sean de cadena.
  • En Excel advanced, cuando elige el iterador de bucle con la opción Para cada fila de la hoja de cálculo, tiene la opción Leer para leer el texto visible o el valor de la celda.

    Por ejemplo, si la celda tiene 70 % como contenido de celda, la opción Leer valor de celda leerá el valor como 70 ignorando el formato de %, mientras que la opción Leer texto visible leerá el contenido como 70 %.

    Recomendación: Utilice la opción Leer valor de celda como el valor de lectura para un mejor rendimiento que la lectura de texto visible.

No se encuentra disponible la opción de Sesión global para compartir una sesión de Microsoft Excel si se utiliza el Excel advanced package.

Solución alternativa: Utilice la action Obtener varias celdas y guarde los datos en una variable de la tabla de datos y, a continuación, utilice el package de Loop con la opción de Tabla de datos seleccionada.

Para cada fila de la tabla de la hoja de cálculo

(Apple Numbers)

  • Utilice una de las siguientes opciones para proporcionar el nombre de la sesión:
    • Nombre de la sesión: Introduzca el nombre de la sesión utilizada para abrir la hoja de cálculo con la Abrir action.
    • Variable: Introduzca la variable de sesión que agregó en la action Abrir.
  • Especifique el nombre de la tabla para recuperar los valores.
  • Seleccione una de las siguientes opciones para realizar un bucle:
    • Toda la fila: seleccione esta opción para extraer todos los datos de la tabla completa, incluidas todas las filas y columnas de esa tabla.
    • Filas específicas: seleccione esta opción para extraer datos solo de la fila especificada dentro de la tabla. Complete los siguientes campos:
      • Desde la fila: especifique el número de fila desde el que desea recuperar el valor. Por ejemplo, 10
      • Hasta la fila: especifique el número de fila hasta el que desea recuperar el valor. Por ejemplo, 40
    • Rango de celdas: seleccione esta opción para extraer datos de un bloque rectangular especificado de celdas definidas por una celda inicial y una final (por ejemplo, de B2 a D5). Complete los siguientes campos:
      • Desde la celda: especifique la dirección de la celda desde la que desea que se recupere el valor. Por ejemplo, A1
      • Hasta la celda: especifique la dirección de la celda hasta la que desea que se recupere el valor. Por ejemplo, C20
  • Elija entre la opción Tipo de valor para leer el texto visible o el valor de la celda:
    • Texto visible
    • Valor de celda

    Por ejemplo, si la celda tiene "70%" como contenido de celda, la opción Valor de celda leerá el valor como "70" ignorando el formato de "%", mientras que la opción Texto visible leerá el contenido como "70%".

  • En el campo Asignar el valor actual a esta variable, seleccione una variable de registro o cree una para contener la salida. Además, puede almacenar la salida en múltiples variables proporcionando la clave y la variable a la que se asigna la clave.
Para cada archivo de la carpeta Repite el conjunto de actions para cada archivo en la carpeta especificada y asigna las propiedades del archivo actual a una variable de diccionario que contenga dos claves: la clave name contiene el nombre del archivo y la clave extension contiene la extensión del archivo.

Para abrir archivos con diferentes extensiones, utilice la opción variable para asignar la ruta de la carpeta, el nombre del archivo y la extensión del archivo. Primero, cree una variable para la ruta de la carpeta, $sFolder$. A continuación, para los archivos en la ruta de la carpeta, cree dos variables, una para el nombre del archivo $name$ y otra para la extensión del archivo $extension$. Para abrir un archivo, combine las variables como una cadena, como se muestra a continuación: $sFolder$\$name$.$extension$. Para que la extensión funcione con diferentes tipos de archivos y diferentes opciones de apertura, se puede añadir una lógica condicional.

Para cada carpeta de la carpeta Repite el conjunto de actions para cada carpeta en la carpeta especificada y asigna el nombre de la carpeta actual a una variable de cadena.

Utilice la opción Incluir todas las subcarpetas para iterar de forma recursiva cada subcarpeta de una carpeta, incluidas las carpetas ocultas.

Para cada elemento de la lista Repite el conjunto de actions para cada elemento de la lista especificada y asigna el elemento actual a una variable. Especifique si desea repetir la action para todos los elementos de la lista o sólo para un rango de elementos de la lista. Dado que este tipo de variable puede contener varios subtipos (cadena, número, booleano, etc.), si crea rápidamente una variable mientras configura la action, la variable es de cualquier tipo.
Nota: El índice en una lista comienza desde cero. Por ejemplo, para repetir la action para los elementos de la tercera posición a la sexta posición de la lista, especifique 2 y 5 en los campos adecuados.
Durante n veces Repite las actions en el contenedor la cantidad de veces especificada. Puede asignar el conteo de iteración a una variable de Número.
Para cada valor en el registro Repite las actions para cada valor en el registro especificado y asigna el valor actual a una variable. Dado que este tipo de variable puede contener varios subtipos (string, número, booleano, etc.), si crea rápidamente una variable mientras configura la acción, la variable es del tipo Cualquiera.
Para cada reunión del calendario Utilice esta opción para repetir el conjunto de actions para cada reunión en el calendario especificado. Consulte Uso de Microsoft 365 Calendar acciones en un bucle.
Para cada fila de la hoja de cálculo (Microsoft 365 Excel) Repite el conjunto de actions para cada fila que contiene datos en una hoja de cálculo.
  • Proporcione el nombre de sesión que ha utilizado para abrir la hoja de cálculo.
  • Especifique si debe repetir el actions para todas las filas o para filas específicas.
  • Puede asignar los valores en la fila actual a una variable de Registro.
Para cada correo en el buzón de correo (Apple Mail) Consulte Uso del iterador Para cada correo del buzón de correo para Apple Mail.
Para cada correo en el buzón de correo (Microsoft 365 Outlook) Repite el conjunto de actions para cada correo electrónico en la bandeja de entrada de Microsoft 365 Outlook.
  • Ingrese el nombre de sesión que utilizó en la action Conectar.
  • Especifique el estado del correo electrónico que desea utilizar con el iterador. Por ejemplo, para usarlo en correos electrónicos que aún no ha leído, seleccione No leídos.
  • Establezca el orden en el que desea que se ordenen los correos electrónicos seleccionando una de las siguientes opciones en el campo Ordenar correo electrónico:
    • El más reciente primero: Cuando la versión del package Microsoft 365 Outlook se actualice a 1.6.1 o posterior, las automatizaciones existentes y nuevas tendrán esta configuración habilitada, y todos los correos electrónicos del buzón se ordenarán por defecto según el método LIFO.
    • El más antiguo primero: Esta configuración habilita el método FIFO para ordenar los correos electrónicos en el buzón. Esta configuración es pertinente para todas las actions de Microsoft 365 Outlook que se pueden realizar utilizando iteradores de bucle, como los siguientes:
      • Cambiar estado
      • Eliminar
      • Reenviar
      • Responder
      • Guardar archivos adjuntos
      • Guardar correo electrónico
  • Configure el formato del mensaje a HTML o texto sin formato.
  • Seleccione una zona horaria específica.
Microsoft Outlook (macOS): para cada correo del buzón de correo Consulte Uso del iterador de Bucle para Microsoft Outlook (macOS).
Para cada chat del usuario (Microsoft Teams) Consulte Using the For each chat of the user iterator.
Para cada canal de un equipo (Microsoft Teams) Consulte Using the For each channel in a team iterator.
Para cada mensaje en un canal (Microsoft Teams) Consulte Using the For each message in a channel iterator.
Para cada mensaje en un chat (Microsoft Teams) Consulte Utilizar el iterador Para cada mensaje en un chat.
Para cada equipo (Microsoft Teams) Consulte Using the For each team iterator.
Para cada elemento de trabajo en la lista de prioridad (Workload) Repite el conjunto de actions para cada elemento de trabajo en una lista de prioridad y asigna los elementos de trabajo a la variable Registro. La variable Registro devuelve tres valores clave fijos: workitemId, workitemValues y workitemMetadata. Consulte Uso del iterador Para cada elemento de trabajo en la cola.
Para cada nodo de un conjunto de datos XML Repite el conjunto de actions para cada nodo en un conjunto de datos XML y asigna el nodo actual a la variable Cadena. Proporcione el nombre de sesión que ha utilizado para abrir el archivo XML.