プロセス テンプレートをアップロードまたはダウンロードする

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

プロジェクトを作成するとき、構成する作業項目の種類とその他の設定を指定するには、プロセスを使います。 各プロセス テンプレートでは、主に、Azure Boards 用の作業項目追跡システムの構成要素が定義されています。 ホストされた XML プロセス モデルとオンプレミス XML プロセス モデルでは、プロセス テンプレートをアップロードして、既存のプロジェクトを更新するか、プロジェクトを作成することができます。 継承プロセス モデルでは、Web ポータルを使用して作業の追跡をカスタマイズします。 これらのさまざまなプロセスについて詳しくは、「作業追跡エクスペリエンスをカスタマイズする」をご覧ください。

プロセス テンプレートをアップロードおよびエクスポートできるのは、オンプレミス XML プロセスを使うように構成されたプロジェクト コレクションの場合のみです。 また、プロジェクトを追加するときに既定として表示されるように、テンプレートをマークすることもできます。

重要

Azure DevOps コンテンツ バージョン セレクターからバージョンを選択。

お使いのプラットフォームとバージョンに対応するこの記事のバージョンを選択します。 バージョン セレクターは目次の上にあります。 Azure DevOps のプラットフォームとバージョンを検索します

ヒント

Azure DevOps Server では、継承プロセス モデルとオンプレミス XML プロセス モデルのどちらを使うかを選べます。 詳細については、「作業追跡エクスペリエンスをカスタマイズする」の「プロジェクト コレクションのプロセス モデルを選択する」セクションを参照してください。 既定のプロセスまたはプロセス テンプレートの最新バージョンにアクセスするには:

前提条件

プロセス テンプレートを管理するには、プロジェクト コレクション管理者グループのメンバーである必要があります。このグループへの追加については、プロジェクト コレクション レベルのアクセス許可の変更に関する記事をご覧ください。

重要

継承プロセスのアップロードとダウンロードはサポートされていません。 継承プロセスの管理については、「プロセスのカスタマイズと継承プロセスの概要」をご覧ください。

[設定] > [プロセス] を開く

プロセスの作成、管理、カスタマイズは、[組織の設定] > [プロセス] から行います。

  1. Azure DevOps のロゴを選択して、[プロジェクト] を開きます。 次に、[組織の設定] を選びます。

    [プロジェクト] > [組織の設定] を開く。

  2. 次に、[プロセス] を選択します。

    次に、[プロセス] を選択する。

    重要

    [プロセス] が表示されない場合は、TFS-2018 以前のバージョンから作業しています。 [プロセス] ページはサポートされていません。 オンプレミス XML プロセス モデルでサポートされている機能を使う必要があります。

プロセスの作成、管理、カスタマイズは、[コレクション設定] > [プロセス] から行います。

  1. Azure DevOps のロゴを選択して、[プロジェクト] を開きます。 プロセスをカスタマイズするプロジェクト コレクションを選んで、[コレクション設定] を選びます。

    [プロジェクト] > [組織の設定] を開く

  2. 次に、[プロセス] を選択します。

    次に、[プロセス] を選択する。

プロセスの作成、管理、カスタマイズは、[管理者の設定] > [プロセス] から行います。

  1. Azure DevOps のロゴを選択して、[プロジェクト] を開きます。 次に、[管理者の設定] を選びます。

    [プロジェクト] > [組織の設定] を開く。

  2. 次に、[プロセス] を選択します。

    次に、[プロセス] を選択する。

プロセス テンプレートをインポートする (ホストされた XML プロセス)

  1. [プロセス] タブで [プロセスのインポート] を選択し、カスタマイズしたプロセスの zip ファイルをドラッグ アンド ドロップするか、参照します。

    [プロセスのインポート] リンクのスクリーンショット。

    注意

    [プロセスのインポート] リンクが表示されない場合は、ホストされた XML プロセス モデルをサポートするように組織が設定されていません。 カスタマイズのニーズのためには継承プロセス モデルを使用する必要があります。 ホストされた XML プロセス モデルは、アカウントがデータ インポート サービスを介して作成された場合にのみサポートされます。

  2. アップロードするファイルを選択します。 インポート時の検証チェックに合格するには、カスタム プロセスが特定の制約を満たしている必要があります

    [プロセスのインポート] ダイアログ、インポートするプロセス ファイルを選択する。

    既存のテンプレートを更新する場合は、[既存のテンプレートを置換] をオンにします。 インポート プロセスでは、インポートするテンプレートと同じ名前のテンプレートが上書きされるので、このボックスをオンにして置換を確認する必要があります。

    重要

    ロックされたプロセス (アジャイル、基本、CMMI、スクラム) のいずれかを更新することはできません。

  3. インポートが成功すると、次のメッセージが表示されます。

    プロセスのインポート成功ダイアログ。

    インポート時に実行される検証チェックにプロセスが合格しない場合は、一連のエラー メッセージが表示されます。
    各エラーを修正し、インポートをもう一度試みます。

  4. 新しくインポートしたプロセスを使って、プロジェクトをすぐに作成できます。

    [プロセスのインポート] アクション メニューのスクリーンショット、インポートされたプロセスから新しいチーム プロジェクトを作成する。

  5. 表示されるフォームに入力します。 さまざまなオプションについて詳しくは、プロジェクトの作成に関する記事をご覧ください。

    [新しいプロジェクトの作成] のダイアログ。

