For Each File/Folder

UiPath.MicrosoftOffice365.Activities.Files.ForEachFileFolder

Description

Usa a API de pesquisa do Microsoft Graph (para pesquisa avançada) ou a API de itens de pesquisa do Microsoft Graph (para pesquisa simples) para executar uma atividade ou uma série de atividades em cada arquivo/pasta que corresponda aos critérios de filtro.

Para obter mais detalhes sobre a implementação da API de pesquisa da Microsoft, verifique os seguintes recursos:

• Visão geral da API de pesquisa da Microsoft
• API de pesquisa da Microsoft para pesquisar conteúdo no OneDrive e no SharePoint
• Propriedades pesquisáveis do site

Observação: esta atividade não suporta persistência.

Compatibilidade do projeto

Windows - Legado | Windows

Configuração

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 o tipo de arquivo na pasta facilita a identificação. Selecione a opção de arquivo atual ao configurar atividades adicionadas dentro da atividade For Each File/Folder. Por exemplo, para uma pasta que contém relatórios, você pode inserir Report. O valor padrão é DriveItem.

Painel de Propriedades

Comum

• NomeDeExibição — o nome de exibição da atividade no painel do Designer. Essa propriedade é compatível com variáveis String e valores formatados de string.

Entrada

• Pesquisa avançada - A consulta de linguagem de consulta de palavra-chave (KQL) para os arquivos e pastas a serem recuperados.

  Observação:

  A atividade usa a restrição da propriedade documentLink com uma URL construída a partir do local especificado no Repositório de Arquivos e o valor no parâmetro Pasta . Não use a restrição de propriedades "documentLink:" ou "path:" no parâmetro AdvancedSearch .

• Pesquisa simples - A consulta de texto usada para pesquisar arquivos e pastas em vários campos como nome do arquivo e conteúdo do arquivo. Essa propriedade é compatível com variáveis String e valores formatados de string.

• Usar Pesquisa Simples - Quando ativa, a pesquisa simples é usada em vez da pesquisa avançada. Se esta opção estiver ativa, o parâmetro Incluir subpastas será ignorado. Este campo oferece suporte a valores booleanos.

  Observação:

  Se a opção Usar pesquisa simples estiver selecionada, a propriedade Repositório de arquivos oferece suporte apenas às opções OneDrive, SharePointe URL específica .

  A atividade agora pode ser usada com contas pessoais da Microsoft e com tipos de autenticação ApplicationIdAndSecret e ApplicationIdAndCertificate (quando usado dentro da atividade Microsoft Office 365 Scope) se a opção Usar pesquisa simples for marcada.

Diversos

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

Opções

• Conta — o ID ou o Nome UPN que tem o OneDrive.Esse parâmetro deve ser definido para os tipos de autenticação ApplicationIdAndSecret e ApplicationIdAndCertificate.Essa propriedade é compatível com variáveis String e valores formatados de string.
• Pasta - O caminho da pasta, dentro do repositório de arquivos especificado, no qual pesquisar (por exemplo,SomeFolder ou SomeFolder/AnotherFolder). Se for deixada em branco, a busca é feita na pasta raiz. Não levado em consideração quando Repositório de Arquivos é definido como Todos. Essa propriedade é compatível com variáveis String e valores formatados de string.
• Incluir subpastas - especifica se a pesquisa deve ser expandida para incluir todas as subpastas do local de nuvem selecionado. Este campo oferece suporte a valores booleanos.
• Limit To First - O número máximo de arquivos e pastas a serem retornados. Se deixado em branco, ele recupera todos os arquivos e pastas que correspondem aos critérios do filtro. Este campo suporta apenas variáveis inteiras e Int32 . O valor padrão é 200.
• Cortar duplicatas - especifica se os itens duplicados de arquivo/pasta devem ser removidos dos resultados da pesquisa.Este campo só aceita Booleanvalores booleanos (Verdadeiro, Falso). O valor padrão é False.

• O que retornar - Selecione se deseja retornar apenas arquivos, apenas pastas ou ambos:

  • Arquivos e pastas
  • Arquivos
  • Pastas

Saída

• Índice - Um índice baseado em zero que especifica qual elemento da coleção atual está sendo iterado. Este campo suporta apenas variáveis inteiras e Int32 .

Repositório

• Repositório de arquivos - O repositório de arquivos onde procurar arquivos e pastas. Selecione uma das quatro opções: All, OneDrive, SharePoint, SpecificUrl. O valor padrão é Todos.
• Biblioteca de Documentos do SharePoint - A biblioteca de documentos no site do SharePoint especificado. Esta propriedade oferece suporte a variáveis String e valores formatados em string.
• URL do site do SharePoint - a URL de um site do SharePoint para pesquisar. Esta propriedade oferece suporte a variáveis String e valores formatados em string.
• URL específico - O URL de um local específico para pesquisar. Esta propriedade oferece suporte a variáveis String e valores formatados em string.
  Observação: às vezes, a API de pesquisa da Microsoft retorna arquivos duplicados ou itens de pasta. Ao selecionar a opção Trim Duplicates, a atividade remove duplicatas dos resultados da pesquisa.

Exemplos de filtragem

A tabela a seguir mostra exemplos de filtros que podem ser úteis quando você consulta arquivos ou pastas:

Consulta	FiltrarExpressão
Todos os arquivos do Excel no local especificado	"fileextension:xlsx"
Todos os arquivos de formato de texto e documento portátil no local especificado	"fileextension:txt OR fileextension:pdf"
Todos os arquivos com o nome "Agenda Brief.xlsx"	"filename:""Agenda Brief.xlsx"""
Todos os arquivos do Excel com a palavra "usuários" no nome do arquivo	"fileextension:xlsx AND filename:users"
Todos os arquivos Excel modificados em 14/06/2021 com a palavra "usuários" no nome do arquivo	"fileextension:xlsx AND filename:users AND lastmodifiedtime=06/14/2021"
Todos os arquivos do Excel modificados antes de 14/06/2021 com a palavra "users" no nome do arquivo	"fileextension:xlsx AND filename:users AND lastmodifiedtime<06/14/2021"
Todos os arquivos e pastas criados por "John Smith" antes de 12/06/2021	"createdby:""John Smith"" AND created<06/12/2021"
Todos os arquivos que foram explicitamente compartilhados com "Cory Belcher"	"sharedwithusersowsuser:""Cory Belcher"""