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 essa atividade quando você estiver trabalhando com um intervalo ou planilha com várias linhas e deseja repetir uma ou mais atividades para cada linha individual. Defina as atividades para repetir dentro do Excel for Each Row e, quando você configurar as atividades, selecione CurrentRow no menu Mais para indicar que você deseja repetir as ações para cada linha na iteração.

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:

• Tutorial: Iterando através das Linhas de uma Tabela.
• Tutorial: Trabalhar com a automação do Word.

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.

  Quando duas atividades do Excel For Each Row são adicionadas uma dentro da outra, se esse nome for o mesmo para ambas, apenas a opção para a mais próxima aparecerá no menu Mais para atividades filhas.

• No intervalo - Clique em Mais no lado direito do campo e, em seguida, no menu, selecione o intervalo, tabela ou planilha a ser usado ou selecione Indicar no Excel para abrir o arquivo e selecionar um intervalo diretamente do arquivo. Ou então, você pode selecionar Entrada personalizada para inserir um intervalo, nome de tabela ou nome de planilha manualmente ou Abrir no editor avançado para inserir uma expressão do VB.
• 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.).

Observação: os exemplos de seleção mencionados acima podem diferir no StudioX. Isso depende de se você define uma expressão em uma propriedade ou se você visualiza a pré-visualização da expressão.