Mező hozzáadása vagy módosítása a munka nyomon követése érdekében
Azure DevOps Server 2022 – Azure DevOps Server 2019
A projekt 100 vagy több adatmezőt tartalmaz a projekt létrehozásához használt folyamat alapján, például Agile, Basic, Scrum vagy CMMI. Minden munkaelem egy munkaelemtípushoz (WIT) van társítva, és a nyomon követhető adatok a WIT-hez rendelt mezőknek felelnek meg. A munkaelem adatait a munkaelem adatmezőjének módosításával frissítheti.
Feljegyzés
Az Azure DevOps Services vagy az örökölt folyamatmodellt használó projektgyűjtemények esetében lásd : Egyéni mező hozzáadása munkaelem-típushoz.
Módosíthatja a meglévő mezőket, vagy hozzáadhat egy egyéni mezőt a további adatkövetelmények nyomon követéséhez. Testreszabhatja például a legördülő menüben a kivétellistát, vagy hozzáadhat egy szabályt az alapértelmezett érték megadásához, vagy korlátozhatja a felvehető értéket.
Nem minden kivétellista van azonos módon definiálva. Egyes listák definiálása a felhasználói felületen, a WIT munkafolyamatán keresztül történik, vagy ha felhasználói fiókokat ad hozzá egy projekthez az alábbi táblázatban leírtak szerint.
| WIT-definíció | Parancssor módosítása (helyszíni XML-folyamat) |
|---|---|
| - Választáslista testreszabása - Szabályok hozzáadása mezőhöz - Egyéni mező hozzáadása - A mezőcímke módosítása az űrlapon - Egyéni vezérlő hozzáadása |
- Mezők listázása - Mezőattribútum módosítása - Mező törlése - Mező indexelése |
Előfeltételek
- A mezők listázásához a projekt projektszintű információinak megtekintése engedéllyel kell rendelkeznie az Engedélyezés gyűjteménykészletben.
- Mező hozzáadásához vagy testreszabásához a Project Rendszergazda istrators csoport tagjának kell lennie, vagy a projektszintű információ szerkesztési engedélyének Engedélyezés értékre kell állítania.
- Mezők törléséhez vagy átnevezéséhez vagy egy mező attribútumának módosításához a Team Foundation Rendszergazda istrators biztonsági csoportnak vagy a Project Collection Rendszergazda istrators biztonsági csoportnak kell lennie.
Rendszergazdaként való hozzáadáshoz módosítsa a projektcsoportszintű engedélyeket.
Metódusok a munkaelemmezők hozzáadásához
Munkaelem-mezők használatával nyomon követheti a munkaelem-típus adatait, és meghatározhatja a lekérdezések szűrési feltételeit, valamint jelentéseket hozhat létre. A nyomon követni kívánt adatelemeket a rendszermezők kivételével munkaelem-mezőként kell definiálni. A munkaelem-mezőket a munkaelem-típus vagy a globális munkafolyamat definíciója alapján határozhatja meg.
A projektcsoport munkaelemmezői megmaradnak. Az alábbi feladatok egyikének végrehajtásakor mezőket ad hozzá:
Hozzon létre egy projektet. Létrejön minden olyan mező, amely a munkaelem-típusok vagy a globális munkafolyamat definícióiban van definiálva, és amelyek a kiválasztott folyamatsablonhoz vannak definiálva. A rendszer minden projekthez definiált munkaelem-típushoz automatikusan definiálja az alapvető rendszermezőket. Ezeknek a mezőknek a listáját a Munkaelem mezőindexben találja.
WIT-definíció importálása. A munkaelem-típus definíciója alatt definiált összes új mező hozzá lesz adva a gyűjteményhez. További információ: Minden WITD XML-elemre vonatkozó hivatkozás.
Globális munkafolyamat-definíció importálása. A globális munkafolyamatban definiált összes új mező hozzá lesz adva a gyűjteményhez. Globális munkafolyamatot akkor határoz meg, ha olyan munkaelemmezőket szeretne fenntartani, amelyeket több típusú munkaelem oszt meg. További információ: Globális munkafolyamat testreszabása.
Minden olyan mező, amely az összes WIT-ben és az összes projekt összes globális munkafolyamatában definiálva van, a gyűjteményben definiált mezők teljes készletét alkotják. A meglévő mezők attribútumát módosíthatja, átnevezheti és törölheti. Bizonyos költségek merülnek fel azonban, amikor ilyen módosításokat hajt végre, különösen a helyszíni kiszolgáló és a jelentéskészítés esetében.
Gyűjtemény mezőinek hozzáadásához vagy testreszabásához módosítsa a WIT-definíció XML-tartalmát. Az egyes mezők definiálása a WIT-definíció MEZŐK szakaszában található MEZŐ elemen keresztül. A fájlok szerkezetéről és helyéről további információt a Minden MEZŐ XML-elem hivatkozásában talál.
Mező hozzáadása, szabály alkalmazása vagy attribútum módosítása
Egyéni mező hozzáadásához, mezőszabályok hozzáadásához vagy egy munkaeleműrlap mezőinek címkéjének módosításához módosítania kell a munkaelem típusát (WIT) vagy a mezőt használó típusokat. Kövesse a folyamatmodellnek megfelelő testreszabási sorrendet .
Mezőattribútum módosításához vagy mező átnevezéséhez használja a witadmin parancssori eszközt. Ellenkező esetben egy mező módosításához hozzáadja vagy módosítja a mezőhöz társított szabályokat egy WIT-definícióban.
WIT-definíciós fájl szerkesztése
Szabályok hozzáadásához vagy egyéni mező hozzáadásához exportálja, szerkessze, majd importálja a WIT-definíciós fájlt.
Tipp.
A witadminnal definíciós fájlokat importálhat és exportálhat. Egyéb használható eszközök: a Folyamatszerkesztő (ehhez telepítenie kell a Visual Studio egy verzióját). Telepítse a Folyamatsablon szerkesztőt a Visual Studio Marketplace-ről.
Az adatok nyomon követésére használni kívánt mezőket hozzá kell adni a WIT definíciós fájlhoz. Ez minden rendszermezőre igaz (olyan mezőkre, amelyek hivatkozási neve a System névvel kezdődik). Minden rendszermező definiálva van az összes WIT-hez, függetlenül attól, hogy szerepel-e bennük a WIT-definíció. Az egyes mezőkről további információt a Munkaelem mezőindex című témakörben talál.
Jelölőnégyzet vagy logikai mező hozzáadása
Az alábbi szintaxissal adhat hozzá logikai mezőt a WIT-definíció MEZŐK szakaszában.
<FIELD name="Triage" refname="Fabrikam.Triage" type="Boolean" >
<DEFAULT from="value" value="False" />
<HELPTEXT>Triage work item</HELPTEXT>
</FIELD>
Ezután adja hozzá a következő szintaxist az ŰRLAP szakaszban, hogy a mező megjelenjen az űrlapon.
<Control Label="Triage" Type="FieldControl" FieldName="Fabrikam.Triage" />
A mező jelölőnégyzetként jelenik meg az űrlapon.
Választáslista testreszabása
A listaválasztás a munkaelem-űrlap legördülő menüjében és a lekérdezésszerkesztő Érték oszlopában megjelenő számbavételi értékek. A pick list testreszabásához használt módszer a mezőtől függően változik.
Ha módosítani szeretné a munkaeleműrlap legtöbb sztring- vagy egészmezőjének kiválasztólistáját, szerkessze a WIT-definíciót. Ha például fel szeretne venni egy egyéni Felbontás mezőt és egy pick-listát, adja meg az XML-kódot az ábrán látható módon.
Egyéni mező és lista kiválasztása
<FIELD name="Resolution" refname="MyCompany.Resolution" type="String">
<ALLOWEDVALUES>
<LISTITEM value="By Design" />
<LISTITEM value="Duplicate" />
<LISTITEM value="External" />
<LISTITEM value="Fixed" />
<LISTITEM value="Not Repro" />
<LISTITEM value="Postponed" />
<LISTITEM value="Won't Fix" />
</ALLOWEDVALUES>
</FIELD>
A szabályok támogatják a listák kombinálását, a listák hatókörének korlátozását, valamint a feltételek beállítását, amikor egy lista megjelenik a munkaelem-űrlapon. A szabályok azt szabályozzák, hogy egy terjesztési lista ki van-e bontva az egyes tagok megjelenítéséhez, vagy a listákat az opcionális expanditems és filteritems attribútumok használatával szűrik. Globális listák használatával minimalizálhatja a WIT-eken vagy projekteken keresztül megosztott listák frissítéséhez szükséges munkát.
Ha egy listát több WIT-ben vagy több projektben használ, a globális listaként való karbantartás minimálisra csökkenti a karbantartási követelményeket. Ha azt is szeretné, hogy a listák egyes részei különbözőként jelenjenek meg a WIT-ekben vagy projektekben, globális listát is definiálhat a lista egy részének. Lásd: Listaválasztási listák definiálása és globális listák definiálása.
Szabályok hozzáadása mezőhöz
Ha egyéni mezőt szeretne hozzáadni, vagy szabályokat szeretne hozzáadni egy mezőhöz, szerkessze a WIT-definíciót. Korlátozhatja, hogy a szabályok adott felhasználókra vagy csoportokra vonatkozzanak. A legtöbb szabály támogatja az attribútumokat, vagy nem, hogy a szabály arra összpontosítson, akire a szabály vonatkozik, és nem.
A következő kódrészlettel például kikényszerítheti azt a szabályt, hogy a munkaelem létrehozása után csak a felügyeleti csapat, egy ügyfél által definiált TFS-csoport tagjai módosíthatják a Stack Rank mezőt.
<FIELD name="Stack Rank" refname="Microsoft.VSTS.Common.StackRank" type="Double" reportable="dimension">
<FROZEN not="[project]\Management Team" />
<HELPTEXT>Work first on items with lower-valued stack rank. Set in triage.</HELPTEXT>
</FIELD>
A következő műveletek végrehajtásához szabályokat kell alkalmaznia:
| A művelet végrehajtása: | Használja ezt az XML-elemet: |
|---|---|
| Adjon meg egy eszköztippet. | SÚGÓSZÖVEG |
| A mező értékének minősítése. | CANNOTLO STANDARD KIADÁS VALUE, EMPTY, FROZEN, NOTSAMEAS, READONLY ÉS REQUIRED |
| Érték másolása vagy alapértelmezett érték megadása. | MÁSOLÁS, ALAPÉRTELMEZETT és Standard kiadás RVERDEFAULT |
| Mező módosításának korlátozása. | VALIDU Standard kiadás R, mezőszabály-attribútumok esetén és nem |
| A mintaegyezés kényszerítése egy sztringmezőn. | MÉRKŐZÉS |
| Feltételesen alkalmazza a szabályokat más mezők értékei alapján. | MIKOR, WHENNOT, WHENCHANGED ÉS WHENNOTCHANGED |
A rendszermezők, amelyek nevei a "System" előtaggal kezdődnek (például System.ID), a rájuk alkalmazható szabályok korlátozottak. Nem másolhat és nem állíthat be üres mezőket a munkaelem vagy a rendszer által használt dátum-idő mezők létrehozásának, módosításának vagy bezárásának nyomon követésére.
A mezőszabályok és korlátozások alkalmazásával kapcsolatos további információkért lásd: Szabályok és szabályértékelés.
Egyéni mező hozzáadása
Egyéni mező hozzáadásához szerkessze a WIT-definíciót, és adjon hozzá egy MEZŐ elemet a MEZŐK szakaszon belül, és egy Vezérlő elemet a FORM szakaszon belül.
Exportálja a WIT-definíciós fájlt a használt folyamatmodell alapján.
Keresse meg az XML-fájl azon szakaszát, amely a következővel
FIELDSkezdődik: .Adja hozzá a
FIELDhozzáadni kívánt egyéni mező nevét meghatározó elemet. A következő kötelező attribútumokat kell megadnia: barátságosname,refname(hivatkozás neve) éstype. További információ: MEZŐ (Definíció) elemhivatkozás.Az alábbi kód megadja az egyéni mezőt, a Kérelmezőt, amelynek hivatkozási neve
FabrikamFiber.MyTeam.Requestorés az engedélyezett értékek listájának kiválasztása az Ügyfél alapértelmezett értékével együtt szerepel.<FIELD name="Requestor" refname="FabrikamFiber.MyTeam.Requestor" type="String" reportable="Dimension"> <ALLOWEDVALUES> <LISTITEM value="Customer" /> <LISTITEM value="Executive Management" /> <LISTITEM value="Other" /> <LISTITEM value="Support" /> <LISTITEM value="Team" /> <LISTITEM value="Technicians" /> <DEFAULTVALUE value="Customer" /> </ALLOWEDVALUES> </FIELD>Tipp.
A listában szereplő elemek mindig alfanumerikus sorrendben jelennek meg, függetlenül attól, hogy hogyan adhatja meg őket az XML-definíciós fájlban. A hivatkozás neve vagy
refnamea mező programozott neve. Az összes többi szabálynak a .-refnamera kell hivatkoznia. További információ: Elnevezési korlátozások és konvenciók.Adja hozzá az
Controlelemet aFORMszakaszhoz, hogy az egyéni mező megjelenjen az űrlapon azon elemek csoportján belül, ahol meg szeretné jeleníteni.Az alábbi kódrészlet például hozzáadja a Kérelmező mezőt a munkaelem űrlap Ok mezőjéhez.
<Column PercentWidth="50"> <Group Label="Status"> <Column PercentWidth="100"> <Control FieldName="System.AssignedTo" Type="FieldControl" Label="Assi&gned To:" LabelPosition="Left" /> <Control FieldName="System.State" Type="FieldControl" Label="&State:" LabelPosition="Left" /> <Control FieldName="System.Reason" Type="FieldControl" Label="Reason:" LabelPosition="Left" ReadOnly="True" /> <Control FieldName="FabrikamFiber.MyTeam.Requestor" Type="FieldControl" Label="Requestor:" LabelPosition="Left" ReadOnly="True" /> </Column> </Group> </Column>Tipp.
A munkakövetés sémadefiníciója az
FORMelem összes gyermekelemét tevees esetként, az összes többi elemet pedig nagybetűsként határozza meg. Ha hibát tapasztal a típusdefiníciós fájlok ellenőrzésekor, ellenőrizze az elemek kis- és nagybetűk szerkezetét. A nyitó és záró címkék kis- és nagybetűszerkezetének is meg kell egyeznie az XML-szintaxis szabályainak megfelelően. További információ: Control XML element reference.Importálja a WIT-definíciós fájlt a használt folyamatmodellnek megfelelően.
Nyissa meg a webportált vagy a Csapatkezelőt a módosítások megtekintéséhez. Ha az ügyfél már meg van nyitva, frissítse a lapot.
Az alábbi ábrán látható, hogy a termékháttérelem munkaeleműrlapja most már tartalmazza az új mezőt.
A mezőcímke módosítása munkaeleműrlapon
A mezőcímke módosításához módosítsa az elemattribútumhoz ControlLabel rendelt értéket. Ha el szeretne távolítani egy mezőt a munkaeleműrlapról, törölje a Control mezőhöz társított elemet.
Exportálja a WIT-definíciós fájlt a folyamatmodellnek megfelelően.
FORMLayoutA szakaszokban keresse meg a módosítani kívánt mező definícióját. Ez a példa módosítja a Cím mező címkéjét:<Column PercentWidth="70"> <Control Type="FieldControl" FieldName="System.Title" Label="Title" LabelPosition="Left" /> </Column>Módosítsa a mező címkéjét, hogy az adott projekten dolgozó portugál fiókiroda felolvassa a Cím mező nevét, amikor a munkaelem-űrlapon dolgoznak. Adja meg a portugál címszót (Titulo) a Cím mezőben.
<Column PercentWidth="70"> <Control Type="FieldControl" FieldName="System.Title" Label="Title (Titulo):" LabelPosition="Left" /> </Column>Importálja a módosított WIT-definíciót.
Egyéni vezérlő hozzáadása
A REST API-k használata a munkaelemek nyomon követéséhez programozott módon hozhat létre, módosíthat és kereshet hibákat, feladatokat és egyéb WIT-eket. Létrehozhat saját egyéni vezérlőket is, amelyek funkcióval bővítik a munkaelem-űrlapokat.
Vagy hozzáadhat egy egyéni vezérlőt is, amely a Visual Studio Marketplace-en keresztül érhető el. Példa:
- Többértékű vezérlőelem , amely támogatja egy mező több értékének bevitelét a jelölőnégyzetek listájának megjelenítésével
- Színválasztó lista vezérlőelem , amely támogatja a szín hozzáadását a listaelemek kiválasztásához
- A munkaelem egy kattintásos műveleteket alkot, amelyek egy csoportbővítményt biztosítanak testre szabható szabályokkal, amelyek támogatják az egykattintásos műveletet.
Ha egyéni vezérlőt szeretne hozzáadni az új webes űrlaphoz, tekintse meg a WebLayout és a Control elemeket.
Meglévő mező attribútumának módosítása
A witadmin changefield használatával módosíthatja egy meglévő mező attribútumait. Az alábbi parancs például kiértékelési módszerre módosítja a MyCompany.Type típushoz definiált felhasználóbarát nevet.
witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.Type /name:"Evaluation Method"
Az alábbi táblázat a witadmin changefield használatával módosítható attribútumokat foglalja össze.
| Attribútum | Leírás |
|---|---|
| Adattípus | A mező által elfogadott adattípust adja meg. A mező adattípusát a definiálás után általában nem módosíthatja. A mező adattípusát csak HTML vagy Egyszerű szöveg típusú mezőkre módosíthatja. |
| Rövid név | A rövid név megjelenik a munkaelem-lekérdezések legördülő menüjében, és egyedinek kell lennie a projektgyűjteményben definiált összes mezőre vonatkozóan. A rövid név eltérhet a munkaeleműrlapon megjelenő űrlapcímkétől. |
| Jelentéskészítési attribútumok | Módosíthatja a mező nevét a jelentésben megjelenő módon, a jelentés hivatkozási nevét és a jelentés típusát. Honosíthatja a jelentéskészítési felhasználóbarát nevet. A jelentés típusa határozza meg, hogy a mező adatai a relációs raktár adatbázisába, a relációs raktár adatbázisába és az OLAP-kockába is íródjanak-e, vagy előre kiszámított értékösszeget generáljanak az OLAP-kocka feldolgozásakor. Az alapértelmezett jelentéskészítési mezők teljes listáját a Jelentéskészítés mezők hivatkozásában találja. A jelentéskészítési attribútumokkal kapcsolatos további információkért lásd: Munkaelemmezők és -attribútumok, Jelentéskészítési attribútumok. |
| Szinkronizálás | Az Active Directoryval engedélyezheti vagy letilthatja a személynév mezők szinkronizálását. |
Mező indexattribútumának módosítása
Engedélyezheti egy mező indexelését a lekérdezési válaszidők javításához a mező szűrésekor. Alapértelmezés szerint a következő mezők indexelve vannak: Hozzárendelve, Létrehozva dátum, Módosítás dátuma, Állapot, Ok, Területazonosító, Iterációazonosító és Munkaelem típusa.
Egy mező indexelésének engedélyezéséhez vagy letiltásához használja a witadmin indexmező parancsot.
Mező törlése
Ha eltávolít egy mezőt egy adott típusú munkaelemből, a rendszer nem távolítja el a mezőt a gyűjteményből vagy az adatbázis-kiszolgálóról, még akkor sem, ha már nem hivatkozik rá semmilyen WIT. Mező eltávolításához kövesse az alábbi lépéseket.
Távolítsa el a definíciót az
FIELDösszes WIT-definícióból és az arra hivatkozó globális munkafolyamatokból.Ellenőrizze, hogy a mező nincs-e használatban. Példa:
witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomContact Field: MyCompany.CustomContact Name: Custom Contact Type: String Reportable As: dimension Use: Not In Use Indexed: FalseTörölje a mezőt. Példa:
witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomContactHa a törölt mező jelentéskészítésre alkalmas volt, és a projekt az SQL Server Reporting Servicest használja, építse újra az adattárházat a régi mező és értékeinek kiürítéséhez.
További információ: Munkaelemmezők kezelése.
Tesztelési, buildelési és verziókövetési mezők
Számos munkaelem-típus olyan mezőket tartalmaz, amelyek a Team Foundation buildel, a Microsoft Test Managerrel és a Team Foundation verziókövetésével integrálható automatizált folyamatok által generált információkat tartalmaznak. Ha ezen mezők egyikét hozzá szeretné adni az egyéni WIT-ekhez, a jelen témakörben korábban ismertetett lépéseknek megfelelően szerkessze a WIT-definíciót .
Hozzáadhatja például a Beépített és a Beépített beépített mezőket, amelyek a hibák típusdefinícióiban jelennek meg. Ezek a mezők a hibákat azokhoz a buildekhez társítják, ahol azokat megtalálták vagy kijavították. A következő kódrészlet használatával felveheti ezeket a mezőket egy munkaelemtípus-definícióba.
<FIELD name="Found In" refname="Microsoft.VSTS.Build.FoundIn" type="String" reportable="dimension">
<HELPTEXT>Product build number (revision) in which this item was found</HELPTEXT>
</FIELD>
<FIELD name="Integration Build" refname="Microsoft.VSTS.Build.IntegrationBuild" type="String" reportable="dimension">
<HELPTEXT>Product build number this bug was fixed in</HELPTEXT>
</FIELD>
További információ: Az integrációs mezők összeállítása és tesztelése alapján végzett lekérdezés.
Mezőnevek és jelentéskészítés
Felvehet mezőket, vagy módosíthatja a meglévő mezők attribútumait a jelentéskészítés támogatásához. Mezők hozzáadásakor vagy módosításakor rendszeresen el kell neveznie őket, hogy megtalálhassa a mezőt az Analysis Services-kockában, mert a mezők logikailag mappákba vannak csoportosítva. További információ: Munkaelemmezők hozzáadása vagy módosítása a jelentéskészítés támogatásához.
Kapcsolódó cikkek
Ez a cikk azt ismerteti, hogyan adhat hozzá és szabhat testre mezőket a üzemeltetett XML- és helyszíni XML-folyamatmodellekhez. Az üzemeltetett XML- és helyszíni XML-folyamatmodellekhez tartozó munkaelemtípusok hozzáadásáról és testreszabásáról további információt a munkaelem-típus hozzáadása vagy módosítása című témakörben talál. Az öröklési folyamat modellje a folyamat testreszabása című témakörben található.
Egyéb kapcsolódó témakörök vagy források:
Visszajelzés
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ: https://aka.ms/ContentUserFeedback.
Visszajelzés küldése és megtekintése a következőhöz: