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 を購入する必要があります。 |
この表の情報について詳しくは、ドキュメントのアクセス要件を参照してください。
s##前提条件
Workfront Planning にアクセスするには、次のものが必要です。
- 新しいWorkfront パッケージおよびライセンス。 Workfront Planning は、従来のWorkfront パッケージまたはライセンスでは使用できません。
- Workfront Planning パッケージ。
- 組織のWorkfront インスタンスは、Adobe Unified Experience にオンボーディングされる必要があります。
Adobe Workfront Planning 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 Planning モジュールで、「接続」フィールドの横にある 追加 をクリックします。
-
次のフィールドに入力します。
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 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 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 Planning に 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 モジュール を参照してください。