Skip to main content
The OneDrive connector uploads to and downloads from the OneDrive cloud storage service.

Key Capabilities

  • Microsoft OneDrive cloud storage integration with OAuth authentication and automatic token refresh
  • Bidirectional file transfer functionality with folder-based organization and glob pattern filtering
  • Optional file deletion after download with overwrite protection
  • Optional caching to ensure only new or updated files are downloaded

Overview

Each OneDrive connector connects to a specified OneDrive storage account. Within the remote storage, you set a single folder as the upload target and a single folder as the download target. Files that reach the OneDrive connector in the Arc flow are uploaded to the upload target folder, and files found in the download target folder are downloaded and entered into the Arc flow. The connector supports upload and download filters to send and receive only specific file names and/or file extensions. Account authentication uses OAuth, so you must enter account credentials in an external site portal the first time the connector connects. The external portal generates an OAuth token that the connector uses to connect, then the connector handles token refresh automatically.

Connector Configuration

This section contains all of the configurable connector properties.

Settings Tab

Authorization

設定説明
Connector Idコネクタの静的で一意の識別子です。
Connector Typeコネクタ名とその機能の説明を表示します。
Connector Descriptionコネクタおよびフロー内でのその役割について自由形式の説明を提供するためのオプションフィールドです。
Click the Connect button to authorize the connector with the storage service by redirecting to a site login portal. Once you enter the account credentials in the portal, the resulting authorization token is returned to Arc and stored for repeated use.

Send

Settings related to uploading to the remote storage.

Receive

Settings related to downloading from the remote storage.

Caching

Settings related to caching and comparing files between multiple downloads.

Arc はリソースキャッシュを自動的にクリーンアップします。この処理はすべての受信サイクルの間にバックグラウンドで実行され、リモートサーバー上にすでに存在しないファイルの古いキャッシュエントリを削除します。これにより、手動での操作を必要とせずにキャッシュサイズを管理可能な状態に保ちます。

デフォルトでは、ファイルは30 日間保持されますが、Advanced タブのOther Settings フィールドにあるResourceCacheRetentionDays 設定を使用して、お使いの環境に合わせて調整できます。例えば、ResourceCacheRetentionDays=15 とすると、ファイルは削除されるまで15 日間保持されます。

When you enable caching, the file names are case-insensitive. For example, the connector cannot distinguish between TEST.TXT and test.txt.

Advanced Tab

Advanced Settings

Settings not included in the previous categories.

Proxy Settings

これらは、接続のルーティング先となるプロキシを識別し認証するための一連の設定です。デフォルトでは、このセクションはSecurity Settings ページのProxy Settings 部分にあるグローバル設定を使用します。チェックボックスをオフにすると、コネクタ固有の設定を指定できます。

設定説明
Proxy Typeプロキシベースのファイアウォールで使用されるプロトコル。
Proxy Hostプロキシベースのファイアウォールの名前またはIP アドレス。
Proxy PortプロキシベースのファイアウォールのTCP ポート。
Proxy Userプロキシベースのファイアウォールで認証するために使用するユーザー名。
Proxy Passwordプロキシベースのファイアウォールで認証するために使用するパスワード。
Authentication SchemeデフォルトのNone のままにするか、次の認証スキームのいずれかを選択します:Basic、Digest、Proprietary、またはNTLM。

Message

Message 設定は、コネクタがメッセージを検索する方法と、処理後にメッセージを管理する方法を決定します。

Note: 以下の設定は非推奨となり、デフォルトで非表示になっています。以前に有効化またはデフォルト以外の値に設定されていたコネクタにのみ表示されます。処理済みファイルのコピーを保持するには、フロー内のコネクタを右クリックし、成功パスを表示を選択して、成功パスをFile コネクタに接続してください。

設定説明
Sent フォルダに保存(非推奨)コネクタが処理したファイルをSent フォルダにコピーします。デフォルトで無効です。Sent フォルダに保存されたファイルは保存データの暗号化の対象外です。
Sent フォルダのスキーム(非推奨)選択した時間間隔でSent フォルダ内のファイルをグループ化します。Sent フォルダに保存が有効な場合のみ適用されます。

Logging

ログの作成と保存を制御する設定です。

設定説明
Log Levelコネクタが生成するログの詳細度です。サポートを依頼する際は、これをDebug に設定してください。
Log Subfolder Scheme選択した間隔に従って、コネクタがLogs フォルダ内のファイルをグループ化するよう指示します。Weekly オプション(デフォルト)は、コネクタが毎週新しいサブフォルダを作成し、その週のすべてのログをそのフォルダに保存するよう指示します。この設定を空白のままにすると、コネクタはすべてのログをLogs フォルダに直接保存します。多数のトランザクションを処理するコネクタでは、サブフォルダを使用することでログを整理しやすくなり、パフォーマンスが向上します。
Log Messages処理したファイルのログエントリにファイル自体のコピーを含めるには、これをオンにします。これを無効にすると、Transactions タブからファイルのコピーをダウンロードできなくなる場合があります。

Miscellaneous

Miscellaneous 設定は、特定のユースケース向けの設定です。

設定説明
Other Settings非表示のコネクタ設定をセミコロン区切りのリストで設定できます(例:setting1=value1;setting2=value2)。通常のコネクタのユースケースや機能では、これらの設定の使用は必要ありません。

Automation Tab

Automation Settings

Settings related to the automatic processing of files by the connector.

Automation Status

Performance

コネクタへのリソースの割り当てに関する設定です。

設定説明
Max Workersこのコネクタでファイルを処理するためにスレッドプールから消費されるワーカースレッドの最大数です。設定すると、Advanced Settings ページのPerformance Settings 部分にあるデフォルト設定が上書きされます。
Max Filesコネクタに割り当てられた各スレッドが送信するファイルの最大数です。設定すると、Advanced Settings ページのPerformance Settings 部分にあるデフォルト設定が上書きされます。

Alerts Tab

SLAs Tab

Establishing a Connection

All that you need to establish a connection with the OneDrive connector is a set of OneDrive account credentials. Click the Connect button on the Settings tab to be directed to a login portal site. Enter your account credentials in this portal to return an authorization token to the connector. This process is only necessary for the first time the connector connects to the storage service.

Uploading and Downloading

Upload

To upload files, set the Remote Folder field in the Send portion of the Settings page to the folder where files should be uploaded. Each OneDrive connector uploads to a single folder location. Use the Overwrite remote files option to indicate whether files that already exist in the remote folder should be overwritten or skipped. After configuration is complete, files placed in the connector Transactions tab are uploaded to the remote storage. If Send Automation is enabled, the upload happens automatically; otherwise, you can send individual files from the Transactions tab.

Download

To download files, set the Remote Folder field in the Receive portion of the Settings page to the folder where files should be downloaded. Use the File Mask to set a glob filter (for example *.txt) that limits the downloads to files matching the filter. To specify multiple filters, use the Receive Filter option on the Advanced tab. Use Delete to specify whether successfully downloaded files should be removed from the remote storage. After configuration is complete, files are downloaded according to the Receive Automation settings, or you can manually click the Receive button on the Transactions tab.

Macros

Examples