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

Článek
06/10/2015

K synchronizaci dat mezi podnikový plán projektu a týmový projekt, je nutné přidružit pole pracovní položku v Visual Studio Team Foundation Server (TFS) s polí v aplikaci Microsoft Project Server.Můžete přidat pole a zadejte způsob synchronizace přizpůsobením mapování polí.Můžete mapovat integrovaných a vlastních polí v projektu.Například můžete sdílet data, která se nevztahuje na plány (například nákladových středisek, názvy týmů nebo stav) Pokud, přidejte pole, které ukládají tyto typy dat k mapování.

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.Je nutné definovat mapování polí pro každé kolekce týmových projektů, které jsou namapovány na instanci aplikace Microsoft Office Project nebo projektu webové aplikace (PWA).Můžete nahrát výchozí mapování, nebo můžete upravit soubor mapování a pak ji nahrajte.Pokud chcete uložit výchozí mapování, naleznete v části nahrát mapování dále v tomto tématu.

[!POZNÁMKA]

Mapování pro integraci sady TFS a Project Server se liší od souboru mapování pro Microsoft Project.Další informace naleznete v tématu Přizpůsobení souboru mapování polí produktu Microsoft Project.

Jak ukazuje na následujícím obrázku, můžete upravit mapování v pět kroků:

Přizpůsobení pole mapování mezi Team Foundation Server a Project Server

Pracovní postup k přizpůsobení mapování polí PS TFS

[!POZNÁMKA]

Můžete aktualizovat soubor mapování tak často, jak chcete.Pole, které se zobrazují na Project Server kartě jsou aktualizovány pro každý typ pracovní položky, který je použit v synchronizaci dat.Nesmíte změnit ručně definice pro Project Server karty.Další informace naleznete v tématu vlastní nastavení na kartě Project Server dále v tomto tématu.

V tomto tématu

Výchozí mapování
Zjistit další pole pro mapování
Stáhnout mapování do souboru
Mapování aktualizace
Nahrát mapování
(Volitelné) Vlastní nastavení na kartě Project Server

[!POZNÁMKA]

Video ukázku, najdete na následující stránce webu společnosti Microsoft: správu mapování polí pro integraci Team Foundation Server a Project Server.

Požadavky

Chcete-li dokončit postupy v tomto tématu, musíte mít spravovat Project Server integration oprávnění nastaven na hodnotu povolit.Kromě toho účet služby pro Team Foundation Server musí mít udělena spravovat Project Server integration.Další informace naleznete v tématu Přiřazení oprávnění na podporu integrace produktů TFS a Project Server.

Výchozí mapování

Mapování určit, která pole získat synchronizovány, když uživatel aktualizuje informace v Team Foundation nebo serveru Microsoft Office Project.Každý z následujících typů synchronizace obsahuje vlastní sadu mapování:

Pro publikování synchronizace, data v serveru Microsoft Office Project aktualizuje data v Team Foundation.Můžete použít targetToTfs element určete pole, v serveru Microsoft Office Project, která aktualizuje pole v Team Foundation.
Pro stav synchronizace, data v Team Foundation je odeslána do fronty stav serveru Microsoft Office Project.Můžete použít tfsToTarget elementu, který chcete určete pole, které aktualizuje pole Stav fronty v serveru Microsoft Office Project.

Další informace o tyto dva typy synchronizace, naleznete v části Přehled procesu synchronizace pro integraci produktů TFS a Project Server.

V následující tabulce jsou uvedeny výchozí sadu polí, které jsou mapovány mezi Team Foundation a Project Server.V tabulce také indikuje, jaké typy pracovních položek použít pole, v závislosti na výchozí šablony procesu, které poskytuje sady TFS.Tato mapování byste neměli měnit, pokud je mapován týmový projekt, který byl vytvořen z šablonu procesu, který je založen na agilní vývoj softwaru nebo zlepšení schopností splatnosti modelu integrace (CMMI) procesu.Pokud je mapován týmový projekt, který byl vytvořen z šablonu procesu Scrum, je nutné provést určité úpravy jako požadované změny provést při mapování týmu projektu který byl vytvořen z the šablonu procesu Scrum popisuje dále v tomto tématu.

Další informace o mapování a proces synchronizace naleznete v tématu Referenční dokumentace k elementům XML mapování polí pro integraci produktů TFS a Project Server.

