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 Bucle paquete 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 acciones 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 Tabla de datos Repite el conjunto de acciones 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 en un conjunto de datos de una consulta SQL Repite el conjunto de acciones 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 Diccionario Repite el conjunto de acciones 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 acción de Bucle que contiene una acción Diccionario > Colocar, el bot solo itera sobre el número original de elementos en un diccionario; ignora los elementos insertados mediante la acción Colocar.
Para cada valor en Diccionario Repite el conjunto de acciones 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 acción de Bucle que contiene una acción Diccionario > Colocar, el bot solo itera sobre el número original de elementos en un diccionario; ignora los elementos insertados mediante la acción Colocar.
Para cada correo en el buzón de correo Repite el conjunto de acciones 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 básico o Excel avanzado) Repite el conjunto de acciones 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 básico o la hoja de cálculo Excel avanzado. Especifique si desea repetir las acciones 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 string. 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 string.
  • En Excel avanzado, 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 avanzado paquete.

Solución alternativa: Utilice la acción Obtener varias celdas y guarde los datos en una variable de la tabla de datos y, a continuación, utilice el paquete de Bucle 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 acción.
    • Variable: Introduzca la variable de sesión que agregó en la acción 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 en la carpeta Repite el conjunto de acciones 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 string, como $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 en carpeta Repite el conjunto de acciones para cada carpeta en la carpeta especificada y asigna el nombre de la carpeta actual a una variable de string.

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 en la lista Repite el conjunto de acciones para cada elemento de la lista especificada y asigna el elemento actual a una variable. Especifique si desea repetir la acción 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 (string, número, booleano, etc.), si crea rápidamente una variable mientras configura la acción, la variable es de cualquier tipo.
Nota: El índice en una lista comienza desde cero. Por ejemplo, para repetir la acción 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 acciones 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 acciones 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 acciones para cada reunión en el calendario especificado. Consulte Uso de Calendario de Microsoft 365 acciones en un bucle.
Para cada fila de la hoja de cálculo (Excel de Microsoft 365) Repite el conjunto de acciones 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 acciones 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 (Microsoft 365 Outlook) Repite el conjunto de acciones para cada correo electrónico en la bandeja de entrada de Microsoft 365 Outlook.
  • Ingrese el nombre de sesión que utilizó en la acción 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 paquete 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 acciones 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 elemento de trabajo en la lista de prioridad (Carga de trabajo) Repite el conjunto de acciones 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 acciones para cada nodo en un conjunto de datos XML y asigna el nodo actual a la variable String. Proporcione el nombre de sesión que ha utilizado para abrir el archivo XML.