作業項目の種類に拡張機能とカスタム コントロールを追加する (継承プロセス)

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

拡張機能を使用すると、作業項目フォームに豊富な機能を追加できます。 拡張機能には、4 種類のフレーバーまたはコントリビューションタイプがあります。 次のコントロールは、継承およびカスタマイズ可能なすべての作業項目の種類 (WIT) の Web フォーム レイアウトに表示されます。

• フィールド レベルのコントリビューション (カスタム コントロール)
• グループ レベルのコントリビューション
• ページ レベルのコントリビューション

一方、4 番目の種類であるアクション レベルのコントリビューションは、Web フォームのコンテキスト メニューに表示されます。

すべての投稿を追加するには、Visual Studio Marketplace の [Azure DevOps] タブから拡張機能をインストールします。または、独自のカスタム コントロールを作成することもできます。

たとえば、[最近作業項目を表示したユーザー] 拡張機能を追加できます。 このグループ レベルのコントリビューションは、次のように作業項目フォームに表示されます。

前提条件

特定のビジネス要件に合わせて Azure Boards を調整する方法のガイダンスについては、「Azure Boards の構成とカスタマイズについて」を参照してください。

• 組織の要件: Azure DevOps に 組織があることを確認します。

• アクセス許可:

  • プロジェクト コレクション管理者グループのメンバーになります。
  • [プロセスの作成]、[プロセスの削除]、[プロセスの編集]、[組織からフィールドを削除する] などのコレクション レベルのアクセス許可が [許可] に設定されている。
  • これらのアクセス許可を使用すると、組織内のプロセスとフィールドを変更できます。

拡張機能を追加したりプロセスを編集したりするには、プロジェクト コレクション管理者グループのメンバーであるか、特定のプロセスを編集するための明示的なアクセス許可が付与されている必要があります。

組織プロセスの設定を開く

1. 組織にサインインします (https://dev.azure.com/{yourorganization})。

2. [組織の設定] を選択します。

   

3. プロセスを選択します。

   

Note

継承されたプロセスをカスタマイズすると、そのプロセスを使用するすべてのプロジェクトにそのカスタマイズが自動的に反映されます。 スムーズな移行を確実に行うために、組織全体でカスタマイズを実装する前にテスト プロセスとプロジェクトを作成することをお勧めします。 詳細については、「継承されたプロセスの作成と管理」を参照してください。

インストールされている Marketplace 拡張機能を確認する

[設定] コンテキストの [拡張機能] から、既にインストールされている拡張機能を表示できます。 新しくインストールされた拡張機能を 表示するには、ページの更新が必要になる場合があります。

拡張機能の詳細については、「無料の拡張機能をインストールする」を参照してください。

Marketplace 拡張機能を追加する

Marketplace を参照して、追加する拡張機能を決定できます。

1. 作業項目の種類に拡張機能を追加するには、継承したプロセスである WIT を選択し、[拡張機能の取得] を選択します。

   

2. 追加する拡張機能を選択します。 ここでは、[作業項目] チェックリストを選択します。

3. 追加する組織を選択し、[インストール] を選択します。

   

   重要

   インストールした拡張機能は、すべてのプロセスのすべての WIT に追加されます。

4. プロセスと WIT に戻り、拡張機能の場所が必要な場所であることを確認します。 中央の列の下部で検索し、フォーム上の目的の場所にドラッグします。

   

フィールド レベルのコントリビューションまたはカスタム コントロールを追加する

1. 前の セクションで説明したように、カスタム コントロール をインストールします。

2. 作業項目フォームから [設定作業>プロセス]>を開きます。 詳細については、「設定プロセスを開く」を>参照してください。

3. (省略可能) カスタム コントロールに関連付けるフィールド を追加します。 または、継承またはカスタムの既存のフィールドを指定することもできます。

4. WIT を選択した状態で、[カスタム コントロールの追加] を選択します。

   

   Note

   [カスタム コントロールの追加] オプションが表示されない場合は、フィールド レベルの拡張機能をインストールしていません。 または、ブラウザーを最新の情報に更新して、最近インストールされた新しい拡張機能をブラウザーで登録する必要がある場合もあります。

5. オプションのメニューから目的のカスタム コントロールを選択します。

   たとえば、ここでは、ブール型フィールドに関連付けることができる Toggle コントロールを選択します。

   

6. [オプション] タブを選択し、ダイアログ ボックスに入力します。 指定する必要があるオプションは、選択したカスタム コントロールによって異なります。

   たとえば、ここではユーザー設定フィールド Triaged を指定し、フォームに表示する切り替えラベルを示します。

   

7. (省略可能)[レイアウト] タブを開き、フィールドのラベルを指定します。

   その他の必須フィールドを入力します。 ガイダンスについては、拡張機能の説明を確認してください。

8. 変更した種類の作業項目を開いて、カスタム コントロールの動作を確認します。 変更を確認するには、ブラウザーの更新が必要な場合があります。

   ここでは、コントロールが既定でどのように表示されるかをチェック ボックスとトグル コントロールで示します。

チェック ボックスが付いたブール型フィールド

トグル コントロールを持つブール型フィールド

グループ レベルとページ レベルのコントリビューション

グループ レベルのコントリビューションとページ レベルのコントリビューションを追加すると、継承とカスタムの両方のプロセスに対して定義されているすべての WIT に自動的に追加されます。 これらの投稿が特定の WIT のフォームに表示されないようにするか、フォーム内で既定の場所から移動するように選択できます。

グループまたはページの投稿をインストールした場合は、ブラウザーを更新し、作業項目を開いてフォームへの投稿の配置を表示します。 コントリビューションを移動または非表示にするには、[ レイアウト] タブのガイダンスに従います。

アクション レベルのコントリビューション

アクション レベルのコントリビューションは、システムプロセスと継承プロセスの両方に対して継承されたカスタマイズ可能な WIT のコンテキスト メニューに追加されます。 すべてのアクション レベルのコントリビューションはすべての作業項目の種類に追加され、拡張機能をアンインストールまたは無効にしないと非表示または削除できません。

たとえば、次の図は、9 つのアクション レベルのコントリビューションが追加され、ユーザー ストーリーのコンテキスト メニューに表示されていることを示しています。

プログラムによってカスタム コントロールを追加する

次の REST API を使用して拡張機能を操作できます。

• 作業項目フォームを拡張する
• 作業項目フォームにカスタム コントロールを追加する

関連記事

Note

監査ログを使用して、継承されたプロセスに加えられた変更を確認します。 詳細については、「監査ログへのアクセス、エクスポート、およびフィルター処理」を参照してください。

• 作業項目の種類にユーザー設定フィールドを追加する
• 作業項目の種類をカスタマイズする
• Web レイアウトをカスタマイズする
• 継承されたプロセスを使用してプロジェクトをカスタマイズする