Referenční dokumentace k elementům XML mapování polí pro integraci produktů TFS a Project Server

Přizpůsobení mapování pole, můžete definovat, která pole je v Visual Studio Team Foundation Server (TFS) a Microsoft Project Server by měly být neustále synchronizovaný a pole, která jsou aktualizovány ve frontě stav pro Microsoft Project Server a v Team Foundation.

[!POZNÁMKA]

Mapování polí pro integraci se serverem Project Server TFS se liší od souboru mapování pro Microsoft Project.Informace o druhém souboru naleznete v tématu Přizpůsobení souboru mapování polí produktu Microsoft Project.

Můžete spravovat jednu sadu mapování polí pro každé kolekce týmových projektů, který hostuje týmových projektů, které chcete synchronizovat se serverem Project Server.Chcete-li načíst mapování pole, můžete stáhnout do souboru z kolekce.Po úpravě souboru, nahrajte jej do kolekce a změny budou použity na všechny týmové projekty, které jsou definovány pro tuto kolekci.Další informace o tom, jak stáhnout nebo odešlete mapování polí naleznete v tématu Přizpůsobení mapování polí mezi produkty TFS a Microsoft Project.

V tomto tématu

• Povinná pole

• Výchozí pole, které jsou namapovány

• Mapování elementů a atributů

• Výchozí mapování polí

Povinná pole

Následující pole musí být namapována na podporu synchronizace dat.Pokud jste upravili pole, které se používají k plánování práce, je nutné upravit mapování polí odkaz na pole, které používáte.

• System.Title musí být namapována na pjTaskName.

• System.AssignedTo musí být namapována na pjResourceNames.

• Pole, které lze využít ke sledování zahájení práce v Team Foundation musí být namapována na pjTaskStart.Ve výchozím nastavení je toto pole Microsoft.VSTS.Scheduling.StartDate.

• Pole, které lze využít ke sledování dokončené práci v Team Foundation musí být namapována na pjTaskFinish.Ve výchozím nastavení je toto pole Microsoft.VSTS.Scheduling.FinishDate.

Výchozí pole, které jsou namapovány

Pro každé pole sady TFS můžete zadat dvě mapování.V první mapování zadáte v poli projekt, který v poli TFS aktualizuje ve frontě stav.V druhém mapování zadáte v poli projekt, který aktualizuje pole v sadě TFS.Kromě toho můžete určit, zda pole sady TFS se zobrazí na formulář pracovní položky a jak jsou proveden odkaz aktualizací a zrcadleného pole.

Ve výchozím nastavení všechna pole projektu, které jsou mapovány jsou také zrcadlení, což znamená, že jejich hodnoty jsou uloženy v rámci TFS.

Důležité

Ve většině konfigurací neměli odebrat výchozí mapování pole vzhledem k tomu, že proces synchronizace vyžadovalo se u něj.Výchozí mapování můžete například neodstraňujte, pokud se plánu projektu enterprise mapuje týmový projekt, který byl vytvořen z šablonu procesu, který je založen na buď Microsoft Solutions Framework (MSF) pro agilní vývoj softwaru nebo zlepšení schopností splatnosti modelu integrace (CMMI) procesu. Nicméně pokud váš plán maps týmu projektu, který byl vytvořen pomocí nástroje Visual Studio šablonu procesu Scrum, může být nutné odebrat některé výchozí mapování.Pokud vaše kolekce projektu obsahuje pouze týmové projekty, které byly vytvořeny pomocí šablony Scrum, obdržet při konfiguraci dvou serverové produkty k chybě.Nejlepších výsledků dosáhnete přidejte do pracovních položek, které máte v úmyslu mapovat dokončené práce (Microsoft.VSTS.Scheduling.CompletedWork) a původní odhad (Microsoft.VSTS.Scheduling.OriginalEstimate).Také je nutné se odebrat <EMPTY /> definice typu pracovního postupu příkazy z úkolu.Další informace naleznete v tématu požadované změny provést při mapování na týmu projektu, aby byl vytvořen z the šablonu procesu Scrum.

Následující tabulka popisuje výchozí mapování, které jsou přiřazeny k polím v Team Foundation.Můžete určit, jak má být odkaz a zrcadlení polí, která mají být aktualizovány.Můžete nastavit OnConflict k PSWins přepsat hodnotu v Team Foundation s hodnotou ze serveru Microsoft Office Project.Necháte-li OnConflict atribut tento parametr zadán, pole Udržovat různé hodnoty.Další informace naleznete pole elementy a atributy tabulce dále v tomto tématu.

