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 のモジュールを参照してください。

アクセス要件

この記事で説明している機能を使用するには、次のアクセス権が必要です。

Adobe Workfront プラン*
Pro 以降
Adobe Workfront ライセンス*
Plan、Work
Adobe Workfront Fusion ライセンス**

現在のライセンス要件:Workfront Fusion ライセンス要件なし。

または

従来のライセンス要件:Workfront Fusion for Work Automation and Integration、Workfront Fusion for Work Automation

製品

現在の製品要件:Select または Prime Adobe Workfront プランをご利用の場合、この記事で説明されている機能を使用するには、組織は Adobe Workfront に加えて Adobe Workfront Fusion も購入する必要があります。Workfront Fusion は、Workfront Ultimate プランに含まれています。

または

従来の製品要件:この記事で説明している機能を使用するには、Adobe Workfront Fusion と Adobe Workfrontを組織で購入する必要があります。

ご利用のプラン、ライセンスタイプまたはアクセス権を確認するには、Workfront 管理者にお問い合わせください。

Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。

Workfront を Workfront Fusion に接続

Workfront コネクタは、OAuth 2.0 を使用して Workfront に継続します。

Workfront アカウントへの接続を、Workfront Fusion モジュール内から直接作成できます。

  1. 任意の Adobe Workfront モジュールで、「接続」フィールドの横にある「追加」をクリックします。

  2. 次のフィールドに入力します。

    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 にしてください。
  3. 続行」をクリックして接続を保存し、モジュールに戻ります。

NOTE
  • SAML ログインボタンが表示されない場合、組織ではシングルサインオン(SSO)が有効になっていません。ユーザー名とパスワードを使用してログインできます。

    SSO について詳しくは、シングルサインオンの概要 Adobe Workfrontを参照してください。

  • Workfront API への OAuth 2.0 接続は API キーに依存しなくなりました。

Workfront モジュールとそのフィールド

Workfront モジュールを設定する際、Workfront Fusion に以下のフィールドが表示されます。これらに加えて、アプリまたはサービスのアクセスレベルなどの要因に応じて、追加の Workfront フィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。

フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、 Adobe Workfront Fusion でモジュールから別のモジュールに情報をマッピングを参照してください。

NOTE
Workfront モジュールに最新のフィールドが表示されない場合は、キャッシュの問題が原因である可能性があります。1 時間待ってから、もう一度試してください。

トリガー

イベントを監視

このトリガーモジュールは、Workfront で特定のタイプのオブジェクトが追加、更新、または削除された場合に、シナリオをリアルタイムで実行します。

このモジュールは、レコードに関連付けられた標準フィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

  1. Web フック」ボックスの右側にある「追加」をクリックします。

  2. 表示される「フックを追加」ボックスで 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 OnlyUpdated Records OnlyNew 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 OnlyUpdated Records OnlyNew and Updated Records をシナリオで監視するかどうかを選択します。
Record Type

フィルター を選択後に表示されます)モジュールで監視する Workfront レコードのタイプを選択します。

例えば、新しいプロジェクトが作成されるたびにシナリオを開始するには、「Project」を選択します。

Outputs このモジュールの出力バンドルに含める情報を選択します。
Optional Filter (詳細)API コード文字列を入力して、条件を絞り込む追加のパラメーターまたはコードを定義します。
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 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
  • オブジェクトの ID を入力する際に、オブジェクトの名前を入力し、リストから選択できます。そうすると、モジュールが適切な ID をフィールドに入力します。

  • カスタムフィールドまたはメモオブジェクト(コメントまたは返信)にテキストを入力する際、「メモテキスト」フィールドで HTML タグを使用して、太字や斜体などのリッチテキストを作成できます。

    更新のリッチテキストについて詳しくは、作業の更新作業項目に更新を追加を参照してください。

レコードを作成

このアクションモジュールは、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
  • オブジェクトの ID を入力する際に、オブジェクトの名前を入力し、リストから選択できます。そうすると、モジュールが適切な ID をフィールドに入力します。

  • カスタムフィールドまたはメモオブジェクト(コメントまたは返信)にテキストを入力する際、「メモテキスト」フィールドで HTML タグを使用して、太字や斜体などのリッチテキストを作成できます。

    更新のリッチテキストについて詳しくは、作業を更新作業項目に更新を追加を参照してください。

カスタム API 呼び出し

このアクションモジュールは、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 オブジェクトの形式で追加します。これにより、リクエストのコンテンツタイプが決まります。

