Adobe Workfront モジュール
Adobe Workfront Fusion Adobe Workfront コネクタを使用して、Workfront 内のプロセスを自動化できます。Workfront Fusion for Work Automation and Integration ライセンスをお持ちの場合は、それを使用してサードパーティのアプリケーションやサービスに接続することもできます。
Workfront コネクタは、組織で使用可能なアクティブなアプリの数に対してカウントされません。すべてのシナリオは、Workfront アプリのみを使用する場合でも、組織の合計シナリオ数にカウントされます。
組織で使用可能なアプリとシナリオについて詳しくは、🔗 Adobe Workfront Fusion の組織とチームの組織を参照してください。
シナリオの作成手順が必要な場合は、 Adobe Workfront Fusion でのシナリオの作成を参照してください。モジュールについて詳しくは、 Adobe Workfront Fusion のモジュールを参照してください。
アクセス要件
この記事で説明している機能を使用するには、次のアクセス権が必要です。
ご利用のプラン、ライセンスタイプまたはアクセス権を確認するには、Workfront 管理者にお問い合わせください。
Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。
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 クライアント ID を入力します。これは、Workfront の設定エリアの OAuth2 アプリケーションエリアにあります。接続している特定のアプリケーションを開いて、クライアント ID を確認します。 Authentication URL これはデフォルト値のままにすることもできますし、Workfront インスタンスの URL に続けて
/integrations/oauth2
を入力することもできます。例:
https://mydomain.my.workfront.com/integrations/oauth2
Host prefix ほとんどの場合、この値は origin
にしてください。 -
「続行」をクリックして接続を保存し、モジュールに戻ります。
-
SAML ログインボタンが表示されない場合、組織ではシングルサインオン(SSO)が有効になっていません。ユーザー名とパスワードを使用してログインできます。
SSO について詳しくは、シングルサインオンの概要 Adobe Workfrontを参照してください。
-
Workfront API への OAuth 2.0 接続は API キーに依存しなくなりました。
-
Workfront サンドボックス環境への接続を作成するには、その環境で OAuth2 アプリケーションを作成し、接続でそのアプリケーションによって生成されたクライアント ID とクライアントシークレットを使用する必要があります。
Workfrontで OAuth2 アプリケーションを作成する方法については、Workfront統合用の OAuth2 アプリケーションの作成の記事の ユーザー資格情報を使用した OAuth2 アプリケーションの作成(認証コードフロー)を参照してください。
Workfront モジュールとそのフィールド
Workfront モジュールを設定する際、Workfront Fusion に以下のフィールドが表示されます。これらに加えて、アプリまたはサービスのアクセスレベルなどの要因に応じて、追加の Workfront フィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。
フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、 Adobe Workfront Fusion でモジュールから別のモジュールに情報をマッピングを参照してください。
- Workfront モジュールに最新のフィールドが表示されない場合は、キャッシュの問題が原因である可能性があります。1 時間待ってから、もう一度試してください。
- Adobe Workfrontの HTTP 429 ステータスコードは、アクティベート解除の原因ではなく、代わりに、シナリオで短い実行の一時停止をトリガーにする必要があります。
トリガー
このトリガーモジュールは、Workfront で特定のタイプのオブジェクトが追加、更新、または削除された場合に、シナリオをリアルタイムで実行します。
このモジュールは、レコードに関連付けられた標準フィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
-
「Web フック」ボックスの右側にある「追加」をクリックします。
-
表示される「フックを追加」ボックスで Web フックを設定します。
このモジュールを設定する際には、次のフィールドが表示されます。
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 に設定されている場合、Status が In Progress に変わると、以前のステータスに関係なく、web フックがシナリオをトリガーします。
-
Old state
レコードが指定された値 から 変化したときにシナリオをトリガーします。
例えば、状態が Old State に設定され、フィルターが Status Equals In Progress に設定されている場合、現在 In Progress である Status が別のステータスに変わると、web フックがシナリオをトリガーします。
Events filters 選択した条件を満たすレコードのみを監視するフィルターを設定できます。
各フィルターに対して、フィルターを評価するフィールド、演算子、およびフィルターに許可する値を入力します。AND ルールを追加すると、複数のフィルターを使用できます。
メモ:既存の Workfront web フックのフィルターは編集できません。Workfront イベントのサブスクリプションに別のフィルターを設定するには、現在の web フックを削除し、新しい web フックを作成します。
イベントフィルターについて詳しくは、この記事の 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 を選択した場合、web フックの作成により 2 つのイベントサブスクリプションが同じ web フックアドレスに対して作成されます。
-
Web フックを作成した後、イベントの送信先エンドポイントのアドレスを表示できます。
詳しくは、Workfront ヘルプ記事イベントサブスクリプション 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 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 | このモジュールの出力バンドルに含める情報を選択します。 |
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 Fusion への Workfront の接続を参照してください。 |
Object type | 変換するオブジェクトのタイプを選択します。これは、変換前のオブジェクトのタイプです。 |
Convert to | 変換先のオブジェクトを選択します。これは、変換後のオブジェクトのタイプです。 |
<Object> ID |
オブジェクトの ID を入力します。 メモ:オブジェクトの ID を入力する場合は、オブジェクトの名前を入力していき、目的のオブジェクトがリストに表示されたら、それを選択します。そうすると、モジュールが適切な ID をフィールドに入力します。 |
Template ID |
プロジェクトに変換する場合は、プロジェクトに使用するテンプレートの ID を選択します。 メモ:オブジェクトの ID を入力する場合は、オブジェクトの名前を入力していき、目的のオブジェクトがリストに表示されたら、それを選択します。そうすると、モジュールが適切な ID をフィールドに入力します。 |
Custom forms | 新しく変換されたオブジェクトに追加するカスタムフォームを選択し、カスタムフォームのフィールドに値を入力します。 |
Options | オブジェクトの変換時に必要なオプションを有効にします。変換先または変換元のオブジェクトに応じて、オプションを使用できます。 |
ネイティブ フィールドのコピー | このオプションを有効にすると、元のオブジェクトから新しいオブジェクトにネイティブフィールドがコピーされます。 |
カスタム フォームのコピー | このオプションを有効にすると、元のオブジェクトから新しいオブジェクトにネイティブフィールドがコピーされます。 |
このアクションモジュールで、プロジェクト、タスク、イシューなどのオブジェクトを Workfront に作成し、カスタムフォームを新しいオブジェクトに追加できます。モジュールを使用すると、モジュールで使用可能なオブジェクトのフィールドを選択できます。
レコードの ID を指定します。
このモジュールは、レコードの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
例えば、クライアントが実行する必要のあるタスクの Google Sheets リストに新しい行を追加する際に、このモジュールを使用して Workfront でタスクを作成できます。
このモジュールを設定する際には、次のフィールドが表示されます。
入力フィールドの最小数を指定してください。例えば、イシューを作成する場合は、「プロジェクト 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 や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
例えば、完了させることが必要なタスクの Google Sheets リストにクライアントが新しい行を追加する場合、このモジュールを使用して Workfront でタスクを作成します。
このモジュールを設定する際には、次のフィールドが表示されます。
入力フィールドの最小数を指定してください。例えば、イシューを作成する場合は、「プロジェクト ID」フィールドに有効な親プロジェクト ID を指定して、Workfront でイシューの配置先を示す必要があります。マッピングパネルを使用してシナリオ内の別のモジュールからこの情報をマッピングするか、名前を入力してリストから選択し、手動で入力することもできます。
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 モジュールで達成できないデータフローの自動化を構築できます。
このモジュールは、次の情報を返します。
-
ステータスコード(数値):HTTP リクエストの成功または失敗を示します。これらはインターネット上で検索できる標準コードです。
-
ヘッダー(オブジェクト):出力本文に関連しない応答/ステータスコードのより詳細なコンテキスト。応答ヘッダーに表示されるすべてのヘッダーが応答ヘッダーではないので、不要なヘッダーも含まれている可能性があります。
応答ヘッダーは、モジュールの設定時に選択した HTTP リクエストによって異なります。
-
本文(オブジェクト):モジュールの設定時に選択した 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 layout-auto html-authored no-header | |
---|---|
Connection | Workfront アプリを Workfront Fusion に接続する方法について詳しくは、この記事にある Workfront を Workfront Fusion に接続を参照してください。 |
Force delete | このオプションを有効にすると、Workfront UI が削除の確認をリクエストした場合でも、確実にレコードは削除されます。 |
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 しか必要ないものもあれば、追加情報(オブジェクト ID やテンプレート ID など)を必要とするもの(Record Type のプロジェクトや Action の Attach Template など)もあります。 一部のアクションで使用できるオプションについては、この記事の その他のアクションオプションを参照してください。 個々のフィールドについて詳しくは、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のアップロードプロセスがスムーズになります。
ドキュメントの場所、アップロードするファイル、およびオプションで新しいファイル名を指定します。
このモジュールは、ドキュメントの 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 のオブジェクト内で検索します。
この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
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 に接続を参照してください。 |
Record Type | モジュールで検索する Workfront レコードのタイプを選択します。 |
Result Set | モジュールが検索条件に一致する最初の結果を取得するか、一致するすべての結果を取得するかを指定するオプションを選択します。 |
Maximal | 各シナリオの実行サイクル中に、モジュールが返すレコードの最大数を入力またはマッピングします。 |
Search criteria |
検索するフィールド、クエリで使用する演算子、およびそのフィールドで検索する値を入力します。 メモ:検索条件に メモ: |
Outputs | このモジュールの出力に含めるフィールドを選択します。 |
References | 検索に含める参照フィールドを選択します。 |
Collections | 検索に追加するコレクションを選択します。 |
このモジュールを使用できる Workfront オブジェクトタイプのリストは、各 Workfront モジュール🔗で使用可能な Workfront オブジェクトタイプを参照してください。
各 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 オブジェクトタイプがないため、この表には含まれていません。 |
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/イベントの監視モジュールのイベント登録フィルター
Workfrontイベントの監視モジュールは、Workfront API でイベント登録を作成する web フックに基づいてシナリオをトリガーします。イベント登録は、web フックに送信されるイベントを決定する一連のデータです。例えば、イシューを監視するイベントの監視モジュールを設定した場合、イベント登録はイシューに関連するイベントのみを送信します。
Fusion ユーザーは、イベント登録フィルターを使用して、ユースケースに適したイベント登録を作成できます。例えば、Workfront API でイベント登録を設定すると、特定のプロジェクトのイシューだけを web フックに送信して、イベントの監視モジュールがそのプロジェクトのイシューに対してのみトリガーされるようにすることができます。より範囲の狭いトリガーを作成できるので、無関係なトリガーの数が減り、シナリオの設計を改善できます。
これは、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
シナリオ内でのイベントのフィルタリング(非推奨) %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
イベント登録について詳しくは、FAQ - イベント登録を参照してください。
Web フックについて詳しくは、 Adobe Workfront Fusion のインスタントトリガー(web フック)を参照してください
シナリオでのフィルターについて詳しくは、 Adobe Workfront Fusion でのシナリオへのフィルターの追加を参照してください。