Ograniczenia i konwencje nazewnictwa

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Większość składników w usłudze Azure DevOps musi przestrzegać ograniczeń i konwencji nazewnictwa. Ograniczenia pomagają zagwarantować spójne środowisko użytkownika i zapewnić zgodność z innymi aplikacjami.

Typowe ograniczenia obejmują nie przekraczanie długości znaków dla nazwy, nie zawiera znaków specjalnych i zachowanie unikatowości nazw w zestawie obiektów.

Uwaga

Aby uzyskać informacje o limitach liczby elementów, które można zdefiniować, zobacz Śledzenie pracy, proces i limity projektów.

Zagadnienia ogólne

Ograniczenia długości w tym artykule są mierzone przez dozwoloną liczbę znaków Unicode. Znaki zastępcze składają się z dwóch znaków Unicode, które są liczone jako dwa znaki względem ograniczenia długości. Aby uzyskać więcej informacji, zobacz About Unicode and Character Sets (Informacje o standardach Unicode i zestawach znaków).

Podobnie jak w przypadku innych plików systemu operacyjnego, znaki sterujące ASCII (ASCII 1-31) i kombinacje zastępcze również nie są dozwolone. Aby uzyskać ogólne informacje na temat ograniczeń systemu operacyjnego stosowanych do nazw plików, zobacz Nazewnictwo plików, ścieżek i przestrzeni nazw.

Nazwy zarezerwowane systemu

Unikaj używania nazw zarezerwowanych systemu, takich jak następujące przykłady:

  • AUX
  • COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10
  • CON
  • Defaultcollection
  • LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9
  • NUL
  • PRN
  • SERWER, SignalR
  • Sieć Web lub sieć Web

Aby uzyskać więcej informacji na temat nazw zarezerwowanych, zobacz Nazwy plików, ścieżki i przestrzenie nazw.

Azure Artifacts

Pakiety uniwersalne muszą być zgodne z następującymi ograniczeniami.

Typ ograniczenia Ograniczenie
Nazwa pakietu - Musi być małymi literami.
- Musi zaczynać się i kończyć literami lub cyframi.
- Musi zawierać tylko litery, cyfry i niebezpieczone kreski, podkreślenie lub kropki.
Wersja pakietu Musi być małymi literami bez metadanych kompilacji.

Azure Boards

Elementy robocze służą do przechwytywania informacji w celu planowania i śledzenia projektów tworzenia oprogramowania. Dzięki elementom roboczym możesz opisać pracę, którą należy wykonać, przypisać pracę, śledzić stan i koordynować wysiłki w zespole. Różne typy elementów roboczych— takie jak scenariusze użytkownika, zadania, błędy i problemy — śledzą różne typy informacji. Aby uzyskać więcej informacji, zobacz dokumentację usługi Azure Boards.

Wszystkie obiekty śledzenia elementów roboczych są skojarzone z co najmniej jedną nazwą. Większość z nich ma przyjazne nazwy wyświetlane, z wyjątkiem typów elementów roboczych i list globalnych, które są skojarzone z nazwami odwołań. Przyjazna nazwa to unikatowy, widoczny dla użytkownika identyfikator pola. Używanie przyjaznych nazw zapewnia spójność między projektami i typami elementów roboczych w kolekcji projektów. System używa nazwy referencyjnej wewnętrznie i nie można jej zmienić po zdefiniowaniu.

Istnieją ograniczenia dotyczące kilku elementów skojarzonych z elementami roboczymi, w tym odwołania i przyjaznych nazw, nazw pól i rozmiaru załącznika.

Ścieżki obszaru i iteracji

Dwa pola elementów roboczych, Ścieżka obszaru i Ścieżka iteracji, zapewniają hierarchię struktury drzewa dla pracy grupowania. Ścieżki obszaru grupuj elementy robocze według produktu, funkcjonalności lub obszaru funkcji. Ścieżki iteracji grupują elementy robocze w przebiegi, punkty kontrolne lub okresy na potrzeby adresowania tych elementów roboczych.

Te pola z wieloma węzłami używają znaków ukośnika \ odwrotnego, aby oznaczyć hierarchię węzłów w strukturze drzewa.

Nazwy przypisywane do węzłów podrzędnych do tych pól muszą być zgodne z następującymi ograniczeniami.

Typ ograniczenia Ograniczenie
Długość węzła Nie może zawierać więcej niż 255 znaków.
Nazwy zarezerwowane - Nie może składać się tylko z kropki . lub dwóch okresów ...
- Nie może być nazwą zarezerwowaną systemu, taką jak PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON lub AUX. Aby uzyskać więcej informacji na temat nazw zarezerwowanych, zobacz Nazwy plików, Ścieżki i Przestrzenie nazw.
Znaki specjalne dla węzłów - Nie może zawierać znaków sterujących Unicode.
- Nie może zawierać żadnego z następujących znaków: \ / : * ? " < > | # $ * +.
- Nie może zawierać znaków zabronionych przez lokalny system plików. Aby uzyskać więcej informacji na temat ograniczeń znaków systemu Windows, zobacz Nazewnictwo plików, ścieżek i przestrzeni nazw.
Długość ścieżki Nie może zawierać więcej niż 4000 znaków Unicode.
Głębokość hierarchii ścieżki Musi być mniej niż 14 poziomów głębokości.

Załączniki

Pliki dołączone do elementów roboczych muszą być zgodne z następującymi ograniczeniami.

Typ ograniczenia Ograniczenie
Rozmiar pliku Nie może przekraczać maksymalnego rozmiaru:
- Domyślny maksymalny rozmiar: 4096 kilobajtów.
- Maksymalny rozmiar bezwzględny: 2 gigabajty.
Typ ograniczenia Ograniczenie
Rozmiar pliku Nie może przekraczać maksymalnego rozmiaru:
- Domyślny maksymalny rozmiar: 4096 kilobajtów.
- Maksymalny rozmiar bezwzględny: 2 gigabajty. Aby uzyskać więcej informacji, zobacz Zmienianie maksymalnego rozmiaru załącznika dla elementów roboczych.

Nazwy kolumn tablicy i pasa kąpielowego

Tablica Kanban zamienia listę prac w interaktywny tablicę logowania, zapewniając wizualny przepływ pracy. W miarę postępu pracy od pomysłu do ukończenia zaktualizujesz elementy na tablicy. Każda kolumna reprezentuje etap pracy, a każda karta reprezentuje historię użytkownika (niebieskie karty) lub usterkę (czerwone karty) na tym etapie pracy.

Dostosuj tablice Kanban, dodając, usuwając lub zmieniając nazwy kolumn i pasków kąpielowych. Kolumny obsługują przepływ pracy na całej tablicy. Pływaki umożliwiają zarządzanie różnymi klasami pracy jako poziome pasy ruchu na pokładzie.

Nazwy kolumn i pasów kąpielowych muszą być zgodne z następującymi ograniczeniami.

Typ ograniczenia Ograniczenie
Długość Nie może zawierać więcej niż 256 znaków Unicode.
Unikatowość — Nazwy kolumn nie mogą być takie same jak żadna inna nazwa kolumny na tablicy Kanban.
- Nazwy pływaków nie mogą być takie same jak każda inna nazwa pływaka na tablicy Kanban.
Znaki specjalne Nie może zawierać żadnych znaków sterujących Unicode ani znaków zastępczych.

Nazwy pól

Każdy typ elementu roboczego zawiera co najmniej jedno pole elementu roboczego. Te pola definiują informacje przechowywane dla elementów roboczych na podstawie typu elementu roboczego. Każde pole elementu roboczego ma skojarzona nazwa odwołania do pola. Nazwa odwołania do pola jednoznacznie identyfikuje każde pole i nie można jej zmienić po przypisaniu. Aby uzyskać więcej informacji na temat wbudowanych pól elementów roboczych, zobacz Indeks pól elementu roboczego.

Nazwy pól elementu roboczego muszą być zgodne z następującymi ograniczeniami.

Typ ograniczenia Ograniczenie
Długość Nie może zawierać więcej niż 128 znaków Unicode.
Unikatowość - Nazwy pól muszą zawierać co najmniej jeden znak alfabetyczny.
- Nie może zawierać żadnego z następujących znaków: .,;':~\/\*|?"&%$!+=()[]{}<>-.
- Nie może zawierać spacji wiodących ani końcowych.
- Nie może zawierać co najmniej dwóch kolejnych spacji.
Znaki specjalne Musi być unikatowa w organizacji lub kolekcji projektów. Nazwy pól elementu roboczego są ograniczone do kolekcji projektów. Jeśli zmienisz nazwę pola, zmienisz ją dla wszystkich elementów roboczych i sieci WITs zdefiniowanych we wszystkich projektach w kolekcji.

Nazwy odwołań do pól i przenośność

Język definicji typu elementu roboczego zawiera pojęcie nazwy odwołania do pola. Nazwy odwołań do pól mogą ułatwić znajdowanie i odwoływanie się do określonych pól między kolekcjami projektów Team Foundation, a także umożliwianie integracji innych firm. Te nazwy są globalnie unikatowe, tak jak przestrzeń nazw w aplikacji .NET Framework jest globalnie unikatowa.

Przestrzeń nazw systemu służy tylko do definiowania wszystkich podstawowych pól systemowych, które są obowiązkowe dla funkcji systemu Team Foundation. Nie można utworzyć własnego pola System.X, ponieważ może to utrudniać funkcjonalność.

