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 Workflow パッケージと任意の Adobe Workfront Automation および Integration パッケージ Workfront Ultimate Workfront Fusion を追加購入した Workfront Prime および Select パッケージ。 |
| Adobe Workfront ライセンス |
標準 Work またはそれ以上 |
| Adobe Workfront Fusion ライセンス |
オペレーションベース：Workfront Fusion ライセンス要件なし コネクターベース（レガシー）：Workfront Fusion for Work Automation および Integration |
| 製品 | 組織が Workfront Automation および Integration を含まない Select またはPrime Workfront パッケージを持っている場合は、Adobe Workfront Fusion を購入する必要があります。 |
この表の情報について詳しくは、ドキュメントのアクセス要件を参照してください。
Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。
前提条件
- Dropbox モジュールを使用するには、Dropbox アカウントが必要です。
- Dropbox コネクタを使用するには、まずDropboxでアプリケーションを作成する必要があります。
詳しくは、Dropbox開発者ガイドの「アプリケーションの作成」を参照してください。 - アプリケーションの作成時に、次のリダイレクト URIを使用します：
https://app.workfrontfusion.com/oauth/cb/dropbox - Dropbox は、ユーザーが 50 人を超えるアプリケーションを承認する必要があります。
詳しくは、Dropbox 開発者ガイドの「Production approval」を検索してください。
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）のどちらに接続するかを選択します。 Exclude dropbox-api-path-root header このオプションを有効にすると、App Folder アクセス権を持つDropbox アプリのdropbox-api-path-root ヘッダーが除外されます -
続行をクリックして接続を保存し、モジュールに戻ります。## Dropbox モジュールとそのフィールド
Dropbox モジュールとそのフィールド
Dropbox モジュールを設定すると、Workfront Fusion には以下のフィールドが表示されます。 これらとともに、アプリやサービスのアクセスレベルなどの要因に応じて、追加の「Dropbox」フィールドが表示される場合があります。 モジュール内の太字のタイトルは、必須フィールドを示します。
フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。 詳しくは、モジュール間での情報のマッピングを参照してください。
トリガーモジュール
ファイルを監視
このトリガータイプのモジュールは、指定されたフォルダー内のファイルが変更されたときに、ファイルの詳細を返します。
Dropbox ファイルおよびフォルダーを取得するためのモジュール
ファイルをダウンロード
このアクションモジュールは、フォルダーからファイルをダウンロードします。
ファイルとその場所を指定します。
このモジュールは、ファイルの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。 この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
フォルダーメタデータを取得
このアクションモジュールは、共有フォルダーの詳細を取得します。
フォルダーの ID を指定します。
このモジュールは、フォルダーの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。 この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
フォルダー内のすべてのファイル／サブフォルダーを一覧表示
このアクションモジュールは、特定のフォルダー内のファイルまたはフォルダーを一覧表示します。
フォルダーの ID を指定します。
このモジュールは、ファイルまたはフォルダーの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。 この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
ファイルリビジョンを一覧表示
このアクションモジュールは、特定のファイルのすべてのファイルリビジョン（バージョン履歴）を取得します。
ファイルの ID を指定します。
このモジュールは、レコードに関連付けられた標準フィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。 この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
ファイル／フォルダーを検索
この検索モジュールは、指定した検索クエリに一致する Dropbox 内のオブジェクトのレコードを検索します。
この情報は、シナリオ内の後続のモジュールにマッピングできます。
Dropbox ファイルおよびフォルダーを作成および編集するためのモジュール
フォルダーを作成
このアクションモジュールは、新規フォルダーを作成します。
フォルダーのパスと名前を指定します。
このモジュールは、フォルダーの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。 この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
テキストファイルを作成／上書き
このアクションモジュールは、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")}}