Team Foundation Server と Project Server の統合におけるフィールド マッピングの管理

フィールド マッピング ファイルを変更すること Visual Studio Team Foundation Server 2012 とMicrosoft Project Server間でデータを同期する方法をカスタマイズできます。このファイルでは、Team Foundation Server と Project Server の統合をサポートするために、同期するデータ フィールド、およびそれらのフィールドを同期する方法を定義します。このファイルは、TfsAdmin ProjectServer コマンド ライン ツールの以下のオプションを使用して管理できます。

• /DownloadFieldMappings: チーム プロジェクト コレクション用に定義されたフィールド マッピング ファイルをダウンロードします。

• /UploadFieldMappings: フィールド マッピング ファイルの XML 構文を検証し、コレクションにアップロードします。構文の検証だけを行い、ファイルのアップロードを実行しない場合は、/validateonly オプションを使用します。

[!メモ]

Team Foundation Server と Project Server の統合用のフィールド マッピング ファイルは、Microsoft Project のフィールド マッピング ファイルとは異なります。2 つ目のファイルをダウンロードまたはアップロードする方法については、「Microsoft Project マッピング ファイルのアップロードまたはダウンロード [TFSFieldMapping]」を参照してください。

フィールド マッピング ファイルの内容と、内容をカスタマイズする方法の詳細については、「Team Foundation Server と Project Server の統合に関するフィールド マッピング XML 要素リファレンス」および「Project Server と Team Foundation Server の間のフィールド マッピングのカスタマイズ」を参照してください。

TfsAdmin ProjectServer のコマンド ライン ツールを使用するには、またはがインストール Visual Studioチーム エクスプローラー 開き、"コマンド プロンプト ウィンドウを:

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

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

必要なアクセス許可

これらのコマンドを使用するには、チーム プロジェクト コレクションの [Project Server の統合の管理] アクセス許可が [許可] に設定されている必要があります。また、Team Foundation Server のサービス アカウントに、データ同期に参加する Project Web Access または Project Web App (PWA) のインスタンスと対話するために必要なアクセス許可が付与されている必要があります。詳細については、「Team Foundation Server と Project Server を統合するために必要なアクセス許可の割り当て」を参照してください。

[!メモ]

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

構文

TfsAdmin ProjectServer /DownloadFieldMappings /collection:tpcUrl /filepath:mappingFile [/encoding:encoding]

TfsAdmin ProjectServer /UploadFieldMappings /collection:tpcUrl /filePath:mappingFile [/encoding:encoding] [/validateOnly] [/useDefaultFieldMappings] [/force]

パラメーター

パラメーター	説明
/collection:tpcURL	チーム プロジェクト コレクションの URL (Uniform Resource Locator) を指定します。URL は次の形式で指定します。 http://<サーバー名:ポート>/<仮想ディレクトリ名>/<コレクション名> 仮想ディレクトリを指定しない場合は、次の形式で URI を指定します。 http://ServerName:Port/CollectionName
/filePath:mappingFile	フィールド マップを含む XML 定義ファイルのパスとファイル名を指定します。 メモ Windows Vista を使用している場合、アクセス許可がないフォルダーが存在する可能性があります。アクセス許可がない場所に作業項目の種類をエクスポートしようとすると、レジストリ仮想化テクノロジが、自動的にエクスポートされたファイルをリダイレクトし、仮想ストアに保存します。このリダイレクトが行われないようにするには、アクセス許可のある場所にファイルをエクスポートします。詳細については、Microsoft Web サイトの「Registry Virtualization (レジストリの仮想化)」および「Windows Vista または Windows 7 のファイルおよびレジストリの仮想化に関する一般的な問題」を参照してください。
/encoding:encoding	.NET Framework 2.0 のエンコード形式の名前を指定します。XML データは、指定したエンコード形式でエクスポートまたはインポートされます。たとえば、/e:utf-7 は Unicode (UTF-7) エンコードを指定します。このパラメーターを指定していない場合、エンコードの検出が試みられます。検出に失敗した場合は、UTF-8 が使用されます。
/validateOnly	マッピング ファイルを検証しますが、アップロードは実行しません。
/useDefaultFieldMappings	カスタム マッピング ファイルではなく、既定のフィールド マップをアップロードします。詳細については、「Team Foundation Server と Project Server の統合に関するフィールド マッピング XML 要素リファレンス」を参照してください。
/force	既存のマッピング ファイルを上書きします。異なるマッピングと既存のマッピングを置き換える場合 /useDefaultFieldMappings のスイッチを指定した場合は、このオプションを指定する必要があります。

