Share via


Elnevezési korlátozások és konvenciók

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

Az Azure DevOps legtöbb összetevőjének az elnevezési korlátozásokat és konvenciókat kell követnie. A korlátozások biztosítják a konzisztens felhasználói élményt, és kompatibilitást biztosítanak más alkalmazásokkal.

A gyakori korlátozások közé tartozik a név karakterhosszának túllépése, a speciális karaktereket nem tartalmazó, valamint az objektumkészleten belüli nevek egyediségének fenntartása.

Feljegyzés

A definiálható elemek számának korlátait a Munkahelyi nyomon követés, a folyamat és a projektkorlátok című témakörben találja.

Általános megfontolások

A cikkben szereplő hosszkorlátozásokat az engedélyezett Unicode-karakterek száma méri. A helyettesítő karakterek két Unicode-karakterből állnak, amelyek a hosszkorlátozástól számítva két karakternek számítanak. További információ: A Unicode és a karakterkészletek ismertetése.

Más operációsrendszer-fájlokhoz hasonlóan az ASCII vezérlőkarakterek (ASCII 1-31) és a helyettesítő kombinációk sem engedélyezettek. A fájlnevekre alkalmazott operációsrendszer-korlátozásokkal kapcsolatos általános információkért lásd : Fájlok, elérési utak és névterek elnevezése.

Fenntartott rendszernevek

Kerülje a fenntartott rendszernevek használatát, például az alábbi példákat:

  • AUX
  • COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10
  • CON
  • DefaultCollection
  • LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9
  • NUL
  • PRN
  • Standard kiadás RVER, SignalR
  • Web vagy WEB

További információ a fenntartott nevekről: Fájlnevek, elérési utak és névterek.

Azure Artifacts

Az univerzális csomagoknak meg kell felelniük a következő korlátozásoknak.

Korlátozás típusa Korlátozás
Csomag neve - Kisbetűsnek kell lennie.
- Betűkkel vagy számokkal kell kezdődnie és végződnie.
- Csak betűket, számokat és nem folytonos kötőjeleket, aláhúzásjeleket vagy pontokat tartalmazhat.
Csomag verziója A metaadatok összeállítása nélkül kisbetűsnek kell lennie.

Azure Boards

A munkaelemek segítségével adatokat rögzíthet a szoftverfejlesztési projektek tervezéséhez és nyomon követéséhez. A munkaelemek segítségével leírhatja a elvégezni kívánt munkát, hozzárendelheti a munkát, nyomon követheti az állapotot, és koordinálhatja a csapaton belüli erőfeszítéseket. A különböző típusú munkaelemek – például a felhasználói történetek, a feladatok, a hibák és a problémák – különböző típusú információkat követnek nyomon. További információkért tekintse meg az Azure Boards dokumentációját.

Minden munkaelem-követési objektum egy vagy több névvel van társítva. A legtöbben rövid megjelenítési névvel rendelkeznek, kivéve a munkaelem-típusokat és a globális listákat, amelyek hivatkozásnevekhez vannak társítva. A rövid név egy mező egyedi, felhasználó által látható azonosítója. A rövid nevek használata biztosítja a projektek és a munkaelem-típusok konzisztenciáját egy projektgyűjteményben. A rendszer belsőleg használja a referencianevet, és a definiálása után nem módosíthatja.

A munkaelemekhez kapcsolódó számos elemre korlátozás vonatkozik, beleértve a hivatkozásokat és a rövid neveket, a mezőneveket és a melléklet méretét.

Terület- és iterációs útvonalak

Két munkaelemmező, a Terület elérési útja és az Iterációs útvonal faszerkezeti hierarchiát biztosít a munka csoportosításához. A terület elérési útjai termék, funkcionális vagy funkcióterület szerint csoportosítják a munkaelemeket. Az iterációs útvonalak a munkaelemeket futamokba, mérföldkövekbe vagy időszakokba csoportosítják a munkaelemek kezeléséhez.

Ezek a többcsomópontos mezők a fordított perjel \ karakterekkel jelölik a faszerkezet csomópontjainak hierarchiáját.

A gyermekcsomópontokhoz hozzárendelt neveknek meg kell felelniük az alábbi korlátozásoknak.

Korlátozás típusa Korlátozás
Csomópont hossza Legfeljebb 255 karaktert tartalmazhat.
Fenntartott nevek - Nem állhat csak időszakból . vagy két időszakból ...
- Nem lehet rendszer által fenntartott név, például PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON vagy AUX. A fenntartott nevekről további információt a Fájlnevek, az Elérési utak és a Névterek című témakörben talál.
Csomópontok speciális karakterei – Unicode-vezérlőkarakterek nem tartalmazhatnak.
- Nem tartalmazhat a következő karakterek egyikét sem: \ / : * ? " < > | # $ * +.
- Nem tartalmazhat a helyi fájlrendszer által tiltott karaktereket. A Windows karakterkorlátozásairól további információt a Fájlok, elérési utak és névterek elnevezése című témakörben talál.
Elérési út hossza Legfeljebb 4000 Unicode-karaktert tartalmazhat.
Elérésiút-hierarchia mélysége 14 szintnél kevesebbnek kell lennie.

Mellékletek

A munkaelemekhez csatolt fájloknak meg kell felelniük az alábbi korlátozásoknak.

Korlátozás típusa Korlátozás
Fájlméret Nem haladhatja meg a maximális méretet:
- Alapértelmezett maximális méret: 4096 kilobájt.
- Abszolút maximális méret: 2 gigabájt.
Korlátozás típusa Korlátozás
Fájlméret Nem haladhatja meg a maximális méretet:
- Alapértelmezett maximális méret: 4096 kilobájt.
- Abszolút maximális méret: 2 gigabájt. További információ: A munkaelemek maximális mellékletméretének módosítása.

Táblaoszlopok és sávok nevei

A Kanban-tábla interaktív táblává alakítja a hátralékot, amely vizuális munkafolyamatot biztosít. Ahogy a munka az ötlettől a befejezésig halad, frissítenie kell a táblán lévő elemeket. Minden oszlop egy munkaszakaszt jelöl, és minden kártya egy felhasználói történetet (kék kártyákat) vagy egy hibát (piros kártyákat) jelöl a munka adott szakaszában.

A Kanban-táblák testreszabása oszlopok és sávok hozzáadásával, eltávolításával vagy átnevezésével. Az oszlopok támogatják a munka menetét a táblán. A sávok lehetővé teszik a különböző munkaosztályok kezelését vízszintes sávként a táblán.

Az oszlop- és sávneveknek meg kell felelniük a következő korlátozásoknak.

Korlátozás típusa Korlátozás
Hossz Legfeljebb 256 Unicode-karaktert tartalmazhat.
Egyediség - Az oszlopnevek nem lehetnek azonosak a Kanban táblában lévő többi oszlop nevével.
- A sávnevek nem lehetnek azonosak a Kanban táblán lévő többi sávnévvel.
Speciális karakterek Unicode-vezérlőkarakterek és helyettesítő karakterek nem tartalmazhatnak.

Mezőnevek

Minden munkaelem-típus egy vagy több munkaelemmezőt tartalmaz. Ezek a mezők határozzák meg a munkaelemekhez tárolt adatokat a munkaelem típusa alapján. Minden munkaelemmezőhöz tartozik egy mezőhivatkozás neve. A mezőhivatkozás neve egyedileg azonosítja az egyes mezőket, és a hozzárendelés után nem módosítható. A beépített munkaelemmezőkről további információt a Munkaelem mezőindex című témakörben talál.

A munkaelemmezők nevének meg kell felelnie az alábbi korlátozásoknak.

Korlátozás típusa Korlátozás
Hossz Legfeljebb 128 Unicode-karaktert tartalmazhat.
Egyediség – A mezőneveknek legalább egy betűrendes karaktert kell tartalmazniuk.
- Nem tartalmazhat a következő karakterek egyikét sem: .,;':~\/\*|?"&%$!+=()[]{}<>-.
- Nem tartalmazhat bevezető vagy záró szóközöket.
- Nem tartalmazhat két vagy több egymást követő szóközt.
Speciális karakterek A szervezeten vagy projektgyűjteményen belül egyedinek kell lennie. A munkaelem-mezőnevek hatóköre a projektgyűjteményre terjed ki. Ha átnevez egy mezőnevet, a gyűjtemény összes projektjében definiált összes munkaelemre és WIT-re módosítja.

Mezőhivatkozások nevei és hordozhatósága

A munkaelem-típusdefiníció nyelve magában foglalja a mezőhivatkozás nevének fogalmát. A mezőhivatkozások nevei segíthetnek a definíciók a Team Foundation-projektgyűjtemények közötti portokon, valamint lehetővé teszik a külső integrációk számára, hogy megkeressék és hivatkozhassanak bizonyos mezőkre. Ezek a nevek globálisan egyediek, ahogyan a .NET-keretrendszer alkalmazás névtere is globálisan egyedi.

A rendszernévtér csak a Team Foundation rendszerfüggvényekhez kötelező összes alapvető rendszermező meghatározására szolgál. Nem hozhat létre saját System.X mezőt, mert az akadályozhatja a működést.

A Microsoft-névtér a munkaelem-követési mezők definiálására szolgál. Ezek a mezők a folyamatsablonok munkaelem-típusdefiníciójában vannak definiálva.

