Get File/Folder

UiPath.MicrosoftOffice365.Activities.Files.GetItem

Description

Usa a API Get Item do Microsoft Graph para obter os metadados de um item especificado com um ID conhecido (ItemID). Para obter o ID do item, você pode usar uma atividade que gere um objeto DriveItem (por exemplo, Find Files And Folders).

Depois de localizar o item, a atividade retorna seus metadados em um novo objeto DriveItem (Item) que você pode usar em atividades subsequentes.

Escopos

Essa atividade requer os seguintes escopos:

• Sites.Read.All

OU

• Sites.ReadWrite.All

Compatibilidade do projeto

Windows - Legado | Windows

Configuração

No corpo da atividade

• Arquivo ou pasta - O arquivo ou pasta de destino. Clique em Procurar ao lado do campo e, em seguida, procure e selecione a pasta ou arquivo. 
• Inserir ID — Para obter o ID, insira uma variável DriveItem de saída de uma dependência de atividade (por exemplo, Find Files And Folders, Copy File/Folder, Create Folder). Ao inserir a variável DriveItem , obtenha o ID do objeto anexando ".Id" ao final da variável (por exemplo, firstFolderFound.Id). Essa propriedade é compatível com variáveis String e valores formatados de string.
• Insira a URL — a URL ItemDeUnidade do arquivo ou pasta de interesse. Essa propriedade é compatível com variáveis String e valores formatados de string.

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

• ID do item — o ID do ItemDeUnidade do arquivo ou pasta de interesse. Essa propriedade é compatível com variáveis String e valores formatados de string.
• URL do Item — a URL ItemDeUnidade do arquivo ou pasta de interesse. Essa propriedade é compatível com variáveis String e valores formatados de string.

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.

Saída

• Item — o arquivo ou pasta de interesse como um ItemDeUnidade.

Sharepoint

• Nome da unidade - o nome da unidade no OneDrive ou no SharePoint pesquisado pelos arquivos ou pastas indicados. Se esta 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 . Esta propriedade oferece suporte a variáveis String e valores formatados em string.
• URL do site - a URL do site do SharePoint pesquisado pelos arquivos ou pastas indicados. Necessário apenas ao pesquisar no SharePoint. Por exemplo, se você deseja pesquisar nos documentos do site do SharePoint, a URL do site pode ser "https://uipath.sharepoint.com/sites/Quickstart" e o nome da sua unidade seria "Documents". Esta propriedade oferece suporte a variáveis String e valores formatados em 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. Adicione uma atividade ou execute um processo externo que gere um objeto DriveItem (por exemplo, Find Files And Folders, Create Workbook e Copy File/Folder).
4. Adicione a atividade Get Item Info dentro da atividade Microsoft Office 365 Scope.
5. Insira valores para as propriedades de entrada.
6. Crie e insira uma variável DriveItem para sua propriedade de saída.

7. Execute a atividade.

   • Seus valores de propriedade de entrada são enviados para a API GetItem .
   • A API retorna o valor DriveItem para sua variável de propriedade de saída.