Munkaelemmezők és -attribútumok az Azure Boardsban

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

A munkaelemmezők az információk nyomon követésére szolgálnak. A mezők egy szervezethez vannak definiálva, és meg vannak osztva az adott szervezethez definiált összes projektben. A két eszköz egyikével áttekintheti a szervezet számára meghatározott mezőket. Ezek az eszközök az örökölt és a üzemeltetett XML-folyamatmodellekhez is elérhetők.

• Folyamatmezők>weblapja
• Munkaelem mezőkezelője

A rendszerfolyamattal definiált mezők leírását a Munkaelem mezőindexe című témakörben talál.

Előfeltételek

• A szervezethez vagy gyűjteményhez definiált mezők megtekintéséhez a Projektgyűjtemény érvényes felhasználói alkalmazáscsoportjának tagjának kell lennie, vagy engedélyeznie kell a példányszintű információk megtekintését a szervezet vagy gyűjtemény számára.

Mezők listázása vagy véleményezése

A mezők listázásához vagy áttekintéséhez az alábbi eszközök egyikét használhatja a használt folyamatmodelltől (öröklés, üzemeltetett XML vagy helyszíni XML) függően. Az alapértelmezett folyamatokban definiált mezők indexét lásd : Munkaelem mezőindexe.

Eszköz	Öröklődés	Üzemeltetett XML	Helyszíni XML
Webportál: Örökölt és egyénileg definiált mezők listázása	✔️	✔️1
Munkaelem mezőkezelője	✔️	✔️	✔️
witadmin listfields parancssori eszköz	✔️	✔️	✔️

Feljegyzés

1. Csak az alapértelmezett folyamatok (Agile, CMMI, Scrum) esetében támogatott.

Mező adattípusai és nevei

Minden munkaelemtípus megadja az adott típusra hivatkozó munkaelemekhez definiált mezőket. Minden mező számos attribútumhoz van társítva, amelyek közül sok a rendszer által van beállítva, és nem módosítható.

Minden mezőt a következő három attribútum határoz meg.

• Adattípus: Megadja a mezőbe beírható adatok típusát, például logikai, dupla, egész szám, HTML és sztring. Az egyes adattípusok leírását a Lekérdezés mezők, operátorok és makrók című témakörben találhatja meg.
• Rövid név: Megadja a mezőhöz rendelt nevet, és a lekérdezési záradékban kiválaszt egy mezőt . Ez a név eltérhet a munkaelem-űrlapon megjelenő névtől.
• Hivatkozás neve: Megadja a WIQL-lekérdezés vagy improvizált munkaelem-sablon létrehozásakor, REST API-parancsokkal vagy XML-munkaelem-típusdefiníciók definiálásakor használt nevet. A definiálás után a hivatkozás neve nem módosítható.

Az egyes mezőattribútumok leírásáért és listázásuk módjáért tekintse meg a cikk későbbi részében a Mezőattribútumokat és a Mezőattribútumok listáját. A wits és a munkaelemek áttekintését a felhasználói történetek, problémák, hibák, funkciók és eposzok nyomon követése című témakörben tekintheti meg.

Mi az a mező? Hogyan használják a mezőneveket?

Minden munkaelemtípus 31 rendszermezőhöz és több típusspecifikus mezőhöz van társítva. Munkaelemeket használ a projekt megtervezéséhez és nyomon követéséhez.

Minden mező támogatja a végrehajtandó munkával kapcsolatos információk nyomon követését. A mezőkhöz hozzárendelt értékek a munkakövetési adattárban vannak tárolva, amelyek állapotának és trendjeinek meghatározásához lekérdezéseket hozhat létre.

Az alapvető rendszerfolyamatokhoz, az Agilis, az Alapszintű, a Scrum és a CMMI-folyamatokhoz definiált mezők leírását és használatát lásd: Munkaelem mezőindexe.

Mezőnevek

A munkaelemmezők neve egyedileg azonosítja az egyes munkaelem-mezőket. Győződjön meg arról, hogy a mezőnevek az alábbi irányelvek közé tartoznak:

• A mezőneveknek egyedinek kell lenniük a fiókon/projektgyűjteményen belül
• A mezőneveknek 128 vagy kevesebb Unicode-karakternek kell lenniük
• A mezőnevek nem tartalmazhatnak bevezető vagy záró szóközöket, sem két vagy több egymást követő szóközt
• A mezőneveknek legalább egy betűrendes karaktert kell tartalmazniuk
• A mezőnevek nem tartalmazhatják a következő karaktereket: .,;'`:~\/\*|?"&%$!+=()[]{}<>.

Mivel az egyéni mezők egy szervezethez vagy gyűjteményhez vannak definiálva, nem adhat hozzá egyéni mezőt egy olyan folyamathoz, amelynek a mezőneve ugyanaz, mint amelyet egy másik folyamathoz ad hozzá.

További információ: Elnevezési korlátozások és konvenciók.

Rendszer- és előre definiált mezők

Minden rendszer által definiált mező hivatkozásnevekkel rendelkezik, amelyek a Rendszer kezdetűek, például System.AreaPath, System.AssignedTo, és ebben a mintában folytatódnak.

Az alapértelmezett folyamat által definiált előre definiált mezők a Microsoft.VSTS-vel kezdődnek, majd használatuktól függően további eltéréseket mutatnak. Példák az előre definiált mezőkre, amelyeket gyakran használnak ütemezési célokra és az Office Projecttel való integrációra, a Team Foundation buildel való integrációhoz, valamint a teszteset-kezeléssel (TCM) való integrációhoz:

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

Az alapértelmezett folyamatokhoz/folyamatsablonokhoz definiált összes rendszer- és előre definiált mező áttekintéséhez lásd : Munkaelem mezőindexe. A mezőnevek megadásával kapcsolatos további információkért lásd az elnevezési korlátozásokat.

Egyéni mezők

Mivel egyéni mezők definiálva vannak egy szervezethez vagy projektcsoporthoz, nem adhat hozzá egyéni mezőt egy olyan folyamathoz, amelynek a mezőneve ugyanaz, mint amelyet egy másik folyamathoz ad hozzá.

Egyéni mezők hozzáadásakor vegye figyelembe a következő korlátozásokat:

• Az egyes WIT-ekhez legfeljebb 64 mező határozható meg
• Folyamatonként legfeljebb 512 mező definiálható

A mező adattípusa határozza meg a mezőben tárolható adatok típusát és méretét. Egy mező csak egy típust definiálhat egy projektgyűjteményben. Ez a korlátozás arra ösztönzi a szervezeteket, hogy a projektek és a munkaelemtípusok közös mezőit használják.

Ha egyéni mezőt ad hozzá egy örökölt folyamathoz, az Azure DevOps hozzárendel egy Egyéni előtagú hivatkozásnevet, majd a szóközökkel rendelkező mező nevét. Hozzáadhat például egy DevOps Triage nevű mezőt, a hivatkozás neve Custom.DevOpsTriage. A hivatkozásnévben nem engedélyezett szóközök használata.

Hogyan határozhatom meg a mező adattípusát?

A szervezethez definiált mezők adattípusát a Folyamatmezők>lap megnyitásával tekintheti meg.

Folyamatmezők>weblapja

A szervezethez vagy gyűjteményhez definiált mezők listájának áttekintéséhez nyissa meg a Szervezeti beállítások Folyamatmezők>elemét>.

1. A Projektek megnyitásához válassza az Azure DevOps emblémát. Ezután válassza a Szervezeti beállítások lehetőséget.

   

2. Ezután válassza a Folyamat lehetőséget.

   

   Feljegyzés

   Ha nem látja a Folyamat elemet, akkor a TFS-2018 vagy korábbi verzióból dolgozik. A Folyamat lap nem támogatott. A helyszíni XML-folyamatmodellhez támogatott funkciókat kell használnia.