Az ügyfelek és partnerek saját mezőnévtereket hozhatnak létre egyéni munkaelem-típusokhoz. Az alapértelmezett folyamatsablonokban definiált rendszermezők és mezők leírását a munkaelemmezők indexe című témakörben talál.

Fontos

  • A mezőhivatkozások neve nem nevezhető át. Ha például a "Cím" mezőnevet "Fejléc" értékre módosította, a mező hivatkozási neve változatlan marad. Az integrációknak és a mezők belső ábrázolásának a mezőhivatkozás nevét kell használnia, nem pedig magát a mezőnevet.
  • Bár létrehozhat saját Microsoft.X-mezőt, nem javasoljuk, hogy ezt tegye, mivel ez akadályozhatja a funkciókat, vagy azt, hogy a Funkciók konfigurálása varázsló sikeresen frissíthet egy projektet a frissítés után.

Példák a mezőhivatkozások nevére

Az alábbi példák érvényes mezőhivatkozás-neveket mutatnak be különböző névterekben. Az ügyfelek és partnerek saját névtereket is meghatározhatnak az egyéni munkaelem-típusok támogatásához.

Példák a rendszernévtérre Példák a Microsoft névterére Egyéb névtér-példák
System.Id, System.Title, System.CreatedBy, System.CreatedDate, System.ChangedBy, System.ChangedDate, System.State, System.Reason Microsoft.VSTS.Build.FoundIn, Microsoft.VSTS.Common.Activity, Microsoft.VSTS.Common.Discipline, Microsoft.VSTS.Common.Priority, Microsoft.VSTS.CMMI.TaskType, Microsoft.VSTS.TCM.AutomationStatus, Microsoft.VSTS.TCM.TestSuiteType A fiktív Fabrikam Fibre vállalat a következő egyéni munkaelem-mezőket határozhatja meg:
FabrikamFiber.Common.Severity, FabrikamFiber.Common.Phase, FabrikamFiber.RiskManagement.RiskType, FabrikamFiber.RiskManagement.Resolution

A Contoso Corporation fiktív szoftvervállalat a következő munkaelem-mezőket határozhatja meg:
Contoso.Common.BusinessPriority, Contoso.Bug.FoundInPhase, Contoso.Bug.FixInPhase

Mező súgószövege

A rendszer futásidőben megjeleníti a súgószöveget, hogy a felhasználók tudják, mit kell beírni a mezőbe. A súgószöveg hatóköre egy adott projekt adott munkaelem-típusára terjed ki.

Az öröklési folyamathoz egy mező súgószövegét a Mező szerkesztése párbeszédpanelen, a Definíció lapon, a Leírásban adhatja meg. Lásd: Egyéni mező hozzáadása munkaelem-típushoz. A helyszíni XML-folyamathoz az elem használatával adhat meg súgószöveget HELPTEXT . Lásd: Mező hozzáadása vagy módosítása a munka nyomon követéséhez.

A hozzáadott súgószövegnek meg kell felelnie az alábbi korlátozásoknak.

Korlátozás típusa Korlátozás
Hossz Legfeljebb 255 Unicode-karaktert tartalmazhat.

Globális listák

A globális lista listaelem-értékek készlete, amelyet globálisan használhat a helyszíni Azure DevOps Server egy példányán belüli összes projektgyűjteményben. A munkaelem-típusok definiálása során előfordulhat, hogy egyes munkaelem-mezők azonos engedélyezett vagy javasolt értékekkel osztoznak. A globális listák lehetővé teszik, hogy egyszer definiálja ezeket az értékeket, és több munkaelem-típuson és projekten ossza meg őket. További részletekért lásd: Globális listák definiálása.

Az elem használatával GLOBALLIST definiált globális lista egy vagy több listaelemet tartalmaz, amely az LISTITEM elem használatával van megadva.

LISTITEM a neveknek meg kell felelniük az alábbi korlátozásoknak.

Korlátozás típusa Korlátozás
Hossz - Legfeljebb 254 Unicode-karaktert tartalmazhat.
- Nem lehet üres.
Speciális karakterek - Nem tartalmazhat kezdő vagy záró szóközt.
- Nem tartalmazhat két egymást követő szóközt.
- Nem tartalmazhat fordított perjel \ karaktereket.
Hatókör Mivel a globális listák minden projektben elérhetők, nem tartalmazhatnak projektszinten definiált elemeket, például projektspecifikus csoportfiók-definíciókat.

A globális listáknak meg kell felelniük a következő korlátozásoknak.

Korlátozás típusa Korlátozás
Elemek száma Nem lehet üres. A globális lista legalább egy LISTITEM elemet tartalmaznia kell.
Egyediség Nem lehet üres. A globális lista legalább egy LISTITEM elemet tartalmaznia kell.

