Microsoft Project のフィールド マッピング
Microsoft Project のフィールド マッピング ファイルを変更することで、Team Foundation Server と Microsoft Project (TFS) との間のデータのマップ方法をカスタマイズできます。 マッピング ファイルは、作業項目トラッキング フィールドの参照名を Project のフィールドに関連付けます。 Microsoft Project のフィールド マッピングを変更する前に、このトピックで後述する情報を参照して、TFS で Project から作業項目トラッキング データベースにデータがコピーされる方法について理解する必要があります。
重要
サポートされる Project のフィールド名のセットは、Microsoft Project のバージョンによって異なる場合があります。
計算済みのフィールド
計算済みのフィールドを作業項目データベースの最新の情報に更新すると、不都合が生じることがよくあります。 たとえば、開始日と終了日は通常、タスクの期間および依存関係に基づいて計算されます。 チーム メンバーがチーム エクスプローラーでタスクの開始日を変更すると、フィールドが最新の情報に更新されたときに Office Project でエラーが起こる可能性があります。 このため、計算済みのフィールドが発行専用になるように構成できます。この場合、Office Project はそれらのフィールドの変更を作業項目データベースに発行しますが、フィールドは更新されません。 フィールドを発行専用で構成する方法の詳細については、「Microsoft Project マッピング ファイルのアップロードまたはダウンロード [TFSFieldMapping]」を参照してください。
また、作業項目フォームの定義に READONLY 属性を使用することで、チーム メンバーがチーム エクスプローラーで計算済みのフィールド値を変更するのを防ぐこともできます。 READONLY 属性の詳細については、「すべての FIELD XML 要素のリファレンス」を参照してください。
注意
MSF (Microsoft Solutions Framework) for Agile Software Development および MSF for CMMI Process Improvement のプロセス テンプレートでは、開始日と完了日があらかじめ発行専用のマップとして構成され、チーム エクスプローラーでは読み取り専用に構成されています。
マッピング フィールドの種類
Project から TFS にタスクを発行すると、Team Foundation によってデータが作業項目データベースにコピーされます。 また、タスクを最新の情報に更新すると、フィールド データが作業項目データベースから Project の計画にコピーされます。 フィールド データを正しくコピーするには、TFS と Project でフィールドの種類に互換性があることが必要です。 次の表に、Project のフィールドの種類が TFS のどのフィールドの種類と互換性があるかを示します。
TFS の作業項目のフィールドの種類 |
Microsoft Project のフィールドの種類 |
|---|---|
DateTime |
Datetime。 |
Double (倍精度浮動小数点型) |
作業、単位、パーセント、小数、および ±5.0 × 10−324 ～ ±1.7 × 10308 の範囲のすべてのフィールドの種類。 |
History |
サポート範囲外。 |
Html |
サポート範囲外。 |
整数 |
作業、単位、数値、および -2,147,483,648 ～ 2,147,483,647 の範囲のすべてのフィールドの種類。 |
PlainText |
サポート範囲外。 |
String |
テキスト (最大 255 文字)。 重要 Office Project では、[リソース名] フィールド リストにチーム メンバーの名前が入力されません。このため、名前を手動で一覧に追加する必要があります。Office Project で作業項目をリソースに割り当てるときは、Active Directory ドメイン サービス (AD DS) の表示名またはアドレス帳を使用してリソースを指定する必要があります。エイリアスや、その他の名前の短縮形を使用して作業項目をリソースに割り当てると、一貫性がなくなって検証エラーが発生する可能性があります。 |
TreePath |
ユーザー設定のアウトライン コード。 |
作業項目のフィールドの種類の詳細については、「作業項目フィールドの定義と変更」を参照してください。 Project フィールドの種類について詳しくは、「Project 2013 SDK の概要」に記されている pjField 定数についてのヘルプをご覧ください。
Project のフィールド名
Project で、pjtask で始まるすべてのフィールド名を TFS のフィールドにマップできます。 たとえば、pjTaskText10 は TFS の String フィールドにマップできます。 これらのフィールド名は、TFS のどの作業項目フィールドを Project のフィールドにマップするかを指定するときに、ProjectField 属性で使用されます。 Microsoft Project のフィールド名の一覧については、Microsoft Office 2003 ソフトウェア開発キットの定数 pjField に関するヘルプを参照してください。
注意
Project Server を使用している場合は、名前に "Enterprise" を含む追加のフィールド (pjTaskEnterpriseCost1 など) があります。「Team Foundation Server と Project Server の同期」で説明されているようにして統合するのでない限り、TFS が Project Server にデータを発行したり、更新したりすることはありません。そのため、こうしたフィールド名を、Project に対する Team Foundation アドインで使用することはできません。
参照
関連項目
Microsoft Project マッピング ファイルのアップロードまたはダウンロード [TFSFieldMapping]