Udostępnij przez

Ograniczenia i konwencje nazewnictwa

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

W tym artykule opisano reguły nazewnictwa, konwencje i ograniczenia dotyczące składników usługi Azure DevOps. Reguły nazewnictwa, ograniczenia i konwencje pomagają zagwarantować spójne środowisko użytkownika i zapewnić zgodność z innymi aplikacjami.

Zagadnienia ogólne

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.

Ważne

W przypadku korzystania z interfejsów API usługi Azure DevOps zamiast interfejsu użytkownika można bezpośrednio określić nazwę, która może zawierać znaki ograniczone w interfejsie użytkownika. Aby zachować spójność i zapobiec niezamierzonym problemom, postępuj zgodnie z ograniczeniami interfejsu użytkownika. Zweryfikuj nazwy programowo i odpowiednio obsłuż znaki specjalne.

Nazwy zarezerwowane dla 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
  • WADA
  • Domyślna Kolekcja
  • LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9
  • NUL
  • PRN
  • SERWER, SignalR
  • Sieć lub sieć WWW

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

Azure Artifacts

Uniwersalne pakiety i kanały informacyjne usługi Azure Artifacts muszą być zgodne z następującymi ograniczeniami:

Typ ograniczenia Ograniczenie
Nazwa pakietu - Musi być małymi literami.
— Musi zaczynać się i kończyć znakami alfanumerycznymi.
- Może zawierać tylko znaki alfanumeryczne i niekolejne łączniki -, podkreślenia _ lub kropki ..
Wersja pakietu — Musi być napisane małymi literami bez metadanych kompilacji.
Nazwa kanału informacyjnego — Musi zaczynać się i kończyć znakami alfanumerycznymi.
— Niewrażliwy na wielkość liter, ale nie może różnić się od innej nazwy kanału jedynie pod tym względem.
- Nie można rozpocząć od kropki . ani podkreślenia _ ani zakończyć kropką ..
- Nie można uwzględnić żadnego z następujących znaków: @~;{}'+=,<>|/\?:&$*"#[]%.

Azure Boards

Usługa Azure Boards używa elementów roboczych do planowania i śledzenia projektów programistycznych. Elementy robocze opisują pracę, którą należy wykonać, przypisują pracę, śledzą stan i koordynują działania 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.

Obiekty śledzenia elementów roboczych są skojarzone z co najmniej jedną nazwą. Wszystkie obiekty z wyjątkiem typów elementów roboczych i list globalnych mają przyjazne nazwy wyświetlane, które są unikatowymi identyfikatorami widocznymi dla użytkowników dla pól. Używanie przyjaznych nazw zapewnia spójność między projektami i typami elementów roboczych w kolekcji projektów.

Typy elementów roboczych i listy globalne są powiązane z nazwami referencyjnymi. System używa nazw odwołań wewnętrznie i nie można ich zmienić po zdefiniowaniu.

Kilka elementów związanych z elementami roboczymi ma ograniczenia, w tym nazwy referencyjne, łatwe do zapamiętania nazwy, nazwy pól i rozmiar załącznika.

Ścieżki obszaru i iteracji

Pola elementów roboczych Ścieżka obszaru i Ścieżka iteracji zapewniają hierarchię struktury drzewa dla grupowania pracy. Ścieżki obszaru grupują elementy robocze według produktu, funkcji lub dziedziny funkcjonalnej. Ścieżki iteracji grupują elementy robocze w sprinty, kamienie milowe lub okresy na potrzeby realizacji pracy.

Te pola z wieloma węzłami używają znaku backslash \, aby oznaczyć hierarchię węzłów w strukturze drzewa. Nazwy, które przypisujesz do węzłów podrzędnych, 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 kropek ...
- 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.

Aby uzyskać więcej informacji, zobacz Zmienianie maksymalnego rozmiaru załącznika dla elementów roboczych.

Nazwy kolumn tablicy i pasa kąpielowego

Tablica zapewnia wizualny przepływ prac w toku. W miarę postępu prac od planowania do ukończenia zaktualizujesz elementy na tablicy. Każda kolumna reprezentuje etap pracy, a każda karta reprezentuje element roboczy na tym etapie pracy.

