Para cada linha da pasta de trabalho

Atividade For Each Row in Workbook que itera pelas linhas em um intervalo especificado dentro de uma planilha no Microsoft 365.

UiPath.MicrosoftOffice365.Activities.Excel.ForEachRowConnections

Description

Itera pelas linhas em um intervalo especificado em uma planilha.

Adicione as atividades a serem repetidas dentro de For Each Row in Workbook e, quando você configurá-las, selecione Usar Variável > LinhaAtual no menu do botão Ver mais para indicar que você deseja repetir as ações para cada linha na iteração. Para obter detalhes, consulte Percorrer itens com atividades For Each.

Escopos

Essa atividade requer os seguintes escopos:

• Arquivos.Read

OU

• Arquivos.ReadWrite

OU

• Arquivos.Ler.Todos

OU

• Arquivos.ReadWrite.All

OU

• Sites.Read.All

OU

• Sites.ReadWrite.All

Observação:

Esta atividade usa paginação para processar um grande número de itens e mitigar problemas de desempenho. Esta atividade não é compatível com persistência.

Compatibilidade do projeto

Windows | Multiplataforma

Configuração

• Conexão do Microsoft OneDrive & SharePoint — A conexão para a conta do Microsoft 365 que será usada na atividade.
• Pasta de trabalho — A pasta de trabalho do Excel que será usada. O método para especificar a pasta que será recuperada: Seletor de pasta, Inserir ID, Inserir URL.

  • Exemplo de pasta de trabalho — O modelo de pasta de trabalho que será usado. O campo fica visível após clicar em Usar modelo de pasta de trabalho. Navegue pelas pastas do OneDrive e selecione uma pasta de trabalho. No Studio Desktop, a opção está disponível no menu de botão Vermais ao lado do tipo de Intervalo. Para saber mais, consulte Trabalhar com modelos.

  • Opção de seletor de arquivo/pasta : selecione a pasta ícone para navegar pelos arquivos/pastas do OneDrive ou do SharePoint e selecionar uma planilha. Essa opção aceita entrada como IResource.

    • Use o Ver mais para usar uma variável ou selecione a opção Recarregar dados da pasta se você tiver modificado suas pastas e precisar recuperar os dados mais recentes.

  • Insira a opção ID :

    • ID da pasta de trabalho — O ID da pasta de trabalho de interesse. Esse campo é compatível com entrada do tipo String .
    • Endereço do site do SharePoint - A URL do site do SharePoint que contém o arquivo ou pasta. Este campo suporta a entrada de tipo String seu site do SharePoint em um navegador e copie seu URL, por exemplo, https://yourcompany.sharepoint.com/sites/ProductOfficial.
    • Biblioteca de documentos do SharePoint - A biblioteca de documentos dentro do site do SharePoint indicado que contém o arquivo ou pasta. Esse campo é compatível com entrada do tipo String . Abra a guia Documentos em seu site do SharePoint e copie o URL, por exemplo, https://yourcompany.sharepoint.com/sites/ProductOfficial/Shared%20Documents/Forms/AllItems.aspx.

  • Insira a opção URL :

    • URL da pasta de trabalho — O URL da pasta de trabalho de interesse. Esse campo é compatível com entrada do tipo String . Recupere o URL abrindo o arquivo em um navegador.
• Intervalo - O intervalo dentro do qual as linhas são iteradas. Esse campo é pré-preenchido com informações recuperadas da planilha ou amostra de planilha selecionada. Essa propriedade é compatível com variáveis String e valores formatados de string.
  • Selecione a opção Atualizar intervalos se você tiver modificado suas planilhas e precisar recuperar os dados mais recentes.
  • Selecione a opção Atualizar tabela se você tiver modificado sua pasta de trabalho e precisar recuperar os dados mais recentes.
• Tem cabeçalhos - especifica se a primeira linha no intervalo representa uma linha de cabeçalho. Por padrão, True é selecionado.

Opção adicional

Entrada

• If row is empty - Indicates the behavior to follow when an empty row is iterated. The available options are Skip, Process, and Stop.

Saída

• Número total de planilhas processadas - O número total de planilhas processadas pela atividade.

Corpo

O corpo da atividade que armazena outras atividades usadas na automação.

Limitações conhecidas para solicitações

Esteja ciente dos limites de solicitação/resposta ao trabalhar com intervalos. O limite é de 4 MB, por exemplo, uma média de 10.000 células com 20 caracteres cada para solicitações de Leitura, 4.000 células com 20 caracteres cada para solicitações de Gravação. Para obter mais informações, consulte Especificações e limites do Excel.

Observação:

O lote de chamadas de API é compatível com as seguintes atividades quando usado dentro de Para cada:

• Add List Item
• Enviar Email
• Gravar linha
• Create Event

Exemplo

Para obter mais detalhes, consulte também os seguintes recursos:

• Excel atividades on-line
• Create Workbook
• Add Sheet
• Ler Célula