Naamgevingsbeperkingen en conventies
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
De meeste onderdelen in Azure DevOps moeten de naamgevingsbeperkingen en conventies volgen. Beperkingen zorgen voor een consistente gebruikerservaring en bieden compatibiliteit met andere toepassingen.
Algemene beperkingen omvatten het niet overschrijden van de tekenlengte voor een naam, geen speciale tekens bevatten en het behouden van de uniekheid van namen binnen een objectset.
Belangrijk
Wanneer u de API gebruikt, in plaats van gebruikersinterface (UI), kunt u met de API rechtstreeks een naam opgeven, die tekens bevat die mogelijk worden beperkt in de gebruikersinterface.
Best practices:
- Volg de ui-beperkingen om consistentie te behouden en onbedoelde problemen te voorkomen.
- Valideer namen programmatisch en verhandel eventuele speciale tekens op de juiste manier.
Algemene overwegingen
De lengtebeperkingen in dit artikel worden gemeten op basis van het toegestane aantal Unicode-tekens. Surrogaattekens bestaan uit twee Unicode-tekens, die tellen als twee tekens tegen de lengtebeperking. Zie Over Unicode en tekensets voor meer informatie.
Net als bij andere besturingssysteembestanden zijn ASCII-besturingstekens (ASCII 1-31) en surrogaatcombinaties ook niet toegestaan. Zie Naamgevingsbestanden, paden en naamruimten voor algemene informatie over de beperkingen van het besturingssysteem die zijn toegepast op bestandsnamen.
Notitie
- Zie Werktracering, proces- en projectlimieten voor limieten voor het aantal items dat u kunt definiëren.
Door het systeem gereserveerde namen
Vermijd het gebruik van door het systeem gereserveerde namen, zoals de volgende voorbeelden:
- AUX
- COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10
- BEDRIEGEN
- DefaultCollection
- LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9
- NUL
- PRN
- SERVER, SignalR
- Web of WEB
Zie Bestandsnamen, paden en naamruimten voor meer informatie over gereserveerde namen.
Azure Artifacts
Universele pakketten moeten voldoen aan de volgende beperkingen.
Beperkingstype | Beperking |
---|---|
Naam van het pakket | - Moet kleine letters zijn. - Moet beginnen en eindigen met letters of cijfers. - Mag alleen letters, cijfers en niet-aangrenzende streepjes, onderstrepingstekens of punten bevatten. |
Versie van het pakket | Moet kleine letters bevatten zonder buildmetagegevens. |
Azure Boards
U gebruikt werkitems om informatie vast te leggen om uw softwareontwikkelingsprojecten te plannen en bij te houden. Met werkitems kunt u het werk beschrijven dat moet worden uitgevoerd, werk toewijzen, status bijhouden en inspanningen binnen uw team coördineren. Verschillende soorten werkitems, zoals gebruikersverhalen, taken, bugs en problemen, volgen verschillende soorten informatie. Zie de documentatie van Azure Boards voor meer informatie.
Alle objecten voor het bijhouden van werkitems zijn gekoppeld aan een of meer namen. De meeste hebben beschrijvende weergavenamen, behalve werkitemtypen en algemene lijsten, die zijn gekoppeld aan referentienamen. Een beschrijvende naam is een unieke, door de gebruiker zichtbare id voor een veld. Het gebruik van beschrijvende namen zorgt voor consistentie tussen projecten en typen werkitems in een projectverzameling. Het systeem gebruikt de verwijzingsnaam intern en u kunt deze niet meer wijzigen nadat deze is gedefinieerd.
Er zijn beperkingen voor verschillende elementen die zijn gekoppeld aan werkitems, waaronder verwijzings- en beschrijvende namen, veldnamen en bijlagegrootte.
Gebieds- en iteratiepaden
Twee werkitemvelden, Gebiedspad en Iteratiepad, bieden een structuurhiërarchie voor het groeperen van werk. Gebiedspaden groeperen werkitems op product-, functionele of functiegebied. Iteratiepaden groeperen werkitems in sprints, mijlpalen of tijdsperioden voor het adresseren van deze werkitems.
Deze velden met meerdere knooppunten gebruiken de backslashtekens \
om de hiërarchie van knooppunten in de structuurstructuur aan te geven.
De namen die u aan onderliggende knooppunten aan deze velden toewijst, moeten voldoen aan de volgende beperkingen.
Beperkingstype | Beperking |
---|---|
Lengte van knooppunt | Mag niet meer dan 255 tekens bevatten. |
Gereserveerde namen | - Mag niet alleen bestaan uit een of . twee perioden .. .- Mag geen door het systeem gereserveerde naam zijn, zoals PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON of AUX. Zie Bestandsnamen, paden en naamruimten voor meer informatie over gereserveerde namen. |
Speciale tekens voor knooppunten | - Mag geen Unicode-besturingstekens bevatten. - Mag geen van de volgende tekens bevatten: \ / : * ? " < > | # $ * + - Mag geen tekens bevatten die niet zijn toegestaan door het lokale bestandssysteem. Zie Naamgevingsbestanden, paden en naamruimten voor meer informatie over beperkingen voor Windows-tekens. |
Padlengte | Mag niet meer dan 4000 Unicode-tekens bevatten. |
Diepte van padhiërarchie | Moet minder dan 14 niveaus diep zijn. |
Bijlagen
Bestanden die aan werkitems zijn gekoppeld, moeten voldoen aan de volgende beperkingen.
Beperkingstype | Beperking |
---|---|
Bestandsgrootte | Mag niet groter zijn dan de maximale grootte: - Standaard maximale grootte: 4.096 kilobytes. - Absolute maximale grootte: 2 gigabyte. |
Beperkingstype | Beperking |
---|---|
Bestandsgrootte | Mag niet groter zijn dan de maximale grootte: - Standaard maximale grootte: 4.096 kilobytes. - Absolute maximale grootte: 2 gigabyte. Zie De maximale bijlagegrootte voor werkitems wijzigen voor meer informatie. |
Namen van bordkolommen en zwembanen
Uw bord verandert uw achterstand in een interactief signboard, wat een visuele werkstroom biedt. Naarmate het werk van idee tot voltooiing vordert, werkt u de items op het bord bij. Elke kolom vertegenwoordigt een werkfase en elke kaart vertegenwoordigt een gebruikersverhaal (blauwe kaarten) of een bug (rode kaarten) in die fase van het werk.
Pas uw bord aan door kolommen en zwembanen toe te voegen, te verwijderen of de naam ervan te wijzigen. Kolommen ondersteunen de werkstroom over het hele bord. Met zwembanen kunt u verschillende werkklassen beheren als horizontale banen op het bord.
Kolom- en zwembaannamen moeten voldoen aan de volgende beperkingen.
Beperkingstype | Beperking |
---|---|
Lengte | Mag niet meer dan 256 Unicode-tekens bevatten. |
Uniciteit | - Kolomnamen mogen niet hetzelfde zijn als een andere kolomnaam op het bord. - Namen van zwembanen mogen niet hetzelfde zijn als andere zwembaannamen op het bord. |
Speciale tekens | Mag geen Unicode-besturingstekens of surrogaattekens bevatten. |
Veldnamen
Elk type werkitem bevat een of meer werkitemvelden. Deze velden definiëren de gegevens die zijn opgeslagen voor werkitems op basis van het type werkitem. Elk werkitemveld heeft een gekoppelde veldreferentienaam. De naam van de veldreferentie identificeert elk veld op unieke wijze en kan niet meer worden gewijzigd nadat deze is toegewezen. Zie de veldindex Werkitem voor meer informatie over out-of-box-werkitemvelden.
Veldnamen van werkitems moeten voldoen aan de volgende beperkingen.
Beperkingstype | Beperking |
---|---|
Lengte | Mag niet meer dan 128 Unicode-tekens bevatten. |
Uniciteit | - Veldnamen moeten ten minste één alfabetisch teken bevatten. - Mag geen van de volgende tekens bevatten: . , ; ' : ~ \ / \ * ? " & % $ ! + = () [] {} <> - |.- Mag geen voorloop- of volgspaties bevatten. - Mag geen twee of meer opeenvolgende spaties bevatten. |
Speciale tekens | Moet uniek zijn binnen de organisatie of projectverzameling. Veldnamen van werkitems zijn gericht op de projectverzameling. Als u de naam van een veld wijzigt, wijzigt u deze voor alle werkitems en WIT's die in alle projecten in de verzameling zijn gedefinieerd. |
Veldreferentienamen en draagbaarheid
De definitietaal van het type werkitem bevat het concept van een veldreferentienaam. Veldverwijzingsnamen kunnen u helpen bij het overzetten van definities tussen Team Foundation-projectverzamelingen en om niet-Microsoft-integraties toe te staan om specifieke velden te vinden en ernaar te verwijzen. Deze namen zijn wereldwijd uniek, net zoals een naamruimte in de .NET Framework-toepassing wereldwijd uniek is.
De systeemnaamruimte wordt alleen gebruikt om alle kernsysteemvelden te definiëren die verplicht zijn voor Team Foundation-systeemfuncties. U kunt uw eigen System.X-veld niet maken omdat dit de functionaliteit kan belemmeren.
De Microsoft-naamruimte wordt gebruikt om velden voor het bijhouden van werkitems te definiëren. Deze velden worden gedefinieerd in een werkitemtypedefinitie van de processjablonen.
Klanten en partners kunnen hun eigen veldnaamruimten maken voor aangepaste typen werkitems. Zie Index van werkitemvelden voor beschrijvingen van systeemvelden en -velden die zijn gedefinieerd in de standaardprocessjablonen.
Belangrijk
- Namen van veldreferenties kunnen niet worden gewijzigd. Als u bijvoorbeeld de veldnaam 'Titel' hebt gewijzigd in Koptekst, blijft de veldreferentienaam van dat veld hetzelfde. Integraties en interne weergaven van velden moeten de veldreferentienaam gebruiken in plaats van afhankelijk van de veldnaam zelf.
- Hoewel u uw eigen Microsoft.X-veld kunt maken, wordt u aangeraden dit niet te doen, omdat dit de functionaliteit of de mogelijkheid voor de wizard Onderdelen configureren kan belemmeren om een project na een upgrade bij te werken.
Voorbeelden van veldreferentienamen
In de volgende voorbeelden ziet u geldige veldreferentienamen in verschillende naamruimten. Klanten en partners kunnen ook hun eigen naamruimten definiëren ter ondersteuning van hun aangepaste werkitemtypen.
Voorbeelden van systeemnaamruimten | Voorbeelden van Microsoft-naamruimten | Andere naamruimtevoorbeelden |
---|---|---|
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.TestSuiteTypeType | Het fictieve bedrijf Fabrikam Fiber kan de volgende aangepaste werkitemvelden definiëren: FabrikamFiber.Common.Severity, FabrikamFiber.Common.Phase, FabrikamFiber.RiskManagement.RiskType, FabrikamFiber.RiskManagement.Resolution Het fictieve softwarebedrijf Contoso Corporation kan de volgende werkitemvelden definiëren: Contoso.Common.BusinessPriority, Contoso.Bug.FoundInPhase, Contoso.Bug.FixInPhase |
Help-tekst voor velden
Het systeem geeft tijdens runtime helptekst weer om gebruikers te helpen weten wat ze moeten invoeren in het veld. Help-tekst is afgestemd op een specifiek type werkitem in een specifiek project.
Voor het overnameproces geeft u Help-tekst voor een veld op via het dialoogvenster Veld bewerken, tabblad Definitie , Beschrijving. Zie Een aangepast veld toevoegen aan een werkitemtype. Voor het on-premises XML-proces geeft u Help-tekst op met behulp van het HELPTEXT
element. Zie Een veld toevoegen of wijzigen voor het bijhouden van werk.
Help-tekst die u toevoegt, moet voldoen aan de volgende beperkingen.
Beperkingstype | Beperking |
---|---|
Lengte | Mag niet meer dan 255 Unicode-tekens bevatten. |
Algemene lijsten
Een globale lijst is een set lijstitemwaarden die u globaal kunt gebruiken in alle projectverzamelingen binnen een exemplaar van een on-premises Azure DevOps Server. Wanneer u werkitemtypen definieert, kan het zijn dat sommige werkitemvelden dezelfde set toegestane of voorgestelde waarden delen. Met globale lijsten kunt u deze waarden eenmalig definiëren en delen in meerdere typen werkitems en projecten. Zie Globale lijsten definiëren voor meer informatie.
Een globale lijst, gedefinieerd met behulp van het GLOBALLIST
element, bevat een of meer lijstitems, die zijn opgegeven met behulp van het LISTITEM
element.
LISTITEM
namen moeten voldoen aan de volgende beperkingen.
Beperkingstype | Beperking |
---|---|
Lengte | - Mag niet meer dan 254 Unicode-tekens bevatten. - Mag niet leeg zijn. |
Speciale tekens | - Mag geen voorloop- of volgspaties bevatten. - Mag geen twee opeenvolgende spaties bevatten. - Mag geen backslash-tekens \ bevatten. |
Bereik | Aangezien globale lijsten beschikbaar zijn voor alle projecten, mogen ze geen elementen bevatten die zijn gedefinieerd op projectniveau, zoals projectspecifieke groepsaccountdefinities. |
Globale lijsten moeten voldoen aan de volgende beperkingen.
Beperkingstype | Beperking |
---|---|
Aantal artikelen | Mag niet leeg zijn. De algemene lijst moet ten minste één LISTITEM element bevatten. |
Uniciteit | Mag niet leeg zijn. De algemene lijst moet ten minste één LISTITEM element bevatten. |
Koppelingstype en categoriereferentienamen
Definieer een verwijzingsnaam wanneer u een koppelingstype of categorie toevoegt of maakt. Alle verwijzingsnamen kunnen maximaal 70 Unicode-tekens lang zijn.
Definieer een verwijzingsnaam met behulp van alfanumerieke tekens, onderstrepingstekens en afbreekstreepjes. Elke verwijzingsnaam moet ten minste één punt .
bevatten, maar er kan geen punt worden weergegeven aan het begin of einde van een naam. Een verwijzingsnaam mag niet beginnen met een getal of een onderstrepingsteken en mag niet meerdere opeenvolgende afbreekstreepjes bevatten, zoals --
.
Beperkingstype | Beperking |
---|---|
Lengte | Mag niet meer dan 70 Unicode-tekens bevatten. |
Uniciteit | - Mag niet identiek zijn aan een andere veldverwijzingsnaam binnen de projectverzameling. - Mag niet identiek zijn aan een andere veldverwijzingsnaam nadat deze namen door de computer worden verwerkt om alle punten . te vervangen door onderstrepingstekens _ . De veldreferentienamen My.*Field* worden bijvoorbeeld verwerkt als My.Field dezelfde naam: My__Field |
Speciale tekens | - Mag geen afbreekstreepjes - bevatten.- moet ten minste één punt . bevatten.- Mag niet beginnen of eindigen met een punt . .- Mag niet beginnen met een numberMust niet beginnen met een onderstrepingsteken _ . |
Werkitemtags
Werkitemtags komen overeen met een of twee trefwoordtermen voor het filteren van hulpprogramma's voor het bijhouden van werk, zoals achterstanden, borden en query's of het definiëren van query's. Zie Werkitemtags toevoegen om lijsten en borden te categoriseren en te filteren voor meer informatie.
Tagnamen moeten voldoen aan de volgende beperkingen.
Beperkingstype | Beperking |
---|---|
Lengte | - Mag niet meer dan 400 Unicode-tekens bevatten. - Mag niet null of leeg zijn. |
Speciale tekens | - Mag geen scheidingstekens bevatten: , of ; .- Mag geen Unicode-besturingselementen of opmaaktekens bevatten, zoals een regelinvoer, alineascheidingsteken, regelterugloop of andere niet-overeenkomende surrogaattekens. |
Bereik | Aangezien globale lijsten beschikbaar zijn voor alle projecten, mogen ze geen elementen bevatten die zijn gedefinieerd op projectniveau, zoals projectspecifieke groepsaccountdefinities. |
Azure-pipelines
Azure Pipeline-definities moeten voldoen aan de volgende beperkingen.
Beperkingstype | Beperking |
---|---|
Taaknaam | - Mag alleen alfanumerieke tekens bevatten en '_' .- Mag niet beginnen met een getal. - Moet een unieke naam hebben. - Mag geen trefwoorden bevatten, bijvoorbeeld: 'implementatie'. |
Fasenaam | - Mag alleen alfanumerieke tekens bevatten en '_' .- Mag niet beginnen met een getal. - Mag geen trefwoorden bevatten, bijvoorbeeld: 'implementatie'. |
Expressies | Moet beginnen met a-Z of _AND , gevolgd door a-Z , 0-9 of _ . |
Zie de documentatie voor Azure Pipelines voor meer informatie.
Azure-opslagplaatsen (Git)
Elk Azure DevOps-project kan meerdere Git-opslagplaatsen bevatten. De namen die u aan Git-opslagplaatsen toewijst, moeten voldoen aan de volgende beperkingen. Zie de Git-documentatie voor Azure-opslagplaatsen voor meer informatie. Zie git check-ref-format voor meer informatie over naamgevingsbeperkingen voor andere Git-items, zoals vertakkingen en tags.
Belangrijk
Hoewel u spaties in namen van opslagplaatsen kunt opnemen, wordt u aangeraden dit niet te doen.
Beperkingstype | Beperking |
---|---|
Lengte | Mag niet meer dan 64 Unicode-tekens bevatten. |
Uniciteit | Mag niet identiek zijn aan een andere Git-opslagplaatsnaam in het project. |
Speciale tekens | - Mag geen Unicode-besturingstekens of surrogaattekens bevatten. - Mag niet de volgende afdrukbare tekens bevatten: \ / : * ? " < > ; # $ * { } , + = [ ] |.- Mag niet beginnen met een onderstrepingsteken _ .- Mag niet beginnen of eindigen met een punt . .- Mag geen door het systeem gereserveerde naam zijn. |
Azure-opslagplaatsen (TFVC)
Team Foundation-versiebeheer (TFVC) biedt een centrale opslagplaats voor bestanden en de opdrachten die nodig zijn om deze bestanden in een team te beheren. Het biedt ook aanpasbare incheckbeleidsregels, vertakkingen, samenvoegen, rekken en vele andere functies. Zie de TFVC-documentatie voor Azure-opslagplaatsen voor meer informatie
Versiebeheerpaden moeten voldoen aan de volgende beperkingen. Zie ook Uw werkruimte optimaliseren.
Beperkingstype | Beperking |
---|---|
Lengte van mappad voor serverbronbeheer | - Mag niet meer dan 259 Unicode-tekens bevatten voor één map of bestandsnaam. - Mag niet meer dan 388 Unicode-tekens voor een map bevatten. - Mag niet meer dan 399 Unicode-tekens bevatten voor een gecombineerde map en bestandsnaam. |
Lengte van lokale mappad | - Mag niet meer dan 248 Unicode-tekens voor een map bevatten. - Mag niet meer dan 260 Unicode-tekens bevatten voor een gecombineerde map en bestandsnaam. |
Beperkingen voor webportal en REST-specifieke lengte | Mag niet meer dan 215 Unicode-tekens bevatten voor een gecombineerde projectnaam, map en bestandsnaam. |
In de webportal en REST API hebben bepaalde bewerkingen een meer beperkende padlengte dan Visual Studio en TF.exe-clients. Deze bewerkingen omvatten Bewerken, Hernoemen en Verwijderen, omdat de webportal/REST een willekeurig gegenereerde werkruimte gebruikt voor gelijktijdigheid wanneer de wijzigingen in behandeling zijn.
TFVC-bestanden
In het versiebeheersysteem worden veel verschillende typen bestanden opgeslagen. Team Foundation-versiebeheer instellen op uw ontwikkelcomputer biedt informatie over het toevoegen van bestaande Visual Studio-projecten of -oplossingen.
Bestanden en mappen die u aan Team Foundation-versiebeheer toevoegt, moeten voldoen aan de volgende beperkingen.
Beperkingstype | Beperking |
---|---|
Bestanden en mappen | - Namen mogen niet de volgende afdrukbare tekens bevatten: \ / : * ? " < > ; .- Mappen mogen zich niet buiten de toegewezen map voor de actieve werkruimte bevinden. |
Bestandsnamen | - Mag niet beginnen met een $ .- Mag niet de volgende afdrukbare tekens bevatten: \ / : * ? " < > ; |. |
TFVC-labels
In Team Foundation-versiebeheer (TFVC) is een label een naam die wordt toegepast op een specifieke set revisies. U kunt labels toevoegen aan een set niet-gerelateerde bestanden in versiebeheer, waarmee u de bestanden kunt ophalen of erop kunt reageren als groep. In de volgende tabel worden de beperkingen beschreven die gelden voor labelnamen.
Beperkingstype | Beperking |
---|---|
Lengte | Mag niet meer dan 64 Unicode-tekens bevatten. |
Speciale tekens | - Kan niet eindigen met een spatie ( ) of punt . .- Mag niet de volgende afdrukbare tekens bevatten: \ / : * ? " < > ; @ |. |
TFVC-plankensets
Met plankensets kunt u tijdelijk een batch wijzigingen in behandeling instellen en vervolgens, als optie, de in behandeling zijnde wijzigingen uit uw werkruimte verwijderen. Later kunt u de wijzigingen in een plankenset herstellen naar uw werkruimte of deze in de werkruimte van een andere gebruiker plaatsen.
Plankennamen moeten voldoen aan de volgende beperkingen.
Beperkingstype | Beperking |
---|---|
Lengte | Mag niet meer dan 64 Unicode-tekens bevatten. |
Speciale tekens | Mag niet de volgende afdrukbare tekens bevatten: \ / : * ? " < > & ; |. |
TFVC-werkruimten
Een werkruimte is een kopie aan de clientzijde van de bestanden en mappen in TfVC (Team Foundation Version Control). Wanneer u meerdere werkruimten maakt, kunt u verschillende versies van dezelfde versiebeheermap op een clientcomputer hebben. Meer informatie over het maken en werken met werkruimten .
Werkruimtenamen moeten voldoen aan de volgende beperkingen.
Beperkingstype | Beperking |
---|---|
Lengte | Mag niet meer dan 64 Unicode-tekens bevatten. |
Speciale tekens | - Mag niet eindigen met een spatie ( ) .- Mag niet de volgende afdrukbare tekens bevatten: \ / : * ? " < > ; |. |
Computernamen
De computernaam waar u Azure DevOps installeert, is gekoppeld aan de naam van de server. Zowel het besturingssysteem als Active Directory stellen bepaalde beperkingen op voor computernamen, zoals beschreven in deze artikelen:
Organisatienamen
Belangrijk
Volg de volgende richtlijnen wanneer u een organisatienaam maakt.
- Alleen letters uit het Engelse alfabet gebruiken
- De naam van uw organisatie starten met een letter of cijfer
- Letters, cijfers of afbreekstreepjes na het eerste teken gebruiken
- Zorg ervoor dat uw organisatie niet groter is dan 50 Unicode-tekens
- Eindigen met een letter of cijfer
Als u een van de niet-toegestane tekens gebruikt, wordt het volgende foutbericht weergegeven: VS850015: De opgegeven naam mag niet worden gebruikt: {Organisatienaam}.
Proces- en processjablonen
Een proces definieert de bouwstenen van het systeem voor het bijhouden van werkitems en andere subsystemen waartoe u toegang hebt nadat u verbinding hebt gemaakt met een project.
Notitie
Terminologie: Zowel 'proces' als 'processjabloon' verwijzen naar een onderling afhankelijke set bestanden die worden gebruikt om een project te maken. Zie Voor meer informatie over processen en processjablonen, waarin de verschillen worden beschreven tussen de drie standaardprocessen die voor u beschikbaar zijn.
Processen die u definieert of aanpast, moeten voldoen aan de volgende beperkingen.
Beperkingstype | Beperking |
---|---|
Lengte | Mag niet meer dan 256 Unicode-tekens bevatten. |
Uniciteit | - Moet uniek zijn in Azure DevOps. - Als u een sjabloon met dezelfde naam als een bestaande sjabloon uploadt, wordt de bestaande sjabloon overschreven. |
Grootte van processjabloonbestand | Mag niet groter zijn dan 2 GB (gigabytes). |
Projectverzamelingen
Een projectverzameling identificeert een groep projecten en de resources die aan deze projecten zijn gekoppeld. Het biedt een organisatiestructuur die u kunt gebruiken om een groep projecten te definiëren en te beheren die zijn gedefinieerd voor een Azure DevOps-server.
De naam van de verzameling maakt ook deel uit van de verbindingsreeks die wordt gebruikt om teamleden te verbinden met projecten. De standaard toegewezen komt overeen met DefaultCollection. Projectverzamelingen beheren biedt meer informatie.
Namen die u aan projectverzamelingen toewijst, moeten voldoen aan de volgende beperkingen.
Beperkingstype | Beperking |
---|---|
Lengte | Mag niet meer dan 64 Unicode-tekens bevatten. |
Uniciteit | - Mag niet identiek zijn aan een andere verzamelingsnaam in uw on-premises implementatie. - Als uw implementatie SharePoint-producten of SQL Server Reporting Services bevat, kunnen ze niet identiek zijn aan de naam en het volledige pad van een bestaande SharePoint-site, rapportserver of Reporting Services-website. |
Gereserveerde namen | Mag geen door het systeem gereserveerde naam zijn. |
Speciale tekens | - Mag geen Unicode-besturingstekens of surrogaattekens bevatten. - Mag niet de volgende afdrukbare tekens bevatten: \ / : * ? " < > ; # $ * { } , + = [ ] |. - Mag geen beletselteken ... of dubbele punt .. bevatten.- Mag niet beginnen met een onderstrepingsteken _ .- Mag niet beginnen of eindigen met een punt . . |
Projectnamen
Met een project wordt een opslagplaats voor broncode en een locatie voor teams gemaakt om de voortgang te plannen, bij te houden en samen te werken. De naam van het project maakt deel uit van de verbindingsreeks die wordt gebruikt om teamleden te verbinden met projecten.
Namen die u toewijst aan projecten die u maakt, moeten voldoen aan de volgende beperkingen.
Beperkingstype | Beperking |
---|---|
Lengte | Mag niet meer dan 64 Unicode-tekens bevatten. |
Uniciteit | Mag niet identiek zijn aan een andere naam in de projectverzameling, de SharePoint-webtoepassing die ondersteuning biedt voor de verzameling of het exemplaar van SQL Server Reporting Services dat de verzameling ondersteunt. |
Namen van reserves | - Mag geen door het systeem gereserveerde naam zijn. - Mag niet een van de verborgen segmenten zijn die worden gebruikt voor IIS-aanvraagfiltering, zoals App_Browsers, App_code, App_Data, App_GlobalResources, App_LocalResources, App_Themes, App_WebResources, bin of web.config. |
Speciale tekens | - Mag geen Unicode-besturingstekens of surrogaattekens bevatten. - Mag niet de volgende afdrukbare tekens bevatten: \ / : * ? " < > ; # $ * { } , + = [ ] |. - Mag niet beginnen met een onderstrepingsteken _ .- Mag niet beginnen of eindigen met een punt . . |
Beveiligingsgroepen
Met Azure DevOps-beveiligingsgroepen kunt u bepaalde rechten of machtigingen toepassen op een groep gebruikers.
On-premises groepen kunnen bestaan uit Active Directory-groepsaccounts, Azure DevOps-beveiligingsgroepen, Windows-gebruikersaccounts, Windows-groepsaccounts of een combinatie van deze typen. Zie Active Directory/ Microsoft Entra-gebruikers of -groepen toevoegen aan een ingebouwde beveiligingsgroep voor meer informatie.
Beveiligingsgroepen moeten voldoen aan de volgende beperkingen.
Beperkingstype | Beperking |
---|---|
Lengte van accountnaam van beveiligingsgroep | Mag niet meer dan 256 Unicode-tekens bevatten. |
Uniciteit | - Groepsaccounts op projectniveau mogen niet overeenkomen met een andere groepsnaam in hetzelfde project. - Groepsaccounts op verzamelingsniveau mogen niet overeenkomen met een andere naam van een groepsaccount in de projectverzameling. |
Gereserveerde groepsnamen | Mag geen naam hebben met een $NAMESPACE op project- of serverniveau. |
Speciale tekens | - Mag geen Unicode-besturingstekens of surrogaattekens bevatten. - Mag niet de volgende afdrukbare tekens bevatten: / \ [ ] : < > + = ; ? * |. - Mag geen niet-afdrukbare tekens bevatten in het ASCII-waardebereik van 1-31. - Mag niet eindigen in een periode . .- Mag geen komma's , bevatten. |
Team Foundation Build
Met Team Foundation Build kunt u alle aspecten van het buildproces op één computer beheren. Met Behulp van Team Foundation Build kunt u de bronnen synchroniseren, de toepassing compileren, gekoppelde eenheidstests uitvoeren, codeanalyse uitvoeren, builds vrijgeven op een bestandsserver en buildrapporten publiceren.
Computer bouwen
Team Foundation Build is een afzonderlijke installatie van de Azure DevOps Server-toepassingslaag, gegevenslaag of Visual Studio-client. U kunt een afzonderlijke computer kiezen. Anders kunt u de build naast elkaar installeren op de clientcomputer of op de servers.
Uw on-premises buildcomputer moet voldoen aan de volgende beperkingen.
Beperkingstype | Beperking |
---|---|
Schijfruimte | Moet voldoende ruimte bevatten voor de build (onvoldoende ruimte leidt tot mislukte builds). |
Map bouwen | Moet een lokaal pad zijn (bijvoorbeeld C:\BuildDirectory ). |
Locatiemap verwijderen | Moet een UNC-pad zijn (bijvoorbeeld \server\share ). |
Locatiemachtigingen verwijderen | Elke gegenereerde build wordt in een nieuwe map in de neerzetmap geplaatst. - Het Team Foundation Server-serviceaccount (bijvoorbeeld Domain\TFSSERVICE ) moet de machtiging Volledig beheer hebben tot de UNC-locatie voor neerzetten.- De locatie van de UNC-drop moet een gedeelde map zijn. |
Team Foundation Build Service-account | Als u het TFS-serviceaccount na de eerste installatie wijzigt, moet u ervoor zorgen dat aan de volgende voorwaarden wordt voldaan: - Het account is lid van de groep Build Services. - Het account heeft lees-/schrijfmachtigingen voor de tijdelijke mappen en de ASP.NET tijdelijke map. - Het account heeft de machtiging Volledig beheer voor de buildmap en drop-locatie. |
Problemen met de firewall | Als de buildcomputer is ingeschakeld, controleert u of het programma, tfsbuildservice, in de lijst met uitzonderingen staat. |
Buildtypen
Bouwtypen configureren de voorwaarden waaronder één oplossing of een set oplossingen in een project worden gebouwd. Als u een build wilt uitvoeren, moet u een nieuw buildtype maken of een bestaand buildtype gebruiken.
Namen van buildtypen moeten voldoen aan de volgende beperkingen.
Beperkingstype | Beperking |
---|---|
Uniciteit | Mag niet hetzelfde zijn als een andere buildtypenaam in het project. |
Speciale tekens | Mag niet het volgende afdrukbare teken bevatten: $ . |
Bouwkwaliteit
Met de buildkwaliteit kunt u een kwaliteits- of voltooiingsstatus koppelen aan een voltooide build. Met Team Foundation Build kunt u ook nieuwe waarden maken voor het type buildkwaliteit. Zie De kwaliteit van een voltooide build beoordelen voor een lijst met de standaardwaarden voor de buildkwaliteit.
Namen van buildkwaliteit moeten voldoen aan de volgende beperkingen.
Beperkingstype | Beperking |
---|---|
Lengte | Mag niet meer dan 256 Unicode-tekens bevatten. |
Uniciteit | Mag niet hetzelfde zijn als een andere buildkwaliteitsnaam op de Team Foundation Build-computer. |
Teamnamen
Teamnamen identificeren een groep personen of groepen die gezamenlijk samenwerken als een team in een project. Teamleden gebruiken deze naam om verbinding te maken met het team of om query's uit te voeren op leden die voor een team zijn gedefinieerd.
Teamnamen moeten voldoen aan conventies waarmee ze kunnen worden weergegeven als onderdeel van een geldige URL. Elke teamnaam moet uniek zijn binnen één project. Er zijn echter geen beperkingen voor het gebruik van dezelfde teamnaam in verschillende projecten binnen een projectverzameling. Zie Een ander team of een hiërarchie van teams toevoegen voor meer informatie.
Teamnamen moeten voldoen aan de volgende beperkingen.
Beperkingstype | Beperking |
---|---|
Lengte | Mag niet meer dan 64 Unicode-tekens bevatten. |
Uniciteit | Mag niet identiek zijn aan een andere naam in het project. |
Gereserveerde namen | Mag geen door het systeem gereserveerde naam zijn. |
Speciale tekens | - Mag geen Unicode-besturingstekens of surrogaattekens bevatten. - Mag niet de volgende afdrukbare tekens bevatten: \ / : * ? " < > ; # $ * { } , + = [ ] |.- Mag geen beletselteken ... of dubbele punt .. bevatten.- Mag niet beginnen met een onderstrepingsteken _ .- Mag niet beginnen of eindigen met een punt . . |
Gebruikersaccountnamen
Gebruikersaccounts identificeren personen die zijn toegevoegd aan een project of projectverzameling. Gebruikersaccounts komen mogelijk overeen met vermeldingen in Active Directory, Microsoft Entra-id, Windows-servergroep.
Gebruikersaccounts die u aan een organisatie of verzameling toevoegt, moeten voldoen aan de volgende beperkingen. Als u gebruikersaccounts wilt toevoegen aan een project, raadpleegt u Gebruikers toevoegen aan een project of team.
Beperkingstype | Beperking |
---|---|
Lengte van accountnaam | Mag niet meer dan 256 Unicode-tekens bevatten. |
Uniciteit | Mag niet overeenkomen met een ander gebruikersaccount dat is toegevoegd aan de projectverzameling. |
Gereserveerde groepsnamen | Mag geen naam hebben met een $NAMESPACE project of op serverniveau. |
Speciale tekens | - Mag niet de volgende afdrukbare tekens bevatten: "/ \ [ ] : < > + = ; ? * |.- Mag geen niet-afdrukbare tekens bevatten in het ASCII-waardebereik van 1-31. - Mag niet eindigen op een punt . of een dollarteken $ .- Mag geen komma's , bevatten.- Mag niet de volgende Unicode-categorieën bevatten: LineSeparator, AlineaSeparator, Control, Format, OtherNotAssigned. |
Wikipagina en bestandsnamen
Elke wikipagina komt overeen met een bestand in de Git-opslagplaats van de wiki. Namen die u aan een wikipaginatitel toewijst, moeten voldoen aan de volgende beperkingen.
Beperkingstype | Beperking |
---|---|
Bestandsnaam | Het volledig gekwalificeerde paginapad mag niet langer zijn dan 235 tekens. |
Uniciteit | Paginatitels zijn hoofdlettergevoelig en moeten uniek zijn binnen de wiki-hiërarchie. |
Speciale tekens | - Mag geen Unicode-besturingstekens of surrogaattekens bevatten. - Mag niet de volgende afdrukbare tekens bevatten: / \ # .- Mag niet beginnen of eindigen met een punt . . |
Bestandsgrootte | Mag niet groter zijn dan 18 MB. |
Bestandsnaam van bijlage | Mag niet groter zijn dan 19 MB. |
Speciale tekens in wikipaginatitels
U kunt paginatitels opgeven die een of meer van deze speciale tekens : < > * ? | -
bevatten. U kunt bijvoorbeeld een Markdown-bestand een naam geven als 'Veelgestelde vragen?' of 'Handleiding instellen'. De tekens hebben de volgende gecodeerde URI-tekenreeksen:
Teken | Gecodeerde tekenreeks |
---|---|
: |
%3A |
< |
%3C |
> |
%3E |
* |
%2A |
? |
%3F |
| |
%7C |
- |
%2D |
" |
22% |