Namngivningsbegränsningar och konventioner

  • Artikel

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

De flesta komponenter i Azure DevOps måste följa namngivningsbegränsningar och konventioner. Begränsningar garanterar en konsekvent användarupplevelse och ger kompatibilitet med andra program.

Vanliga begränsningar är att inte överskrida teckenlängden för ett namn, inte innehålla specialtecken och upprätthålla unika namn i en objektuppsättning.

Kommentar

Begränsningar för hur många objekt du kan definiera finns i Arbetsspårning, process- och projektgränser.

Allmänna överväganden

Längdbegränsningarna i den här artikeln mäts med antalet Tillåtna Unicode-tecken. Surrogattecken består av två Unicode-tecken, som räknas som två tecken mot längdbegränsningen. Mer information finns i Om Unicode- och teckenuppsättningar.

Precis som med andra operativsystemfiler tillåts inte heller ASCII-kontrolltecken (ASCII 1-31) och surrogatkombinationer. Allmän information om de operativsystembegränsningar som tillämpas på filnamn finns i Namngivning av filer, sökvägar och namnområden.

Systemreserverade namn

Undvik att använda systemreserverade namn, till exempel:

  • AUX
  • COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10
  • CON
  • DefaultCollection
  • LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9
  • NUL
  • PRN
  • SERVER, SignalR
  • Webb eller WEBB

Mer information om reserverade namn finns i Filnamn, sökvägar och namnområden.

Azure Artifacts

Universella paket måste följa följande begränsningar.

Begränsningstyp Begränsning
Paketnamn - Måste vara gemener.
- Måste börja och sluta med bokstäver eller siffror.
– Får endast innehålla bokstäver, siffror och icke-konsekutiva bindestreck, understreck eller punkter.
Paketversion Måste vara gemener utan byggmetadata.

Azure-tavlor

Du använder arbetsobjekt för att samla in information för att planera och spåra dina programutvecklingsprojekt. Med arbetsobjekt kan du beskriva det arbete som ska utföras, tilldela arbete, spåra status och samordna arbetet inom ditt team. Olika typer av arbetsobjekt – till exempel användarberättelser, uppgifter, buggar och problem – spårar olika typer av information. Mer information finns i Dokumentation om Azure Boards.

Alla spårningsobjekt för arbetsobjekt är associerade med ett eller flera namn. De flesta har egna visningsnamn, förutom arbetsobjektstyper och globala listor, som är associerade med referensnamn. Ett eget namn är en unik, användar synlig identifierare för ett fält. Med hjälp av egna namn säkerställs konsekvens mellan projekt och arbetsobjektstyper i en projektsamling. Systemet använder referensnamnet internt och du kan inte ändra det när det har definierats.

Det finns begränsningar för flera element som är associerade med arbetsobjekt, inklusive referensnamn och egna namn, fältnamn och storlek på bifogade filer.

Sökvägar för område och iteration

Två arbetsobjektfält, Områdessökväg och Iterationssökväg, tillhandahåller en trädstrukturhierarki för gruppering av arbete. Områdessökvägar grupperar arbetsobjekt efter produkt, funktion eller funktionsområde. Iterationssökvägar grupperar arbetsobjekt i sprintar, milstolpar eller tidsperioder för att hantera dessa arbetsobjekt.

Dessa fält med flera noder använder omvänt snedstreck \ för att ange hierarkin för noder i trädstrukturen.

De namn som du tilldelar underordnade noder till dessa fält måste följa följande begränsningar.

Begränsningstyp Begränsning
Nodlängd Får inte innehålla fler än 255 tecken.
Reserverade namn – Får inte bara bestå av en period . eller två perioder ...
- Får inte vara ett systemreserverad namn, till exempel PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON eller AUX. Mer information om reserverade namn finns i Filnamn, Sökvägar och Namnområden.
Specialtecken för noder – Får inte innehålla Unicode-kontrolltecken.
- Får inte innehålla något av följande tecken: \ / : * ? " < > | # $ * +.
– Får inte innehålla tecken som är förbjudna av det lokala filsystemet. Mer information om Windows-teckenbegränsningar finns i Namngivning av filer, sökvägar och namnområden.
Sökvägslängd Får inte innehålla fler än 4 000 Unicode-tecken.
Djup för sökvägshierarki Måste vara färre än 14 nivåer djupt.

