Megosztás:


Munkaelemmezők és -attribútumok listázása

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

A munkaelemmezők az Azure DevOpsban követik nyomon az információkat. A rendszer szervezeti szinten határozza meg ezeket a mezőket, és megosztja őket a szervezet összes projektjében. A szervezet számára definiált mezők áttekintéséhez használhatja az alábbi két eszköz egyikét, amely mind az örökölt, mind a üzemeltetett XML-folyamatmodellekhez elérhető:

A munkaelemmezők az Azure DevOpsban követik nyomon az információkat. A rendszer ezeket a mezőket a gyűjtemény szintjén határozza meg, és megosztja őket a gyűjtemény összes projektjén belül. A gyűjteményhez definiált mezők áttekintéséhez használja az alábbi eszközök egyikét:

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

Miért fontosak a munkaelemmezők?

A munkaelemmezők számos kritikus függvényt szolgálnak ki az Azure DevOpsban:

  • Adatkövetés: Alapvető információk rögzítése és tárolása a munkaelemekről
  • Lekérdezési funkciók: Hatékony keresési és szűrési képességek engedélyezése
  • Jelentéskészítés: Az elemzések és irányítópultok létrehozásának támogatása
  • Munkafolyamat-kezelés: Állapotváltások és üzleti szabályok meghajtása
  • Integráció: Csatlakozás külső eszközökkel és rendszerekkel

A mezőattribútumok ismertetése segít:

  • Lekérdezések optimalizálása: Válassza ki a megfelelő mezőket a hatékony kereséshez
  • Testreszabások megtervezése: Korlátozások és lehetőségek megismerése
  • Problémák elhárítása: A mező viselkedésével kapcsolatos problémák diagnosztizálása
  • Tervezési folyamatok: Hatékony munkaelemtípusok és munkafolyamatok létrehozása

Prerequisites

Category Requirements
Permissions A szervezethez vagy gyűjteményhez definiált mezők megtekintéséhez: A Projektgyűjtemény érvényes felhasználói alkalmazáscsoport tagja, vagy A példányszintű adatok megtekintése engedély beállítása A szervezet vagy gyűjtemény engedélyezése.

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

Mezők listázásához vagy áttekintéséhez használja az alábbi eszközök egyikét a folyamatmodell alapján – örökölt, üzemeltetett XML vagy helyszíni XML. Az alapértelmezett folyamatokban definiált mezők indexét lásd : Munkaelem mezőindexe.

Tool Inheritance Ü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 ✔️ ✔️ ✔️

Note

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

Mező adattípusai és nevei

Minden munkaelemtípus az adott típusú munkaelemekben szereplő mezőket határozza meg. Minden mező több attribútummal rendelkezik, amelyek közül sok rendszer által definiált és nem módosítható.

Három kulcsattribútum definiálja a mezőket:

  • Adattípus: A mezőbe beírható adatok típusát jelzi, például logikai, dupla, egész szám, HTML vagy sztring. Az egyes adattípusok részletes leírását a Lekérdezés mezők, operátorok és makrók című témakörben találja.
  • Rövid név: A mezőhöz rendelt felhasználóbarát név, amely egy mező lekérdezési záradékban való kijelölésekor használatos. Ez a név eltérhet a munkaelem-űrlapon megjelenő névtől.
  • Hivatkozás neve: WIQL-lekérdezések, munkaelem-sablonok, REST API-parancsok végrehajtása vagy XML-munkaelem-típusdefiníciók definiálásakor használt azonosító. A hivatkozás neve állandó, és a beállítás után nem módosítható.

Az egyes mezőattribútumok részletes leírását és a listázásukra vonatkozó utasításokat a jelen cikk későbbi részében, a Mezőattribútumok és a Mezőattribútumok listázása című témakörben találja. A munkaelemtípusok (WIT-ek) és a munkaelemek áttekintéséhez tekintse meg a felhasználói történetekkel, problémákkal, hibákkal, funkciókkal és eposzokkal végzett munka nyomon követését ismertető cikket.

Mi az a mező? Hogyan működnek a mezőnevek?

Minden munkaelemtípus 31 rendszermezőt és számos típusspecifikus mezőt tartalmaz. A munkaelemek segítenek a projekt megtervezésében és nyomon követésében.