Další informace o zrcadleného polí a proces synchronizace, naleznete v části Principy řízení aktualizací konkrétních polí.

Team Foundationpole	Pole projektu	Zobrazení pole na serveru Microsoft Office Project na kartě formulář pracovní položka (displayTfsField)	Zobrazení zrcadleného pole na serveru Microsoft Office Project na kartě formulář pracovní položka (displayTfsMirror)	Pole aktualizace (OnConflict)
Název	Název úlohy	Ne	Ne	Hodnota v serveru Microsoft Office Project nahradí nová hodnota v Team Foundation.
Přiřazeno	Prostředky	Ne	Ne	Hodnota v serveru Microsoft Office Project nahradí nová hodnota v Team Foundation.
Zbývající práce	Prostředek zbývající práce (stav fronty) Úloha zbývající práce (Project Server)	Ano	Ano	Každá hodnota je zachován.
Dokončené práce	Skutečná práce zdroje (stav fronty) Úloha skutečná práce (Project Server)	Ano	Ano	Každá hodnota je zachován.
Původní odhad	Směrného plánu	Ne	Ano	Hodnota v serveru Microsoft Office Project nahradí nová hodnota v Team Foundation.
Počáteční datum	Zdroj zahájit (stav fronty) Spuštění úlohy (Project Server)	Ne	Ne	Hodnota v serveru Microsoft Office Project nahradí nová hodnota v Team Foundation.
Koncové datum	Dokončit prostředků (stav fronty) Dokončení úkolu (Project Server)	Ne	Ne	Hodnota v serveru Microsoft Office Project nahradí nová hodnota v Team Foundation.

Je možné zobrazit další pole projektu na Project Server na kartě formuláře pracovních položek v Team Foundation Pokud přidat mapování polí.Další informace o této kartě naleznete v tématu Pole produktu Project Server přidaná do produktu TFS na podporu synchronizace dat.

Mapování elementů a atributů

Můžete použít field elementu, který chcete zadat odkaz na pole v Team Foundation pro synchronizaci.Všechny field elementy, které jsou obsaženy v mappingFile, persistables, a Microsoft.TeamFoundation.Sync.Mapping.Impls.FieldMapping kontejner elementů.

Důležité

Při připojování k serveru Microsoft Office Project pole ze sady TFS, ujistěte se, že můžete stejné datové typy z těchto polí.K následující chybě jinak, může se zobrazí při pokusu uložit mapování polí: Index (od nuly) musí být větší než nebo roven nule a menší než velikost seznamu argumentů. Další informace naleznete v tématu Omezení platná pro mapování polí produktu Project Server při integraci s produktem TFS.

Následující příklad ukazuje vnoření struktury elementů XML.Výchozí mapování naleznete v tématu výchozí mapování soubor dále v tomto tématu.

<mappingFile>
   <persistables>
      <Microsoft.TeamFoundation.Sync.Mapping.Impls.FieldMapping>
         <field tfsName="System.Title" tfsMirrorName="Mirror.System.Title" displayTfsField="false" displayTfsMirror="false" onConflict="PSWin">
            <tfsToTarget>
               <target provider="ProjectServerStatusQueue" name="pjTaskName" />
            </tfsToTarget>
            <targetToTfs>
               <target provider="ProjectServerPublished" name="pjTaskName" />
            </targetToTfs>
         </targetToTfs>
      </field>

         . . .

    </Microsoft.TeamFoundation.Sync.Mapping.Impls.FieldMapping>
  </persistables>
</mappingFile>

Syntaxe Element pole

Následující syntaxe definuje atributy field element:

<field tfsName="FieldName" tfsMirrorName="FieldMirrorName" displayTfsField="true | false" displayTfsMirror=" true | false" onConflict="PSWin">

Cílový Element syntaxe

Následující syntaxe definuje atributy target element:

<target provider="ProviderName" name="ProjectFieldName" />

Pokud chcete určit název pole, předpony zřetězených popisný název s "pj".Můžete například název pole pro správce stavu je pjStatusManager a názvu pole pro vlastní 01 je pjCustom01.

Pole prvky a atributy

Následující tabulka popisuje dílčí prvky a atributy field elementu.Můžete namapovat Team Foundation pole do pole zdrojů projektu jejíž hodnota, kterou chcete aktualizovat během synchronizace stavu.Můžete namapovat Team Foundation pole do pole úloha projektu aktualizujeme, jehož hodnota Team Foundation Server během publikování synchronizace.Jednotky pole, které můžete mapovat také, musí vyhovovat stanovených kritérií.Další informace naleznete v tématu Omezení platná pro mapování polí produktu Project Server při integraci s produktem TFS.