Team Foundationpole	Pole Project Server	Pole Stav fronty	Pracovní položky typy agilní	Pracovní položky typy CMMI	Typy pracovních položek v procesu Scrum
Název	Název úlohy	Název	Všechny	Všechny	Všechny
Přiřazeno	Prostředky	Prostředky	Všechny	Všechny	Všechny
Dokončené práce	Úloha skutečná práce	Skutečná práce zdroje	Úloha	Úloha	Žádná
Zbývající práce	Úloha, zbývající práce	Zbývající práce zdroje	Úloha	Úloha	Úloha
Původní odhad	Směrného plánu		Úloha	Chyby, žádost o změnu, problém, požadavku, riziko a úloh	Žádná
Počáteční datum	Spuštění úlohy	Zdroj zahájit práci	Úloha a příběhu uživatele	Úloha a požadavek	Žádná
Datum dokončení	Dokončení úkolu	Dokončit prostředku	Úloha a příběhu uživatele	Úloha a požadavek	Žádná

Chcete-li při mapování do týmového projektu, který byl vytvořen z šablonu procesu Scrum požadované změny

Existují dvě změny, je nutné provést umožňují tok dat z týmový projekt vytvořen z Microsoft Visual Studio Scrum šablonu procesu.Je třeba přidat pole dokončené práce a původní odhad úkolu pracovní položky typu a je nutné odebrat prvky, které vyžadují pole zbývající práce a být prázdný, když člen týmu změní stav, který má provést nebo odebrané.

Chcete-li aktualizovat definice typu úloh Scrum

Otevřete okno příkazového řádku, kde je nainstalována buď aplikace Visual Studio, nebo Průzkumník týmových projektů, a zadejte:
```
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
```
Na 32bitovou verzi systému Windows, nahradit %programfiles(x86)% s %programfiles%.
Exportovat definici typu pro úlohu, zadejte následující příkaz a nahrazování dat pro argumenty, které jsou zde uvedeny, kde CollectionURL Určuje adresu URL kolekce týmových projektů ProjectName Určuje název týmového projektu definované v rámci kolekce, a "DirectoryPath\FileName.xml" Určuje název a umístění souboru pro export.Pak zvolte Enter.
```
witadmin exportwitd /collection: /p:"ProjectName" /n:"Task" /f:"DirectoryPath\FileName.xml"
```
V textovém editoru nebo v sadě Visual Studio otevřete exportovaný soubor.

V rámci FIELDS definice oddílu, přidejte tento fragment kódu před element pro zbývající práce:

<FIELD name="Completed Work" refname="Microsoft.VSTS.Scheduling.CompletedWork" type="Double" reportable="measure" formula="sum">
   <HELPTEXT>The number of units of work that have been spent on this task</HELPTEXT>
</FIELD>
<FIELD name="Original Estimate" refname="Microsoft.VSTS.Scheduling.OriginalEstimate" type="Double" reportable="measure" formula="sum">
   <HELPTEXT>Initial value for Remaining Work - set once, when work begins. </HELPTEXT>
</FIELD>

V rámci <WORKFLOW> oddílu, odeberte následující fragment kódu z obou <STATE value="Done"> a <STATE value="Removed"> definice:
```
<FIELD refname="Microsoft.VSTS.Scheduling.RemainingWork">
   <EMPTY />
</FIELD>
```

V rámci <FORM> oddílu, přidejte následující Control prvky:

<Control FieldName="Microsoft.VSTS.Scheduling.OriginalEstimate" Type="FieldControl" Label="Original Estimate:" LabelPosition="Left" />
<Control FieldName="Microsoft.VSTS.Scheduling.CompletedWork" Type="FieldControl" Label="Completed:" LabelPosition="Left" />

Soubor uložte a zavřete.

Importuje soubor, nahrazení dat pro argumenty, které jsou uvedeny.

witadmin importwitd /collection: /p:"ProjectName" /f:"DirectoryPath\FileName.xml"

Aktualizace vašeho týmového projektu nebo pracovních položek stránky Chcete-li ověřit změny.

Další informace naleznete v tématu Export a import typů pracovních položek [přesměrováno], Úprava nebo přidání pole na podporu dotazů, sestav a pracovních postupů a Návrh a přizpůsobení formuláře pracovní položky [přesměrováno].

Zjistit další pole pro mapování

Určete následující informace pro každé pole, které chcete synchronizovat kromě polí jako výchozí:

Název odkazu pole v Team Foundation.Pokud chcete synchronizovat na pole v serveru Microsoft Office Project s pole, které je nutné vytvořit v Team Foundation, nejprve vytvořit pole v každého typu pracovní položky, které jsou synchronizace.Další informace naleznete v tématu Referenční dokumentace polí pracovních položek pro Visual Studio ALM a Úprava nebo přidání pole na podporu dotazů, sestav a pracovních postupů.
Název pole na serveru Project Server, který bude aktualizovat pole v Team Foundation.Seznam dostupných polí naleznete v tématu Omezení platná pro mapování polí produktu Project Server při integraci s produktem TFS.
Název pole v k aktualizaci v serveru Microsoft Office Project a názvu pole v Project Server, který bude aktualizovat pole zrcadlení v Team Foundation Server bude aktualizován.
Určuje, zda chcete-li zobrazit pole ve formuláři pracovní položky.Nastavte hodnotu displayTfsField atribut true pro pole, které se mají zobrazit ve formuláři pracovní položku.Nastavte hodnotu displayTfsMirror atribut true pro pracovní položku formulář.
Zda se má vyřešit konflikty dat tím, že hodnota v poli Team Foundation přepsat hodnotu v poli Project Server nebo udržovat obě hodnoty.Toto rozhodnutí určuje hodnotu onConflict atributu.Při onConflict=”PsWins” je nastavena hodnota v poli Project Server přepíše hodnotu v poli Team Foundation.Další informace naleznete v tématu pole elementy a atributy.
Další hodnoty, které je nutné definovat pro podporu vyberte seznamy nebo vlastní vyhledávací tabulky v serveru Microsoft Office Project.

Omezení týkající se data, která lze mapovat

Po určení pole, která chcete mapovat Poznámka: následující omezení:

Pouze úloha informace na úrovni, pjTask * pole, můžete odeslat ze serveru Microsoft Office Project k Team Foundation Server.
Informace o pouze úroveň prostředků, pjResource * pole, můžete odeslat z Team Foundation Server do fronty stav serveru Microsoft Office Project.
Název pole je pouze pole, které můžete odeslat na Team Foundation Server a do fronty stav.
Souhrn je vypočtena automaticky pro pole Přiřazeno, dokončené práce a zbývající práce.Nelze mapovat další pole a mít souhrn započítána pro ně.Další informace naleznete v tématu Práce se zahrnutím prostředků v podnikových projektech namapovaných na týmové projekty.
Ujistěte se, že datových typů nebo jednotky každé pole, které můžete mapovat odpovídat kritériím mapování pole pro pole standardní a vlastní organizace.Další informace naleznete v části "Datové typy a pole mapování kritéria" v Omezení platná pro mapování polí produktu Project Server při integraci s produktem TFS.
Můžete mapovat pole, které jsou přidruženy k seznamů pro výběr v Team Foundation.Nicméně je nutné vytvořit vyhledávací tabulky v serveru Microsoft Office Project k porovnání seznamů pro výběr.Nelze automaticky synchronizovat seznamů pro výběr a vyhledávací tabulky.

Další informace naleznete v tématu Omezení platná pro mapování polí produktu Project Server při integraci s produktem TFS.

Příklad: mapování název týmu zobrazit v projektu

V následujícím příkladu vlastní řetězec pole v Team Foundation, MyCompany.MyOrg.DevTeamName, je mapován na pole vlastní text organizace na serveru projektu, název týmu mé společnosti.V tomto příkladu slouží k zobrazení v aplikaci Project Professional název týmu, který je přidružen k úkolu.

<field tfsName="MyCompany.MyOrg.DevTeamName" tfsMirrorName="Mirror.MyCompany.MyOrg.DevTeamName" displayTfsField="false" displayTfsMirror="false" onConflict="DoNothing">
   <tfsToTarget>
   <target provider="ProjectServerStatusQueue" name=" My Company Team Name" />
   </tfsToTarget>
   <targetToTfs>
      <target provider="ProjectServerPublished" name=" My Company Team Name" />
   </targetToTfs>
</field>

Žádná pole se zobrazí ve formuláři pracovní položky.Také pokud hodnoty neshodují, každé pole zachová svou vlastní hodnotu.

Zpět na začátek

Příklad: zobrazování oblasti a iterace cesty v projektu

