ドキュメントWorkfrontWorkfront ガイド

Dropbox モジュール

Last update: Thu Nov 21 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • ユーザー

Adobe Workfront Fusion シナリオでは、Dropbox または Dropbox Business を使用するワークフローを自動化できるほか、複数のサードパーティアプリケーションおよびサービスに接続できます。これにより、Dropbox 内のファイルやフォルダーの監視、検索、取得、一覧表示、作成、編集などのアクティビティを自動化できます。

シナリオの作成手順が必要な場合は、 Adobe Workfront Fusion でのシナリオの作成を参照してください。

モジュールについて詳しくは、 Adobe Workfront Fusion のモジュールを参照してください。

アクセス要件

この記事で説明している機能を使用するには、次のアクセス権が必要です。

Adobe Workfront プラン*
Pro 以降
Adobe Workfront ライセンス*
Plan、Work
Adobe Workfront Fusion ライセンス**

現在のライセンス要件：Workfront Fusion ライセンス要件なし。

または

従来のライセンス要件：Workfront Fusion for Work Automation and Integration

製品

現在の製品要件：Select または Prime Adobe Workfront プランがある場合、この記事で説明する機能を使用するには、組織で Adobe Workfront Fusion の購入 Adobe Workfront 必要です。 Workfront Fusion は、Workfront Ultimate プランに含まれています。

または

従来の製品要件：この記事で説明している機能を使用するには、Adobe Workfront Fusion と Adobe Workfrontを組織で購入する必要があります。

ご利用のプラン、ライセンスタイプまたはアクセス権を確認するには、Workfront 管理者にお問い合わせください。

Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。

前提条件

  • Dropbox モジュールを使用するには、Dropbox アカウントが必要です。
IMPORTANT
Dropbox は、ユーザーが 50 人を超えるアプリケーションを承認する必要があります。
詳しくは、Dropbox 開発者ガイドの「Production approval」を検索してください。

DropboxAPI に関する情報

Dropboxコネクタでは、以下を使用します。

ベース URL
https://api.dropboxapi.com/2
API バージョン
2
API タグ

  • Dropbox

    v5.3.9

  • Dropbox Business

    v1.0.12

Dropbox への接続の作成

Dropbox モジュールの接続を作成するには、次の手順に従います。

  1. 「接続」ボックスの横に表示される「追加」をクリックします。

  2. 次のフィールドに入力します。

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header
    Connection name この接続の名前を入力します。
    Environment この接続を実稼動環境と非実稼動環境のどちらで使用するかを選択します。
    Type サービスアカウントと個人アカウントのどちらに接続するかを選択します。
    Client ID Dropbox Client ID を入力します。
    Client Secret Dropbox Client Secret を入力します。
    Account Type 個人用 Dropbox アカウントとビジネス用アカウント（Dropbox Business）のどちらに接続するかを選択します。

  3. 「続行」をクリックして接続を保存し、モジュールに戻ります。## Dropbox モジュールとそのフィールド

Dropbox モジュールとそのフィールド

Dropbox モジュールを設定する際、Workfront Fusion に以下のフィールドが表示されます。これらに加えて、アプリまたはサービスのアクセスレベルなどの要因に応じて、追加の Dropbox フィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。

フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、モジュール間での情報のマッピング： Adobe Workfront Fusionを参照してください。

トリガーモジュール

ファイルを監視

このトリガータイプのモジュールは、指定されたフォルダー内のファイルが変更されたときに、ファイルの詳細を返します。

Connection
Dropbox アカウントを Workfront Fusion に接続する手順については、この記事の Dropbox への接続の作成を参照してください。
Folder
変更を監視するフォルダーを選択します。
Watch also subfolders
このオプションを有効にすると、選択したフォルダー内のサブフォルダーも変更されたファイルがないか監視されます。
Limit
各シナリオの実行サイクル中に、モジュールが返すレコードの最大数を入力またはマッピングします。

Dropbox ファイルおよびフォルダーを取得するためのモジュール

ファイル／フォルダーを検索

この検索モジュールは、指定された検索クエリに一致するレコードを Dropbox のオブジェクト内で検索します。

この情報は、シナリオ内の後続のモジュールにマッピングできます。

Connection
Dropbox アカウントを Workfront Fusion に接続する手順については、この記事の Dropbox への接続の作成を参照してください。
Search
検索語句を入力します。
Folder
検索するフォルダーを選択します。フォルダーを選択しない場合、このモジュールは Dropbox 全体を検索します。
ファイルステータス
ファイルステータスを選択すると、選択したファイルステータスに検索を制限できます。
ファイルカテゴリ
ファイルカテゴリを選択すると、選択したカテゴリに検索を制限できます。
ファイル拡張子
検索するファイル拡張子を選択します。
制限
各シナリオの実行サイクル中に、モジュールが返すレコードの最大数を入力またはマッピングします。

