Dropbox モジュール
Adobe Workfront Fusion シナリオでは、Dropbox または Dropbox Business を使用するワークフローを自動化できるほか、複数のサードパーティアプリケーションおよびサービスに接続できます。これにより、Dropbox 内のファイルやフォルダーの監視、検索、取得、一覧表示、作成、編集などのアクティビティを自動化できます。
シナリオの作成方法については、 シナリオの作成：記事のインデックスの記事を参照してください。
モジュールについて詳しくは、「 モジュール：記事インデックス」の記事を参照してください。
アクセス要件
この記事で説明している機能を使用するには、次のアクセス権が必要です。
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront パッケージ | 任意 |
| Adobe Workfront プラン |
新規：標準 または 現在：仕事以上 |
| Adobe Workfront Fusion ライセンス** |
現在：Workfront Fusion ライセンスは必要ありません。 または 従来のバージョン：作業の自動化と統合のためのWorkfront Fusion |
| 製品 |
新規：
または 現在：Adobe Workfront Fusion を購入する必要があります。 |
このテーブルの情報について詳しくは、 ドキュメントのアクセス要件を参照してください。
Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。
前提条件
- Dropbox モジュールを使用するには、Dropbox アカウントが必要です。
Dropbox API の情報
Dropbox コネクタでは、以下を使用します。
Dropbox への接続の作成
Dropbox モジュールへの接続を作成するには、以下を実行します。
-
任意のモジュールで、「接続」ボックスの横にある 追加 をクリックします。
-
次のフィールドに入力します。
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-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）のどちらに接続するかを選択します。 除外 dropbox-api-path-root ヘッダー アプリのフォルダーアクセス権を持つDropbox アプリの dropbox-api-path-root ヘッダーを除外するには、このオプションを有効にします -
「続行」をクリックして接続を保存し、モジュールに戻ります。## Dropbox モジュールとそのフィールド
Dropbox モジュールとそのフィールド
Dropbox モジュールを設定する際、Workfront Fusion に以下のフィールドが表示されます。これらに加えて、アプリまたはサービスのアクセスレベルなどの要因に応じて、追加の Dropbox フィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。
フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、 モジュール間で情報をマッピングするを参照してください。
トリガーモジュール
ファイルを監視
このトリガータイプのモジュールは、指定されたフォルダー内のファイルが変更されたときに、ファイルの詳細を返します。
Dropbox ファイルおよびフォルダーを取得するためのモジュール
ファイルをダウンロード
このアクションモジュールは、フォルダーからファイルをダウンロードします。
ファイルとその場所を指定します。
このモジュールは、ファイルの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
フォルダーメタデータを取得
このアクションモジュールは、共有フォルダーの詳細を取得します。
フォルダーの ID を指定します。
このモジュールは、フォルダーの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
フォルダー内のすべてのファイル／サブフォルダーを一覧表示
このアクションモジュールは、特定のフォルダー内のファイルまたはフォルダーを一覧表示します。
フォルダーの ID を指定します。
このモジュールは、ファイルまたはフォルダーの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
ファイルリビジョンを一覧表示
このアクションモジュールは、特定のファイルのすべてのファイルリビジョン（バージョン履歴）を取得します。
ファイルの ID を指定します。
このモジュールは、レコードに関連付けられた標準フィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
ファイル／フォルダーを検索
この検索モジュールは、指定された検索クエリに一致するレコードを Dropbox のオブジェクト内で検索します。
この情報は、シナリオ内の後続のモジュールにマッピングできます。
Dropbox ファイルおよびフォルダーを作成および編集するためのモジュール
フォルダーを作成
このアクションモジュールは、新規フォルダーを作成します。
フォルダーのパスと名前を指定します。
このモジュールは、フォルダーの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
テキストファイルを作成／上書き
このアクションモジュールは、DOC ファイルを作成するか、既存の DOC ファイルの内容を上書きします。
ソースファイルとフォルダーを指定します。
このモジュールを設定する際には、次のフィールドが表示されます。
共有リンクを作成／更新
このアクションモジュールは、ファイルへの公開リンクを作成します。
ファイルとリンクに関する情報を指定します。
このモジュールは、リンクの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
ファイル／フォルダーを削除
このアクションモジュールは、ファイルまたはフォルダーを削除します。
ファイルまたはフォルダーを指定します。
このモジュールは、レコードの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
ファイル／フォルダーを移動
このアクションモジュールは、ファイルまたはフォルダーを別の場所に移動します。
ファイルまたはフォルダー、および移動する方法と場所を指定します。
このモジュールは、ファイルまたはフォルダーの ID と関連するフィールドのほか、接続でアクセスするカスタムフィールドと値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
ファイル／フォルダーの名前を変更
このアクションモジュールは、ファイルまたはフォルダーの名前を変更します。
ファイルまたはフォルダーと新しい名前を指定します。
このモジュールは、ファイルまたはフォルダーの ID と関連するフィールドのほか、接続でアクセスするカスタムフィールドと値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
ファイルを復元
このアクションモジュールは、ファイルの以前のバージョンを復元します。
ファイルと必要なリビジョン番号を指定します。
このモジュールは、バージョンの ID と関連するフィールドのほか、接続でアクセスするカスタムフィールドと値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
ファイルをアップロード
このアクションモジュールは、ファイルをフォルダーにアップロードします。
ファイルの場所、アップロードするファイル、ファイルの新しい名前（オプション）などの情報を指定します。
このモジュールは、ファイルの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
その他のモジュール
API 呼び出しを実行
このアクションモジュールでは、Dropbox API への認証済みのカスタム呼び出しを実行できます。これにより、他の Dropbox モジュールでは不可能なデータフロー自動処理を作成できます。
このモジュールを設定する際には、次のフィールドが表示されます。
https://api.dropboxapi.com からの相対パスを入力します。例： /2/files/list_folder標準の JSON オブジェクトの形式で、API 呼び出しの本文の内容を追加します。
メモ：
if などの条件ステートメントを JSON で使用する場合、条件ステートメントの外側に引用符を挿入します。
例：
次の 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
wwwをdlに置き換えます。?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")}}