データの同期をサポートするために TFS に追加された Project Server フィールド

Visual Studio Team Foundation Server と Microsoft Project Server 間のデータ同期に含める作業項目の種類を指定すると、作業項目の種類に 25 以上のフィールドが追加されます。 追加されるフィールドのいくつかは、作業項目フォームにも追加され、[Project Server] タブに表示されます。 これらのフィールドを使用して、レポートを作成したり、作業項目を検索するクエリを指定したりできます。 詳細については、「作業項目送信の監視および拒否状態の解消」を参照してください。

作業項目フォームのフィールドを追加または削除するには、通常、作業項目の種類の定義ファイルをエクスポートし、ファイルを修正してからチーム プロジェクト用にインポートします。 ただし、データ同期に含める作業項目の種類の場合は、フィールドの追加または削除は、[Project Server] タブからフィールド マップをファイルにダウンロードし、このファイルを修正してからチーム プロジェクト コレクションにアップロードすることによって行います。 詳細については、「TFS と Project Server の間のフィールド マッピングのカスタマイズ」を参照してください。

重要

フィールドはチーム プロジェクト コレクションにマップされます。作業項目の 1 つの種類についてマップされるすべてのフィールドは、データ同期に含める他のすべての種類の作業項目に対しても同様になります。詳細については、「同期する作業項目の種類の指定」を参照してください。

既定の Project Server タブ

エンタープライズ プロジェクトをチーム プロジェクトに関連付けると、次の図に示すような [Project Server] タブが作業項目フォームに追加されます。 このタブは、データ同期に含めるよう指定した作業項目の種類に対してのみ追加されます。 フィールドは、フィールド マッピング ファイルの displayTfsField 属性または displayTfsMirror 属性が true に設定されている場合にのみ追加されます。

チーム プロジェクト コレクションのフィールド マップをカスタマイズすることで、フィールドを追加または削除できます。 詳細については、「TFS と Project Server の間のフィールド マッピングのカスタマイズ」および「TFS と Project Server の統合における XML 要素リファレンスのフィールド マッピング」を参照してください。

既定の Project Server フィールド

データ同期をサポートするために作業項目の種類に追加される各フィールドを次の表で説明します。 ほとんどのフィールドは、送信、更新、再送信を追跡するために同期エンジンによってのみ使用されるため、読み取り専用になっています。 エンタープライズ プロジェクトがチーム プロジェクトにマップされるか、または作業項目の種類がマップされると、[Project Server] タブにミラー化されたフィールドが追加されます。

注意

コレクションが PWA のインスタンスにマップされると、次の表に記載されたフィールドがグローバル ワークフロー定義ファイルからチーム プロジェクト コレクションにインポートされます。グローバル ワークフローの詳細については、「グローバル ワークフローのカスタマイズ」を参照してください。

フィールド	参照名とデータ型	説明
Project Server Assigned To (Project Server の割り当て先)	Mirror.System.AssignedTo (String)	読み取り専用。 プロジェクト計画の作業項目に割り当てるリソースの値を格納します。
Project Server Completed Work (Project Server 実績作業)	Mirror.Microsoft.VSTS.Scheduling.CompletedWork (Double)	読み取り専用。 プロジェクト計画の対応するタスクに割り当てられた "Task Actual Work" (タスクの実績作業時間) フィールドの値を格納します。
Project Server Enterprise Project (Project Server エンタープライズ プロジェクト)	Microsoft.Sync.ProjSrv.ProjectName (String)	読み取り/書き込みまたは読み取り専用 作業項目と同期するタスクを持つエンタープライズ プロジェクト計画の名前を指定します。 複数のプロジェクト計画にマップされるチーム プロジェクトから新しい作業項目を送信する場合、作業項目を同期する計画を指定する必要があります。 チーム プロジェクトでマップされているプロジェクト計画が 1 つしかない場合は、このフィールドは読み取り専用になり、マップされているプロジェクト計画の名前が表示されます。 注意 サービス アカウント グループのメンバーとしてログオンしている場合、同期エンジンがこのフィールドに対して特別なアクセス権を要求するため、フィールドは常に読み取り/書き込みとして表示されます。
Project Server Finish Date (Project Server の完了日)	Mirror.Microsoft.VSTS.Scheduling.FinishDate (DateTime)	読み取り専用。 プロジェクト計画の対応するタスクに割り当てられた "完了日" フィールドの値を格納します。 注意 "完了日" (pjFinishDate) フィールドをマッピングに追加することはできますが、Team Foundation で設定した値は Project Server に送信されません。この制限は仕様です。"完了日" は、エンタープライズ プロジェクト計画の値によって常に定義される必要があります。
Project Server Is Linked (Project Server とのリンク状態)(Project Server にリンク済み)	Microsoft.Sync.ProjSrv.IsLinkedToProjSrv (String)	読み取り専用。 作業項目が Project Server のタスクに現在リンクされているかどうかを指定します。 タスクが Project Server へ発行されると、作業項目はリンク状態になります。 有効値は、"はい" と "いいえ" です。
Project Server Last Review Status (Project Server の最新レビュー ステータス)(最新の承認の状態)	Microsoft.Sync.ProjSrv.LastReviewStatus (String)	読み取り専用。 プロジェクト マネージャーによって行われた最新の承認の状態を "承認済み" または "却下" に指定します。
Project Server Last Reviewed Date (Project Server の最新レビュー日付)(最新の承認日)	Microsoft.Sync.ProjSrv.LastReviewedDate (DateTime)	プロジェクト マネージャーが、作業項目のステータスの更新を最後に承認した日時を指定します。
Project Server Last Submit Status (Project Server 最終送信状態)	Microsoft.Sync.ProjSrv.LastSubmitStatus (String)	読み取り専用。 Project Server への最後の送信の結果を "成功" または "失敗" として格納します。
Project Server Last Submitted Date (Project Server の最新送信日付)	Microsoft.Sync.ProjSrv.LastSubmittedDate (DateTime)	読み取り専用。 作業項目が最後に保存された日付と時刻を格納します。これは、最後に Project Server に送信されたバージョンに対応します。
Project Server Original Estimate (Project Server の最初の見積もり)	Mirror.Microsoft.VSTS.Scheduling.OriginalEstimate (Double)	読み取り専用。 プロジェクト計画の対応するタスクに割り当てられた "基準作業時間" フィールドの値を格納します。
Project Server Remaining Work (Project Server 残存作業)	Mirror.Microsoft.VSTS.Scheduling.RemainingWork (Double)	読み取り専用。 プロジェクト計画の対応するタスクに割り当てられた "Task Remaining Work" (タスクの残存作業時間) フィールドの値を格納します。
Project Server Start Date (Project Server の開始日)	Mirror.Microsoft.VSTS.Scheduling.StartDate (DateTime)	読み取り専用。 プロジェクト計画の対応するタスクに対して定義されている開始日を格納します。 注意 "開始日" (pjStartDate) フィールドをマッピングに追加することはできますが、Team Foundation で設定した値は Project Server に作業項目を初めて送信するときにしか送信されません。この制限は仕様です。同期エンジンは Project Server に対し、日付関連のフィールドに関する更新を送信しません。日付は、エンタープライズ プロジェクト計画の値によって定義されます。
Project Server Submit (Project Server の送信)(必須)	Microsoft.Sync.ProjSrv.Submit (String)	作業項目をデータ同期に含めるかどうかを指定します。
Project Server Title (Project Server のタイトル)	Mirror.System.Title (String)	読み取り専用。 プロジェクト計画の対応するタスクに割り当てられているタイトルを格納します。

