Seznam polí a atributů pracovní položky

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Pole pracovních položek sledují informace v rámci Azure DevOps. Systém tato pole definuje na úrovni organizace a sdílí je 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ích úloh

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

Návod

S touto úlohou můžete využít umělou inteligenci dále v tomto článku nebo si můžete projít Povolit asistenci umělé inteligence s Azure DevOps MCP Server začít.

Proč záleží na polích pracovních položek

Pole pracovních položek obsluhuje několik důležitých funkcí v Azure DevOps:

• Sledování dat: Zachytávání a ukládání základních informací o pracovních položkách
• Funkce dotazů: Povolení výkonných možností vyhledávání a filtrování
• Vytváření sestav: Podpora analýz a řídicích panelů
• Správa pracovních postupů: Řízení přechodů stavu a obchodních pravidel
• Integrace: Připojení s externími nástroji a systémy

Vysvětlení atributů polí vám pomůže:

• Optimalizace dotazů: Výběr správných polí pro efektivní vyhledávání
• Přizpůsobení plánu: Vysvětlení omezení a možností
• Řešení potíží: Diagnostika problémů s chováním polí
• Procesy návrhu: Vytváření efektivních typů a pracovních postupů pracovních položek

Prerequisites

Category	Requirements
Povolení	Chcete-li zobrazit pole definovaná pro organizaci nebo kolekci: Člen Kolekce projektů Platní uživatelé skupiny aplikace nebo Zobrazení informací na úrovni instance oprávnění nastavená na Povolit 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. Pro podrobný seznam polí definovaných v rámci výchozích procesů si přečtěte Index polí pracovní položky.

Tool	Inheritance	Hostovaný XML	Lokální XML
Webový portál: Seznam zděděných a vlastních definovaných polí	✔️	✔️1
Průzkumník polí pracovní položky	✔️	✔️	✔️
příkazový řádek nástroje "witadmin listfields"	✔️	✔️	✔️

Note

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é.

Tři klíčové atributy definují pole:

• Datový typ: Označuje druh dat, která můžete 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, šablon 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 fungují 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 vám pomůžou plánovat a sledovat projekt.

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.

Požadavky na pojmenování 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 systém definuje vlastní pole 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

Systém definuje pole pracovních položek s konkrétními požadavky na pojmenování a strukturální požadavky, aby se zajistila konzistence a funkčnost:

• 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 systém definuje vlastní pole 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 systém definuje vlastní pole na úrovni kolekce organizace nebo projektu, nemůžete do více procesů přidat vlastní pole se stejným názvem.

Při přidávání vlastních polích si povšimněte následujících omezení:

• 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á můžete v poli uložit. 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 Custom následovaný názvem 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 vyberte 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.

   

   Note

   Pokud nevidíte pole, vaše kolekce používá lokální 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ích položek. 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ích položek

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

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

• Visual Studio 2019 & 2022: Od této chvíle 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. Pro určitá přizpůsobení můžete také použít webový portál Azure DevOps, 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ářů pracovních položek starého 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 neangeovatelný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 rozhraní REST API pro načtení polí nebo je zobrazíte prostřednictvím nástroje Průzkumník polí pracovních položek (WIFE).

Atributy přiřazené k poli závisí na platformě a používané verzi. Například některé atributy nejsou podporovány procesem dědičnosti. Chcete-li vyhledat referenční název pro pole, podívejte se na index polí pracovních položek.

Attribute

Typ atributu

Description

---

REST:
MANŽELKA: AllowedValues

kolekce

Získat kolekci platných hodnot pro pole, které obsahuje hodnoty výběrového seznamu. Můžete to změnit pomocí zadání rozevíracího seznamu nebo globálního seznamu (na místě).
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

řetězec

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

Integer

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

REST:
ŽENA: IsKloneable

boolean

Určuje, zda systém zkopíruje hodnotu definovanou pro pole, když se uživatel rozhodne zkopírovat pracovní položku. Systém například kopíruje pole Název, Značky a Popis , ale nekopírovala pole ID a Historie .
Může se změnit?=Ne

