Správa typů propojení

  • Článek

Podobně jako typy pracovních položek, můžete definovat a upravovat vlastní typy odkazů.Nelze však provádět změny typů propojení definovaných systémem.Před přidáním nového typu odkazu do kolekce týmových projektů, zkontrolujte typy propojení, které jsou vám k dispozici.Viz téma Propojení pracovních položek pro podporu sledovatelnosti.

Typy odkazů definované pro kolekci týmového projektu můžete spravovat pomocí následujících příkazů witadmin:

  • deactivatelinktype:  Deaktivuje zadaný typ vazby.Uživatelé už nebudou nadále moci vytvářet odkazy tohoto typu.Existující odkazy tohoto typu budou nadále fungovat správně.

  • deletelinktype:  Trvale odstraní zadaný typ odkazu z databáze.Budou odebrány také všechny odkazy definované pomocí tohoto typu odkazu.

  • exportlinktype:  Exportuje definice typů propojení.Můžete exportovat definici jednoho typu propojení nebo všech typů propojení definovaných pro server.

  • importlinktype: Importuje definice typů odkazů ze souboru XML.Pokud typ propojení se stejným referenčním názvem již existuje, bude aktualizován tak, aby odpovídal typu importované vazby.Pokud typ odkazu ještě neexistuje, bude vytvořen nový typ odkazu.

  • listlinktypes: Zobrazí dostupnou sadu typů odkazů na serveru.

  • reactivatelinktype: Znovu aktivuje zadaný typ odkazu a volitelně přiřadí nový název.

Chcete-li spustit nástroj příkazového řádku witadmin, otevřete okno příkazového řádku, kde je nainstalován buď Visual Studio nebo Průzkumník týmových projektů a zadejte:

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

V 32bitové verzi systému Windows nahraďte %programfiles(x86)% za %programfiles%.

Požadavky

Pro kolekci týmového projektu, kde jsou definovány typy propojení, musíte mít následující sadu oprávnění:

  • Chcete-li zobrazit seznam typů propojení nebo je exportovat, musíte mít oprávnění Zobrazit informace na úrovni projektu pro týmový projekt v kolekci nastavena na Povolit.

  • Chcete-li odstranit, importovat nebo reaktivovat typy odkazů, musíte být členem skupiny zabezpečení Správci kolekce projektu nebo mít oprávnění Spravovat typy odkazů na pracovní položky nastaveno na možnost Povolit.

Další informace naleznete v tématu Oprávnění v prostředí Team Foundation Server a Výchozí skupiny, oprávnění a role serveru Team Foundation Server.

[!POZNÁMKA]

I v případě, že se přihlásíte s oprávněními správce, je nutné otevřít okno příkazového řádku se zvýšenými oprávněními, abyste tuto funkci mohli provést na serveru se systémem Windows Server 2008.Chcete-li otevřít okno příkazového řádku se zvýšenými oprávněními, zvolte nabídku Start, otevřete místní nabídku pro příkazový řádeka pak zvolte možnost Spustit jako správce. Další informace naleznete na webu společnosti Microsoft: Řízení uživatelského přístupu.

witadmin deactivatelinktype /collection:CollectionURL /n:LinkName

witadmin deletelinktype /collection:CollectionURL /n:LinkName [/noprompt]

witadmin exportlinktype /collection:CollectionURL [/n:LinkName] [/f:FileName] [/e:Encoding] 

witadmin importlinktype /collection:CollectionURL /f:FileName [/e:Encoding] [/v]

witadmin listlinktypes /collection:CollectionURL

witadmin reactivatelinktype /collection:CollectionURL /n:LinkName

Parametry

Parametr

Description

/collection:CollectionURL

Určuje URI kolekce týmového projektu.Formát identifikátoru URI je následující: http://ServerName:Port/VirtualDirectoryName/CollectionName

Příklad:

http://ServerName:8080/tfs/Collection0

Pokud není použit žádný virtuální adresář, formát identifikátoru URI bude následující:

http://ServerName:Port/CollectionName

/n:LinkName

Název nebo název odkazu typu odkazu pro deaktivování nebo odstranění.

/f:FileName

Soubor XML typů odkazů.Potřebné k importu, volitelné pro export.Pokud tento parametr vynecháte, zobrazí se na displeji výstup příkazu.

/e:encoding

Název formátu kódování .NET Framework 2,0.Uvedené kódování se použije k exportu nebo importu dat XML.Například /e:utf-7 určuje kódování Unicode (UTF-7).Pokud tento parametr vynecháte, witadmin se pokusí rozpoznat kódování, a pokud se nezdaří detekce, witadmin použije kódování UTF-8.

/v

Ověřuje typu odkazu XML bez importu.

/noprompt

Zakáže výzvu k potvrzení.

/? nebo help

Zobrazí nápovědu k příkazu v okně příkazového řádku.

Poznámky

Pro strukturu schématu definice typu spojení, viz Referenční dokumentace elementů typů propojení.

Informace o tom, jak můžete omezit typy vztahů propojení, které mohou členové týmu využívat, naleznete zde: Referenční dokumentace ovládacích prvků, omezení a polí propojení a LinksControlOptions – elementy.

Příklady

Pokud není uvedeno jinak, platí následující hodnoty v obou příkladech:

  • Adresa URI kolekce týmového projektu: http://AdventureWorksServer:8080/tfs/DefaultCollection

  • Název serveru: AdventureWorksServer

  • Název vstupního nebo výstupního souboru: myLinkTypes.xml

  • Název typu odkazu: mylinktype

  • Výchozí kódování: UTF-8

Seznam typů odkazů

Následující příkaz zobrazí příkazy pro typy vlastní vazby definované pro Team Foundation AdventureWorksServer.  

witadmin listlinktypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

Seznam definice typu odkazu

Následující příklad zobrazuje definici typu odkazu v okně příkazového řádku:

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

Deaktivovat a znovu aktivovat typ propojení

Následující příklady deaktivuje typ odkazu mylinktype, deaktivujte a poté ho znovu aktivuje:

witadmin deactivatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype
witadmin activatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype

Exportovat definici typu propojení

Následující příkaz exportuje definici všech typů odkazů do souboru mylinktype.xml:

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml

Import definice typů odkazů

Následující příklad importuje odkaz typů definovaných v souboru XML definice:

witadmin importlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml

Viz také

Koncepty

Referenční dokumentace elementů typů propojení

Referenční dokumentace ovládacích prvků, omezení a polí propojení

Další zdroje

Propojení pracovních položek pro podporu sledovatelnosti

witAdmin: Přizpůsobení a správa objektů pro sledování práce