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 la aplicación de API de 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.

Versión

Descripción

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

  • Compatible con Designer 2021.4.2 (parche 4), 2022.1 (parche 2) y versiones posteriores.

  • Compatible solo con AMP Engine.

  • Se requiere DCM para ejecutar este conector en Alteryx Server.

  • Se mejoró la ventana de opciones de autenticación.

  • La salida de la Entrada de OneDrive ahora incluye los nombres de las hojas cuando se descargan archivos XLSX localmente. Puedes usar los nombres de las hojas en otras herramientas de su flujo de trabajo.

  • Se corrigió el problema en el que la Salida de OneDrive configurada para sobrescribir una hoja específica en el archivo XLSX modificaba también otras hojas.

  • Se solucionó el problema en el que la autenticación de las herramientas de OneDrive no funcionaba correctamente. (TPM-3833)

  • Se solucionó el problema por el que la Entrada de OneDrive no leía ciertos tipos de datos correctamente. (TPM-3751, TPM-3722, TPM-3721)

  • Se solucionó el problema por el que la Salida de OneDrive escribía archivos incorrectos si los datos contenían valores decimales o nulos fijos. (TPM-3720)

  • Se solucionó el problema en el que la Salida de OneDrive convertía incorrectamente valores nulos en archivos CSV. (TPM-3719)

  • Se solucionó el problema en el que la autenticación principal del servicio no funcionaba en la Salida de OneDrive. (TPM-3580)

  • Se solucionó el problema en el que, a pesar de la configuración del usuario para excluir el campo de las opciones de Hoja de selección, la Salida de OneDrive incluía el campo en la salida. (TPM-3393)

  • Se solucionó el problema en el que la Salida de OneDrive no agregaba correctamente los datos. (TPM-2564)

  • Se solucionó el problema en el que la opción de anulación de la Salida de OneDrive no funcionaba correctamente para todos los tipos de datos. (TPM-2563)

  • Se solucionaron los problemas de codificación de las herramientas de OneDrive. (TPM-1984)

  • Se solucionó el problema en el que la Salida de OneDrive cambiaba el formato de los encabezados. (TPM-1375)

  • Se solucionó el problema en el que la opción Adición de la Salida de OneDrive sobrescribía el formato y las fórmulas del documento. (TPM-1179)

  • Se solucionó el problema en el que la Entrada de OneDrive no podía leer archivos YXDB con datos de DateTime. (TPM-1100)

  • Se solucionó el problema en el que la Salida de OneDrive falla cuando el flujo de trabajo incluye datos de tipos de datos Byte e Int16. (TPM-209)

v2.2.0

  • Compatible con Designer 2021.4.2 (parche 4), 2022.1 (parche 2) y versiones posteriores.

  • Compatible solo con AMP Engine.

  • Se agregó la compatibilidad con DCM.

    • Se requiere DCM para ejecutar este conector en Alteryx Server.

  • Se puede utilizar FIPS.

  • Se agregó la opción de sobrescribir solo una hoja.

  • Se cambió el comportamiento del campo Nombre de hoja para excluirlo de los datos escritos. Se agregó la opción para mantener el campo Nombre de hoja.

  • Ahora, la validación mediante SSL/TLS se realiza en función del almacén de certificados de Windows.

v2.1.0

  • La autenticación se produce cuando se utiliza el navegador del usuario en lugar de CEF incrustado en Designer a fin de cumplir con las políticas de seguridad modernas.

v2.0.2

  • Se corrigió el problema por el cual se perdía la configuración de la herramienta cuando se habilitaba la opción “Proporcionar información de autenticación”.

v2.0.1

  • Se solucionó el problema que muestra la pantalla en blanco cuando se realiza la autenticación en Designer 2021.3.2.54175. Ten en cuenta que también debes actualizar Designer a la versión 21.3.3.63061 o posterior.

v2.0.0

  • La aplicación Azure multiinquilino integrada con la opción de utilizar una aplicación Azure personalizada (incluida la aplicación de un solo inquilino o Entidad de servicio).

  • Admite la lectura y escritura de formatos de archivo XLSX, CSV e YXDB.

  • Compatibilidad con proxy.

  • Compatible con Alteryx Designer versión 2021.2.2 y posteriores.

  • Requiere OneDrive 365.

v1.0.2

  • Opciones para actualizar página de código

  • Distingue entre codificaciones con el mismo idioma (por ejemplo, “Idioma” -> “Idioma [código específico]”) y codificaciones ordenadas alfabéticamente.

  • Permite al usuario especificar la codificación de archivos CSV en la herramienta de salida.

  • Se mejoró el manejo de la conversión de datos para no mostrar una advertencia en vez de un error cuando falta un valor en un campo.

  • Se corrigió el problema en el que ocasionalmente no se respetaban los valores predeterminados.

  • Se deshabilitó el registro de producción a fin de evitar problemas de permisos para diferentes instalaciones/configuraciones de Alteryx Designer y admitir la funcionalidad de flujos de trabajo programados.

v1.0.1

  • Se corrigió el problema que impedía que los paquetes se instalaran correctamente.

v1.0.0

  • Versión inicial de Entrada de OneDrive y Salida de OneDrive.

Herramientas de Alteryx utilizadas para establecer conexiones

Habilitar AMP Engine

Asegúrate de tener habilitado AMP Engine para los flujos de trabajo que contienen las herramientas de OneDrive versión 2.2.0 y posteriores.

Configurar una aplicación de API personalizada de Microsoft Azure

Para configurar una aplicación de API personalizada para esta herramienta, ve a nuestra guía.