REST:
MANŽELKA: IsComputed

boolean

Určuje, jestli systém vypočítá hodnotu, která pole nastaví (Pravda) nebo ne (Nepravda). Příkladem počítaných polí jsou ta, která systém nastavuje, například ID, Datum revize, Datum změny a Počet externích odkazů.
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 needitelných polí jsou ta, která nastavuje systém, jako jsou pole ID, Revize, Vytvořeno a Změněno.
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:
MANŽELKA: 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ý

Určuje, zda je pole spojeno s rozevíracím seznamem. Systém nastaví hodnotu na True, když definujete vlastní pole pro Azure DevOps a zvolíte typ Výběrový seznam (Řetězec) nebo Výběrový seznam (Celé číslo). Systém nastaví hodnotu False pro zděděná pole, která definují rozevírací seznamy.
Může se změnit?=Ne

REST: isPicklistSuggested² MANŽELKA:

logický

Určuje, jestli pole umožňuje uživatelům zadat vlastní hodnoty pro rozevírací seznam. Systém nastaví hodnotu na True, když definujete vlastní pole pro Azure DevOps, vyberete typ Picklist (Řetězec) nebo Picklist (Celé číslo) a zaškrtnete políčko pro 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 polích, která můžete přidat k filtrování dotazu na pracovní položku (Pravda), nebo ne (Nepravda). Většinu polí lze dotazovat.
Může se změnit?=Ne

REST:
ŽENA: IsReportable ³

boolean

Určuje, zda je oznamovatelný atribut definován nebo nastaven na cokoli jiného než None. Tento atribut můžete 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, zda se toto pole používá k zobrazení pole s identitou.
Může se změnit?=Ne

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

řetězec

Přátelský název přiřazený k poli Přátelské jméno pro Azure DevOps nemůžete změnit, ale můžete ho změnit pro lokální instalaci pomocí příkazu witadmin changefield.
Může se změnit?=Pouze místní

REST: picklistId
MANŽELKA: HelpText

GUID

Pokud je pole seznam výběru, identifikátor přidruženého seznamu výběru, jinak nulová hodnota. Systém přiřadí jedinečnou hodnotu GUID, když definujete vlastní pole pro Azure DevOps a vyberete typ Rozevírací seznam (Řetězec) nebo Rozevírací seznam (Celé číslo).
Může se změnit?=Ne

REST:
MANŽELKA: ZakázanéHodnoty

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í
WIFE:

logický

Určuje, zda je pole nastaveno jen pro čtení. Pro Azure DevOps Služby 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

řetězec

Určuje referenční název 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. Systém exportuje data z polí, která mají jinou hodnotu než Žádná pro tento atribut, do datového skladu a může je zahrnout do sestav SQL.
Může se změnit?=Pouze místní

REST:
MANŽELKA: ReportingName³

řetězec

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

REST:
MANŽELKA: ReportingReferenceName³

řetězec

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

REST: podporovanéOperace
WIFE:

set

Kolekce 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

řetězec

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
MANŽELKA: FieldType

řetězec

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í

řetězec

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 Get Fields, FieldUsage.
Může se změnit?=Ne

Note

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. Systém přiřadí atributy isPicklist a isPicklistSuggested pouze vlastním polím definovaným pro zděděný proces. Model zděděného procesu podporuje Azure DevOps Server 2020 a novější verze. Další informace najdete v tématu Model zděděného procesu.
3. Všechny atributy sestav jsou platné pouze pro místní nasazení, jehož projekty byly nakonfigurovány tak, aby podporovaly sestavy SQL Server a SQL Server Analysis Services.

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

Například, abyste vypsali atributy pro Iteration Path, použijte referenční název System.IterationPath pro organizaci fabrikam.

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

Vrácená data:

{
"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"
}

Osvědčené postupy pro práci s poli

Při práci s poli pracovních položek zvažte tato doporučení:

Výběr a návrh polí

