Get File/Folder List

A atividade Get File or Folder List que recupera uma lista de arquivos ou pastas de um local especificado do OneDrive ou do SharePoint.

UiPath.MicrosoftOffice365.Activities.Files.GetFileListConnections

Description

Recupera uma lista de arquivos ou pastas de um local especificado do OneDrive ou do SharePoint.

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

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.
• No local - O local onde pesquisar por arquivos e pastas. O método para especificar o arquivo ou pasta a ser recuperado: Inserir Id, Inserir URL, Caminho relativo ou Use variável.
  • Opção de seletor de pasta — navegue pelas pastas do OneDrive ou do SharePoint e selecione um arquivo ou pasta. Esse campo aceita IResource como entrada.
  • Opção Caminho relativo:
    • Pasta pai – Especifique a pasta pai. Navegue pelas pastas do OneDrive ou SharePoint e selecione um arquivo ou pasta. Esse campo aceita IResource como entrada.
    • Caminho do arquivo ou pasta relativo – Especifica o caminho do arquivo ou pasta relativo à pasta pai, incluindo o nome e a extensão. Esse campo aceita String como entrada.
  • Insira a opção ID :
    • ID do arquivo ou pasta — o ID do arquivo ou pasta. Para recuperar o ID, abra o arquivo no OneDrive Web e recupere seu URL. O ID está codificado no URL. Por exemplo: se o URL for https://yourcompany.sharepoint.com/Doc.aspx?sourcedoc=%7BA1CA7E78-BA59-4DD4-A6B9-5F5BBC37FA85%7D&file=Merge_sheets.xlsx``, the decoded file ID is A1CA7E78-BA59-4DD4-A6B9-5F5BBC37FA85. %7Band%7Dare the delimiters around the file ID. This field supportsEntrada do tipo String.
    • Endereço do site do SharePoint - A URL do site do SharePoint que contém o arquivo ou pasta. Abra seu site do SharePoint em um navegador e recupere a URL, por exemplo, https://yourCompany.sharepoint.com/sites/Marketing. Essa propriedade é compatível com entrada de tipo String .
    • Biblioteca de documentos do SharePoint - A biblioteca de documentos dentro do site do SharePoint indicado que contém o arquivo ou pasta. Abra seu site do SharePoint em um navegador, vá para a guia Documentos e, em seguida, recupere a URL, por exemplo, https://yourCompany.sharepoint.com/sites/Marketing/Shared%20Documents/Forms/AllItems.aspx. Essa propriedade é compatível com entrada de tipo String .
  • Insira a opção URL :
    • URL do arquivo ou pasta — O URL do arquivo ou pasta. Essa propriedade é compatível com variáveis String e valores formatados de string. Recupere o URL abrindo o arquivo em um navegador.
  • 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.

Propriedades

Opções

• Limitar ao primeiro - O número máximo de arquivos e pastas a serem retornados. Se for deixado em branco, não há limite. Esse campo é compatível com variáveis Int32 e valores Int32.
• O que retornar - Especifica o que retornar. Escolha uma das opções disponíveis no menu suspenso:
  • Arquivos — recupera arquivos.
  • Arquivos e pastas — recupera arquivos e pastas ordenados por nome.
  • Pastas — recupera pastas.
• Trim duplicates - Boolean value. Set to True to remove duplicate files and folders from the search results.
• Pesquisa simples - O texto da consulta usado para pesquisar arquivos e pastas em vários campos (como nome do arquivo ou conteúdo do arquivo). Essa propriedade é compatível com variáveis String e valores formatados de string. Use o botão do menu mais para selecionar uma das seguintes opções:

  • Advanced search - An advanced search criteria defined to filter the files and folders. This advanced search is not supported for personal Microsoft accounts. Advanced search uses the Filter builder to configure the search criteria.

    Observação:

    A filtragem por Extensão de arquivo no Construtor de filtros pode não funcionar para extensões como .avi, .webp, .gif, .ico, .jpeg, .jpg, .mov, .mp3, .mp4, .ogg, .png, .rtf, .tiff, .wav, .webm, .webp, ou .wmv. A filtragem por Última modificação por ou Compartilhado com usuário pode retornar resultados incompletos.

  • Filtro de texto livre - Pesquise uma lista de arquivos ou pasta por um texto livre. Esse campo é compatível com entrada do tipo String .

  • Filtro de metadados - Filtrar por metadados de itens. Esse campo é preenchido dinamicamente se você selecionar uma biblioteca de documentos do SharePoint para o campo No local .

  • Filtro de consulta - Essa opção exibe o filtro de consulta da API de pesquisa, que permite especificar uma consulta para filtrar os arquivos e pastas.

• Classificar por — a propriedade para classificar a lista de arquivos retornados. Selecione uma das seguintes opções:
  • Name
  • Data da última modificação
  • Data criada
  • Tamanho
  • Nenhum
• Direção de classificação - A direção de classificação para os resultados. Selecione uma das seguintes opções:
  • Em ordem crescente
  • Em ordem decrescente
• Incluir subpastas - Valor booleano. Defina como Verdadeiro para expandir a pesquisa para todas as subpastas do local selecionado.

Saída

• Arquivos ou pasta — A lista de arquivos recuperados pela atividade. Variável de saída gerada automaticamente. Você pode usá-la como está ou salvá-la com outro nome. Além disso, você pode usar isso em outras atividades.

Exemplo

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

• Atividades de arquivos
• For Each File/Folder
• Move File/Folder
• Copy File/Folder