Adobe Workfront Planning モジュール

Adobe Workfront Planning モジュールを使用すると、Workfront Planning でイベントが発生した場合にシナリオをトリガー設定できます。 レコードを作成、読み取り、更新、削除したり、Adobe Workfront Planning アカウントへのカスタム API の呼び出しを実行したりできます。

アクセス要件

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

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

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

または

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

製品

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

または

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

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

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

Adobe Workfront Planning API に関する情報

Adobe Workfront Planning コネクタでは、以下を使用します。

ベース URL
https://{{connection.host}}/maestro/api/{{common.maestroApiVersion}}/
API タグ
v1.13.7

Adobe Workfront Planning への接続の作成

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

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

  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 実稼動環境と非実稼動環境のどちらに接続するかを選択します。
    Type サービスアカウントに接続するか、個人アカウントに接続するかを選択します。

    Client ID

    (オプション)

    Adobe Client ID を入力します。これは、Adobe Developer Console の Credentials details セクションで確認できます。

    Client Secret

    (オプション)

    Adobe Client Secret を入力します。これは、Adobe Developer Console の Credentials details セクションで確認できます。

    Authentication URL

    (オプション)

    Workfrontのインスタンスで、この接続の認証に使用する URL を入力します。

    デフォルト値は https://oauth.my.workfront.com/integrations/oauth2 です。

    Host prefix

    ホストのプレフィックスを入力します。

    デフォルト値は origin- です。

  3. 続行」をクリックして接続を保存し、モジュールに戻ります。

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

トリガー

イベントの監視

このトリガーモジュールは、Workfront Planning でレコード、レコードタイプまたはワークスペースが作成、更新または削除されたときにシナリオを開始します。

Webhook
使用する web フックを選択するか、「追加」をクリックして新しい web フックを作成します。
Connection
Adobe Workfront Planning への接続を作成する手順については、この記事のAdobe Workfront Planning への接続を作成を参照してください。
Object type
レコード、レコードタイプまたはワークスペースを監視するかどうかを選択します。
Events filters

選択した条件を満たすレコードのみを監視するフィルターを設定できます。

各フィルターに対して、フィルターを評価するフィールド、演算子、およびフィルターに許可する値を入力します。AND ルールを追加すると、複数のフィルターを使用できます。

メモ:既存の Workfront web フックのフィルターは編集できません。Workfront イベントのサブスクリプションに別のフィルターを設定するには、現在の web フックを削除し、新しい web フックを作成します。

イベントフィルターについて詳しくは、Workfront モジュール記事の Workfront > Watch Events モジュールのイベント購読フィルターを参照してください。

Objects to watch
レコードの新規作成、更新、新規作成および更新、削除を監視するかどうかを選択します。
Exclude updates made by this connection
このオプションを有効にすると、このモジュールが使用する接続によって変更が行われた場合にシナリオがトリガーされなくなります。これにより、このシナリオがトリガーアクションを実行した場合に、シナリオの別のインスタンスがトリガーされるのを防ぎます。

アクション

レコードタイプの削除

このアクションモジュールは、Workfront Planning 内の 1 つのレコードタイプを ID で削除します。

WARNING
Workfront Planning でレコード・タイプを削除すると、レコード・タイプ・テーブル内のすべてのレコードも削除されます。
Connection
Adobe Workfront Planning への接続を作成する手順については、この記事のAdobe Workfront Planning への接続を作成を参照してください。
Record type ID
削除するフィールドの ID を入力またはマッピングします。

カスタム API 呼び出しの実行

このモジュールは、Adobe Workfront Planning API に対してカスタム API 呼び出しを実行します。

Connection
Adobe Workfront Planning への接続を作成する手順については、この記事のAdobe Workfront Planning への接続を作成を参照してください。
URL
相対パスを入力します https://(YOUR_WORKFRONT_DOMAIN)/maestro/api/
Method
API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。詳しくは、Adobe Workfront Fusionでの HTTP リクエストメソッドを参照してください。
Headers

リクエストのヘッダーを標準 JSON オブジェクトの形式で追加します。

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

Workfront Fusion 認証ヘッダーを自動的に追加します。

Query String
クエリ文字列に追加するキーと値のペアごとに、「項目を追加」をクリックして、キーと値を入力します。
Body

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

メモ:

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

未分類

レコードを作成

この操作を実行すると、Workfront Planning に 1 つのレコードが作成されます。

Connection
Adobe Workfront Planning への接続を作成する手順については、この記事のAdobe Workfront Planning への接続を作成を参照してください。
Record type ID
作成するレコードのタイプを入力またはマッピングします。使用可能なレコードタイプは、Workfront Planning アカウントに基づいています。
その他のフィールド
これらのフィールドは、選択したレコードタイプに基づきます。

レコードの削除

このアクションモジュールは、Workfront Planning で指定されたレコードを削除します。

Connection
Adobe Workfront Planning への接続を作成する手順については、この記事のAdobe Workfront Planning への接続を作成を参照してください。
Record ID
削除するレコードの ID を入力またはマッピングします。

レコードを取得

このアクションモジュールは、Adobe Workfront Planning から、ID で指定された、1 つのレコードを取得します。

Connection
Adobe Workfront Planning への接続を作成する手順については、この記事のAdobe Workfront Planning への接続を作成を参照してください。
Record ID
取得するレコードの ID を入力またはマッピングします。

レコードタイプ別にレコードの取得

このアクションモジュールは、指定されたタイプのすべてのレコードを取得します。

Connection
Adobe Workfront Planning への接続を作成する手順については、この記事のAdobe Workfront Planning への接続を作成を参照してください。
Workspace
取得するレコードを含むワークスペースを選択またはマッピングします。
Record type
取得するレコードのタイプを選択します。
Maximum number of returned records
各シナリオの実行サイクル中に、モジュールが返すレコードの最大数を入力またはマッピングします。

レコードタイプの取得

このアクションモジュールは、Adobe Workfront Planning アカウント内のレコードタイプのリストを取得します。

Connection
Adobe Workfront Planning への接続を作成する手順については、この記事のAdobe Workfront Planning への接続を作成を参照してください。

レコードの更新

Workfront Planning 内の 1 つのレコードを更新します。

Connection
Adobe Workfront Planning への接続を作成する手順については、この記事のAdobe Workfront Planning への接続を作成を参照してください。
Record ID
更新するレコードのタイプを入力またはマッピングします。使用可能なレコードタイプは、Workfront Planning アカウントに基づいています。
その他のフィールド
これらのフィールドは、選択したレコードタイプに基づきます。
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43