Skip to main content

Microsoft OneDrive

The OneDrive connector lets you connect to Microsoft OneDrive cloud storage in Designer. OneDrive is available as a data source in the Input Data and Output Data tools.

Upgrade to the New OneDrive Connector

If your workflow uses the standalone OneDrive Input or OneDrive Output tools, those are now deprecated. Instead, use connector version 2.2.0 or later with the Input Data and Output Data tools. Use the workflow migration utility to update existing workflows.

Requirements

Requirement

Details

Designer

Designer 2026.1 or later.

Designer 2025.2 Patch 3 or later.

Designer 2025.1 Patch 5 or later.

Connector Version

Microsoft OneDrive version 2.2.0 or later. Available from Designer Add-Ons.

Azure Permissions

See Configurar o aplicativo da API do Microsoft Azure.

DCM

You must enable DCM in Designer. Go to Options >Advanced Settings > DCM to enable it.

Network Access

Outbound access to OneDrive Online and Microsoft OAuth endpoints.

Install the Connector

Install the latest version of OneDrive connector directly from Designer using Add-Ons. This is the recommended installation method that allows you to browse, install, and update connectors without leaving Designer or visiting the Alteryx Marketplace.

To install the connector...

  1. In Designer, go to Add-Ons > Manage Marketplace Add-Ons. You will see a list of available connectors.

  2. Select Microsoft OneDrive Connector and select Install. Designer downloads and installs the package. Designer might require a restart to complete the installation.

  3. After installation and setup are complete, the OneDrive connector is available from the Input Data and Output Data tools.

Set Up a Connection

To connect to Microsoft OneDrive...

  1. Drag the Input Data or Output Data tool to the canvas, and select Connect to Data.

  2. In the Connector Setup, select Create or Browse a Data Connection.

    If you've created a Microsoft OneDrive connection before, you can select the connection from the Recents tab.

  3. Select + New. From the list of technologies, select Microsoft OneDrive.

  4. Enter the Connection Name and Data Source Name.

  5. In the Credentials section, select your authentication method, and enter the credentials. For more information, see Authentication Methods.

  6. Select Save. You can also test the connection before saving.

  7. Select Connect. Microsoft OneDrive may request authentication.

  8. Select the read or write configuration in the Options window. To know more about the options, see Read Data from OneDrive or Write Data to OneDrive.

  9. Select Confirm to create a connection to the file. You can continue building your workflow.

Workflow Migration

If your existing workflows use the deprecated OneDrive Input or OneDrive Output tools, you need to migrate them to use the new connector. Use the workflow migration utility to update existing workflows.

The utility previews all the changes and replaces deprecated tool instances with the new connector versions without breaking the workflows.

Authentication Methods

Microsoft OneDrive supports three authentication methods. Use the table below to choose the right one for your use case.

Method

Details

Azure AD-private (Built-In App)

  • Use this to set up a personal, ad hoc connection with your own Microsoft credentials.

  • Email and password are tied to your personal Microsoft credentials.

  • This can be used for SDK.

  • Not recommended for scheduling workflows.

  • DCM is optional.

Azure AD-private (Custom App)

  • Use this when your team shares a custom-registered Azure app.

  • This can be used for SDK.

  • For instructions on the set up, see Microsoft Azure API app setup.

  • DCM is optional.

Service Principal (Application)

  • Use this to schedule or automate workflows without tying authentication to a specific user.

  • Leverages the capabilities of custom API applications with a service principal.

  • For instructions on the setup, see Microsoft Azure API app setup.

  • DCM is required.

Limitations

The Microsoft OneDrive connector currently has the following limitations:

  • Microsoft's underlying Recent and Shared with Me Graph APIs are deprecated and do not return data. This is a platform-level limitation independent of this connector.

  • Partitioning is not supported.

  • Reading data with wildcards or from multiple files or folders is not supported, but it can be achieved using macros.

  • The output action Append is not supported. Use Read > Union > Overwrite to replicate append behavior.

  • When creating a new file, if a file with the same name already exists at the destination, the action will not overwrite it. Instead, it will append a timestamp suffix to the new file's name, retaining both files.

  • Reading multi-sheet XLSX files or selecting a sheet by name or index is not supported.

  • Path scoping is limited to My Files. Recent and Shared with Me are not browsable/ accessible through OneDrive.

Versão

Descrição

v3.1.1

  • Improved the Authority URL field with a pre-filled default value and inline help text, reducing the need to consult external documentation.

  • Fixed an issue where selecting an unsupported file format in the OneDrive Input connector would show irrelevant configuration options.

  • Fixed an issue where Test Connection failed in DCM when using the Built-in App authentication type.

  • Improved error handling for OneDrive In and Out operations.

v3.1.0

  • Compatible with Designer 2021.4.2 Patch 4, 2022.1 Patch 2 and later.

  • Ability to connect to OneDrive using Microsoft's secure OAuth 2.0 login.

  • Authenticate with a Service Principal for automated, unattended workflows.

  • Store your login once via DCM and reuse it across workflows on both Designer and Server.

  • Run unattended jobs on Server with automatic token refresh, no manual re-authentication needed.

  • Quickly filter to Personal Files, Shared with Me, or Recent Files.

  • Pick files by browsing, typing a path manually, or simply pasting a shared OneDrive link.

  • Paste a URL and the connector automatically identifies and loads the file's details.

  • Choose a specific sheet by name or number, define a custom cell range, or pull just the list of sheet names.

  • Bring in details like file name, path, size, last modified date, and file type alongside your data.

  • Retrieve just the file/folder structure without downloading full file contents.

  • Read .csv, .xlsx, and .yxdb files directly from OneDrive.

