Munkaelemmezők kezelése

  • Cikk

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

Fontos

A helyszíni XML-folyamatmodell esetében a witadmin használatával listázhatja, importálhatja, exportálhatja és módosíthatja egy projekt folyamatait. Az örökölt és üzemeltetett XML-folyamatmodellek esetében csak a witadmin használatával listázhatja és exportálhatja a folyamatadatokat. A folyamatmodellek és a támogatott szolgáltatások áttekintéséért lásd : A munkakövetési élmény testreszabása.

A projektcsoporthoz (helyszíni XML-hez) definiált munkaelemtípusokhoz definiált mezőket az alábbi witadmin parancsokkal kezelheti. Ha globális (helyszíni XML-hez érvényes) mezőt szeretne hozzáadni, ezt a globális munkafolyamat-fájl módosításával és a gyűjteménybe való importálásával teheti meg.

  • changefield: Egy mező egy vagy több attribútumának módosítása. Az alábbi attribútumok egyikének módosításakor a projektgyűjteményben lévő összes munkaelemtípus és projekt esetében módosítja azt:

    • Adattípus vagy PlainTextHTML mezők.

      Fontos

      Ha a Team Foundation-kiszolgálót egy korábbi verzióról az aktuális verzióra frissíti, a Rendszer.Leírás mező típus-hozzárendelése automatikusan a következőre PlainTextHTMLalakul. A changefield paranccsal visszaállíthatja a mező tartalmát, hogy egyszerű szöveget jelenítsen meg.

    • A munkaelem-lekérdezésben megjelenő rövid név . Ez a név eltérhet a munkaeleműrlapon megjelenőtől.

    • Jelentési attribútumok , amelyek tartalmazzák a mező nevét a jelentésben megjelenő módon, a referenciajelentés nevét és a jelentés típusát.

    • Szinkronizálás az Active Directoryval – engedélyezheti vagy letilthatja a személynévmezők szinkronizálását.

  • deletefield: Törli a megadott mezőt.
  • listfields: Az összes vagy egy megadott mező attribútumait sorolja fel.

Feljegyzés

A witadmin indexfield parancs elavult az Azure DevOps Server 2019 és újabb verzióival. A mezők indexelése már nem szükséges.

A parancssori witadmin eszköz futtatása

A parancssori witadmin eszköz futtatásához nyisson meg egy parancssori ablakot, amelyen telepítve van a Visual Studio. A witadmin parancssori eszköz a Visual Studio bármely verziójával telepíthető. Ezt az eszközt a Visual Studio Community vagy a Visual Studio Team Explorer ingyenes verziójának telepítésével érheti el.

Feljegyzés

Az Azure DevOps Serviceshez való csatlakozáshoz javasoljuk, hogy a Visual Studio vagy a Visual Studio Community legújabb verzióját használja.

Feljegyzés

Helyszíni kiszolgálóhoz való csatlakozáshoz javasoljuk, hogy a Visual Studio ugyanazon vagy újabb verzióját használja, mint az Azure DevOps Server. Ha például az Azure DevOps Server 2019-hez csatlakozik, akkor a Visual Studio 2019 egyik verziójából csatlakozhat a projekthez.

Visual Studio 2022 esetén

%programfiles(x86)%\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

vagy ProfessionalEnterprise helyett, Communitya telepített verziótól függően.

Visual Studio 2019 esetén

%programfiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

vagy ProfessionalEnterprise helyett, Communitya telepített verziótól függően.

Visual Studio 2017

%programfiles(x86)%\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

vagy TeamExplorerProfessional helyett, Enterprisea telepített verziótól függően.

A Windows 32 bites kiadásában cserélje le a %programfiles(x86)% elemet %programfiles%-ra. A Visual Studio Community (amely hozzáférést biztosít a Team Explorerhez) vagy a Visual Studio Team Explorer 2017 ingyenesen telepíthető.

Az alapértelmezett folyamatsablonban definiált mezők áttekintéséért lásd : Munkaelem mezőindexe.

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.

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

További információ: Projektcsoportszintű engedélyek módosítása.

Feljegyzés

