Pole a atributy pracovních položek v Azure Boards

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

Pole pracovních položek slouží ke sledování informací. Pole jsou definována pro organizaci a sdílí se napříč všemi projekty definovanými pro danou organizaci. Pomocí jednoho ze dvou nástrojů můžete zkontrolovat pole definovaná pro organizaci. Tyto nástroje 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

• Chcete-li zobrazit pole definovaná pro organizaci nebo kolekci, musíte být členem skupiny aplikace Project Collection Valid Users nebo mít oprávnění Zobrazit informace na úrovni instance nastavená tak, aby umožňovala organizaci nebo kolekci.

Seznam nebo kontrola polí

Pokud chcete zobrazit nebo zkontrolovat pole, můžete použít jeden z následujících nástrojů v závislosti na modelu procesu – dědičnost, hostovaný XML nebo místní XML – který používáte. 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 definovaná pro pracovní položky, které odkazují na tento typ. Každé pole je přidruženo k řadě atributů, z nichž mnohé jsou nastaveny systémem a nelze je změnit.

Každé pole je definováno následujícími třemi atributy.

• Datový typ: Určuje typ dat, která lze zadat do pole, například logická hodnota, double, celé číslo, HTML a řetězec. Popis jednotlivých datových typů najdete v tématu Pole dotazu, operátory a makra.
• Popisný název: Určuje název přiřazený k poli a vyberete 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: Určuje název, který použijete při vytváření dotazu WIQL nebo improvizované šablony pracovní položky, pomocí příkazů rozhraní REST API nebo definování definic typů pracovních položek XML. Po definování nelze změnit název odkazu.

Popis každého atributu pole a způsob jejich výpisu najdete v části Atributy polí a Atributy pole seznam dále v tomto článku. Přehled pracovních položek 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 je přidružený k 31 systémovým polím a několika dalším polím specifickým pro typ. Pracovní položky slouží k plánování a sledování projektu.

Každé pole podporuje sledování informací o práci, která se má provést. Hodnoty, které přiřadíte k poli, se ukládají v úložišti dat sledování práce, ve kterém můžete vytvářet dotazy k určení stavu a trendů.

Popisy a použití jednotlivých polí definovaných pro základní systémové procesy, Agilní, Základní, Scrum a CMMI naleznete v indexu polí pracovní položky.

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í spadají do těchto pokynů:

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

Protože jsou vlastní pole definovaná pro organizaci nebo kolekci, nemůžete do procesu přidat vlastní pole se stejným názvem pole, který přidáte do jiného procesu.

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

Systémová a předdefinovaná pole

Všechna systémově definovaná pole mají referenční názvy, které začínají systémem, například System.AreaPath, System.AssignedTo a pokračovat v tomto vzoru.

Předdefinovaná pole definovaná výchozím procesem začínají microsoft.VSTS a pak se dále liší podle jejich využití. Příklady předdefinovaných polí, která se používají běžně pro plánování a integraci s Office Projectem, pro integraci s Team Foundation Buildem a integrací se správou testovacích případů (TCM) jsou následující:

• Microsoft.VSTS.Common.Priority
• Microsoft.VSTS.Scheduling.DueDate
• Microsoft.VSTS.Build.FoundIn
• Microsoft.VSTS.TCM.Steps

Přehled všech systémových a předdefinovaných polí definovaných pro výchozí šablony procesů a procesů najdete v tématu Index polí pracovní položky. Další informace o zadávání názvů polí najdete v tématu Omezení pojmenování.

Vlastní pole

Vzhledem k tomu, že vlastní pole jsou definovaná pro organizaci nebo kolekci projektů, nemůžete do procesu přidat vlastní pole se stejným názvem pole, který přidáte do jiného procesu.

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

• Pro každou definici wi-fi je možné definovat maximálně 64 polí.
• Pro každý proces lze definovat maximálně 512 polí.

Datový typ pole určuje druh a velikost dat, která můžete v poli uložit. Pole může mít v kolekci projektů definovaný jenom jeden typ. Toto omezení podporuje organizace, aby používaly společná pole napříč projekty a typy 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 pak název pole s odebranými mezerami. Například přidáte pole s názvem DevOps Triage, název odkazu je Custom.DevOpsTriage. V názvu odkazu nejsou povoleny žádné mezery.

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

Webová stránka Pole procesu>

Pokud chcete zkontrolovat seznam polí definovaných pro organizaci nebo kolekci, otevřete pole procesu nastavení>>organizace.

1. Zvolte logo Azure DevOps a otevřete projekty. Pak zvolte Nastavení organizace.

   

2. Pak zvolte Proces.

   

   Poznámka:

   Pokud proces nevidíte, pracujete v TFS-2018 nebo starší verzi. Stránka Proces není podporovaná. Musíte použít funkce podporované pro místní model procesu XML.

3. Pak zvolte Pole.

   Uvedená pole odpovídají všem polím definovaným pro organizaci nebo kolekci. To zahrnuje 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 a použití jednotlivých polí a také název odkazu pro každé pole můžete vyhledat z indexu pole Pracovní položka. Název odkazu můžete získat také z pole Typy pracovních položek – rozhraní REST API seznamu.

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, musíte nainstalovat 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: Editor šablon procesů
• 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 neměnitelných a skrytých atributů. Následující tabulka popisuje každý atribut. Atributy mají různé názvy podle toho, jestli je získáte prostřednictvím polí – Získejterozhraní REST API nebo si prohlédněte nástroj Průzkumníka polí pracovních položek (WIFE).

Atributy přiřazené k poli závisí na platformě a používané verzi. Některé atributy například nepodporují proces dědičnosti. Pokud chcete vyhledat název odkazu pro pole, přečtěte si téma Index pole pracovní položky.

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 neupravitelný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:

boolean

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:

boolean

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í
ŽENA:

boolean

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 změnit.
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
ŽENA:

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. Zadejte název organizace pro Název organizace.

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

Zde například uvádíme atributy pro cestu iterace, určující název odkazu , System.IterationPathpro 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"
}

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

• Stručná referenční příručka k dotazům
• Index pole pracovních položek
• Přidání a správa polí pro zděděný proces
• Referenční informace o metadatech pro Azure Boards Analytics