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 Microsoft Azure APIアプリケーションのセットアップ.

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.

バージョン

説明

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

  • Designer 2021.4.2パッチ4、2022.1パッチ2以降と互換性があります。

  • AMP Engineとのみ互換性があります。

  • このコネクタをAlteryx Serverで実行するには、DCMが必要です。

  • 認証オプションウィンドウを改善しました。

  • XLSXファイルをローカルにダウンロードするときに、OneDrive入力の出力にシート名が含まれるようになりました。そのシート名はワークフローの他のツールで使用できます。

  • OneDrive出力で、XLSXファイル内の特定のシートの上書きを設定したのに他のシートも変更されてしまう問題を修正しました。

  • OneDriveツールの認証が正しく機能しない問題を修正しました。 (TPM-3833)

  • OneDrive入力が特定のデータ型を正しく読み取らない問題を修正しました。(TPM-3751、TPM-3722、TPM-3721)

  • データに固定小数点値またはNull値が含まれている場合に、OneDrive出力が誤ったファイルを書き込む問題を修正しました。 (TPM-3720)

  • OneDrive出力でCSVファイルのNull値が正しく変換されない問題を修正しました。 (TPM-3719)

  • OneDrive出力でサービスプリンシパル認証が機能しない問題を修正しました。 (TPM-3580)

  • ユーザー設定で[シートを選択]オプションのフィールドを除外するように設定されているのに、OneDrive出力でそのフィールドが出力に含まれる問題を修正しました。 (TPM-3393)

  • OneDrive出力がデータを正しく付加しない問題を修正しました。 (TPM-2564)

  • OneDrive出力の中止オプションがすべてのデータ型で正しく機能しない問題を修正しました。 (TPM-2563)

  • OneDriveツールのエンコードの問題を修正しました。 (TPM-1984)

  • OneDrive出力がヘッダーの形式を変更する問題を修正しました。 (TPM-1375)

  • OneDrive出力の[付加]オプションがドキュメントの書式設定と数式を上書きする問題を修正しました。 (TPM-1179)

  • OneDrive入力が日付/時刻データを含むYXDBファイルを読み込めない問題を修正しました。 (TPM-1100)

  • ワークフローにByteおよびInt16のデータ型のデータが含まれている場合にOneDrive出力が失敗する問題を修正しました。 (TPM-209)

v2.2.0

  • Designer 2021.4.2パッチ4、2022.1パッチ2以降と互換性があります。

  • AMP Engineとのみ互換性があります。

  • DCM のサポートを追加しました。

    • このコネクタをAlteryx Serverで実行するには、DCMが必要です。

  • FIPS対応。

  • 1つのシートのみを上書きするオプションを追加しました。

  • シート名フィールドの動作を変更して、書き込みデータから除外されるようにしました。シート名フィールドを保持するオプションを追加しました。

  • Windows証明書ストアに対して、SSL/TLS検証が実行されるようになりました。

v2.1.0

  • Designerに組み込まれたCEFではなくユーザーのブラウザを使用して認証が行われ、最新のセキュリティポリシーに準拠します。

v2.0.2

  • 「認証情報を提供」が有効になっているとツール設定が失われる問題を修正しました。

v2.0.1

  • Designer 2021.3.2.54175での認証時に空白の画面が表示される問題を修正しました。Designer 21.3.3.63061以降に更新する必要もあるので、注意してください。

v2.0.0

  • カスタムAzureアプリ(シングルテナントアプリまたはサービスプリンシパルを含む)を使用するオプションを備えた、マルチテナントAzureアプリが組み込まれています。

  • XLSX、CSV、YXDBファイル形式の読み取りと書き込みをサポートします。

  • プロキシのサポート。

  • Alteryx Designerバージョン2021.2.2以降と互換性があります。

  • OneDrive 365が必要です。

v1.0.2

  • コードページオプションを更新しました。

  • 同じ言語のエンコーディング(例: 「言語」 -> 「言語(特定のコード)」)とアルファベット順のエンコーディングが区別されるようになりました。

  • ユーザーが出力ツールでCSVファイルのエンコーディングを指定できるようになりました。

  • データ変換処理を改善し、フィールドに値がない場合にエラーではなく警告が表示されるという問題を解決しました。

  • 既定値の設定が優先されないことがある問題を修正しました。

  • Designer の異なるインストール/構成に対する権限の問題を回避し、スケジュールされたワークフロー機能をサポートするために、本番環境のログを無効にしました。

v1.0.1

  • パッケージが正常にインストールされない問題を解決しました。

v1.0.0

  • OneDrive入力とOneDrive出力の初期リリース。

接続に使用する Alteryx ツール

AMP Engineを有効にする

OneDriveツールのバージョン2.2.0以降を含むワークフローで、AMP Engine が有効になっていることを確認します。

カスタムMicrosoft Azure APIアプリケーションのセットアップ

このツールのカスタムAPIアプリケーションを設定するには、ガイドを参照してください。