Můžete mapovat oblasti (System.AreaPath) a iteraci (System.IterationPath) pole v Team Foundation tak, aby se zobrazují v plánů projektu.Vzhledem k tomu, že tato pole Cesta stromu často měnit, by měl jejich namapování jako textová pole, v projektu.Cesta k plné oblasti nebo cesta k iteraci, musí ručně zadat projektovými manažery, kteří používají tato pole.

Důležité
Aktuální implementaci Team Foundation Server a Project Server integration nepodporuje automatickou synchronizaci povolená hodnota seznamů, vyberte seznamů, globální seznamy nebo seznamy cesta stromu, které jsou definovány pro mapované pole mezi dvěma serverové produkty.Nejlepší prostředí, je třeba provést ručně zadané položky v plánu projektu, které se shodují s v Team Foundation.Pokud zadáte položku, který není platný, se zobrazí dialogové okno ověření při publikování plánu.

Aktuální implementaci Team Foundation Server a Project Server integration nepodporuje automatickou synchronizaci povolená hodnota seznamů, vyberte seznamů, globální seznamy nebo seznamy cesta stromu, které jsou definovány pro mapované pole mezi dvěma serverové produkty.Nejlepší prostředí, je třeba provést ručně zadané položky v plánu projektu, které se shodují s v Team Foundation.Pokud zadáte položku, který není platný, se zobrazí dialogové okno ověření při publikování plánu.

Chcete-li přidat pole oblasti a iterace do plánu projektu, proveďte následující akce:

Přidejte dvě pole organizace zákazníka do serveru Microsoft Office Project a označte je jako oblasti (TFS) a iteraci (TFS).

Další informace získáte na následující stránce webu společnosti Microsoft: vytváření vyhledávací tabulky a vlastní pole organizace.
Exportujte mapování polí z kolekce týmových projektů, kde jsou definovány týmové projekty.

Další informace naleznete v tématu stáhnout mapování do souboru dále v tomto tématu.

Přidejte do souboru následující kód:

<field tfsName="System.AreaPath" tfsMirrorName="Mirror.System.AreaPath" displayTfsField="true" displayTfsMirror="true">
        <tfsToTarget>
          <target provider="ProjectServerStatusQueue" name="Area (TFS)" />
        </tfsToTarget>
        <targetToTfs>
          <target provider="ProjectServerPublished" name="Area (TFS)" />
        </targetToTfs>
      </field>
      <field tfsName="System.IterationPath" tfsMirrorName="Mirror.System.IterationPath" displayTfsField="true" displayTfsMirror="true">
        <tfsToTarget>
          <target provider="ProjectServerStatusQueue" name="Iteration (TFS)" />
        </tfsToTarget>
        <targetToTfs>
          <target provider="ProjectServerPublished" name="Iteration (TFS)" />
        </targetToTfs>
      </field>

Importovat soubor mapování aktualizované pole jako nahrát mapování popisuje dále v tomto tématu.
Synchronizujte plánu projektu se serverem Project Server.
Přidat dva nové sloupce pro nové pole, oblasti (TFS) a iterace (TFS) do plánu projektu

Změny provedené oblasti a iteraci pole v Team Foundation bude možné synchronizovat se službou tato pole v plánu projektu.Také můžete aktualizovat tato pole v projektu a publikovat vaše změny Team Foundation Pokud určit hodnoty, které byly definovány v Team Foundation.

Zpět na začátek

Stáhnout mapování do souboru

[!POZNÁMKA]

Mapování můžete stáhnout pouze z kolekce týmových projektů, do kterého byl odeslán.Pokud chcete stáhnout výchozí mapování do souboru, musí nejprve nahrajete výchozí mapování, jak je popsáno v chcete uložit výchozí mapování dále v tomto tématu.Alternativně můžete zkopírovat obsah výchozí mapování.Další informace naleznete v tématu Referenční dokumentace k elementům XML mapování polí pro integraci produktů TFS a Project Server.

Chcete-li stáhnout mapování do souboru

Chcete-li spustit TfsAdmin příkazového řádku nástroj, otevřete okno příkazového řádku kde buď Visual Studio nebo Průzkumník týmových projektů je nainstalován a zadejte:
```
cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE
```
On a 64-bit edition of Windows, replace %programfiles% with %programfiles(x86)%..
Zadejte následující příkaz a poté zvolte možnost Enter.
```
TfsAdmin ProjectServer /DownloadFieldMappings /collection:tpcUrl /filePath:MappingFile
```
Nahradit tpcUrl s jednotným prostředků adresy URL týmu kolekce projektu a nahradit MappingFile s cestu a název souboru, který bude přizpůsobit.
Vyčkejte, než se zobrazí následující zpráva:

