Seznam polí a atributů pracovní položky

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Pole pracovních položek slouží ke sledování informací v Rámci Azure DevOps. Tato pole jsou definována na úrovni organizace a sdílí se napříč všemi projekty v organizaci. Pokud chcete zkontrolovat pole definovaná pro vaši organizaci, můžete použít jeden z následujících dvou nástrojů, které jsou k dispozici pro modely zděděných i hostovaných procesů XML:

• Webová stránka Pole procesu >
• Průzkumník polí pracovní položky

Popis každého pole definovaného systémovým procesem najdete v tématu Index polí pracovní položky.

Požadavky

Oprávnění: Chcete-li zobrazit pole definovaná pro organizaci nebo kolekci, být členem skupiny aplikace Project Collection Valid Users nebo mít oprávnění Zobrazit informace na úrovni instance nastavená tak, aby byla povolena pro organizaci nebo kolekci.

Seznam nebo kontrola polí

Pokud chcete zobrazit nebo zkontrolovat pole, použijte jeden z následujících nástrojů založený na modelu procesu – zděděný, hostovaný XML nebo místní XML. Index polí definovaných v rámci výchozích procesů najdete v tématu Index polí pracovní položky.

Nástroj	Dědičnost	Hostovaný XML	Místní XML
Webový portál: Seznam zděděných a vlastních definovaných polí	✔️	✔️1
Průzkumník polí pracovní položky	✔️	✔️	✔️
nástroj příkazového řádku witadmin listfields	✔️	✔️	✔️

Poznámka:

1. Podporuje se jenom pro výchozí procesy (Agile, CMMI, Scrum).

Datové typy a názvy polí

Každý typ pracovní položky určuje pole zahrnutá do pracovních položek daného typu. Každé pole má více atributů, z nichž mnohé jsou definované systémem a neměnné.

Pole jsou definována následujícími třemi atributy:

• Datový typ: Označuje druh dat, která lze zadat do pole, například logická hodnota, double, celé číslo, HTML nebo řetězec. Podrobné popisy jednotlivých datových typů najdete v tématu Pole dotazu, operátory a makra.
• Popisný název: Uživatelsky přívětivý název přiřazený k poli, který se používá při výběru pole v klauzuli dotazu. Tento název se může lišit od názvu zobrazeného ve formuláři pracovní položky.
• Název odkazu: Identifikátor použitý při vytváření dotazů WIQL, improvizované šablony pracovních položek, spouštění příkazů rozhraní REST API nebo definování definic typů pracovních položek XML. Název odkazu je trvalý a po nastavení není možné ho změnit.

Podrobný popis jednotlivých atributů pole a pokyny k jejich výpisu najdete v části Atributy polí a Atributy pole Seznam dále v tomto článku. Přehled typů pracovních položek (WIT) a pracovních položek najdete v tématu Sledování práce s uživatelskými příběhy, problémy, chybami, funkcemi a náměty.

Co je pole? Jak se používají názvy polí?

Každý typ pracovní položky obsahuje 31 systémových polí a několik polí specifických pro typ. Pracovní položky slouží k plánování a sledování projektu.

Každé pole zachycuje konkrétní informace o práci, která se má provést. Hodnoty, které přiřadíte k těmto polím, jsou uloženy v úložišti dat sledování práce a umožňují vytvářet dotazy, které určují stav a trendy.

Popisy a použití jednotlivých polí definovaných pro základní systémové procesy – Agile, Basic, Scrum a CMMI – najdete v indexu polí Pracovní položka.

Názvy polí

Název pole pracovní položky jednoznačně identifikuje každé pole pracovní položky. Ujistěte se, že názvy polí odpovídají následujícím pokynům:

• Jedinečnost: Názvy polí musí být jedinečné v rámci kolekce účtů nebo projektů.
• Délka: Názvy polí musí obsahovat 128 znaků Unicode nebo méně.
• Mezery: Názvy polí nemohou mít úvodní nebo koncové mezery nebo obsahují dvě nebo více po sobě jdoucích mezer.
• Složení: Názvy polí musí obsahovat alespoň jeden abecední znak.
• Zakázané znaky: Názvy polí nesmí obsahovat následující znaky: .,;':~/*|? &%$!+=()[]{}<>'.