Prvek	Atribut	Popis
field		Určuje v poli Team Foundation mapovat a mapovány pole.
	tfsName	Určuje název odkazu v poli Team Foundation pro synchronizaci.Je třeba zadat pole, která je definována v kolekce týmových projektů.Je možné uvést všechna pole v kolekci spuštěním witadmin listfields příkazu.Další informace naleznete v tématu Správa polí pracovních položek [witadmin].
	tfsMirrorName	Požadováno.Určuje název odkazu, pod kterou pro uložení hodnoty v poli Project Server Team Foundation Server.Předpona, název odkazu s "Zrcadlení." Můžete například zadat Mirror.System.Title pro System.Title. [!POZNÁMKA] Zrcadlení pole, které zadáte jsou vytvářeny automaticky.Nemáte k přidání zrcadlení polí do definice typu pracovní položky.
	displayTfsField	Volitelné.Ve výchozím nastavení je tento atribut nastaven na true.Pokud tento atribut je nastaven na true, pole se zobrazí na Project Server karty formulář pracovní položka v Team Foundation.Pokud tento atribut je nastaven na false, pole ve formuláři nezobrazí.Ve výchozím nastavení pouze dokončené a zbývající práce pole se objeví ve formuláři.
	displayTfsMirror	Volitelné.Ve výchozím nastavení je tento atribut nastaven na true.Pokud tento atribut je nastaven na true, pole se zobrazí na Project Server karty formulář pracovní položka v Team Foundation.Pokud tento atribut je nastaven na false, pole ve formuláři nezobrazí.
	onConflict	Volitelné.Určuje, jak modul Synchronizace aktualizuje pole odkazu.Jediná platná hodnota je PSWin. Když tento atribut je nastaven na PSWin, bude aktualizována hodnota odkaz na pole, pokud aktuální hodnotu, která je publikována ze serveru Project Server se liší od hodnoty v zrcadlení. Pokud tento atribut nedefinují, určíte, že by měl být zachována dvou sad knih.Jinými slovy, je hodnota v projektu se může lišit od hodnoty v Team Foundation.Ve výchozím nastavení nahradí hodnoty v projektu vždy hodnoty polí Title, přiřazeno, počáteční datum a koncové datum.Ve výchozím nastavení jsou zachovány pouze pole dokončené a zbývající práce se dvěma sadami knih.Další informace naleznete v tématu aktualizuje pole že obsahovat hodin.
tfsToTarget		Určuje název pole v projektu, který Team Foundation bude aktualizován.
target		Určuje cíl, který má získávat aktualizace z Team Foundation.
	provider	Určuje název zprostředkovatele aktualizace.Pro tfsToTarget, je platný pouze hodnota ProjectServerStatusQueue.
	name	Určuje název pole projektu, který bude aktualizován s hodnotou v Team Foundation.Lze mapovat pouze integrované nebo enterprise vlastní pole v serveru Microsoft Office Project.Seznam dostupných polí naleznete v tématu Omezení platná pro mapování polí produktu Project Server při integraci s produktem TFS.
targetToTfs		Určuje mapování pole synchronizovat aktualizace serveru Microsoft Office Project s Team Foundation Server.
target		Určuje cíl, který má přijímat aktualizace ze serveru Microsoft Office Project.
	provider	Určuje název zprostředkovatele aktualizace.Pro targetToTfs, je platný pouze hodnota ProjectServerPublished.
	name	Určuje název pole v projektu, který bude aktualizovat pole v Team Foundation.Lze mapovat pouze integrované nebo enterprise vlastní pole.Seznam dostupných polí naleznete v tématu Omezení platná pro mapování polí produktu Project Server při integraci s produktem TFS.
transforms		Volitelné.Element kontejneru pro transform elementu.
transform	transformType	Určuje typ transformaci, kterou chcete použít na pole.Můžete zadat jen transformType pro targetToTfs a pouze pro typy číselného pole.Jediná platná hodnota je ClearValueIfParent. Zjistí-li modul Synchronizace hierarchii pod pracovní položky, který je synchronizován se serverem Project Server, provede souhrnné pro práci a přiřazení k odeslání do serveru Microsoft Office Project.Nicméně s transformType nastavena na ClearValueIfParent, modul Synchronizace vymaže pole práce na nadřazená pracovní položka v Team Foundation Server a vyhnout se tak chybná data ve standardním Team Foundation Server sestavy.

Výchozí mapování

