|
Workfront Planning にアクセスするには、次のものが必要です。
- 新しいWorkfront パッケージおよびライセンス。 Workfront Planning は、従来のWorkfront パッケージまたはライセンスでは使用できません。
- Workfront Planning パッケージ。
- 組織のWorkfront インスタンスは、Adobe Unified Experience にオンボーディングされる必要があります。
Adobe Workfront Planning API に関する情報
Adobe Workfront Planning コネクタでは、以下を使用します。
| table 0-row-2 1-row-2 layout-auto html-authored no-header |
|
| ベース URL |
https://{{connection.host}}/maestro/api/{{common.maestroApiVersion}}/ |
| API タグ |
v1.13.7 |
Adobe Workfront Planning への接続の作成 create-a-connection-to-adobe-workfront-planning
Workfront Fusion モジュール内から Workfront Planning アカウントへの直接接続を作成できます。
-
任意の Adobe Workfront Planning モジュールで、「接続」ボックスの横にある「追加」をクリックします。
-
次のフィールドに入力します。
| 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- です。
|
-
「続行」をクリックして接続を保存し、モジュールに戻ります。
Adobe Workfront Planning モジュールとそのフィールド
Workfront Fusion でWorkfront モジュールを設定する場合、以下に示すフィールドが表示されます。 これらに加えて、アプリまたはサービスのアクセスレベルなどの要因に応じて、追加のWorkfront フィールドが表示される場合があります。 モジュール内の太字のタイトルは、必須フィールドを示します。
フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、 モジュール間で情報をマッピングする を参照してください。
トリガー
イベントの監視
このトリガーモジュールは、Workfront Planning でレコード、レコードタイプまたはワークスペースが作成、更新または削除されたときにシナリオを開始します。
| 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 |
|
| Webhook |
使用する web フックを選択するか、「追加」をクリックして新しい web フックを作成します。 |
| Connection |
Adobe Workfront Planning への接続を作成する手順については、この記事のAdobe Workfront Planning への接続を作成を参照してください。 |
| Object type |
レコード、レコードタイプまたはワークスペースを監視するかどうかを選択します。 |
| State |
古い状態と新しい状態のどちらを監視するかを選択します。
|
| Workspace |
レコードをウォッチする場合は、レコードをウォッチするWorkspaceを選択します。 |
| Record type |
レコードをウォッチする場合は、ウォッチするレコードのタイプを選択します。 |
| Events filters |
選択した条件を満たすレコードのみを監視するフィルターを設定できます。
各フィルターに対して、フィルターを評価するフィールド、演算子、およびフィルターに許可する値を入力します。AND ルールを追加すると、複数のフィルターを使用できます。
メモ:既存のWorkfront Webhook ではフィルターを編集できません。 Workfront イベント購読用に異なるフィルターを設定するには、現在の Webhook を削除して、新しい Webhook を作成します。
イベントフィルターについて詳しくは、Workfront モジュール記事の Workfrontのイベント購読フィルター > Watch Events モジュールを参照してください。
|
| Objects to watch |
レコードの新規作成、更新、新規作成および更新、削除を監視するかどうかを選択します。 |
| Exclude updates made by this connection |
このオプションを有効にすると、このモジュールが使用する接続によって変更が行われた場合にシナリオがトリガーされなくなります。これにより、このシナリオがトリガーアクションを実行した場合に、シナリオの別のインスタンスがトリガーされるのを防ぎます。 |
アクション
レコードタイプの削除
このアクションモジュールは、Workfront Planning 内の 1 つのレコードタイプを ID で削除します。
| note warning |
| WARNING |
| Workfront Planning でレコード・タイプを削除すると、レコード・タイプ・テーブル内のすべてのレコードも削除されます。 |
| table 0-row-2 1-row-2 layout-auto html-authored no-header |
|
| Connection |
Adobe Workfront Planning への接続を作成する手順については、この記事のAdobe Workfront Planning への接続を作成を参照してください。 |
| Record type ID |
削除するレコードタイプの ID を入力またはマッピングします。 |
カスタム API 呼び出しの実行
このモジュールは、Adobe Workfront Planning API に対してカスタム API 呼び出しを実行します。
| 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 |
Adobe Workfront Planning への接続を作成する手順については、この記事のAdobe Workfront Planning への接続を作成を参照してください。 |
| URL |
相対パスを入力します https://(YOUR_WORKFRONT_DOMAIN)/maestro/api/ |
| Method |
API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。詳しくは、HTTP リクエストメソッドを参照してください。 |
| Headers |
リクエストのヘッダーを標準 JSON オブジェクトの形式で追加します。
例: {"Content-type":"application/json"}
Workfront Fusion は、認証ヘッダーを自動的に追加します。
|
| Query String |
クエリ文字列に追加するキーと値のペアごとに、「項目を追加」をクリックして、キーと値を入力します。 |
| Body |
標準の JSON オブジェクトの形式で、API 呼び出しの本文の内容を追加します。
メモ:
if などの条件ステートメントを JSON で使用する場合は、条件ステートメントの外側に引用符を挿入します。
|
検索
レコードの検索
このアクションモジュールは、指定した条件に基づいてレコードのリストを取得します。
| 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 |
Adobe Workfront Planning への接続を作成する手順については、この記事のAdobe Workfront Planning への接続を作成を参照してください。 |
| Workspace |
検索するレコードを含むWorkspaceを入力またはマッピングします。 |
| Record type |
検索するレコードタイプを選択します。 |
| Record Fields |
検索に使用する各フィールドについて、そのフィールドを見つけ、演算子を選択して、検索する値を入力またはマッピングします。 フィールドは、選択したレコードタイプに基づいて使用可能になります。 |
| フィルターの 条件 |
フィルターの条件の選択:
|
| Limit |
各シナリオの実行サイクル中に、モジュールが返すレコードの最大数を入力またはマッピングします。 |
未分類
レコードを作成
この操作を実行すると、Workfront Planning に 1 つのレコードが作成されます。
| table 0-row-2 1-row-2 2-row-2 3-row-0 layout-auto html-authored no-header |
|
| Connection |
Adobe Workfront Planning への接続を作成する手順については、この記事のAdobe Workfront Planning への接続を作成を参照してください。 |
| Record type ID |
作成するレコードのタイプを入力またはマッピングします。使用可能なレコードタイプは、Workfront Planning アカウントに基づいています。 |
| その他のフィールド |
新しいレコードに設定する値を入力します。 これらのフィールドは、選択したレコードタイプに基づきます。 |
|
|
レコードの削除
このアクションモジュールは、Workfront Planning で指定されたレコードを削除します。
| table 0-row-2 1-row-2 layout-auto html-authored no-header |
|
| Connection |
Adobe Workfront Planning への接続を作成する手順については、この記事のAdobe Workfront Planning への接続を作成を参照してください。 |
| Record ID |
削除するレコードの ID を入力またはマッピングします。 |
レコードを取得
このアクションモジュールは、Adobe Workfront Planning から、ID で指定された、1 つのレコードを取得します。
| table 0-row-2 1-row-2 layout-auto html-authored no-header |
|
| Connection |
Adobe Workfront Planning への接続を作成する手順については、この記事のAdobe Workfront Planning への接続を作成を参照してください。 |
| Record ID |
取得するレコードの ID を入力またはマッピングします。 |
レコードタイプ別にレコードの取得
このアクションモジュールは、指定されたタイプのすべてのレコードを取得します。
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header |
|
| Connection |
Adobe Workfront Planning への接続を作成する手順については、この記事のAdobe Workfront Planning への接続を作成を参照してください。 |
| Workspace |
取得するレコードを含むワークスペースを選択またはマッピングします。 |
| Record type |
取得するレコードのタイプを選択します。 |
レコードタイプの取得
このアクションモジュールは、Adobe Workfront Planning アカウント内のレコードタイプのリストを取得します。
| table 0-row-2 1-row-2 layout-auto html-authored no-header |
|
| Connection |
Adobe Workfront Planning への接続を作成する手順については、この記事のAdobe Workfront Planning への接続を作成を参照してください。 |
| Workspace |
取得するレコードタイプを含むワークスペースを選択またはマッピングします。 |
レコードの更新
Workfront Planning 内の 1 つのレコードを更新します。
| table 0-row-2 1-row-2 2-row-2 3-row-0 layout-auto html-authored no-header |
|
| Connection |
Adobe Workfront Planning への接続を作成する手順については、この記事のAdobe Workfront Planning への接続を作成を参照してください。 |
| Record ID |
更新するレコードのタイプを入力またはマッピングします。使用可能なレコードタイプは、Workfront Planning アカウントに基づいています。 |
| その他のフィールド |
レコードに追加する新しい値を入力します。 これらのフィールドは、選択したレコードタイプに基づきます。 |
|
|
読み取り可能な record-types の分類に JSONata を使用
次の JSONata 式は、レコードタイプの分類を示す、人間が判読できる Planning クエリの出力を作成します。 これにより、レコードタイプ名、フィールド名およびフィールドオプション名(該当する場合)が名前で人間によって読み取り、残りの構造はそのままの状態を維持します。
| code language-none |
(
$s0 := ({"data":$ ~> | fields | {"options":(options){name:$}} |});
$s1 := ({"data":$s0.data ~> | **.fields | {"options_name":(options.*){displayName:$}} | });
$s2 := $s1 ~> | data | {"fields":(fields){displayName:$}} |;
$s2.data{displayName:$}
)
|
JSONata モジュールの使用について詳しくは、JSONata モジュール を参照してください。
|