Sdílet prostřednictvím

Pole mapování Odkaz Element XML pro integraci Team Foundation Server a serveru Project Server

  • Článek

Vlastní nastavení mapování polí, můžete definovat, která pole v Visual Studio Team Foundation Server 2012 a Microsoft Project Server by mělo zůstat synchronizovány a pole, která jsou aktualizovány v stav fronty serveru Microsoft Project a v Team Foundation.

[!POZNÁMKA]

Mapování polí pro integraci Team Foundation Server se serverem Project Server se liší od souboru mapování pro Microsoft Project.Informace o druhém souboru naleznete v tématu Soubor mapování pole Microsoft Project.

Můžete spravovat jednu sadu mapování polí pro jednotlivé kolekce týmového projektu, který hostitelů týmové projekty, které chcete synchronizovat se serverem Project Server.Načíst mapování polí, můžete stáhnout do souboru z kolekce.Po úpravě souboru můžete odeslat do kolekce a změny budou použity pro všechny týmové projekty, které jsou definovány pro tuto kolekci.Další informace o stažení nebo Uložit mapování polí naleznete v Přizpůsobení mapování polí mezi produkty Project Server a Team Foundation Server.

V tomto tématu

  • Povinná pole

  • Výchozí pole, která jsou mapována

  • Mapování elementů a atributů

  • Výchozí mapování polí

Povinná pole

Podpora synchronizace dat musí být mapována následující pole.Pokud jste přizpůsobili pole, které se používají k plánování práce, je nutné upravit mapování pole odkaz na pole, které používáte.

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

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

  • Pole, sledovat zahájení práce v Team Foundation musí být mapována na pjTaskStart.Toto pole je ve výchozím nastavení Microsoft.VSTS.Scheduling.StartDate.

  • Pole, které slouží ke sledování dokončení práce v Team Foundation musí být mapována na pjTaskFinish.Toto pole je ve výchozím nastavení Microsoft.VSTS.Scheduling.FinishDate.

Zpět na začátek

Výchozí pole, která jsou mapována

Pro každé pole v Team Foundation, můžete zadat dvě mapování.V první mapování určete pole v projektu, která pole v Team Foundation aktualizace ve frontě stavu.V druhém mapování určit pole v projektu, který aktualizuje pole v Team Foundation.Kromě toho můžete určit zda pole v Team Foundation na formulář pracovní položky a jak jsou aktualizovány referenční a zrcadleného pole se zobrazí.

Standardně všechna pole projektu, které jsou mapovány jsou také zrcadlené, což znamená, že jejich hodnoty jsou uloženy v Team Foundation.

Důležitá poznámkaDůležité

Ve většině konfigurací neměli odebírat výchozí mapování pole, protože vyžaduje proces synchronizace.Výchozí mapování například neodstraňujte, pokud týmového projektu, který byl vytvořen z šablonu procesu, který je založen na buď Microsoft Solutions Framework (MSF) agilní vývoj softwaru nebo zlepšení procesu schopnosti splatnost Model integrace (CMMI) mapuje plánu projektu organizace.

Nicméně pokud váš plán mapy týmu projektu, který byl vytvořen pomocí Visual Studio Scrum šablonu procesu, může být nutné odebrat některé výchozí mapování.Kolekce projektu obsahuje pouze týmové projekty, které byly vytvořeny pomocí šablony Scrum, obdržíte chybu při konfiguraci dvou serverových produktů.Nejlepších výsledků přidáte pracovní položky, které chcete mapovat dokončení práce (Microsoft.VSTS.Scheduling.CompletedWork) a původní odhad (Microsoft.VSTS.Scheduling.OriginalEstimate).Také budete muset k odebrání <EMPTY /> definice typu pracovní příkazy z úkolu.Další informace naleznete v Požadované změny proveďte při mapování týmu projektu, byl vytvořen z Scrum šablonu procesu.

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 chcete odkaz a zrcadlení pole aktualizovat.Můžete nastavit OnConflict na PSWins přepsat hodnotu v Team Foundation s hodnotou ze serveru Project Server.Pokud ponecháte OnConflict určen atribut pole udržovat různé hodnoty.Další informace naleznete pole elementů a atributů tabulce dále v tomto tématu.

