Adobe Workfront モジュール
Adobe Workfront Fusion Adobe Workfront コネクタを使用すると、Workfront 内でのプロセスを自動化できます。また、Workfrontを他のアプリケーションやサービスに接続することもできます。
シナリオの作成方法については、 シナリオの作成:記事のインデックスの記事を参照してください。 モジュールについて詳しくは、「 モジュール:記事インデックス」の記事を参照してください。
アクセス要件
この記事で説明している機能を使用するには、次のアクセス権が必要です。
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 ライセンスは必要ありません。 または レガシー:任意 |
製品 |
新規:
または 現在:Adobe Workfront Fusion を購入する必要があります。 |
このテーブルの情報について詳しくは、 ドキュメントのアクセス要件を参照してください。
Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。
note note |
---|
NOTE |
|
WorkfrontのWorkfront Fusion への接続
Workfront コネクタは、OAuth 2.0 を使用してWorkfrontに接続します。
Workfront アカウントへの接続は、Workfront Fusion モジュール内から直接作成できます。
-
任意の Adobe Workfront モジュールで、「接続」フィールドの横にある「追加」をクリックします。
-
次のフィールドに入力します。
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 本番環境と非本番環境のどちらに接続するかを選択します。 Connection type サービスアカウントと個人アカウントのどちらに接続するかを選択します。 Client ID Workfront クライアント ID を入力します。 これは、Workfront の設定エリアの OAuth2 アプリケーションエリアにあります。接続している特定のアプリケーションを開いて、クライアント ID を確認します。 Client Secret Workfront クライアントの秘密鍵を入力します。 これは、Workfront の設定エリアの OAuth2 アプリケーションエリアにあります。Workfrontで OAuth2 アプリケーションのクライアント秘密鍵がない場合は、別の秘密鍵を生成できます。 手順については、Workfrontのドキュメントを参照してください。 Authentication URL これはデフォルト値のままにすることもできますし、Workfront インスタンスの URL に続けて
/integrations/oauth2
を入力することもできます。例:
https://mydomain.my.workfront.com/integrations/oauth2
Host prefix ほとんどの場合、この値は origin
にしてください。 -
「Continue」をクリックして接続を保存し、モジュールに戻ります。
Workfrontにログインしていない場合は、ログイン画面が表示されます。 ログイン後、接続を許可できます。
- Workfront API への OAuth 2.0 接続は、API キーに依存しなくなりました。
- Workfront サンドボックス環境への接続を作成するには、その環境で OAuth2 アプリケーションを作成し、接続でそのアプリケーションによって生成されたクライアント ID とクライアントシークレットを使用する必要があります。
Workfront モジュールとそのフィールド
Workfront Fusion でWorkfront モジュールを設定する場合、以下に示すフィールドが表示されます。 これらに加えて、アプリまたはサービスのアクセスレベルなどの要因に応じて、追加のWorkfront フィールドが表示される場合があります。 モジュール内の太字のタイトルは、必須フィールドを示します。
フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、 モジュール間で情報をマッピングするを参照してください。
- Workfront モジュールに最新のフィールドが表示されない場合は、キャッシュの問題が原因である可能性があります。1 時間待ってから、もう一度試してください。
- Adobe Workfrontの HTTP 429 ステータスコードは、アクティベート解除の原因ではなく、代わりに、シナリオで短い実行の一時停止をトリガーにする必要があります。
トリガー
このトリガーモジュールは、Workfront で特定のタイプのオブジェクトが追加、更新、または削除された場合に、シナリオをリアルタイムで実行します。
このモジュールは、レコードに関連付けられた標準フィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
-
Webhook ボックスの右側にある Add をクリックします。
-
表示される Add a hook ボックスで Webhook を設定します。
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 Webhook name Web フックの名前を入力します。 Connection Workfront アプリケーションをWorkfront Fusion に接続する手順については、この記事の WorkfrontをWorkfront Fusion に接続を参照してください。 Record Type モジュールで監視するWorkfront レコードのタイプを選択します。 State 古い状態と新しい状態のどちらを監視するかを選択します。
-
New state
レコードが指定された値 に 変化したときにシナリオをトリガーします。
例えば、ステートが New State に設定され、フィルターが Status Equals In Progress に設定されている場合、Webhook は、以前のステータスに関係なく、Status が In Progress に変わると、シナリオをトリガーします。
-
Old state
レコードが指定された値 から 変化したときにシナリオをトリガーします。
例えば、ステートが Old State に設定され、フィルターが Status Equals In Progress に設定されている場合、現在 In Progress の Status が別のステータスに変わると、Webhook はシナリオをトリガーします。
Events filters 選択した条件を満たすレコードのみを監視するフィルターを設定できます。
各フィルターに対して、フィルターを評価するフィールド、演算子、およびフィルターに許可する値を入力します。AND ルールを追加すると、複数のフィルターを使用できます。
メモ :既存のWorkfront Webhook ではフィルターを編集できません。 Workfront イベント購読用に異なるフィルターを設定するには、現在の Webhook を削除して、新しい Webhook を作成します。
イベントフィルターについて詳しくは、この記事の Workfront/Watch Events モジュールのイベント購読フィルターを参照してください。
Exclude events made by this connection このトリガーモジュールが使用するのと同じコネクターを使用して作成または更新されたイベントを除外するには、このオプションを有効にします。これにより、シナリオが自分自身をトリガーし、無限ループが繰り返されることを防ぐことができます。
注意 : 「アサイメント」レコード・タイプには、このオプションは含まれていません。
Record Origin シナリオで New Records Only、Updated Records Only、New and Updated Records、Deleted Records Only のいずれを監視するかを選択します。
メモ :New and Updated Records を選択すると、Webhook の作成により(同じ Webhook アドレスに対して) 2 つのイベント購読が作成されます。
-
Web フックを作成した後、イベントの送信先エンドポイントのアドレスを表示できます。
詳しくは、Workfront ドキュメントの Event Subscription API の記事の イベントペイロードの例を参照してください。
このモジュールを使用できるWorkfront オブジェクトタイプのリストについては、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプを参照してください。
このトリガーモジュールは、指定したフィールドが更新されるとシナリオを実行します。モジュールは、指定されたフィールドの古い値と新しい値の両方を返します。 この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header | |
---|---|
Connection | Workfront アプリケーションをWorkfront Fusion に接続する手順については、この記事の WorkfrontをWorkfront Fusion に接続を参照してください。 |
Record Type |
モジュールで監視するWorkfront レコードのタイプを選択します。 例えば、タスクでレコードフィールドが更新されるたびにシナリオの実行を開始する場合は、「Task」を選択します。 |
Field | モジュールで更新を監視するフィールドを選択します。これらのフィールドは、Workfront管理者がトラッキング用に設定したフィールドを反映しています。 |
Outputs | このモジュールの出力バンドルに含めるオブジェクトフィールドを選択します。 |
Limit | 各シナリオの実行サイクル中に、モジュールが返すレコードの最大数を入力またはマッピングします。 |
このモジュールを使用できるWorkfront オブジェクトタイプのリストについては、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプを参照してください。
このトリガーモジュールは、特定のタイプのオブジェクトが追加、更新、またはその両方が行われた場合にシナリオを実行します。このモジュールは、レコードに関連付けられたすべての標準フィールドと、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
出力のモジュールは、各レコードが新規か更新かを示します。
シナリオが前回実行されてから追加および更新されたレコードは、新しいレコードとして返されます。
このモジュールを設定する際には、次のフィールドが表示されます。
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 layout-auto html-authored no-header | |
---|---|
Connection | Workfront アプリケーションをWorkfront Fusion に接続する手順については、この記事の WorkfrontをWorkfront Fusion に接続を参照してください。 |
Filter | シナリオで New Records Only、Updated Records Only、New and Updated Records のいずれを監視するかを選択します。 |
Record Type |
モジュールで監視するWorkfront レコードのタイプを選択します。 例えば、新しいプロジェクトが作成されるたびにシナリオを開始する場合は、を選択します。 Project |
Outputs | このモジュールの出力バンドルに含めるフィールドを選択します。 |
Reference | このモジュールの出力バンドルに含める参照フィールドを選択します。 |
Outputs | このモジュールの出力バンドルに含めるコレクションフィールドを選択します。 |
Optional Filter | (詳細)API コード文字列を入力して、条件を絞り込む追加のパラメーターまたはコードを定義します。 |
Limit | 各シナリオの実行サイクル中に、モジュールが返すレコードの最大数を入力またはマッピングします。 |
このモジュールを使用できるWorkfront オブジェクトタイプのリストについては、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプを参照してください。
アクション
このアクションモジュールは、次のいずれかの変換を行います。
- イシューをプロジェクトに変換
- イシューをタスクに変換
- タスクをプロジェクトに変換
note note |
---|
NOTE |
2024 年 7 月から、オブジェクトの変換時にカスタムフォームを含めることができます。 |
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 layout-auto html-authored no-header | |
---|---|
Connection | Workfront アプリケーションをWorkfront Fusion に接続する手順については、この記事の WorkfrontをWorkfront Fusion に接続を参照してください。 |
Object type | 変換するオブジェクトのタイプを選択します。これは、変換前のオブジェクトのタイプです。 |
Convert to | 変換先のオブジェクトを選択します。これは、変換後のオブジェクトのタイプです。 |
<Object> ID |
オブジェクトの ID を入力します。 メモ:オブジェクトの ID を入力する場合は、オブジェクトの名前を入力していき、目的のオブジェクトがリストに表示されたら、それを選択します。そうすると、モジュールが適切な ID をフィールドに入力します。 |
Template ID |
プロジェクトに変換する場合は、プロジェクトに使用するテンプレートの ID を選択します。 メモ:オブジェクトの ID を入力する場合は、オブジェクトの名前を入力していき、目的のオブジェクトがリストに表示されたら、それを選択します。そうすると、モジュールが適切な ID をフィールドに入力します。 |
Custom forms | 新しく変換されたオブジェクトに追加するカスタムフォームを選択し、カスタムフォームのフィールドに値を入力します。 |
Options | オブジェクトの変換時に必要なオプションを有効にします。変換先または変換元のオブジェクトに応じて、オプションを使用できます。 |
Copy native fields | このオプションを有効にすると、元のオブジェクトから新しいオブジェクトにネイティブフィールドがコピーされます。 |
Copy custom forms | このオプションを有効にすると、元のオブジェクトから新しいオブジェクトにネイティブフィールドがコピーされます。 |
このアクションモジュールは、Workfrontのプロジェクト、タスク、イシューなどのオブジェクトを作成し、新しいオブジェクトにカスタムフォームを追加できます。 モジュールを使用すると、モジュールで使用可能なオブジェクトのフィールドを選択できます。
レコードの ID を指定します。
このモジュールは、レコードの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
入力フィールドの最小数を指定してください。例えば、イシューを作成する場合は、「プロジェクト ID」フィールドに有効な親プロジェクト ID を指定して、Workfront でイシューの配置先を示す必要があります。マッピングパネルを使用してシナリオ内の別のモジュールからこの情報をマッピングするか、名前を入力してリストから選択し、手動で入力することもできます。
このモジュールを設定する際には、次のフィールドが表示されます。
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
---|---|
Connection | Workfront アプリケーションをWorkfront Fusion に接続する手順については、この記事の WorkfrontをWorkfront Fusion に接続を参照してください。 |
Record Type |
モジュールで作成するWorkfront レコードのタイプを選択します。 例えば、プロジェクトを作成する場合は、ドロップダウンリストから「Project」を選択します。 |
Select fields to map |
データ入力に使用するフィールドを選択します。これにより、不要なフィールドをスクロールしなくても、これらのフィールドを使用できます。 その後、これらのフィールドにデータを入力またはマッピングできます。 カスタムフォームのフィールドには、Attach Custom Form フィールドを使用します。 |
Attach Custom Form | 新しいオブジェクトに追加するカスタムフォームを選択し、これらのフィールドの値を入力またはマッピングします。 |
このモジュールを使用できるWorkfront オブジェクトタイプのリストについては、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプを参照してください。
note note |
---|
NOTE |
|
このアクションモジュールは、Workfront でプロジェクト、タスク、イシューなどのオブジェクトを作成します。モジュールを使用すると、モジュールで使用可能なオブジェクトのフィールドを選択できます。
レコードの ID を指定します。
このモジュールは、レコードの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
入力フィールドの最小数を指定してください。例えば、イシューを作成する場合は、「プロジェクト ID」フィールドに有効な親プロジェクト ID を指定して、Workfront でイシューの配置先を示す必要があります。マッピングパネルを使用してシナリオ内の別のモジュールからこの情報をマッピングするか、名前を入力してリストから選択し、手動で入力することもできます。
このモジュールでは、オブジェクトを作成する際にカスタムフォームを添付しません。 オブジェクトの作成時にカスタムフォームを添付するには、Create a record (attaching custom forms) モジュールを使用します。
このモジュールを設定する際には、次のフィールドが表示されます。
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
---|---|
Connection | Workfront アプリケーションをWorkfront Fusion に接続する手順については、この記事の WorkfrontをWorkfront Fusion に接続を参照してください。 |
Record Type |
モジュールで作成するWorkfront レコードのタイプを選択します。 例えば、プロジェクトを作成する場合は、ドロップダウンリストから「Project」を選択します。 |
Select fields to map | データ入力に使用するフィールドを選択します。これにより、不要なフィールドをスクロールしなくても、これらのフィールドを使用できます。 |
このモジュールを使用できるWorkfront オブジェクトタイプのリストについては、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプを参照してください。
note note |
---|
NOTE |
|
このアクションモジュールを使用すると、Workfront API に対してカスタム認証呼び出しを行うことができます。 これにより、他のWorkfront モジュールでは実現できないデータフローの自動処理を作成できます。
このモジュールは、次の情報を返します。
-
Status Code (数字):HTTP リクエストの成功または失敗を示します。 これらはインターネット上で検索できる標準コードです。
-
Headers (オブジェクト):出力本文に関連しない、応答/ステータスコードのより詳細なコンテキスト。 応答ヘッダーに表示されるすべてのヘッダーが応答ヘッダーではないので、不要なヘッダーも含まれている可能性があります。
応答ヘッダーは、モジュールの設定時に選択した HTTP リクエストによって異なります。
-
Body (オブジェクト):モジュールの設定時に選択した HTTP リクエストによっては、一部のデータが返される場合があります。 GET リクエストからのデータなどは、このオブジェクトに含まれます。
この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
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 | Workfront アプリケーションをWorkfront Fusion に接続する手順については、この記事の WorkfrontをWorkfront Fusion に接続を参照してください。 |
URL | https://<WORKFRONT_DOMAIN>/attask/api/<API_VERSION>/ への相対パスを入力します。 |
API Version | モジュールで使用するWorkfront API のバージョンを選択します。 |
Method | API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。詳しくは、Adobe Workfront Fusion の HTTP リクエストメソッドを参照してください。 |
Headers |
リクエストのヘッダーを標準 JSON オブジェクトの形式で追加します。これにより、リクエストのコンテンツタイプが決まります。 例: メモ:エラーが発生し、接触チャネルを特定するのが難しい場合は、Workfrontのドキュメントに基づいてヘッダーを変更することを検討してください。 カスタム API 呼び出しで 422 HTTP リクエストエラーが返される場合は、 |
Query String |
API 呼び出しのクエリを標準 JSON オブジェクトの形式で追加します。 例: ヒント:情報は、クエリパラメーターではなく、JSON 本文を使用して送信することをお勧めします。 |
Body |
標準の JSON オブジェクトの形式で、API 呼び出しの本文の内容を追加します。 メモ:
|
このモジュールを使用できるWorkfront オブジェクトタイプのリストについては、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプを参照してください。
このアクションモジュールは、Workfront のプロジェクト、タスクまたはイシューなどのオブジェクトを削除します。
レコードの ID を指定します。
このモジュールは、レコードの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header | |
---|---|
Connection | Workfront アプリケーションをWorkfront Fusion に接続する手順については、この記事の WorkfrontをWorkfront Fusion に接続を参照してください。 |
Force delete | このオプションを有効にすると、Workfront UI から削除の確認がリクエストされる場合でも、レコードが確実に削除されます。 |
Async delete | モジュールを非同期で削除できるようにするには、このオプションを有効にします。 |
ID |
モジュールから削除するレコードの一意のWorkfront ID を入力します。 ID を取得するには、ブラウザーでWorkfront オブジェクトを開き、URL の末尾にある「ID=」の後のテキストをコピーします。 例:https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e |
Record Type | モジュールから削除するWorkfront レコードのタイプを選択します。 |
このモジュールを使用できるWorkfront オブジェクトタイプのリストについては、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプを参照してください。
note note |
---|
NOTE |
操作が同期されずにレコードが削除されない可能性を回避するために、次のシナリオ設定をお勧めします。 |
|
このアクションモジュールは、Workfront からドキュメントをダウンロードします。
レコードの ID を指定します。
このモジュールは、ドキュメントの内容、ファイル名、ファイル拡張子、ファイルサイズを返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
table 0-row-2 1-row-2 layout-auto html-authored no-header | |
---|---|
Connection | Workfront アプリケーションをWorkfront Fusion に接続する手順については、この記事の WorkfrontをWorkfront Fusion に接続を参照してください。 |
Document ID |
モジュールをダウンロードするドキュメントの一意のWorkfront ID をマッピングするか、手動で入力します。 ID を取得するには、ブラウザーでWorkfront オブジェクトを開き、URL の末尾にある「ID=」の後のテキストをコピーします。 例:https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e |
このモジュールを使用できるWorkfront オブジェクトタイプのリストについては、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプを参照してください。
このアクションモジュールを使用すると、API に対してアクションを実行できます。
note note |
---|
NOTE |
2024 年 7 月現在、convertToProject のアクションにはフィールド copyCategories が含まれています。 TRUE に設定すると、すべてのカスタムフォームは、イシューが変換されるプロジェクトに含まれます。 |
このモジュールを設定する際には、次のフィールドが表示されます。
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
---|---|
Connection | Workfront アプリケーションをWorkfront Fusion に接続する手順については、この記事の WorkfrontをWorkfront Fusion に接続を参照してください。 |
Record Type | モジュールでやり取りするWorkfront レコードのタイプを選択します。 |
Action |
モジュールで実行するアクションを選択します。 選択した Record Type や Action に応じて、追加のフィールドに入力する必要が生じる場合があります。 これら 2 つの設定の組み合わせには、レコード ID のみが必要なものもあれば(Record Type のプロジェクトや Action の Attach Template など)、追加情報(オブジェクト ID やテンプレート ID など)が必要なものもあります。 一部のアクションで使用できるオプションについては、この記事の その他のアクションオプションを参照してください。 個々のフィールドについて詳しくは、Workfront 開発者ドキュメントを参照してください。 メモ:開発者ドキュメントサイトには、API バージョン 14 を通じた情報のみが含まれていますが、API 呼び出しに関する有用な情報がまだ含まれています。
メモ: Workfront Misc Action モジュールを使用してプルーフを作成する場合、ベストプラクティスは、詳細オプションを使用せずにプルーフを作成し、Workfront Proof SOAP API を使用してプルーフを更新することです。 Workfront API (このモジュールが使用)を使用したプルーフの作成について詳しくは、Adobe Workfront API でプルーフを作成する際の詳細プルーフオプションの追加を参照してください |
ID |
モジュールでやり取りするレコードの一意のWorkfront ID を入力またはマッピングします。 ID を取得するには、ブラウザーでWorkfront オブジェクトを開き、URL の末尾にある「ID=」の後のテキストをコピーします。 例:https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e |
このモジュールを使用できるWorkfront オブジェクトタイプのリストについては、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプを参照してください。
その他のアクションオプション
タスク
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored | |
---|---|
アクション | オプション |
コピー |
|
移動 |
|
イシュー
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored | |
---|---|
アクション | オプション |
コピー |
|
タスクに変換 |
|
プロジェクトに変換 |
|
プロジェクト
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored | |
---|---|
アクション | オプション |
コピー |
|
テンプレートを添付/テンプレートとして保存 |
|
このアクションモジュールは、1 つのレコードからデータを取得します。
レコードの ID を指定します。また、モジュールで読み取る関連レコードを指定することもできます。
例えば、モジュールが読み取っているレコードがプロジェクトの場合、プロジェクトのタスクを読み込むように指定できます。
モジュールは、指定した出力フィールドからデータの配列を返します。
このモジュールを設定する際には、次のフィールドが表示されます。
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 | Workfront アプリケーションをWorkfront Fusion に接続する手順については、この記事の WorkfrontをWorkfront Fusion に接続を参照してください。 |
Record Type | モジュールで読み取るWorkfront オブジェクトタイプを選択します。 |
Outputs | このモジュールの出力バンドルに含める情報を選択します。 |
References | 出力に含める参照フィールドを選択します。 |
Collections | 出力に含める参照フィールドを選択します。 |
ID |
モジュールで読み取るレコードの一意のWorkfront ID を入力します。 ID を取得するには、ブラウザーでWorkfront オブジェクトを開き、URL の末尾にある「ID=」の後のテキストをコピーします。 例:https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e |
このモジュールを使用できるWorkfront オブジェクトタイプのリストについては、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプを参照してください。
このアクションモジュールは、プロジェクト、タスク、イシューなどのオブジェクトを更新します。モジュールを使用すると、モジュールで使用可能なオブジェクトのフィールドを選択できます。
レコードの ID を指定します。
このモジュールは、オブジェクトの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
---|---|
Connection | Workfront アプリケーションをWorkfront Fusion に接続する手順については、この記事の WorkfrontをWorkfront Fusion に接続を参照してください。 |
ID |
モジュールで更新するレコードの一意のWorkfront ID を入力します。 ID を取得するには、ブラウザーでWorkfront オブジェクトを開き、URL の末尾にある「ID=」の後のテキストをコピーします。 例:https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e |
Record Type | モジュールで更新するWorkfront レコードのタイプを選択します。 |
Select fields to map | データ入力に使用するフィールドを選択します。これにより、不要なフィールドをスクロールしなくても、これらのフィールドを使用できます。 その後、これらのフィールドにデータを入力またはマッピングできます。 |
このモジュールを使用できるWorkfront オブジェクトタイプのリストについては、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプを参照してください。
note note |
---|
NOTE |
|
このアクションモジュールは、プロジェクト、タスク、イシューなどのWorkfront オブジェクトにドキュメントをアップロードします。 このモジュールは、ドキュメントをチャンク単位でアップロードするので、Workfrontのアップロードプロセスがスムーズになります。
このモジュールは、従来のモジュールよりも大きなファイルを処理でき、Ultimate Workfront パッケージを使用する組織への段階的なロールアウトの一部です。
ドキュメントの場所、アップロードするファイル、およびオプションで新しいファイル名を指定します。
このモジュールは、ドキュメントの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドと値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header | |
---|---|
Connection | Workfront アプリケーションをWorkfront Fusion に接続する手順については、この記事の WorkfrontをWorkfront Fusion に接続を参照してください。 |
Related Record ID | ドキュメントをアップロードするレコードの一意のWorkfront ID を入力します。 |
Related Record Type | モジュールがドキュメントをアップロードするWorkfront レコードのタイプを選択します。 |
Folder ID | 関連レコードのタイプに応じて、フォルダー ID の入力またはマッピングが必要になる場合があります。 |
Source file | 以前のモジュールで使用したソースファイルを選択するか、ソースファイルの名前とデータをマッピングします。 |
このモジュールを使用できるWorkfront オブジェクトタイプのリストについては、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプを参照してください。
このアクションモジュールは、プロジェクト、タスク、イシューなどのWorkfront オブジェクトにドキュメントをアップロードします。 ドキュメント全体を一度にアップロードします。
ドキュメントの場所、アップロードするファイル、およびオプションで新しいファイル名を指定します。
このモジュールは、ドキュメントの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドと値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header | |
---|---|
Connection | Workfront アプリケーションをWorkfront Fusion に接続する手順については、この記事の WorkfrontをWorkfront Fusion に接続を参照してください。 |
Related Record ID | ドキュメントをアップロードするレコードの一意のWorkfront ID を入力します。 |
Related Record Type | モジュールがドキュメントをアップロードするWorkfront レコードのタイプを選択します。 |
Folder ID | 関連レコードのタイプに応じて、フォルダー ID の入力またはマッピングが必要になる場合があります。 |
Source file | 以前のモジュールで使用したソースファイルを選択するか、ソースファイルの名前とデータをマッピングします。 |
このモジュールを使用できるWorkfront オブジェクトタイプのリストについては、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプを参照してください。
検索
この検索モジュールは、特定の親オブジェクト内で、指定した検索クエリに一致するレコードを読み取ります。
出力に含めるフィールドを指定します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header | |
---|---|
Connection | Workfront アプリケーションをWorkfront Fusion に接続する手順については、この記事の WorkfrontをWorkfront Fusion に接続を参照してください。 |
Record Type |
読み取る関連レコードの親レコード(Workfront オブジェクト)のタイプを選択します。 この記事では、 各Workfront モジュールで使用できるWorkfront オブジェクトタイプで、このモジュールを使用できるWorkfront オブジェクトタイプのリストを参照してください。 |
Parent Record ID |
読み取る関連レコードの親レコードの ID を入力またはマッピングします。 ID を取得するには、ブラウザーでWorkfront オブジェクトを開き、URL の末尾にある「ID=」の後のテキストをコピーします。 例:https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e |
Collections | モジュールが読み取る子レコードのタイプを選択またはマッピングします。 |
Outputs | このモジュールの出力バンドルに含める情報を選択します。 |
この検索モジュールは、指定した検索クエリに一致するWorkfront内のオブジェクト内のレコードを検索します。
この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 layout-auto html-authored no-header | |
---|---|
Connection | Workfront アプリケーションをWorkfront Fusion に接続する手順については、この記事の WorkfrontをWorkfront Fusion に接続を参照してください。 |
Record Type | モジュールで検索するWorkfront レコードのタイプを選択します。 |
Result Set | モジュールが検索条件に一致する最初の結果を取得するか、一致するすべての結果を取得するかを指定するオプションを選択します。 |
Maximal | 各シナリオの実行サイクル中に、モジュールが返すレコードの最大数を入力またはマッピングします。 |
Search criteria fields | 検索条件に使用するフィールドを選択します。これらのフィールドは、検索条件ドロップダウンで使用できるようになります。 |
Search criteria |
検索するフィールド、クエリで使用する演算子、およびそのフィールドで検索する値を入力します。 メモ:検索条件に メモ: |
Outputs | このモジュールの出力に含めるフィールドを選択します。 |
References | 検索に含める参照フィールドを選択します。 |
Collections | 検索に追加するコレクションを選択します。 |
各Workfront モジュールで使用できるWorkfront オブジェクトタイプ
table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 16-row-4 17-row-4 18-row-4 19-row-4 20-row-4 21-row-4 22-row-4 23-row-4 24-row-4 25-row-4 26-row-4 27-row-4 28-row-4 29-row-4 30-row-4 31-row-4 32-row-4 33-row-4 34-row-4 35-row-4 36-row-4 37-row-4 38-row-4 39-row-4 40-row-4 41-row-4 layout-auto | |||
---|---|---|---|
Watch Record | Watch Field | Watch Events | |
承認プロセス | ✓ | ||
割り当て | ✓ | ✓ | |
ベースライン | ✓ | ||
請求記録 | ✓ | ||
請求レート | ✓ | ||
会社 | ✓ | ✓ | ✓ |
ダッシュボード | ✓ | ||
ドキュメント | ✓ | ✓ | ✓ |
ドキュメントフォルダー | ✓ | ✓ | |
ドキュメントリクエスト | ✓ | ||
ドキュメントのバージョン | ✓ | ✓ | |
費用 | ✓ | ✓ | ✓ |
費用タイプ | |||
グループ | ✓ | ✓ | |
時間 | ✓ | ✓ | |
時間タイプ | ✓ | ||
イシュー | ✓ | ✓ | ✓ |
イテレーション | ✓ | ✓ | |
担当業務 | ✓ | ✓ | |
ジャーナルエントリ | ✓ | ||
マイルストーン | ✓ | ||
マイルストーンパス | ✓ | ✓ | |
メモ | ✓ | ✓ | ✓ |
メモタグ | ✓ | ||
ポートフォリオ | ✓ | ✓ | ✓ |
プログラム | ✓ | ✓ | ✓ |
プロジェクト | ✓ | ✓ | ✓ |
プロジェクトユーザー | ✓ | ||
プルーフの承認 | ✓ | ||
予約済み時間* | ✓ | ||
レポート | ✓ | ||
リスク | |||
リスクタイプ | |||
ステップ承認者 | ✓ | ||
タスク | ✓ | ✓ | ✓ |
チーム | ✓ | ||
テンプレート | ✓ | ✓ | ✓ |
テンプレートタスク | ✓ | ✓ | |
タイムシート | ✓ | ✓ | ✓ |
ユーザー | ✓ | ✓ | ✓ |
アップデート |
note note |
---|
NOTE |
Workfront オブジェクトタイプは設定に含まれていないので、Download Document モジュールはこのテーブルに含まれていません。 |
table 0-row-8 1-row-8 2-row-8 3-row-8 4-row-8 5-row-8 6-row-8 7-row-8 8-row-8 9-row-8 10-row-8 11-row-8 12-row-8 13-row-8 14-row-8 15-row-8 16-row-8 17-row-8 18-row-8 19-row-8 20-row-8 21-row-8 22-row-8 23-row-8 24-row-8 25-row-8 26-row-8 27-row-8 28-row-8 29-row-8 30-row-8 31-row-8 32-row-8 33-row-8 34-row-8 35-row-8 36-row-8 37-row-8 38-row-8 39-row-8 layout-auto | |||||||
---|---|---|---|---|---|---|---|
Create a record | Update a record | Delete a record | Upload Document | Read a record | Custom API Call | Misc Action | |
承認プロセス | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
割り当て | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |
ベースライン | ✓ | ✓ | ✓ | ✓ | |||
請求記録 | ✓ | ✓ | ✓ | ✓ | |||
請求レート | ✓ | ✓ | ✓ | ✓ | ✓ | ||
会社 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
ドキュメント | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
ドキュメントフォルダー | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
ドキュメントのバージョン | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |
為替レート | ✓ | ✓ | ✓ | ✓ | |||
費用 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
費用タイプ | ✓ | ✓ | ✓ | ✓ | |||
外部ドキュメント | ✓ | ||||||
グループ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
時間 | ✓ | ✓ | ✓ | ✓ | ✓ | ||
時間タイプ | ✓ | ✓ | ✓ | ✓ | |||
イシュー | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
イテレーション | ✓ | ✓ | ✓ | ✓ | ✓ | ||
担当業務 | ✓ | ✓ | ✓ | ✓ | ✓ | ||
ジャーナルエントリ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |
マイルストーン | ✓ | ✓ | ✓ | ✓ | ✓ | ||
マイルストーンパス | ✓ | ✓ | ✓ | ✓ | ✓ | ||
メモ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
メモタグ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
ポートフォリオ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
プログラム | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
プロジェクト | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
プロジェクトユーザー | ✓ | ✓ | ✓ | ✓ | ✓ | ||
予約済み時間* | ✓ | ✓ | ✓ | ✓ | ✓ | ||
リスク | ✓ | ✓ | ✓ | ✓ | ✓ | ||
リスクタイプ | ✓ | ✓ | ✓ | ✓ | |||
ステップ承認者 | ✓ | ✓ | ✓ | ✓ | ✓ | ||
タスク | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
チーム | ✓ | ✓ | ✓ | ✓ | |||
テンプレート | ✓ | ✓ | ✓ | ✓ | ✓ | ||
テンプレートタスク | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
タイムシート | ✓ | ✓ | ✓ | ✓ | ✓ | ||
ユーザー | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
アップデート | ✓ |
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3 14-row-3 15-row-3 16-row-3 17-row-3 18-row-3 19-row-3 20-row-3 21-row-3 22-row-3 23-row-3 24-row-3 25-row-3 26-row-3 27-row-3 28-row-3 29-row-3 30-row-3 31-row-3 32-row-3 33-row-3 34-row-3 35-row-3 36-row-3 layout-auto | ||
---|---|---|
Search | Read Related Records | |
承認プロセス | ✓ | ✓ |
割り当て | ✓ | ✓ |
請求記録 | ✓ | |
請求レート | ✓ | |
会社 | ✓ | ✓ |
ドキュメント | ✓ | ✓ |
ドキュメントフォルダー | ✓ | ✓ |
ドキュメントのバージョン | ✓ | |
費用 | ✓ | |
費用タイプ | ✓ | |
グループ | ✓ | ✓ |
時間 | ✓ | |
時間タイプ | ✓ | |
イシュー | ✓ | ✓ |
イテレーション | ✓ | |
担当業務 | ✓ | |
ジャーナルエントリ | ✓ | |
マイルストーン | ✓ | |
マイルストーンパス | ✓ | |
メモ | ✓ | |
メモタグ | ✓ | |
ポートフォリオ | ✓ | ✓ |
プログラム | ✓ | |
プロジェクト | ✓ | ✓ |
プロジェクトユーザー | ✓ | |
予約済み時間* | ✓ | |
リスク | ✓ | |
リスクタイプ | ✓ | |
ステップ承認者 | ✓ | |
タスク | ✓ | ✓ |
チーム | ✓ | |
テンプレート | ✓ | |
テンプレートタスク | ✓ | |
タイムシート | ✓ | ✓ |
ユーザー | ✓ | ✓ |
ユーザーの委任 | ✓ |
これが期待どおりに機能することを再確認することをお勧めします。
Workfront/Watch Events モジュールでのイベント購読フィルター
Workfront Watch Events モジュールは、Workfront API でイベント購読を作成する Webhook に基づくシナリオをトリガーします。 イベント登録は、web フックに送信されるイベントを決定する一連のデータです。例えば、問題を監視する Watch Events モジュールを設定した場合、イベント購読は問題に関連するイベントのみを送信します。
Fusion ユーザーは、イベント登録フィルターを使用して、ユースケースに適したイベント登録を作成できます。例えば、Workfront API でイベント購読を設定して、特定のプロジェクトの問題のみを Webhook に送信し、Watch Events モジュールがそのプロジェクトの問題のみをトリガーするようにできます。 より範囲の狭いトリガーを作成できるので、無関係なトリガーの数が減り、シナリオの設計を改善できます。
これは、Workfront Fusion シナリオでフィルターを設定する場合とは異なります。 イベント登録フィルターを使用しない場合、web フックは、選択されたオブジェクトタイプに関連するすべてのイベントを受信します。これらのイベントのほとんどはシナリオとは無関係と思われるので、シナリオを続行する前に除外する必要があります。
Workfront/イベントの監視フィルターで使用できる演算子は、次のとおりです。
-
が次と等しい
-
等しくない
-
より大きい
-
より小さい
-
が次よりも大きいか等しい
-
が次よりも小さいか等しい
-
が次を含む
-
存在する
- この演算子には値は必要ありません。また、値フィールドは存在しません。
-
が存在しません
- この演算子には値は必要ありません。また、値フィールドは存在しません。
-
変更済み
- この演算子には値は必要ありません。また、値フィールドは存在しません。
- この演算子では、「状態」フィールドを無視します。
Changed
を使用する際は、「レコード元」フィールドで「更新されたイベントのみ」を選択します。
イベント登録フィルターを使用したイベントのフィルタリング(推奨) %E3%82%A4%E3%83%99%E3%83%B3%E3%83%88%E7%99%BB%E9%8C%B2%E3%83%95%E3%82%A3%E3%83%AB%E3%82%BF%E3%83%BC%E3%82%92%E4%BD%BF%E7%94%A8%E3%81%97%E3%81%9F%E3%82%A4%E3%83%99%E3%83%B3%E3%83%88%E3%81%AE%E3%83%95%E3%82%A3%E3%83%AB%E3%82%BF%E3%83%AA%E3%83%B3%E3%82%B0%EF%BC%88%E6%8E%A8%E5%A5%A8%EF%BC%89
![イベントフィルター](./media_1b0a9cc211de0ef1e547eb88d47b4531a9d1004d8.png?width=750&format=png&optimize=medium)
シナリオ内でのイベントのフィルタリング(非推奨) %E3%82%B7%E3%83%8A%E3%83%AA%E3%82%AA%E5%86%85%E3%81%A7%E3%81%AE%E3%82%A4%E3%83%99%E3%83%B3%E3%83%88%E3%81%AE%E3%83%95%E3%82%A3%E3%83%AB%E3%82%BF%E3%83%AA%E3%83%B3%E3%82%B0%EF%BC%88%E9%9D%9E%E6%8E%A8%E5%A5%A8%EF%BC%89
![イベントフィルターなし](./media_1bc976a7eb8303304a3ca3dc0d7ad3d810efc8fcd.png?width=750&format=png&optimize=medium)
Workfront イベント購読について詳しくは、FAQ - イベント購読を参照してください。
Webhook について詳しくは、「Adobe Workfront Fusion の インスタントトリガー(Webhook)」を参照してください
シナリオのフィルターについて詳しくは、 シナリオへのフィルターの追加を参照してください。