Adobe Workfront基板モジュール

NOTE
Boards Fusion コネクタはベータ版ステータスです。 その結果、このコネクタのサポートは制限され、今後のボードの開発により変更される可能性があります。 また、Fusion コネクタプロセスに影響を与える可能性があるGraphQL API が、予告なく変更される場合があります。

Adobe Workfront ボードは、列やカードを含む共有ボードへのアクセスを提供することで、チームの共同作業を可能にする柔軟なツールです。

Adobe Workfront ボード モジュールを使用すると、レコードの読み取りや更新、Workfront ボード API への API 呼び出しを行ったり、ボードでアクションが発生した場合のシナリオのトリガーを設定したりできます。

アクセス要件

展開すると、この記事の機能のアクセス要件が表示されます。
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Adobe Workfront パッケージ

任意のAdobe Workfront ワークフローパッケージと任意のAdobe Workfront Automation and Integration パッケージ

WorkfrontUltimate

Workfront Fusion を追加購入したWorkfront Primeおよび Select パッケージ。

Adobe Workfront ライセンス

標準

ワークまたはそれ以上

製品 組織がWorkfront Automation and Integration を含まない Select またはPrime Workfront パッケージを持っている場合は、Adobe Workfront Fusion を購入する必要があります。

このテーブルの情報について詳しくは、​ ドキュメントのアクセス要件 ​ を参照してください。

accordion
##前提条件

ボードに接続するには、Adobe Workfrontでボードを設定しておく必要があります。

Adobe Workfront ボード API 情報

Adobe Workfront ボードコネクタでは、以下を使用します。

table 0-row-2 layout-auto html-authored no-header
API タグ v1.23.6

Workfront Boards への接続の作成

note note
NOTE
Workfront接続を使用してWorkfront Boards に接続するか、別のWorkfront Boards 接続を作成できます。

Workfront ボード接続を作成するには:

  1. 任意の Adobe Workfront Boards モジュールで、「接続」ボックスの横にある「追加」をクリックします。

  2. 次のフィールドに入力します。

    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- です。

  3. 続行」をクリックして接続を保存し、モジュールに戻ります。

Adobe Workfront Boards モジュールとそのフィールド

Workfront Fusion でWorkfront ボードモジュールを設定する場合、以下に示すフィールドが表示されます。 これらに加えて、アプリまたはサービスのアクセスレベルなどの要因に応じて、追加のWorkfront ボードフィールドが表示される場合があります。 モジュール内の太字のタイトルは、必須フィールドを示します。

フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、​ モジュール間で情報をマッピングする ​ を参照してください。

マップ切り替え

カード

チェックリスト項目を追加

このアクションモジュールは、指定されたカードにチェックリスト項目を追加します。

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Connection

既存のWorkfront接続を使用してWorkfront Boards に接続することも、特定のWorkfront Boards 接続を使用することもできます。

Workfront アプリをWorkfront Fusion に接続する手順については、この記事の Workfront ボードへの接続の作成を参照してください。

Card ID

チェックリスト項目を追加するカードの ID を入力またはマッピングします

Workfrontでカードを表示すると、URL にカード ID が表示されます。

チェックリスト項目 ​ 追加するチェックリスト項目ごとに、「項目を追加」をクリックし、チェックリスト項目の名前を入力して、項目が完了したかどうかを選択します。

サブタスクを追加

このアクションモジュールは、ボードのカードにサブタスクを追加します。 カードは接続されている必要があります。 サブタスクは、カードが表すWorkfront タスクにも追加されます。

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection

既存のWorkfront接続を使用してWorkfront Boards に接続することも、特定のWorkfront Boards 接続を使用することもできます。

Workfront アプリをWorkfront Fusion に接続する手順については、この記事の Workfront ボードへの接続の作成を参照してください。

親カード ID

サブタスクの追加先となるカードの ID を入力またはマッピングします。

Workfrontでカードを表示すると、URL にカード ID が表示されます。

Board ID

サブタスクの追加先となるカードを含むボードの ID を入力またはマッピングします。

Workfrontでボードを表示する際に、URL にボード ID が含まれています。

Name 新しいサブタスクの名前を入力またはマッピングします。

カードの作成

Workfrontのボード上に新しいカードを作成します。

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection

既存のWorkfront接続を使用してWorkfront Boards に接続することも、特定のWorkfront Boards 接続を使用することもできます。

Workfront アプリをWorkfront Fusion に接続する手順については、この記事の Workfront ボードへの接続の作成を参照してください。

Board ID

カードを追加するボードの ID を入力またはマッピングします。

Workfrontでボードを表示する際に、URL にボード ID が含まれています。

列 ID

サブタスクを追加する列の ID を入力またはマッピングします。

列 ID は、ボードを読み取りモジュールから返される情報で見つけることができます。

Name 新しいカードの名前を入力またはマッピングします。

カードの移動

このアクションモジュールは、カードを同じボード上の別の列に移動します。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
Connection

既存のWorkfront接続を使用してWorkfront Boards に接続することも、特定のWorkfront Boards 接続を使用することもできます。