Bifogade filer

Filer som är kopplade till arbetsobjekt måste följa följande begränsningar.

Begränsningstyp Begränsning
Filstorlek Får inte överskrida den maximala storleken:
– Maximal standardstorlek: 4 096 kilobyte.
- Absolut maximal storlek: 2 gigabyte.
Begränsningstyp Begränsning
Filstorlek Får inte överskrida den maximala storleken:
– Maximal standardstorlek: 4 096 kilobyte.
- Absolut maximal storlek: 2 gigabyte. Mer information finns i Ändra den maximala storleken på bifogade filer för arbetsobjekt.

Brädkolumn och simbananamn

Din Kanban-tavla omvandlar din kvarvarande information till en interaktiv skylt, vilket ger ett visuellt arbetsflöde. När arbetet går från idé till slutförande uppdaterar du objekten på tavlan. Varje kolumn representerar en arbetsfas och varje kort representerar en användarberättelse (blå kort) eller en bugg (röda kort) i det skedet av arbetet.

Anpassa dina Kanban-tavlor genom att lägga till, ta bort eller byta namn på kolumner och simbanor. Kolumner stöder arbetsflödet över hela linjen. Med simbanor kan du hantera olika arbetsklasser som vågräta körfält på tavlan.

Kolumn- och simbanenamn måste följa följande begränsningar.

Begränsningstyp Begränsning
Längd Får inte innehålla fler än 256 Unicode-tecken.
Unikhet – Kolumnnamn får inte vara samma som andra kolumnnamn på Kanban-tavlan.
- Simbananamn får inte vara samma som andra simbanenamn på Kanban-tavlan.
Specialtecken Får inte innehålla unicode-kontrolltecken eller surrogattecken.

Fält-namn:

Varje typ av arbetsobjekt innehåller ett eller flera arbetsobjektfält. De här fälten definierar den information som lagras för arbetsobjekt baserat på typen av arbetsobjekt. Varje arbetsobjektfält har ett associerat fältreferensnamn. Fältreferensnamnet identifierar varje fält unikt och kan inte ändras när det har tilldelats. Mer information om färdiga arbetsobjektfält finns i Index för arbetsobjektfält.

Fältnamn för arbetsobjekt måste överensstämma med följande begränsningar.

Begränsningstyp Begränsning
Längd Får inte innehålla fler än 128 Unicode-tecken.
Unikhet - Fältnamn måste innehålla minst ett alfabetiskt tecken.
- Får inte innehålla något av följande tecken: .,;':~\/\*|?"&%$!+=()[]{}<>-.
– Får inte innehålla inledande eller avslutande blanksteg.
– Får inte innehålla två eller flera blanksteg i följd.
Specialtecken Måste vara unikt i organisationen eller projektsamlingen. Fältnamn för arbetsobjekt är begränsade till projektsamlingen. Om du byter namn på ett fältnamn ändrar du det för alla arbetsobjekt och WIT:er som definierats i alla projekt i samlingen.

Fältreferensnamn och portabilitet

Definitionsspråket för arbetsobjekttyp innehåller begreppet fältreferensnamn. Fältreferensnamn kan hjälpa dig att portdefinitioner mellan Team Foundation-projektsamlingar och även tillåta integreringar från tredje part att hitta och referera till specifika fält. Dessa namn är globalt unika, precis som ett namnområde i .NET Framework-programmet är globalt unikt.

Systemnamnområdet används endast för att definiera alla kärnsystemfält som är obligatoriska för Team Foundation-systemfunktioner. Du kan inte skapa ett eget System.X-fält eftersom det kan hindra funktioner.

Microsofts namnområde används för att definiera spårningsfält för arbetsobjekt. Dessa fält definieras i en definition av arbetsobjekttyp för processmallarna.

