同期対象に含める作業項目の種類の定義
Visual Studio Team Foundation Server (TFS) と Microsoft Project Server のデータを同期するには、事前に 2 つのサーバー製品の統合を構成する必要があります。 構成タスクの一環として、エンタープライズ プロジェクト計画とチーム プロジェクトを関連付け、同期に含める作業項目の種類を指定する必要があります。 初期構成およびマッピングを行った後で、マップ対象の作業項目の種類を変更できます。
同期に含める作業項目の種類を管理するには、TfsAdmin ProjectServer コマンド ライン ツールの以下のオプションを使用します。
/MapWorkItemTypes: チーム プロジェクトで同期に含めることができる作業項目の種類を定義します。 複数の種類をマップできますが、同期されるのは発行のために送信された作業項目のみです。
/GetMappedWorkItemTypes: チーム プロジェクトで同期に含めるように構成されている作業項目の種類の一覧を返します。
/UnmapWorkItemTypes: チーム プロジェクトで作業項目の種類を同期から除外します。
2 つのサーバー製品を統合する方法の概要については、「TFS と Project Server の統合の構成」を参照してください。 エンタープライズ プロジェクトとチーム プロジェクトを関連付ける方法の概要については、「エンタープライズ プロジェクトとチーム プロジェクトの関連付けの管理」を参照してください。
TfsAdmin ProjectServer コマンド ライン ツールを使用するには、Visual Studio かチーム エクスプローラーのいずれかがインストールされているコマンド プロンプト ウィンドウを開き、次のように入力します。
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
32 ビット版の Windows では、%programfiles(x86)% を %programfiles% に置き換えます。
要件
このコマンドを使用するには、[Project Server の統合の管理] アクセス許可が [許可] に設定されている必要があります。 また、Team Foundation Server のサービス アカウントに、データ同期に参加する PWA のインスタンスと対話するために必要なアクセス許可が付与されている必要があります。詳細については、「TFS と Project Server を統合するためのアクセス許可の割り当て」を参照してください。
構文
TfsAdmin ProjectServer /GetMappedWorkItemTypes /collection:tpcUrl teamProject:TeamProjectName
TfsAdmin ProjectServer /MapWorkItemTypes /collection:tcpUrl /teamProject:TeamProjectName /workItemTypes:ListOfWorkItemTypes [/skipUIChanges]
TfsAdmin ProjectServer /UnmapWorkItemTypes /collection:tpcUrl /teamProject:TeamProjectName /workItemTypes:ListOfWorkItemTypes [/force]
パラメーター
パラメーター |
説明 |
|---|---|
/collection:tpcUrl |
チーム プロジェクト コレクションの URL (Uniform Resource Locator) を指定します。 URL は次の形式で指定します。 http://ServerName:Port/VirtualDirectoryName/CollectionName 仮想ディレクトリを指定しない場合は、次の形式で URL を指定します。 http://ServerName:Port/CollectionName |
/teamProject:TeamProjectName |
プロジェクト コレクションで定義されているチーム プロジェクトの名前を指定します。 |
/workItemTypes:ListofWorkItemTypes |
1 種類以上の作業項目の参照名をコンマ区切りの一覧で指定します。 Project Professional で追跡するデータを含む作業項目の種類のみを指定してください。 たとえば、アジャイル プロセスをサポートするには、作業項目の種類として “User Story,Task” または “User Story”,Task を指定できます。 コンマの後にスペースは挿入できません。 |
/skipUIChanges |
指定した種類について、作業項目フォームの [Project Server] タブが変更されないように指定します。 影響を受ける種類の [Project Server] タブをカスタマイズしている場合は、このフラグを指定しないと MapWorkItemTypes コマンドを完了できません。 種類の定義は手動で更新できます。 詳細については、「作業項目の種類の定義に追加される XML 要素」を参照してください。 |
/force |
指定した種類の作業項目を Project のタスクに関連付けているすべてのリンクを削除します。 このオプションを使用すると、該当する種類の 1 つ以上の作業項目が現在同期中であっても、データ同期からその種類の作業項目を削除できます。 |
/? または help |
コマンドに関する情報を表示します。 |
解説
コマンドを実行すると、実行中のアクションとその対象となっているオブジェクトを示すメッセージが表示されます。 たとえば、次のメッセージは、ユーザー ストーリーとタスクをデータ同期に含めるように構成中であることを示します。
Configuring synchronization for the following work item types for team project ProjA: User Story, Task. . .
コマンドが終了すると、別のメッセージが表示されます。 たとえば、次のメッセージは、ユーザー ストーリーとタスクが正常に構成されたことを示します。
You have successfully configured the following work item types for team project ProjA: User Story, Task.
/MapWorkItemTypes コマンドでは、同期に含めることができる作業項目の種類を構成する以外に、次の操作も実行します。
指定した作業項目の種類をデータ同期対象の種類のセットに追加します。 つまり、このコマンドでは、既存のマップ済みの種類のマップ解除は行いません。
指定した作業項目の種類のフォームに [Project Server] タブを追加します。
指定した作業項目の種類に対して [Project Server] タブが既に定義されている場合、その種類は無視され、その種類の作業項目のフォームは変更されません。
エンタープライズ プロジェクト計画に関連付けられていないチーム プロジェクトの作業項目の種類をマップしようとすると、エラーが表示されます。 マップできるのは、チーム プロジェクトで同期に含めるように構成されている作業項目の種類のみです。 詳細については、「エンタープライズ プロジェクトとチーム プロジェクトの関連付けの管理」を参照してください。
作業項目の種類のマッピングを削除すると、マップ解除したチーム プロジェクトについて、その種類のフォームから [Project Server] タブが削除されます。
チーム プロジェクトの作業項目の種類をマップ解除する前に、エンタープライズ プロジェクト計画からタスクを削除し、それらのタスクと Team Foundation の作業項目の間の関連付けをすべて解除する必要があります。 エンタープライズ プロジェクト計画からタスクを削除したら、これを発行して同期の完了を待つ必要があります。 別の方法として、/force フラグを指定して、作業項目をチーム プロジェクトのタスクに関連付けているすべてのリンクを削除することもできます。 指定した種類の作業項目のみが同期から除外されます。
ヒント
タスクを削除する場合は、必要に応じてこれを別の計画にコピーして、そのレコードを残しておくことができます。
例
マップされている作業項目の種類を一覧表示する
次の例では、AdventureWorksServer 上の DefaultCollection の Contoso チーム プロジェクトについて、同期に含めるように構成されている作業項目の種類を取得しています。
TfsAdmin ProjectServer /GetMappedWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /teamproject:Contoso
チーム プロジェクトの作業項目の種類をマップする
次の例では、Contoso プロジェクトのユーザー ストーリーとタスクをデータ同期に含めるように構成しています。
TfsAdmin ProjectServer /MapWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection/ /teamProject:Contoso /workitemtypes:”User Story, Task”
チーム プロジェクトの作業項目の種類のマッピングを削除する
次の例では、Contoso プロジェクトのタスクをデータ同期から削除しています。
TfsAdmin ProjectServer /UnmapWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection/ /teamProject:Contoso /workitemtypes:Task
参照
概念
マップ統合コンポーネント [TfsAdmin ProjectServer]