Vzhledem k tomu, že vlastní pole jsou definována na úrovni organizace nebo kolekce, nemůžete do více procesů přidat vlastní pole se stejným názvem.

Další informace najdete v tématu Omezení a konvence pojmenování.

Systémová a předdefinovaná pole

Název pole pracovní položky jednoznačně identifikuje každé pole v Rámci Azure DevOps. Ujistěte se, že názvy polí vyhovují následujícím pokynům:

• Jedinečnost: Názvy polí musí být jedinečné v rámci kolekce účtů nebo projektů.
• Délka: Názvy polí musí být 128 znaků Unicode nebo méně.
• Mezery: Názvy polí nemůžou mít úvodní ani koncové mezery nebo obsahují několik po sobě jdoucích mezer.
• Složení: Názvy polí musí obsahovat alespoň jeden abecední znak.
• Zakázané znaky: Názvy polí nesmí obsahovat následující znaky: .,;':~/*|? &%$!+=()[]{}<>'.

Vzhledem k tomu, že vlastní pole jsou definována na úrovni organizace nebo kolekce, nemůžete do více procesů přidat vlastní pole se stejným názvem.

Další informace najdete v tématu Omezení a konvence pojmenování.

Vlastní pole

Vzhledem k tomu, že vlastní pole jsou definována na úrovni organizace nebo kolekce projektů, nemůžete do více procesů přidat vlastní pole se stejným názvem.

Při přidávání vlastníchpolích

• Maximální počet polí na typ pracovní položky (WIT): 64
• Maximální počet polí na proces: 512

Datový typ pole určuje druh a velikost dat, která mohou být uložena v poli. Každé pole může mít v kolekci projektů definovaný jenom jeden typ, který podporuje použití společných polí v různých projektech a typech pracovních položek.

Když do zděděného procesu přidáte vlastní pole, Azure DevOps přiřadí název odkazu s předponou Vlastní a název pole bez mezer. Například přidání pole s názvem DevOps Triage má za následek název odkazu Custom.DevOpsTriage. Mezery nejsou povoleny v názvech odkazů.

Další informace najdete v tématu Omezení a konvence pojmenování.

Jak můžu určit datový typ pole?

Datový typ polí definovaných pro vaši organizaci můžete zobrazit otevřením stránky Pole procesu>.

Kontrola seznamu polí

Pokud chcete zkontrolovat seznam polí definovaných pro organizaci nebo kolekci, postupujte takto:

1. Výběrem loga Azure DevOps otevřete projekty. Pak zvolte Nastavení organizace.

   

2. Vyberte možnost Proces.

   

3. Vyberte Pole.

   Uvedená pole odpovídají všem polím definovaným pro organizaci nebo kolekci, která zahrnují všechna vlastní pole a pole definovaná pro systémové procesy.

   

   Poznámka:

   Pokud pole nevidíte, použije vaše kolekce místní proces XML. Stránka Pole není pro tento proces podporovaná.

   Popisy, použití a referenční názvy jednotlivých polí najdete v indexu polí Pracovní položka. Kromě toho můžete načíst referenční názvy polí pomocí pole Typy pracovních položek – seznam rozhraní REST API.

Průzkumník polí pracovní položky

Přiřazení atributů polí můžete vyhledat pomocí nástroje Průzkumníka polí pracovní položky.

Pokud chcete získat přístup k Průzkumníku polí pracovní položky, nainstalujte nástroj Editor procesů. Na základě nainstalované verze sady Visual Studio získejte nástroj Editor procesů z některého z následujících rozšíření.