Kunder och partner kan skapa egna fältnamnområden för anpassade typer av arbetsobjekt. Beskrivningar av systemfält och fält som definierats i standardprocessmallarna finns i Index för arbetsobjektfält.

Viktigt!

  • Det går inte att byta namn på fältreferensnamn. Om du till exempel har ändrat fältnamnet "Rubrik" till "Rubrik" förblir fältreferensnamnet för det fältet detsamma. Integreringar och interna representationer av fält bör använda fältreferensnamnet i stället för beroende på själva fältnamnet.
  • Även om du kan skapa ett eget Microsoft.X-fält rekommenderar vi inte att du gör det, eftersom det kan hindra funktioner eller möjligheten för guiden Konfigurera funktioner att uppdatera ett projekt efter en uppgradering.

Exempel på fältreferensnamn

I följande exempel visas giltiga fältreferensnamn i olika namnområden. Kunder och partner kan också definiera sina egna namnområden för att stödja sina anpassade typer av arbetsobjekt.

Systemnamnområdesexempel Exempel på Microsoft-namnområde Andra namnområdesexempel
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 Det fiktiva företaget Fabrikam Fiber kan definiera följande anpassade arbetsobjektfält:
FabrikamFiber.Common.Severity, FabrikamFiber.Common.Phase, FabrikamFiber.RiskManagement.RiskType, FabrikamFiber.RiskManagement.Resolution

Det fiktiva programvaruföretaget Contoso Corporation kan definiera följande arbetsobjektfält:
Contoso.Common.BusinessPriority, Contoso.Bug.FoundInPhase, Contoso.Bug.FixInPhase

Fälthjälptext

Systemet visar hjälptext vid körning för att hjälpa användarna att veta vad de ska ange i fältet. Hjälptexten är begränsad till en viss typ av arbetsobjekt i ett visst projekt.

För arvsprocessen anger du hjälptext för ett fält via dialogrutan Redigera fält , fliken Definition och Beskrivning. Se Lägga till ett anpassat fält i en arbetsobjektstyp. För den lokala XML-processen anger du hjälptext med hjälp av elementet HELPTEXT . Se Lägga till eller ändra ett fält för att spåra arbete.

Hjälptext som du lägger till måste följa följande begränsningar.

Begränsningstyp Begränsning
Längd Får inte innehålla fler än 255 Unicode-tecken.

Globala listor

En global lista är en uppsättning listobjektvärden som du kan använda globalt i alla projektsamlingar i en instans av en lokal Azure DevOps Server. När du definierar typer av arbetsobjekt kan det hända att vissa arbetsobjektfält delar samma uppsättning tillåtna eller föreslagna värden. Med globala listor kan du definiera dessa värden en gång och dela dem över flera typer av arbetsobjekt och projekt. Mer information finns i Definiera globala listor.

En global lista som definieras med elementet GLOBALLIST innehåller ett eller flera listobjekt som anges med elementet LISTITEM .

LISTITEM måste följa följande begränsningar.

Begränsningstyp Begränsning
Längd – Får inte innehålla fler än 254 Unicode-tecken.
- Får inte vara tom.
Specialtecken - Får inte innehålla inledande eller avslutande blanksteg.
- Får inte innehålla två blanksteg i följd.
– Får inte innehålla omvänt snedstreck \ .
Omfattning Eftersom globala listor är tillgängliga bland alla projekt får de inte innehålla element som definierats på projektnivå, till exempel projektspecifika gruppkontodefinitioner.

Globala listor måste följa följande begränsningar.

Begränsningstyp Begränsning
Antal artiklar Det går inte att vara tom. Den globala listan måste innehålla minst ett LISTITEM element.
Unikhet Det går inte att vara tom. Den globala listan måste innehålla minst ett LISTITEM element.

Definiera ett referensnamn när du lägger till eller skapar en länktyp eller kategori. Alla referensnamn kan vara upp till 70 Unicode-tecken långa.