Tablicę można dostosować, dodając, usuwając lub zmieniając nazwy kolumn i torów. Kolumny obsługują przepływ pracy na pokładzie, a pływaki umożliwiają zarządzanie różnymi pracami jako poziomymi pasami 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.
- Nazwy pływaków nie mogą być takie same jak żadna inna nazwa pływaka na pokładzie.
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, które definiuje informacje przechowywane dla tego typu elementu roboczego. Każde pole elementu roboczego ma skojarzoną nazwę referencyjną pola, która jednoznacznie identyfikuje pole i nie można jej zmienić po przypisaniu. Aby uzyskać więcej informacji na temat wbudowanych pól elementów roboczych, zobacz indeks pola Elementu roboczego.

Nazwy pól elementu roboczego są ograniczone do kolekcji projektów. Jeśli zmienisz nazwę pola, zmienisz ją dla wszystkich elementów roboczych i typów elementów roboczych zdefiniowanych we wszystkich projektach w kolekcji.

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ść Musi być unikatowa w organizacji lub kolekcji projektów.
Znaki specjalne - Musi 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ć dwóch lub więcej kolejnych spacji.

Nazwy odwołań do pól

Język definicji typu elementu roboczego zawiera pojęcie nazwy odwołania do pola. Nazwy odwołań do pól mogą pomóc w przenoszeniu definicji między kolekcjami projektów Team Foundation i umożliwiać integracjom innych firm odnajdywanie oraz odwoływanie się do konkretnych pól. Te nazwy, takie jak przestrzenie nazw w aplikacjach .NET Framework, są globalnie unikatowe.

Następujące pola są definiowane w definicji typu elementu roboczego szablonów procesów:

  • 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 System.X pola, ponieważ może to utrudniać funkcjonalność.

  • Przestrzeń nazw firmy Microsoft służy do definiowania pól śledzenia elementów roboczych. Chociaż można utworzyć własne Microsoft.X pole, nie jest zalecane, ponieważ może to utrudniać funkcjonalność lub możliwość pomyślnego zaktualizowania projektu po uaktualnieniu.

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 zobacz w Indeks elementów roboczych.

Ważne

Nie można zmienić nazw odwołań do pól. Jeśli na przykład zmienisz nazwę pola Tytuł na Nagłówek, nazwa odwołania do pola tego pola nie ulegnie zmianie. Integracje i wewnętrzne reprezentacje pól powinny używać nazwy odwołania do pola zamiast nazwy pola.

Przykłady nazwy referencyjnej pola

W poniższych przykładach przedstawiono prawidłowe nazwy odwołań do pól w różnych przestrzeniach nazw.

Przykłady przestrzeni nazw systemu Przykłady przestrzeni nazw firmy Microsoft Inne przykłady przestrzeni nazw
System.Id, System.Tytuł, System.UtworzonyPrzez, System.DataUtworzenia, System.ZmienionyPrzez, System.DataZmiany, System.Stan, System.Powód 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 FabrikamFiber.Common.Dotkliwość, FabrikamFiber.Common.Faza, FabrikamFiber.ZarządzanieRyzykiem.TypRyzyka, FabrikamFiber.ZarządzanieRyzykiem.Rozwiązanie

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 przypisany do 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 na potrzeby ś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

Podczas definiowania typów elementów roboczych niektóre pola elementów roboczych mogą współdzielić ten sam zestaw dozwolonych lub sugerowanych wartości. Globalna lista to zestaw wartości elementów listy, które można definiować pojedynczo i używać globalnie we wszystkich kolekcjach projektów w ramach wystąpienia lokalnego serwera Azure DevOps Server.

Lista globalna, zdefiniowana przy użyciu elementu GLOBALLIST, zawiera co najmniej jeden element listy określony przy użyciu elementu LISTITEM. Aby uzyskać szczegółowe informacje, zobacz Definiowanie list globalnych.

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

Typ ograniczenia Ograniczenie
Unikatowość Lista globalna musi być unikatowa w wystąpieniu usługi Azure DevOps Server.
Liczba towarów Nie może być pusty. Lista globalna musi zawierać co najmniej jeden LISTITEM element.

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 ukośnika \ wstecznego.
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.

