|
ボードに接続するには、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 ボード接続を作成するには:
-
任意の 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 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 の形式で追加します
例:
次の使用例は、列名を更新します。 boardId と columnId を、ハードコードされた 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 |
各シナリオの実行サイクル中に、モジュールが返すレコードの最大数を入力またはマッピングします。 |
|