作業項目の種類のカテゴリのカスタマイズ

[アーティクル]
02/22/2013

次の witadmin コマンドを使用して、チームプロジェクトに対して定義されている作業項目の種類のカテゴリを管理できます。

exportcategories: Team Foundation Server を実行しているサーバーで定義されているカテゴリの XML 定義をエクスポートします。
importcategories: 作業項目の種類の XML 定義ファイルを、Team Foundation Server を実行するサーバーのチームプロジェクトにインポートします。

同じ名前のカテゴリが既に存在する場合、このコマンドは既存の定義を上書きします。同じ名前の作業項目の種類が存在しない場合は、新しいカテゴリが作成されます。

witadmin コマンドラインツールを実行するには、Visual Studio かチームエクスプローラーのいずれかがインストールされているコマンドプロンプトウィンドウを開き、次のように入力します。

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

64 ビット版の Windows で、%programfiles% を %programfiles(x86)% に置き換えます。

[!メモ]

カテゴリは、Visual Studio のパワーツールであるプロセスエディターを使用して作成および変更できます。このパワーツールはサポートされていません。詳細については、Microsoft Web サイトの「Team Foundation Server Power Tools (Team Foundation Server パワーツール)」を参照してください。

要件

カテゴリが定義されているチームプロジェクトに対して、次のアクセス許可を設定する必要があります。

作業項目の種類のカテゴリをエクスポートするには、[プロジェクトレベル情報を表示します] のアクセス許可が [許可] に設定されている必要があります。
作業項目の種類のカテゴリをインポートするには、プロジェクト管理者セキュリティグループのメンバーであるか、または [プロジェクトレベル情報を編集します] のアクセス許可が [許可] に設定されている必要があります。

詳細については、「Team Foundation Server のアクセス許可」および「Team Foundation Server の既定のグループ、アクセス許可、およびロール」を参照してください。

[!メモ]

管理者のアクセス許可を使ってログオンしている場合でも、Windows Server 2008 を実行中のサーバーでこの機能を実行するには、昇格した特権でコマンドプロンプトウィンドウを開く必要があります。管理者特権でコマンドプロンプトウィンドウを開くには、[スタート] ボタンをクリックし、[コマンドプロンプト] ショートカットメニューを開いて、[管理者として実行] をクリックします。詳細については、Microsoft Web サイトの「ユーザーアカウント制御」を参照してください。

witadmin exportcategories /collection:CollectionURL /p:Project [/f:FileName] [/e:Encoding] 

witadmin importcategories /collection:CollectionURL /p:Project /f:FileName [/e:Encoding]

パラメーター

パラメーター	説明
/collection:CollectionURL	チームプロジェクトコレクションの URI を指定します。URI の形式は http://ServerName:Port/VirtualDirectoryName/CollectionName です。仮想ディレクトリを使用していない場合、URI の形式は次のようになります。 http://ServerName:Port/CollectionName
/p:Project	カテゴリのエクスポート元またはカテゴリのインポート先のチームプロジェクトの名前。
/f:FileName	エクスポートまたはインポートするカテゴリを含む XML 定義ファイルのパスとファイル名。exportcategories コマンドの使用時にこのパラメーターを省略すると、カテゴリの一覧はコマンドプロンプトウィンドウに表示されます。
/e:Encoding	.NET Framework 2.0 のエンコーディング形式の名前。XML データをエクスポートまたはインポートするときに、指定したエンコーディングを使用します。たとえば、/e:utf-7 は Unicode (UTF-7) エンコーディングを指定します。このパラメーターを省略すると、witadmin はエンコーディングの検出を試みます。検出に失敗した場合、witadmin は UTF-8 を使用します。
/? または help	コマンドプロンプトウィンドウにコマンドのヘルプを表示します。

解説

カテゴリファイルをインポートすると、カテゴリがまだ存在しない場合は作成されます。カテゴリが既に存在する場合は、witadmin importcategories コマンドから、現在のリストが上書きされるという警告が出力されます。独自のプログラムを作成して既存のカテゴリのセットを更新したり、新しいデータに基づいてカテゴリを自分で更新したりできます。

重要
カテゴリに加えた変更は、プロセスの構成に影響します。「プロセス構成を使用したバックログページおよびボードページのカスタマイズ」を参照してください。

カテゴリの XML ファイルの構造については、「カテゴリ定義のスキーマリファレンス」を参照してください。

例

特に指定されていない場合、それぞれの例に適用される値は次のとおりです。

チームプロジェクトコレクションの URI: http://AdventureWorksServer:8080/tfs/DefaultCollection
プロジェクト名: AdventureWorks
入力または出力ファイル名: myCategories.xml
既定のエンコーディング: UTF-8

作業項目の種類のカテゴリの一覧表示

次のコマンドは、AdventureWorks プロジェクトに定義されている作業項目の種類のカテゴリを一覧表示します。

witadmin exportcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks

作業項目の種類のカテゴリのエクスポート

次のコマンドは、AdventureWorks プロジェクトに対して定義されている作業項目の種類のカテゴリを myCategories XML ファイルにエクスポートします。

witadmin exportcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myCategories.xml

作業項目の種類のカテゴリのインポート

次の例は、myCategories XML ファイルから AdventureWorks プロジェクトにカテゴリをインポートします。

witadmin importcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myCategories.xml

参照

概念

プロセス構成を使用したバックログページおよびボードページのカスタマイズ

その他の技術情報

作業項目の種類のカテゴリをグループ化するカテゴリの定義

作業項目の種類のカテゴリ要素参照リファレンス

witAdmin: 作業項目を追跡するためのオブジェクトのカスタマイズおよび管理

次の方法で共有