例: {"Content-type":"application/json"}

メモ:エラーが表示され、エラーの発生元を特定するのが困難な場合は、Workfront ドキュメントを基に、ヘッダーを変更することを考慮してください。カスタム API 呼び出しで 422 HTTP リクエストエラーが返される場合は、"Content-Type":"text/plain" ヘッダーを使用してみてください。

Query String

API 呼び出しのクエリを標準 JSON オブジェクトの形式で追加します。

例: {"name":"something-urgent"}

ヒント:情報は、クエリパラメーターではなく、JSON 本文を使用して送信することをお勧めします。

Body

標準の JSON オブジェクトの形式で、API 呼び出しの本文の内容を追加します。

メモ:

if などの条件文を JSON で使用する場合は、条件文を引用符で囲みます。

このモジュールを使用できる 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
操作が同期されずにレコードが削除されない可能性を回避するために、次のシナリオ設定をお勧めします。
  1. レコードを同期的に削除します。
  2. レコード削除モジュールにエラー処理を追加し、40 秒のタイムアウトによるエラーを無視します。
ドキュメントのダウンロード

このアクションモジュールは、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 に対してアクションを実行できます。

このモジュールを設定する際には、次のフィールドが表示されます。

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 呼び出しに関する有用な情報がまだ含まれています。

  1. Workfront 開発者ドキュメントページの左側のナビゲーションからレコードタイプを選択します。以下のタイプには、独自のページがあります。

    • Projects

    • Tasks

    • Issues

    • Users

    • Documents

    その他のすべてのレコードタイプに対して、Other objects and endpoints を選択し、アルファベット順に並べ替えられたページでレコードタイプを探します。

  2. 適切なレコードタイプのページで、アクションを検索(Ctrl + F キーまたは Command + F キー)します。

  3. 選択したアクションで使用可能なフィールドの説明を表示します。

メモ:

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 オブジェクトタイプを参照してください。

レコードを読み取り

このアクションモジュールは、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
  • オブジェクトの ID を入力する際に、オブジェクトの名前を入力し、リストから選択できます。そうすると、モジュールが適切な ID をフィールドに入力します。

  • カスタムフィールドまたはメモオブジェクト(コメントまたは返信)にテキストを入力する際、「メモテキスト」フィールドで HTML タグを使用して、太字や斜体などのリッチテキストを作成できます。

    更新のリッチテキストについて詳しくは、作業の更新作業アイテムへの更新の追加を参照してください。

ドキュメントをアップロード

このアクションモジュールは、プロジェクト、タスク、イシューなどの Workfront オブジェクトにドキュメントをアップロードします。

ドキュメントの場所、アップロードするファイル、およびオプションで新しいファイル名を指定します。

このモジュールは、ドキュメントの 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 に接続を参照してください。
Related Record ID ドキュメントをアップロードするレコードの一意の Workfront ID を入力します。
Related Record Type モジュールでドキュメントをアップロードする Workfront レコードのタイプを選択します。
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

検索するフィールド、クエリで使用する演算子、およびそのフィールドで検索する値を入力します。

メモ:検索条件に username を使用しないでください。Workfront への API クエリに username を含めると、そのユーザーが Workfront に記録され、検索は成功しません。

メモ:InNotIn は配列で動作します。入力は配列形式である必要があります。

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

検索するフィールド、クエリで使用する演算子、およびそのフィールドで検索する値を入力します。

メモ:検索条件に username を使用しないでください。Workfront への API クエリに username を含めると、そのユーザーが Workfront に記録され、検索は成功しません。

メモ:InNotIn は配列で動作します。入力は配列形式である必要があります。

Outputs このモジュールの出力に含めるフィールドを選択します。
References 検索に含める参照フィールドを選択します。
Collections 検索に追加するコレクションを選択します。

