For Each File/Folder

UiPath.MicrosoftOffice365.Activities.Files.ForEachFileFolder

Description

Usa a API Microsoft Graph Search (para pesquisa avançada) ou API de itens do Microsoft Graph Search (para pesquisa simples) para realizar uma atividade ou uma série de atividades em cada arquivo/pasta que corresponda aos critérios do 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:

Essa atividade não é compatível com 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 Keyword Query Language (KQL) para os arquivos e pastas a serem recuperados.
  Observação:

  A atividade usa a restrição da propriedade documentLink com uma URL criada 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 PesquisaAvançada .

• 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 no lugar da pesquisa avançada. Se essa opção estiver ativa, o parâmetro Incluir subpastas será ignorado. Esse campo aceita valores Booleanos.
  Observação:

  Se Usar pesquisa simples estiver selecionado, a propriedade Repositório de arquivos é compatível apenas com as opções OneDrive, SharePoint e URL específica . A atividade agora pode ser usada com contas pessoais da Microsoft e com os tipos de autenticação ApplicationIdAndSecret e ApplicationIdAndCertificate (quando usado dentro da atividade Microsoft Office 365 Scope ) se a opção Usar pesquisa simples estiver marcada.

Diversos

• Particular — se selecionada, os valores de variáveis e argumentos não são mais registrados no nível Verbose. Esse 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 pasta raiz será pesquisada. 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. Esse campo aceita valores Booleanos.
• Limit To First - The maximum number of files and folders to return. If left blank, it retrieves all files and folders matching the filter criteria. This field supports only integer and Int32 variables. The default value is 200.
• Trim Duplicates - Specifies whether duplicate file/folder items should be removed from the search results. This field only supports Boolean values (True, False). The default value is False.
• O Que Retornar — selecione se deve retornar apenas arquivos, apenas pastas ou ambos:
  • Arquivos e pastas
  • Arquivos
  • Pastas

Saída

• Index - A zero-based index that specifies which element of the current collection is being iterated. This field supports only integer and Int32 variables.

Repositório

• Files Repository - The files repository where to search for files and folder. Select one of four options: All, OneDrive, SharePoint, SpecificUrl. The default value is All.

• Biblioteca de Documentos do SharePoint - A biblioteca de documentos dentro do site do SharePoint especificado. Essa propriedade é compatível com variáveis String e valores formatados de string.

• URL do Site do SharePoint - A URL de um site do SharePoint para pesquisar. Essa propriedade é compatível com variáveis String e valores formatados de string.

• URL específica — a URL de um local específico onde pesquisar. Essa propriedade é compatível com variáveis String e valores formatados de string.

  Observação:

  Sometimes Microsoft Search API returns duplicate file or folder items. By selecting the option Trim Duplicates, the activity removes duplicates from the search results.

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 "users" no nome	"fileextension:xlsx AND filename:users"
Todos os arquivos do Excel modificados em 14/06/2021 com a palavra "users" 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 06/12/2021	"createdby:""John Smith"" AND created<06/12/2021"
Todos os arquivos compartilhados explicitamente com "Cory Belcher"	"sharedwithusersowsuser:""Cory Belcher"""