Find Files And Folders

UiPath.MicrosoftOffice365.Activities.Files.FindFilesAndFolders

Description

Usa as APIs de Pesquisar itens e Arquivos compartilhados do Microsoft Graph para localizar os arquivos, metadados e/ou conteúdos que correspondam aos valores dos seus parâmetros de pesquisa (Consulta). Por padrão, essa atividade pesquisa seu OneDrive conectado. Você tem a opção de alterar seu local de pesquisa para um site do SharePoint (NomeDaUnidade e URLDo Site ).

Após realizar a pesquisa, a atividade retorna os objetos DriveItem correspondentes (Primeiro e Resultados) que você pode usar como variáveis de entrada em atividades subsequentes; quase todas as atividades Excel e Files exigem isso como uma variável de entrada.

Esta atividade é limitada a 200 resultados. Se você estiver trabalhando com mais arquivos, use a atividade For Each File/Folder .

Observação: Localizar arquivos e pastas não oferece suporte à permissão de aplicativo Sites.Selected .

Compatibilidade do projeto

Windows - Legado | Windows

Configuração

Propriedades

Comum

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

Entrada

• Consulta - Define a frase de pesquisa de texto livre para os arquivos ou pastas a serem recuperados. Se deixado em branco, o conteúdo da pasta raiz será retornado. Para obter uma lista completa dos parâmetros de consulta suportados, consulte o item da unidade Propriedades na documentação da API da Microsoft. Essa propriedade é compatível com variáveis String e valores formatados de string.
• Subpasta — (opcional) o caminho de uma subpasta na qual pesquisar (por exemplo, UmaPasta ou UmaPasta/Outra/MaisOutra). Se deixado em branco, a pasta raiz será pesquisada. Essa propriedade é compatível com variáveis String e valores formatados de string.

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.

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.

Saída

• Primeiro - O primeiro arquivo ou pasta correspondente à consulta especificada. Este campo suporta apenas DriveItem variáveis. Obrigatório se você planeja usar os dados de saída em atividades subseqüentes. O DriveItem contém informações sobre o arquivo, incluindo seu nome, tamanho, tipo, etc., que você pode usar em atividades subseqüentes.
• Resultados - Todos os arquivos e pastas correspondentes à consulta retornados como uma matriz de DriveItems. Os DriveItems contêm informações como nome do arquivo, tipo, tamanho, ID etc. e podem ser usados em atividades subsequentes. Ao usar a variável Resultados DriveItem em outras atividades, especifique o item na matriz que deseja usar (por exemplo, myFiles(0)).

Sharepoint

• Nome da Unidade — o nome da unidade no OneDrive ou no Sharepoint pesquisou os arquivos ou pastas indicados. Se essa unidade existir no Sharepoint, a URL do site deverá ser especificada. Se deixado em branco, a pesquisa é realizada na unidade padrão (normalmente "Documentos") do site do SharePoint especificado no campo URL do site. Essa propriedade é compatível com variáveis String e valores formatados de string.
• URL do site — a URL do site do Sharepoint pesquisou os arquivos ou pastas indicados. Necessária apenas ao pesquisar no SharePoint. Por exemplo, se você deseja pesquisar nos documentos do seu site do SharePoint, a URL do seu site pode ser "https://uipath.sharepoint.com/sites/Quickstart" e o Nome da Unidade seria "Documentos". Essa propriedade é compatível com variáveis String e valores formatados de string.

Como funciona

As etapas a seguir e o diagrama de sequência de mensagens são um exemplo de como a atividade funciona desde o tempo de design (ou seja, as dependências da atividade e as propriedades de entrada/saída) até o tempo de execução.

1. Conclua as etapas de Configuração .
2. Adicione a atividade Microsoft Office 365 Scope ao seu projeto.
3. Adicione a atividade Find Files And Folders dentro da atividade Microsoft Office 365 Scope.
4. Insira valores para as propriedades de entrada.
5. Crie e insira variáveis DriveItem e DriveItem[] para as propriedades de Saída.

6. Execute a atividade.

   • Seus valores de propriedade de entrada são enviados para a API SearchItems.
   • A API retorna os valores DriveItem e DriveItem[] para sua variável de propriedade de saída.