ファイルをダウンロード

このアクションモジュールは、フォルダーからファイルをダウンロードします。

ファイルとその場所を指定します。

このモジュールは、ファイルの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

NOTE
このモジュールは、後続のモジュールにファイルを提供するのに役立ちます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Dropbox アカウントを Workfront Fusion に接続する手順については、この記事の Dropbox への接続の作成を参照してください。
ファイルを選択する方法
ファイルパスをマッピングするか、ファイルを手動で選択するかを選びます。
ファイルパス／ファイル

ファイルパス

ターゲットパスを入力するか、ファイルにマッピングします。

ファイル

ファイルをメニューから選択します。

フォルダーメタデータを取得

このアクションモジュールは、共有フォルダーの詳細を取得します。

フォルダーの ID を指定します。

このモジュールは、フォルダーの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Dropbox アカウントを Workfront Fusion に接続する手順については、この記事の Dropbox への接続の作成を参照してください。
共有フォルダー ID
詳細を取得するフォルダーの ID を入力またはマッピングします。

フォルダー内のすべてのファイル／サブフォルダーを一覧表示

このアクションモジュールは、特定のフォルダー内のファイルまたはフォルダーを一覧表示します。

フォルダーの ID を指定します。

このモジュールは、ファイルまたはフォルダーの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Dropbox アカウントを Workfront Fusion に接続する手順については、この記事の Dropbox への接続の作成を参照してください。
リスト
ファイルを取得するか、フォルダーを取得するかを選択します。
ダウンロード可能なファイルのみを表示
ダウンロード可能なファイルのみを返すには、このオプションを有効にします。Google ドキュメントなど、一部の種類のファイルはダウンロードできません。
フォルダー
ファイルまたはフォルダーを取得するフォルダーを入力またはマッピングします。
制限
シナリオの実行サイクルごとにモジュールが一覧表示するレコードの最大数を入力またはマッピングします。

ファイルリビジョンを一覧表示

このアクションモジュールは、特定のファイルのすべてのファイルリビジョン（バージョン履歴）を取得します。
ファイルの ID を指定します。

このモジュールは、レコードに関連付けられた標準フィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Dropbox アカウントを Workfront Fusion に接続する手順については、この記事の Dropbox への接続の作成を参照してください。
ファイルを選択する方法
ファイルパスをマッピングするか、ファイルを手動で選択するかを選びます。
ファイルパス／ファイル

ファイルパス

ターゲットパスを入力するか、ファイルにマッピングします。

ファイル

ファイルをメニューから選択します。

制限
シナリオの実行サイクルごとにモジュールが一覧表示するレコードの最大数を入力またはマッピングします。

Dropbox ファイルおよびフォルダーを作成および編集するためのモジュール

ファイルをアップロード

このアクションモジュールは、ファイルをフォルダーにアップロードします。

ファイルの場所、アップロードするファイル、ファイルの新しい名前（オプション）などの情報を指定します。

このモジュールは、ファイルの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Dropbox アカウントを Workfront Fusion に接続する手順については、この記事の Dropbox への接続の作成を参照してください。
Folder
ファイルのアップロード先となる Dropbox のフォルダーを選択します。
Source File

上記で選択した Dropbox フォルダーに追加するファイルを入力またはマッピングします。

File name

ファイル拡張子を含むファイル名を入力またはマッピングします。

File data

（Google Drive／Get a File などの以前のモジュールから）ファイルデータを入力またはマッピングします。

メモ：アップロードされるファイルの最大サイズは 150 MB です。

Overwrite an existing file
既存のファイルを新しいファイルで置き換えるには、このオプションを有効にします。このオプションを無効にしたままにすると、アップロードされたファイルの名前が変更されます。

フォルダーを作成

このアクションモジュールは、新規フォルダーを作成します。

フォルダーのパスと名前を指定します。

このモジュールは、フォルダーの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Dropbox アカウントを Workfront Fusion に接続する手順については、この記事の Dropbox への接続の作成を参照してください。
Folder Name
新規フォルダーの名前を入力します。
Folder

新規フォルダーを作成する場所のパスを入力またはマッピングします。

メモ：

（チームスペースで）Dropbox Business アカウントを使用している場合は、スラッシュ / を削除する必要があります。または、「Click hereしてフォルダーを選択」をクリックしてルートにチームフォルダーを作成しないでください。

スラッシュが削除されない場合は、エラー [409] path/malformed_path/.. が返されます。

Auto rename
このオプションを有効にすると、同じ名前のフォルダーがターゲットの場所に既に存在する場合は、新規フォルダーの名前が変更されます。