Minden mező konkrét információkat rögzít az elvégzendő munkáról. Az ezekhez a mezőkhöz rendelt értékek a munkakövetési adattárban vannak tárolva, így állapotot és trendeket meghatározó lekérdezéseket hozhat létre.

Az alapvető rendszerfolyamatokhoz (Agile, Basic, Scrum és CMMI) definiált egyes mezők leírásáért és használatához tekintse meg a Munkaelem mezőindexet.

Mezőelnevezési követelmények

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

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

Mivel a rendszer egyéni mezőket határoz meg a szervezet vagy a gyűjtemény szintjén, nem adhat hozzá azonos nevű egyéni mezőket több folyamathoz.

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

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

A rendszer meghatározott elnevezési és szerkezeti követelményekkel rendelkező munkaelem-mezőket határoz meg a konzisztencia és a funkcionalitás biztosítása érdekében:

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

Mivel a rendszer egyéni mezőket határoz meg a szervezet vagy a gyűjtemény szintjén, nem adhat hozzá azonos nevű egyéni mezőket több folyamathoz.

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

Egyéni mezők

Mivel a rendszer egyéni mezőket határoz meg a szervezet vagy a projektcsoport szintjén, nem adhat hozzá azonos nevű egyéni mezőket több folyamathoz.

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

  • Munkaelemtípusonkénti mezők maximális száma (WIT): 64
  • Folyamatonkénti mezők maximális száma: 512

A mező adattípusa határozza meg a mezőben tárolható adatok típusát és méretét. Minden mező csak egy típust definiálhat egy projektgyűjteményben, ami ösztönzi a közös mezők használatát a különböző projektekben és munkaelem-típusokban.

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 mező nevét szóközök nélkül. Egy DevOps Triage nevű mező hozzáadása például a Custom.DevOpsTriage hivatkozási nevet eredményezi. A hivatkozásnevekben nem engedélyezett a szóközök használata.

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

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.

Képernyőkép a Szervezeti beállítások, a Folyamat, a Mezők lapról.

Ha a projektgyűjtemény az Öröklési folyamat modellel szabja testre a munkakövetést, a Folyamatmezők > lap megnyitásával megtekintheti a mezők adattípusát.

Képernyőkép a Gyűjtemény beállításai, a Folyamat, a Mezők lapról.

Ha a projektgyűjtemény a helyszíni XML-folyamatmodellt használja, az adattípust a Munkaelem mezőindex segítségével határozhatja meg. Másik lehetőségként:

  • Nyissa meg a Munkaelem mezőkezelőt a definiált mezők és attribútumaik áttekintéséhez.
  • A mezőattribútumok felsorolásához használja a witadmin listfields parancsot.

További információ: Munkaelem mezőkezelője és Lista mezőattribútumai a cikk későbbi részében.

Mezők listájának áttekintése

A szervezethez vagy gyűjteményhez definiált mezők listájának áttekintéséhez kövesse az alábbi lépéseket:

  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.

    Képernyőkép a Szervezeti beállítások kiválasztása lehetőségről.

  2. Válassza ki a folyamatot.

    Képernyőkép a Kiválasztási folyamatról.

  3. 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, amely magában foglalja az összes egyéni mezőt és a rendszerfolyamatokhoz definiált mezőket.

    Képernyőkép: Másolat készítése egy kijelölt öröklött folyamatról.

    Note

    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ásait, használati adatait és hivatkozásneveit a Munkaelem mezőindexben keresheti meg. Emellett a munkaelemtípusok mező – LISTA REST API használatával is lekérheti a mezőhivatkozások nevét.

Munkaelem mezőkezelője

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

Képernyőkép a Munkaelem mezőkezelőről.

A Munkaelem mezőkezelő eléréséhez telepítse a Folyamatszerkesztő eszközt. A Visual Studio telepített verziójától függően kérje le a Folyamatszerkesztő eszközt az alábbi bővítmények egyikéből.

  • Visual Studio 2019 & 2022: Egyelőre nem érhető el konkrét Folyamatsablon-szerkesztő bővítmény. A folyamatsablonokat azonban más eszközökkel, például szövegszerkesztővel vagy XML-szerkesztővel is testre szabhatja. Az Azure DevOps webes portált is használhatja bizonyos testreszabásokhoz, különösen az örökölt folyamatokhoz.
  • 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 felcserélhető és rejtett attribútum tartozik. Az alábbi táblázat külön ismerteti az egyes tulajdonságokat. Az attribútumoknak különböző neveik vannak attól függően, hogy a Mezők – REST API lekérése vagy a Munkaelem mezőkezelő (FELESÉG) eszközzel tekintik meg őket.

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