• Visual Studio 2019 & 2022: Odteď není k dispozici žádné konkrétní rozšíření Editoru šablon procesů. Šablony procesů ale můžete i nadále přizpůsobovat pomocí jiných nástrojů, jako je jakýkoli textový editor nebo editor XML. Webový portál Azure DevOps můžete použít také pro určitá přizpůsobení, zejména pro zděděné procesy.
• Visual Studio 2017: Editor šablon procesů TFS Tuto verzi Editoru procesů můžete také použít k úpravě formulářů starých pracovních položek ve stylu. Nemůžete ho použít k úpravám formulářů přidružených k novým webovým formulářům.
• Visual Studio 2015: TFS Power Tools.

Atributy pole

Pro každé pole pracovní položky existuje mnoho neschangovatelných a skrytých atributů. Následující tabulka popisuje každý atribut. Atributy mají různé názvy v závislosti na tom, jestli je načtete prostřednictvím polí – získejte rozhraní REST API nebo je můžete zobrazit pomocí nástroje Průzkumníka polí pracovních položek (WIFE).

Atributy přiřazené k poli závisí na platformě a verzi, kterou používáte. Například některé atributy nejsou podporovány procesem dědičnosti. Pokud chcete vyhledat název odkazu pro pole, podívejte se na index pole Pracovní položka.

Atribut

Typ atributu

Popis

---

REST:
MANŽELKA: AllowedValues

– kolekce

Získá kolekci platných hodnot pro pole, které obsahuje hodnoty rozevíracího seznamu. Můžete to změnit zadáním rozevíracího seznamu nebo globálního seznamu (místně).
Může se změnit?=Ano

REST: canSortBy
ŽENA: CanSortBy

boolean

Určuje, jestli můžete výsledky dotazu seřadit pomocí tohoto pole.
Může se změnit?=Ne

REST: popis
MANŽELKA: HelpText

string

Určuje popis pole, které také definuje text nápovědy, který se zobrazí při najetí myší na pole ve formuláři pracovní položky.
Může se změnit?=Ano

REST:
ŽENA: ID

Celé číslo

Určuje interní ID pole.
Může se změnit?=Ne

REST:
ŽENA: IsKloneable

boolean

Určuje, jestli se hodnota definovaná pro pole zkopíruje, když se uživatel rozhodne zkopírovat pracovní položku. Například pole Název, Značky a Popis se zkopírují, ale pole ID a Historie se nezkopírují.
Může se změnit?=Ne

REST:
MANŽELKA: IsComputed

boolean

Určuje, jestli je hodnota nastavená tímto polem vypočítaná systémem (Pravda) nebo ne (Nepravda). Příklady počítaných polí jsou ty, které systém nastavil, například ID, Revidované datum, Změněné datum a Počet externích propojení.
Může se změnit?=Ne

REST:
ŽENA: IsCoreField

boolean

Určuje, zda je toto pole určeno pro všechny typy pracovních položek.
Může se změnit?=Ne

REST:
ŽENA: IsEditable

boolean

Označuje, jestli uživatelé můžou toto pole upravit (Pravda) nebo ne (Nepravda). Příklady nesložitelných polí jsou pole, která jsou nastavená systémem, například pole ID, Revize, Autor a Změněno podle .
Může se změnit?=Ne

REST: isIdentity
ŽENA: IsIdentity

boolean

Určuje, jestli je toto pole pole Identita. Pole identity jsou řetězcová pole použitá k ukládání identit uživatelů.
Může se změnit?=Ne

REST:
ŽENA: IsIndexed¹

boolean

Určuje, zda je toto pole indexováno pro podporu vyhledávání.
Může se změnit?=Ne

REST:
ŽENA: IsLongText

boolean

Označuje, že pole může obsahovat více než 255 znaků, například pole přiřazená datový typ PlainText, HTML nebo Historie.
Může se změnit?=Ne

REST: isPicklist² MANŽELKA:

Logická hodnota

Určuje, jestli je pole přidružené k rozevíracímu seznamu. Hodnota je nastavena na Hodnotu True , pokud je pro Azure DevOps definováno vlastní pole a je vybrán typ rozevíracího seznamu (String) nebo Picklist (Integer). Hodnota je nastavena na False pro zděděná pole, která definují rozevírací seznamy.
Může se změnit?=Ne

