Move File/Folder

UiPath.MicrosoftOffice365.Activities.Files.MoveItem

Description

Usa a API de item Mover do Microsoft Graph para mover um arquivo ou pasta especificado para uma nova pasta pai (Pasta de destino) com a opção de alterar seu nome.

Após mover o item para a Pasta de destino, a atividade retorna um DriveItemobjeto (Referenciar como) que você pode usar como variável de entrada em atividades subsequentes.

Escopos

Essa atividade requer os seguintes escopos:

• Sites.ReadWrite.All

Compatibilidade do projeto

Windows - Legado | Windows

Configuração

No corpo da atividade

• Arquivo ou pasta a mover - O arquivo ou pasta a mover como um DriveItem. Esse objeto pode ser recuperado usando a atividade Find Files And Folders . Use a variável de propriedade de saída de Find Files and Folders (Primeiro ou Resultados). Se estiver usando a propriedade de saída Resultados da atividade Find Files and Folders , especifique o item na matriz que você deseja usar (por exemplo, myWorkbooks(0)).
• Pasta de destino - O diretório para o qual este item é movido como um DriveItem. Se deixado em branco, a pasta raiz será usada. Esse objeto pode ser recuperado usando a atividade Find Files And Folders . Use a variável de propriedade de saída de Find Files and Folders (Primeiro ou Resultados). Se estiver usando a propriedade de saída Resultados da atividade Find Files and Folders , especifique o item na matriz que você deseja usar (por exemplo, myFolders(0)).

• Novo nome (opcional) - O nome deste item após ser movido. Se estiver movendo um arquivo, inclua a extensão do tipo de arquivo do item que está movendo (por exemplo, "MoveItem.docx").

  Observação: você pode salvar arquivos ou pastas para uso posterior na automação usando a atividade Get File/Folder .

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

• Consulte as opções no corpo da atividade.

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

• Referência como - O nome usado para se referir ao arquivo ou pasta movido em outras atividades. Clique Mais no lado direito do campo e selecione Salvar para uso posterior para salvar a pasta para uso posterior na automação. Como alternativa, selecione Usar valor salvo para selecionar um arquivo ou pasta que você salvou anteriormente para uso posterior no projeto ou selecione Abrir no Editor avançado para inserir uma expressão VB.

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 Move File/Folder 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 MoveDriveItem.
   • A API retorna o valor DriveItem para sua variável de propriedade de saída.
     
     

     

     
     

Essa atividade pode chamar diferentes APIs, como a seguir:

• Se o driveId do arquivo a mover for igual ao driveId da Pasta de destino, usa a API Move item.
• Se o driveId do arquivo a mover não for igual ao driveId da Pasta de destino, usa as APIs Copy item e Delete item (o arquivo original é excluído e substituído por sua cópia na pasta de destino).