Omezení a konvence pojmenování
Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019
Většina komponent v Azure DevOps musí dodržovat omezení a konvence vytváření názvů. Omezení pomáhají zaručit konzistentní uživatelské prostředí a zajistit kompatibilitu s jinými aplikacemi.
Mezi běžná omezení patří překročení délky znaků pro název, neobsahuje speciální znaky a zachování jedinečnosti názvů v rámci sady objektů.
Důležité
Při použití rozhraní API místo uživatelského rozhraní umožňuje rozhraní API přímo zadat název, který zahrnuje znaky, které mohou být v uživatelském rozhraní omezeny.
Osvědčené postupy:
- Pokud chcete zachovat konzistenci a zabránit nezamýšleným problémům, postupujte podle omezení uživatelského rozhraní.
- Ověřte názvy programově a odpovídajícím způsobem zpracujte všechny speciální znaky.
Obecné aspekty
Omezení délky v tomto článku se měří podle počtu povolených znaků Unicode. Náhradní znaky se skládají ze dvou znaků Unicode, které se počítají jako dva znaky proti omezení délky. Další informace naleznete v tématu O sadě Unicode a znakových sadách.
Stejně jako u jiných souborů operačního systému nejsou povoleny také řídicí znaky ASCII (ASCII 1-31) a náhradní kombinace. Obecné informace o omezeních operačního systému použitých na názvy souborů naleznete v tématu Pojmenování souborů, cest a oborů názvů.
Poznámka:
- Omezení počtu položek, které můžete definovat, najdete v tématu Sledování práce, proces a limity projektu.
Rezervované názvy systému
Vyhněte se používání rezervovaných názvů systému, například v následujících příkladech:
- AUX
- COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10
- PROTI
- DefaultCollection
- LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9
- NUL
- PRN
- SERVER, SignalR
- Web nebo WEB
Další informace o rezervovaných názvech najdete v tématu Názvy souborů, cesty a obory názvů.
Azure Artifacts
Univerzální balíčky musí odpovídat následujícím omezením.
Typ omezení | Omezení |
---|---|
Název balíčku | - Musí to být malá písmena. - Musí začínat a končit písmeny nebo číslicemi. – Musí obsahovat pouze písmena, číslice a nekonektivní pomlčky, podtržítka nebo tečky. |
Verze balíčku | Musí být malá písmena bez metadat sestavení. |
Azure Boards
Pracovní položky slouží k zaznamenání informací k plánování a sledování projektů vývoje softwaru. Pomocí pracovních položek můžete popsat práci, kterou chcete provést, přiřadit práci, sledovat stav a koordinovat úsilí v rámci vašeho týmu. Různé typy pracovních položek, jako jsou uživatelské scénáře, úkoly, chyby a problémy, sledují různé typy informací. Další informace najdete v dokumentaci k Azure Boards.
Všechny sledovací objekty pracovních položek jsou přidruženy k jednomu nebo více názvům. Většina obsahuje popisné zobrazované názvy s výjimkou typů pracovních položek a globálních seznamů, které jsou přidružené k názvům odkazů. Popisný název je jedinečný identifikátor viditelný uživatelem pro pole. Použití popisných názvů zajišťuje konzistenci mezi projekty a typy pracovních položek v kolekci projektů. Systém používá název odkazu interně a po definování ho nemůžete změnit.
Existuje omezení několika prvků přidružených k pracovním položkám, včetně referenčních a popisného názvu, názvů polí a velikosti přílohy.
Cesty oblasti a iterace
Dvě pole pracovních položek, Cesta k oblasti a Cesta iterace, poskytují hierarchii struktury stromu pro seskupování práce. Cesty oblastí seskupují pracovní položky podle oblasti produktu, funkčnosti nebo oblasti funkcí. Cesty iterace seskupují pracovní položky do sprintů, milníků nebo časových období pro adresování těchto pracovních položek.
Tato pole s více uzly používají znaky zpětného lomítka \
k označení hierarchie uzlů ve struktuře stromové struktury.
Názvy, které přiřadíte podřízeným uzlům k těmto polím, musí odpovídat následujícím omezením.
Typ omezení | Omezení |
---|---|
Délka uzlu | Nesmí obsahovat více než 255 znaků. |
Rezervované názvy | - Nesmí se skládat pouze z období . nebo dvou období .. .- Nesmí se jednat o název vyhrazený systémem, například PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON nebo AUX. Další informace o rezervovaných názvech naleznete v tématu Názvy souborů, cesty a obory názvů. |
Speciální znaky pro uzly | – Nesmí obsahovat řídicí znaky Unicode. - Nesmí obsahovat žádný z následujících znaků: \ / : * ? " < > | # $ & * + .- Nesmí obsahovat znaky zakázané místním systémem souborů. Další informace o omezeních znaků systému Windows naleznete v tématu Pojmenování souborů, cest a oborů názvů. |
Délka cesty | Nesmí obsahovat více než 4 000 znaků Unicode. |
Hloubka hierarchie cest | Musí být menší než 14 úrovní hloubky. |
Přílohy
Soubory připojené k pracovním položkám musí odpovídat následujícím omezením.
Typ omezení | Omezení |
---|---|
Velikost souboru | Nesmí překročit maximální velikost: - Výchozí maximální velikost: 4 096 kilobajtů. - Absolutní maximální velikost: 2 gigabajty. |
Typ omezení | Omezení |
---|---|
Velikost souboru | Nesmí překročit maximální velikost: - Výchozí maximální velikost: 4 096 kilobajtů. - Absolutní maximální velikost: 2 gigabajty. Další informace najdete v tématu Změna maximální velikosti přílohy pro pracovní položky. |
Názvy sloupců panelu a plavecké dráhy
Váš panel změní backlog na interaktivní podepisující panel, který poskytuje vizuální tok práce. S tím, jak práce pokračuje od nápadu po dokončení, aktualizujete položky na panelu. Každý sloupec představuje pracovní fázi a každá karta představuje uživatelský příběh (modré karty) nebo chybu (červené karty) v dané fázi práce.
Přizpůsobte si panel přidáním, odebráním nebo přejmenováním sloupců a plaveckých drah. Sloupce podporují tok práce na panelu. Plavecké dráhy umožňují spravovat různé třídy práce jako vodorovné pruhy na palubě.
Názvy sloupců a plavecké dráhy musí odpovídat následujícím omezením.
Typ omezení | Omezení |
---|---|
Délka | Nesmí obsahovat více než 256 znaků Unicode. |
Jedinečnost | – Názvy sloupců nesmí být stejné jako žádné jiné názvy sloupců na panelu. - Názvy plavecké dráhy nesmí být stejné jako žádný jiný název plavecké dráhy na palubě. |
Speciální znaky | Nesmí obsahovat žádné znaky ovládacího prvku Unicode ani náhradní znaky. |
Názvy polí
Každý typ pracovní položky obsahuje jedno nebo více polí pracovní položky. Tato pole definují informace uložené pro pracovní položky na základě typu pracovní položky. Každé pole pracovní položky má přidružený název odkazu na pole. Název odkazu na pole jednoznačně identifikuje každé pole a po přiřazení není možné ho změnit. Další informace o polích pracovních položek, která jsou připravená k použití, naleznete v tématu Index pole pracovní položky.
Názvy polí pracovních položek musí odpovídat následujícím omezením.
Typ omezení | Omezení |
---|---|
Délka | Nesmí obsahovat více než 128 znaků Unicode. |
Jedinečnost | – Názvy polí musí obsahovat alespoň jeden abecední znak. - Nesmí obsahovat žádný z následujících znaků: . , ; ' : ~ \ / \ * ? " & % $ ! + = () [] {} <> - |.- Nesmí obsahovat úvodní ani koncové mezery. - Nesmí obsahovat dvě nebo více po sobě jdoucích mezer. |
Speciální znaky | Musí být jedinečný v rámci organizace nebo kolekce projektů. Názvy polí pracovních položek jsou vymezeny na kolekci projektů. Pokud přejmenujete název pole, změníte ho pro všechny pracovní položky a pracovní položky definované ve všech projektech v kolekci. |
Referenční názvy polí a přenositelnost
Jazyk definice typu pracovní položky obsahuje koncept názvu odkazu na pole. Názvy odkazů na pole vám můžou pomoct převést definice portů mezi kolekcemi projektů Team Foundation a také umožnit integraci jiných společností než Microsoftu najít a odkazovat na konkrétní pole. Tyto názvy jsou globálně jedinečné, stejně jako obor názvů v aplikaci .NET Framework je globálně jedinečný.
Obor názvů Systému slouží pouze k definování všech základních systémových polí, která jsou povinná pro systémové funkce Team Foundation. Nemůžete vytvořit vlastní pole System.X, protože by mohlo bránit funkcím.
Obor názvů Microsoftu slouží k definování polí sledování pracovních položek. Tato pole jsou definována v definici typu pracovní položky šablon procesů.
Zákazníci a partneři můžou vytvořit vlastní obory názvů polí pro vlastní typy pracovních položek. Popis systémových polí a polí definovaných ve výchozích šablonách procesů najdete v tématu Index polí pracovních položek.
Důležité
- Názvy odkazů na pole nelze přejmenovat. Pokud jste například změnili název pole "Název" na "Záhlaví", název odkazu na pole tohoto pole zůstane stejný. Integrace a interní reprezentace polí by měly místo názvu samotného pole používat název odkazu na pole.
- I když můžete vytvořit vlastní pole Microsoft.X, nedoporučujeme, abyste to udělali, protože by to mohlo bránit funkcím nebo možnosti průvodce konfigurací funkcí úspěšně aktualizovat projekt po upgradu.
Příklady názvů odkazů na pole
Následující příklady ukazují platné názvy odkazů na pole v různých oborech názvů. Zákazníci a partneři mohou také definovat vlastní obory názvů pro podporu vlastních typů pracovních položek.
Příklady systémového oboru názvů | Příklady oboru názvů Microsoftu | Další příklady oborů názvů |
---|---|---|
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 | Fiktivní společnost Fabrikam Fiber může definovat následující pole vlastních pracovních položek: FabrikamFiber.Common.Severity, FabrikamFiber.Common.Phase, FabrikamFiber.RiskManagement.RiskType, FabrikamFiber.RiskManagement.Resolution Fiktivní softwarová společnost Contoso Corporation může definovat následující pole pracovních položek: Contoso.Common.BusinessPriority, Contoso.Bug.FoundInPhase, Contoso.Bug.FixInPhase |
Text nápovědy k poli
Systém zobrazí text nápovědy za běhu, který uživatelům pomůže zjistit, co se má do pole zadat. Text nápovědy je vymezen na konkrétní typ pracovní položky v konkrétním projektu.
Pro proces dědičnosti zadáte text nápovědy pro pole prostřednictvím dialogového okna Upravit pole , karta Definice , Popis. Viz Přidání vlastního pole do typu pracovní položky. Pro místní proces XML zadáte text nápovědy pomocí elementu HELPTEXT
. Viz Přidání nebo úprava pole pro sledování práce.
Text nápovědy, který přidáte, musí odpovídat následujícím omezením.
Typ omezení | Omezení |
---|---|
Délka | Nesmí obsahovat více než 255 znaků Unicode. |
Globální seznamy
Globální seznam je sada hodnot položek seznamu, které můžete použít globálně ve všech kolekcích projektů v instanci místního Azure DevOps Serveru. Při definování typů pracovních položek můžete zjistit, že některá pole pracovních položek sdílejí stejnou sadu povolených nebo navrhovaných hodnot. Globální seznamy umožňují definovat tyto hodnoty jednou a sdílet je mezi více typy pracovních položek a projekty. Podrobnosti najdete v tématu Definování globálních seznamů.
Globální seznam definovaný pomocí elementu GLOBALLIST
obsahuje jednu nebo více položek seznamu zadaných pomocí elementu LISTITEM
.
LISTITEM
názvy musí odpovídat následujícím omezením.
Typ omezení | Omezení |
---|---|
Délka | – Nesmí obsahovat více než 254 znaků Unicode. - Nesmí být prázdné. |
Speciální znaky | - Nesmí obsahovat úvodní ani koncové prázdné znaky. - Nesmí obsahovat dvě po sobě jdoucí mezery. - Nesmí obsahovat znaky zpětného lomítka \ . |
Obor | Vzhledem k tomu, že globální seznamy jsou dostupné mezi všemi projekty, nesmí obsahovat prvky definované na úrovni projektu, jako jsou definice účtu skupiny specifické pro projekt. |
Globální seznamy musí odpovídat následujícím omezením.
Typ omezení | Omezení |
---|---|
Počet položek | Nemůže být prázdný. Globální seznam musí obsahovat alespoň jeden LISTITEM prvek. |
Jedinečnost | Nemůže být prázdný. Globální seznam musí obsahovat alespoň jeden LISTITEM prvek. |
Odkazy na typ a názvy kategorií
Kdykoli přidáte nebo vytvoříte typ odkazu nebo kategorii, definujte název odkazu. Všechny názvy odkazů můžou mít délku až 70 znaků Unicode.
Definujte název odkazu pomocí alfanumerických znaků, podtržítka a pomlček. Každý název odkazu musí obsahovat aspoň jedno období .
, ale na začátku nebo na konci názvu se nesmí objevit žádné tečky. Název odkazu nesmí začínat číslem nebo podtržítkem a nesmí obsahovat několik po sobě jdoucích pomlček, například --
.
Typ omezení | Omezení |
---|---|
Délka | Nesmí obsahovat více než 70 znaků Unicode. |
Jedinečnost | – Nesmí být shodný s žádným jiným názvem odkazu na pole v kolekci projektů. - Po zpracování těchto názvů počítačem nesmí být totožný s žádným jiným názvem odkazu na pole, aby se nahradila všechna tečka . _ podtržítky . Například názvy My.*Field* odkazů na pole a My.Field oba budou zpracovávat stejný název: My__Field |
Speciální znaky | - Nesmí obsahovat pomlčky - .- Musí obsahovat alespoň jedno období . .- Nesmí začínat ani končit tečkou . .- Nesmí začínat číslemMust, nesmí začínat podtržítkem _ . |
Značky pracovních položek
Značky pracovních položek odpovídají jedné nebo dvou frázím klíčových slov pro filtrování nástrojů pro sledování práce, jako jsou backlogy, panely a dotazy nebo definují dotazy. Další informace najdete v tématu Přidání značek pracovních položek pro kategorizaci a filtrování seznamů a panelů.
Názvy značek musí odpovídat následujícím omezením.
Typ omezení | Omezení |
---|---|
Délka | – Nesmí obsahovat více než 400 znaků Unicode. – Nesmí být null nebo prázdný. |
Speciální znaky | - Nesmí obsahovat oddělovač znaků: , nebo ; .– Nesmí obsahovat znaky ovládacího prvku Unicode ani formátovat, například odřádkování, oddělovač odstavců, návrat na začátek řádku nebo jiné neodpovídající náhradní znaky. |
Obor | Vzhledem k tomu, že globální seznamy jsou dostupné mezi všemi projekty, nesmí obsahovat prvky definované na úrovni projektu, jako jsou definice účtu skupiny specifické pro projekt. |
Azure Pipelines
Definice služby Azure Pipeline musí odpovídat následujícím omezením.
Typ omezení | Omezení |
---|---|
Název úlohy | - Musí obsahovat pouze alfanumerické znaky a '_' .- Nesmí začínat číslem. - Musí mít jedinečný název. – Nesmí obsahovat klíčová slova, například : "deployment" (nasazení). |
Název fáze | - Musí obsahovat pouze alfanumerické znaky a '_' .- Nesmí začínat číslem. – Nesmí obsahovat klíčová slova, například : "deployment" (nasazení). |
Výrazy | Musí začínat a-Z nebo _AND , následovat a-Z , 0-9 nebo _ . |
Další informace najdete v dokumentaci ke službě Azure Pipelines.
Azure Repos (Git)
Každý projekt Azure DevOps může obsahovat několik úložišť Git. Názvy, které přiřadíte k úložištím Git, musí odpovídat následujícím omezením. Další informace najdete v dokumentaci k Gitu pro Azure Repos. Další informace o omezeních pojmenování pro jiné položky Gitu, jako jsou větve a značky, najdete v tématu o formátu git check-ref-ref..
Důležité
I když můžete v názvech úložiště zahrnout mezery, nedoporučujeme to udělat.
Typ omezení | Omezení |
---|---|
Délka | Nesmí obsahovat více než 64 znaků Unicode. |
Jedinečnost | Nesmí být v projektu shodný s žádným jiným názvem úložiště Git. |
Speciální znaky | – Nesmí obsahovat žádné řídicí znaky Unicode ani znaky nahrazení. - Nesmí obsahovat následující tisknutelné znaky: \ / : * ? " < > ; # $ * { } , + = [ ] |.- Nesmí začínat podtržítkem _ .- Nesmí začínat ani končit tečkou . .- Nesmí se jednat o vyhrazený název systému. |
Azure Repos (TFVC)
Správa verzí Team Foundation (TFVC) poskytuje centrální úložiště pro soubory a příkazy potřebné ke správě těchto souborů napříč týmem. Poskytuje také přizpůsobitelné zásady vracení se změnami, větvení, slučování, vkládání a mnoho dalších funkcí. Další informace najdete v dokumentaci k TFVC pro Azure Repos.
Cesty správy verzí musí odpovídat následujícím omezením. Viz také Optimalizace pracovního prostoru.
Typ omezení | Omezení |
---|---|
Délka cesty ke složce správy zdrojového serveru | – Nesmí obsahovat více než 259 znaků Unicode pro jednu složku nebo název souboru. – Nesmí obsahovat více než 388 znaků Unicode pro adresář. – Nesmí obsahovat více než 399 znaků Unicode pro sloučený adresář a název souboru. |
Délka cesty k místní složce | – Nesmí obsahovat více než 248 znaků Unicode pro adresář. – Nesmí obsahovat více než 260 znaků Unicode pro sloučený adresář a název souboru. |
Omezení délky specifické pro webový portál a REST | Nesmí obsahovat více než 215 znaků Unicode pro sloučený název projektu, adresář a název souboru. |
Na webovém portálu a rozhraní REST API mají určité operace více omezující délku cesty než sada Visual Studio a TF.exe klienti. Mezi tyto operace patří operace Upravit, Přejmenovat a Odstranit a dochází k nim, protože webový portál/REST používá náhodně vygenerovaný pracovní prostor pro souběžnost při čekání na změny.
Soubory TFVC
Systém správy verzí ukládá mnoho různých typů souborů. Nastavení správy verzí Team Foundation na vývojovém počítači poskytuje podrobnosti o tom, jak přidat existující projekty nebo řešení sady Visual Studio.
Soubory a složky, které přidáte do správy verzí Team Foundation, musí odpovídat následujícím omezením.
Typ omezení | Omezení |
---|---|
Soubory a složky | - Názvy nesmí obsahovat následující tisknutelné znaky: \ / : * ? " < > ; .– Složky nesmí být mimo mapovaný adresář pro aktivní pracovní prostor. |
Názvy souborů | - Nesmí začínat na $ .- Nesmí obsahovat následující tisknutelné znaky: \ / : * ? " < > ; |. |
Popisky TFVC
Ve správě verzí Team Foundation (TFVC) je popisek použitý pro konkrétní sadu revizí. Popisky můžete připojit k sadě nesouvisejících souborů ve správě verzí, které vám umožní načíst soubory nebo s nimi pracovat jako se skupinou. Následující tabulka popisuje omezení týkající se názvů popisků.
Typ omezení | Omezení |
---|---|
Délka | Nesmí obsahovat více než 64 znaků Unicode. |
Speciální znaky | - Nemůže končit mezerou ( ) nebo tečkou . .- Nesmí obsahovat následující tisknutelné znaky: \ / : * ? " < > ; @ |. |
Sady odložených odlic TFVC
Sady odložených změn umožňují dočasně vyhradit dávku čekajících změn a pak jako možnost odebrat nevyřízené změny z pracovního prostoru. Později můžete změny v sadě odložených změn obnovit do pracovního prostoru nebo je vložit do pracovního prostoru jiného uživatele.
Názvy sad odložených položek musí odpovídat následujícím omezením.
Typ omezení | Omezení |
---|---|
Délka | Nesmí obsahovat více než 64 znaků Unicode. |
Speciální znaky | Nesmí obsahovat následující tisknutelné znaky: \ / : * ? " < > & ; |. |
Pracovní prostory TFVC
Pracovní prostor je kopie souborů a složek na straně klienta ve správě verzí Team Foundation (TFVC). Při vytváření více pracovních prostorů můžete mít na klientském počítači různé verze stejné složky správy verzí. Další podrobnosti najdete v tématu Vytváření a práce s pracovními prostory.
Názvy pracovních prostorů musí odpovídat následujícím omezením.
Typ omezení | Omezení |
---|---|
Délka | Nesmí obsahovat více než 64 znaků Unicode. |
Speciální znaky | - Nesmí končit mezerou ( ) .- Nesmí obsahovat následující tisknutelné znaky: \ / : * ? " < > ; |. |
Názvy počítačů
Název počítače, do kterého instalujete Azure DevOps, je přidružený k názvu serveru. Operační systém i služba Active Directory ukládají na názvy počítačů určitá omezení, jak je popsáno v těchto článcích:
Názvy organizací
Důležité
Při vytváření názvu organizace dodržujte následující pokyny.
- Používejte pouze písmena z anglické abecedy.
- Zahajte název organizace písmenem nebo číslem.
- Použití písmen, číslic nebo pomlček za počátečním znakem
- Ujistěte se, že vaše organizace nepřekračuje 50 znaků Unicode.
- Konec písmenem nebo číslem
Pokud použijete některý z nepovolených znaků, zobrazí se následující chybová zpráva: VS850015: Zadaný název nesmí být použit: {Název organizace}.
Šablony procesů a procesů
Proces definuje stavební bloky systému sledování pracovních položek a dalších subsystémů, ke kterým máte přístup po připojení k projektu.
Poznámka:
Terminologie: "proces" i "šablona procesu" odkazují na vzájemně závislá sada souborů použitých k vytvoření projektu. Další informace najdete v tématu O procesech a šablonách procesů, které popisují rozdíly mezi třemi výchozími procesy, které jsou vám k dispozici.
Procesy, které definujete nebo přizpůsobíte, musí odpovídat následujícím omezením.
Typ omezení | Omezení |
---|---|
Délka | Nesmí obsahovat více než 256 znaků Unicode. |
Jedinečnost | – Musí být jedinečný v rámci Azure DevOps. – Pokud šablonu nahrajete se stejným názvem jako existující šablona, stávající šablona se přepíše. |
Velikost souboru šablony procesu | Nesmí překročit 2 GB (gigabajty). |
Kolekce projektů
Kolekce projektů identifikuje skupinu projektů a zdroje, které jsou k těmto projektům přidružené. Poskytuje organizační strukturu, kterou můžete použít k definování a řízení skupiny projektů definovaných pro Azure DevOps Server.
Název kolekce je také součástí připojovací řetězec sloužící k propojení členů týmu k projektům. Výchozí přiřazená hodnota odpovídá DefaultCollection. Správa kolekcí projektů poskytuje další informace.
Názvy, které přiřadíte kolekci projektů, musí odpovídat následujícím omezením.
Typ omezení | Omezení |
---|---|
Délka | Nesmí obsahovat více než 64 znaků Unicode. |
Jedinečnost | – Nesmí být totožný s žádným jiným názvem kolekce v místním nasazení. – Pokud vaše nasazení zahrnuje sharepointové produkty nebo službu SQL Server Reporting Services, nemůžou být shodné s názvem a úplnou cestou existujícího webu Služby SharePoint, serveru sestav nebo webu služby Reporting Services. |
Rezervované názvy | Nesmí se jednat o vyhrazený název systému. |
Speciální znaky | – Nesmí obsahovat žádné řídicí znaky Unicode ani znaky nahrazení. - Nesmí obsahovat následující tisknutelné znaky: \ / : * ? " < > ; # $ * { } , + = [ ] |. - Nesmí obsahovat tři tečky ... ani dvojitou tečku .. .- Nesmí začínat podtržítkem _ .- Nesmí začínat ani končit tečkou . . |
Názvy projektů
Projekt vytvoří úložiště pro zdrojový kód a místo, kde týmy můžou plánovat, sledovat průběh a spolupracovat. Název projektu je součástí připojovací řetězec sloužící k propojení členů týmu k projektům.
Názvy, které přiřadíte k projektům, které vytvoříte, musí odpovídat následujícím omezením.
Typ omezení | Omezení |
---|---|
Délka | Nesmí obsahovat více než 64 znaků Unicode. |
Jedinečnost | Nesmí být totožný s žádným jiným názvem v kolekci projektů, webovou aplikací SharePoint, která podporuje kolekci, nebo instancí služby SQL Server Reporting Services, která podporuje kolekci. |
Rezervace názvů | - Nesmí se jednat o vyhrazený název systému. – Nesmí být jedním ze skrytých segmentů používaných pro filtrování požadavků služby IIS, jako jsou App_Browsers, App_code, App_Data, App_GlobalResources, App_LocalResources, App_Themes, App_WebResources, bin nebo web.config. |
Speciální znaky | – Nesmí obsahovat žádné řídicí znaky Unicode ani znaky nahrazení. - Nesmí obsahovat následující tisknutelné znaky: \ / : * ? " < > ; # $ * { } , + = [ ] |. - Nesmí začínat podtržítkem _ .- Nesmí začínat ani končit tečkou . . |
Skupiny zabezpečení
Pomocí skupin zabezpečení Azure DevOps můžete u skupiny uživatelů použít určitá práva nebo oprávnění.
Místní skupiny se můžou skládat z účtů skupin Active Directory, skupin zabezpečení Azure DevOps, uživatelských účtů Windows, skupinových účtů Windows nebo jakékoli kombinace těchto typů. Další informace naleznete v tématu Přidání uživatelů nebo skupin Služby Active Directory / Microsoft Entra do předdefinované skupiny zabezpečení.
Skupiny zabezpečení musí odpovídat následujícím omezením.
Typ omezení | Omezení |
---|---|
Délka názvu účtu skupiny zabezpečení | Nesmí obsahovat více než 256 znaků Unicode. |
Jedinečnost | – Účty skupin na úrovni projektu nesmí odpovídat žádnému jinému názvu skupiny ve stejném projektu. – Účty skupin na úrovni kolekce se nesmí shodovat s žádným jiným názvem účtu skupiny v kolekci projektů. |
Názvy rezervovaných skupin | Nesmí být pojmenovaný pomocí $NAMESPACE na úrovni projektu nebo serveru. |
Speciální znaky | – Nesmí obsahovat žádné řídicí znaky Unicode ani znaky nahrazení. - Nesmí obsahovat následující tisknutelné znaky: / \ [ ] : < > + = ; ? * |. – Nesmí obsahovat netisknutelné znaky v rozsahu hodnot ASCII 1–31. - Nesmí končit v období . .- Nesmí obsahovat čárky , . |
Sestavení Team Foundation
Team Foundation Build umožňuje spravovat všechny aspekty procesu sestavení na jednom počítači. Pomocí Team Foundation Buildu můžete synchronizovat zdroje, zkompilovat aplikaci, spouštět přidružené testy jednotek, provádět analýzu kódu, vydávat buildy na souborovém serveru a publikovat sestavy sestavení.
Sestavení počítače
Team Foundation Build je samostatná instalace od aplikační vrstvy Azure DevOps Serveru, datové vrstvy nebo klienta sady Visual Studio. Můžete zvolit samostatný počítač. Jinak můžete sestavení nainstalovat vedle sebe na klientský počítač nebo na servery.
Místní počítač sestavení musí splňovat následující omezení.
Typ omezení | Omezení |
---|---|
Místo na disku | Musí obsahovat dostatek místa pro sestavení (nedostatek místa vede k selhání sestavení). |
Adresář sestavení | Musí to být místní cesta (například C:\BuildDirectory ). |
Drop location directory | Musí to být cesta UNC (například \server\share ). |
Vyřazení oprávnění k umístění | Každé vygenerované sestavení se vloží do nového adresáře do složky drop. – Účet služby Team Foundation Server (například Domain\TFSSERVICE ) musí mít oprávnění úplné řízení přístupu k umístění pro vkládání UNC.– Umístění pro vkládání UNC musí být sdílená složka. |
Účet služby Team Foundation Build Service | Pokud po počáteční instalaci změníte účet služby TFS, musíte se ujistit, že jsou splněné následující podmínky: – Účet je členem skupiny Build Services. – Účet má oprávnění ke čtení a zápisu dočasných složek a ASP.NET dočasné složce. – Účet má oprávnění Úplné řízení k adresáři sestavení a umístění pro vyřazení. |
Problémy s bránou firewall | Pokud je v počítači sestavení povolená brána firewall, ujistěte se, že je program tfsbuildservice v seznamu výjimek. |
Typy sestavení
Typy sestavení konfigurují podmínky, za kterých se sestaví jedno řešení nebo sada řešení v projektu. Pokud chcete provést sestavení, musíte buď vytvořit nový typ sestavení, nebo použít existující typ sestavení.
Názvy typů sestavení musí odpovídat následujícím omezením.
Typ omezení | Omezení |
---|---|
Jedinečnost | Nesmí být stejný jako žádný jiný název typu sestavení v projektu. |
Speciální znaky | Nesmí obsahovat následující tisknutelný znak: $ . |
Kvalita sestavení
Kvalita sestavení umožňuje připojit stav kvality nebo dokončení k dokončené sestavení. Team Foundation Build také umožňuje vytvářet nové hodnoty pro typ kvality sestavení. Seznam výchozích hodnot kvality sestavení najdete v části Ohodnotit kvalitu dokončeného sestavení .
Názvy kvality sestavení musí odpovídat následujícím omezením.
Typ omezení | Omezení |
---|---|
Délka | Nesmí obsahovat více než 256 znaků Unicode. |
Jedinečnost | Nesmí být stejný jako žádný jiný název kvality sestavení v počítači Team Foundation Build. |
Názvy týmů
Názvy týmů identifikují skupinu jednotlivců nebo skupin, které společně spolupracují jako tým v projektu. Členové týmu používají tento název pro připojení k týmu nebo k dotazování na členy definované pro tým.
Názvy týmů musí odpovídat konvencím, které jim umožňují vykreslit jako součást platné adresy URL. Každý název týmu musí být jedinečný v rámci jednoho projektu. Použití stejného názvu týmu v různých projektech v kolekci projektů ale nemá žádná omezení. Další informace najdete v tématu Přidání jiného týmu nebo hierarchie týmů.
Názvy týmů musí odpovídat následujícím omezením.
Typ omezení | Omezení |
---|---|
Délka | Nesmí obsahovat více než 64 znaků Unicode. |
Jedinečnost | Nesmí být totožný s žádným jiným názvem v projektu. |
Rezervované názvy | Nesmí se jednat o vyhrazený název systému. |
Speciální znaky | – Nesmí obsahovat žádné řídicí znaky Unicode ani znaky nahrazení. - Nesmí obsahovat následující tisknutelné znaky: \ / : * ? " < > ; # $ * { } , + = [ ] |.- Nesmí obsahovat tři tečky ... ani dvojitou tečku .. .- Nesmí začínat podtržítkem _ .- Nesmí začínat ani končit tečkou . . |
Uživatelská jména účtů
Uživatelské účty identifikují osoby přidané do projektu nebo kolekce projektů. Uživatelské účty můžou odpovídat položkám v rámci služby Active Directory, Microsoft Entra ID, skupiny serverů Windows.
Uživatelské účty, které přidáte do organizace nebo kolekce, musí splňovat následující omezení. Pokud chcete do projektu přidat uživatelské účty, přečtěte si článek Přidání uživatelů do projektu nebo týmu.
Typ omezení | Omezení |
---|---|
Délka názvu účtu | Nesmí obsahovat více než 256 znaků Unicode. |
Jedinečnost | Nesmí odpovídat žádnému jinému uživatelskému účtu přidanému do kolekce projektů. |
Názvy rezervovaných skupin | Nesmí být pojmenovaný s projektem $NAMESPACE ani na úrovni serveru. |
Speciální znaky | - Nesmí obsahovat následující tisknutelné znaky: "/ \ [ ] : < > + = ; ? * |.– Nesmí obsahovat netisknutelné znaky v rozsahu hodnot ASCII 1–31. - Nesmí končit tečkou . ani znakem $ dolaru .- Nesmí obsahovat čárky , .- Nesmí obsahovat následující kategorie Unicode: LineSeparator, ParagraphSeparator, Control, Format, OtherNotAssigned. |
Názvy stránek wikiwebu a souborů
Každá stránka wikiwebu odpovídá souboru v úložišti Git wikiwebu. Názvy, které přiřadíte k nadpisům stránek wikiwebu, musí splňovat následující omezení.
Typ omezení | Omezení |
---|---|
Název souboru | Plně kvalifikovaná cesta ke stránce by neměla být delší než 235 znaků. |
Jedinečnost | V nadpisech stránek se rozlišují malá a velká písmena a musí být v hierarchii wikiwebu jedinečné. |
Speciální znaky | – Nesmí obsahovat žádné řídicí znaky Unicode ani znaky nahrazení. - Nesmí obsahovat následující tisknutelné znaky: / \ # .- Nesmí začínat ani končit tečkou . . |
Velikost souboru | Nesmí překročit maximální velikost 18 MB. |
Velikost souboru přílohy | Nesmí překročit maximální velikost 19 MB. |
Speciální znaky v názvech stránek wikiwebu
Můžete zadat názvy stránek, které obsahují jeden nebo více těchto speciálních znaků : < > * ? | -
. Například soubor Markdownu můžete pojmenovat jako "FAQ?" nebo "Set-up guide". Znaky mají následující řetězce kódované identifikátorem URI:
Znak | Kódovaný řetězec |
---|---|
: |
%3A |
< |
%3C |
> |
%3E |
* |
%2A |
? |
%3F |
| |
%7C |
- |
%2D |
" |
22 % |