プロセスの構成インポートとエクスポート

[アーティクル]
04/04/2024

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

重要

オンプレミスの XML プロセスモデルでは、 witadmin を使用して、プロジェクトのプロセスの一覧表示、インポート、エクスポート、変更を行うことができます。継承およびホストされた XML プロセスモデルの場合は、 witadmin を使用してプロセス情報の一覧表示とエクスポートのみを行うことができます。プロセスモデルの概要とサポートされる内容については、「作業追跡エクスペリエンスのカスタマイズ」を参照してください。

プロセス構成をカスタマイズして、Web ポータルのアジャイルツールの表示を変更します。いくつかの追加ツールでは、ワークフローの状態をメタステートマッピングにマップする必要があります。

Note

TF400917エラーメッセージが表示された場合は、無効な構成が発生しました。 witadmin importprocessconfigを使用して、プロセス構成ファイルをプロジェクトに再インポートします。エラーを解決するために必要なメッセージが表示されます。

プロジェクトのプロセス構成を管理するには、 witadmin コマンドラインツールを使用して、プロセス構成 XML 定義ファイルをエクスポートおよびインポートします。プロセス構成の詳細については、「 ProcessConfigurationを参照してください。

exportprocessconfig: プロセス構成定義を XML ファイルまたはコマンドプロンプトウィンドウにエクスポートします。
importprocessconfig: プロセス構成定義 XML ファイルをインポートします。

`witadmin` コマンドラインツールを実行する

witadminコマンドラインツールを実行するには、Visual Studio がインストールされているコマンドプロンプトウィンドウを開きます。 witadmin コマンドラインツールは、任意のバージョンの Visual Studio と共にインストールされます。このツールにアクセスするには、 Visual Studio Community または Visual Studio チームエクスプローラーの無料バージョンをインストールします。

Note

Azure DevOps Services に接続するには、最新バージョンの Visual Studio または Visual Studio Community を使用することをお勧めします。

Note

オンプレミスサーバーに接続するには、Azure DevOps Server と同じまたはそれ以降のバージョンの Visual Studio を使用することをお勧めします。たとえば、Azure DevOps Server 2019 に接続する場合は、Visual Studio 2019 のバージョンからプロジェクトに接続します。

Visual Studio 2022 の場合

%programfiles(x86)%\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

インストールしたバージョンに応じて、Communityの代わりにProfessionalまたはEnterprise。

Visual Studio 2019 の場合

%programfiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

インストールしたバージョンに応じて、Communityの代わりにProfessionalまたはEnterprise。

Visual Studio 2017 の場合

%programfiles(x86)%\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

インストールしたバージョンに応じて、Enterpriseの代わりにTeamExplorerまたはProfessional。

32 ビット版の Windows では、 %programfiles(x86)% を %programfiles% に置き換えます。 Visual Studio Community (チームエクスプローラーへのアクセスを提供する) または Visual Studio Team Explorer 2017 を無料でインストールできます。

ヒント

witadmin を使用すると、定義ファイルをインポートおよびエクスポートできます。使用できるその他のツールには、プロセスエディターが含まれます (Visual Studio のバージョンをインストールしている必要があります)。 Visual Studio Marketplace からプロセステンプレートエディターをインストールします。

前提条件

プロセス構成定義をエクスポートするには、プロジェクトまたはコレクションの有効なユーザーである必要があります。
プロセス構成定義をインポートするには、 Team Foundation Administrators または Project Administrators のセキュリティグループのメンバーである必要があります。

詳細については、「プロジェクトコレクションレベルのアクセス許可を変更する」を参照してください。

構文

witadmin exportprocessconfig /collection:CollectionURL /p:ProjectName [/f:FileName] [/e:encoding]    
witadmin importprocessconfig /collection:CollectionURL [/p:ProjectName] /f:FileName [/e:encoding] [/v]

パラメーター

パラメーター

説明

/collection:CollectionURLx

プロジェクトコレクションの URI を指定します。次に例を示します。

オンプレミスの Azure DevOps 形式: http://ServerName:Port/VirtualDirectoryName/CollectionName

仮想ディレクトリが使用されていない場合、URI の形式は次のようになります: http://ServerName:Port/CollectionName。

/p:ProjectName

必須。プロセス構成をエクスポートまたはインポートするプロジェクトを指定します。このプロジェクトは、/collection パラメーターを使用して指定したコレクションで定義する必要があります。 /vスイッチを指定するときにプロジェクトを指定する必要はありません。

/f**:FileName

エクスポートまたはインポートするプロセス構成の XML 定義ファイルのパスと名前。

Note

クライアントコンピューターで Windows Vista が実行されている場合は、特定のフォルダーに対するアクセス許可がない可能性があります。グローバルリストをアクセス許可のない場所にエクスポートしようとすると、レジストリ仮想化テクノロジによってエクスポートされたファイルが自動的にリダイレクトされ、仮想ストアに保存されます。詳細については、Microsoft Web サイトの Registry Virtualization ページを参照してください。このリダイレクトを回避するには、アクセス許可がある場所にファイルをエクスポートします。

/e:Encoding

省略可能。 .NET Framework 2.0 エンコード形式の名前。指定したエンコードは、XML データのエクスポートまたはインポートに使用されます。たとえば、 /e utf-7 は Unicode (UTF-7) エンコードを指定します。このパラメーターを省略すると、 witadmin はエンコードの検出を試み、検出に失敗した場合は UTF-8 を使用します。

/v

省略可能。プロセス構成を定義するが、定義ファイルをインポートしない XML を検証します。

/? または help

コマンドプロンプトウィンドウにコマンドに関するヘルプを表示します。

解説

最新バージョンの Azure DevOps をインストールすると、既存のプロジェクトがアップグレードされます。アップグレードされたプロジェクトを更新する場合は、アップグレード後の構成機能に関するページを参照してください。

アップグレード後に既存のテスト計画またはテストスイートへのアクセスで問題が発生した場合は、テスト管理をサポートするための Manual 更新プログラムを参照してください。

例

各例では、次の値が適用されます。

コレクションの URL: http://AdventureWorksServer:8080/tfs/DefaultCollection
プロジェクト： Contoso
サーバー Web サイトのポート番号: 8080

クイック追加パネルにフィールドを追加するには

任意のクイック追加パネルのフィールドを追加できます。たとえば、次の例では、製品バックログパネルに Business Value を追加します。

[ビジネス価値] フィールドが追加された [バックログ] パネル

パネルには、選択した WIT の WIT 定義の FIELDS セクションに含まれるフィールドのみが表示されます。たとえば、バグ WIT を選択すると、ビジネス値がバグに対して定義されていないため、タイトルのみが表示されます。パネルに別の WIT を追加するには、それを要件カテゴリに追加します。「作業項目の種類をバックログとボードに追加するを参照してください。

プロジェクトの管理アクセス許可がない場合は、それらを取得。
「 witadmin コマンドラインツールを実行する方法に関する記事に記載されている手順に従って、コマンドプロンプトウィンドウを開きます。次に例を示します。
```
cd %programfiles(x86)%\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer
```
プロセス構成ファイルをエクスポートします。
```
witadmin exportprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\ProcessConfiguration.xml"  
```
CollectionURL の例は次のようになります。http://MyServer:8080/tfs/TeamProjectCollectionName.
フィールド参照名を AddPanel セクションに追加します。

たとえば、次の構文は、パネルに Priority 要素を追加します。
```
<AddPanel>  
   <Fields>  
      <Field refname="System.Title" />  
      <Field refname="Microsoft.VSTS.Common.BusinessValue" />  
   </Fields>  
</AddPanel>  
```
ヒント
- この indexを使用して、フィールドの参照名を検索できます。
- 要件カテゴリに定義されている作業項目タイプのすべての必須フィールドを追加します。これにより、パネルからバックログ項目を追加するときに、作業項目フォームを開いて入力する必要がなくなります。

プロセス構成ファイルをインポートします。

witadmin importprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\ProcessConfiguration.xml"

バックログページを更新して、更新されたパネルを表示します。

テストマネージャーをサポートするようにメタステートマッピングを更新する

テスト計画またはテストスイートの WORKFLOW セクションをカスタマイズする場合は、状態をメタステートにマップする必要があります。

次の例では、デザイン、テスト、およびサインオフ状態を使用するようにテスト計画ワークフローが更新されています。下位互換性をサポートするために、プロセス構成定義の ProjectProcessConfiguration セクションにTestPlanWorkItemsが追加されます。

Workflow

<WORKFLOW>
      <STATES>
        <STATE value="Design" />
        <STATE value="Testing" />
        <STATE value="Signed Off" />
      </STATES>
      <TRANSITIONS>
        <TRANSITION from="" to="Design">
          <REASONS>
            <DEFAULTREASON value="New test plan" />
          </REASONS>
        </TRANSITION>
     <TRANSITION from="Design" to="Testing">
          <REASONS>
            <DEFAULTREASON value="Authoring complete" />
          </REASONS>
        </TRANSITION>        
     <TRANSITION from="Testing" to="Signed Off">
          <REASONS>
            <DEFAULTREASON value="Signed Off testing" />
          </REASONS>
        </TRANSITION>
        <TRANSITION from="Signed Off" to="Design">
          <REASONS>
            <DEFAULTREASON value="Reactivating to authoring phase" />
          </REASONS>
        </TRANSITION>
        <TRANSITION from="Signed Off" to="Testing">
          <REASONS>
            <DEFAULTREASON value="Reactivating to run tests" />
          </REASONS>
        </TRANSITION>
        <TRANSITION from="Testing" to="Design">
          <REASONS>
            <DEFAULTREASON value="Back to authoring" />
          </REASONS>
        </TRANSITION>
      </TRANSITIONS>
    </WORKFLOW>

メタステートマッピング

<TestPlanWorkItems category="Microsoft.TestPlanCategory" pluralName="Test Plans" singularName="Test Plan">
    <States>
      <State type="InProgress" value="Design" />
      <State type="InProgress" value="Testing" />
      <State type="Complete" value="Signed Off" />
    </States>
  </TestPlanWorkItems>
<TestSuiteWorkItems category="Microsoft.TestSuiteCategory" pluralName="Test Suites" singularName="Test Suite">
    <States>
      <State type="Proposed" value="In Planning" />
      <State type="InProgress" value="In Progress" />
      <State type="Complete" value="Completed" />
    </States>
  </TestSuiteWorkItems>

テストスイートのワークフローを変更する場合は、新しい状態をマップする場合も同様の更新を行う必要があります。 TestSuiteWorkItems セクション内に追加します。 ProcessConfiguration を参照してください。

Q & A

Q: ワークフローの状態をメタステートにマップする必要があるのはいつですか?

A: ワークフローの状態を次の作業項目の種類に追加または削除する場合は、対応するメタステートマッピングを追加または削除するようにプロセス構成を更新することを検討する必要があります。

要件カテゴリまたはタスクカテゴリに属する作業項目の種類: メタ状態マッピングでは、アジャイル計画ツールの表示がサポートされます。
バグカテゴリに属する作業項目の種類: My Work ツール (アジャイルおよび CMMI ベースのプロジェクト) をサポートするメタステートマッピング。
テスト計画とテストスイート: これらの作業項目の種類のワークフローの更新は、Visual Studio 2013.2 以前のバージョンに基づく Test Manager のバージョンから Azure DevOps に接続するチームメンバーをサポートする場合にのみマップする必要があります。

アプリケーションがプロジェクトに接続するときに予期しないエラーエラーが検出された場合は、メタステートマッピングを更新します。

プロセス構成エラー操作方法解決しますか?

A: プロジェクトに次のいずれかの変更を加える場合は、作業項目の種類、カテゴリ、またはプロセス構成の定義を更新する必要があります。エラーを回避するには、(1) 作業項目の種類、(2) カテゴリ、および (3) プロセス構成の順に常に変更してください。

カスタマイズ

作業項目の種類の定義を更新または確認する

プロセス構成定義を更新または確認する

作業項目の種類を要件カテゴリに追加する

(作業項目の種類は、要件カテゴリまたはタスクカテゴリに属できますが、両方に属することはできません)。

次のフィールドを含めるには:

バックログ優先度 (スクラム) またはスタックランク (アジャイルまたは CMMI)

(プロセス構成ファイルの type=Order に割り当てられているフィールド値と一致する必要があります)
作業量 (スクラム)、ストーリーポイント (アジャイル)、またはサイズ (CMMI)