Ha rendszergazdai engedélyekkel jelentkezik be, akkor is meg kell nyitnia egy emelt szintű parancssori ablakot, hogy végrehajtsa ezt a funkciót a Windows Server 2008 rendszert futtató kiszolgálón. Emelt szintű parancssori ablak megnyitásához kattintson a Start gombra, nyissa meg a parancssor helyi menüjét, majd válassza a Futtatás Rendszergazda istratorként lehetőséget. További információkért lásd a Microsoft webhelyét: Felhasználói hozzáférés-vezérlés.

Syntax

witadmin changefield /collection:CollectionURL /n:RefName   [/name:NewName]    [/syncnamechanges:true | false]   [/reportingname:ReportingName]    [/reportingrefname:ReportingRefName]   [/reportingtype:Type]   [/reportingformula:Formula]   [/type:PlainText | HTML]   [/noprompt]  

witadmin deletefield /collection:CollectionURL /n:RefName [/noprompt]  

witadmin listfields /collection:CollectionURL /n:RefName [/unused]

Paraméterek

Paraméter Leírás
/collection:CollectionURL A projektgyűjtemény URI-ját adja meg. Példa:

Helyszíni formátum:http://ServerName:Port/VirtualDirectoryName/CollectionName
Ha nem használ virtuális könyvtárat, használja a következő formátumot: http://ServerName:Port/CollectionName.
/n:RefName
/n:Name		 Egy munkaelem típusú mező hivatkozásneve.
/index A megadott mező indexelésének engedélyezését vagy letiltását határozza meg. Az indexelés engedélyezéséhez és kikapcsolásához adja meg az indexelés letiltását.
/name:NewName Megadja a mező új nevét.
/syncnamechanges Itt adhatja meg, hogy a munkaelem mezővel tárolja a neveket, és a módosításokat az Active Directoryban vagy munkacsoportban végzett módosításokkal frissítse. Ez a beállítás csak akkor érvényes, ha a sztring adattípusú mező van megadva a typename.

Adja meg true az adatmező szinkronizálásának engedélyezését, az false adatmező szinkronizálásának letiltását.
/reportingname:ReportingName Megadja a jelentéskészítéshez használni kívánt adattárház mezőjének nevét.
/reportingrefname:ReportingRefName Megadja a jelentéskészítéshez használni kívánt adattárház mezőjének referencianevét.
/reportingtype:Type Megadja, hogyan használja a mező a raktárban a jelentéskészítéshez. A következő értékek érvényesek:

- dimension: Az Egész szám, a Sztring vagy a DateTime mezőhöz használatos.
- detail: Az egész szám, a dupla, a sztring vagy a DateTime mezőhöz használatos.
- measure: Az Egész és a Dupla mezőhöz használatos. Az alapértelmezett összesítési típus az összeg. A képletparaméterrel egy másik összesítési típust is megadhat.
- none: A mező jelentéskészítési funkciójának letiltására szolgál.

További információ: A munkaelem mezői és attribútumai.
/reportingformula:Formula A mező jelentésekor használandó összesítési képletet measureadja meg. Az egyetlen támogatott képlet az sum.
/type:HTML | PlainText Itt adhatja meg, hogy a mező tartalma áttér-e HTML a következőre.HTMLPlainTextPlainText Ezt a beállítást csak azokhoz a mezőkhöz adhatja meg, amelyek típus-hozzárendelése PlainText vagy HTML. Lásd: MEZŐ (Definíció) elemhivatkozás.
/unused Felsorolja azokat a mezőket, amelyeket a projektgyűjteményben definiált projektek nem használnak.
/noprompt Letiltja a megerősítés kérését.
/? vagy help A parancs súgóját jeleníti meg a Parancssor ablakban.

Személynevek szinkronizálása az Active Directoryval

Manuálisan engedélyeznie kell az Active Directoryra hivatkozó személynevek hozzárendeléséhez használt egyéni munkaelem-mezők szinkronizálását. Engedélyeznie kell a szinkronizálást minden olyan projektcsoporthoz, amely az egyéni mezőket tartalmazza.