Przestrzeń nazw firmy Microsoft służy do definiowania pól śledzenia elementów roboczych. Te pola są definiowane w definicji typu elementu roboczego szablonów procesów.

Klienci i partnerzy mogą tworzyć własne przestrzenie nazw pól dla niestandardowych typów elementów roboczych. Opisy pól systemowych i pól zdefiniowanych w domyślnych szablonach procesów można znaleźć w temacie Indeks pól elementów roboczych.

Ważne

  • Nie można zmienić nazwy odwołań do pól. Jeśli na przykład zmieniono nazwę pola "Tytuł" na "Nagłówek", nazwa odwołania do pola tego pola pozostaje taka sama. Integracje i wewnętrzne reprezentacje pól powinny używać nazwy odwołania do pola zamiast w zależności od samej nazwy pola.
  • Chociaż można utworzyć własne pole Microsoft.X, nie zalecamy, aby to zrobić, ponieważ może to utrudnić funkcjonalność lub możliwość pomyślnego zaktualizowania projektu po uaktualnieniu przez kreatora Konfigurowanie funkcji.

Przykłady nazw odwołań do pól

W poniższych przykładach przedstawiono prawidłowe nazwy odwołań do pól w różnych przestrzeniach nazw. Klienci i partnerzy mogą również definiować własne przestrzenie nazw, aby obsługiwać niestandardowe typy elementów roboczych.

Przykłady przestrzeni nazw systemu Przykłady przestrzeni nazw firmy Microsoft Inne przykłady przestrzeni nazw
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 Fikcyjna firma Fabrikam Fiber może definiować następujące niestandardowe pola elementów roboczych:
FabrikamFiber.Common.Severity, FabrikamFiber.Common.Phase, FabrikamFiber.RiskManagement.RiskType, FabrikamFiber.RiskManagement.Resolution

Fikcyjna firma zajmująca się oprogramowaniem Contoso Corporation może definiować następujące pola elementów roboczych:
Contoso.Common.BusinessPriority, Contoso.Bug.FoundInPhase, Contoso.Bug.FixInPhase

Tekst pomocy dotyczącej pola

System wyświetla tekst pomocy w czasie wykonywania, aby ułatwić użytkownikom poznanie, co należy wprowadzić w polu. Tekst pomocy jest zakresem określonego typu elementu roboczego w określonym projekcie.

W przypadku procesu dziedziczenia należy określić tekst pomocy dla pola w oknie dialogowym Edytowanie pola , karcie Definicja , Opis. Zobacz Dodawanie pola niestandardowego do typu elementu roboczego. W przypadku lokalnego procesu XML należy określić tekst pomocy przy użyciu HELPTEXT elementu . Zobacz Dodawanie lub modyfikowanie pola w celu śledzenia pracy.

Dodany tekst pomocy musi być zgodny z następującymi ograniczeniami.

Typ ograniczenia Ograniczenie
Długość Nie może zawierać więcej niż 255 znaków Unicode.

Listy globalne

Lista globalna to zestaw wartości elementów listy, których można używać globalnie we wszystkich kolekcjach projektów w ramach wystąpienia lokalnego serwera Usługi Azure DevOps. Podczas definiowania typów elementów roboczych niektóre pola elementów roboczych mogą współdzielić ten sam zestaw dozwolonych lub sugerowanych wartości. Listy globalne umożliwiają jednorazowe definiowanie tych wartości i udostępnianie ich w wielu typach elementów roboczych i projektach. Aby uzyskać szczegółowe informacje, zobacz Definiowanie list globalnych.

Lista globalna zdefiniowana przy użyciu GLOBALLIST elementu zawiera co najmniej jeden element listy określony przy użyciu LISTITEM elementu .

LISTITEM nazwy muszą być zgodne z następującymi ograniczeniami.

Typ ograniczenia Ograniczenie
Długość - Nie może zawierać więcej niż 254 znaków Unicode.
- Nie może być pusty.
Znaki specjalne - Nie może zawierać wiodących ani końcowych białych znaków.
- Nie może zawierać dwóch kolejnych spacji.
- Nie może zawierać znaków ukośnika \ odwrotnego.
Scope Ponieważ listy globalne są dostępne we wszystkich projektach, nie mogą zawierać elementów zdefiniowanych na poziomie projektu, takich jak definicje konta grupy specyficzne dla projektu.

Listy globalne muszą być zgodne z następującymi ograniczeniami.

Typ ograniczenia Ograniczenie
Liczba towarów Nie można być pustym. Lista globalna musi zawierać co najmniej jeden LISTITEM element.
Unikatowość Nie można być pustym. Lista globalna musi zawierać co najmniej jeden LISTITEM element.

Zdefiniuj nazwę odwołania za każdym razem, gdy dodasz lub utworzysz typ łącza lub kategorię. Wszystkie nazwy odwołań mogą zawierać maksymalnie 70 znaków Unicode.

Zdefiniuj nazwę odwołania przy użyciu znaków alfanumerycznych, znaków podkreślenia i znaków łącznika. Każda nazwa odwołania musi zawierać co najmniej jeden kropka, ale żaden kropka .nie może być wyświetlana na początku lub na końcu nazwy. Nazwa odwołania nie może zaczynać się od liczby lub podkreślenia i nie może mieć wielu kolejnych łączników, takich jak --.

Typ ograniczenia Ograniczenie
Długość Nie może zawierać więcej niż 70 znaków Unicode.
Unikatowość — Nie może być taka sama jak żadna inna nazwa odwołania do pola w kolekcji projektu.
- Nie może być taka sama jak żadna inna nazwa odwołania do pola po przetworzeniu tych nazw przez komputer, aby zastąpić wszystkie kropki . podkreśleniami _. Na przykład nazwy My.*Field* odwołań do pól i My.Field będą przetwarzane jako ta sama nazwa: My__Field
Znaki specjalne - Nie może zawierać łączników -.
- Musi zawierać co najmniej jeden okres ..
- Nie może rozpoczynać się lub kończyć kropką ..
- Nie może zaczynać się od liczbyMust nie zaczynać się od podkreślenia _.

Tagi elementów roboczych

Tagi elementów roboczych odpowiadają co najmniej jednej frazie kluczowej do filtrowania narzędzi do śledzenia pracy, takich jak listy prac, tablice i zapytania lub definiowanie zapytań. Aby uzyskać więcej informacji, zobacz Dodawanie tagów elementów roboczych w celu kategoryzowania i filtrowania list i tablic.

Nazwy tagów muszą być zgodne z następującymi ograniczeniami.

Typ ograniczenia Ograniczenie
Długość - Nie może zawierać więcej niż 400 znaków Unicode.
- Nie może być pusty ani mieć wartości null.
Znaki specjalne - Nie może zawierać znaków separatora: , lub ;.
- Nie może zawierać kontrolek Unicode ani znaków formatu, takich jak źródło wiersza, separator akapitu, powrót karetki lub inne niezgodne znaki zastępcze.
Scope Ponieważ listy globalne są dostępne we wszystkich projektach, nie mogą zawierać elementów zdefiniowanych na poziomie projektu, takich jak definicje konta grupy specyficzne dla projektu.

Azure Pipelines

Definicje usługi Azure Pipeline muszą być zgodne z następującymi ograniczeniami.

Typ ograniczenia Ograniczenie
Nazwa zadania - Musi zawierać tylko znaki alfanumeryczne i '_'.
- Nie może zaczynać się od liczby.
- Musi mieć unikatową nazwę.
- Nie może zawierać słów kluczowych, na przykład: "wdrożenie".
Nazwa etapu - Musi zawierać tylko znaki alfanumeryczne i '_'.
- Nie może zaczynać się od liczby.
- Nie może zawierać słów kluczowych, na przykład: "wdrożenie".
Wyrażenia Musi zaczynać się od a-Z lub _AND, a następnie a-Z, lub ._0-9

Aby uzyskać więcej informacji, zobacz dokumentację usługi Azure Pipelines.

Azure Repos (Git)

Każdy projekt usługi Azure DevOps może zawierać wiele repozytoriów Git. Nazwy przypisywane do repozytoriów Git muszą być zgodne z następującymi ograniczeniami. Aby dowiedzieć się więcej, zobacz dokumentację usługi Azure Repos Git. Aby uzyskać więcej informacji na temat ograniczeń nazewnictwa dla innych elementów usługi Git, takich jak gałęzie i tagi, zobacz git check-ref-format.

Ważne

Chociaż można uwzględnić spacje w nazwach repozytorium, nie zalecamy tego.

Typ ograniczenia Ograniczenie
Długość Nie może zawierać więcej niż 64 znaków Unicode.
Unikatowość Nie może być identyczna z inną nazwą repozytorium Git w projekcie.
Znaki specjalne — Nie mogą zawierać żadnych znaków zastępczych ani znaków kontrolnych Unicode.
- Nie może zawierać następujących znaków drukowalnych: \ / : * ? " < > | ; # $ * { } , + = [ ].
- Nie może zaczynać się od podkreślenia _.
- Nie może rozpoczynać się lub kończyć kropką ..
- Nie może być nazwą zarezerwowaną systemu.

Azure Repos (TFVC)

Kontrola wersji programu Team Foundation (TFVC) udostępnia centralne repozytorium plików i poleceń wymaganych do zarządzania tymi plikami w zespole. Zapewnia również możliwość dostosowywania zasad ewidencjonowania, rozgałęziania, scalania, regałów i wielu innych funkcji. Aby dowiedzieć się więcej, zobacz dokumentację serwera TFVC usługi Azure Repos

Ścieżki kontroli wersji muszą być zgodne z następującymi ograniczeniami. Zobacz również Optymalizowanie obszaru roboczego.

Typ ograniczenia Ograniczenie
Długość ścieżki folderu kontroli źródła serwera — Nie może zawierać więcej niż 259 znaków Unicode dla pojedynczego folderu lub nazwy pliku.
- Nie może zawierać więcej niż 388 znaków Unicode dla katalogu.
- Nie może zawierać więcej niż 399 znaków Unicode dla połączonego katalogu i nazwy pliku.
Długość ścieżki folderu lokalnego — Nie może zawierać więcej niż 248 znaków Unicode dla katalogu.
- Nie może zawierać więcej niż 260 znaków Unicode dla połączonego katalogu i nazwy pliku.
Ograniczenia dotyczące długości specyficzne dla portalu internetowego i rest Nie może zawierać więcej niż 215 znaków Unicode dla połączonej nazwy projektu, katalogu i nazwy pliku.

W portalu internetowym i interfejsie API REST niektóre operacje mają bardziej restrykcyjną długość ścieżki niż program Visual Studio i TF.exe klientów. Te operacje obejmują edytowanie, zmienianie nazwy i usuwanie oraz występują, ponieważ portal internetowy/REST używa losowo wygenerowanego obszaru roboczego do współbieżności podczas oczekiwania na zmiany.

Pliki TFVC

System kontroli wersji przechowuje wiele różnych typów plików. Konfigurowanie kontroli wersji programu Team Foundation na maszynie deweloperów zawiera szczegółowe informacje na temat dodawania istniejących projektów lub rozwiązań programu Visual Studio.

Pliki i foldery dodawane do kontroli wersji programu Team Foundation muszą być zgodne z następującymi ograniczeniami.

Typ ograniczenia Ograniczenie
Pliki i foldery - Nazwy nie mogą zawierać następujących znaków drukowalnych: \ / : * ? " < > | ;.
— Foldery nie mogą znajdować się poza zamapowanym katalogem dla aktywnego obszaru roboczego.
Nazwy plików - Nie może zaczynać się od .$
- Nie może zawierać następujących znaków drukowalnych: \ / : * ? " < > | ;.

Etykiety kontroli wersji serwera Team Foundation

W kontroli wersji programu Team Foundation (TFVC) etykieta jest nazwą stosowana do określonego zestawu poprawek. Etykiety można dołączyć do zestawu niepowiązanych plików w kontroli wersji, co umożliwia pobranie plików lub działanie na nich jako grupy. W poniższej tabeli opisano ograniczenia dotyczące nazw etykiet.

Typ ograniczenia Ograniczenie
Długość Nie może zawierać więcej niż 64 znaków Unicode.
Znaki specjalne — Nie można zakończyć spacją ( ) ani kropką ..
- Nie może zawierać następujących znaków drukowalnych: \ / : * ? " < > | ; @.

Zestawy półek TFVC

Zestawy półek umożliwiają tymczasowe odkładanie partii oczekujących zmian, a następnie, jako opcji, usunięcie oczekujących zmian z obszaru roboczego. Później możesz przywrócić zmiany w zestawie na półce do obszaru roboczego lub umieścić je w obszarze roboczym innego użytkownika.

Nazwy zestawów na półce muszą być zgodne z następującymi ograniczeniami.

Typ ograniczenia Ograniczenie
Długość Nie może zawierać więcej niż 64 znaków Unicode.
Znaki specjalne Nie może zawierać następujących znaków drukowalnych: \ / : * ? " < > | ;.

Obszary robocze kontroli wersji serwera Team Foundation

Obszar roboczy to kopia po stronie klienta plików i folderów w kontroli wersji programu Team Foundation (TFVC). Podczas tworzenia wielu obszarów roboczych można mieć różne wersje tego samego folderu kontroli wersji na komputerze klienckim. Tworzenie obszarów roboczych i praca z obszarami roboczymi zawiera więcej szczegółów.

Nazwy obszarów roboczych muszą być zgodne z następującymi ograniczeniami.

Typ ograniczenia Ograniczenie
Długość Nie może zawierać więcej niż 64 znaków Unicode.
Znaki specjalne - Nie może kończyć się spacją ( ).
- Nie może zawierać następujących znaków drukowalnych: \ / : * ? " < > | ;.

Nazwy komputerów

Nazwa komputera, na którym jest instalowana usługa Azure DevOps, jest skojarzona z nazwą serwera. System operacyjny i usługa Active Directory nakładają pewne ograniczenia na nazwy komputerów zgodnie z opisem w następujących artykułach:

Nazwy organizacji

Ważne

Postępuj zgodnie z poniższymi wytycznymi podczas tworzenia nazwy organizacji.

  • Używaj tylko liter z alfabetu angielskiego
  • Rozpoczynanie nazwy organizacji literą lub cyfrą
  • Użyj liter, cyfr lub łączników po początkowym znaku
  • Upewnij się, że organizacja nie przekracza 50 znaków Unicode
  • Koniec literą lub cyfrą

Jeśli używasz dowolnego niedozwolonego znaku, zostanie wyświetlony następujący komunikat o błędzie: VS850015: Określona nazwa nie może być używana: {Nazwa organizacji}.

Szablony procesów i procesów

Proces definiuje bloki konstrukcyjne systemu śledzenia elementów roboczych i innych podsystemów, do których masz dostęp po nawiązaniu połączenia z projektem.

Uwaga

Terminologia: Zarówno "proces" jak i "szablon procesu" odnoszą się do współzależnego zestawu plików używanych do tworzenia projektu. Aby uzyskać więcej informacji, zobacz About processes and process templates (Informacje o procesach i szablonach procesów), w którym opisano różnice między trzema dostępnymi procesami domyślnymi.

Procesy definiowane lub dostosowywane muszą być zgodne z następującymi ograniczeniami.

Typ ograniczenia Ograniczenie
Długość Nie może zawierać więcej niż 256 znaków Unicode.
Unikatowość — Musi być unikatowa w usłudze Azure DevOps.
— Jeśli przekażesz szablon o takiej samej nazwie jak istniejący szablon, istniejący szablon zostanie zastąpiony.
Rozmiar pliku szablonu procesu Nie może przekraczać 2 GB (gigabajtów).

Kolekcje projektów

Kolekcja projektów identyfikuje grupę projektów i zasoby skojarzone z tymi projektami. Udostępnia on strukturę organizacyjną, której można użyć do definiowania i kontrolowania grupy projektów zdefiniowanych dla serwera Usługi Azure DevOps.

Ponadto nazwa kolekcji jest częścią parametry połączenia używanej do łączenia członków zespołu z projektami. Przypisana wartość domyślna odpowiada domyślnej kolekcji DefaultCollection. Aby uzyskać więcej informacji, zobacz Zarządzanie kolekcjami projektów.

Nazwy przypisywane do kolekcji projektów muszą być zgodne z następującymi ograniczeniami.

Typ ograniczenia Ograniczenie
Długość Nie może zawierać więcej niż 64 znaków Unicode.
Unikatowość — Nie może być identyczna z inną nazwą kolekcji we wdrożeniu lokalnym.
— Jeśli wdrożenie obejmuje produkty programu SharePoint lub usługi SQL Server Reporting Services, nie mogą być identyczne z nazwą i pełną ścieżką istniejącej witryny programu SharePoint, serwera raportów lub witryny sieci Web usług Reporting Services.
Nazwy zarezerwowane Nie może być nazwą zarezerwowaną systemu.
Znaki specjalne — Nie mogą zawierać żadnych znaków zastępczych ani znaków kontrolnych Unicode.
- Nie może zawierać następujących znaków drukowalnych: \ / : * ? " < > | ; # $ * { } , + = [ ].
- Nie może zawierać wielokropka ... ani podwójnego kropki ...
- Nie może zaczynać się od podkreślenia _.
- Nie może rozpoczynać się lub kończyć kropką ..

Nazwy projektów

Projekt ustanawia repozytorium kodu źródłowego i miejsce, w których zespoły będą planować, śledzić postęp i współpracować. Nazwa projektu jest częścią parametry połączenia używanej do łączenia członków zespołu z projektami.

Nazwy przypisywane do tworzonych projektów muszą być zgodne z następującymi ograniczeniami.

Typ ograniczenia Ograniczenie
Długość Nie może zawierać więcej niż 64 znaków Unicode.
Unikatowość Nie może być taka sama jak żadna inna nazwa w kolekcji projektu, aplikacja sieci Web programu SharePoint obsługująca kolekcję lub wystąpienie usług SQL Server Reporting Services, które obsługują kolekcję.
Nazwy rezerw - Nie może być nazwą zarezerwowaną systemu.
— Nie może być jednym z ukrytych segmentów używanych do filtrowania żądań usług IIS, takich jak App_Browsers, App_code, App_Data, App_GlobalResources, App_LocalResources, App_Themes, App_WebResources, bin lub web.config.
Znaki specjalne — Nie mogą zawierać żadnych znaków zastępczych ani znaków kontrolnych Unicode.
- Nie może zawierać następujących znaków drukowalnych: \ / : * ? " < > | ; # $ * { } , + = [ ].
- Nie może zaczynać się od podkreślenia _.
- Nie może rozpoczynać się lub kończyć kropką ..

