Microsoft Project マッピング ファイルのアップロードまたはダウンロード [TFSFieldMapping]

  • [アーティクル]

TFSFieldMapping マッピング ファイルをアップロードおよびダウンロードするには、Microsoft Project を使用します。 このファイルは、オンプレミスの Team Foundation Server (TFS) に接続しているチーム プロジェクトに Microsoft Project がどのようにタスクを発行するかを制御します。 たとえば、このファイルを変更することによって、作業項目の種類に追加したフィールドをサポートしたり、既存のフィールドの発行や更新の方法を変更したりすることができます。

どの TFS フィールドを Project フィールドにマップするかを指定できます。 また、PublishOnly 属性を使用して発行の動作を制御したり、コンテキスト フィールドなどの特別なフィールドを指定したりすることもできます。 マッピング ファイルの完全な XML 構文については、「Microsoft Project のフィールド マッピング ファイルのカスタマイズ」を参照してください。 このファイルは、チーム プロジェクトの作成に使用されたプロセス テンプレートで定義されたファイルと同じです。 「Microsoft Project フィールドの Team Foundation フィールドへのマッピング」を参照してください。

TFSFieldMapping コマンド ライン ツールは、オンプレミスの TFS に対して実行される場合にのみ機能します。 このツールを実行するには、Visual Studio またはチーム エクスプローラーがインストールされている環境でコマンド プロンプト ウィンドウを開き、次のように入力します。

cd %programfiles%\Common Files\microsoft shared\Team Foundation Server\14.0

注意

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

必要条件

TFSFieldMapping コマンドを実行するには、Team Foundation 管理者セキュリティ グループまたは プロジェクト管理者セキュリティ グループのメンバーである必要があります。 詳細については、「Team Foundation Server のアクセス許可の参照」を参照してください。

TFSFieldMapping upload | download /collection:CollectionURL /teamproject:ProjectName /mappingfile:MappingFile

パラメーター

引数

説明

upload | download

フィールド マッピング ファイルをダウンロードまたはアップロードするかどうかを指定します。

/collection:CollectionURL

チーム プロジェクト コレクションの URI を次の形式で指定します。http://ServerName:Port/VirtualDirectoryName/CollectionName

仮想ディレクトリを指定しない場合は、次の形式を使用する必要があります。

http://ServerName:Port/CollectionName

以前サーバーに接続したことがある場合は、URI ではなくサーバーの表示名を指定できます。

/teamproject: ProjectName

マッピング パラメーターを変更するチーム プロジェクトの名前を指定します。 名前に空白が含まれている場合は、二重引用符で囲みます。

/mappingfile: MappingFile

マッピング ファイルの名前とファイル パスを指定します。

作業項目フィールドの Project へのマッピングを変更するには

  1. Project と、チーム エクスプローラーまたは TFS がインストールされている環境でコマンド プロンプト ウィンドウを開き、次のように入力します。

    cd %programfiles%\Common Files\microsoft shared\Team Foundation Server\12.0

    ヒント

    Project はマッピング ファイルをダウンロードする場合は必要ありませんが、アップロードするために必要です。

  2. 次のコマンドを入力して、マッピング ファイルをダウンロードします。

    TFSFieldMapping download /collection:CollectionURL /teamproject:ProjectName /mappingfile:MappingFile

    ヒント

    名前に空白が含まれている場合は、引用符で囲みます。

  3. テキスト エディターまたは XML エディターでマッピング ファイルを開きます。

  4. 以下の形式で、新しいマッピングを追加するか、既存のマッピングを編集します。

    <Mapping WorkItemTrackingFieldReferenceName="System.Id" 
   ProjectField=""
   ProjectName=""
   ProjectUnits=""
   PublishOnly=""
   IfSummaryRefreshOnly=""/>

    たとえば、スクラム プロセス テンプレートを使用して作成されたチーム プロジェクトにスケジューリング フィールドを追加するには、次のマッピングを追加します。

    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.StartDate" ProjectField="pjTaskStart" PublishOnly="true" />
<Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.FinishDate" ProjectField="pjTaskFinish" PublishOnly="true" />
<Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.OriginalEstimate" ProjectField="pjTaskBaselineWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="true" />
<Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.CompletedWork" ProjectField="pjTaskActualWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="true" />

    既定のスクラム テンプレートは、"残存作業" フィールドのみを Project にマップします。

    注意

    ProjectField 属性に対する Office Project のすべてのフィールド値の一覧については、「Microsoft Project のフィールド マッピング」を参照してください。

  5. (省略可能) フィールドが発行されるが、更新されないことを指定します。 そのフィールドのマッピング セクションに PublishOnly 属性を追加し、属性を true に設定します。 この属性を使用すると、チーム メンバーはフィールド値を参照できますが、Team Foundation でフィールド値を変更できません。

  6. (省略可能) サマリー タスクが Project でどのように最新の情報に更新されるかを指定します。 フィールドが作業項目データベースに発行されないが、フィールドの行が Project のサマリー タスクであり、サマリー タスクで fSummaryRefreshOnly="true"Publish and Refresh=Yes が設定され、サマリー タスクに TFS に発行された子タスクが少なくとも 1 つ含まれている場合に、作業項目データベースからの最新の情報に更新されることを指定するには、 属性を追加します。

  7. ファイルを保存してアップロードします。

    TFSFieldMapping upload /collection:CollectionURL /teamproject:ProjectName /mappingfile:MappingFile

参照

関連項目

Microsoft Project のフィールド マッピング

概念

Microsoft Project のフィールド マッピング ファイルのカスタマイズ