Adobe Workfront Planning モジュール
Adobe Workfront Planning モジュールを使用すると、Workfront Planningでイベントが発生したときにシナリオをトリガーできます。 レコードを作成、読み取り、更新、削除したり、Adobe Workfront Planning アカウントへのカスタム API の呼び出しを実行したりできます。
アクセス要件
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront パッケージ |
任意の Adobe Workfront Workflow パッケージと任意の Adobe Workfront Automation および Integration パッケージ Workfront Ultimate Workfront Fusion を追加購入した Workfront Prime および Select パッケージ。 |
| Adobe Workfront ライセンス |
標準 Work またはそれ以上 |
| 製品 | 組織が Workfront Automation および Integration を含まない Select またはPrime Workfront パッケージを持っている場合は、Adobe Workfront Fusion を購入する必要があります。 |
この表の情報について詳しくは、ドキュメントのアクセス要件を参照してください。
前提条件
Workfront Planningにアクセスするには、次の情報が必要です。
- 新しいWorkfront パッケージとライセンス。 Workfront Planningは、従来のWorkfront パッケージまたはライセンスでは使用できません。
- Workfront計画パッケージ。
- 組織のWorkfront インスタンスをAdobe Unified Experienceにオンボーディングする必要があります。
Adobe Workfront計画APIの情報
Adobe Workfront Planning コネクタでは、次の機能が使用されます。
Workfront PlanningとWorkfront Fusionの連携
Workfront Planning コネクタは、OAuth 2.0を使用してWorkfront Planningに接続します。
Workfront Planning Fusion モジュール内から直接Workfront Planning アカウントへの接続を作成できます。
クライアント IDとクライアントシークレットを使用してWorkfront Planningに接続する
-
任意のAdobe 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 type Adobe Workfront auth connection を選択します。 Connection name 新しい接続の名前を入力します。 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/oauth2Host prefix ほとんどの場合、この値は originにしてください。 -
「続行」をクリックして接続を保存し、モジュールに戻ります。
Workfront Planningにログインしていない場合は、ログイン画面が表示されます。 ログイン後、接続を許可できます。
- Workfront API への OAuth 2.0 接続は API キーに依存しなくなりました。
- Workfront サンドボックス環境への接続を作成するには、その環境で OAuth2 アプリケーションを作成し、接続でそのアプリケーションによって生成されたクライアント ID とクライアントシークレットを使用する必要があります。
サーバー間接続を使用したWorkfront Planningへの接続
-
任意のAdobe 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 type 「Adobe Workfront サーバー間接続」を選択します。 Connection name 新しい接続の名前を入力します。 Instance name インスタンス（ドメインとも呼ばれます）の名前を入力します。
例：URL が
https://example.my.workfront.comの場合は、exampleと入力します。Instance lane この接続の接続先となる環境タイプを入力します。
例：URL が
https://example.my.workfront.comの場合は、myと入力します。Client ID Workfront クライアント ID を入力します。これは、Workfront の設定エリアの OAuth2 アプリケーションエリアにあります。接続している特定のアプリケーションを開いて、クライアント ID を確認します。 Client Secret Workfront クライアントシークレットを入力します。これは、Workfront の設定エリアの OAuth2 アプリケーションエリアにあります。Workfront で OAuth2 アプリケーションのクライアントシークレットがない場合は、別のシークレットを生成できます。手順について詳しくは、Workfront ドキュメントを参照してください。 Scopes この接続に適用可能なスコープを入力します。 Host prefix ほとんどの場合、この値は originにしてください。 -
「続行」をクリックして接続を保存し、モジュールに戻ります。
Workfront Planningにログインしていない場合は、ログイン画面が表示されます。 ログイン後、接続を許可できます。
- Workfront API への OAuth 2.0 接続は API キーに依存しなくなりました。
- Workfront サンドボックス環境への接続を作成するには、その環境で OAuth2 アプリケーションを作成し、接続でそのアプリケーションによって生成されたクライアント ID とクライアントシークレットを使用する必要があります。
Adobe Workfront Planning モジュールとそのフィールド
Workfront モジュールを設定すると、Workfront Fusion には以下のフィールドが表示されます。これらと共に、アプリやサービスのアクセスレベルなどの要因に応じて、追加の Workfront フィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。
フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、モジュール間での情報のマッピングを参照してください。
トリガー
イベントの監視
このトリガーモジュールは、レコード、レコードタイプ、またはワークスペースがWorkfront Planningで作成、更新、または削除されたときにシナリオを開始します。
アクション
レコードタイプの削除
このアクションモジュールは、Workfront Planningの1つのレコードタイプをIDで削除します。
カスタム API 呼び出しの実行
このモジュールは、Adobe Workfront Planning API に対してカスタム API 呼び出しを実行します。
https://(YOUR_WORKFRONT_DOMAIN)/maestro/api/リクエストのヘッダーを標準 JSON オブジェクトの形式で追加します。
例： {"Content-type":"application/json"}
Workfront Fusion は認証ヘッダーを自動的に追加します。
標準の JSON オブジェクトの形式で、API 呼び出しの本文の内容を追加します。
メモ：
if などの条件文を JSON で使用する場合は、条件文を引用符で囲みます。
検索
レコードの検索
このアクションモジュールは、指定した条件に基づいてレコードのリストを取得します。
未分類
レコードの作成
このアクションは、Workfront計画で1つのレコードを作成します。
レコードの削除
このアクションモジュールは、Workfront Planningで指定されたレコードを削除します。
レコードを取得
このアクションモジュールは、Adobe Workfront Planning から、ID で指定された、1 つのレコードを取得します。
レコードタイプ別にレコードの取得
このアクションモジュールは、指定されたタイプのすべてのレコードを取得します。
レコードタイプの取得
このアクションモジュールは、Adobe Workfront Planning アカウント内のレコードタイプのリストを取得します。
レコードの更新
このアクションは、Workfront Planningの1つのレコードを更新します。
読み取り可能なrecord-typesの分類にJSONataを使用
次のJSONata式は、レコードタイプの内訳を示す、人間が読み取り可能なPlanning クエリの出力を作成します。 これにより、レコードタイプ名、フィールド名、およびフィールドオプション名（該当する場合）が名前で読みやすくなり、構造の残りの部分はそのまま維持されます。
(
$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 モジュール を参照してください。