DownloadingMappingFileto Team Project CollectiontpcUrl.

You have successfully downloaded field mapping fileMappingFileto Team Project CollectiontpcUrl.

Aktualizovat mapování

Pro každé pole, které chcete přidat do souboru mapování, zadejte field elementu a jeho dílčí prvky a atributy.Další informace naleznete v tématu Referenční dokumentace k elementům XML mapování polí pro integraci produktů TFS a Project Server.

Nahrát mapování

Nahrát mapování pomocí UploadFieldMappings příkazu.Výchozí mapování mohou odesílat pomocí /usedefaultfieldmapping možnost.Jinak zadejte soubor, který obsahuje mapování elementů.

Chcete uložit výchozí mapování

Na příkazovém řádku zadejte následující příkaz a poté zvolte možnost ENTER.
```
TfsAdmin ProjectServer /UploadFieldMappings /collection:tpcUrl /usedefaultfieldmappings
```
Nahradit tpcUrl s adresou URL kolekce týmových projektů.
Vyčkejte, než se zobrazí následující zpráva:

Uploading default field mappings toCollectionUri.

You have successfully uploaded field mappings to collectionCollectionUri.

Chcete uložit mapování ze souboru

Na příkazovém řádku zadejte následující příkaz a poté zvolte možnost ENTER.
```
TfsAdmin ProjectServer /UploadFieldMappings /collection:tpcUrl /filePath:MappingFile /force
```
Nahradit tpcUrl s adresou URL kolekce týmových projektů a nahradit MappingFile se cesta a název souboru vlastní mapování.Zadejte /force při aktualizaci stávajících mapování.
Vyčkejte, než se zobrazí následující zpráva:

UploadingMappingFileto Team Project CollectiontpcUrl.

You have successfully uploaded field mapping fileMappingFileto Team Project CollectiontpcUrl.

Vlastní nastavení na kartě Project Server

Pokud přidružíte podnikový plán projektu týmový projekt, na kartě Project Server je přidán formulář pracovní položky, jako na následujícím obrázku je znázorněno.Na kartě je přidán do pouze tyto typy pracovních položek, které určují k účasti v synchronizaci dat.Na této kartě můžete upravit tak, že nastavíte displayTfsField nebo displayTfsMirror atributů true pro tato pole, které chcete zobrazovat ve formuláři.

Karta Project Server

Karta Server výchozí pole projektu

Důležité
Pole, které se zobrazují v určení mapování pole, které jsou definovány pro kolekce týmových projektů Project Server kartu.Po přidání na této kartě na typ pracovní položky pro týmový projekt, můžete ji aktualizovat úpravou mapování polí pro kolekci.Pokud ručně přizpůsobit přidáním pole do formulář pracovní položka Project Server kartu nebo změnit jeho umístění ve formuláři, na kartě nesmíte získat automaticky aktualizován budoucí změny, které provedete mapování polí.Je-li k tomuto stavu dochází, můžete upravit kartu ručně.Další informace naleznete v tématu Elementy XML přidané do definice pro typ pracovní položky.

Pole, které se zobrazují v určení mapování pole, které jsou definovány pro kolekce týmových projektů Project Server kartu.Po přidání na této kartě na typ pracovní položky pro týmový projekt, můžete ji aktualizovat úpravou mapování polí pro kolekci.Pokud ručně přizpůsobit přidáním pole do formulář pracovní položka Project Server kartu nebo změnit jeho umístění ve formuláři, na kartě nesmíte získat automaticky aktualizován budoucí změny, které provedete mapování polí.Je-li k tomuto stavu dochází, můžete upravit kartu ručně.Další informace naleznete v tématu Elementy XML přidané do definice pro typ pracovní položky.

Další informace o každé výchozí pole, které se zobrazí na Project Server kartu, naleznete v tématu Pole produktu Project Server přidaná do produktu TFS na podporu synchronizace dat.

Viz také

Úkoly

Konfigurace integrace produktů TFS a Project Server

Koncepty

Určení typů pracovních položek, které se mají synchronizovat

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

Sdílet prostřednictvím