Další informace o zrcadlených polí a procesu synchronizace naleznete v Principy řízení aktualizací konkrétních polí.

Pole Team Foundation

Pole projektu

Zobrazení pole na kartě Project Server formulář pracovní položka (displayTfsField)

Pole zrcadleného zobrazení na kartě Project Server formulář pracovní položka (displayTfsMirror)

Aktualizace pole (OnConflict)

Title

Název úkolu

Ne

Ne

Hodnota v serveru Project Server nahradí hodnotu v Team Foundation.

Přiřazeno

Zdrojích

Ne

Ne

Hodnota v serveru Project Server nahradí hodnotu v Team Foundation.

Zbývající práce

Prostředek zbývající práce (stav fronty)

Úkol zbývající práce (Project Server)

Ano

Ano

Každá hodnota je zachována.

Dokončené práce

Zdroj skutečné práce (stav fronty)

Úkol skutečné práce (Project Server)

Ano

Ano

Každá hodnota je zachována.

Původní odhad

Práce podle směrného plánu

Ne

Ano

Hodnota v serveru Project Server nahradí hodnotu v Team Foundation.

Datum zahájení

Start prostředku (stav fronty)

Zahájení (Project Server)

Ne

Ne

Hodnota v serveru Project Server nahradí hodnotu v Team Foundation.

Koncové datum

Dokončení prostředku (stav fronty)

Dokončení úkolu (Project Server)

Ne

Ne

Hodnota v serveru Project Server nahradí hodnotu v Team Foundation.

Můžete zobrazit více polí projektu na Project Server kartě formulář pracovní položka v Team Foundation Pokud přidat mapování polí.Další informace o této kartě naleznete v tématu Pole aplikace Project Server přidána podpora synchronizace dat.

Zpět na začátek

Mapování elementů a atributů

Použití field prvku určit referenční pole v Team Foundation k synchronizaci.Všechny field prvky jsou obsaženy v mappingFile, persistables, a Microsoft.TeamFoundation.Sync.Mapping.Impls.FieldMapping prvky kontejneru.

Důležitá poznámkaDůležité

Při mapování pole z Team Foundation Server na server Project Server, ujistěte se, shodovat s typy dat těchto polí.Jinak následující chybová zpráva může zobrazit při pokusu o uložení mapování polí:

Index (nuly) musí být větší nebo rovna nule a menší než velikost seznamu argumentů.

Další informace naleznete v tématu Data Types and Field Mapping Criteria.

Následující příklad ukazuje strukturu vnořením elementů XML.Výchozí mapování naleznete v tématu Výchozí mapování souboru 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>

Gg412657.collapse_all(cs-cz,VS.110).gifSyntaxe pole prvek

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

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

Gg412657.collapse_all(cs-cz,VS.110).gifCílový prvek syntaxe

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

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

Určit název pole, předponu popisný název spojených s "pj".Například je název pole Správce stavu pro pjStatusManager a pjCustom01 je název pole pro vlastní 01.

Zpět na začátek

Gg412657.collapse_all(cs-cz,VS.110).gifPole elementů a atributů

Následující tabulka obsahuje dílčí prvky a atributy field prvku.Mapování Team Foundation pole zdrojů pole jehož hodnotu chcete aktualizovat během synchronizace stavu projektu.Mapování Team Foundation pole pole úkolu projektu, jehož hodnota bude aktualizovat Team Foundation Server během publikování synchronizace.Také jednotky mapování polí musí odpovídat stanovených kritérií.Další informace naleznete v tématu Omezení mapování polí serveru Project Server pro integraci s Team Foundation Server.

Element

Atribut

Description

field

Určuje pole v Team Foundation namapovat a mapovány na pole.

tfsName

Určuje referenční název pole v Team Foundation k synchronizaci.Je třeba zadat pole, která je definována v kolekci týmového projektu.Můžete vytvořit seznam všech polí v kolekci spuštěním witadmin listfields příkaz.Další informace naleznete v tématu Správa polí pracovních položek [witadmin].

tfsMirrorName

