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

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

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.

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.

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

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

Atributy polí seznamu

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

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

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

https://{ServerName:Port}/tfs/{Collection}/_apis/wit/fields/FieldReferenceName?api-version={version}

https://fabrikam:8080/tfs/DefaultCollection/_apis/wit/fields/System.IterationPath?api-version=4.1

{
"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://fabrikam:8080/tfs/DefaultCollection/_apis/wit/fields/System.IterationPath?api-version=4.1"
}

witadmin listfields /collection:http://fabrikam:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Issue  

Field: Microsoft.VSTS.Common.Issue  
Name: Issue  
Type: String  
Reportable As: dimension  
Use: Adventure Works (Shared Steps), AW Future (Shared Steps), AW Current (Shared Steps)  
Indexed: False  

Přidání a úprava polí

Související články