Minden olyan rendszerhivatkozási mező, amely személyneveket jelenít meg, az attribútum syncnamechanges a következőre truevan állítva: . Ilyen mezők például a System.AuthorizedAs, a System.AssignedTo, a System.ChangedBy és a System.CreatedBy. A szinkronizálás engedélyezve van minden olyan személynévmező esetében, amely az egyik alapértelmezett folyamatsablonban van definiálva. További információ: Hozzárendelések és munkafolyamat-mezők.

A szinkronizálás engedélyezése után a mező már nem jelenít meg statikus sztringet. Ehelyett a mező a felhasználói fiókhoz társított nevet jeleníti meg. Amikor módosítja a felhasználónevet az Active Directoryban vagy a Munkacsoportban, a megadott true mező syncnamechanges automatikusan megjeleníti az új nevet.

Amikor egy Karakterlánc mezőhöz rendeli az syncnamechanges attribútumot, a mező mindig érvényes felhasználóneveket fogad el. A mező azonban nem engedélyezi a Team Foundation-kiszolgálón vagy az Active Directoryban tárolt csoportneveket, ha az alábbi feltételek valamelyike a következő true:

  • A VALIDUSER szabály minden munkaelem-típusban meg van adva

  • A VALIDUSER szabály egy munkaelem-típushoz van megadva

  • A ALLOWEDVALUES szabály egy munkaelemtípushoz van megadva, és a szabály szűrőfeltételekkel rendelkezik, amelyek kizárják a csoportokat

    További információ: Minden MEZŐ elem.

Az egyes munkaelemtípusokhoz módosítható attribútumok

A mezőhöz definiált alábbi attribútumokat vagy értékeket a munkaelem típusdefiníciójának módosításával módosíthatja, amelyben a mező megjelenik:

Példák

Ha másként nincs megadva, a következő értékek érvényesek az egyes példákban:

  • URI a projektgyűjteményhez: http://AdventureWorksServer:8080/tfs/DefaultCollection
  • Munkaelem mező neve: AdventureWorks.Field
  • Alapértelmezett kódolás: UTF-8

Mezők listázása

A witadmin listfields használt mezők halmazának megtekintéséhez válassza ki a munkaelem-típushoz hozzáadni kívánt mezőt. Emellett listázhatja az adott mezőhöz definiált attribútum-hozzárendeléseket, és meghatározhatja, hogy mely mezőket használják a projektek.

Munkaelem-mező attribútumainak megtekintése

  • Adja meg a következő parancsot egy adott mezőhöz definiált attribútumok listázásához, például Microsoft.VSTS.Common.Issue.

    witadmin listfields /collection:http://AdventureWorksServer: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. A mezőattribútumokról további információt a munkaelemmezők indexe című témakörben talál.

Projektgyűjtemény összes mezőinek listázása

  • A projektgyűjteményhez definiált összes mező listázásához írja be a következő parancsot.

    witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

    Megjelenik a nevesített projektgyűjtemény összes mezőjének mezőadatai. Lásd : Munkaelemmezők indexe.

Nem használt mezők listázása

  • Írja be a következő parancsot azoknak a mezőknek a listázásához, amelyeket már nem használnak a projektgyűjteményben semmilyen munkaelem-típus szerint.

    witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /unused

    A mező- és attribútumadatok minden olyan mezőnél megjelennek, amelyet nem használnak, ahogyan az ebben a példában látható.

    Field: Microsoft.VSTS.CMMI.TaskType  
Name: Task Type  
Type: String  
Reportable As: dimension  
Use: Not In Use  
Indexed: False  

Field: Microsoft.VSTSUE.Common.Flag  
Name: Flag  
Type: String  
Reportable As: dimension  
Use: Not In Use  
Indexed: False  

Field: Microsoft.VSTSUE.Common.Progress  
Name: Progress  
Type: String  
Reportable As: dimension  
Use: Not In Use  
Indexed: False

Mező átnevezése