Povinné.Určuje referenční název, pod kterým chcete ukládat hodnotu v poli Project Server Team Foundation Server.Předponu názvu odkazu s "Zrcadlo." Můžete například zadat Mirror.System.Title pro System.Title.

PoznámkaPoznámka
Zrcadlové pole, které zadáte, jsou automaticky vytvořeny.Není třeba přidat zrcadlo pole definice typu pracovní položky.

displayTfsField

Nepovinné.Ve výchozím nastavení je tento atribut nastaven na true.Pokud je tento atribut nastaven na true, pole se zobrazí na Project Server kartě formulář pracovní položka v Team Foundation.Pokud je tento atribut nastaven na false, pole na formuláři nezobrazí.Ve výchozím nastavení zobrazeny pouze dokončené práce a zbývající práce pole ve formuláři.

displayTfsMirror

Nepovinné.Ve výchozím nastavení je tento atribut nastaven na true.Pokud je tento atribut nastaven na true, pole se zobrazí na Project Server kartě formulář pracovní položka v Team Foundation.Pokud je tento atribut nastaven na false, pole na formuláři nezobrazí.

onConflict

Nepovinné.Určuje, jak modul synchronizace aktualizace referenční pole.Jediná platná hodnota je PSWin.

Pokud je tento atribut nastaven na PSWin, hodnota referenční pole je aktualizován při aktuální hodnota, který je publikován na serveru Project Server se liší od hodnot v zrcadlení.

Pokud tento atribut není definujete, označují se uchovávají dvě sady knih.Jinými slovy, hodnota v projektu může lišit od hodnoty v Team Foundation.Výchozí hodnoty v projektu vždy nahradit hodnoty pole Title, přiřazeno, počáteční datum a koncové datum.Ve výchozím nastavení jsou dvě sady knih udržovány pouze pole Dokončená práce a zbývající práce.Další informace naleznete v tématu Aktualizace pole obsahující hodin.

tfsToTarget

Určuje název pole v projektu, Team Foundation bude aktualizovat.

target

Určuje cílový přijímat aktualizace z Team Foundation.

provider

Určuje název poskytovatele aktualizace.Pro tfsToTarget, jediná platná hodnota je ProjectServerStatusQueue.

name

Určuje název pole projektu, který bude aktualizován s hodnotou v Team Foundation.Lze mapovat pouze integrovaný nebo organizace vlastní pole na serveru Project Server.Seznam dostupných polí, viz Fields Available for Mapping to the Status Queue.

targetToTfs

Určuje mapování pole synchronizovat aktualizace Project Server s Team Foundation Server.

target

Určuje cílový přijímat aktualizace ze serveru Project Server.

provider

Určuje název poskytovatele aktualizace.Pro targetToTfs, jediná platná hodnota je ProjectServerPublished.

name

Určuje název pole v projektu, který bude aktualizovat pole v Team Foundation.Lze mapovat pouze integrovaný nebo organizace vlastní pole.Seznam dostupných polí, viz Fields Available for Mapping from Project Server to Team Foundation Only.

transforms

Nepovinné.Element kontejner transform prvku.

transform

transformType

Určuje typ transformace pole.Můžete zadat pouze transformType pro targetToTfs a pouze pro typy číselných polí.Jediná platná hodnota je ClearValueIfParent.

Modul synchronizace zjistí hierarchii pod pracovní položku, která je synchronizována se serverem Project Server, provede shrnutí práce a přiřazení odeslat na server Project Server.Nicméně s transformType nastavena na ClearValueIfParent, modul Synchronizace vymaže pole práce na nadřazenou položku v Team Foundation Server zabránit nesprávná data ve standardním Team Foundation Server sestav.

Zpět na začátek

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 stahování těchto mapování do souboru a poté do ní přidat prvky nebo upravit atributy uvedených polích.

Seznam všech polí, které jsou přidány do typu pracovní položky při přidání typu k účasti v synchronizaci dat naleznete v tématu Pole aplikace Project Server přidána podpora 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>

Zpět na začátek

Viz také

Referenční dokumentace

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

Koncepty

Omezení mapování polí serveru Project Server pro integraci s Team Foundation Server

Pole aplikace Project Server přidána podpora synchronizace dat

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

Další zdroje

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