ページのトップへ

解説

マップできるのは、エンタープライズ ユーザー設定フィールドまたは Project Server に組み込まれているフィールドだけです。Project で有効なフィールドの名前を指定する必要があります。組み込みフィールドの名前を指定するには、表示名からスペースを削除した後、名前の先頭に "pj" を追加します。たとえば、Status Manager のフィールド名は pjStatusManager、Custom 01 のフィールド名は pjCustom01 になります。組み込みフィールドとカスタム フィールドをマップする方法には制限があり、フィールドのデータ型を一致させる必要があります。詳細については、「Team Foundation Server と統合するために Project Server のフィールドをマッピングする際の制限事項」を参照してください。

TFSAdmin ProjectServer コマンドを実行すると、実行されるアクションと影響を受けるオブジェクトを示すメッセージが表示されます。たとえば、次のメッセージは、フィールド マッピング ファイルをダウンロードしていることを示しています。

Download field mappings from DefaultCollection

コマンド アクションが完了すると、別のメッセージが表示されます。たとえば、フィールド マッピング ファイルのダウンロードが完了すると、次のメッセージが表示されます。

You have downloaded field mappings to C:MappingFile. . . Done.

フィールド マップのアップロードに関する注意事項

フィールド マッピング ファイルが正常にアップロードされると、次の変更が行われます。

• マップされたフィールドに適合するように、Team Foundation の各ミラー フィールドが構成されます。

• コレクションまたはチーム プロジェクトのマップされている作業項目の種類について、作業項目フォームの [Project Server] タブに新しいマッピングが表示されます。

重要
Team Foundation Server のフィールドを Project Server にマップする場合は、これらのフィールドのデータ型が一致していることを確認します。それ以外の場合は、フィールド マップをアップロードしようとすると、次のエラーが表示されることがあります。 インデックス (0 ベース) は 0 以上で、引数リストのサイズよりも小さくなければなりません。 詳細については、「Data Types and Field Mapping Criteria」を参照してください。

ページのトップへ

例

チーム プロジェクト コレクションに対して定義されているフィールド マッピング ファイルをダウンロードする

次の例では、AdventureWorksCollection 用に定義されているフィールド マップを AWMappingFile.xml にダウンロードします。

TfsAdmin ProjectServer /DownloadFieldMappings /collection:http://AdventureWorksServer:8080/AdventureWorksCollection /filePath:"C:AWMappingFile.xml"

チーム プロジェクト コレクションのフィールド マッピング ファイルをアップロードする

次の例では、AWMappingFile.xmlをAdventureWorksCollectionにアップロードします。

TfsAdmin ProjectServer /UploadFieldMappings /collection:http://AdventureWorksServer:8080/AdventureWorksCollection /filePath:"C:AWMappingFile.xml" 

ページのトップへ

参照

処理手順

Team Foundation Server と Project Server の統合の構成

概念

Team Foundation Server と Project Server の統合に関するフィールド マッピング XML 要素リファレンス

Team Foundation Server と統合するために Project Server のフィールドをマッピングする際の制限事項

TfsAdmin ProjectServer による Project Server 統合の管理

その他の技術情報

Project Server と Team Foundation Server の間のフィールド マッピングのカスタマイズ