Jegyzet
Az oldalhoz való hozzáférés engedélyezést igényel. Próbálhatod be jelentkezni vagy könyvtárat váltani.
Az oldalhoz való hozzáférés engedélyezést igényel. Megpróbálhatod a könyvtár váltását.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
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 witadmin parancssori eszköz hatékony képességeket biztosít a projektgyűjtemény munkaelem-mezőinek kezeléséhez. Függetlenül attól, hogy át kell neveznie a mezőket, módosítania kell az adattípusokat, vagy konfigurálnia kell az identitásszolgáltatókkal való szinkronizálást, ezek a parancsok részletes vezérlést biztosítanak a munkakövetési élmény felett.
A witadmin mezőparancsokkal elvégezhető műveletek
A következő witadmin parancsokkal kezelheti a mezőket a gyűjtemény összes munkaelemtípusában és projektjében:
-
changefield: A gyűjteményszintű mezőattribútumok módosítása, beleértve a következőket:-
Adattípus konvertálása a formátumok és a
PlainTextformátumok közöttHTML
Fontos
Az Azure DevOps Server frissítésekor a Leírás mező (System.Description) automatikusan átvált
PlainTexta következőreHTML: . Ha szükséges, achangefieldparancs használatával állítsa vissza a parancsot.- A munkaelem-lekérdezésekben megjelenő rövid nevek (eltérhetnek az űrlapfeliratoktól)
- Adatraktár-integráció jelentési attribútumai
- Identitásszinkronizálás a Microsoft Entra-azonosítóval vagy az Active Directoryval
-
Adattípus konvertálása a formátumok és a
-
deletefield: A nem használt mezők eltávolítása a gyűjteményből -
listfields: Mezőattribútumok és -használat megtekintése projektek között
Tipp.
- Ha globális mezőket szeretne hozzáadni a helyszíni XML-környezetekhez, módosítsa a globális munkafolyamat-fájlt , és importálja azt a gyűjteménybe.
- A
witadmin indexfieldparancs elavult. A mezőindexelés automatikusan megtörténik.
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
| Feladatok | Szükséges engedélyek |
|---|---|
| Mezők listázása | A projektszintű információ engedélykészletének megtekintése a gyűjtemény projektjének engedélyezése beállításhoz |
| Mezők törlése vagy átnevezése | A Projektgyűjtemény rendszergazdái biztonsági csoport tagja |
| Mezőattribútumok módosítása | A Projektgyűjtemény rendszergazdái biztonsági csoport tagja |
További információkat a Projektgyűjtemény-szintű engedélyek módosítása szakaszban talál.
Feljegyzés
Még akkor is, ha rendszergazdai engedélyekkel jelentkezik be, egy rendszergazda jogú parancssori ablakot kell megnyitnia, hogy végrehajtsa ezt a függvényt egy Windows Servert 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 rendszergazdaként parancsot.
Syntax
A következő parancsszintaxis-minták használatával kezelheti a munkaelemmezőket a witadmin eszközzel:
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/CollectionNameHa 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. |
/name:NewName |
Megadja a mező új nevét. |
/syncnamechanges |
Itt adhatja meg, hogy a munkaelem mezővel tárolja a neveket, és hogy a módosításokat a Microsoft Entra-azonosítóban, az Active Directoryban vagy egy munkacsoportban végezhesse el. 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. Adja meg false az 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 PlainText a következőre.HTMLHTMLPlainText 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 a Microsoft Entra-azonosítóval és az Active Directoryval
Egyéni személynév mezők konfigurálása automatikus frissítésre, amikor a felhasználónevek megváltoznak az identitásszolgáltatóban.
Mikor kell engedélyezni a szinkronizálást?
Csak egyéni mezők: Manuálisan kell engedélyeznie a szinkronizálást a személynevek hozzárendeléséhez használt egyéni munkaelem-mezők esetében.
Rendszermezők: Minden beépített személynév mező automatikusan engedélyezi a szinkronizálást:
System.AssignedToSystem.ChangedBySystem.CreatedBy
Identitásszolgáltató támogatása
| Környezet | Identitásszolgáltató |
|---|---|
| Azure DevOps Services | Microsoft Entra ID |
| Azure DevOps Server | Active Directory vagy munkacsoport |
A szinkronizálás működése
| Állam | Magatartás |
|---|---|
| Engedélyezés előtt | A mező statikus szöveges sztringeket jelenít meg |
| Engedélyezés után | A mező az identitásszolgáltató aktuális felhasználónevet jeleníti meg |
| Amikor a nevek megváltoznak | Automatikus frissítéssel rendelkező syncnamechanges=true mezők |
Csoportnévkorlátozások
Ha engedélyezi az syncnamechanges attribútumot egy Sztring mezőben, az érvényes felhasználóneveket fogad el, de nem engedélyezi a csoportneveket , ha az alábbi feltételek valamelyike érvényes:
-
VALIDUSERminden munkaelem-típusra megadott szabály -
VALIDUSERadott munkaelem-típushoz megadott szabály -
ALLOWEDVALUESa csoportokat kizáró szűrési feltételekkel megadott szabály
Konfigurációs hatókör
Fontos
Engedélyeznie kell a szinkronizálást minden olyan projektcsoport minden mezőjéhez, amely tartalmazza az egyéni mezőket.
További információkért lásd:
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:
- A munkaelem űrlapon megjelenő név . Lásd: WebLayout and Control elements or Control XML element reference.
- Súgószöveg. Lásd: Szabályok és szabályértékelés.
- A pick listában vagy legördülő menüben engedélyezett értékek vagy elemek. Lásd: ALLOWEDVALUES, SUGGESTEDVALUES és PROHIBITEDVALUES XML-elemek.
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 nem használt mezők mező- és attribútumadatai jelennek meg, ahogyan az ebben a példában is 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. Az új nevet az összes olyan munkaelemtípusra alkalmazza a rendszer, 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
Írja be a következő parancsot a fontos ranghoz rendelt rövid név átnevezéséhez.
Microsoft.VSTS.Common.Rankwitadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Rank /name:"Important Rank"A megerősítést kérő üzenetben adja meg
y, majd válassza 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
A Team Explorerben válassza a Frissítés lehetőségetRefreshIcon_refreshNode.
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.
Lekérdezés létrehozásához válassza az Új lekérdezés lehetőséget.
A Lekérdezésszerkesztőben kattintson ide a záradékhivatkozás hozzáadásához , jelölje ki az üres mezőcellát , majd írja be
Ranka cellába. 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 következő okozza
<\<Rank>>: .Törölje a Rang értéket a Mező cellából, és írja be
Important Ranka cellába.Jelölje ki <> az Operátor cellát, és írja be
1az Érték cellába.A Lekérdezés eszköztáron válassza a Futtatás lehetőséget
.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.
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 rövid neve. A rangot a lekérdezésszerkesztő és az eredmények listája során rangrólfontos rangra nevezik át.
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.
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.
Figyelje meg az Állapot mezőben, hogy az átnevezett mező rangcímkéje nem változott. A munkaeleműrlapok mezőfeliratai hatóköre a szülőprojektre terjed ki, és független a megadott kiszolgálószintű mező nevével.
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.
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. Az összes mérték összesítése összeg szerint.
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
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
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:trueMegjelenik a következő megerősítési üzenet:
Ez megváltoztatja az Azure DevOps Server mezőinek {0} tulajdonságait. Folytatja?
Írja be
0a mezőt annak megerősítéséhez, hogy módosítani szeretné a mezőt, vagy1megszakítja a kérést.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 az azt használó munkaelem-típusokbó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 nincs-e használatban egy mező
Í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.MyFieldA 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: FalseHa 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.SystemInfohogy 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: FalseMielő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
FIELDmezőhivatkozás nevét tartalmazó elemek ésControlelemek 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.