このモジュールを使用できる Workfront オブジェクトタイプのリストは、各 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
承認プロセス
割り当て
ベースライン
請求記録
請求レート
会社
ダッシュボード
ドキュメント
ドキュメントフォルダー
ドキュメントリクエスト
ドキュメントのバージョン
費用
費用タイプ
グループ
時間
時間タイプ
イシュー
イテレーション
担当業務
ジャーナルエントリ
マイルストーン
マイルストーンパス
メモ
メモタグ
ポートフォリオ
プログラム
プロジェクト
プロジェクトユーザー
プルーフの承認
予約済み時間*
レポート
リスク
リスクタイプ
ステップ承認者
タスク
チーム
テンプレート
テンプレートタスク
タイムシート
ユーザー
アップデート
各 Workfront アクションモジュールで使用可能なオブジェクトタイプ
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
承認プロセス
割り当て
ベースライン
請求記録
請求レート
会社
ドキュメント
ドキュメントフォルダー
ドキュメントのバージョン
為替レート
費用
費用タイプ
外部ドキュメント
グループ
時間
時間タイプ
イシュー
イテレーション
担当業務
ジャーナルエントリ
マイルストーン
マイルストーンパス
メモ
メモタグ
ポートフォリオ
プログラム
プロジェクト
プロジェクトユーザー
予約済み時間*
リスク
リスクタイプ
ステップ承認者
タスク
チーム
テンプレート
テンプレートタスク
タイムシート
ユーザー
アップデート
各 Workfront 検索モジュールで使用可能なオブジェクトタイプ
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/イベントの監視モジュールのイベント登録フィルター

NOTE
イベントの監視モジュールでは、イベント登録フィルターを使用することを強くお勧めします。

Workfrontイベントの監視モジュールは、Workfront API でイベント登録を作成する web フックに基づいてシナリオをトリガーします。イベント登録は、web フックに送信されるイベントを決定する一連のデータです。例えば、イシューを監視するイベントの監視モジュールを設定した場合、イベント登録はイシューに関連するイベントのみを送信します。

Fusion ユーザーは、イベント登録フィルターを使用して、ユースケースに適したイベント登録を作成できます。例えば、Workfront API でイベント登録を設定すると、特定のプロジェクトのイシューだけを web フックに送信して、イベントの監視モジュールがそのプロジェクトのイシューに対してのみトリガーされるようにすることができます。より範囲の狭いトリガーを作成できるので、無関係なトリガーの数が減り、シナリオの設計を改善できます。

これは、Workfront Fusion シナリオでのフィルターの設定とは異なります。イベント登録フィルターを使用しない場合、web フックは、選択されたオブジェクトタイプに関連するすべてのイベントを受信します。これらのイベントのほとんどはシナリオとは無関係と思われるので、シナリオを続行する前に除外する必要があります。

Workfront/イベントの監視フィルターで使用できる演算子は、次のとおりです。

  • が次と等しい

  • 等しくない

  • より大きい

  • より小さい

  • が次よりも大きいか等しい

  • が次よりも小さいか等しい

  • が次を含む

  • 存在する

    • この演算子には値は必要ありません。また、値フィールドは存在しません。
  • が存在しません

    • この演算子には値は必要ありません。また、値フィールドは存在しません。
  • 変更済み

    • この演算子には値は必要ありません。また、値フィールドは存在しません。
    • この演算子では、「状態」フィールドを無視します。
    • Changed を使用する際は、「レコード元」フィールドで「更新されたイベントのみ」を選択します。
IMPORTANT
既存の Workfront web フックのフィルターは編集できません。Workfront イベント登録に異なるフィルターを設定するには、現在の web フックを削除し、新しく作成します。
INFO
例: 特定のユーザー Ana に割り当てられた新規イシューを処理するシナリオについて考えます。

イベント登録フィルターを使用したイベントのフィルタリング(推奨) %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

イベントフィルターを使用すると、イシューが Ana に割り当てられている場合のシナリオをイシューの作成時にトリガーする web フックを設定できます。Ana の ユーザー IDは、b378489d8f7cd3cee0539260720a84b7 です。
1 日に 100 件のイシューが作成され、そのうち 2 件のみが Ana に割り当てられている場合、シナリオは 2 回実行されます。

シナリオ内でのイベントのフィルタリング(非推奨) %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

Ana に割り当てられたイシューのみを処理するようにイベントをフィルタリングするには、イベントを監視モジュールの後にフィルターを作成できます。
1 日に 100 件のイシューが作成され、そのうち 2 件のみが Ana に割り当てられている場合、シナリオは 100 回実行されます。98 回の実行はフィルターで停止しますが、トリガーモジュールは引き続きデータを消費し、すべての実行で操作が実行されます。

イベント登録について詳しくは、FAQ - イベント登録を参照してください。

Web フックについて詳しくは、 Adobe Workfront Fusion のインスタントトリガー(web フック)を参照してください

シナリオでのフィルターについて詳しくは、 Adobe Workfront Fusion でのシナリオへのフィルターの追加を参照してください。

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43