テキストファイルを作成／上書き

このアクションモジュールは、DOC ファイルを作成するか、既存のファイルの内容を上書きします。

ソースファイルとフォルダーを指定します。

このモジュールは、フォルダーの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Dropbox アカウントを Workfront Fusion に接続する手順については、この記事の Dropbox への接続の作成を参照してください。
Select to
DOC ファイルを作成するか上書きするかを選択します。
Folder
ファイルを作成するターゲットの場所を選択します。
Source File

Dropbox フォルダーに追加するファイルを入力またはマッピングします。

ファイル名

新しい DOC ファイルのファイル名（拡張子を除く）を入力します。

ファイルコンテンツ

DOC ファイルのテキストコンテンツを入力します。

共有リンクを作成／更新

このアクションモジュールは、ファイルへの公開リンクを作成します。

ファイルとリンクに関する情報を指定します。

このモジュールは、リンクの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Dropbox アカウントを Workfront Fusion に接続する手順については、この記事の Dropbox への接続の作成を参照してください。
Way of selecting files
ファイルパスをマッピングするか入力するか、手動でファイルを選択するかを選択します。
File Path / File

File Path

ターゲットパスを入力するか、ファイルにマッピングします。

File

ファイルをメニューから選択します。

Requested Visibility

リンクがパブリック、チーム用、またはパスワード制限されているかどうかを選択します。

メモ：Team only および Access with password オプションは、Dropbox Pro 以降のバージョンを所有しているユーザーのみが利用できます。

Link's Expiration Date

リンクの有効期限が切れて、アクセスできなくなる日時を入力します。このフィールドを空のままにした場合、リンクは期限切れになりません。サポートされる日付と時刻の形式の一覧については、Adobe Workfront Fusion での型強制を参照してください。

メモ：「Team only」および「Access with password」オプションは、Dropbox Pro 以降のバージョンを所有しているユーザーのみが利用できます。

Link's Access Level

リンクの受信者に対する権限を設定します。

Viewer：リンクを使用するユーザーは、コンテンツの表示とコメントを行うことができます。

Editor：リンクを使用するユーザーは、コンテンツの編集、表示、コメントを行うことができます。

Max：リンクを使用するユーザーは、リンク先として設定できる最大アクセスレベルを受け取ります。

ファイルを復元

このアクションモジュールは、ファイルの以前のバージョンを復元します。

ファイルと必要なリビジョン番号を指定します。

このモジュールは、バージョンの ID と関連するフィールドのほか、接続でアクセスするカスタムフィールドと値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Dropbox アカウントを Workfront Fusion に接続する手順については、この記事の Dropbox への接続の作成を参照してください。
Way of selecting files
ファイルパスをマッピングするか入力するか、手動でファイルを選択するかを選択します。
File Path / File

File Path

ターゲットパスを入力するか、ファイルにマッピングします。

File

ファイルをメニューから選択します。

Revision
復元するリビジョンのリビジョン番号を入力またはマッピングします。

ファイル／フォルダーを移動

このアクションモジュールは、ファイルまたはフォルダーを別の場所に移動します。

ファイルまたはフォルダー、および移動する方法と場所を指定します。

このモジュールは、ファイルまたはフォルダーの ID と関連するフィールドのほか、接続でアクセスするカスタムフィールドと値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Dropbox アカウントを Workfront Fusion に接続する手順については、この記事の Dropbox への接続の作成を参照してください。
Way of selecting files
ファイルパスをマッピングするか入力するか、手動でファイルを選択するかを選択します。
File/Folder Path／File/Folder

File/Folder Path

ターゲットパスを入力するか、ファイルまたはフォルダーにマッピングします。

File/Folder

メニューからファイルまたはフォルダーを選択します。

To Folder
ファイルまたはフォルダーのターゲットの場所を入力またはマッピングします。
New Name
新しい場所にあるファイルまたはフォルダーの新しい名前を入力します。
Auto Rename
このオプションを有効にすると、同じ名前のファイルまたはフォルダーが存在する場合、モジュールはファイルまたはフォルダー名の後に (NUMBER) を付加して、新しいファイルまたはフォルダーの名前を変更します。それ以外の場合は、ターゲットの場所にあるファイルまたはフォルダーが上書きされます。
Allow ownership transfer
このオプションを有効にすると、移動されるコンテンツの所有権が移転される結果になる場合であっても、所有者による移動が許可されます。

ファイル／フォルダーの名前を変更

このアクションモジュールは、ファイルまたはフォルダーの名前を変更します。

ファイルまたはフォルダーと新しい名前を指定します。

