Skip to main content
The Dropbox connector supports uploading to and downloading from the Dropbox cloud storage service.

Key Capabilities

  • OAuth-based cloud storage integration with automatic token refresh
  • Upload and download from the connected Dropbox account with recursive subdirectory support
  • File filtering, deletion management, and overwrite protection
  • Comprehensive proxy support for enterprise network environments
  • Optional caching to ensure only new or updated files are downloaded

Overview

Each Dropbox connector connects to a specified Dropbox storage account. Within the remote storage, you set a single folder as the upload target, and a list of folders as the download target. Files that reach the Dropbox connector in the CData 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コネクタおよびフロー内でのその役割について自由形式の説明を提供するためのオプションフィールドです。
Use the Connect button to authenticate the connector with the storage service the first time. You are redirected to a site login portal. After you provide the account credentials, an authentication token is returned to Arc and stored for repeat 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。

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

To establish a connection with the Dropbox connector, use the Connect button on the Settings tab to be directed to a login portal site. Enter your account credentials in this portal; it returns an authentication token to the connector. This process is only required the first time the connector connects to the storage service.

Uploading and Downloading

Upload

To upload files, set the Remote Folder in the Send portion of the Settings page to the folder where files should be uploaded. Each Dropbox connector uploads to a single folder location. Use the Overwrite remote files option to indicate whether files that already exist in the container 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 in the Receive portion of the Settings page to the folder from where files should be downloaded. Use a comma-delimited list to specify multiple folders. 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.

Macros

Examples