Módosíthatja egy munkaelem-mező rövid nevét, hogy megfeleljen a csapat által használt elnevezési konvencióknak. Vegye figyelembe, hogy az új név minden olyan munkaelem-típusra vonatkozik, amely a projektcsoport összes projektjének módosított mezőjére hivatkozik. A rövid név akkor jelenik meg, ha szűrőfeltételeket határoz meg egy munkaelem-lekérdezésben. A munkaelem-űrlapon megjelenő név eltérhet a mezőhöz definiált rövid névétől.

Munkaelem-mező átnevezése

  1. Írja be a következő parancsot a fontos ranghoz rendelt rövid név átnevezéséhez.Microsoft.VSTS.Common.Rank

    witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Rank /name:"Important Rank"

  2. A megerősítést kérő parancssorba írja be az y értéket, majd nyomja le az ENTER billentyűt. Várjon, amíg megkapja a következő üzenetet:

    A mező átnevezve.

Egyetlen projektbe importált módosítások ellenőrzése

  1. A Team Explorerben válassza a Frissítés lehetőségetFrissítés.

    A legújabb frissítések a kiszolgálóról töltődnek le, amelyek tartalmazzák az imént végrehajtott módosításokat a mezőnéven. Várjon néhány másodpercet, amíg a frissítés befejeződik.

  2. Lekérdezés létrehozásához válassza az Új lekérdezés lehetőséget.

  3. A Lekérdezésszerkesztő kattintson ide, ha egy sor hozzáadásához záradékhivatkozást szeretne hozzáadni, jelölje ki az üres mezőcellát, és a cellába írja be a Rangsor parancsot. Az alábbi üzenet jelenik meg az eredménylista felett. Ez az üzenet azt jelzi, hogy a rangsor nem található.

    Futtassa a lekérdezést a lekérdezés eredményeinek megtekintéséhez. TF51005: A lekérdezés nem létező mezőre hivatkozik. A hibát a Rank>> okozza<<.

  4. Törölje a Rang értéket a Mező cellából, és írja be a fontos rangot a cellába.

  5. Jelölje ki <> az Operátor cellát, és írja be az 1 értéket az Érték cellába.

  6. A Lekérdezés eszköztáron válassza a Futtatás lehetőségetLekérdezés futtatása.

  7. Nyissa meg az eredmények bármelyik sorának helyi menüjét, és válassza az Oszlopbeállítások lehetőséget. Görgessen le az Elérhető oszlopok listában. Figyelje meg, hogy a Rang mező már nincs jelen, de a Fontos rang mező jelen van.

  8. Válassza a Fontos rangsor lehetőséget az Elérhető oszlopok mezőben, majd válassza a gombot (adja hozzá a > kijelölt oszlopokat). Válassza az OK lehetőséget.

    Figyelje meg, hogy a Microsoft.VSTS.Common.Rank rövid neve rangról fontos rangra lett átnevezve a lekérdezésszerkesztőben és az eredmények listájában.

  9. Zárja be a lekérdezést. Válassza a Nem lehetőséget, amikor a rendszer kéri a lekérdezés mentését.

  10. Hozzon létre egy új tevékenység munkaelemet. Válassza az Új munkaelemek hivatkozást, majd a Tevékenység lehetőséget.

    Ez a munkaelem a módosított és importált munkaelem-típusból jön létre.

  11. Figyelje meg, hogy az Állapot mezőben az átnevezett mező (Rank) címkéje nem változott. Ennek az az oka, hogy a munkaeleműrlapok mezőfeliratai hatóköre a szülőprojektre terjed ki, és független az imént megadott kiszolgálószintű mezőnévétől.

    Feljegyzés

    A munkaeleműrlapok mezőfeliratainak módosításáról további információt az XML-elemhivatkozások szabályozása című témakörben talál.

  12. Zárja be az új feladatot, és válassza a Nem lehetőséget, amikor a rendszer a munkaelem mentésére kéri.

Jelentés módosítása mező értékként

Az alábbi parancs az AdventureWorks.CreatedOn DateTime mező típusának dimenzióba történő jelentésére vonatkozó lehetőséget adja meg. A mező adatai a raktár- és Analysis Services-adatbázisokba kerülnek, hogy a jelentések szűrésére használhatók legyenek.

witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:AdventureWorks.CreatedOn /reportingtype:dimension

