Referenční dokumentace elementů FIELD (definice)
Můžete použít FIELD (definice) elementu, který chcete definovat pole pracovní položku a zadejte pravidly a podmínkami, které se vztahují k němu.Atributy, které můžete přiřadit k poli zjistěte, jak se zobrazí v formuláře pracovních položek a zda je k dispozici pro zařazení do sestavy.Můžete spravovat sadu přiřazení pole pro kolekci týmového projektu.Proto atributy, které přiřadíte do pole, které jsou definovány v jeden typ pracovní položky se musí shodovat všech typů pracovních položek pro všechny týmové projekty v kolekci.Kromě toho jsou všechna pole událostí podléhajících ze všech kolekcí vyexportovány do databáze datových skladů.
[!POZNÁMKA]
Informace o FIELD element (pracovního postupu), který použijete k určení pravidly a podmínkami k polím během přechod stavu změnit nebo pracovního postupu, naleznete v části FIELD (pracovní postup) – element.
Můžete změnit přiřazení atributů, které provedete na stávající pole pro kolekci pomocí witadmin nástroj pro příkaz.Další informace naleznete v tématu Správa polí pracovních položek [witadmin].
Schéma hierarchie
FIELD
<FIELD name="fieldDisplayName" refname="fieldReferenceName" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath | GUID" syncnamechanges ="true | false" reportable="Dimension | Detail | Measure" formula="sum" reportingname="ReportingDisplayName" reportingrefname="ReportingReferenceName" > <ALLOWEDVALUES> . . . </ALLOWEDVALUES> <ALLOWEXISTINGVALUE /> <CANNOTLOSEVALUE /> <COPY /> <DEFAULT /> <EMPTY /> <FROZEN /> <HELPTEXT> . . . </HELPTEXT> <MATCH /> <NOTSAMEAS /> <PROHIBITEDVALUES /> . . . </PROHIBITEDVALUES> <READONLY /> <REQUIRED /> <SERVERDEFAULT /> <SUGGESTEDVALUES /> . . . </SUGGESTEDVALUES> <VALIDUSER /> <WHEN> . . . </WHEN> <WHENNOT> . . . </WHENNOT> <WHENCHANGED> . . . </WHENCHANGED> <WHENNOTCHANGED> . . . </WHENNOTCHANGED> </FIELD>
Atributy a elementy
Následující části popisují atributy, podřízené prvky a nadřazené prvky.
Atributy
Atribut |
Popis |
||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
name |
Požadováno.Popisný název pole, které se zobrazí v rozevírací nabídky dotazů pracovní položku.Popisný název musí být jedinečné v rámci všechna pole, které jsou definovány v rámci týmový projekt.Popisný název se také mohou lišit od popisek, který se zobrazí vedle pole ve formuláři pracovní položky.Další informace naleznete v tématu Control – referenční dokumentace elementu XML. Typ atributu je typelib:FieldName.Minimální délka: 1; Maximální délka: 128. Hodnota vzorku: ^ [^ \.\[\]]+$ Příklad hodnoty vzor: přiřazená k |
||||||||||||||||||||
refname |
Požadováno.Jedinečný popisek, která odlišuje pole ze všech ostatních polí, které jsou definovány v kolekce týmových projektů. Další požadavky a omezení týkající se popisné názvy a názvy referenční informace naleznete v tématu Vytváření názvů pro objekty sledování pracovní položky. Typ atributu je typelib:ReferenceFieldName.Minimální délka: 1; Maximální délka: 70. Hodnota vzorku: ^[a-zA-Z_][a-zA-Z0-9_]* (\. [-zA-Z0-9_] +) + $ Příklad hodnoty vzor: Company.IssueType |
||||||||||||||||||||
type |
Požadováno.Určuje typ dat, které lze do pole zadat.
V následující tabulce jsou uvedeny platné hodnoty pro tento atribut:
|
||||||||||||||||||||
syncnamechanges |
Volitelné.Určuje, zda pole pracovní položky slouží k uložení názvy, které chcete aktualizovat, jakmile změny ve službě Active Directory nebo k pracovní skupině.Tato možnost je platný pouze při type="String".Typ atributu je xs:boolean. Zadejte true Chcete-li povolit synchronizaci pro pole dat, zadejte false zakázání synchronizace pro datové pole. |
||||||||||||||||||||
reportable |
Volitelné.Určuje, zda data z pole je k dispozici pro zařazení do sestavy.Pole s výchozí hodnotu None jsou vyexportovány do relační datového skladu ani zpracovaných SQL Server datové krychli služby Analysis Services.Další informace o událostí podléhajících polích naleznete v tématu Přidání a změna polí pracovních položek jako podpora tvorby sestav.
V následující tabulce jsou uvedeny platné hodnoty pro tento atribut:
|
||||||||||||||||||||
formula |
Volitelné.Typ agregace pro measure událostí podléhajících typu.Jediná platná hodnota je sum, která vrací součet hodnot v sadě. |
||||||||||||||||||||
reportingname |
Volitelné.Určuje název, který se zobrazí v sestavách.Pokud nezadáte hodnotu, hodnotu, která je přiřazena k name je použit atribut.
Typ atributu je typelib:FieldName.Minimální délka: 1; Maximální délka: 128. Hodnota vzorku: ^ [^ \.\[\]]+$ Příklad hodnoty vzor: přiřazená k |
||||||||||||||||||||
reportingrefname |
Volitelné.Určuje název odkazu, který se používá při zpracování událostí podléhajících pole.Pokud nezadáte hodnotu, hodnotu, která je přiřazena k refname je použit atribut. Tento atribut slouží ke sloučení nebo odchýlit pole, které jsou zpracovávány do datového skladu.Chcete-li sloučit dvě pole, které jsou definovány v kolekcích jiného projektu, které mají odlišné odkaz na názvy, je stejná přiřadit reportingrefname do obou z nich.O odchylce dvě pole, které mají stejný název odkazu, ale které jsou definovány v kolekcích jiného projektu, můžete přiřadit jinou reportingrefname do všech polí. Měli byste sloučit pole, pokud je to možné, chcete-li minimalizovat počet polí ve skladu a sledovat maximálního limitu 1024 událostí podléhajících polí.Můžete generovat sestavy různé skupiny se sloučené pole. Typ atributu je typelib:ReferenceFieldName.Minimální délka: 1; Maximální délka: 70. Hodnota vzorku: ^[a-zA-Z_][a-zA-Z0-9_]* (\. [-zA-Z0-9_] +) + $ Příklad hodnoty vzor: Company.IssueType |
Podřízené elementy
Prvek |
Popis |
|---|---|
Volitelné.Definuje seznam povolených hodnot pro pole.Povolené hodnoty jsou hodnoty, které jsou k dispozici pro výběr v seznamu polí ve formulářích pracovní položky a Tvůrce dotazů.Je třeba vybrat jednu z těchto hodnot. |
|
Volitelné.Definuje pole, které chcete povolit existující hodnoty.Tento element umožňuje hodnoty pole, které již existují mají být použity, i v případě, že nejsou platné.Všechny nové hodnoty polí musí být platný. |
|
Volitelné.Definuje pole jako nemůže dojít ke ztrátě hodnotu.Tento element zachová aktuální hodnota pole a nemůže být zrušeno nebo být prázdný. |
|
Volitelné.Určuje jiné pole, které obsahuje hodnotu, která mají být zkopírována do aktuálního pole. |
|
Volitelné.Definuje výchozí hodnotu pro pole. |
|
Volitelné.Definuje pole jako prázdný. |
|
Volitelné.Definuje pole jako zmrazené.Ukotvené pole nelze změnit na libovolnou hodnotu neprázdný, jakmile změny potvrzeny.Můžete však ručně vymažte pole, uložit s pracovní položkou a poté zadejte jinou hodnotu. |
|
Volitelné.Definuje text zobrazený v popisu tlačítka pro pole. |
|
Volitelné.Definuje základní vzor pro pole, která se musí shodovat s hodnotou pole. |
|
Volitelné.Určuje jiné pole, jehož hodnota nesmí být shodné s hodnotou aktuálního pole. |
|
Volitelné.Definuje seznam zakázaných hodnot pro pole. |
|
Volitelné.Definuje pole jen pro čtení. |
|
Volitelné.Definuje pole podle potřeby. |
|
Volitelné.Určuje součást serveru, který bude poskytovat hodnotu pro pole. |
|
Volitelné.Definuje seznam hodnot navržené pro pole.Navrhované hodnoty jsou hodnoty, které jsou k dispozici pro výběr v seznamu polí ve formulářích pracovní položky a Tvůrce dotazů.Navíc můžete zadat jiné hodnoty na ty v seznamu. |
|
Volitelné.Určuje, že seznam povolených hodnot musí obsahovat pouze platné uživatele systému. |
|
Volitelné.Určuje jedno nebo více pravidel, která má být použita pro aktuální pole, má-li jiné pole konkrétní hodnotu. |
|
Volitelné.Použije jeden nebo více pravidel na aktuální pole při změně hodnoty určitého pole. |
|
Volitelné.Použije jeden nebo více pravidel pro aktuální pole, pokud jiné pole nemá konkrétní hodnotu. |
|
Volitelné.Použije jeden nebo více pravidel pro aktuální pole, pokud hodnota konkrétní pole se nezmění. |
Nadřazené elementy
Prvek |
Popis |
|---|---|
Požadováno.Obsahuje definice pole Typ pracovní položky. |
Poznámky
FIELD(Definice) je povinný podřízený element elementu FIELDS (definice).
minOccurs = "1"
Můžete definovat pole více než 1 024 pracovních položek ve stejné kolekce týmových projektů a maximálně 1 024 pole můžete nastavit na událostí podléhajících ve všech kolekce týmových projektů.Další informace naleznete v tématu Přidání a změna polí pracovních položek jako podpora tvorby sestav.
[!POZNÁMKA]
Když přidáte existující pole na jiný typ pracovní položky, aktuální hodnoty událostí podléhajících atributy se používají.
Další požadavky a omezení týkající se pole pro tisk názvy a referenční informace naleznete v tématu Vytváření názvů pro objekty sledování pracovní položky.Informace o tom, jak popisek pole pro účely generování sestav naleznete v tématu Přidání a změna polí pracovních položek jako podpora tvorby sestav.
Nelze definovat vlastní pole, které začíná System. předpony.Pole můžete definovat pomocí Microsoft. předpony, tento postup je však doporučeno, protože by mohly bránit Team Foundation Server funkce.
Přehled pole pracovní položka sledování objektu naleznete v tématu Definování a úprava polí pracovní položky.
Přehled všech systému a předdefinované pole, které jsou definovány pro šablony procesů sady TFS, naleznete v části Referenční dokumentace polí pracovních položek pro Visual Studio ALM.
Odkaz na názvy polí nelze přejmenovat.Seznam polí, přejmenovat popisný název pole a změnit atributy pole pomocí witadmin nástroj příkazového řádku.Další informace naleznete v tématu Správa polí pracovních položek [witadmin].
Informace o tom, jak se používají pole v rámci kolekce týmových projektů naleznete v tématu Řešení konfliktů schémat, které se vyskytují v datovém skladu a Přidání a změna polí pracovních položek jako podpora tvorby sestav.
Příklad
<FIELD name="Activity" refname="Microsoft.VSTS.Common.Activity" type="String" reportable="dimension">
<HELPTEXT>Type of work involved</HELPTEXT>
<SUGGESTEDVALUES>
<LISTITEM value="Development"/>
<LISTITEM value="Testing"/>
<LISTITEM value="Requirements"/>
<LISTITEM value="Design"/>
<LISTITEM value="Deployment"/>
<LISTITEM value="Documentation"/>
</SUGGESTEDVALUES>
</FIELD>
Viz také
Referenční dokumentace
Správa polí pracovních položek [witadmin]
Koncepty
Vytváření názvů pro objekty sledování pracovní položky
Referenční dokumentace polí pracovních položek pro Visual Studio ALM
Přizpůsobení objektů pro sledování práce na podporu týmových procesů
Definování a úprava polí pracovní položky