Para cada fila de Excel

UiPath.Excel.Activities.Business.ExcelForEachRow

Executes one or more activities for each row in a range, table, or sheet. The activity can be used with an Excel file selected for a parent Use Excel File activity, or with the Project Notebook.

Use this activity when you are working with a range or sheet with multiple rows, and you want to repeat one or more activities for each individual row. Set the activities to repeat inside Excel for Each Row and, when you configure the activities, select CurrentRow from the Plus menu to indicate that you want to repeat the actions for each row in the iteration.

For most activities, you must also select a specific column to use from each row. To find out what options are available for specifying the column depending on your range selection, see How Range Selection Works. You can also specify the column using the Indicate in Excel option under CurrentRow. In this case, you can select any cell from the column you want to use directly from the file.

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.

  When two Excel For Each Row activities are added one inside the other, if this name is the same for both, only the option for the nearest one appears in the Plus menu for child activities.

• In range - Click Plus on the right side of the field and then, from the menu, select the range, table, or sheet to use, or select Indicate in Excel to open the file and select a range directly from the file. Alternatively, you can select Custom Input to enter a range, table name, or sheet name manually, or Open in Advanced Editor to enter a VB expression.
• 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.).

Note: The selection examples mentioned above may differ in StudioX. This depends on whether you set an expression on a property or you view the expression preview.