Proprietários de sites do SharePoint frequentemente precisam copiar arquivos entre bibliotecas de documentos. Fazer isso manualmente para muitos arquivos consome tempo e causa erros. O Power Automate pode copiar arquivos automaticamente entre bibliotecas no mesmo site ou em sites diferentes. Este artigo explica um checklist prático para configurar um fluxo do Power Automate para copiar arquivos de forma confiável. Você aprenderá os gatilhos, ações e configurações corretos para evitar cópias quebradas e metadados ausentes.
Principais Conclusões: Checklist do Fluxo de Cópia de Arquivos no Power Automate
- Seleção do gatilho: Use “Quando um arquivo é criado ou modificado (somente propriedades)” para iniciar o fluxo sem esperar por todas as propriedades do arquivo.
- Ação de cópia: Use a ação “Copiar arquivo” do conector do SharePoint, não a ação “Criar arquivo”, para preservar metadados.
- Tratamento de erros: Adicione uma configuração “Executar após” à ação de cópia para lidar com casos em que o arquivo de origem está bloqueado ou já existe.
Por Que um Checklist é Necessário para Copiar Arquivos
O Power Automate oferece várias maneiras de copiar arquivos entre bibliotecas. O modelo de fluxo padrão “Copiar um arquivo” funciona para casos simples, mas falha quando os arquivos têm metadados personalizados ou quando a biblioteca de destino usa colunas diferentes. A causa raiz da maioria das falhas é que o fluxo copia apenas os dados binários do arquivo, não os valores das colunas. Outro problema comum é a seleção do gatilho. O gatilho “Quando um arquivo é criado ou modificado” é executado antes do arquivo ser totalmente salvo, fazendo com que a cópia pegue uma versão incompleta. Para evitar esses problemas, você precisa de um checklist estruturado que cubra configuração do gatilho, mapeamento de metadados, tratamento de erros e testes.
Pré-requisitos Antes de Criar o Fluxo
Antes de criar o fluxo, confirme se os seguintes itens estão prontos:
- Você tem uma licença do Power Automate (incluída nos planos do Microsoft 365 que possuem SharePoint Online).
- Você é proprietário dos sites de origem e destino do SharePoint, ou tem pelo menos permissões de Contribuição em ambas as bibliotecas.
- A biblioteca de destino já existe. O Power Automate não pode criar uma nova biblioteca.
- Ambas as bibliotecas estão no mesmo locatário. Cópia de arquivos entre locatários não é suportada com conectores padrão.
- Você identificou quais colunas de metadados devem ser copiadas. O Power Automate copia apenas colunas que existem em ambas as bibliotecas com o mesmo nome interno.
Etapas do Checklist para Copiar Arquivos Entre Bibliotecas
Siga estas sete etapas em ordem. Cada etapa inclui o nome exato do menu, ação ou configuração que você precisa definir.
- Crie um fluxo de nuvem automatizado
Entre no Power Automate (flow.microsoft.com). Selecione Criar e depois Fluxo de nuvem automatizado. Dê ao fluxo um nome como “Copiar novos arquivos para biblioteca de destino.” Escolha o gatilho Quando um arquivo é criado ou modificado (somente propriedades) do conector do SharePoint. Não use o gatilho sem “somente propriedades” porque esse gatilho espera que todas as propriedades do arquivo sejam gravadas, o que atrasa o fluxo. - Configure o gatilho com os detalhes da biblioteca de origem
No cartão do gatilho, defina Endereço do Site como a URL do site de origem. Defina Nome da Biblioteca como o nome da biblioteca de origem. Deixe Pasta em branco se quiser monitorar toda a biblioteca, ou insira um caminho de pasta específico. Defina Limitar por Pasta como Não, a menos que precise restringir o gatilho a uma subpasta. - Adicione uma ação Obter metadados do arquivo
Adicione uma nova etapa. Pesquise por Obter metadados do arquivo do conector do SharePoint. Defina Endereço do Site como o site de origem. Defina Identificador do Arquivo como o conteúdo dinâmico Identificador do gatilho. Esta ação recupera todas as colunas de metadados do arquivo de origem. - Adicione uma ação Copiar arquivo
Adicione outra etapa. Pesquise por Copiar arquivo do conector do SharePoint. Defina Endereço do Site de Origem como o site de origem. Defina Arquivo de Origem como o conteúdo dinâmico Identificador do Arquivo do gatilho. Defina Endereço do Site de Destino como a URL do site de destino. Defina Pasta de Destino como o caminho da biblioteca de destino, por exemplo/sites/TeamSite/Shared Documents/PastaDestino. Defina Sobrescrever como Não para evitar a substituição acidental de arquivos existentes com o mesmo nome. - Mapeie colunas de metadados manualmente
A ação Copiar arquivo não copia colunas de metadados personalizados automaticamente. Para preservar metadados, adicione uma ação Atualizar propriedades do arquivo após a ação Copiar arquivo. Defina Endereço do Site como o site de destino. Defina Identificador do Arquivo como o conteúdo dinâmico ID da ação Copiar arquivo. Adicione cada coluna que você precisa copiar. Por exemplo, se a biblioteca de origem tem uma coluna chamada “Departamento”, defina Departamento como o conteúdo dinâmico Departamento da ação Obter metadados do arquivo. Repita para cada coluna que deve ser preservada. - Adicione tratamento de erros para conflitos de arquivo
Abra as configurações da ação Copiar arquivo (clique nos três pontos e selecione Configurar execução após). Marque as caixas para obteve êxito, tempo limite excedido, foi ignorado e falhou. Em seguida, adicione uma condição de ramificação paralela. Use a saída Código de status da ação Copiar arquivo. Se o código de status for 409 (conflito), o fluxo pode renomear o arquivo usando uma ação Criar arquivo com um timestamp anexado ao nome do arquivo. Isso impede que o fluxo pare em nomes duplicados. - Salve, teste e monitore
Salve o fluxo. Carregue um arquivo de teste na biblioteca de origem com pelo menos um valor de metadado personalizado. Verifique a biblioteca de destino para o arquivo copiado e confira os metadados. Abra o histórico de execução do fluxo no Power Automate para revisar as entradas e saídas de cada etapa. Se alguma etapa falhar, a mensagem de erro mostra a causa exata.
Erros Comuns e Como Evitá-los
O fluxo copia apenas o nome do arquivo e não o conteúdo
Isso acontece quando você usa a ação Criar arquivo em vez da ação Copiar arquivo. A ação Criar arquivo exige que você forneça o conteúdo do arquivo como uma entrada binária. Se você passar o conteúdo dinâmico errado, o arquivo de destino ficará vazio ou conterá apenas metadados. Sempre use a ação Copiar arquivo para transferência completa do conteúdo do arquivo.
Valores de metadados estão ausentes na biblioteca de destino
A ação Copiar arquivo copia apenas o binário do arquivo e as colunas padrão (Nome, Título, Criado, Modificado). Colunas personalizadas como Escolha, Pessoa ou Pesquisa não são transferidas. Você deve adicionar a ação Atualizar propriedades do arquivo após a cópia para gravar esses valores. Verifique também se a biblioteca de destino possui colunas com o mesmo nome interno. Se o nome interno for diferente, a ação Atualizar propriedades do arquivo falhará.
O fluxo é executado várias vezes para o mesmo arquivo
O gatilho “Quando um arquivo é criado ou modificado (somente propriedades)” é disparado quando qualquer alteração de propriedade é salva, incluindo atualizações de metadados. Se o seu fluxo atualiza as propriedades do arquivo no destino e o gatilho monitora o destino, cria-se um loop. Para evitar isso, defina o gatilho para monitorar apenas a biblioteca de origem ou adicione uma condição que verifique se o arquivo já foi copiado. Uma maneira é adicionar uma coluna Sim/Não chamada “Copiado” na biblioteca de origem e defini-la como Sim após a cópia. Então o gatilho pode filtrar arquivos onde Copiado é igual a Não.
Ação Copiar Arquivo vs Ação Criar Arquivo: Principais Diferenças
| Item | Ação Copiar Arquivo | Ação Criar Arquivo |
|---|---|---|
| Manipulação do conteúdo do arquivo | Copia o conteúdo binário automaticamente | Requer entrada binária de uma etapa anterior |
| Preservação de metadados | Copia apenas colunas padrão (Nome, Título) | Nenhuma transferência de metadados; você deve definir todas as colunas manualmente |
| Erro em nome de arquivo duplicado | Retorna código de status 409 (conflito) | Falha com erro a menos que você defina Sobrescrever como Sim |
| Desempenho | Mais rápido para arquivos grandes porque o conteúdo é transmitido em fluxo | Mais lento porque o conteúdo é lido e gravado em partes |
| Melhor caso de uso | Copiar arquivos entre bibliotecas no mesmo locatário | Criar um novo arquivo a partir de um modelo ou fonte externa |
Agora você pode configurar um fluxo do Power Automate que copia arquivos entre bibliotecas com metadados completos e tratamento de erros. Comece com o checklist acima e teste com um conjunto pequeno de arquivos antes de habilitar o fluxo para todos os usuários. Para cenários avançados, considere usar a ação Enviar uma solicitação HTTP para o SharePoint para copiar arquivos com o histórico de versões intacto, o que a ação padrão Copiar arquivo não suporta.