Zdefiniuj nazwę odwołania podczas dodawania lub tworzenia typu łącza lub kategorii.

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 odniesienia pola w zbiorze projektów.
— Nie może być taka sama jak żadna inna nazwa odwołania do pola po tym, jak system przetwarza nazwy, aby zastąpić wszystkie kropki . podkreśleniami _. Na przykład nazwy odwołań do pól My._Field i My..Field będą przetwarzane jako ta sama nazwa: My__Field.
Znaki specjalne — Może używać znaków alfanumerycznych, podkreśleń, łączników i kropek.
- Nie można zawierać kolejnych łączników --.
— Musi zawierać co najmniej jedną kropkę ., ale nie może zaczynać się ani kończyć kropką.
- Nie można rozpocząć od cyfry lub podkreślenia _.

Nazwy zapytań elementu roboczego

Zapytania elementów roboczych umożliwiają wyświetlanie listy elementów roboczych na podstawie podanych kryteriów pól. Aby uzyskać więcej informacji, zobacz About managed queries (Informacje o zarządzanych zapytaniach).

Typ ograniczenia Ograniczenie
Długość Nie może zawierać więcej niż 255 znaków Unicode.
Znaki specjalne - Nie może być pusty.
- Nie może zawierać żadnego z następujących znaków: /\<>*?"+|:.
Unikatowość - Musi być zawarty w folderze i być nazwany unikatowo w folderze.

Nazwy tagów elementów roboczych

Tagi elementów roboczych składają się z jednego lub dwóch słów kluczowych, które filtrują lub definiują narzędzia do śledzenia pracy, takie jak listy prac, tablice i zapytania. 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 , ani ;.
- Nie może zawierać znaków sterujących ani znaków formatu Unicode, takich jak znaki nowej linii, separatory akapitów, znaki powrotu karetki lub inne niezgodne znaki zastępcze.

Azure Pipelines

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

Typ obiektu Ograniczenie
Wyrażenia - Musi zaczynać się od małych lub wielkich liter alfabetycznych lub podkreślenia, a następnie małych lub wielkich liter alfabetycznych, cyfr lub podkreśleń _.
Zmienne - Musi zawierać tylko znaki alfanumeryczne, kropki .i podkreślenia _.
— Nie wolno rozpocząć od zarezerwowanych prefiksów endpoint, input, secret, path, lub securefile, niezależnie od wielkości liter.
Etapach - Nazwa etapu musi zawierać tylko znaki alfanumeryczne oraz znak podkreślenia _.
- Nazwa nie może zaczynać się od cyfry.
Zadania i prace wdrożeniowe - Nazwa zadania musi zawierać tylko znaki alfanumeryczne i podkreślenia _.
- Nazwa nie może zaczynać się od cyfry.
- Nazwa nie może zawierać słów kluczowych, takich jak deploy.
Strategia zadania macierzy - Nazwa konfiguracji macierzy musi zawierać tylko znaki alfanumeryczne i podkreślenia _.
- Nazwa musi zaczynać się od znaku alfabetycznego.
- Maksymalna długość: 100 znaków.
Zasób budowania — Alias lub nazwa artefaktu kompilacji musi zawierać tylko znaki alfanumeryczne, łączniki -i podkreślenia _.
Zasoby kontenera — Identyfikator kontenera musi zawierać tylko znaki alfanumeryczne, łączniki -i podkreślenia _.
Zasoby pakietu — Alias artefaktu pakietu musi zawierać tylko znaki alfanumeryczne, łączniki -i podkreślenia _.
Zasoby rurociągu — Identyfikator pipeline musi zawierać tylko znaki alfanumeryczne, łączniki -, i podkreślenia _.
Zasoby repozytorium - Alias repozytorium musi zawierać tylko znaki alfanumeryczne, łączniki -i podkreślenia _.
Zasoby webhooków - Nazwa elementu webhook musi zawierać tylko znaki alfanumeryczne, łączniki -i podkreślenia _.
Kroki - Identyfikator nazwy kroku musi zawierać tylko znaki alfanumeryczne, łączniki -i podkreślenia _.

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

Azure Repos

Repozytoria usługi Azure Repos mogą być oparte na Git lub kontroli wersji Team Foundation (TFVC).

Każdy projekt usługi Azure DevOps może zawierać wiele repozytoriów Git. Aby uzyskać więcej informacji, zobacz dokumentację usługi Azure Repos Git.

Nazwy repozytoriów Git 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ą 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ć zarezerwowaną nazwą systemową.
- Ważne: chociaż można uwzględnić spacje w nazwach repozytorium, nie jest to zalecane.

Aby uzyskać informacje na temat ograniczeń nazewnictwa innych elementów usługi Git, takich jak gałęzie i tagi, zobacz git check-ref-format.

Nazwy komputerów

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

Kompilacja Team Foundation

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.

Zbudować komputer

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 lub zainstalować kompilację obok siebie na komputerze klienckim lub 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, ponieważ niewystarczająca ilość miejsca prowadzi do niepowodzenia kompilacji.
Katalog kompilacji Musi być ścieżką lokalną, taką jak C:\BuildDirectory.
Usuwanie katalogu lokalizacji Musi być ścieżką UNC, taką jak \server\share*.
Usuwanie uprawnień do lokalizacji Każda wygenerowana kompilacja musi zostać umieszczona w nowym katalogu w folderze docelowym.
— Konto usługi serwera Team Foundation Server, na przykład Domain\TFSSERVICE, musi mieć uprawnienia pełnej kontroli do lokalizacji 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:
— 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 docelowej.
Zapora Jeśli na komputerze kompilacji jest włączona zapora, upewnij się, że program tfsbuildservice znajduje się na liście wyjątków.

Typy kompilacji

Typy kompilacji to warunki tworzenia pojedynczego rozwiązania lub zestawu rozwiązań w projekcie. Aby uruchomić kompilację, możesz 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ć znaku dolara $ .

Jakość wykonania

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

Nazwy jakości budowy 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 Team Foundation Build.

Nazwy kolekcji projektów

Kolekcja projektów to struktura organizacyjna używana do definiowania i kontrolowania grupy projektów dla usługi Azure DevOps Server. Kolekcja projektów identyfikuje grupę projektów i ich zasobów. Nazwa kolekcji projektu jest również częścią parametrów połączenia używanych do łączenia członków zespołu z projektami.

Domyślna nazwa kolekcji przypisana do kolekcji projektu to DefaultCollection. Aby uzyskać więcej informacji, zobacz Zarządzanie kolekcjami projektów.

Nazwy 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, ich nazwy 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.
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ójnej kropki ...
- Nie może zaczynać się od podkreślenia _.
- Nie może rozpoczynać się lub kończyć kropką ..
Nie może być nazwą zarezerwowaną przez system.

Nazwy organizacji

Organizacja jest strukturą organizacyjną używaną do definiowania i kontrolowania grupy projektów dla usług Azure DevOps Services. Organizacja identyfikuje grupę projektów i ich zasobów.

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
  • Zachowaj nazwę organizacji poniżej 50 znaków Unicode
  • Koniec literą lub cyfrą

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

Proces i szablony procesów

Proces definiuje bloki konstrukcyjne systemu śledzenia elementów roboczych i innych podsystemów, do których można uzyskać dostęp po nawiązaniu połączenia z projektem. Zarówno proces , jak i szablon procesu odwołują się do współzależnego zestawu plików używanych do tworzenia projektu. Aby uzyskać informacje na temat procesów domyślnych, zobacz About processes and process templates (Informacje o procesach i szablonach procesów).

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 gigabajtów.

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ą ciągu połączenia używanego 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 organizacji, kolekcji projektów lub aplikacji sieci Web programu SharePoint ani w raporcie programu SQL Server dla kolekcji.
Nazwy zarezerwowane - Nie może być zarezerwowaną nazwą systemową.
— Nie może być jednym z ukrytych segmentów używanych do filtrowania żądań usług IIS, takich jak App_Browsers, , App_codeApp_DataApp_GlobalResourcesApp_LocalResourcesApp_ThemesApp_WebResourcesbinlub .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ń