Následující kód uvádí výchozí mapování pole, které jsou definovány při spuštění TfsAdmin ProjectServer /UploadFieldMappings příkaz a zadejte /useDefaultFieldMappings možnost.Můžete stáhnout tato mapování do souboru a potom do ní přidejte elementy nebo upravit atributy uvedených polích.

Seznam všech polí, které jsou přidány na typ pracovní položky po přidání tohoto typu k účasti v synchronizaci dat naleznete v tématu Pole produktu Project Server přidaná do produktu TFS na podporu synchronizace dat.

<mappingFile>
  <persistables>
    <Microsoft.TeamFoundation.Sync.Mapping.Impls.FieldMapping>
      <field tfsName="System.Title" tfsMirrorName="Mirror.System.Title" displayTfsField="false" displayTfsMirror="false" onConflict="PSWin">
        <tfsToTarget>
          <target provider="ProjectServerStatusQueue" name="pjTaskName" />
        </tfsToTarget>
        <targetToTfs>
          <target provider="ProjectServerPublished" name="pjTaskName" />
        </targetToTfs>
      </field>
      <field tfsName="System.AssignedTo" tfsMirrorName="Mirror.System.AssignedTo" displayTfsField="false" displayTfsMirror="false" onConflict="PSWin">
        <tfsToTarget>
          <target provider="ProjectServerStatusQueue" name="pjTaskResourceNames" />
        </tfsToTarget>
        <targetToTfs>
          <target provider="ProjectServerPublished" name="pjTaskResourceNames" />
        </targetToTfs>
      </field>
      <field tfsName="Microsoft.VSTS.Scheduling.CompletedWork" tfsMirrorName="Mirror.Microsoft.VSTS.Scheduling.CompletedWork" displayTfsField="true" displayTfsMirror="true">
        <tfsToTarget>
          <target provider="ProjectServerStatusQueue" name="pjResourceActualWork" />
        </tfsToTarget>
        <targetToTfs>
          <target provider="ProjectServerPublished" name="pjTaskActualWork" />
            <transforms>
               <transform transformType="clearValueIfParent">
            </transforms>
        </targetToTfs>
      </field>
      <field tfsName="Microsoft.VSTS.Scheduling.RemainingWork" tfsMirrorName="Mirror.Microsoft.VSTS.Scheduling.RemainingWork" displayTfsField="true" displayTfsMirror="true">
        <tfsToTarget>
          <target provider="ProjectServerStatusQueue" name="pjResourceRemainingWork" />
        </tfsToTarget>
        <targetToTfs>
          <target provider="ProjectServerPublished" name="pjTaskRemainingWork" />
            <transforms>
               <transform transformType="clearValueIfParent">
            </transforms>
        </targetToTfs>
      </field>
      <field tfsName="Microsoft.VSTS.Scheduling.OriginalEstimate" tfsMirrorName="Mirror.Microsoft.VSTS.Scheduling.OriginalEstimate" displayTfsField="false" displayTfsMirror="true" onConflict="PSWin">
        <targetToTfs>
          <target provider="ProjectServerPublished" name="pjTaskBaselineWork" />
        </targetToTfs>
      </field>
      <field tfsName="Microsoft.VSTS.Scheduling.StartDate" tfsMirrorName="Mirror.Microsoft.VSTS.Scheduling.StartDate" displayTfsField="false" displayTfsMirror="false" onConflict="PSWin">
        <tfsToTarget>
          <target provider="ProjectServerStatusQueue" name="pjResourceStart" />
        </tfsToTarget>
        <targetToTfs>
          <target provider="ProjectServerPublished" name="pjTaskStart" />
        </targetToTfs>
      </field>
      <field tfsName="Microsoft.VSTS.Scheduling.FinishDate" tfsMirrorName="Mirror.Microsoft.VSTS.Scheduling.FinishDate" displayTfsField="false" displayTfsMirror="false" onConflict="PSWin">
        <tfsToTarget>
          <target provider="ProjectServerStatusQueue" name="pjResourceFinish" />
        </tfsToTarget>
        <targetToTfs>
          <target provider="ProjectServerPublished" name="pjTaskFinish" />
        </targetToTfs>
      </field>
    </Microsoft.TeamFoundation.Sync.Mapping.Impls.FieldMapping>
  </persistables>
</mappingFile>

Viz také

Referenční dokumentace

Správa mapování polí pro integraci produktů TFS a Project Server

Koncepty

Omezení platná pro mapování polí produktu Project Server při integraci s produktem TFS

Pole produktu Project Server přidaná do produktu TFS na podporu synchronizace dat

Správa integrace produktů Team Foundation Server a Project Server

Další zdroje

Přizpůsobení mapování polí mezi produkty TFS a Microsoft Project