Adobe Workfront Boardsのモジュール
Adobe Workfront ボードは、列やカードを含む共有ボードへのアクセスを提供することで、チームの共同作業を可能にする柔軟なツールです。
Adobe Workfront Boards モジュールを使用すると、レコードの読み取りまたは更新、Workfront Boards APIへの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 を購入する必要があります。 |
この表の情報について詳しくは、ドキュメントのアクセス要件を参照してください。
前提条件
Adobe Workfrontで掲示板を設定してから、掲示板に接続する必要があります。
Adobe Workfront Boards APIの情報
Adobe Workfront Boards コネクタでは、次の機能が使用されます。
Workfront ボードへの接続の作成
Workfront ボード接続を作成するには：
-
任意の Adobe Workfront Boards モジュールで、「接続」ボックスの横にある「追加」をクリックします。
-
次のフィールドに入力します。
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 ボードのモジュールとそのフィールド
Workfront Boards モジュールを設定すると、Workfront Fusionに以下のフィールドが表示されます。 また、アプリやサービスのアクセスレベルなどの要因に応じて、Workfront ボードのフィールドが表示される場合があります。 モジュール内の太字のタイトルは、必須フィールドを示します。
フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。 詳しくは、モジュール間での情報のマッピングを参照してください。
カード
チェックリスト項目を追加
このアクションモジュールは、指定したカードにチェックリスト項目を追加します。
サブタスクを追加
このアクションモジュールは、ボードのカードにサブタスクを追加します。 カードは接続されたカードである必要があります。 サブタスクは、カードが表すWorkfront タスクにも追加されます。
カードの作成
このアクションモジュールは、Workfront ボード上に新しいカードを作成します。
カードを移動
このアクションモジュールは、カードを同じボード上の別の列に移動します。
カードを読む
このアクションモジュールは、特定のカードに関する情報を取得します。
カードの更新
このアクションモジュールは、指定したカードの情報を更新します。
ボード
ボードの作成
このアクションモジュールは、Workfrontでボードを作成します。 作成するボードのタイプを指定できます。
ボードを読む
このアクションモジュールは、ボードのカード、列、タグ、メンバーなど、1つのボードに関する情報を返します。
列
列の作成
このアクションモジュールは、指定したボードに新しい列を作成します。
列の検索
この検索モジュールは、指定した名前の列に関する情報を返します。
列の更新
このアクション モジュールは、指定された列の名前またはWIP制限を更新します。
タグ
カードにタグを追加
このアクションモジュールは、カードにタグを追加します。
タグの作成
このアクションモジュールは、新しいタグを作成し、色を割り当てます。
コメント
コメントを作成
このアクションモジュールは、指定したカードにコメントを作成しました。
カードのコメントを読む
このアクションモジュールは、指定したカードからコメントを取得します。
その他
カスタム API 呼び出しの実行
このアクションモジュールは、Workfront Boards APIをカスタム呼び出します。
既存のWorkfront接続を使用してWorkfront ボードに接続したり、特定のWorkfront ボード接続を使用したりできます。
Workfront アプリをWorkfront Fusionに接続する方法については、この記事の「Workfront ボードへの接続の作成」を参照してください。
https://<WORKFRONT_DOMAIN>/boards-service/graphql? への相対パスを入力します。API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。 詳しくは、HTTP リクエスト方法を参照してください。
ほとんどのボードでは、メソッドはPOSTです。
リクエストのヘッダーを標準 JSON オブジェクトの形式で追加します。 これにより、リクエストのコンテンツタイプが決まります。
例： { "Content-type":"application/json-stringify()"}
API 呼び出しのクエリを標準 JSON オブジェクトの形式で追加します。
Workfront ボードの場合、通常、このセクションは空のままになります。
JSON埋め込みGraphql形式のAPI呼び出しの本文コンテンツを追加します
例：
次の使用例は、列名を更新します。 boardIdとcolumnIdは、ハードコードされているか、以前のモジュールからマッピングされているGUIDとして含めることができます。
{
"query": "mutation { updateColumn （boardId: \"\", columnId: \"\", updateColumnInput: { name: \"\" }） { id name }}"
}
メモ：
if などの条件文を JSON で使用する場合は、条件文を引用符で囲みます。
カスタム GraphQL API呼び出しを行う
このアクションモジュールは、Workfront Boards APIに対してカスタム GraphQL リクエストを行います。