Integração: Enviar Arquivos para o OneDrive (Microsoft)
O nó Enviar Arquivos para o OneDrive permite que o seu workflow faça upload automático de arquivos diretamente para o OneDrive da sua conta Microsoft 365. Ao chegar nesse ponto do fluxo, a instância envia os arquivos configurados — PDFs gerados por nós anteriores ou arquivos coletados em formulários — para a pasta de destino escolhida, sem nenhuma ação manual necessária.
Esse nó segue exatamente o mesmo comportamento do nó Enviar Arquivos para o Google Drive, mas opera no ecossistema Microsoft. Se você já utiliza o Google Drive e conhece sua configuração, encontrará aqui os mesmos conceitos, apenas adaptados para o OneDrive e o SharePoint.
O nó OneDrive funciona da mesma forma que o nó Google Drive: mesmas opções de configuração, mesmo fluxo de subpastas, mesmos tipos de arquivo suportados e mesmo limite de 50 MB por arquivo. A única diferença é a conta utilizada — Microsoft em vez de Google.
Pré-requisito: Configurar Conexão OneDrive
Antes de adicionar esse nó ao seu workflow, é necessário estabelecer uma conexão autorizada com a sua conta Microsoft 365. Essa conexão é feita uma única vez por espaço de trabalho e fica disponível para todos os workflows do espaço.
- Acesse Configurações no menu lateral.
- Clique em Integrações.
- Clique em Nova conexão e escolha OneDrive (Microsoft).
- Uma janela de autenticação Microsoft será aberta. Faça login com a conta Microsoft 365 que possui o OneDrive de destino.
- Conceda as permissões solicitadas para leitura e escrita no OneDrive.
- Após autorizar, a conexão aparecerá na lista de integrações com o nome da conta Microsoft associada.
Certifique-se de que a conta Microsoft utilizada possui permissão para gravar arquivos na pasta de destino escolhida. Contas com restrições de TI podem não ter acesso de escrita em determinados drives ou pastas do SharePoint.
Depois que a conexão estiver criada, ela poderá ser selecionada em qualquer nó OneDrive dentro dos workflows do espaço de trabalho.
Configuração do Nó
Ao adicionar o nó Enviar Arquivos para o OneDrive ao canvas, um painel de configuração será exibido no lado direito da tela. Preencha os campos conforme descrito abaixo.
| Campo | Descrição | Obrigatório |
|---|---|---|
| Conexão OneDrive | Selecione a conexão Microsoft 365 configurada previamente nas integrações do espaço de trabalho. | Sim |
| Drive | Escolha o drive disponível na conta Microsoft conectada. Pode ser o OneDrive pessoal do usuário ou um drive de SharePoint ao qual ele tem acesso. | Sim |
| Pasta de destino | Selecione a pasta dentro do drive escolhido onde os arquivos serão enviados. A lista de pastas é carregada automaticamente com base no drive selecionado. | Sim |
| Criar subpasta por instância | Defina se cada execução do workflow deve criar uma subpasta individual dentro da pasta de destino. Opções: Sim ou Não. | Não |
| Template do nome da subpasta | Disponível quando a opção acima é Sim. Defina o nome da subpasta usando texto livre e variáveis no formato {{variável}}, como Pedido {{numero_pedido}} - {{nome_cliente}}. O nome é resolvido em tempo de execução com os dados da instância. | Condicional |
| Artefatos a enviar | Selecione os PDFs gerados por nós anteriores do workflow (como nós de aprovação ou envio de email) que devem ser incluídos no upload. | Não |
| Enviar arquivos de formulários | Escolha os campos de upload de formulários ancestrais cujos arquivos devem ser enviados para o OneDrive junto com os demais arquivos configurados. | Não |
Ativar a opção Criar subpasta por instância é altamente recomendado quando o workflow processa múltiplos registros. Com o template de nome usando variáveis como {{nome_cliente}} ou {{numero_protocolo}}, cada instância terá sua própria pasta organizada automaticamente no OneDrive, sem risco de mistura de arquivos entre diferentes execuções.
Tipos de Arquivos Enviados
O nó suporta dois tipos de origem de arquivos que podem ser combinados na mesma execução:
Artefatos gerados pelo workflow
São os PDFs criados automaticamente por nós anteriores durante a execução. Por exemplo, um nó de Aprovação gera um PDF com o registro da decisão tomada pelos aprovadores. Um nó de Enviar Email pode também gerar um artefato com o conteúdo do email enviado. Esses artefatos ficam disponíveis para seleção neste campo.
Arquivos de formulários
São os arquivos enviados pelos respondentes em perguntas do tipo upload dentro de formulários Hashdata. Quando o workflow é acionado por uma resposta de formulário que contém campos de upload, esses arquivos podem ser selecionados aqui e serão encaminhados ao OneDrive como parte do processamento da instância.
O limite é de 50 MB por arquivo. Arquivos que excedam esse limite não serão enviados e a instância registrará um erro de upload para o arquivo em questão. Certifique-se de que os formulários associados ao workflow possuam validação de tamanho máximo configurada.
Diferenças em Relação ao Google Drive
O nó Enviar Arquivos para o OneDrive é funcionalmente equivalente ao nó Enviar Arquivos para o Google Drive. As diferenças existentes são exclusivamente relacionadas à plataforma de destino:
| Aspecto | Google Drive | OneDrive (Microsoft) |
|---|---|---|
| Conta necessária | Conta Google (Google Workspace ou pessoal) | Conta Microsoft 365 (corporativa ou pessoal) |
| Destino dos arquivos | Google Drive (Meu Drive ou Drive Compartilhado) | OneDrive pessoal ou SharePoint da organização |
| Tipo de autenticação | OAuth Google | OAuth Microsoft |
| Comportamento de subpastas | Idêntico | Idêntico |
| Limite por arquivo | 50 MB | 50 MB |
| Tipos de arquivo suportados | Idênticos | Idênticos |
| Saída do nó | SINGLE_OUTCOME (avança sempre) | SINGLE_OUTCOME (avança sempre) |
Se a sua organização utiliza o ecossistema Microsoft 365 como padrão, o nó OneDrive é a escolha natural para arquivamento e compartilhamento de documentos gerados pelos workflows. Para organizações que utilizam ambas as plataformas, é possível adicionar os dois nós no mesmo workflow para enviar cópias tanto para o Google Drive quanto para o OneDrive.
Comportamento Durante a Execução
Quando a instância do workflow chega ao nó Enviar Arquivos para o OneDrive, o seguinte acontece:
- O sistema autentica na conta Microsoft usando a conexão configurada.
- O drive selecionado é acessado e a pasta de destino é localizada.
- Se a opção de subpasta estiver ativa, uma nova pasta é criada com o nome resolvido a partir do template e das variáveis da instância.
- Os arquivos selecionados (artefatos e/ou arquivos de formulários) são enviados um a um para a pasta de destino.
- Após o upload de todos os arquivos, a instância avança automaticamente para o próximo nó do workflow.
O nó possui saída única (SINGLE_OUTCOME), o que significa que o fluxo sempre continua após a execução, independentemente do número de arquivos enviados. Eventuais erros de upload para arquivos específicos são registrados no histórico da instância, mas não interrompem o fluxo.
Dicas de Uso
- Combine com o nó Definir Status logo após o upload para registrar na instância que os arquivos foram enviados com sucesso ao OneDrive.
- Use variáveis de datas no template do nome da subpasta para organizar os arquivos por período, como
{{ano}}-{{mes}} - {{nome_cliente}}. - Posicione o nó ao final do workflow quando o objetivo for arquivar todos os documentos gerados durante o processo. Assim, os artefatos de todos os nós anteriores já estarão disponíveis para seleção.
- Verifique as permissões da pasta de destino no SharePoint antes de publicar o workflow, especialmente em ambientes corporativos com políticas de acesso restrito.