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

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

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

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

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

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

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

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 を無料でインストールできます。

前提条件

• プロセス構成定義をエクスポートするには、プロジェクトまたはコレクションの有効なユーザーである必要があります。
• プロセス構成定義をインポートするには、 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]  

パラメーター

解説

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

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

例

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

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

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

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

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

1. プロジェクトの管理アクセス許可がない場合は、それらを 取得。

2. 「 witadmin コマンドライン ツールを実行する方法に関する記事に記載されている手順に従って、コマンド プロンプト ウィンドウを開きます。 次に例を示します。

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

3. プロセス構成ファイルをエクスポートします。

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

   CollectionURL の例は次のようになります。http://MyServer:8080/tfs/TeamProjectCollectionName.

4. フィールド参照名を AddPanel セクションに追加します。

   たとえば、次の構文は、パネルに Priority 要素を追加します。

   <AddPanel>  
      <Fields>  
         <Field refname="System.Title" />  
         <Field refname="Microsoft.VSTS.Common.BusinessValue" />  
      </Fields>  
   </AddPanel>  
   

   ヒント

   • この indexを使用して、フィールドの参照名を検索できます。
   • 要件カテゴリに定義されている作業項目タイプのすべての必須フィールドを追加します。 これにより、パネルからバックログ項目を追加するときに、作業項目フォームを開いて入力する必要がなくなります。

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

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

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

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

テスト計画またはテスト スイートの 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) プロセス構成の順に常に変更してください。

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

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

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

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

関連記事

• アップグレード後の機能の構成
• コントロール XML 要素リファレンス
• 作業項目フォームのレイアウトを変更する
• 作業項目の種類の定義を編集して、Web コンテンツを作業項目フォームに追加する
• 作業追跡エクスペリエンスのカスタマイズ
• 作業項目フィールドのインデックス
• witAdmin: 作業を追跡するためのオブジェクトのカスタマイズおよび管理