3. Ezután válassza a Mezők lehetőséget.

   A felsorolt mezők a szervezethez vagy gyűjteményhez definiált összes mezőnek felelnek meg. Ez magában foglalja az összes egyéni mezőt és a rendszerfolyamatokhoz definiált mezőket.

   

   Feljegyzés

   Ha nem látja a mezőket, akkor a gyűjtemény a helyszíni XML-folyamatot használja. A Mezők lap nem támogatott ehhez a folyamathoz.

   Az egyes mezők leírását és használatát, valamint az egyes mezők hivatkozási nevét a Munkaelem mezőindexből tekintheti meg. A mezők hivatkozási nevét a Munkaelemtípusok mezőből is lekérheti – A REST API listázása.

Munkaelem mezőkezelője

A Munkaelem mezőkezelő eszközével megkeresheti a mezőattribútumok hozzárendeléseit.

A Munkaelem mezőkezelő eléréséhez telepítenie kell a Folyamatszerkesztő eszközt. A Telepített Visual Studio verziója alapján kérje le a Folyamatszerkesztő eszközt az alábbi bővítmények egyikéből.

• Visual Studio 2019: Folyamatsablon-szerkesztő.
• Visual Studio 2017: TFS folyamatsablon-szerkesztő. A Folyamatszerkesztő ezen verziójával is módosíthatja a régi stílusú munkaeleműrlapokat. Nem használhatja az új webes űrlapokhoz társított űrlapok szerkesztésére.
• Visual Studio 2015: TFS Power Tools.

Mezőattribútumok

Az egyes munkaelemek mezőihez számos nem módosítható és rejtett attribútum tartozik. Az alábbi táblázat külön ismerteti az egyes tulajdonságokat. Az attribútumok neve eltérő, ha a Mezők – REST API lekérésevagy a Munkaelem mezőkezelő (FELESÉG) eszköz használatával tekinti meg őket.

A mezőhöz rendelt attribútumok a használt platformtól és verziótól függenek. Egyes attribútumok például nem támogatottak az öröklési folyamat során. Egy mező hivatkozási nevének kereséséhez tekintse meg a Munkaelem mezőindexet.

Attribútum

Attribútumtípus

Leírás

---

TÖBBI:
FELESÉG: AllowedValues

Gyűjtemény

Lekéri a picklist értékeket tartalmazó mező érvényes értékeinek gyűjteményét. Ezt egy picklist vagy globális lista (helyszíni) megadásával módosíthatja.
Módosítható?=Igen

REST: canSortBy
FELESÉG: CanSortBy

Logikai

Azt jelzi, hogy rendezheti-e a lekérdezés eredményeit ezzel a mezővel.
Módosítható?=Nem

REST: leírás
FELESÉG: Súgószöveg

húr

Megadja a mező leírását, amely meghatározza azt a súgószöveget is, amely akkor jelenik meg, amikor a munkaelem-űrlapon a mező fölé viszi az egérmutatót.
Módosítható?=Igen

TÖBBI:
FELESÉG: AZONOSÍTÓ

Egész

A mező belső azonosítóját adja meg.
Módosítható?=Nem

TÖBBI:
FELESÉG: IsCloneable

Logikai

Azt jelzi, hogy a program átmásolja-e a mezőhöz definiált értéket, amikor egy felhasználó a munkaelem másolását választja. A Cím, a Címkék és a Leírás mezők például ki vannak másolva, de az Azonosító és az Előzmények mezők nem lesznek másolva.
Módosítható?=Nem

TÖBBI:
FELESÉG: IsComputed

Logikai

Azt jelzi, hogy a mező által beállított értéket a rendszer (Igaz) vagy sem (Hamis) számítja-e ki. A számított mezők például a rendszer által beállított mezők, például az azonosító, a módosított dátum, a módosított dátum és a külső csatolások száma.
Módosítható?=Nem

TÖBBI:
FELESÉG: IsCoreField

Logikai

Azt jelzi, hogy ez a mező minden munkaelem-típushoz meg van-e adva.
Módosítható?=Nem

TÖBBI:
FELESÉG: IsEditable

Logikai

Azt jelzi, hogy a felhasználók módosíthatják-e ezt a mezőt (Igaz) vagy sem (Hamis). A nem szerkeszthető mezők például a rendszer által beállított mezők, például az Azonosító, a Változat, a Létrehozva és a Módosítva mezők
Módosítható?=Nem