Hivatkozástípus vagy kategória hozzáadásakor vagy létrehozásakor adjon meg hivatkozásnevet. Minden hivatkozásnév legfeljebb 70 Unicode karakter hosszúságú lehet.

Adjon meg egy hivatkozásnevet alfanumerikus karakterek, aláhúzásjelek és kötőjelek használatával. Minden hivatkozásnévnek tartalmaznia kell legalább egy pontot ., de a név elején vagy végén nem jelenhet meg időszak. A hivatkozás neve nem kezdődhet számmal vagy aláhúzásjellel, és nem tartalmazhat több egymást követő kötőjelet, például --.

Korlátozás típusa Korlátozás
Hossz Legfeljebb 70 Unicode-karaktert tartalmazhat.
Egyediség - Nem lehet azonos a projektgyűjteményben lévő többi mezőhivatkozás nevével.
- Nem lehet azonos a többi mezőhivatkozás nevével, miután a számítógép feldolgozta ezeket a neveket, hogy az összes pontot . aláhúzásjelekkel helyettesítse _. Például a mezőhivatkozások nevei My.*Field* , és My.Field mindkettő ugyanazzal a névvel dolgozna fel: My__Field
Speciális karakterek - Nem tartalmazhat kötőjeleket -.
- Legalább egy pontot .tartalmaznia kell.
- Nem kezdődhet és nem végződhet ponttal ..
- Nem kezdődhet olyan számmal, amely nem aláhúzással _kezdődik.

Munkaelem címkéi

A munkaelemek címkéi egy vagy két kulcsszókifejezésnek felelnek meg, amelyekkel szűrhetők a munkakövető eszközök, például a hátralékok, a táblák és a lekérdezések, vagy definiálhatók a lekérdezések. További információ: Munkaelemcímkék hozzáadása listák és táblák kategorizálásához és szűréséhez.

A címkeneveknek meg kell felelniük a következő korlátozásoknak.

Korlátozás típusa Korlátozás
Hossz - Legfeljebb 400 Unicode-karaktert tartalmazhat.
- Nem lehet null vagy üres.
Speciális karakterek - Nem tartalmazhat elválasztó karaktereket: , vagy ;.
- Nem tartalmazhat Unicode-vezérlő- vagy formázási karaktereket, például vonalcsatornát, bekezdéselválasztót, kocsivisszajelet vagy más nem egyező helyettesítő karaktereket.
Hatókör Mivel a globális listák minden projektben elérhetők, nem tartalmazhatnak projektszinten definiált elemeket, például projektspecifikus csoportfiók-definíciókat.

Azure Pipelines

Az Azure Pipeline definícióinak meg kell felelniük a következő korlátozásoknak.

Korlátozás típusa Korlátozás
Feladat neve - Csak alfanumerikus karaktereket és '_'.
- Nem kezdődhet számmal.
- Egyedi névvel kell rendelkeznie.
- Nem tartalmazhat kulcsszavakat, például: "üzembe helyezés".
Fázis neve - Csak alfanumerikus karaktereket és '_'.
- Nem kezdődhet számmal.
- Nem tartalmazhat kulcsszavakat, például: "üzembe helyezés".
Kifejezések A kezdő vagy a következővel kell kezdődniea-Z: , majd a-Z, 0-9vagy _._AND

További információkért tekintse meg az Azure Pipelines dokumentációját.

Azure-adattárak (Git)

Minden Azure DevOps-projekt több Git-adattárat is tartalmazhat. A Git-adattárakhoz rendelt neveknek meg kell felelniük az alábbi korlátozásoknak. További információkért tekintse meg az Azure Repos Git dokumentációját. További információ az egyéb Git-elemek, például ágak és címkék elnevezési korlátozásáról: git check-ref-format.

Fontos

Bár szóközöket is tartalmazhat az adattárnevekben, ezt nem javasoljuk.

Korlátozás típusa Korlátozás
Hossz Legfeljebb 64 Unicode-karaktert tartalmazhat.
Egyediség Nem lehet azonos a projekt többi Git-adattár nevével.
Speciális karakterek – Nem használhatók Unicode-vezérlőkarakterek vagy helyettesítő karakterek.
- Nem tartalmazhat a következő nyomtatható karaktereket: \ / : * ? " < > | ; # $ * { } , + = [ ].
- Nem szabad aláhúzással _kezdeni.
- Nem kezdődhet és nem végződhet ponttal ..
- Nem lehet fenntartott rendszernév.

Azure-adattárak (TFVC)

A Team Foundation verziókövetése (TFVC) központi adattárat biztosít a fájlokhoz és a fájlok csapaton belüli kezeléséhez szükséges parancsokhoz. Emellett testre szabható bejelentkezési szabályzatokat, elágaztatást, egyesítést, polcolást és sok más funkciót is biztosít. További információkért tekintse meg az Azure Repos TFVC dokumentációját

A verziókövetési útvonalaknak meg kell felelniük az alábbi korlátozásoknak. Lásd még : Munkaterület optimalizálása.

Korlátozás típusa Korlátozás
Kiszolgáló forrásvezérlő mappáinak elérési útja – Egyetlen mappa vagy fájlnév esetében legfeljebb 259 Unicode-karaktert tartalmazhat.
- Nem tartalmazhat 388-nál több Unicode-karaktert egy könyvtárhoz.
– Nem tartalmazhat 399-nél több Unicode-karaktert egy kombinált könyvtár és fájlnév esetében.
A helyi mappa elérési útja hossza - Nem tartalmazhat 248-nál több Unicode-karaktert egy könyvtárhoz.
- Nem tartalmazhat 260-nál több Unicode-karaktert egy kombinált könyvtárhoz és fájlnévhez.
Webportál és REST-specifikus hosszkorlátozások Nem tartalmazhat 215-nél több Unicode-karaktert egy kombinált projektnévhez, könyvtárhoz és fájlnévhez.

A webportálon és a REST API-ban bizonyos műveletek elérési útja szigorúbb, mint a Visual Studio és TF.exe ügyfelek. Ezek a műveletek közé tartozik a szerkesztés, az átnevezés és a törlés, és azért fordulnak elő, mert a webportál/REST véletlenszerűen létrehozott munkaterületet használ az egyidejűséghez, amikor a módosítások függőben vannak.

TFVC-fájlok

A verziókövetési rendszer számos különböző típusú fájlt tárol. A Team Foundation verziókövetésének beállítása a fejlesztői gépen a meglévő Visual Studio-projektek vagy -megoldások hozzáadásának részleteit tartalmazza.

A Team Foundation verziókövetéséhez hozzáadott fájloknak és mappáknak meg kell felelniük az alábbi korlátozásoknak.

Korlátozás típusa Korlátozás
Fájlok és mappák - A nevek nem tartalmazhatják a következő nyomtatható karaktereket: \ / : * ? " < > | ;.
– A mappák nem lehetnek kívül az aktív munkaterület megfeleltetett könyvtárán.
Fájlnevek - Nem kezdődhet a $.
- Nem tartalmazhat a következő nyomtatható karaktereket: \ / : * ? " < > | ;.

TFVC-címkék

A Team Foundation verziókövetésében (TFVC) a címke egy adott változatkészletre alkalmazott név. A verziókövetésben címkéket csatolhat a nem kapcsolódó fájlokhoz, így lekérheti a fájlokat, vagy csoportként kezelheti őket. Az alábbi táblázat a címkenevekre vonatkozó korlátozásokat ismerteti.

Korlátozás típusa Korlátozás
Hossz Legfeljebb 64 Unicode-karaktert tartalmazhat.
Speciális karakterek - Nem végződhet szóközzel ( ) vagy ponttal ..
- Nem tartalmazhat a következő nyomtatható karaktereket: \ / : * ? " < > | ; @.

TFVC polckészletek

A polckészletek lehetővé teszik, hogy ideiglenesen félretegye a függőben lévő módosítások egy kötegét, majd lehetőségként távolítsa el a függőben lévő módosításokat a munkaterületről. Később visszaállíthatja a polckészlet módosításait a munkaterületre, vagy elhelyezheti őket egy másik felhasználó munkaterületén.

A polckészletek nevének meg kell felelnie az alábbi korlátozásoknak.

Korlátozás típusa Korlátozás
Hossz Legfeljebb 64 Unicode-karaktert tartalmazhat.
Speciális karakterek Nem tartalmazhat a következő nyomtatható karaktereket: \ / : * ? " < > | ;.

TFVC-munkaterületek

A munkaterület a Team Foundation verziókövetésében (TFVC) található fájlok és mappák ügyféloldali másolata. Ha több munkaterületet hoz létre, ugyanazon verziókövetési mappa különböző verzióival rendelkezhet egy ügyfélszámítógépen. A munkaterületek létrehozása és kezelése további részleteket tartalmaz.

A munkaterületneveknek meg kell felelniük a következő korlátozásoknak.

Korlátozás típusa Korlátozás
Hossz Legfeljebb 64 Unicode-karaktert tartalmazhat.
Speciális karakterek - Nem szabad szóközzel ( )végződnie.
- Nem tartalmazhat a következő nyomtatható karaktereket: \ / : * ? " < > | ;.

Számítógépnevek

Az Azure DevOps telepítésének számítógépneve a kiszolgáló nevével van társítva. Az operációs rendszer és az Active Directory is bizonyos korlátozásokat vezet be a számítógépnevekre az alábbi cikkekben leírtak szerint:

Szervezeti nevek

Fontos

