Skip to main content

microsoft-onedrive-icon.png Microsoft OneDrive

OneDriveコネクタを使用すると、DesignerのMicrosoft OneDriveクラウドストレージに接続できます。OneDriveは、データ入力ツールとデータ出力ツールでデータソースとして使用できます。

新しいOneDriveコネクタへのアップグレード

ワークフローでスタンドアロンのOneDrive入力ツールまたはOneDrive出力ツールを使用している場合、これらのツールは現在廃止されています。代わりに、データ入力ツールとデータ出力ツールでコネクタバージョン2.2.0以降を使用してください。ワークフロー移行ユーティリティを使用すると、既存のワークフローを更新できます。

必要条件

続行する前に、次の前提条件を満たしていることを確認してください。

要件

詳細

Designer

Designer 2026.1以降。

Designer 2025.2パッチ3以降。

Designer 2025.1パッチ5以降。

コネクタバージョン

Microsoft OneDriveバージョン2.2.0以降。Designerアドオンから利用できます。

Azureの権限

Microsoft Azure APIアプリケーションのセットアップを参照してください。

DCM

DesignerでDCMを有効にする必要があります。[オプション] > [詳細設定] > [DCM]を選択して有効にします。

ネットワークアクセス

OneDrive OnlineおよびMicrosoft OAuthエンドポイントへのアウトバウンドアクセス。

コネクタのインストール

アドオンを使用して、Designerから最新バージョンのOneDriveコネクタを直接インストールします。これは、Designerを終了したりAlteryx Marketplaceにアクセスしたりせずに、コネクタの参照、インストール、更新を実行できる推奨のインストール方法です。

コネクタをインストールするには次の手順に従います。

  1. Designerで、[アドオン] > [Marketplaceアドオンの管理]に移動します。使用可能なコネクタのリストが表示されます。

  2. [Microsoft OneDriveコネクタ]を選択し、[インストール]を選択します。Designerがパッケージをダウンロードしてインストールします。インストールを完了するために、Designerを再起動する必要がある場合があります。

  3. インストールとセットアップの完了後、データ入力ツールとデータ出力ツールからOneDriveコネクタを使用できるようになります。

接続を設定します

Microsoft OneDriveに接続するには次の手順に従います。

  1. データ入力ツールまたはデータ出力ツールをキャンバスにドラッグし、[データに接続]を選択します。

  2. コネクタの設定で、[データ接続の作成または参照]を選択します。

    以前にMicrosoft OneDrive接続を作成したことがある場合は、[最近]タブから接続を選択できます。

  3. [+新規] を選択します。テクノロジーのリストから[Microsoft OneDrive]を選択します。

  4. [接続名]と[データソース名]を入力します。

  5. [資格情報]セクションで、認証方法を選択し、資格情報を入力します。詳細については、「認証方法」を参照してください。

  6. [保存]を選択します。保存する前に接続をテストすることもできます。

  7. [接続]を選択します。Microsoft OneDriveが認証を要求する場合があります。

  8. [オプション]ウィンドウで読み取りまたは書き込み設定を選択します。オプションの詳細については、OneDriveからデータを読み取るまたはOneDriveにデータを書き込むを参照してください。

  9. [確認]を選択して、ファイルへの接続を作成します。ワークフローの構築を続行できます。

ワークフローの移行

既存のワークフローで廃止されたOneDrive入力ツールまたはOneDrive出力ツールを使用している場合は、新しいコネクタを使用するように移行する必要があります。ワークフロー移行ユーティリティを使用すると、既存のワークフローを更新できます。

このユーティリティは、すべての変更のプレビューを表示し、ワークフローを中断することなく、廃止予定のツールインスタンスを新しいコネクタバージョンに置き換えます。

バージョン

説明

v3.1.1

  • [認証局URL]フィールドを改善し、既定値をあらかじめ入力してインラインヘルプテキストを追加したため、外部ドキュメントを参照する必要が減りました。

  • OneDrive入力コネクタでサポートされていないファイル形式を選択すると、関連のない設定オプションが表示される問題を修正しました。

  • ビルトインアプリ認証タイプを使用しているときに、DCMで[接続テスト]が失敗する問題を修正しました。

  • OneDriveの入力操作と出力操作のエラー処理を改善しました。