REST: isIdentity
FELESÉG: IsIdentity

Logikai

Azt jelzi, hogy ez a mező identitásmező-e. Az identitásmezők a felhasználói identitások tárolására használt sztringmezők.
Módosítható?=Nem

TÖBBI:
FELESÉG: IsIndexed¹

Logikai

Azt jelzi, hogy ez a mező indexelve van-e a keresés támogatásához.
Módosítható?=Nem

TÖBBI:
FELESÉG: IsLongText

Logikai

Azt jelzi, hogy a mező legfeljebb 255 karaktert tartalmazhat, például egyszerű szöveg, HTML vagy előzmények adattípusú mezőket.
Módosítható?=Nem

REST: isPicklist² FELESÉG:

Logikai

Azt jelzi, hogy a mező egy picklistához van-e társítva. Az érték True (Igaz) értékre van állítva, ha egyéni mező van definiálva az Azure DevOps és a Picklist (Sztring) vagy a Picklist (Egész szám) típushoz. Az érték értéke False (Hamis) értékre van állítva a listákat definiáló öröklött mezők esetében.
Módosítható?=Nem

REST: isPicklistSuggested² FELESÉG:

Logikai

Azt jelzi, hogy a mező lehetővé teszi-e, hogy a felhasználók saját értékeket adjanak meg egy picklisthez. Az érték Igaz értékre van állítva, ha egyéni mező van definiálva az Azure DevOpshoz, a Picklist (String) vagy a Picklist (Egész szám) típushoz, és bejelöli a saját értékek beállításának engedélyezése jelölőnégyzetet.
Módosítható?=Igen

REST: isQueryable
FELESÉG: IsQueryable

Logikai

Azt jelzi, hogy a mező megjelenik-e a munkaelem-lekérdezés szűréséhez hozzáadható mezőkön belül (Igaz), vagy sem (Hamis). A legtöbb mező lekérdezhető.
Módosítható?=Nem

TÖBBI:
FELESÉG: IsReportable ³

Logikai

Azt jelzi, hogy a jelentéskészítési attribútum definiálva van-e, vagy a Nincs értéken kívül másra van-e beállítva. Ez az attribútum a helyszíni környezetekben módosítható.
Módosítható?=Igen

TÖBBI:
FELESÉG: IsUsedInGlobalWorkflow

Logikai

Azt jelzi, hogy a mező globális munkafolyamatban van-e definiálva.
Módosítható?=Nem

TÖBBI:
FELESÉG: IsUserNameField

Logikai

Azt jelzi, hogy a mező egy Identitás mező megjelenítésére szolgál-e.
Módosítható?=Nem

REST: név
FELESÉG: Név

húr

A mezőhöz rendelt rövid név. A rövid név nem módosítható az Azure DevOps esetében, de a witadmin changefield paranccsal a helyszínen módosítható.
Módosítható?=Csak helyszíni

REST: picklistId
FELESÉG: Súgószöveg

GUID

Ha a mező egy picklist, akkor a társított lista azonosítója, egyébként null. Egyedi GUID-érték akkor van hozzárendelve, ha egyéni mező van meghatározva az Azure DevOpshoz, és ki van jelölve a Picklist (Sztring) vagy a Picklist (Egész szám) típus.
Módosítható?=Nem

TÖBBI:
FELESÉG: Tiltott Értékértékek

Gyűjtemény

Lekéri az ilyen értékeket meghatározó mező tiltott értékeinek gyűjteményét. Csak a helyszíni üzemelő példányok tiltott értékeit határozhatja meg.
Módosítható?=Csak helyszíni

REST: readOnly
FELESÉGE:

Logikai

Azt jelzi, hogy a mező írásvédett-e. Az Azure DevOps Services esetében csak az egyéni mezők módosíthatók írásvédettként. A rendszermezők nem módosíthatók.
Módosítható?=Igen

REST: referenceName
FELESÉG: ReferenceName

húr

Egy mező hivatkozási nevét adja meg.
Módosítható?=Nem

