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 ライセンスは必要ありません。

または

レガシー:任意

製品

新規:

  • Prime Workfront パッケージを選択する:Adobe Workfront Fusion を購入する必要があります。
  • Ultimate Workfront パッケージ:Workfront Fusion が含まれています。

または

現在:Adobe Workfront Fusion を購入する必要があります。

このテーブルの情報について詳しくは、 ドキュメントのアクセス要件を参照してください。

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

note note
NOTE
  • 従来のライセンスパッケージ(コネクタに基づく)を使用する場合、サードパーティのアプリやサービスに接続するには、作業自動化および統合用のWorkfront Fusion ライセンスが必要です。 Workfront コネクタは、組織で使用可能なアクティブなアプリの数にはカウントされません。 すべてのシナリオは、Workfront アプリのみを使用する場合でも、組織の合計シナリオ数に対してカウントされます。

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 クライアントの秘密鍵を入力します。 これは、Workfront の設定エリアの OAuth2 アプリケーションエリアにあります。Workfrontで OAuth2 アプリケーションのクライアント秘密鍵がない場合は、別の秘密鍵を生成できます。 手順については、Workfrontのドキュメントを参照してください。
    Authentication URL

    これはデフォルト値のままにすることもできますし、Workfront インスタンスの URL に続けて /integrations/oauth2 を入力することもできます。

    例: https://mydomain.my.workfront.com/integrations/oauth2

    Host prefix ほとんどの場合、この値は origin にしてください。
  3. Continue」をクリックして接続を保存し、モジュールに戻ります。

    Workfrontにログインしていない場合は、ログイン画面が表示されます。 ログイン後、接続を許可できます。

NOTE
  • Workfront API への OAuth 2.0 接続は、API キーに依存しなくなりました。
  • Workfront サンドボックス環境への接続を作成するには、その環境で OAuth2 アプリケーションを作成し、接続でそのアプリケーションによって生成されたクライアント ID とクライアントシークレットを使用する必要があります。

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

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

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

マップ切り替え

NOTE
  • Workfront モジュールに最新のフィールドが表示されない場合は、キャッシュの問題が原因である可能性があります。1 時間待ってから、もう一度試してください。
  • Adobe Workfrontの HTTP 429 ステータスコードは、アクティベート解除の原因ではなく、代わりに、シナリオで短い実行の一時停止をトリガーにする必要があります。

トリガー

Watch Events

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

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

  1. Webhook ボックスの右側にある Add をクリックします。

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

Watch Field

このトリガーモジュールは、指定したフィールドが更新されるとシナリオを実行します。モジュールは、指定されたフィールドの古い値と新しい値の両方を返します。 この情報は、シナリオ内の後続のモジュールにマッピングできます。

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

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

Watch Record

このトリガーモジュールは、特定のタイプのオブジェクトが追加、更新、またはその両方が行われた場合にシナリオを実行します。このモジュールは、レコードに関連付けられたすべての標準フィールドと、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

出力のモジュールは、各レコードが新規か更新かを示します。

シナリオが前回実行されてから追加および更新されたレコードは、新しいレコードとして返されます。

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

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

アクション

Convert object