A szervezetnév létrehozásakor kövesse az alábbi irányelveket.

  • Csak az angol ábécé betűinek használata
  • A szervezet nevének indítása betűvel vagy számmal
  • Betűk, számok vagy kötőjelek használata a kezdeti karakter után
  • Győződjön meg arról, hogy a szervezet nem haladja meg az 50 Unicode-karaktert
  • Betűvel vagy számmal végződik

Ha a nem engedélyezett karakterek bármelyikét használja, a következő hibaüzenet jelenik meg: VS850015: A megadott név nem használható: {Szervezet neve}.

Sablonok feldolgozása és feldolgozása

A folyamat meghatározza a munkaelem-követési rendszer és más alrendszerek építőelemeit, amelyekhez a projekthez való csatlakozás után hozzáféréssel rendelkezik.

Feljegyzés

Terminológia: A "folyamat" és a "folyamatsablon" egyaránt a projekt létrehozásához használt fájlok egymással összefüggő készletére utal. További információ: A folyamatok és a folyamatsablonok ismertetése, amely a három elérhető alapértelmezett folyamat közötti különbségeket ismerteti.

A definiált vagy testre szabott folyamatoknak meg kell felelniük az alábbi korlátozásoknak.

Korlátozás típusa Korlátozás
Hossz Legfeljebb 256 Unicode-karaktert tartalmazhat.
Egyediség – Az Azure DevOpsban egyedinek kell lennie.
– Ha egy meglévő sablon nevével megegyező nevű sablont tölt fel, a meglévő sablon felülíródik.
Folyamatsablon fájlmérete Nem haladhatja meg a 2 GB-ot (gigabájtot).

Projektgyűjtemények

A projektgyűjtemények azonosítják a projektek egy csoportját és az ezekhez a projektekhez társított erőforrásokat. Olyan rendszerezési struktúrát biztosít, amellyel definiálhatja és szabályozhatja az Azure DevOps Serverhez definiált projektek egy csoportját.

Emellett a gyűjtemény neve annak a kapcsolati sztring része, amely a csapattagok projektekhez való csatlakoztatására szolgál. Az alapértelmezett hozzárendelt érték a DefaultCollection függvénynek felel meg. A projektgyűjtemények kezelése további információt nyújt.

A projektgyűjteményekhez hozzárendelt neveknek meg kell felelniük az alábbi korlátozásoknak.

Korlátozás típusa Korlátozás
Hossz Legfeljebb 64 Unicode-karaktert tartalmazhat.
Egyediség – Nem lehet azonos a helyszíni üzembe helyezés más gyűjteménynevével.
– Ha az üzembe helyezés SharePoint-termékeket vagy SQL Server Reporting Services szolgáltatást tartalmaz, azok nem lehetnek azonosak egy meglévő SharePoint-webhely, jelentéskészítő kiszolgáló vagy Reporting Services-webhely nevével és teljes elérési úttal.
Fenntartott nevek Nem lehet fenntartott rendszernév.
Speciális karakterek – Nem használhatók Unicode-vezérlőkarakterek vagy helyettesítő karakterek.
- Nem tartalmazhat a következő nyomtatható karaktereket: \ / : * ? " < > | ; # $ * { } , + = [ ].
- Nem tartalmazhat három pontot ... vagy két pontot ...
- Nem szabad aláhúzással _kezdeni.
- Nem kezdődhet és nem végződhet ponttal ..

Projektnevek

A projekt létrehoz egy adattárat a forráskódhoz, valamint egy helyet a csapatok számára a haladás megtervezéséhez, nyomon követéséhez és az együttműködéshez. A projekt neve annak a kapcsolati sztring része, amely a csapattagok projektekhez való csatlakoztatására szolgál.

A létrehozott projektekhez hozzárendelt neveknek meg kell felelniük az alábbi korlátozásoknak.

Korlátozás típusa Korlátozás
Hossz Legfeljebb 64 Unicode-karaktert tartalmazhat.
Egyediség Nem lehet azonos a projektgyűjtemény más nevével, a gyűjteményt támogató SharePoint-webalkalmazással vagy a gyűjteményt támogató SQL Server Reporting Services-példánysal.
Fenntartja a neveket - Nem lehet fenntartott rendszernév.
– Nem lehet az IIS-kérelmek szűréséhez használt rejtett szegmensek egyike, például App_Browsers, App_code, App_Data, App_GlobalResources, App_LocalResources, App_Themes, App_WebResources, bin vagy web.config.
Speciális karakterek – Nem használhatók Unicode-vezérlőkarakterek vagy helyettesítő karakterek.
- Nem tartalmazhat a következő nyomtatható karaktereket: \ / : * ? " < > | ; # $ * { } , + = [ ].
- Nem szabad aláhúzással _kezdeni.
- Nem kezdődhet és nem végződhet ponttal ..