v3.1.0

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

  • Microsoftの安全なOAuth 2.0ログインを使用してOneDriveに接続する機能。

  • 自動化された無人ワークフローでは、サービスプリンシパルで認証します。

  • DCMを介してログインを一度保存し、DesignerとServerの両方のワークフローで再利用できます。

  • 自動トークン更新を使用してServer上でジョブを無人で実行します。手動での再認証は必要ありません。

  • [個人ファイル]、[共有アイテム]、または[最近のファイル]ですばやくフィルタリングします。

  • 参照する、パスを手動で入力する、共有OneDriveリンクを貼り付ける、のいずれかの方法でファイルを選択できます。

  • URLを貼り付けると、コネクタがファイルの詳細を自動的に識別して読み込みます。

  • 名前または番号で特定のシートを選択する、カスタムセル範囲を定義する、シート名のリストのみを取得する、といった操作ができます。

  • ファイル名、パス、サイズ、最終変更日、ファイルタイプなどの詳細をデータと一緒に取り込みます。

  • ファイルの内容全体をダウンロードせずに、ファイル/フォルダー構造のみを取得します。

  • .csv、.xlsx、.yxdbの各ファイルをOneDriveから直接読み取ります。

v2.0.0

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

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

  • プロキシのサポート。

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

  • OneDrive 365が必要です。

v1.0.2

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

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

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

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

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

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

v1.0.1

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

v1.0.0

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

認証方法

Microsoft OneDriveは、3つの認証方法をサポートしています。以下の表をご確認いただき、ユースケースに適したものをご使用ください。

メソッド

詳細

Azure AD-プライベート(ビルトインアプリ)

  • 独自のMicrosoft資格情報を使用した個人のアドホック接続を設定する際に使用します。

  • Eメールとパスワードは、個人のMicrosoft資格情報に関連付けられます。

  • SDKに使用可能です。

  • ワークフローのスケジュール設定には推奨されません。

  • DCMはオプションです。

Azure AD-プライベート(カスタムアプリ)

サービスプリンシパル(アプリケーション)

  • 認証を特定のユーザーに関連付けずにワークフローのスケジュール設定や自動化を行う際に使用します。

  • サービスプリンシパルを使用して、カスタムAPIアプリケーションの機能を利用します。

  • セットアップの手順については、Microsoft Azure APIアプリケーションのセットアップを参照してください。

  • DCMは必須です。

制限事項

Microsoft OneDriveコネクタには現在、次の制限事項があります。

  • Microsoftの内部で使用される[最近使ったもの]と[自分と共有]のGraph APIは廃止されており、データを返しません。これは、このコネクタとは独立したプラットフォームレベルの制限です。

    そのため、[最近使ったもの]と[自分と共有]は参照もアクセスもできず、OneDriveのパスの範囲は[マイファイル]に制限されます。

  • パーティショニングはサポートされていません。

  • ワイルドカードを使用したデータの読み取り、または複数のファイルやフォルダーからのデータの読み取りはサポートされていませんが、マクロを使用して実行できます。

  • 出力アクション[付加]はサポートされていません。[読み込み] > [ユニオン] > [上書き]を使用して、付加動作を再現します。

  • 新しいファイルを作成するときに、保存先に同じ名前のファイルがすでに存在している場合、その操作によってファイルが上書きされることはありません。代わりに、新しいファイルの名前にタイムスタンプの接尾辞が付加され、両方のファイルが保持されます。

  • 複数シートのXLSXファイルの読み取り、または名前やインデックスによるシートの選択はサポートされていません。

カスタムMicrosoft Azure APIアプリケーション

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

注記

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

Microsoft OneDriveバージョン2.3.1以前(廃止)

スタンドアロンのMicrosoft OneDriveツールは廃止されました。最新の機能を使用するには、最新のOneDriveコネクタをインストールしてください。

Designerとの互換性(検討中)

解決済みの問題

コネクタリリースバージョンxxxx.x.x.xxxxx

ID

説明

v2.3.1

Fixed Issues

  • The OneDrive Input tool returns DateTime and TIME values with an extra fractional component.

  • Secret values are exposed in returned JSON in Designer HTML Developer Tools for the OneDrive tools.

  • The OneDrive Input tool returns this error: ToolId 2: str.replace() takes no keyword argument.

  • Running a workflow with a YXDB file fails in FIPS environments for the OneDrive tools.

  • The file name breadcrumb doesn’t appear in the OneDrive Input tool.

  • Custom authentication prompts for credentials twice in the browser in the OneDrive Output tool.

  • The SharePoint Input tool version 2.6.2 returns a Python int too large to convert to C long error.

  • The OneDrive tools don’t prompt users to reauthenticate when the DCM token expires.

  • Wildcard entries don’t work in the OneDrive tools after upgrading the SDK to version 2.4.0.

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

Authentication occurs using user's browser instead of embedded CEF in Designer to comply with modern security policies.

v2.0.2

Fixed issue with tool configuration being lost in case of Provide authentication Information being enabled.

v2.0.1

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