WorkfrontのWorkfront Fusion への接続
Workfront コネクタは、OAuth 2.0 を使用してWorkfrontに接続します。
Workfront アカウントへの接続は、Workfront Fusion モジュール内から直接作成できます。
-
任意の Adobe Workfront モジュールで、「接続」フィールドの横にある「追加」をクリックします。
-
次のフィールドに入力します。
-
「続行」をクリックして接続を保存し、モジュールに戻ります。
Workfrontにログインしていない場合は、ログイン画面が表示されます。 ログイン後、接続を許可できます。
- Workfront API への OAuth 2.0 接続は、API キーに依存しなくなりました。
- Workfront サンドボックス環境への接続を作成するには、その環境で OAuth2 アプリケーションを作成し、接続でそのアプリケーションによって生成されたクライアント ID とクライアントシークレットを使用する必要があります。
Workfront モジュールとそのフィールド
Workfront Fusion でWorkfront モジュールを設定する場合、以下に示すフィールドが表示されます。 これらに加えて、アプリまたはサービスのアクセスレベルなどの要因に応じて、追加のWorkfront フィールドが表示される場合があります。 モジュール内の太字のタイトルは、必須フィールドを示します。
フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、 モジュール間で情報をマッピングするを参照してください。
- Workfront モジュールに最新のフィールドが表示されない場合は、キャッシュの問題が原因である可能性があります。1 時間待ってから、もう一度試してください。
- Adobe Workfrontの HTTP 429 ステータスコードは、アクティベート解除の原因ではなく、代わりに、シナリオで短い実行の一時停止をトリガーにする必要があります。
トリガー
イベントを監視
このトリガーモジュールは、Workfront で特定のタイプのオブジェクトが追加、更新、または削除された場合に、シナリオをリアルタイムで実行します。
このモジュールは、レコードに関連付けられた標準フィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
-
「Web フック」ボックスの右側にある「追加」をクリックします。
-
表示される「フックを追加」ボックスで Web フックを設定します。
Web フックを作成した後、イベントの送信先エンドポイントのアドレスを表示できます。
詳しくは、Workfront ドキュメントの Event Subscription API の記事の イベントペイロードの例を参照してください。
このモジュールを使用できるWorkfront オブジェクトタイプのリストについては、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプを参照してください。
フィールドを監視
このトリガーモジュールは、指定したフィールドが更新されるとシナリオを実行します。モジュールは、指定されたフィールドの古い値と新しい値の両方を返します。 この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
このモジュールを使用できるWorkfront オブジェクトタイプのリストについては、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプを参照してください。
レコードを監視
このトリガーモジュールは、特定のタイプのオブジェクトが追加、更新、またはその両方が行われた場合にシナリオを実行します。このモジュールは、レコードに関連付けられたすべての標準フィールドと、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
出力のモジュールは、各レコードが新規か更新かを示します。
シナリオが前回実行されてから追加および更新されたレコードは、新しいレコードとして返されます。
このモジュールを設定する際には、次のフィールドが表示されます。
このモジュールを使用できるWorkfront オブジェクトタイプのリストについては、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプを参照してください。
アクション
オブジェクトの変換
このアクションモジュールは、次のいずれかの変換を行います。
- イシューをプロジェクトに変換
- イシューをタスクに変換
- タスクをプロジェクトに変換
レコードを作成
このアクションモジュールは、Workfrontのプロジェクト、タスク、イシューなどのオブジェクトを作成し、新しいオブジェクトにカスタムフォームを追加できます。 モジュールを使用すると、モジュールで使用可能なオブジェクトのフィールドを選択できます。
レコードの ID を指定します。
このモジュールは、レコードの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
入力フィールドの最小数を指定してください。例えば、イシューを作成する場合は、「プロジェクト ID」フィールドに有効な親プロジェクト ID を指定して、Workfront でイシューの配置先を示す必要があります。マッピングパネルを使用してシナリオ内の別のモジュールからこの情報をマッピングするか、名前を入力してリストから選択し、手動で入力することもできます。
このモジュールを設定する際には、次のフィールドが表示されます。
このモジュールを使用できるWorkfront オブジェクトタイプのリストについては、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプを参照してください。
- オブジェクトの ID を入力する際に、オブジェクトの名前を入力し、リストから選択できます。そうすると、モジュールが適切な ID をフィールドに入力します。
- カスタムフィールドまたはメモオブジェクト(コメントまたは返信)にテキストを入力する際、「メモテキスト」フィールドで HTML タグを使用して、太字や斜体などのリッチテキストを作成できます。
レコードを作成(レガシー)
このモジュールを使用する既存のシナリオは、引き続き期待どおりに機能します。 このモジュールは、2025 年 5 月にモジュールセレクターから削除されます。
このアクションモジュールは、Workfront でプロジェクト、タスク、イシューなどのオブジェクトを作成します。モジュールを使用すると、モジュールで使用可能なオブジェクトのフィールドを選択できます。
レコードの ID を指定します。
このモジュールは、レコードの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
入力フィールドの最小数を指定してください。例えば、イシューを作成する場合は、「プロジェクト ID」フィールドに有効な親プロジェクト ID を指定して、Workfront でイシューの配置先を示す必要があります。マッピングパネルを使用してシナリオ内の別のモジュールからこの情報をマッピングするか、名前を入力してリストから選択し、手動で入力することもできます。
このモジュールでは、オブジェクトを作成する際にカスタムフォームを添付しません。 オブジェクトの作成時にカスタムフォームを添付するには、 レコードの作成(カスタムフォームの添付) モジュールを使用します。
このモジュールを設定する際には、次のフィールドが表示されます。
このモジュールを使用できるWorkfront オブジェクトタイプのリストについては、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプを参照してください。
- オブジェクトの ID を入力する際に、オブジェクトの名前を入力し、リストから選択できます。そうすると、モジュールが適切な ID をフィールドに入力します。
- カスタムフィールドまたはメモオブジェクト(コメントまたは返信)にテキストを入力する際、「メモテキスト」フィールドで HTML タグを使用して、太字や斜体などのリッチテキストを作成できます。
カスタム API 呼び出し
このアクションモジュールを使用すると、Workfront API に対してカスタム認証呼び出しを行うことができます。 これにより、他のWorkfront モジュールでは実現できないデータフローの自動処理を作成できます。
このモジュールは、次の情報を返します。
-
ステータスコード(数値):HTTP リクエストの成功または失敗を示します。これらはインターネット上で検索できる標準コードです。
-
ヘッダー(オブジェクト):出力本文に関連しない応答/ステータスコードのより詳細なコンテキスト。応答ヘッダーに表示されるすべてのヘッダーが応答ヘッダーではないので、不要なヘッダーも含まれている可能性があります。
応答ヘッダーは、モジュールの設定時に選択した HTTP リクエストによって異なります。
-
本文(オブジェクト):モジュールの設定時に選択した HTTP リクエストによっては、データの一部を受け取る場合があります。GET リクエストからのデータなどは、このオブジェクトに含まれます。
この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
このモジュールを使用できるWorkfront オブジェクトタイプのリストについては、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプを参照してください。
レコードを削除
このアクションモジュールは、Workfront のプロジェクト、タスクまたはイシューなどのオブジェクトを削除します。
レコードの ID を指定します。
このモジュールは、レコードの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
このモジュールを使用できるWorkfront オブジェクトタイプのリストについては、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプを参照してください。
- レコードを同期的に削除します。
- レコード削除モジュールにエラー処理を追加し、40 秒のタイムアウトによるエラーを無視します。
ドキュメントのダウンロード
このアクションモジュールは、Workfront からドキュメントをダウンロードします。
レコードの ID を指定します。
このモジュールは、ドキュメントの内容、ファイル名、ファイル拡張子、ファイルサイズを返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
このモジュールを使用できるWorkfront オブジェクトタイプのリストについては、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプを参照してください。
その他のアクション
このアクションモジュールを使用すると、API に対してアクションを実行できます。
convertToProject
のアクションにはフィールド copyCategories
が含まれています。 TRUE
に設定すると、すべてのカスタムフォームは、イシューが変換されるプロジェクトに含まれます。このモジュールを設定する際には、次のフィールドが表示されます。
このモジュールを使用できるWorkfront オブジェクトタイプのリストについては、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプを参照してください。
その他のアクションオプション
タスク
イシュー
プロジェクト
レコードを読み取り
このアクションモジュールは、1 つのレコードからデータを取得します。
レコードの ID を指定します。また、モジュールで読み取る関連レコードを指定することもできます。
例えば、モジュールが読み取っているレコードがプロジェクトの場合、プロジェクトのタスクを読み込むように指定できます。
モジュールは、指定した出力フィールドからデータの配列を返します。
このモジュールを設定する際には、次のフィールドが表示されます。
このモジュールを使用できるWorkfront オブジェクトタイプのリストについては、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプを参照してください。
レコードの読み取り(レガシー)
このモジュールを使用する既存のシナリオは、引き続き期待どおりに機能します。 このモジュールは、2025 年 5 月にモジュールセレクターから削除されます。
このアクションモジュールは、1 つのレコードからデータを取得します。
レコードの ID を指定します。また、モジュールで読み取る関連レコードを指定することもできます。
例えば、モジュールが読み取っているレコードがプロジェクトの場合、プロジェクトのタスクを読み込むように指定できます。
モジュールは、指定した出力フィールドからデータの配列を返します。
このモジュールを設定する際には、次のフィールドが表示されます。
このモジュールを使用できるWorkfront オブジェクトタイプのリストについては、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプを参照してください。
イベントペイロードのバージョンを更新
Workfrontは最近、イベント購読サービスの新しいバージョンをリリースしました。 新しいバージョンはWorkfront API に対する変更ではなく、イベント購読機能に対する変更です。 このアクションモジュールは、このシナリオで使用されるイベントペイロードのバージョンを更新します。
新しいイベント購読のバージョンについて詳しくは、Workfront ドキュメントの イベント購読のバージョン管理を参照してください
レコードを更新
このアクションモジュールは、プロジェクト、タスク、イシューなどのオブジェクトを更新します。モジュールを使用すると、モジュールで使用可能なオブジェクトのフィールドを選択できます。
レコードの ID を指定します。
このモジュールは、オブジェクトの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
このモジュールを使用できるWorkfront オブジェクトタイプのリストについては、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプを参照してください。
レコードを更新(レガシー)
このモジュールを使用する既存のシナリオは、引き続き期待どおりに機能します。 このモジュールは、2025 年 5 月にモジュールセレクターから削除されます。
このアクションモジュールは、プロジェクト、タスク、イシューなどのオブジェクトを更新します。モジュールを使用すると、モジュールで使用可能なオブジェクトのフィールドを選択できます。
レコードの ID を指定します。
このモジュールは、オブジェクトの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
このモジュールを使用できるWorkfront オブジェクトタイプのリストについては、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプを参照してください。
- オブジェクトの ID を入力する際に、オブジェクトの名前を入力し、リストから選択できます。そうすると、モジュールが適切な ID をフィールドに入力します。
- カスタムフィールドまたはメモオブジェクト(コメントまたは返信)にテキストを入力する際、「メモテキスト」フィールドで HTML タグを使用して、太字や斜体などのリッチテキストを作成できます。
ドキュメントをアップロード
このアクションモジュールは、プロジェクト、タスク、イシューなどのWorkfront オブジェクトにドキュメントをアップロードします。 このモジュールは、ドキュメントをチャンク単位でアップロードするので、Workfrontのアップロードプロセスがスムーズになります。
このモジュールは、従来のモジュールよりも大きなファイルを処理でき、Ultimate Workfront パッケージを使用する組織への段階的なロールアウトの一部です。
ドキュメントの場所、アップロードするファイル、およびオプションで新しいファイル名を指定します。
このモジュールは、ドキュメントの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドと値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
このモジュールを使用できるWorkfront オブジェクトタイプのリストについては、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプを参照してください。
ドキュメントのアップロード(レガシー)
このアクションモジュールは、プロジェクト、タスク、イシューなどのWorkfront オブジェクトにドキュメントをアップロードします。 ドキュメント全体を一度にアップロードします。
ドキュメントの場所、アップロードするファイル、およびオプションで新しいファイル名を指定します。
このモジュールは、ドキュメントの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドと値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
このモジュールを使用できるWorkfront オブジェクトタイプのリストについては、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプを参照してください。