Para cada fila de Excel

UiPath.Excel.Activities.Business.ExcelForEachRow

Ejecuta una o más actividades para cada fila en un rango, tabla u hoja. La actividad se puede utilizar con un archivo de Excel seleccionado para una actividad principal Usar archivo de Excel , o con el Cuaderno del proyecto.

Utiliza esta actividad cuando trabajes con un rango u hoja con varias filas y quieras repetir una o más actividades para cada fila individual. Establezca las actividades que se repetirán dentro de Excel para Cada fila y, cuando configure las actividades, seleccione Fila actual en el Más para indicar que quieres repetir las acciones para cada fila de la iteración.

Para la mayoría de las actividades, también debes seleccionar una columna específica para usar de cada fila. Para saber qué opciones están disponibles para especificar la columna en función de tu selección de rango, consulta Cómo funciona la selección de rango. También puedes especificar la columna utilizando la opción Indicar en Excel en FilaActual. En este caso, puedes seleccionar cualquier celda de la columna que quieras utilizar directamente desde el archivo.

Para aprender a usar esta actividad, consulte:

• Tutorial: Iterar a través de las filas de una tabla.
• Tutorial: Trabajar con la automatización de Word.

Configurar la actividad

En el cuerpo de la actividad

• Para cada: escribe el nombre por el que referirse a la fila actual de la iteración. El uso de un nombre que describa las filas del rango facilita la identificación y selección de la fila actual en la iteración cuando se configuran las actividades añadidas dentro de Excel Para cada fila. Por ejemplo, para un rango con información sobre un proveedor diferente en cada fila, puedes introducir Supplier. El valor predeterminado es CurrentRow.

  Cuando se añaden dos actividades de Excel Para cada fila una dentro de la otra, si este nombre es el mismo para ambas, solo aparece la opción para la más cercana en el Más menú para actividades secundarias.

• Dentro del rango: haga clic en Más a la derecha del campo y luego, en el menú, selecciona el rango, la tabla o la hoja a utilizar, o selecciona Indicar en Excel para abrir el archivo y seleccionar un rango directamente desde el archivo. Como alternativa, puedes seleccionar Entrada personalizada para introducir un rango, nombre de tabla o nombre de hoja manualmente, o Abrir en editor avanzado para introducir una expresión VB.
• Contiene encabezados: si se selecciona, indica que la primera fila del rango es una fila de encabezado. Cuando se configuran las actividades que se añaden dentro de Excel para cada fila, se pueden identificar fácilmente los datos a seleccionar de la fila actual por los encabezados de las columnas.
• Guardar después de cada fila: si se selecciona, el archivo Excel se guarda durante la ejecución del proyecto después de procesar cada fila de la iteración. Si no se selecciona, el archivo se guarda solo después de procesar todas las filas de la iteración. Esta opción no está seleccionada de forma predeterminada.

Panel de propiedades

Común

• NombreParaMostrar: el nombre que se muestra en el panel Diseñador para la actividad.

Otros

• Privado: si se selecciona, los valores de variables y argumentos ya no se registran en el nivel Detallado.

Opciones

• Comportamiento de fila vacía : selecciona cómo debe comportarse la automatización si se encuentra una fila vacía:

  • DetenerTrasTresFilasVacíasConsecutivas: deja de iterar después de tres filas vacías consecutivas. Esta es la opción predeterminada.
  • Detener: deja de iterar por las filas.
  • Omitir: omite la fila vacía y pasa a la siguiente.
  • Proceso: procesa la fila vacía.
• Contiene encabezados: consulta Contiene encabezados en el cuerpo de la actividad.
• Dentro del rango: consulta Dentro del rango en el cuerpo de la actividad.
• Guardar cada fila: consulta Guardar cada fila en el cuerpo de la actividad.

Cómo funciona la selección de rangos