(プロセス構成ファイル内の type=Effort に割り当てられたフィールド値と一致する必要があります)
プロセス構成ファイル内の type=Team に割り当てられたエリアパスまたはフィールド値
プロセス構成ファイルの AddPanel セクションに含まれるすべてのフィールド (フィールドは FIELDS セクション内で定義する必要がありますが、 FORM セクションに含める必要はありません。

必要なメタステートマッピングを含むには、次の手順を実行します。

各ワークフロー状態の開始を type="Proposed"
ボードに表示する中間ワークフローの各状態を type="InProgress"
各ワークフロー状態の終了を type="Complete"
にマップできる状態は 1 つだけです。 type="Complete"

WIT に関連付けられているカラーコードを定義するエントリを含める。次に例を示します。
<WorkItemColor primary="FF009CCC" secondary="FFD6ECF2" name="Product Backlog Item" />

要件カテゴリの作業項目タイプのワークフローを変更する

該当なし

作業項目の種類を要件カテゴリに追加するために、前述のように必要なメタステートマッピングを含める。

作業項目の種類をタスクカテゴリに追加する

次のフィールドを含めるには:

バックログ優先度 (スクラム) またはスタックランク (アジャイルまたは CMMI)
アクティビティ (スクラムまたはアジャイル) または規範 (CMMI)
(プロセス構成ファイル内の type=Activity に割り当てられたフィールド値と一致する必要があります)
残存作業
(プロセス構成ファイル内の type=RemainingWork に割り当てられたフィールド値と一致する必要があります)
プロセス構成ファイル内の type=Team に割り当てられたエリアパスまたはフィールド値
(省略可能)元の作業と完了した作業 (アジャイルと CMMI のみ)

必要なメタステートマッピングを含むには、次の手順を実行します。

各ワークフロー状態の開始を type="Proposed" にマップする
タスクボードに表示する中間ワークフローの各状態を、 type="InProgress"
各ワークフロー状態の終了を type="Complete にマップする"

にマップできる状態は 1 つだけです。 type="Complete"

WIT に関連付けられているカラーコードを定義するエントリを含める。次に例を示します。

<WorkItemColor primary="FFF2CB1D" secondary="FFF6F5D2" name="Task" />

タスクカテゴリの作業項目の種類のワークフローを変更する

該当なし

作業項目の種類をタスクカテゴリに追加するために、前述のように必要なメタステートマッピングを含める場合。

バグカテゴリに作業項目の種類を追加する (アジャイルと CMMI のみ)
バグカテゴリの作業項目の種類のワークフローを変更する (アジャイルと CMMI のみ)

該当なし

必要なメタステートマッピングを含むには、次の手順を実行します。

各ワークフロー状態の開始を type="Proposed"
[マイワーク] に表示する中間ワークフローの各状態を type="InProgress"
各ワークフロー状態の種類の末尾をマップする="完了"

にマップできる状態は 1 つだけです。 type="Complete"

詳細については、「マイワークを使用してバグ更新の状態をサポートするを参照してください。

要件カテゴリまたはタスクカテゴリから作業項目の種類を削除する

該当なし

その作業項目の種類にのみ関連付けられているメタステートマッピングを削除するには

プロジェクトから作業項目の種類を削除する

作業項目の種類をカテゴリファイルから削除します。

削除した作業項目の種類にのみ関連付けられているメタステートマッピングと、削除した作業項目の種類の色コードを定義する WorkItemColor 要素を削除します。

Q: 2 つ以上のポートフォリオバックログを操作しますか?

A: 既定のエクスペリエンスでは、1 レベルのポートフォリオバックログがサポートされます。「アジャイルツールにポートフォリオバックログを追加するで説明されているように、最大 5 つのレベルを追加できます。

Q: タスクボードまたは製品バックログに表示される作業項目の種類を追加または変更しますか?

A: カスタム作業項目の種類を追加し、バックログまたはタスクボードに追加する場合は、これを行うことができます。両方の場所に表示することはできません。詳細については、「作業項目の種類をバックログとボードに追加するを参照してください。

次の方法で共有

プロセスの構成インポートとエクスポート

`witadmin` コマンドラインツールを実行する

前提条件

構文

パラメーター

解説

例

クイック追加パネルにフィールドを追加するには

テストマネージャーをサポートするようにメタステートマッピングを更新する

Q & A

Q: ワークフローの状態をメタステートにマップする必要があるのはいつですか?

プロセス構成エラー操作方法解決しますか?

Q: 2 つ以上のポートフォリオバックログを操作しますか?

Q: タスクボードまたは製品バックログに表示される作業項目の種類を追加または変更しますか?

フィードバック

その他のリソース

次の方法で共有

プロセスの構成インポートとエクスポート

witadmin コマンド ライン ツールを実行する

前提条件

構文

パラメーター

解説

例

クイック追加パネルにフィールドを追加するには

テスト マネージャーをサポートするようにメタステート マッピングを更新する

Q & A

Q: ワークフローの状態をメタステートにマップする必要があるのはいつですか?

プロセス構成エラー操作方法解決しますか?

Q: 2 つ以上のポートフォリオ バックログを操作しますか?

Q: タスク ボードまたは製品バックログに表示される作業項目の種類を追加または変更しますか?

関連記事

フィードバック

その他のリソース

`witadmin` コマンドラインツールを実行する

テストマネージャーをサポートするようにメタステートマッピングを更新する

Q: 2 つ以上のポートフォリオバックログを操作しますか?

Q: タスクボードまたは製品バックログに表示される作業項目の種類を追加または変更しますか?