Grupy zabezpieczeń

Za pomocą grup zabezpieczeń usługi Azure DevOps można zastosować pewne prawa lub uprawnienia do grupy użytkowników.

Grupy lokalne mogą składać się z kont grup usługi Active Directory, grup zabezpieczeń usługi Azure DevOps, kont użytkowników systemu Windows, kont grup systemu Windows lub dowolnej kombinacji tych typów. Aby uzyskać więcej informacji, zobacz Dodawanie użytkowników lub grup usługi Active Directory/Microsoft Entra do wbudowanej grupy zabezpieczeń.

Grupy zabezpieczeń muszą być zgodne z następującymi ograniczeniami.

Typ ograniczenia Ograniczenie
Długość nazwy konta grupy zabezpieczeń Nie może zawierać więcej niż 256 znaków Unicode.
Unikatowość — Konta grup na poziomie projektu nie mogą być zgodne z żadną inną nazwą grupy w tym samym projekcie.
— Konta grup na poziomie kolekcji nie mogą być zgodne z żadną inną nazwą konta grupy w kolekcji projektów.
Nazwy grup zarezerwowanych Nie może mieć nazwy z $NAMESPACE na poziomie projektu lub serwera.
Znaki specjalne — Nie mogą zawierać żadnych znaków zastępczych ani znaków kontrolnych Unicode.
- Nie może zawierać następujących znaków drukowalnych: / \ [ ] : | < > + = ; ? *.
- Nie może zawierać znaków niedrukowalnych w zakresie wartości ASCII 1–31.
- Nie może kończyć się kropką ..
- Nie może zawierać przecinków ,.

Team Foundation Build

Team Foundation Build umożliwia zarządzanie wszystkimi aspektami procesu kompilacji na jednym komputerze. Za pomocą kompilacji team foundation można synchronizować źródła, kompilować aplikację, uruchamiać skojarzone testy jednostkowe, przeprowadzać analizę kodu, kompilować kompilacje na serwerze plików i publikować raporty kompilacji.

Komputer kompilacji

Team Foundation Build to oddzielna instalacja od warstwy aplikacji, warstwy danych lub klienta programu Visual Studio serwera Azure DevOps Server. Możesz wybrać oddzielny komputer. W przeciwnym razie można zainstalować kompilację obok siebie na komputerze klienckim lub na serwerach.

Lokalny komputer kompilacji musi być zgodny z następującymi ograniczeniami.

Typ ograniczenia Ograniczenie
Miejsce na dysku Musi zawierać wystarczającą ilość miejsca dla kompilacji (niewystarczająca ilość miejsca prowadzi do niepowodzenia kompilacji).
Katalog kompilacji Musi być ścieżką lokalną (na przykład C:\BuildDirectory).
Usuwanie katalogu lokalizacji Musi być ścieżką UNC (na przykład \server\share).
Usuwanie uprawnień do lokalizacji Każda wygenerowana kompilacja jest umieszczana w nowym katalogu w folderze upuszczania.
— Konto usługi serwera Team Foundation Server (na przykład Domain\TFSSERVICE) musi mieć uprawnienia Pełna kontrola dostępu do lokalizacji upuszczania UNC.
— Lokalizacja upuszczania UNC musi być folderem udostępnionym.
Konto usługi Team Foundation Build Service Jeśli po początkowej instalacji zmienisz konto usługi TFS, upewnij się, że spełnione są następujące warunki:
— Konto jest członkiem grupy Usług kompilacji.
— Konto ma uprawnienia do odczytu/zapisu do folderów tymczasowych i folderu tymczasowego ASP.NET.
— Konto ma uprawnienia Pełna kontrola do katalogu kompilacji i lokalizacji upuszczania.
Problemy z zaporą Jeśli komputer kompilacji jest włączony, upewnij się, że program, tfsbuildservice, znajduje się na liście wyjątków.

Typy kompilacji

Typy kompilacji konfigurują warunki, w których tworzone jest pojedyncze rozwiązanie lub zestaw rozwiązań w projekcie. Aby przeprowadzić kompilację, musisz utworzyć nowy typ kompilacji lub użyć istniejącego typu kompilacji.

Nazwy typów kompilacji muszą być zgodne z następującymi ograniczeniami.

Typ ograniczenia Ograniczenie
Unikatowość Nie może być taka sama jak jakakolwiek inna nazwa typu kompilacji w projekcie.
Znaki specjalne Nie może zawierać następującego znaku drukowalnego: $.

Jakość kompilacji

Jakość kompilacji umożliwia dołączenie poziomu jakości lub stanu ukończenia do ukończonej kompilacji. Team Foundation Build umożliwia również tworzenie nowych wartości dla typu jakości kompilacji. Zobacz Oceń jakość ukończonej kompilacji , aby uzyskać listę domyślnych wartości jakości kompilacji.