REST: isPicklistSuggested² WIFE:

Logická hodnota

Určuje, jestli pole umožňuje uživatelům zadat vlastní hodnoty pro rozevírací seznam. Hodnota je nastavena na Hodnotu True , pokud je definováno vlastní pole pro Azure DevOps, rozevírací seznam (řetězec) nebo typ rozevíracího seznamu (celé číslo) a je zaškrtnuté políčko Povolit uživatelům nastavit vlastní hodnoty .
Může se změnit?=Ano

REST: isQueryable
ŽENA: IsQueryable

boolean

Označuje, jestli se pole zobrazuje v sadě polí, která můžete přidat k filtrování dotazu na pracovní položku (Pravda), nebo ne (Nepravda). Většina polí je možné dotazovat.
Může se změnit?=Ne

REST:
ŽENA: IsReportable ³

boolean

Určuje, jestli je atribut sestavovatelný nebo nastavený na cokoli jiného než None. Tento atribut je možné změnit pro místní prostředí.
Může se změnit?=Ano

REST:
ŽENA: IsUsedInGlobalWorkflow

boolean

Určuje, jestli je pole definováno v rámci globálního pracovního postupu.
Může se změnit?=Ne

REST:
MANŽELKA: IsUserNameField

boolean

Označuje, jestli se pole používá k zobrazení pole Identita.
Může se změnit?=Ne

REST: název
MANŽELKA: Jméno

string

Popisný název přiřazený k poli Popisný název nejde pro Azure DevOps změnit, ale můžete ho změnit pro místní prostředí pomocí příkazu witadmin changefield .
Může se změnit?=Pouze místní

REST: picklistId
MANŽELKA: HelpText

Identifikátor GUID

Pokud je pole rozevírací seznam, identifikátor přidruženého rozevíracího seznamu, jinak null. Jedinečná hodnota GUID se přiřadí, když je pro Azure DevOps definováno vlastní pole a je vybrán typ rozevíracího seznamu (String) nebo Picklist (Integer).
Může se změnit?=Ne

REST:
MANŽELKA: ZakázánoHodnoty

– kolekce

Získá kolekci zakázaných hodnot pro pole, které určuje tyto hodnoty. Zakázané hodnoty můžete definovat pouze pro místní nasazení.
Může se změnit?=Pouze místní

REST: jen pro čtení
MANŽELKA:

Logická hodnota

Určuje, zda je pole nastaveno jen pro čtení. Pro Azure DevOps Services je možné změnit pouze vlastní pole tak, aby byla jen pro čtení. Systémová pole nelze upravit.
Může se změnit?=Ano

REST: referenceName
MANŽELKA: ReferenceName

string

Určuje název odkazu pole.
Může se změnit?=Ne

REST:
ŽENA: ReportingAttributes³

Určuje podrobnosti, dimenzi nebo míru v závislosti na tom, jestli a jak chcete pole zahrnout do sestav. Data z polí, která mají jinou hodnotu než None pro tento atribut, se exportují do datového skladu a mohou být zahrnuta do sestav SQL.
Může se změnit?=Pouze místní

REST:
MANŽELKA: ReportingName³

string

Určuje popisek pole, když se data zobrazí v sestavách SQL. Pokud nezadáte hodnotu, použije se popisný název pole.
Může se změnit?=Pouze místní

REST:
MANŽELKA: ReportingReferenceName³

string

Určuje jiný název odkazu na pole, které se používá při exportu dat do relačního datového skladu. Pokud nezadáte hodnotu, použije se název odkazu na pole.
Může se změnit?=Pouze místní

REST: supportedOperations
MANŽELKA:

set

Sada operátorů dotazu, které jsou platné pro použití při odkazování na toto pole. Stručný přehled podporovaných operací založených na datovém typu najdete v tématu Rychlá reference k dotazům, operátory a makra podporovaná pro každý datový typ.
Může se změnit?=Ne

