Megosztás a következőn keresztül:

Mező hozzáadása vagy módosítása a munka nyomon követése érdekében

  • Cikk

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 Projektgazdák csoport tagjának kell lennie, vagy engedélyeznie kell a Projektszintű információ szerkesztése engedélyt.
  • A mezők törléséhez vagy átnevezéséhez vagy egy mező attribútumának módosításához a Team Foundation Rendszergazdák biztonsági csoportjának vagy a Projektgyűjteménygazdák 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.

Mezőattribútumok és mezőszabályok összegzése

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
Egyéni kiválasztólista

<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. CANNOTLOSEVALUE, EMPTY, FROZEN, NOTSAMEAS, READONLY, AND REQUIRED
Érték másolása vagy alapértelmezett érték megadása. COPY, DEFAULT és SERVERDEFAULT
Mező módosításának korlátozása. VALIDUSER, mezőszabály-attribútumok esetén és nem
A mintaegyezés kényszerítése egy sztringmezőn. GYUFA
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.

  1. Exportálja a WIT-definíciós fájlt a használt folyamatmodell alapján.

  2. Keresse meg az XML-fájl azon szakaszát, amely a következővel FIELDSkezdődik: .

  3. Adja hozzá a FIELD hozzáadni kívánt egyéni mező nevét meghatározó elemet. A következő kötelező attribútumokat kell megadnia: barátságos name, refname (hivatkozás neve) és type. 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.

  4. Adja hozzá az Control elemet a FORM szakaszhoz, 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&amp;gned To:" LabelPosition="Left" />
         <Control FieldName="System.State" Type="FieldControl" Label="&amp;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 FORM elem ö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.

  5. Importálja a WIT-definíciós fájlt a használt folyamatmodellnek megfelelően.

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

    Új mező az űrlapon

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

  1. Exportálja a WIT-definíciós fájlt a folyamatmodellnek megfelelően.

  2. FORM Layout A 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>

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

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

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.

  1. Távolítsa el a definíciót az FIELD összes WIT-definícióból és az arra hivatkozó globális munkafolyamatokból.

  2. 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: False

  3. Törölje a mezőt. Példa:

    witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomContact

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

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: