For Each Excel Row

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 saber como usar esta atividade, consulte:

Configurando a atividade

No corpo da atividade

Para cada — insira o nome que deve ser usado para referenciar a linha atual na iteração. Usar um nome que descreve as linhas no intervalo facilita identificar e selecionar a linha atual na iteração ao configurar atividades adicionadas dentro de Excel For Each Row. Por exemplo, para um intervalo com informações sobre um diferente fornecedor em cada linha, você pode inserir Supplier. O valor padrão é 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.
Tem cabeçalhos - Se estiver selecionado, indica que a primeira linha no intervalo é uma linha de cabeçalho. Quando você configurar as atividades adicionadas dentro de Excel For Each Row, você poderá identificar facilmente os dados a selecionar da linha atual pelos cabeçalhos das colunas.
Salvar depois de cada linha - Se estiver selecionado, o arquivo do Excel é salvo durante a execução do projeto após cada linha na iteração ser processada. Se não estiver selecionado, o arquivo é salvo apenas após todas as linhas na iteração serem processadas. Esta opção não está selecionada por padrão.

Painel de Propriedades

Comum

NomeDeExibição — o nome exibido para a atividade no painel do Designer.

Diversos

Particular — se selecionada, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Opções

Comportamento de linha vazia - selecione como a automação deve se comportar se uma linha vazia for encontrada:
- PararApósTrêsLinhasVaziasConsecutivas - Pare de iterar após três linhas vazias consecutivas. Essa é a opção padrão.
- Parar - Pare de iterar em linhas.
- Pular - Pule a linha vazia e passe para a próxima linha.
- Processo - Processe a linha vazia.
Tem cabeçalhos — consulte Tem cabeçalhos no corpo da atividade.
No intervalo — consulte No intervalo no corpo da atividade.
Salvar cada linha — consulte Salvar cada linha no corpo da atividade.

Como a seleção do intervalo funciona

O StudioX permite que você defina o intervalo de destino de uma atividade Excel For Each Row de várias maneiras. As seguintes informações descrevem como diferentes seleções para No intervalo influenciam o intervalo usado pelas atividades adicionadas dentro de Excel For Each Row e as opções disponíveis para indicar qual coluna usar a partir da linha atual.

Planilha inteira

Exemplo de seleção: [Excel]Sheet1

Intervalo usado: Todas as linhas onde os dados estão presentes na planilha.
Opções de linhas atuais:
- Se Tem cabeçalhos estiver selecionados em Excel For Each Row,, as opções são os valores na linha 1 da planilha.
- Se Tem cabeçalhos não estiver selecionado em Excel For Each Row,, as opções são as letras das colunas (A,B,C etc.).

Tabela

Exemplo de seleção: [Excel]Sheet1!Table1

Intervalo usado: Todas as linhas na tabela selecionada.
Opções de linhas atuais: Os valores no cabeçalho da tabela, independentemente de Tem cabeçalhos estar selecionado ou não em Excel For Each Row.

Intervalo nomeado

Exemplo de seleção: [Excel]Sheet1!Range1

Intervalo usado: Todas as linhas no intervalo selecionado.
Opções de linhas atuais:
- Se Tem cabeçalhos está selecionado em Excel For Each Row, as opções são os valores na primeira linha do intervalo.
- Se Tem cabeçalhos não está selecionado em Excel For Each Row, as opções são os índices das colunas (Coluna 1, Coluna 2 etc.).

Intervalo não nomeado

Exemplo de seleção: [Excel]Sheet1!B3:F10

Intervalo usado: Todas as linhas no intervalo selecionado.
Opções de linhas atuais:
- Se Tem cabeçalhos está selecionado em Excel For Each Row, as opções são os valores na primeira linha da seleção.
- Se Tem cabeçalhos não está selecionado em Excel For Each Row, as opções são os índices das colunas (Coluna 1, Coluna 2 etc.).

Colunas inteiras

Exemplo de seleção: [Excel]Sheet1!B:F

Intervalo usado: As linhas nas colunas selecionadas nas quais há dados presentes na planilha incluindo as linhas nas quais há os dados presentes em outras colunas diferentes das selecionadas.
Opções de linhas atuais:
- Se Tem cabeçalhos estiver selecionado em Excel For Each Row, as opções são os valores na primeira linha das colunas.
- Se Tem cabeçalhos não está selecionado em Excel For Each Row, as opções são os índices das colunas (Coluna 1, Coluna 2 etc.).

Linhas inteiras

Exemplo de seleção: [Excel]Sheet1!3:10

Intervalo usado: As células nas quais há dados presentes nas linhas selecionadas.
Opções de linhas atuais:
- Se Tem cabeçalhos está selecionado em Excel For Each Row, as opções são os valores na primeira linha da seleção.
- Se Tem cabeçalhos não está selecionado em Excel For Each Row, as opções são os índices das colunas (Coluna 1, Coluna 2 etc.).

Célula única

Exemplo de seleção: [Excel]Sheet1!B3

Intervalo usado: As atividades identificam um intervalo a partir da célula selecionada como o canto superior esquerdo e expandem o intervalo para a direita e para baixo, desde que haja dados na planilha. Por exemplo, se a seleção for Sheet1!B3 e a Planilha1 tiver dados até a coluna AC e a linha 115, as atividades dentro de Excel For Each Row usam o intervalo computado B3:AC115.

Se a célula selecionada estiver à direita da última coluna com dados ou abaixo da última linha com dados, apenas os dados na célula selecionada são usados.
Opções de linhas atuais:
- Se Tem cabeçalhos está selecionado em Excel For Each Row, as opções são os valores na primeira linha da seleção.
- Se Tem cabeçalhos não está selecionado em Excel For Each Row, as opções são os índices das colunas (Coluna 1, Coluna 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.

Nesta página