Workfront アプリをWorkfront Fusion に接続する手順については、この記事の Workfront ボードへの接続の作成を参照してください。

Card ID

移動するカードの ID を入力またはマッピングします。

Workfrontでカードを表示すると、URL にカード ID が表示されます。

Board ID

移動するカードを含むボードの ID を入力またはマッピングします。

Workfrontでボードを表示する際に、URL にボード ID が含まれています。

宛先列 ID

カードの移動先の列の ID を入力またはマッピングします。

列 ID は、ボードを読み取りモジュールから返される情報で見つけることができます。

からインデックスへ ​

新しい列にカードを配置する位置を入力またはマップします。

インデックス 0 の列の一番上の位置。

カードを読み取る

このアクションモジュールは、特定のカードに関する情報を取得します。

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Connection

既存のWorkfront接続を使用してWorkfront Boards に接続することも、特定のWorkfront Boards 接続を使用することもできます。

Workfront アプリをWorkfront Fusion に接続する手順については、この記事の Workfront ボードへの接続の作成を参照してください。

Card ID

読み取るカードの ID を入力またはマッピングします。

Workfrontでカードを表示すると、URL にカード ID が表示されます。

Card ID

読み取るカードを含むボードの ID を入力またはマッピングします。

Workfrontでボードを表示する際に、URL にボード ID が含まれています。

カードの更新

このアクションモジュールは、指定したカードの情報を更新します。

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

既存のWorkfront接続を使用してWorkfront Boards に接続することも、特定のWorkfront Boards 接続を使用することもできます。

Workfront アプリをWorkfront Fusion に接続する手順については、この記事の Workfront ボードへの接続の作成を参照してください。

Card ID

更新するカードの ID を入力またはマッピングします。

Workfrontでカードを表示すると、URL にカード ID が表示されます。

Board ID

更新するカードを含むボードの ID を入力またはマッピングします。

Workfrontでボードを表示する際に、URL にボード ID が含まれています。

Name カードの新しい名前を入力またはマッピングします。
Description カードの新しい説明を入力またはマッピングします。
Estimation このカードを完了するのに必要な推定時間を入力またはマップします。
Due date

このカードの期日を入力またはマッピングします。

サポートされる日付と時刻の形式の一覧については、「 型強制」を参照してください。

Status カードの新しいステータスを選択します。

ボード

ボードを作成

Workfrontにボードを作成します。 作成するボードのタイプを指定できます。

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Connection

既存のWorkfront接続を使用してWorkfront Boards に接続することも、特定のWorkfront Boards 接続を使用することもできます。

Workfront アプリをWorkfront Fusion に接続する手順については、この記事の Workfront ボードへの接続の作成を参照してください。

ボード名 ​ 新しいボードの名前を入力またはマッピングします。
Template 作成するボードのタイプに合ったテンプレートを選択します。

ボードを読み取る

このアクションモジュールは、ボードのカード、列、タグ、メンバーなど、1 つのボードに関する情報を返します。

table 0-row-2 1-row-2 layout-auto html-authored no-header
Connection

既存のWorkfront接続を使用してWorkfront Boards に接続することも、特定のWorkfront Boards 接続を使用することもできます。

Workfront アプリをWorkfront Fusion に接続する手順については、この記事の Workfront ボードへの接続の作成を参照してください。

Board ID

情報を取得するボードの ID を入力またはマッピングします。

Workfrontでボードを表示する際に、URL にボード ID が含まれています。

列の作成

このアクションモジュールは、指定されたボードに新しい列を作成します。

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection

既存のWorkfront接続を使用してWorkfront Boards に接続することも、特定のWorkfront Boards 接続を使用することもできます。

Workfront アプリをWorkfront Fusion に接続する手順については、この記事の Workfront ボードへの接続の作成を参照してください。

Board ID

列を追加するボードの ID を入力またはマッピングします。

Workfrontでボードを表示する際に、URL にボード ID が含まれています。

列 ID

更新する列の ID を入力またはマッピングします。

列 ID は、ボードを読み取りモジュールから返される情報で見つけることができます。

列名 ​ 列の新しい名前を入力またはマッピングします。

列の検索

この検索モジュールは、指定された名前を持つ列に関する情報を返します。

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Connection

既存のWorkfront接続を使用してWorkfront Boards に接続することも、特定のWorkfront Boards 接続を使用することもできます。

Workfront アプリをWorkfront Fusion に接続する手順については、この記事の Workfront ボードへの接続の作成を参照してください。

Board ID

取得する列を含むボードの ID を入力またはマッピングします。

Workfrontでボードを表示する際に、URL にボード ID が含まれています。

列名 ​ 取得する列の名前を入力またはマッピングします。

列の更新

このアクションモジュールは、指定された列の名前または WIP 制限を更新します。

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection

既存のWorkfront接続を使用してWorkfront Boards に接続することも、特定のWorkfront Boards 接続を使用することもできます。

Workfront アプリをWorkfront Fusion に接続する手順については、この記事の Workfront ボードへの接続の作成を参照してください。

Board ID

取得する列を含むボードの ID を入力またはマッピングします。

Workfrontでボードを表示する際に、URL にボード ID が含まれています。