Definiera ett referensnamn med hjälp av alfanumeriska tecken, understreckstecken och bindestreck. Varje referensnamn måste innehålla minst en punkt ., men ingen punkt kan visas i början eller slutet av ett namn. Ett referensnamn får inte börja med ett tal eller ett understreck, och det kan inte ha flera bindestreck i följd, till exempel --.

Begränsningstyp Begränsning
Längd Får inte innehålla fler än 70 Unicode-tecken.
Unikhet – Får inte vara identisk med något annat fältreferensnamn i projektsamlingen.
- Får inte vara identisk med något annat fältreferensnamn när dessa namn bearbetas av datorn för att ersätta alla perioder . med understreck _. Till exempel fältreferensnamnen My.*Field* och My.Field skulle båda bearbetas som samma namn: My__Field
Specialtecken – Får inte innehålla bindestreck -.
- Måste innehålla minst en punkt ..
– Får inte starta eller avsluta med en punkt ..
- Får inte börja med ett talMust inte börja med ett understreck _.

Taggar för arbetsobjekt

Arbetsobjekttaggar motsvarar en eller två nyckelordsfraser för att filtrera arbetsspårningsverktyg som kvarvarande uppgifter, tavlor och frågor eller definiera frågor. Mer information finns i Lägga till arbetsobjekttaggar för att kategorisera och filtrera listor och tavlor.

Taggnamn måste följa följande begränsningar.

Begränsningstyp Begränsning
Längd – Får inte innehålla fler än 400 Unicode-tecken.
– Får inte vara null eller tomt.
Specialtecken – Får inte innehålla avgränsartecken: , eller ;.
– Får inte innehålla Unicode-kontroll- eller formattecken, till exempel radmatning, styckeavgränsare, vagnretur eller andra surrogattecken som inte stämmer överens.
Omfattning Eftersom globala listor är tillgängliga bland alla projekt får de inte innehålla element som definierats på projektnivå, till exempel projektspecifika gruppkontodefinitioner.

Azure-pipelines

Azure Pipeline-definitioner måste följa följande begränsningar.

Begränsningstyp Begränsning
Jobbnamn – Får endast innehålla alfanumeriska tecken och '_'.
- Får inte börja med ett tal.
- Måste ha ett unikt namn.
– Får inte innehålla nyckelord, till exempel "distribution".
Namn på stadium – Får endast innehålla alfanumeriska tecken och '_'.
- Får inte börja med ett tal.
– Får inte innehålla nyckelord, till exempel "distribution".
Uttryck Måste börja med a-Z eller _AND, följt av a-Z, 0-9eller _.

Mer information finns i Dokumentation om Azure Pipelines.

Azure Repos (Git)

Varje Azure DevOps-projekt kan innehålla flera Git-lagringsplatser. Namnen som du tilldelar till Git-lagringsplatser måste överensstämma med följande begränsningar. Mer information finns i Git-dokumentationen för Azure Repos. Mer information om namngivningsbegränsningar för andra Git-objekt, till exempel grenar och taggar, finns i git check-ref-format.

Viktigt!

Även om du kan inkludera blanksteg i lagringsplatsnamn rekommenderar vi inte att du gör det.

Begränsningstyp Begränsning
Längd Får inte innehålla fler än 64 Unicode-tecken.
Unikhet Får inte vara identisk med något annat Git-lagringsplatsnamn i projektet.
Specialtecken – Får inte innehålla Unicode-kontrolltecken eller surrogattecken.
– Får inte innehålla följande utskrivbara tecken: \ / : * ? " < > | ; # $ * { } , + = [ ].
– Får inte börja med ett understreck _.
– Får inte starta eller avsluta med en punkt ..
– Får inte vara ett systemreserverad namn.

Azure Repos (TFVC)

Team Foundation-versionskontroll (TFVC) tillhandahåller en central lagringsplats för filer och de kommandon som krävs för att hantera dessa filer i ett team. Det ger också anpassningsbara incheckningsprinciper, förgrening, sammanslagning, hyllor och många andra funktioner. Mer information finns i dokumentationen om Azure Repos TFVC