Biztonsági csoportok

Az Azure DevOps biztonsági csoportjaival bizonyos jogosultságokat vagy engedélyeket alkalmazhat a felhasználók egy csoportjára.

A helyszíni csoportok lehetnek Active Directory-csoportfiókok, Azure DevOps biztonsági csoportok, Windows-felhasználói fiókok, Windows-csoportfiókok vagy ezek bármilyen keveréke. További információ: Active Directory/ Microsoft Entra-felhasználók vagy -csoportok hozzáadása egy beépített biztonsági csoporthoz.

A biztonsági csoportoknak meg kell felelniük az alábbi korlátozásoknak.

Korlátozás típusa Korlátozás
Biztonsági csoport fióknévének hossza Legfeljebb 256 Unicode-karaktert tartalmazhat.
Egyediség - A projektszintű csoportfiókok nem egyezhetnek meg az ugyanabban a projektben lévő többi csoportnévvel.
– A gyűjteményszintű csoportfiókok nem egyeznek a projektgyűjteményben lévő csoportfiókok más nevével.
Fenntartott csoportnevek Nem nevezhető el $NAMESPACE sem a projekt, sem a kiszolgáló szintjén.
Speciális karakterek – Nem használhatók Unicode-vezérlőkarakterek vagy helyettesítő karakterek.
- Nem tartalmazhat a következő nyomtatható karaktereket: / \ [ ] : | < > + = ; ? *.
- Nem tartalmazhat nem nyomtatható karaktereket az 1–31 ASCII értéktartományban.
- Nem végződik pontban ..
- Nem tartalmazhat vesszőt ,.

Team Foundation Build

A Team Foundation Build segítségével egyetlen számítógépen kezelheti a buildelési folyamat összes aspektusát. A Team Foundation Build használatával szinkronizálhatja a forrásokat, lefordíthatja az alkalmazást, futtathatja a kapcsolódó egységteszteket, kódelemzést végezhet, buildeket bocsáthat ki egy fájlkiszolgálón, és közzéteheti a buildjelentéseket.

Számítógép összeállítása

A Team Foundation Build egy különálló telepítés az Azure DevOps Server alkalmazásszinttől, adatszinttől vagy Visual Studio-ügyféltől. Külön számítógépet is választhat. Ellenkező esetben a buildet egymás mellett telepítheti az ügyfélszámítógépen vagy a kiszolgálókon.

A helyszíni buildszámítógépnek meg kell felelnie az alábbi korlátozásoknak.

Korlátozás típusa Korlátozás
Lemezterület Elegendő helyet kell tartalmaznia a build számára (a nem elegendő hely a sikertelen buildekhez vezet).
Címtár összeállítása Helyi elérési útnak kell lennie (például C:\BuildDirectory).
Hely könyvtárának elvetése UNC elérési útnak kell lennie (például \server\share).
Helyengedélyek elvetése Minden létrehozott build új könyvtárba kerül a drop mappában.
- A Team Foundation kiszolgálószolgáltatás-fióknak (például Domain\TFSSERVICE) teljes hozzáféréssel kell rendelkeznie az UNC legördülő helyhez.
- Az UNC legördülő helynek megosztott mappának kell lennie.
Team Foundation Build Service-fiók Ha a kezdeti telepítés után módosítja a TFS-szolgáltatásfiókot, győződjön meg arról, hogy a következő feltételek teljesülnek:
- A fiók a Build Services csoport tagja.
– A fiók olvasási/írási engedélyekkel rendelkezik az ideiglenes mappákhoz és az ASP.NET ideiglenes mappához.
– A fiók teljes hozzáféréssel rendelkezik a buildkönyvtárhoz és az elvetési helyhez.
Tűzfallal kapcsolatos problémák Ha a buildelési számítógép engedélyezve van, győződjön meg arról, hogy a program ( tfsbuildservice) szerepel a kivételek listájában.

Buildtípusok

A buildtípusok konfigurálják azokat a feltételeket, amelyek mellett egyetlen megoldás vagy egy projektben lévő megoldáskészlet készül. A buildek elvégzéséhez létre kell hoznia egy új buildtípust, vagy egy meglévő buildtípust kell használnia.

A buildtípusneveknek meg kell felelniük a következő korlátozásoknak.

Korlátozás típusa Korlátozás
Egyediség Nem lehet ugyanaz, mint bármely más buildtípus neve a projektben.
Speciális karakterek Nem tartalmazhat a következő nyomtatható karaktert: $.

Build minősége

A build minősége lehetővé teszi, hogy minőségi szintet vagy befejezési állapotot csatoljon egy befejezett buildhez. A Team Foundation Build funkcióval új értékeket is létrehozhat a build minőségi típusához. Tekintse meg az alapértelmezett buildminőségi értékek listájának befejezett buildek minőségének értékelése című témakört.