REST:
MANŽELKA: SupportsTextQuery

boolean

Určuje, zda pole podporuje textové dotazy, například Obsahuje slova, Neobsahuje slova.
Může se změnit?=Ne

REST:
MANŽELKA: SystemType

string

Určuje datový typ pole, odkazující na název systému, například System.DateTime nebo System.String.
Může se změnit?=Ne

REST: typ
WIFE: FieldType

string

Určuje datový typ pole, například Boolean, DateTime, Integer, String atd. Úplný seznam a popisy najdete v tématu Pole dotazu, operátory a makra.
Může se změnit?=Ne

REST: využití
MANŽELKA: Využití

string

Určuje, zda je pole určeno pro použití s pracovními položkami (WorkItem) nebo odkazem na pracovní položku (WorkItemLink). Použití většiny polí je WorkItem. Úplný seznam hodnot využití najdete v tématu Získání polí a jednotek polí.
Může se změnit?=Ne

Poznámka:

1. U místních nasazení můžete povolit indexování pole, aby se zlepšila doba odezvy dotazů při filtrování pole. Další informace najdete v tématu Indexovaná pole dále v tomto článku.
2. Atributy isPicklist a isPicklistSuggested jsou přiřazeny pouze k vlastním polím definovaným pro zděděný proces. Model zděděného procesu je podporovaný pro Azure DevOps Server 2019 a novější verze. Další informace najdete v tématu Model zděděného procesu.
3. Všechny atributy generování sestav jsou platné pouze pro místní nasazení, jejichž projekty byly nakonfigurovány tak, aby podporovaly vytváření sestav a Služba Analysis Services serveru SQL SQL Serveru.

Atributy polí seznamu

Pomocí rozhraní Fields – Get REST API můžete zobrazit seznam atributů přiřazených k poli. Název organizace nahraďte skutečným názvem organizace.

https://dev.azure.com/OrganizationName/_apis/wit/fields/FieldReferenceName

Pokud chcete například vypsat atributy cesty iterace, použijte název System.IterationPath odkazu pro fabrikam organizaci:

https://dev.azure.com/fabrikam/_apis/wit/fields/System.IterationPath

**Returned data:**

> [!div class="tabbedCodeSnippets"]
> ```JSON
> {
> "name": "Iteration Path",
> "referenceName": "System.IterationPath",
> "description": "The iteration within which this bug will be fixed",
> "type": "treePath",
> "usage": "workItem",
> "readOnly": false,
> "canSortBy": true,
> "isQueryable": true,
> "supportedOperations": [
> {
> "referenceName": "SupportedOperations.Under",
> "name": "Under"
> },
> {
> "referenceName": "SupportedOperations.NotUnder",
> "name": "Not Under"
> },
> {
> "referenceName": "SupportedOperations.Equals",
> "name": "="
> },
> {
> "referenceName": "SupportedOperations.NotEquals",
> "name": "<>"
> },
> {
> "referenceName": "SupportedOperations.In",
> "name": "In"
> },
> {
> "name": "Not In"
> }
> ],
> "isIdentity": false,
> "isPicklist": false,
> "isPicklistSuggested": false,
> "url": "https://dev.azure.com/mseng/_apis/wit/fields/System.IterationPath"
> }
> ```

Přidání a úprava polí

Chcete-li přidat pole do procesu, přidejte je do jednoho nebo více typů pracovních položek. Další informace naleznete v tématu Přizpůsobení procesu dědičnosti.

Související články

• Pokud chcete rychle porozumět syntaxi a použití dotazů, projděte si stručnou referenční informace .
• Prozkoumejte index pole Pracovní položka a zobrazte všechna dostupná pole pracovních položek.
• Přidání a správa polí pro zděděný proces pro přizpůsobení polí podle požadavků na zděděný proces
• Získejte přístup k referenčním informacím o metadatech pro Azure Boards Analytics , abyste porozuměli možnostem analytických metadat a vytváření sestav.