Grupy zabezpieczeń usługi Azure DevOps umożliwiają stosowanie pewnych praw lub uprawnień do grupy użytkowników. Grupy mogą składać się z kont Microsoft Entra ID lub Active Directory, grup zabezpieczeń usługi Azure DevOps, kont użytkowników lub grup systemu Windows lub kombinacji. 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 grupy na poziomie organizacji lub kolekcji nie mogą być zgodne z żadną inną nazwą konta grupy w organizacji lub kolekcji projektów.
Nazwy grup zarezerwowanych Nie może być nazwane z użyciem $NAMESPACE ani na poziomie projektu, ani 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ą ..

Nazwy zespołów

Nazwy zespołów identyfikują grupę osób lub grup, które 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, ale nie ma żadnych ograniczeń dotyczących używania tej samej nazwy zespołu w różnych projektach w organizacji lub 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 zespołu w projekcie.
Nazwy zarezerwowane Nie może być nazwą zarezerwowaną przez system.
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ójnej 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 służą do identyfikacji użytkowników dodanych do projektu lub kolekcji projektu. Konta użytkowników mogą odpowiadać wpisom w ramach usługi Active Directory, identyfikatora Entra firmy Microsoft lub grupy serwerów systemu Windows.

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

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 w organizacji ani kolekcji projektów.
Nazwy grup zarezerwowanych Nie może być nazwane z użyciem $NAMESPACE ani na poziomie projektu, ani 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ć następujących kategorii Unicode: LineSeparator, , ParagraphSeparatorControl, Format, OtherNotAssigned.

Nazwy stron typu wiki i plików

Każda strona typu wiki odpowiada plikowi w repozytorium Git typu wiki. Następujące ograniczenia odnoszą się do nazw plików stron oraz rozmiaru pliku:

  • Nazwa pliku: podczas wybierania nazwy dla pliku stronicowania należy pamiętać, że w pełni kwalifikowana ścieżka do pliku powinna mieć 235 znaków lub mniej. Pełna ścieżka do strony składa się z adresu URL repozytorium, ścieżki folderu do pliku strony i nazwy pliku strony. Na przykład https://github.com/ExampleWiki/Contributors/Code/How-to-add-code-to-the-project.md.

  • Unikatowość: nazwa pliku strony musi być unikatowa w jej lokalizacji folderu w hierarchii repozytorium wiki. W nazwie jest rozróżniana wielkość liter.

  • Znaki specjalne: nazwa pliku strony ma ograniczenia dotyczące następujących znaków specjalnych:

    • Brak znaków kontrolnych Unicode ani znaków zastępczych
    • Brak znaków drukowalnych: ukośnik do przodu, ukośnik /\odwrotny, skrót#
    • Brak symbolu kropki . na początku lub na końcu nazwy

  • Rozmiar pliku: maksymalny rozmiar pliku strony to 18 MB.

  • Rozmiar pliku załącznika: maksymalny rozmiar dowolnego załącznika do pliku strony wynosi 19 MB.

Dozwolone znaki specjalne

W nazwie pliku strony dozwolonych jest kilka znaków specjalnych, takich jak dwukropek : i łącznik -. Możesz na przykład nazwać plik Markdown jako FAQ:0525 lub Setup-Guide.

Ważne

Aby uniknąć błędów w składni strony i nawigacji w przeglądarce, nie używaj znaku spacji ( ) w nazwach plików strony. Jeśli nazwy plików stron są oparte na tytule strony, zastąp wszystkie spacje w tytule strony łącznikiem (-) w nazwie pliku.

W poniższej tabeli wymieniono znaki specjalne dozwolone w nazwach plików stron typu wiki oraz odpowiadający im ciąg zakodowany identyfikatorem URI:

Znak Symbol Ciąg identyfikatora URI
Dwukropek : %3A
Lewy nawias kątowy < %3C
Nawias kątowy w prawo > %3E
Gwiazdka (symbol wieloznaczny) * %2A
Znak zapytania ? %3F
potoku | %7C
Łącznik (kreska) - %2D
Podwójny cudzysłów " 22%

Na przykład nazwa pliku FAQ:0525 jest zakodowana jako FAQ%3A0525.

Treści powiązane

  • Last updated on