Find Files And Folders

UiPath.MicrosoftOffice365.Activities.Files.FindFilesAndFolders

Description

Importante:

Esta atividade foi descontinuada e removida do pacote a partir da versão 2.7.21. É recomendável substituir essa atividade por For Each File/Folder (clássico) ou For Each File or Folder (conexão do Integration Service).

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

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 do 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 .

Find Files and Folders doesn't support the Sites.Selected application permission.

Escopos

Essa atividade requer os seguintes escopos:

• Sites.Read.All

OU

• Sites.ReadWrite.All

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, será retornado o conteúdo da pasta raiz. Para obter uma lista completa dos parâmetros de consulta compatíveis, consulte o item de 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. Esse campo aceita valores Booleanos.

Saída

• First - The first file or folder matching the specified query. This field supports only DriveItem variables. Required if you plan to use the output data in subsequent activities. The DriveItem contains information about the file including its name, size, type, etc., that you can use in subsequent activities.
• Results - All files and folders matching the query returned as an array of DriveItems. DriveItems contain info such as filename, type, size, ID, etc., and can be used in subsequent activities. When using the Results DriveItem variable in other activities, specify the item in the array that you want to use (e.g., 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 "Documents". 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.
2. Adicione a atividade Microsoft Office 365 Scope ao seu projeto.
3. Add the Find Files And Folders activity inside the Microsoft Office 365 Scope activity.
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.