For Each Excel Row

UiPath.Excel.Activities.Business.ExcelForEachRow

Executa uma ou mais atividades para cada linha em um intervalo, tabela ou planilha. A atividade pode ser usada com um arquivo Excel selecionado para uma atividade Use Excel File pai ou com o Project Notebook.

Use essa atividade quando estiver trabalhando com um intervalo ou planilha com várias linhas e você quiser repetir uma ou mais atividades para cada linha. Defina as atividades a serem repetidas dentro do Excel para cada linha e, ao configurar as atividades, selecione CurrentRow no menu Mais para indicar que você deseja repetir as ações para cada linha na iteração.

Para a maioria das atividades, você também deve selecionar uma coluna específica para usar de cada linha. Para descobrir quais opções estão disponíveis para especificar a coluna, dependendo da seleção do intervalo, consulte Como funciona a seleção do intervalo. Você também pode especificar a coluna usando a opção Indicar no Excel em LinhaAtual. Nesse caso, você pode selecionar qualquer célula da coluna que deseja usar diretamente do arquivo.

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 Excel For Each Row são adicionadas uma dentro da outra, se esse nome for igual para ambas, apenas a opção da mais próxima aparece no campo Mais menu para atividades filhas.

• No intervalo : clique em Mais no lado direito do campo e, no menu, selecione o intervalo, tabela ou planilha a ser usada ou selecione Indicar no Excel para abrir o arquivo e selecione um intervalo diretamente do arquivo. Como alternativa, 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 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 você definir uma expressão em uma propriedade ou de exibir a visualização da expressão.