Az alábbi parancs azt a lehetőséget adja meg, hogy a mértékhez tartozó Kétmezős AdventureWorks.Field típust jelentse. Minden mérték összesítve van összegezve.

witadmin reportfield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:AdventureWorks.Field /reportingtype:measure

Egyéni személynév mező szinkronizálásának engedélyezése

Az alábbi parancs lehetővé teszi az AW munkaelem-mező szinkronizálását. Az AdventureWorksServer 1. gyűjteményéhez definiált CustomerName.

Ellenőrizze az átalakítani kívánt mező adattípusát

  1. Ellenőrizze a szinkronizálni kívánt mezőhöz (például MyCompany.CustomerName) rendelt adattípust a következő parancs beírásával:

    witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomerName

Szinkronizálás engedélyezése

  1. Egy személy által elnevezett mező szinkronizálásának engedélyezéséhez írja be a következő parancsot, és helyettesítse az itt látható argumentumok adatait:

    witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomerName /syncnamechanges:true

  2. Megjelenik a következő megerősítési üzenet:

    Ez megváltoztatja a Team Foundation-kiszolgáló mezőinek {0} tulajdonságait. Folytatja?

  3. Írja be a 0 billentyűt, hogy erősítse meg, hogy módosítani szeretné a mezőt, vagy 1-et a kérés visszavonásához.

    Ha a változáskérés sikeres, a következő megerősítő üzenet jelenik meg:

    A mező frissült.

    Ha a változáskérés sikertelen, hibaüzenet jelenik meg. A leggyakrabban előforduló hibák közé tartoznak a rendszerhivatkozási mező módosítása, vagy a Sztringen kívüli adattípus mezőinek módosítása. Ezek a műveletek nem támogatottak.

Mező törlése

Mielőtt töröl egy mezőt, ellenőrizze, hogy a mező nincs-e használatban. Ha a mező használatban van, először el kell távolítania a mezőt a használt munkaelem-típusok közül, mielőtt törölné a projektgyűjteményből. A következő parancs törli a mezőt AdventureWorks.Field a Gyűjtemény1 gyűjteményből:

witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:AdventureWorks.Field

Annak ellenőrzése, hogy egy mező nincs-e használatban

  1. Írja be a következő parancsot, és adja meg a munkaelem mező hivatkozásnevét, például MyCompany.MyProcess.MyField.

    witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.MyProcess.MyField

    A mezőhöz megjelenített információkban ellenőrizze, hogy a használat értéke "Nincs használatban" -e az alábbi példában leírtak szerint.

    Field: MyCompany.MyProcess.MyField  
Name: MyField  
Type: String  
Reportable As: dimension  
Use: Not In Use  
Indexed: False

  2. Ha a Használat mező azt jelzi, hogy a mező használatban van, akkor minden felsorolt projekt minden munkaelem-típusából törölnie kell. A mező például azt jelzi, Microsoft.VSTS.TCM.SystemInfo hogy a Hiba és kódhibák munkaelemtípus négy projekthez használja: Arroyo, Desert, Palm és Springs.

    Field: Microsoft.VSTS.TCM.SystemInfo  
Name: System Info  
Type: Html  
Reportable As: None  
Use: Arroyo (Bug), Desert (Bug), Palm (Bug), Springs (Bug, Code Defect)  
Indexed: False

    Mielőtt törölné ezt a mezőt, el kell távolítania azt minden olyan projekthez felsorolt munkaelem-típusból, amelyhez definiálva van. A mező eltávolításához módosítsa a munkaelem-típus definícióját a FIELD mezőhivatkozás nevét tartalmazó elemek és Control elemek törlésével. Lásd: Munkaelemtípusok importálása, exportálása és kezelése, MEZŐ (Definíció) elemhivatkozás és Vezérlőelem.

Mező törlése projektgyűjteményből

A mező törléséhez írja be a következő parancsot, majd válassza az MyCompany.MyProcess.MyField Enter billentyűt.

witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:RefName

A lépés végrehajtásához írja be az y értéket a megerősítést kérő üzenetbe.