Nazwy jakości kompilacji muszą być zgodne z następującymi ograniczeniami.

Typ ograniczenia Ograniczenie
Długość Nie może zawierać więcej niż 256 znaków Unicode.
Unikatowość Nie może być taka sama jak jakakolwiek inna nazwa jakości kompilacji na komputerze kompilacji Team Foundation Build.

Nazwy zespołów

Nazwy zespołów identyfikują grupę osób lub grup, które wspólnie współpracują ze sobą jako zespół w projekcie. Członkowie zespołu używają tej nazwy do nawiązywania połączenia z zespołem lub wykonywania zapytań względem członków zdefiniowanych dla zespołu.

Nazwy zespołów muszą być zgodne z konwencjami, które umożliwiają ich renderowanie w ramach prawidłowego adresu URL. Każda nazwa zespołu musi być unikatowa w ramach jednego projektu. Nie ma jednak żadnych ograniczeń dotyczących używania tej samej nazwy zespołu w różnych projektach w kolekcji projektów. Aby uzyskać więcej informacji, zobacz Dodawanie innego zespołu lub hierarchii zespołów.

Nazwy zespołów muszą być zgodne z następującymi ograniczeniami.

Typ ograniczenia Ograniczenie
Długość Nie może zawierać więcej niż 64 znaków Unicode.
Unikatowość Nie może być taka sama jak żadna inna nazwa w projekcie.
Nazwy zarezerwowane Nie może być nazwą zarezerwowaną systemu.
Znaki specjalne — Nie mogą zawierać żadnych znaków zastępczych ani znaków kontrolnych Unicode.
- Nie może zawierać następujących znaków drukowalnych: \ / : * ? " < > | ; # $ * { } , + = [ ].
- Nie może zawierać wielokropka ... ani podwójnego kropki ...
- Nie może zaczynać się od podkreślenia _.
- Nie może rozpoczynać się lub kończyć kropką ..

Nazwy kont użytkowników

Konta użytkowników identyfikują osoby dodane do projektu lub kolekcji projektów. Konta użytkowników mogą odpowiadać wpisom w usłudze Active Directory, Microsoft Entra ID, grupie serwerów systemu Windows.

Konta użytkowników dodawane do organizacji lub kolekcji muszą być zgodne z następującymi ograniczeniami. Aby dodać konta użytkowników do projektu, zobacz Dodawanie użytkowników do projektu lub zespołu.

Typ ograniczenia Ograniczenie
Długość nazwy konta Nie może zawierać więcej niż 256 znaków Unicode.
Unikatowość Nie może być zgodne z żadnym innym kontem użytkownika dodanym do kolekcji projektów.
Nazwy grup zarezerwowanych Nie może mieć nazwy z $NAMESPACE na poziomie projektu lub serwera.
Znaki specjalne - Nie może zawierać następujących znaków drukowalnych: "/ \ [ ] : | < > + = ; ? *.
- Nie może zawierać znaków niedrukowalnych w zakresie wartości ASCII 1–31.
- Nie może kończyć się kropką . ani znakiem $dolara.
- Nie może zawierać przecinków ,.
- Nie może zawierać następujących kategorii Unicode: LineSeparator, ParagraphSeparator, Control, Format, OtherNotAssigned.

Nazwy stron typu wiki i plików

Każda strona typu wiki odpowiada plikowi w repozytorium Git zawartości typu wiki. Nazwy przypisywane do tytułów stron typu wiki muszą być zgodne z następującymi ograniczeniami.

Typ ograniczenia Ograniczenie
Nazwa pliku Długość w pełni kwalifikowanej ścieżki strony nie powinna przekraczać 235 znaków.
Unikatowość W tytułach stron jest rozróżniana wielkość liter i tytuły te muszą być unikatowe w hierarchii stron typu wiki.
Znaki specjalne — Nie mogą zawierać żadnych znaków zastępczych ani znaków kontrolnych Unicode.
- Nie może zawierać następujących znaków drukowalnych: / \ #.
- Nie może rozpoczynać się lub kończyć kropką ..
Rozmiar pliku Nie może przekraczać 18 MB.
Rozmiar pliku załącznika Rozmiar nie może przekraczać 19 MB.

Znaki specjalne w tytułach stron typu wiki

Możesz określić tytuły stron, które zawierają co najmniej jeden z tych znaków : < > * ? | -specjalnych. Możesz na przykład nazwać plik Markdown jako "FAQ?" lub "Set-up guide". Znaki mają następujące ciągi zakodowane za pomocą identyfikatora URI:

Znak Zakodowany ciąg
: %3A
< %3C
> %3E
* %2A
? %3F
| %7C
- %2D
" 22%