Sökvägarna för versionskontroll måste följa följande begränsningar. Se även Optimera din arbetsyta.

Begränsningstyp Begränsning
Längd på mappsökväg för serverkällkontroll – Får inte innehålla fler än 259 Unicode-tecken för en enda mapp eller filnamn.
– Får inte innehålla fler än 388 Unicode-tecken för en katalog.
– Får inte innehålla fler än 399 Unicode-tecken för ett kombinerat katalog- och filnamn.
Sökvägslängd för lokal mapp – Får inte innehålla fler än 248 Unicode-tecken för en katalog.
– Får inte innehålla fler än 260 Unicode-tecken för en kombinerad katalog och ett filnamn.
Begränsningar för webbportal och REST-specifik längd Får inte innehålla fler än 215 Unicode-tecken för ett kombinerat projektnamn, katalog och filnamn.

I webbportalen och REST-API:et har vissa åtgärder en mer restriktiv sökvägslängd än Visual Studio och TF.exe klienter. Dessa åtgärder omfattar Redigera, Byt namn och Ta bort och inträffar eftersom webbportalen/REST använder en slumpmässigt genererad arbetsyta för samtidighet när ändringarna väntar.

TFVC-filer

Versionskontrollsystemet lagrar många olika typer av filer. Konfigurera versionskontroll för Team Foundation på utvecklingsdatorn innehåller information om hur du lägger till befintliga Visual Studio-projekt eller -lösningar.

Filer och mappar som du lägger till i Team Foundation-versionskontroll måste följa följande begränsningar.

Begränsningstyp Begränsning
Filer och mappar - Namnen får inte innehålla följande utskrivbara tecken: \ / : * ? " < > | ;.
– Mappar får inte ligga utanför den mappade katalogen för den aktiva arbetsytan.
Filnamn - Får inte börja med en $.
– Får inte innehålla följande utskrivbara tecken: \ / : * ? " < > | ;.

TFVC-etiketter

I Team Foundation-versionskontroll (TFVC) är en etikett ett namn som tillämpas på en specifik uppsättning revisioner. Du kan bifoga etiketter till en uppsättning orelaterade filer i versionskontrollen, vilket gör att du kan hämta filerna eller agera på dem som en grupp. I följande tabell beskrivs begränsningarna för etikettnamn.

Begränsningstyp Begränsning
Längd Får inte innehålla fler än 64 Unicode-tecken.
Specialtecken – Det går inte att avsluta med ett blanksteg ( ) eller en punkt ..
– Får inte innehålla följande utskrivbara tecken: \ / : * ? " < > | ; @.

TFVC-hyllor

Med hyllor kan du tillfälligt avsätta en batch med väntande ändringar och sedan, som ett alternativ, ta bort väntande ändringar från arbetsytan. Senare kan du återställa ändringarna i en hylloruppsättning till din arbetsyta eller placera dem i en annan användares arbetsyta.

Hylloruppsättningsnamn måste överensstämma med följande begränsningar.

Begränsningstyp Begränsning
Längd Får inte innehålla fler än 64 Unicode-tecken.
Specialtecken Får inte innehålla följande utskrivbara tecken: \ / : * ? " < > | ;.

TFVC-arbetsytor

En arbetsyta är en kopia på klientsidan av filerna och mapparna i Team Foundations versionskontroll (TFVC). När du skapar flera arbetsytor kan du ha olika versioner av samma versionskontrollmapp på en klientdator. Skapa och arbeta med arbetsytor innehåller mer information.

Namn på arbetsytor måste följa följande begränsningar.

Begränsningstyp Begränsning
Längd Får inte innehålla fler än 64 Unicode-tecken.
Specialtecken – Får inte sluta med ett blanksteg ( ).
– Får inte innehålla följande utskrivbara tecken: \ / : * ? " < > | ;.

Datornamn

Datornamnet där du installerar Azure DevOps är associerat med namnet på servern. Både operativsystemet och Active Directory har vissa begränsningar för datornamn enligt beskrivningen i följande artiklar:

Organisationsnamn

Viktigt!

Följ följande riktlinjer när du skapar ett organisationsnamn.

  • Använd endast bokstäver från det engelska alfabetet
  • Starta organisationens namn med en bokstav eller ett nummer
  • Använd bokstäver, siffror eller bindestreck efter det första tecknet
  • Se till att organisationen inte överskrider 50 Unicode-tecken
  • Avsluta med en bokstav eller ett nummer

Om du använder något av de otillåtna tecknen visas följande felmeddelande: VS850015: Det angivna namnet får inte användas: {Organisationsnamn}.

Process- och processmallar

En process definierar byggstenarna i arbetsobjektspårningssystemet och andra undersystem som du har åtkomst till när du har anslutit till ett projekt.

Kommentar

Terminologi: Både "process" och "processmall" refererar till en beroende uppsättning filer som används för att skapa ett projekt. Mer information finns i Om processer och processmallar, som beskriver skillnaderna mellan de tre standardprocesserna som är tillgängliga för dig.

Processer som du definierar eller anpassar måste följa följande begränsningar.

Begränsningstyp Begränsning
Längd Får inte innehålla fler än 256 Unicode-tecken.
Unikhet – Måste vara unikt i Azure DevOps.
– Om du laddar upp en mall med samma namn som en befintlig mall skrivs den befintliga mallen över.
Filstorlek för processmall Får inte överstiga 2 GB (gigabyte).

Projektsamlingar

En projektsamling identifierar en grupp projekt och de resurser som är associerade med dessa projekt. Den tillhandahåller en organisationsstruktur som du kan använda för att definiera och styra en grupp projekt som definierats för en Azure DevOps Server.

Samlingsnamnet är också en del av anslutningssträng som används för att ansluta gruppmedlemmar till projekt. Standardtilldelade motsvarar DefaultCollection. Hantera projektsamlingar innehåller mer information.

Namn som du tilldelar projektsamlingar måste följa följande begränsningar.

Begränsningstyp Begränsning
Längd Får inte innehålla fler än 64 Unicode-tecken.
Unikhet – Får inte vara identisk med något annat samlingsnamn i din lokala distribution.
– Om distributionen innehåller SharePoint-produkter eller SQL Server Reporting Services kan de inte vara identiska med namnet och den fullständiga sökvägen för en befintlig SharePoint-webbplats, rapportserver eller Reporting Services-webbplats.
Reserverade namn Får inte vara ett systemreserverad namn.
Specialtecken – Får inte innehålla Unicode-kontrolltecken eller surrogattecken.
– Får inte innehålla följande utskrivbara tecken: \ / : * ? " < > | ; # $ * { } , + = [ ].
- Får inte innehålla en ellips ... eller en dubbel punkt ...
– Får inte börja med ett understreck _.
– Får inte starta eller avsluta med en punkt ..

Projektnamn

Ett projekt upprättar en lagringsplats för källkod och en plats där team kan planera, spåra förlopp och samarbeta. Namnet på projektet är en del av anslutningssträng används för att ansluta gruppmedlemmar till projekt.

Namn som du tilldelar projekt som du skapar måste följa följande begränsningar.

Begränsningstyp Begränsning
Längd Får inte innehålla fler än 64 Unicode-tecken.
Unikhet Får inte vara identisk med något annat namn i projektsamlingen, SharePoint-webbprogrammet som stöder samlingen eller instansen av SQL Server Reporting Services som stöder samlingen.
Namn på reserver – Får inte vara ett systemreserverad namn.
– Får inte vara ett av de dolda segment som används för IIS-begärandefiltrering som App_Browsers, App_code, App_Data, App_GlobalResources, App_LocalResources, App_Themes, App_WebResources, bin eller web.config.
Specialtecken – Får inte innehålla Unicode-kontrolltecken eller surrogattecken.
– Får inte innehålla följande utskrivbara tecken: \ / : * ? " < > | ; # $ * { } , + = [ ].
– Får inte börja med ett understreck _.
– Får inte starta eller avsluta med en punkt ..

