Microsoft OneDrive
O conector do OneDrive permite que você se conecte ao armazenamento em nuvem do Microsoft OneDrive no Designer. O OneDrive está disponível como uma fonte de dados nas ferramentas Dados de Entrada e Dados de Saída.
Atualizar para o novo conector do OneDrive
Se o fluxo de trabalho usa as ferramentas independentes Entrada ou Saída do OneDrive, elas agora estão descontinuadas. Em vez disso, use a versão do conector 2.2.0 ou posterior com as ferramentas Dados de Entrada e Dados de Saída. Use o utilitário de migração de fluxo de trabalho para atualizar os fluxos de trabalho existentes.
Pré-requisitos
Antes de prosseguir, certifique-se de ter concluído os seguintes pré-requisitos:
Requisito | Detalhes |
|---|---|
Designer | Designer 2026.1 ou posterior. Designer 2025.2 Patch 3 ou posterior. Designer 2025.1 Patch 5 ou posterior. |
Versão do conector | Microsoft OneDrive versão 2.2.0 ou posterior. Disponível nos add-ons do Designer. |
Permissões do Azure | |
Você deve habilitar o DCM no Designer. Vá para Opções >Configurações avançadas > DCM para habilitá-lo. | |
Acesso à rede | Acesso de saída para pontos de extremidade do OneDrive Online e do Microsoft OAuth. |
Instalar o conector
Instale a versão mais recente do conector do OneDrive diretamente do Designer usando add-ons. Esse é o método de instalação recomendado que permite navegar, instalar e atualizar conectores sem sair do Designer ou visitar o Alteryx Marketplace.
Para instalar o conector...
No Designer, vá para Add-Ons > Gerenciar add-ons do Marketplace. Você verá uma lista de conectores disponíveis.
Selecione Conector do Microsoft OneDrive e clique em Instalar. O Designer baixa e instala o pacote. O Designer pode precisar ser reiniciado para concluir a instalação.
Após a conclusão da instalação e da configuração, o conector do OneDrive estará disponível nas ferramentas Dados de Entrada e Dados de Saída.
Configurar uma conexão
Para se conectar ao Microsoft OneDrive...
Arraste a ferramenta Dados de Entrada ou Dados de Saída para a tela e selecione Conectar aos dados.
Em Configuração do conector , selecione Criar ou procurar uma conexão de dados.
Se você já criou uma conexão do Microsoft OneDrive antes, pode selecioná-la na guia Recentes.
Clique em + Novo. Na lista de tecnologias, selecione Microsoft OneDrive.
Insira o Nome da conexão e o Nome da fonte de dados.
Na seção Credenciais, selecione seu método de autenticação e insira as credenciais. Para obter mais informações, consulte Métodos de autenticação.
Clique em Salvar. Você também pode testar a conexão antes de salvar.
Clique em Conectar. O Microsoft OneDrive pode solicitar autenticação.
Selecione a configuração de leitura ou gravação na janela Opções. Para saber mais sobre as opções, consulte Ler dados do OneDrive ou Gravar dados no OneDrive.
Clique em Confirmar para criar uma conexão com o arquivo. Você pode continuar criando seu fluxo de trabalho.
Migração de fluxos de trabalho
Se os seus fluxos de trabalho existentes usarem as ferramentas Entrada do OneDrive ou Saída do OneDrive descontinuadas, você precisará migrá-las para usar o novo conector. Use o utilitário de migração de fluxo de trabalho para atualizar os fluxos de trabalho existentes.
O utilitário visualiza todas as alterações e substitui instâncias de ferramentas descontinuadas pelas novas versões do conector sem interromper os fluxos de trabalho.
Métodos de autenticação
O Microsoft OneDrive é compatível com três métodos de autenticação. Use a tabela abaixo para escolher a melhor opção para o seu caso de uso.
Método | Detalhes |
|---|---|
Azure AD – privado (aplicativo nativo) |
|
Azure AD – privado (aplicativo personalizado) |
|
Entidade de serviço (aplicativo) |
|
Limitações
Atualmente, o conector do Microsoft OneDrive tem as seguintes limitações:
As APIs de gráfico subjacentes da Microsoft Recentes e Compartilhados comigo foram descontinuadas e não retornam dados. Essa é uma limitação no nível da plataforma, independente desse conector.
Como resultado, Recentes e Compartilhados comigo não ficam navegáveis nem acessíveis, e o escopo do caminho do OneDrive fica limitado a Meus arquivos.
Não há suporte para particionamento.
Não há suporte para a leitura de dados com caracteres curinga ou de múltiplos arquivos ou pastas, mas isso pode ser feito usando macros.
A ação de saída Acrescentar não é compatível. Use Ler > União > Substituir para replicar o comportamento de acréscimo.
Ao criar um novo arquivo, se um arquivo com o mesmo nome já existir no destino, a ação não o substituirá. Em vez disso, ele adicionará um sufixo de carimbo de data/hora ao nome do novo arquivo, mantendo ambos os arquivos.
Não há suporte para a leitura de arquivos XLSX com múltiplas planilhas ou para selecionar uma planilha por nome ou índice.
Versão | Descrição |
v3.1.1 |
|
v3.1.0 |
|
v2.3.0 |
|
v2.2.0 |
|
v2.1.0 |
|
v2.0.2 |
|
v2.0.1 |
|
v2.0.0 |
|
v1.0.2 |
|
v1.0.1 |
|
v1.0.0 |
|
Aplicativo de API personalizado do Microsoft Azure
Para configurar um aplicativo de API personalizado para essa ferramenta, acesse o nosso guia.
Nota
Certifique-se de ter o AMP Engine habilitado para os fluxos de trabalho que contêm as ferramentas do OneDrive versão 2.2.0 e versões posteriores. Para saber mais, consulte AMP Engine.