Attribute

Attribútum típusa

Description


REST:
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

boolean

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

karakterlánc

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

REST:
FELESÉG: AZONOSÍTÓ

Integer

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

REST:
FELESÉG: IsCloneable

boolean

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

REST:
FELESÉG: IsComputed

boolean

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

REST:
FELESÉG: IsCoreField

boolean

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

REST:
FELESÉG: IsEditable

boolean

Azt jelzi, hogy a felhasználók módosíthatják-e ezt a mezőt (Igaz) vagy sem (Hamis). Nem szerkeszthető mezők például a rendszer által beállított mezők, például az azonosító, a korrektúra, a létrehozási és a módosítási mező.
Módosítható?=Nem

REST: isIdentity
FELESÉG: IsIdentity

boolean

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

REST:
FELESÉG: IsIndexed1

boolean

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

REST:
FELESÉG: IsLongText

boolean

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: isPicklist2 FELESÉG:

logikai

Azt jelzi, hogy a mező társítva van-e egy picklistával. A rendszer igaz értékre állítja az értéket, amikor egyéni mezőt határoz meg az Azure DevOpshoz, és kiválasztja a Picklist (Sztring) vagy a Picklist (Egész szám) típust. A rendszer hamis értékre állítja a picklisteket meghatározó öröklött mezők értékét.
Módosítható?=Nem

REST: isPicklistSuggested2 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. A rendszer igaz értékre állítja az értéket, amikor egyéni mezőt határoz meg az Azure DevOpshoz, kiválasztja a Picklist (Sztring) vagy a Picklist (Egész szám) típust, és jelölje be a jelölőnégyzetet, hogy a felhasználók saját értékeket állítsanak be.
Módosítható?=Igen

REST: isQueryable
FELESÉG: IsQueryable

boolean

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

REST:
FELESÉG: IsReportable 3

boolean

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. Ezt az attribútumot a helyszíni környezetek esetében módosíthatja.
Módosítható?=Igen

REST:
FELESÉG: IsUsedInGlobalWorkflow

boolean

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

REST:
FELESÉG: IsUserNameField

boolean

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

karakterlánc

A mezőhöz rendelt rövid név. Az Azure DevOps barátságos nevét nem módosíthatja, de a helyszíni környezethez tartozó nevet módosíthatja a witadmin changefield paranccsal.
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. A rendszer egyedi GUID-értéket rendel hozzá, amikor egyéni mezőt határoz meg az Azure DevOpshoz, és kiválasztja a Picklist (Sztring) vagy a Picklist (Egész szám) típust.
Módosítható?=Nem

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

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

karakterlánc

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

REST:
FELESÉG: ReportingAttributes3

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. A rendszer olyan mezőkből exportál adatokat, amelyek ennél az attribútumnál nem None értékkel rendelkeznek, az adattárházba, és az SQL-jelentésekbe is belefoglalhatók.
Módosítható?=Csak helyszíni

REST:
FELESÉG: ReportingName3

karakterlánc

Megadja egy mező címkéjét, amikor az adatok megjelennek az SQL-jelentésekben. Ha nem ad meg értéket, a rendszer a mező felhasználóbarát nevét használja.
Módosítható?=Csak helyszíni

REST:
FELESÉG: ReportingReferenceName3

karakterlánc

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

REST: támogatott műveletek
WIFE:

set

A mezőre való hivatkozáskor érvényes lekérdezési operátorok gyűjteménye. 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

REST:
FELESÉG: Támogatja aTextQueryt

boolean

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

REST:
FELESÉG: SystemType

karakterlánc

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

karakterlánc

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

karakterlánc

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

Note

  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. A rendszer az isPicklist és az isPicklistSuggested attribútumokat csak az örökölt folyamathoz definiált egyéni mezőkhöz rendeli hozzá. Az örökölt folyamatmodell támogatja az Azure DevOps Server 2020 és újabb verzióit. 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. Cserélje le az OrganizationName nevet a tényleges szervezetnévre.

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