A build minőségi neveinek meg kell felelniük a következő korlátozásoknak.

Korlátozás típusa Korlátozás
Hossz Legfeljebb 256 Unicode-karaktert tartalmazhat.
Egyediség Nem lehet ugyanaz, mint a Team Foundation buildelési számítógépének más buildminőség-neve.

Csapatnevek

A csoportnevek olyan egyének vagy csoportok csoportját azonosítják, amelyek együttesen dolgoznak együtt egy projektben. A csapattagok ezzel a névvel csatlakoznak a csapathoz, vagy lekérdezik a csoporthoz meghatározott tagokat.

A csapatneveknek meg kell felelniük azoknak a konvencióknak, amelyek lehetővé teszik számukra, hogy érvényes URL-cím részeként legyenek megjelenítve. Minden csapatnévnek egyedinek kell lennie egy projekten belül. A projektcsoporton belüli különböző projektekben azonban nincs korlátozás arra vonatkozóan, hogy ugyanazt a csoportnevet használja. További információ: Másik csapat vagy csoporthierarchiák hozzáadása.

A csapatneveknek meg kell felelniük az alábbi korlátozásoknak.

Korlátozás típusa Korlátozás
Hossz Legfeljebb 64 Unicode-karaktert tartalmazhat.
Egyediség Nem lehet azonos a projekt más nevével.
Fenntartott nevek Nem lehet fenntartott rendszernév.
Speciális karakterek – Nem használhatók Unicode-vezérlőkarakterek vagy helyettesítő karakterek.
- Nem tartalmazhat a következő nyomtatható karaktereket: \ / : * ? " < > | ; # $ * { } , + = [ ].
- Nem tartalmazhat három pontot ... vagy két pontot ...
- Nem szabad aláhúzással _kezdeni.
- Nem kezdődhet és nem végződhet ponttal ..

Felhasználói fiókok nevei

A felhasználói fiókok azonosítják a projekthez vagy projektgyűjteményhez hozzáadott személyeket. A felhasználói fiókok megfelelhetnek az Active Directory, a Microsoft Entra ID és a Windows-kiszolgálócsoport bejegyzéseinek.

A szervezethez vagy gyűjteményhez hozzáadott felhasználói fiókoknak meg kell felelniük az alábbi korlátozásoknak. Ha felhasználói fiókokat szeretne hozzáadni egy projekthez, olvassa el a Felhasználók hozzáadása projekthez vagy csapathoz című témakört.

Korlátozás típusa Korlátozás
Fióknév hossza Legfeljebb 256 Unicode-karaktert tartalmazhat.
Egyediség Nem egyezhet meg a projektgyűjteményhez hozzáadott más felhasználói fiókkal.
Fenntartott csoportnevek Nem nevezhető el $NAMESPACE sem a projekt, sem a kiszolgáló szintjén.
Speciális karakterek - Nem tartalmazhatja a következő nyomtatható karaktereket: "/ \ [ ] : | < > + = ; ? *.
- Nem tartalmazhat nem nyomtatható karaktereket az 1–31 ASCII értéktartományban.
- Nem végződhet pontban . vagy dollárjelben $.
- Nem tartalmazhat vesszőt ,.
- Nem tartalmazhat a következő Unicode-kategóriákat: LineSeparator, ParagraphSeparator, Control, Format, OtherNotAssigned.

Wikilap és fájlnevek

Minden wikilap egy-egy fájlnak felel meg a wiki Git-adattárában. A wikilapokhoz rendelt neveknek az alábbi korlátozásoknak kell megfelelniük.

Korlátozás típusa Korlátozás
Fájlnév A teljes lapútvonal nem haladhatja meg a 235 karakter hosszúságot.
Egyediség A lapcímek megkülönböztetik a kis- és nagybetűket, és egyedinek kell lenniük a wikihierarchiában.
Speciális karakterek – Nem használhatók Unicode-vezérlőkarakterek vagy helyettesítő karakterek.
- Nem tartalmazhat a következő nyomtatható karaktereket: / \ #.
- Nem kezdődhet és nem végződhet ponttal ..
Fájlméret Nem lépheti túl a 18 MB-os maximális méretet.
Mellékletfájl mérete Nem lépheti túl a 19 MB-os maximális méretet.

Speciális karakterek a Wikilap címeiben

Megadhatja azokat a lapcímeket, amelyek egy vagy több speciális karaktert : < > * ? | -tartalmaznak. A Markdown-fájlokat például "GYIK" vagy "Beállítási útmutató" néven is elnevezheti. A karakterek a következő URI-kódolt sztringekkel rendelkeznek:

Karakter Kódolt sztring
: %3A
< %3C
> %3E
* %2A
? %3F
| %7C
- %2D
" 22%