同期プロセスをサポートする目的でのみ使用されるフィールド

次の表に、同期プロセスをサポートするために使用される読み取り専用フィールドを示します。

注意

次の情報は参照用としてのみ提供されています。

フィールド	参照名とデータ型
Project Server Sync Approval Watermark (Project Server Sync の承認ウォーターマーク)	Microsoft.Sync.ProjSrv.ApprovalWatermark (String)
Project Server Sync Assignment Data (Project Server Sync の割り当てデータ)	Microsoft.Sync.ProjSrv.AssignmentData (PlainText)
Project Server Sync Is Summary in Project Server (Project Server Sync の Project Server でのサマリーの状態)	Microsoft.Sync.ProjSrv.IsSummaryInProjSvr (Integer)
Project Server Sync Last Submitted Revision (Project Server Sync の最新送信リビジョン)	Microsoft.Sync.ProjSrv.LastSubmittedRevision (Integer)
Project Server Sync Last Sync Revision (Project Server Sync の最新同期リビジョン)	Microsoft.Sync.ProjSrv.LastSyncRevision (Integer)
Project Server Sync Last Sync Type (Project Server Sync の最新同期の種類)	Microsoft.Sync.ProjSrv.LastSyncType (Integer)
Project Server Sync Project GUID (Project Server Sync のプロジェクト GUID)	Microsoft.Sync.ProjSrv.ProjGuid (GUID)
Project Server Sync Queue Flags (Project Server Sync のキュー フラグ)	Microsoft.Sync.ProjSrv.QueueFlags (Integer)
Project Server Sync Requested Assignment GUID (Project Server Sync の要求割り当て GUID)	Microsoft.Sync.ProjSrv.RequestedAssnGuid (GUID)
Project Server Sync Requested Project GUID (Project Server Sync の要求プロジェクト GUID)	Microsoft.Sync.ProjSrv.RequestedProjGuid (GUID)
Project Server Sync Submit Tag (Project Server Sync の送信タグ)	Microsoft.Sync.ProjSrv.SubmitTag (String)
Project Server Sync Task GUID (Project Server Sync のタスク GUID)	Microsoft.Sync.ProjSrv.TaskGuid (GUID)
Project Server Sync Task Modified Revision Counter (Project Server Sync のタスクの修正リビジョン カウンター)	Microsoft.Sync.ProjSrv.TaskModifiedRevCounter (Integer)

Project Server Assignment Data (Project Server の割り当てデータ)

次のコード サンプルは、"Project Server Sync Assignment Data" (Project Server Sync の割り当てデータ) フィールドにサマリー タスクの作業のロールアップを格納するために使用されるマークアップ言語を示しています。 IsPrimary 属性は、サマリー作業項目の主要なまたはアクティブな所有者である 1 つの Assignment に対してのみ true にできます。

注意

次の情報は参照用としてのみ提供されています。

<Assignments>
   <Assignment IsPrimary="true" Succeeded="true">
      <Field RefName="System.AssignedTo">Eduard Dell</Field>
      <Field RefName="Microsoft.VSTS.Scheduling.CompletedWork">0.000000</Field>
      <Field RefName="Microsoft.VSTS.Scheduling.RemainingWork">32.000000</Field>
   </Assignment>
   <Assignment IsPrimary="false" Succeeded="true">
      <Field RefName="System.AssignedTo">Sanjay Patel</Field>
      <Field RefName="Microsoft.VSTS.Scheduling.CompletedWork">8.000000</Field>
      <Field RefName="Microsoft.VSTS.Scheduling.RemainingWork">16.000000</Field>
   </Assignment>
</Assignments>

参照

概念

TFS と Project Server の統合における同期プロセスの概要

同期する作業項目の種類の指定

TFS と Project Server の統合における XML 要素リファレンスのフィールド マッピング

その他の技術情報

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