TÖBBI:
FELESÉG: ReportingAttributes³

Megadja a részleteket, a dimenziót vagy a mértéket attól függően, hogy a mező szerepel-e a jelentésekben. Az attribútumHoz nem a None értékkel rendelkező mezőkből származó adatok az adattárházba lesznek exportálva, és belefoglalhatók az SQL-jelentésekbe.
Módosítható?=Csak helyszíni

TÖBBI:
FELESÉG: ReportingName³

húr

Megadja egy mező címkéjét, amikor az adatok megjelennek az SQL-jelentésekben. Ha nem ad meg értéket, a mező rövid neve lesz használva.
Módosítható?=Csak helyszíni

TÖBBI:
FELESÉG: ReportingReferenceName³

húr

Más hivatkozásnevet ad meg egy mezőhöz, amelyet az adatok relációs adattárházba való exportálásakor használnak. Ha nem ad meg értéket, a rendszer a mezők hivatkozási nevét használja.
Módosítható?=Csak helyszíni

REST: supportedOperations
FELESÉGE:

beállítás

Azon lekérdezési operátorok készlete, amelyek a mezőre való hivatkozáskor érvényesek. A támogatott műveletek adattípuson alapuló gyorshivatkozását az egyes adattípusokhoz támogatott lekérdezési gyorshivatkozások, operátorok és makrók című témakörben tekintheti meg.
Módosítható?=Nem

TÖBBI:
FELESÉG: Támogatja aTextQueryt

Logikai

Azt jelzi, hogy a mező támogatja-e a szöveges lekérdezéseket, például szavakat tartalmaz, nem tartalmaz szavakat.
Módosítható?=Nem

TÖBBI:
FELESÉG: SystemType

húr

Megadja a mező adattípusát, hivatkozva a rendszer nevére, például System.DateTime vagy System.String.
Módosítható?=Nem

REST: típus
FELESÉG: FieldType

húr

Megadja a mező adattípusát, például logikai, DateTime, egész szám, sztring stb. A teljes listát és leírást a Lekérdezés mezők, operátorok és makrók című témakörben találja.
Módosítható?=Nem

REST: használat
FELESÉG: Használat

húr

Megadja, hogy a mező munkaelemekkel (WorkItem) vagy munkaelem-hivatkozásokkal (WorkItemLink) használható-e. A legtöbb mező használata a WorkItem. A használati értékek teljes listájáért tekintse meg a Mezők lekérése, Mezőhasználat című témakört.
Módosítható?=Nem

Feljegyzés

1. Helyszíni üzemelő példányok esetén engedélyezheti egy mező indexelését a lekérdezési válaszidők javítása érdekében a mező szűrésekor. További információ: Indexelt mezők a cikk későbbi részében.
2. Az isPicklist és az isPicklistSuggested attribútumok csak örökölt folyamathoz definiált egyéni mezőkhöz vannak hozzárendelve. Az örökölt folyamatmodell az Azure DevOps Server 2019-ben és újabb verzióiban támogatott. További információ: Örökölt folyamatmodell.
3. Minden jelentési attribútum csak olyan helyszíni üzemelő példányokra érvényes, amelyek projektjei az SQL Server Reporting és az SQL Server Analysis Services támogatására lettek konfigurálva.

Mezőattribútumok listázása

A mezőkhöz hozzárendelt attribútumokat a Mezők – REST API lekérése funkcióval listázhatja. Adja meg a szervezet nevét a OrganizationName mezőben.

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

Itt például felsoroljuk az iterációs útvonal attribútumait, megadva a referencianevet a System.IterationPathfabrikam szervezet számára.

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

Visszaadott adatok:

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

Mezők hozzáadása és módosítása

Ha mezőket szeretne hozzáadni egy folyamathoz, vegye fel őket egy vagy több munkaelem-típusba. További információ: Öröklési folyamat testreszabása.

Kapcsolódó cikkek

• Rövid összefoglalás a lekérdezésekről
• Munkatétel mezőindex
• Öröklődő folyamat mezőinek hozzáadása és kezelése
• Az Azure Boards Analytics metaadat-referenciája