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 Configurazione dell'applicazione API 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.

Versione

Descrizione

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

  • Compatibile con Designer 2021.4.2 Patch 4, 2022.1 Patch 2 e versioni successive.

  • Compatibile solo con AMP Engine.

  • DCM necessario per l'esecuzione di questo connettore su Alteryx Server.

  • Finestra delle opzioni di autenticazione migliorata.

  • Quando scarichi file XLSX in locale, adesso l'output di Input OneDrive include i nomi dei fogli. Tali nomi possono essere utilizzati in altri strumenti del flusso di lavoro.

  • Risolto il problema a causa del quale Output OneDrive, impostato per sovrascrivere uno specifico foglio nel file XLSX, modificava anche altri fogli.

  • Risolto il problema a causa del quale l'autenticazione degli strumenti OneDrive non funzionava correttamente. (TPM-3833)

  • Risolto il problema a causa del quale Input OneDrive non leggeva correttamente determinati tipi di dati. (TPM-3751, TPM-3722, TPM-3721)

  • Risolto il problema a causa del quale Output OneDrive generava file errati in presenza di dati contenenti valori decimali fissi o nulli. (TPM-3720)

  • Risolto il problema a causa del quale Output OneDrive convertiva erroneamente valori nulli nei file CSV. (TPM-3719)

  • Risolto il problema a causa del quale l'autenticazione principale del servizio non funzionava in Output OneDrive. (TPM-3580)

  • Risolto il problema a causa del quale Output OneDrive includeva il campo nell'output, anche se l'esclusione del campo era stata impostata in Seleziona foglio. (TPM-3393)

  • Risolto il problema a causa del quale Output OneDrive non aggiungeva correttamente i dati. (TPM-2564)

  • Risolto il problema a causa del quale l'opzione di interruzione di Output OneDrive non funzionava correttamente per tutti i tipi di dati. (TPM-2563)

  • Risolti i problemi di codifica degli strumenti OneDrive. (TPM-1984)

  • Risolto il problema a causa del quale Output OneDrive modificava il formato delle intestazioni. (TPM-1375)

  • Risolto il problema a causa del quale l'opzione di aggiunta di Output OneDrive sovrascriveva la formattazione e le formule del documento. (TPM-1179)

  • Risolto il problema a causa del quale Input OneDrive non riuscita a leggere i file YXDB contenenti Data e ora. (TPM-1100)

  • Risolto il problema a causa del quale Output OneDrive generava un errore in presenza di tipi di dati Byte e Int16 nel flusso di lavoro. (TPM-209)

v2.2.0

  • Compatibile con Designer 2021.4.2 Patch 4, 2022.1 Patch 2 e versioni successive.

  • Compatibile solo con AMP Engine.

  • Aggiunto il supporto per DCM.

    • DCM necessario per l'esecuzione di questo connettore su Alteryx Server.

  • Compatibile con FIPS.

  • Aggiunta l'opzione per sovrascrivere solo un foglio.

  • Modificato il comportamento del campo del nome del foglio in modo da escluderlo dai dati scritti. Aggiunta opzione per mantenere il campo del nome del foglio.

  • La convalida SSL/TLS viene ora eseguita a fronte dell'archivio certificati Windows.

v2.1.0

  • L'autenticazione avviene utilizzando il browser dell'utente anziché il CEF incorporato in Designer per garantire la conformità con i criteri di sicurezza moderni.

v2.0.2

  • Risolto il problema relativo alla perdita della configurazione dello strumento in caso di attivazione dell'opzione "Fornisci le informazioni di autenticazione".

v2.0.1

  • È stato risolto un problema di schermata vuota durante l'autenticazione in Designer 2021.3.2.54175. Nota che è anche necessario eseguire l'aggiornamento a Designer 21.3.3.63061 o versione successiva.

v2.0.0

  • App Azure multi-tenant integrata con opzione di utilizzo di un'app Azure personalizzata (inclusa un'app single-tenant o un'entità servizio).

  • Supporta la lettura e la scrittura dei formati di file XLSX, CSV e YXDB.

  • Supporto proxy.

  • Compatibile con Alteryx Designer a partire dalla versione 2021.2.2.

  • Richiede OneDrive 365.

v1.0.2

  • Aggiornamento delle opzioni di Tabella codici.

  • Distinzione tra codifiche con la stessa lingua (ad esempio 'Lingua' -> 'Lingua (codice specifico)') e codifiche in ordine alfabetico.

  • Possibilità per l'utente di specificare la codifica per i file CSV nello strumento di output.

  • Gestione migliorata della conversione dei dati in modo da non generare un avviso al posto di un errore quando in un campo manca un valore.

  • È stato risolto il problema a causa del quale occasionalmente le impostazioni predefinite venivano ignorate.

  • È stata disattivata la registrazione in produzione per evitare problemi di autorizzazioni per installazioni/configurazioni diverse di Designer e supportare la funzionalità del flusso di lavoro pianificato.

v1.0.1

  • È stato risolto il problema che impediva l'installazione dei pacchetti.

v1.0.0

  • Versione iniziale per Input OneDrive e Output OneDrive.

Strumenti Alteryx utilizzati per Connect

Abilitazione di AMP Engine

Assicurati che AMP Engine sia abilitato per i flussi di lavoro che contengono gli strumenti OneDrive versione 2.2.0 e successive.

Configurazione dell'applicazione API Microsoft Azure personalizzata

Per impostare un'applicazione API personalizzata per questo strumento, vai alla nostra guida.