このアクションモジュールは、次のいずれかの変換を行います。

  • イシューをプロジェクトに変換
  • イシューをタスクに変換
  • タスクをプロジェクトに変換
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 このオプションを有効にすると、元のオブジェクトから新しいオブジェクトにネイティブフィールドがコピーされます。
Create a record (attaching 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
  • オブジェクトの ID を入力する際に、オブジェクトの名前を入力し、リストから選択できます。そうすると、モジュールが適切な ID をフィールドに入力します。
  • カスタムフィールドまたは Note オブジェクト(コメントまたは返信)のテキストを入力する際に、Note Text フィールドにHTMLタグを使用して、太字や斜体などのリッチテキストを作成できます。
Create Record

このアクションモジュールは、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
  • オブジェクトの ID を入力する際に、オブジェクトの名前を入力し、リストから選択できます。そうすると、モジュールが適切な ID をフィールドに入力します。
  • カスタムフィールドまたは Note オブジェクト(コメントまたは返信)のテキストを入力する際に、Note Text フィールドにHTMLタグを使用して、太字や斜体などのリッチテキストを作成できます。
Custom API Call

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

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

Delete Record

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

このアクションモジュールは、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 オブジェクトタイプを参照してください。

Misc Action

このアクションモジュールを使用すると、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 呼び出しに関する有用な情報がまだ含まれています。

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

その他のアクションオプション

タスク
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored
アクション オプション
コピー
  • clearApprovers

  • clearAssignments

  • clearConstraints

  • clearCustomData

  • clearDocuments

  • clearExpenses

  • clearFinancials

    財務データを消去します

  • clearPermission

  • clearPredecessors

  • clearProgress

  • clearTimedNotifications

    リマインダ通知をクリアします

移動
  • clearApprovers

  • clearAssignments

  • clearDocuments

  • clearConstraints

  • clearExpenses

  • clearFinancials

    財務データを消去します

  • clearPermission

  • clearPredecessors

  • clearProgress

  • clearTimedNotifications

    リマインダ通知をクリアします

イシュー
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored
アクション オプション
コピー
  • clearApprovers
  • clearAssignments
  • clearCustomData
  • clearDocuments
  • clearPermission
  • clearProgress
タスクに変換
  • preserveIssue

    元の問題を保持し、その解決策をこのタスクに関連付ける

  • preservePrimaryContact

    問題のプライマリ連絡先にこのタスクへのアクセスを許可する

  • preserveCompletionDate

    問題の予定完了日を変更しない

プロジェクトに変換
  • preserveIssue

    元の問題を保持し、その解決策をこのタスクに関連付ける

  • preservePrimaryContact

    問題のプライマリ連絡先にこのタスクへのアクセスを許可する

プロジェクト
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored
アクション オプション
コピー
  • clearApprovers

  • clearAssignments

  • clearCustomData

  • clearDocuments

  • clearExpenses

  • clearFinancials

    財務データを消去します

  • clearPermission

  • clearPredecessors

  • clearProgress

  • clearTimedNotifications

    リマインダ通知をクリアします

テンプレートを添付/テンプレートとして保存
  • clearApprovers

  • clearAssignments

  • clearBillingRates

  • clearConstraints

  • clearDeliverables

    目標をクリア

  • clearDocuments

  • clearExpenses

  • clearFinancials

    財務データを消去します

  • clearHourTypes

  • clearIssueSetup

    キューのプロパティと問題の設定をクリアします

  • clearPredecessors

  • clearRisks

  • clearSharingOptions

  • clearTimedNotifications

    リマインダ通知をクリアします

Read a Record

このアクションモジュールは、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 オブジェクトタイプを参照してください。

Update Record

このアクションモジュールは、プロジェクト、タスク、イシューなどのオブジェクトを更新します。モジュールを使用すると、モジュールで使用可能なオブジェクトのフィールドを選択できます。

レコードの 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 をフィールドに入力します。
  • カスタムフィールドまたは Note オブジェクト(コメントまたは返信)のテキストを入力する際に、Note Text フィールドにHTMLタグを使用して、太字や斜体などのリッチテキストを作成できます。
Upload Document

このアクションモジュールは、プロジェクト、タスク、イシューなどの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 オブジェクトタイプを参照してください。

Upload Document (Legacy)

このアクションモジュールは、プロジェクト、タスク、イシューなどの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 オブジェクトタイプを参照してください。

検索

Read Related Records

この検索モジュールは、特定の親オブジェクト内で、指定した検索クエリに一致するレコードを読み取ります。

出力に含めるフィールドを指定します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

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

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 このモジュールの出力バンドルに含める情報を選択します。
Search

この検索モジュールは、指定した検索クエリに一致する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 モジュールで使用できる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 オブジェクトタイプは設定に含まれていないので、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
承認プロセス
割り当て
ベースライン
請求記録
請求レート
会社
ドキュメント
ドキュメントフォルダー
ドキュメントのバージョン
為替レート
費用
費用タイプ
外部ドキュメント
グループ
時間
時間タイプ
イシュー
イテレーション
担当業務
ジャーナルエントリ
マイルストーン
マイルストーンパス
メモ
メモタグ
ポートフォリオ
プログラム
プロジェクト
プロジェクトユーザー
予約済み時間*
リスク
リスクタイプ
ステップ承認者
タスク
チーム
テンプレート
テンプレートタスク
タイムシート
ユーザー
アップデート
各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/Watch Events モジュールでのイベント購読フィルター

NOTE
Watch Events モジュールでは、イベント購読フィルターを使用することを強くお勧めします。

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

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

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

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

  • が次と等しい

  • 等しくない

  • より大きい

  • より小さい

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

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

  • が次を含む

  • 存在する

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

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

    • この演算子には値は必要ありません。また、値フィールドは存在しません。
    • この演算子では、「状態」フィールドを無視します。
    • Changed を使用する際は、「レコード元」フィールドで「更新されたイベントのみ」を選択します。
IMPORTANT
既存のWorkfront Webhook ではフィルターを編集できません。 Workfront イベント購読用に異なるフィルターを設定するには、現在の Webhook を削除して、新しい Webhook を作成します。
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 に割り当てられたイシューのみを処理するには、Watch Events モジュールの後にフィルターを作成します。
イベントフィルターなし
1 日に 100 件のイシューが作成され、そのうち 2 件のみが Ana に割り当てられている場合、シナリオは 100 回実行されます。98 回の実行はフィルターで停止しますが、トリガーモジュールは引き続きデータを消費し、すべての実行で操作が実行されます。

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

Webhook について詳しくは、「Adobe Workfront Fusion の インスタントトリガー(Webhook)」を参照してください

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

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3