Säkerhetsgrupper

Med Azure DevOps-säkerhetsgrupper kan du använda vissa rättigheter eller behörigheter för en grupp användare.

Lokala grupper kan bestå av Active Directory-gruppkonton, Azure DevOps-säkerhetsgrupper, Windows-användarkonton, Windows-gruppkonton eller någon blandning av dessa typer. Mer information finns i Lägga till Active Directory/Microsoft Entra-användare eller -grupper i en inbyggd säkerhetsgrupp.

Säkerhetsgrupper måste följa följande begränsningar.

Begränsningstyp Begränsning
Namnlängd för säkerhetsgruppskonto Får inte innehålla fler än 256 Unicode-tecken.
Unikhet – Gruppkonton på projektnivå får inte matcha något annat gruppnamn i samma projekt.
– Gruppkonton på samlingsnivå får inte matcha något annat namn på ett gruppkonto i projektsamlingen.
Namn på reserverade grupper Får inte namnges med en $NAMESPACE på antingen projekt- eller servernivå.
Specialtecken – Får inte innehålla Unicode-kontrolltecken eller surrogattecken.
– Får inte innehålla följande utskrivbara tecken: / \ [ ] : | < > + = ; ? *.
– Får inte innehålla icke-utskrivbara tecken i ASCII-värdeintervallet 1–31.
– Får inte avslutas under en period ..
– Får inte innehålla kommatecken ,.

Team Foundation Build

Med Team Foundation Build kan du hantera alla aspekter av byggprocessen på en enda dator. Genom att använda Team Foundation Build kan du synkronisera källorna, kompilera programmet, köra associerade enhetstester, utföra kodanalys, versionsversioner på en filserver och publicera byggrapporter.

Skapa dator

Team Foundation Build är en separat installation från Azure DevOps Server-programnivån, datanivån eller Visual Studio-klienten. Du kan välja en separat dator. Annars kan du installera versionen sida vid sida på klientdatorn eller på servrarna.

Den lokala byggdatorn måste följa följande begränsningar.

Begränsningstyp Begränsning
Diskutrymme Måste innehålla tillräckligt med utrymme för bygget (otillräckligt utrymme leder till misslyckade versioner).
Skapa katalog Måste vara en lokal sökväg (till exempel C:\BuildDirectory).
Ta bort platskatalog Måste vara en UNC-sökväg (till exempel \server\share).
Ta bort platsbehörigheter Varje genererad version placeras i en ny katalog i mappen drop.
– Team Foundation Server Service-kontot (till exempel Domain\TFSSERVICE) måste ha fullständig behörighet till UNC-släppplatsen.
– UNC-släppplatsen måste vara en delad mapp.
Team Foundation Build Service-konto Om du ändrar TFS-tjänstkontot efter den första installationen måste du se till att följande villkor är uppfyllda:
– Kontot är medlem i gruppen Build Services.
– Kontot har läs- och skrivbehörighet till de temporära mapparna och den ASP.NET temporära mappen.
– Kontot har fullständig behörighet till byggkatalogen och släppplatsen.
Brandväggsproblem Om byggdatorn är brandväggsaktiverad kontrollerar du att programmet tfsbuildservice finns i undantagslistan.

Byggtyper

Byggtyper konfigurerar de villkor under vilka en enskild lösning eller en uppsättning lösningar i ett projekt skapas. Om du vill utföra en version måste du antingen skapa en ny byggtyp eller använda en befintlig byggtyp.

Namn på byggtyp måste följa följande begränsningar.

Begränsningstyp Begränsning
Unikhet Får inte vara samma som andra byggtypsnamn i projektet.
Specialtecken Får inte innehålla följande utskrivbara tecken: $.

Byggkvalitet

Med byggkvaliteten kan du koppla ett kvalitets- eller slutförandetillstånd till en färdig version. Med Team Foundation Build kan du också skapa nya värden för byggkvalitetstypen. Se Betygsätt kvaliteten på en färdig version för en lista över standardvärdena för byggkvalitet.