列名 ​ 取得する列の名前を入力またはマッピングします。
の WIP 制限 ​ 列の新しい WIP 制限を入力またはマップします。

タグ

カードにタグを追加

このアクションモジュールは、カードにタグを追加します。

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection

既存のWorkfront接続を使用してWorkfront Boards に接続することも、特定のWorkfront Boards 接続を使用することもできます。

Workfront アプリをWorkfront Fusion に接続する手順については、この記事の Workfront ボードへの接続の作成を参照してください。

Card ID

タグの追加先となるカードの ID を入力またはマッピングします。

Workfrontでカードを表示すると、URL にカード ID が表示されます。

Board ID

タグの追加先となるカードを含んだボードの ID を入力またはマッピングします。

Workfrontでボードを表示する際に、URL にボード ID が含まれています。

Tag ID

追加するタグの ID を入力またはマッピングします。

タグ ID は、ボードを読み取りモジュールから返される情報で見つけることができます。

タグの作成

このアクションモジュールは、新しいタグを作成し、カラーを割り当てます。

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection

既存のWorkfront接続を使用してWorkfront Boards に接続することも、特定のWorkfront Boards 接続を使用することもできます。

Workfront アプリをWorkfront Fusion に接続する手順については、この記事の Workfront ボードへの接続の作成を参照してください。

Board ID

タグを作成するボードの ID を入力またはマッピングします。

Workfrontでボードを表示する際に、URL にボード ID が含まれています。

タグ名 ​ 新しいタグの名前を入力またはマッピングします。
タグの色 ​ このタグのカラーを選択します。

コメント

コメントの作成

このアクションモジュールは、指定されたカードにコメントを作成しました。

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Connection

既存のWorkfront接続を使用してWorkfront Boards に接続することも、特定のWorkfront Boards 接続を使用することもできます。

Workfront アプリをWorkfront Fusion に接続する手順については、この記事の Workfront ボードへの接続の作成を参照してください。

Card ID

コメントを追加するカードの ID を入力またはマッピングします。

Workfrontでカードを表示すると、URL にカード ID が表示されます。

Comment 追加するコメントのテキストを入力またはマップします。

カードコメントを読む

このアクションモジュールは、指定されたカードからコメントを取得します。

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Connection

既存のWorkfront接続を使用してWorkfront Boards に接続することも、特定のWorkfront Boards 接続を使用することもできます。

Workfront アプリをWorkfront Fusion に接続する手順については、この記事の Workfront ボードへの接続の作成を参照してください。

Card ID

コメントを取得するカードの ID を入力またはマッピングします。

Workfrontでカードを表示すると、URL にカード ID が表示されます。

Limit 1 回の実行サイクルでモジュールに返すコメントの最大数を入力します。

その他

カスタム API 呼び出しの実行

このアクションモジュールは、Workfront Boards 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

既存のWorkfront接続を使用してWorkfront Boards に接続することも、特定のWorkfront Boards 接続を使用することもできます。

Workfront アプリをWorkfront Fusion に接続する手順については、この記事の Workfront ボードへの接続の作成を参照してください。

URL https://<WORKFRONT_DOMAIN>/boards-service/graphql? への相対パスを入力します。
Method

API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。詳しくは、HTTP リクエストメソッドを参照してください。

ほとんどのボードでは、メソッドは POST です。

Headers

リクエストのヘッダーを標準 JSON オブジェクトの形式で追加します。これにより、リクエストのコンテンツタイプが決まります。

例: { "Content-type":"application/json-stringify()"}

Query String

API 呼び出しのクエリを標準 JSON オブジェクトの形式で追加します。

Workfront ボードの場合、このセクションは通常、空のままになります。

Body

API 呼び出しの本文コンテンツを JSON 埋め込み Graphql の形式で追加します

例:

次の使用例は、列名を更新します。 boardIdcolumnId を、ハードコードされた GUID または以前のモジュールからマッピングされた GUID として含めることができます。

{
 "query": "mutation { updateColumn (boardId: \"\"", columnId: \"\", updateColumnInput: { name: \"\" }) { id name }}"
}

メモ:

if などの条件文を JSON で使用する場合は、条件文を引用符で囲みます。

カスタム GraphQL API 呼び出しを行う

このアクションモジュールは、Workfront Boards API に対してカスタム GraphQL リクエストを実行します。

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

既存のWorkfront接続を使用してWorkfront Boards に接続することも、特定のWorkfront Boards 接続を使用することもできます。

Workfront アプリをWorkfront Fusion に接続する手順については、この記事の Workfront ボードへの接続の作成を参照してください。

Method この呼び出しのメソッドを選択します。
Query API 呼び出しのクエリを標準 JSON オブジェクトの形式で追加します。
操作名 ​ この操作の名前を入力します。 これにより、呼び出しのトレースとデバッグが容易になります。
変数のデータ ソース ​ 変数をフォームから取得するか、コレクションから取得するかを選択します。
Variables 追加する変数ごとに、「 項目を追加 をクリックして、変数のキーと値を入力します。
Limit 各シナリオの実行サイクル中に、モジュールが返すレコードの最大数を入力またはマッピングします。
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3