v2.3.0

  • É compatível com o Designer 2021.4.2 Patch 4, 2022.1 Patch 2 e versões posteriores.

  • Compatível apenas com AMP Engine.

  • O DCM é necessário para executar esse conector no Alteryx Server.

  • Melhoria da janela de opções de autenticação.

  • A saída da ferramenta Entrada do OneDrive agora inclui os nomes das planilhas quando você baixa arquivos XLSX localmente. Você pode usar os nomes das planilhas em outras ferramentas do seu fluxo de trabalho.

  • Corrigido o problema em que a ferramenta Saída do OneDrive configurada para substituir uma planilha específica no arquivo XLSX modificava outras planilhas também.

  • Corrigido o problema em que a autenticação das ferramentas do OneDrive não funcionava corretamente. (TPM-3833)

  • Corrigido o problema em que a ferramenta Entrada do OneDrive não lia determinados tipos de dados corretamente. (TPM-3751, TPM-3722, TPM-3721)

  • Corrigido o problema em que a ferramenta Saída do OneDrive gravava arquivos incorretos se os dados continham valores decimais fixos ou nulos. (TPM-3720)

  • Corrigido o problema em que a ferramenta Saída do OneDrive convertia incorretamente valores nulos em arquivos CSV. (TPM-3719)

  • Corrigido o problema em que a autenticação da entidade de serviço não funcionava corretamente na ferramenta Saída do OneDrive. (TPM-3580)

  • Corrigido o problema em que, apesar das configurações do usuário para excluir o campo das opções "Selecionar planilha", a ferramenta Saída do OneDrive incluía o campo na saída. (TPM-3393)

  • Corrigido o problema em que a ferramenta Saída do OneDrive não agregava dados corretamente. (TPM-2564)

  • Corrigido o problema em que a opção "Abortar" da ferramenta Saída do OneDrive não funcionava corretamente para todos os tipos de dados. (TPM-2563)

  • Corrigidos os problemas de codificação das ferramentas do OneDrive. (TPM-1984)

  • Corrigido o problema em que a ferramenta Saída do OneDrive mudava o formato dos cabeçalhos. (TPM-1375)

  • Corrigido o problema em que a opção "Agregar" da Saída do OneDrive substituía a formatação e as fórmulas do documento. (TPM-1179)

  • Corrigido o problema em que a ferramenta Saída do OneDrive não conseguia ler arquivos YXDB com dados DateTime. (TPM-1100)

  • Corrigido o problema em que a ferramenta Saída do OneDrive falha quando o fluxo de trabalho inclui dados dos tipos Byte e Int16. (TPM-209)

v2.2.0

  • É compatível com o Designer 2021.4.2 Patch 4, 2022.1 Patch 2 e versões posteriores.

  • Compatível apenas com AMP Engine.

  • Suporte adicional para DCM.

    • O DCM é necessário para executar esse conector no Alteryx Server.

  • Capaz de operar com FIPS.

  • Opção adicional para substituir apenas uma planilha.

  • Alteração do comportamento do campo de nome da planilha a ser excluído dos dados gravados. Opção adicional para manter o campo de nome da planilha.

  • A validação SSL/TLS é agora executada em relação ao Repositório de Certificados do Windows.

v2.1.0

  • A autenticação ocorre usando o navegador do usuário em vez do CEF incorporado no Designer para cumprir políticas de segurança modernas.

v2.0.2

  • Corrigido o problema de perda da configuração da ferramenta no caso de a opção "Fornecer informações de autenticação" ser habilitada.

v2.0.1

  • Corrigido o problema de tela em branco na autenticação no Designer 2021.3.2.54175. Você também precisa atualizar para o Designer versão 21.3.3.63061 ou posterior.

v2.0.0

  • Aplicativo Azure multilocatário incorporado com uma opção para usar um aplicativo Azure personalizado (incluindo aplicativo de locatário único ou Principal de serviço).

  • Suporte para leitura e gravação de arquivos nos formatos XLSX, CSV e YXDB.

  • Compatível com proxy.

  • Compatível com o Alteryx Designer versão 2021.2.2 e posteriores.

  • Requer o OneDrive 365.

v1.0.2

  • Atualizar opções das Páginas de código.

  • Distinguir entre codificações com o mesmo idioma (por exemplo, 'Language' -> 'Language (specific code)') e codificações organizadas alfabeticamente.

  • Permitir que o usuário especifique a codificação para arquivos CSV na ferramenta de saída.

  • Tratamento de conversão de dados aprimorado para não emitir um aviso em vez de um erro quando está faltando um valor em algum campo.

  • Corrija o problema em que as configurações de valor padrão ocasionalmente não foram respeitadas.

  • Registro em log de produção desativado para impedir problemas de permissões para diferentes instalações/configurações do Designer e oferecer suporte à funcionalidade de fluxo de trabalho agendado.

v1.0.1

  • Corrigido o problema que impedia que os pacotes fossem instalados com sucesso.

v1.0.0

  • Versão inicial para Entrada e Saída do OneDrive.

Ferramentas do Alteryx usadas para conexão

Habilitar o AMP Engine

Certifique-se de ter o AMP Engine habilitado para os fluxos de trabalho que contêm as ferramentas do OneDrive 2.2.0 e versões posteriores.

Configuração de aplicativo de API personalizado do Microsoft Azure

Para configurar um aplicativo de API personalizado para essa ferramenta, acesse o nosso guia.