• Zvolte smysluplné názvy: Používejte popisné názvy polí, které jasně označují jejich účel.
• Standardizace pojmenování: Vytvoření konzistentních konvencí vytváření názvů v rámci vaší organizace
• Omezit počet vlastních polí: Přidávejte vlastní pole uvážlivě, abyste předešli zahlcení uživatelů
• Zvažte datové typy: Vyberte vhodné datové typy pro informace, které ukládáte.

Optimalizace výkonu

• Použití indexovaných polí: Pro místní nasazení zvažte indexování často dotazovaných vlastních polí.
• Vyhněte se náročným dotazům: Při použití mnoha filtrů polí mějte na paměti výkon dotazů.
• Optimalizace rozevíracích seznamů: Udržujte hodnoty seznamů přehledné a dobře organizované

Údržba a zásady správného řízení

• Použití pole dokumentu: Údržba dokumentace vysvětlující účel a použití vlastních polí
• Pravidelně kontrolovat: Pravidelně kontrolujte vlastní pole a identifikujte nepoužívané nebo redundantní pole.
• Plánování změn: Zvažte dopad změn polí na stávající pracovní položky a dotazy.
• Změny testů: Nejprve vždy změny testovacího pole ve vývojovém prostředí

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.

Řešení problémů na místě

Běžné problémy a řešení při práci s poli pracovních položek:

Problémy s viditelností polí

• Pole se nezobrazuje: Zkontrolujte, jestli je pole přidáno do rozložení typu pracovní položky.
• Problémy s oprávněními: Ověřte, že máte příslušná oprávnění k zobrazení nebo úpravám polí.
• Rozdíly mezi procesy: Ujistěte se, že pole v aktuálním procesu existuje.

Problémy s dotazy a vyhledáváním

• Pole nelze dotazovat: Zkontrolujte IsQueryable atribut pole.
• Problémy s výkonem: Zvažte indexování často dotazovaných vlastních polí (místní)
• Omezení operátorů: Ověřte, které operátory jsou pro datový typ pole podporovány.

Zadávání a ověřování dat

• Neplatné hodnoty: Zkontrolujte, jestli pole omezilo povolené hodnoty nebo ověřovací pravidla.
• Pole jen pro čtení: Ověření atributu IsEditable pole
• Požadavky na formát: Zajištění shody dat s očekávaným datovým typem pole

Zkoumání polí pracovních položek pomocí AI

Pokud nakonfigurujete Azure DevOps MCP Server, můžete zkoumat a dotazovat pole pracovních položek pomocí přirozeného jazyka.

Task	Příklad výzvy
Pole seznamu pro typ pracovní položky	Show me all fields available for the Bug work item type in project <Contoso>
Vyhledání vlastních polí	List all custom fields defined in my organization
Kontrola využití polí	Which work item types use the "Story Points" field in project <Contoso>?
Dotazování podle hodnot polí	Show all user stories where Story Points is greater than 8 in <Contoso>
Najděte prázdná povinná pole	List all active work items in project <Contoso> where the Priority field is empty
Porovnání hodnot polí mezi různými typy	Show which fields are shared between Bug and User Story work item types in project <Contoso>
Konzistence polí auditování	Find all work items in <Contoso> where the Remaining Work field is set but the Original Estimate is blank
Prozkoumání hodnot rozevíracího seznamu	What are the allowed values for the Severity field on the Bug work item type in project <Contoso>?
Vyhledání zřídka používaných polí	Which custom fields in project <Contoso> have values set on fewer than 10 work items?
Identifikace problémů s daty polí	Show work items in <Contoso> where the Closed Date is set but the state is not Done or Closed

Note

Pokud používáte Visual Studio Code, agent mode je zvláště užitečné pro zkoumání definic polí a atributů.

Související obsah

• Stručné referenční informace k dotazům pro rychlé pochopení syntaxe a použití dotazů.
• Index polí pracovní položky pro zobrazení všech dostupných polí 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
• Metadata pro Azure Boards Analytics pro pochopení analytických metadat a možností vykazování.