Byggkvalitetsnamn måste följa följande begränsningar.

Begränsningstyp Begränsning
Längd Får inte innehålla fler än 256 Unicode-tecken.
Unikhet Får inte vara samma som andra byggkvalitetsnamn på Team Foundation Build-datorn.

Gruppnamn

Teamnamn identifierar en grupp individer eller grupper som tillsammans arbetar tillsammans som ett team i ett projekt. Gruppmedlemmar använder det här namnet för att ansluta till teamet eller för att fråga mot medlemmar som definierats för ett team.

Gruppnamn måste överensstämma med konventioner som gör att de kan återges som en del av en giltig URL. Varje teamnamn måste vara unikt i ett enda projekt. Det finns dock inga begränsningar för att använda samma gruppnamn i olika projekt i en projektsamling. Mer information finns i Lägga till ett annat team eller en hierarki med team.

Gruppnamn måste följa följande begränsningar.

Begränsningstyp Begränsning
Längd Får inte innehålla fler än 64 Unicode-tecken.
Unikhet Får inte vara identisk med något annat namn i projektet.
Reserverade namn Får inte vara ett systemreserverad namn.
Specialtecken – Får inte innehålla Unicode-kontrolltecken eller surrogattecken.
– Får inte innehålla följande utskrivbara tecken: \ / : * ? " < > | ; # $ * { } , + = [ ].
- Får inte innehålla en ellips ... eller en dubbel punkt ...
– Får inte börja med ett understreck _.
– Får inte starta eller avsluta med en punkt ..

Användarnamn

Användarkonton identifierar personer som lagts till i ett projekt eller en projektsamling. Användarkonton kan motsvara poster i Active Directory, Microsoft Entra-ID, Windows-servergrupp.

Användarkonton som du lägger till i en organisation eller samling måste följa följande begränsningar. Information om hur du lägger till användarkonton i ett projekt finns i Lägga till användare i ett projekt eller team.

Begränsningstyp Begränsning
Längd på kontonamn Får inte innehålla fler än 256 Unicode-tecken.
Unikhet Får inte matcha något annat användarkonto som lagts till i projektsamlingen.
Namn på reserverade grupper Får inte namnges med en $NAMESPACE på antingen projekt- eller servernivå.
Specialtecken – Får inte innehålla följande utskrivbara tecken: "/ \ [ ] : | < > + = ; ? *.
– Får inte innehålla icke-utskrivbara tecken i ASCII-värdeintervallet 1–31.
- Får inte sluta i en period . eller ett dollartecken $.
– Får inte innehålla kommatecken ,.
– Får inte innehålla följande Unicode-kategorier: LineSeparator, ParagraphSeparator, Control, Format, OtherNotAssigned.

Wiki-sida och filnamn

Varje wiki-sida motsvarar en fil i Git-lagringsplatsen för wikin. Namn som du tilldelar en wiki-sidrubrik måste överensstämma med följande begränsningar.

Begränsningstyp Begränsning
Filnamn Den fullständigt kvalificerade sidsökvägen får vara högst 235 tecken lång.
Unikhet Sidrubriker är skiftlägeskänsliga och måste vara unika i wiki-hierarkin.
Specialtecken – Får inte innehålla Unicode-kontrolltecken eller surrogattecken.
– Får inte innehålla följande utskrivbara tecken: / \ #.
– Får inte starta eller avsluta med en punkt ..
Filstorlek Får inte överskrida maxgränsen på 18 MB.
Storlek på bifogad fil Får inte överskrida 19 MB.

Specialtecken i Wiki-sidrubriker

Du kan ange sidrubriker som innehåller ett eller flera av dessa specialtecken : < > * ? | -. Du kan till exempel ge en Markdown-fil namnet "Faq?" eller "Set-up guide". Tecknen har följande URI-kodade strängar:

Tecken Kodad sträng
: %3A
< %3C
> %3E
* %2A
? %3F
| %7C
- %2D
" 22 %