このモジュールは、ファイルまたはフォルダーの ID と関連するフィールドのほか、接続でアクセスするカスタムフィールドと値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Dropbox アカウントを Workfront Fusion に接続する手順については、この記事の Dropbox への接続の作成を参照してください。
ファイルを選択する方法
ファイルパスをマッピングするか入力するか、手動でファイルを選択するかを選択します。
ファイルまたはフォルダーのパス／ファイルまたはフォルダー

ファイルまたはフォルダーのパス

ターゲットパスを入力するか、ファイルまたはフォルダーにマッピングします。

ファイルまたはフォルダー

メニューからファイルまたはフォルダーを選択します。

名前を変更
ファイルの target name を、ファイル拡張子を含めて入力します。

ファイル／フォルダーを削除

このアクションモジュールは、ファイルまたはフォルダーを削除します。

ファイルまたはフォルダーを指定します。

このモジュールは、レコードの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Dropbox アカウントを Workfront Fusion に接続する手順については、この記事の Dropbox への接続の作成を参照してください。
Way of selecting files
ファイルパスをマッピングするか入力するか、手動でファイルを選択するかを選択します。
File Path / File

File Path

ターゲットパスを入力するか、ファイルにマッピングします。

File

ファイルをメニューから選択します。

その他のモジュール

API 呼び出しを実行

このアクションモジュールでは、Dropbox API への認証済みのカスタム呼び出しを実行できます。これにより、他の Dropbox モジュールでは不可能なデータフロー自動処理を作成できます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Dropbox アカウントを Workfront Fusion に接続する手順については、この記事の Dropbox への接続の作成を参照してください。
URL

https://api.dropboxapi.com からの相対パスを入力します。例： /2/files/list_folder

メモ：使用可能なエンドポイントの一覧については、Dropbox API v2 ドキュメントを参照してください。

Method
API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。詳しくは、Adobe Workfront Fusionでの HTTP リクエストメソッドを参照してください。
Headers
希望するリクエストヘッダーを入力します。Workfront Fusion は、認証ヘッダーを自動的に追加します。
Query String
リクエストクエリ文字列を入力します。
Body

標準の JSON オブジェクトの形式で、API 呼び出しの本文の内容を追加します。

メモ：

if などの条件ステートメントを JSON で使用する場合は、条件ステートメントの外側に引用符を挿入します。

INFO
例： ​次の API 呼び出しでは、お使いの Dropbox アカウントの /Text files フォルダーから最初の 10 個のファイルを返します。
URL：/2/files/list_folder
本文：
{
"path": "/Text files",
"limit": 10,
"recursive": false,
"include_deleted": false
}
検索結果は、バンドル／本文にあるエントリ内のモジュールの「出力」に表示されます。
この例では、10 枚のチケットが返されています。

よくある問題

ファイルをアップロードまたは更新できない

ファイルのアップロードまたは更新に失敗する状況はいくつかあります。

  • アップロードされるファイルが大きすぎて、利用中の Dropbox プランで許可されている最大ファイルサイズを超えている場合や、Dropbox アカウントのストレージ割当をすべて使い切った場合。Dropbox アカウントから既存のファイルを削除するか、プランをアップグレードする必要があります。
  • ファイルをアップロードしようとしている選択済みのフォルダーが存在しなくなった場合。シナリオが停止するので、ターゲットフォルダーをもう一度選択する必要があります。

共有リンクで参照された画像がレンダリングされない

Dropbox／共有リンクを作成で返される URL は、画像に直接リンクされるのではなく、Dropbox ページにリンクされています。画像を強制的にダウンロードするには、末尾の ?dl=0 を ?dl=1 に置き換えます。（Web ブラウザーや Facebook メッセンジャーなどで）画像を強制的にレンダリングするには、URL の末尾に &raw=1 を追加します。

Web サイトまたはその他の Workfront Fusion モジュールの画像の直接リンクまたは生のリンクを取得する必要がある場合は、最初の共有 URL を次のように変更する必要があります。

元の URL：

https://www.dropbox.com/s/ia8qtvs20f3a5ux/Screen%20Shot%202018-10-15%20at%204.21.11%20PM.png?dl=0

  1. www を dl に置き換えます。
  2. ?dl=0 を削除します。

最終的な URL：

https://dl.dropbox.com/s/ia8qtvs20f3a5ux/Screen%20Shot%202018-10-15%20at%204.21.11%20PM.png

URL を自動的に変更するには、次のように replace() 関数を 2 回実行します。

  • www を dl に置き換えます。

  • さらに、?dl=0 を削除します。

これを 1 回で実行するには、これらの関数を次のように組み合わせます。

次のコードをコピーして、フィールドにペーストすることもできます。1.url を URL に置き換えます。

{{replace(replace(1.url; "?dl=0"; ""); "www"; "dl")}}
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43