StudioX te permite definir el rango de destino de una actividad de Excel para cada fila de varias maneras. La siguiente información describe cómo las diferentes selecciones de Dentro del rango influyen en el rango utilizado por las actividades añadidas dentro de Excel Para cada fila y las opciones disponibles para indicar qué columna usar de la fila actual.

Hoja entera

Ejemplo de selección: [Excel]Sheet1

• Rango utilizado: todas las filas con datos en la hoja.

• Opciones de fila actual:

  • Si se selecciona Contiene encabezados en Excel Para cada fila, las opciones son los valores de la fila 1 de la hoja.
  • Si no se selcciona la opción Contiene encabezados en Excel Para cada fila, las opciones son las letras de las columnas (A, B, C, etc.).

Tabla

Ejemplo de selección: [Excel]Sheet1!Table1

• Rango usado: todas las filas de la tabla seleccionada.
• Opciones de fila actual: los valores del encabezado de la tabla, independientemente de si se ha seleccionado o no la opción Contiene encabezados en Excel Para cada fila.

RangoConBandas

Ejemplo de selección: [Excel]Sheet1!Range1

• Rango usado: todas las filas del rango seleccionado.
• Opciones de fila actual:
  • Si se selecciona Contiene encabezados en Excel Para cada fila, las opciones son los valores de la primera fila del rango.
  • Si no se selecciona Contiene encabezados en Excel Para cada fila, las opciones son los índices de las columnas (columna 1, columna 2, etc.).

Rango sin nombre

Ejemplo de selección: [Excel]Sheet1!B3:F10

• Rango usado: todas las filas del rango seleccionado.
• Opciones de fila actual:
  • Si se selecciona Contiene encabezados en Excel Para cada fila, las opciones son los valores de la primera fila de la selección.
  • Si no se selecciona Contiene encabezados en Excel Para cada fila, las opciones son los índices de las columnas (columna 1, columna 2, etc.).

Columnas enteras

Ejemplo de selección: [Excel]Sheet1!B:F

• Rango usado: las filas de las columnas seleccionadas en las que hay datos en la hoja, incluidas las filas en las que hay datos en otras columnas distintas de las seleccionadas.
• Opciones de fila actual:
  • Si se selecciona Contiene encabezados en Excel Para cada fila, las opciones son los valores de la primera fila de las columnas.
  • Si no se selecciona Contiene encabezados en Excel Para cada fila, las opciones son los índices de las columnas (columna 1, columna 2, etc.).

Filas enteras

Ejemplo de selección: [Excel]Sheet1!3:10

• Rango usado: las celdas donde hay datos de las filas seleccionadas.
• Opciones de fila actual:
  • Si se selecciona Contiene encabezados en Excel Para cada fila, las opciones son los valores de la primera fila de la selección.
  • Si no se selecciona Contiene encabezados en Excel Para cada fila, las opciones son los índices de las columnas (columna 1, columna 2, etc.).

Celda única

Ejemplo de selección: [Excel]Sheet1!B3

• Rango usado: las actividades identifican un rango que comienza con la celda seleccionada como la esquina superior izquierda y expanden el rango hacia la derecha y hacia abajo mientras haya datos en la hoja. Por ejemplo, si la selección es Sheet1!B3 y la Hoja1 tiene datos hasta la columna AC y la fila 115, las actividades dentro de Excel Para cada fila usan el rango calculado B3:AC115.

  Si la celda seleccionada se encuentra a la derecha de la última columna con datos o debajo de la última fila con datos, solo se usan los datos de la celda seleccionada.

• Opciones de fila actual:

  • Si se selecciona Contiene encabezados en Excel Para cada fila, las opciones son los valores de la primera fila de la selección.
  • Si no se selecciona Contiene encabezados en Excel Para cada fila, las opciones son los índices de las columnas (columna 1, columna 2, etc.).

Nota: Los ejemplos de selección mencionados anteriormente pueden diferir en StudioX. Esto depende de si estableces una expresión en una propiedad o ves la vista previa de la expresión.