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