ホストされた XML プロセスのその他の管理タスクについては、「ホストされた XML プロセスのインポートとエクスポート」をご覧ください。

プロセス テンプレートを管理する (オンプレミス XML プロセス)

  1. プロセス テンプレートをアップロードするには、[プロセス テンプレートのアップロード] オプションを選択します。

    Web ポータル、[すべてのプロセス]、[プロセス テンプレートのアップロード] のスクリーンショット。

    [プロセス テンプレートのアップロード] ダイアログで、アップロードするプロセス テンプレートのルート ファイル ProcessTemplate.xml が格納されている .zip フォルダーを選択します。 「プロセス テンプレートの制限事項と検証チェック」も参照してください。

    Web ポータル、[プロセス テンプレートのアップロード] ダイアログのスクリーンショット。

  2. プロセス テンプレートをダウンロードまたはエクスポートするには、 アクション アイコンを選んで、[エクスポート] オプションを選びます。

    Web ポータルのプロセス コンテキスト メニューの、プロセスのエクスポートのスクリーンショット。

  3. 新しいプロジェクトを追加するときの既定としてプロセスを設定したり、プロセスの使用を無効にしたりするには、プロセスの アクション アイコンを選択して、[既定のプロセスとして設定] または [プロセスを無効にする] オプションを選びます。

    Web ポータルのプロセス コンテキスト メニューの、プロセスの無効化または削除のスクリーンショット。

プロセス テンプレートを既存のプロジェクトに関連付ける

プロジェクトの作成に使用されたプロセス テンプレートの種類を確認するには、チーム エクスプローラーの [新しい作業項目] メニューに表示される作業項目の種類をレビューし、次の図の作業項目の種類と比較します。 作業項目の種類が表示されている項目と異なる場合、カスタム プロセス テンプレートが使われている可能性があります。

アジャイル Basic CMMI スクラム
Agile の作業項目の種類 基本作業項目の種類 CMMI の作業項目の種類 Scrum の作業項目の種類

プロセス テンプレートの制限事項と検証チェック

Web ポータルを使用してプロセス テンプレートをアップロードすると、次の図に示すようなエラーが発生する可能性があります。

プロセス テンプレートのアップロードのエラーのスクリーンショット。

各エラーを解決してから、アップロード プロセスをもう一度試してください。 プロセス テンプレート エラーの解決に関する追加情報については、「プロセス インポートの検証エラーを解決する」をご覧ください。

プロセス テンプレートをアップロードするときは、次の検証チェックに合格する必要があります。

  • プロセス テンプレートには、Unicode で 256 文字以内の一意の名前を付ける必要があります。 既存のテンプレートと同じ名前を持つテンプレートをアップロードすると、既存のテンプレートが上書きされます。 名前には、次の文字を含めることはできません: . , ; ' ` : / \ * | ? " & % $ ! + = ( ) [ ] { } <>. その他の制限については、名前付けの制限に関する記事をご覧ください。
  • プロセス テンプレートのフォルダーには、.exe ファイルを含めることはできません。 含めた場合、プロセス テンプレートのアップロードには成功しても、プロジェクトの作成は失敗します。
  • プロセス テンプレートの合計サイズは 2 GB 以内にしてください。この制限を超えると、プロジェクトの作成は失敗します。
  • アップロード プロセスでは、部分的な検証チェックが実行されて、各プロセス テンプレート XML ファイルの XML が有効であることが確認されます。 プロセス テンプレートをアップロードしようとしてエラーが発生する場合は、XML をレビューしてエラーの原因を特定してください。 XML ファイルに重複するタグがあると、エラーの原因になります。 XML にエラーがない場合は、適切なすべてのファイルが、プロセス テンプレート内の正しいフォルダーの位置に含まれていることを確認します。
  • XML 定義ファイルで拡張機能が参照されている場合は、コレクションに拡張機能をインストールして有効にする必要があります。

重要

プロセス テンプレートのスキーマ定義では、Camel 形式とすべて大文字の要素を組み合わせて使用します。 種類の定義ファイルの検証中にエラーが発生した場合は、要素の大文字と小文字の構造を確認してください。 また、開始タグと終了タグの大文字と小文字の構造は、XML 構文の規則に従って一致する必要があります。 「プロセス テンプレート プラグイン: XML 要素定義に対するインデックス」もご覧ください。

新しい機能をサポートするため、プロセス テンプレートは定期的に更新されます。 詳しくは、Azure DevOps Server のリリース ノートに関する記事をご覧ください。