Az iterációs útvonal attribútumainak listázásához például használja a szervezet referencianevét System.IterationPathfabrikam :

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

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. A REST használatának megkezdéséhez tekintse meg az Azure DevOps Services REST API-referenciáit

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

Itt például felsoroljuk az iterációs útvonal attribútumait, megadva a fabrikam-kiszolgáló referencianevét System.IterationPath.

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

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

Attribútumok listázása witadmin parancssori eszközzel

A witadmin listfields paranccsal listázhatja a mezőattribútumokat – például az adattípust, a jelentéskészítési attribútumokat és az indexelést .

A következő paranccsal például listázhatja egy adott mezőhöz definiált attribútumokat, például a Microsoft.VSTS.Common.Issue parancsot.

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

A névvel ellátott mező mező- és attribútumadatai jelennek meg, ahogyan az ebben a példában is látható.

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  

A Use paraméter az egyes projektek nevét és azt a munkaelemtípust jelöli, ahol a mezőt használják.

Ajánlott eljárások a mezőkkel való munkához

A munkaelemmezők használatakor vegye figyelembe ezeket a javaslatokat:

Mező kijelölése és tervezése

  • Értelmes nevek kiválasztása: Leíró mezőnevek használata, amelyek egyértelműen jelzik a céljukat
  • Elnevezés egységesítése: Konzisztens elnevezési konvenciók létrehozása a szervezeten belül
  • Egyéni mezők korlátozása: Egyéni mezők hozzáadása megfontolt módon a felhasználók túlterheltségének elkerülése érdekében
  • Adattípusok megfontolása: Válassza ki a megfelelő adattípusokat a tárolt adatokhoz

Teljesítményoptimalizálás

  • Indexelt mezők használata: Helyszíni üzemelő példányok esetén fontolja meg a gyakran lekérdezett egyéni mezők indexelését
  • Kerülje a nehéz lekérdezéseket: Ügyeljen a lekérdezési teljesítményre számos mezőszűrő használatakor
  • A listák optimalizálása: A picklist-értékek méretben és rendezetten kezelhetők maradnak

Karbantartás és irányítás

  • Dokumentummezők használata: Az egyéni mezők célját és használatát ismertető dokumentáció karbantartása
  • Rendszeres felülvizsgálat: Rendszeresen tekintse át az egyéni mezőket a nem használt vagy redundáns mezők azonosítása érdekében
  • Változások megtervezése: A mezőmódosítások hatása a meglévő munkaelemekre és lekérdezésekre
  • Tesztmódosítások: Mindig a tesztmezők változásait kell először tesztelni egy fejlesztői környezetben

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.

Hozzáadhatja vagy módosíthatja a WIT-ben található mezőket, vagy hozzáadhat egy egyéni WIT-t. További információk:

A witadmin parancssori eszközzel bármely mező mezőnevét, indexét és jelentésattribútumait módosíthatja a rendszermezők kivételével. További információ: Munkaelemmezők kezelése–witadmin.

Mezőproblémák elhárítása

Gyakori problémák és megoldások a munkaelemmezők használatakor:

Mező láthatósági problémái

  • A mező nem jelenik meg: Ellenőrizze, hogy a mező hozzáadva van-e a munkaelem-típuselrendezéshez
  • Engedélyekkel kapcsolatos problémák: Ellenőrizze, hogy rendelkezik-e megfelelő engedélyekkel a mezők megtekintéséhez vagy szerkesztéséhez
  • Folyamatkülönbségek: Győződjön meg arról, hogy a mező létezik az aktuális folyamatban

Lekérdezési és keresési problémák

  • A mező nem kérdezhető le: Ellenőrizze a IsQueryable mező attribútumát
  • Teljesítménnyel kapcsolatos problémák: Fontolja meg a gyakran lekérdezett egyéni mezők indexelését (helyszíni)
  • Operátorokra vonatkozó korlátozások: Annak ellenőrzése, hogy mely operátorok támogatottak a mező adattípusához

Adatbevitel és -ellenőrzés

  • Érvénytelen értékek: Ellenőrizze, hogy a mező engedélyezett értékekkel vagy érvényesítési szabályokkal rendelkezik-e
  • Írásvédett mezők: A mező attribútumának IsEditable ellenőrzése
  • Formázási követelmények: Győződjön meg arról, hogy az adatok megfelelnek a várt mezőadattípusnak