Поделиться через

Ограничения именования и соглашения

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

В этой статье описываются правила именования, соглашения и ограничения для компонентов Azure DevOps. Правила именования, ограничения и соглашения помогают обеспечить согласованное взаимодействие с пользователем и обеспечить совместимость с другими приложениями.

Общие рекомендации

Распространенные ограничения включают не превышение длины символа для имени, не содержащего специальных символов, а также сохранение уникальности имен в наборе объектов.

Внимание

При использовании API Azure DevOps вместо пользовательского интерфейса можно напрямую указать имя, которое может содержать символы, ограниченные в пользовательском интерфейсе. Чтобы обеспечить согласованность и предотвратить непредвиденные проблемы, следуйте ограничениям пользовательского интерфейса. Проверьте имена программным способом и соответствующим образом обработайте специальные символы.

Зарезервированные системные имена

Избегайте использования системных зарезервированных имен, таких как в следующих примерах:

  • AUX
  • COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10
  • РАЗВОДИТЬ
  • Коллекция по умолчанию
  • LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9
  • Ноль
  • PRN
  • СЕРВЕР, SignalR
  • Веб или WEB

Дополнительные сведения о зарезервированных именах см. в разделе "Имена файлов", "Пути" и "Пространства имен".

Артефакты Azure

Универсальные пакеты и фиды Azure Artifacts должны соответствовать следующим ограничениям:

Тип ограничения Ограничение
Имя пакета — должен быть строчными буквами.
— должен начинаться и заканчиваться буквенно-цифровыми символами.
— может содержать только буквенно-цифровые символы -и несекуемые дефисы, подчеркивания _или периоды ..
Версия пакета — должен быть строчным регистром без метаданных сборки.
Имя канала — должен начинаться и заканчиваться буквенно-цифровыми символами.
— Не учитывает регистр, но не может отличаться от другого имени канала только за счёт использования заглавной буквы.
— Не удается начать с периода . или подчеркивания _ или окончания периода ..
— Не удается включить один из следующих символов: @~;{}'+=,<>|/\?:&$*"#[]%

Azure Boards

Azure Boards использует рабочие элементы для планирования и отслеживания проектов разработки программного обеспечения. Рабочие элементы описывают работу, назначение работы, отслеживание состояния и координацию усилий в команде. Различные типы рабочих элементов, такие как истории пользователей, задачи, ошибки и проблемы, отслеживают различные типы информации. Дополнительные сведения см. в документации по Azure Boards.

Объекты отслеживания рабочих элементов связаны с одним или несколькими именами. Все объекты, кроме типов рабочих элементов и глобальных списков, имеют понятные отображаемые имена, которые являются уникальными, видимыми пользователем идентификаторами полей. Использование понятных имен обеспечивает согласованность между проектами и типами рабочих элементов в коллекции проектов.

Типы рабочих элементов и глобальные списки связаны с именами ссылок. Система использует имена ссылок внутри системы, и их нельзя изменить после определения.

Некоторые элементы, связанные с рабочими элементами, имеют ограничения, включая имена ссылок, удобочитаемые имена, имена полей и размер вложений.

Пути областей и итераций

Поля рабочего элемента "Путь к области " и " Путь итерации " предоставляют иерархию структуры дерева для группирования работы. Областные пути группируют рабочие элементы по продукту, функции или области признаков. Пути итерации группируют рабочие элементы в спринты, вехи или периоды для решения задачи.

Эти поля с несколькими узлами используют символ обратной косой черты \ для обозначения иерархии узлов в структуре дерева. Имена, которые вы назначаете дочерним узлам, должны соответствовать следующим ограничениям.

Тип ограничения Ограничение
Длина узла Не должно содержать более 255 символов.
Зарезервированные имена — не должно состоять только из периода . или двух периодов ...
— не должно быть системным зарезервированным именем, таким как PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON или AUX. Дополнительные сведения о зарезервированных именах см. в разделе «Имена файлов», «Пути» и «Пространства имен».
Специальные символы для узлов — не должен содержать управляющие символы Юникода.
— не должен содержать один из следующих символов: \ / : * ? " < > | # $ & * +
— не должен содержать символы, запрещенные локальной файловой системой. Дополнительную информацию об ограничениях символов Windows см. в разделе Именование файлов, путей и пространств имен.
Длина пути Не должно содержать более 4000 символов Юникода.
Глубина иерархии пути Должно быть меньше 14 уровней глубины.

Вложения

Файлы, присоединенные к рабочим элементам, должны соответствовать следующим ограничениям.

Тип ограничения Ограничение
Размер файла Не должно превышать максимальный размер:
— Максимальный размер по умолчанию: 4096 килобайт.
— абсолютный максимальный размер: 2 гигабайта.

Дополнительные сведения см. в разделе "Изменение максимального размера вложений для рабочих элементов".

Названия столбцов и дорожек

Доска предоставляет визуальный поток невыполненной работы. По мере выполнения работы от планирования до завершения вы обновляете элементы на доске. Каждый столбец представляет рабочий этап, и каждая карточка представляет рабочий элемент на этом этапе работы.

Можно настроить доску, добавив, удалив или переименовав столбцы и линии. Столбцы поддерживают поток работы через доску, а дорожки позволяют управлять различными работами в виде горизонтальных полос на доске.

Имена столбцов и дорожек должны соответствовать следующим ограничениям.

Тип ограничения Ограничение
Длина Не должно содержать более 256 символов Юникода.
Уникальность — Имена столбцов не должны совпадать с любым другим именем столбца на доске.
- Имена пловцов не должны совпадать с другими именами пловцов на доске.
Специальные символы Не должен содержать символы элемента управления Юникода или суррогатные символы.

Имена полей

Каждый тип рабочего элемента содержит одно или несколько полей, определяющих сведения, хранящиеся для этого типа рабочего элемента. Каждое поле рабочего элемента имеет связанное имя ссылки на поле, которое однозначно идентифицирует поле и не может быть изменено после назначения. Дополнительные сведения о встроенных полях рабочих элементов см. в индексе поля рабочего элемента.

Имена полей рабочих элементов привязаны к коллекции проектов. При переименовании имени поля измените его для всех рабочих элементов и типов рабочих элементов, определенных во всех проектах коллекции.

Имена полей рабочих элементов должны соответствовать следующим ограничениям.

Тип ограничения Ограничение
Длина Не должно содержать более 128 символов Юникода.
Уникальность Должен быть уникальным в пределах организации или коллекции проектов.
Специальные символы — должен содержать по крайней мере один алфавитный символ.
— не должен содержать ни одного из следующих символов: .,;':~\/*?"&%$!+=()[]{}<>-|
— не должен содержать начальные или конечные пробелы.
— не должно содержать два или более последовательных пробелов.

Имена ссылок на поля

Язык определения типа рабочего элемента включает концепцию ссылочного имени поля. Имена ссылок на поля помогают портировать определения между коллекциями проектов Team Foundation и позволяют сторонним интеграциям находить и ссылаться на определенные поля. Эти имена, такие как пространства имен в приложениях .NET Framework, являются глобально уникальными.

Следующие поля определяются в определении типа рабочего элемента шаблонов процессов:

  • Пространство имен системы используется только для определения всех основных системных полей, которые являются обязательными для системных функций Team Foundation. Вы не можете создать собственное System.X поле, так как это может препятствовать функциональным возможностям.

  • Пространство имен Microsoft используется для определения полей для отслеживания рабочих элементов. Хотя вы можете создать собственное Microsoft.X поле, не рекомендуется, так как он может препятствовать функциональным возможностям или возможности успешного обновления проекта после обновления.

Клиенты и партнеры могут создавать собственные пространства имен полей для пользовательских типов рабочих элементов. Описание системных полей и полей, определенных в шаблонах процессов по умолчанию, см. в разделе "Индекс рабочих элементов".

Внимание

Невозможно изменить имена ссылок на поля. Например, если изменить имя поля Title на Header, имя ссылочного идентификатора этого поля не изменится. Интеграции и внутренние представления полей должны использовать имя ссылки на поле вместо имени поля.

Примеры ссылочного имени поля

В следующих примерах показаны допустимые имена полей в разных пространствах имен.

Примеры пространства имен системы Примеры пространства имен Майкрософт Другие примеры пространства имен
System.Id, System.Название, System.Создано, System.ДатаСоздания, System.Изменено, System.ДатаИзменения, System.Состояние, System.Причина 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.Severity, FabrikamFiber.Common.Phase, FabrikamFiber.RiskManagement.RiskType, FabrikamFiber.RiskManagement.Resolution

Contoso.Common.BusinessPriority, Contoso.Bug.FoundInPhase, Contoso.Bug.FixInPhase

Текст справки по полю

Система отображает текст справки во время выполнения, чтобы помочь пользователям узнать, что ввести в поле. Текст справки ограничен определённым типом рабочего элемента в определённом проекте.

Для процесса наследования можно указать текст справки для поля в диалоговом окне "Изменение поля", вкладка "Определение", "Описание". См. раздел "Добавление настраиваемого поля в тип рабочего элемента". Для локального XML-процесса можно указать текст справки с помощью HELPTEXT элемента. См. Добавление или изменение поля для отслеживания работы.

Добавляемый текст справки должен соответствовать следующим ограничениям.

Тип ограничения Ограничение
Длина Не должно содержать более 255 символов Юникода.

Глобальные списки

Определяя типы рабочих элементов, можно найти, что некоторые поля рабочих элементов используют одинаковый набор разрешенных или предлагаемых значений. Глобальный список — это набор значений элементов списка, которые можно определить один раз и использовать глобально во всех коллекциях проектов в экземпляре локального сервера Azure DevOps Server.

Глобальный список, определенный с помощью элемента GLOBALLIST, содержит один или несколько элементов списка, указанных с помощью элемента LISTITEM. Дополнительные сведения см. в разделе "Определение глобальных списков".

Глобальные списки должны соответствовать следующим ограничениям.

Тип ограничения Ограничение
Уникальность Глобальный список должен быть уникальным в экземпляре Azure DevOps Server.
Количество предметов Не должно быть пустым. Глобальный список должен содержать по крайней мере один LISTITEM элемент.

LISTITEM имена должны соответствовать следующим ограничениям.

Тип ограничения Ограничение
Длина — не должно содержать более 254 символов Юникода.
- Не должно быть пустым.
Специальные символы — не должно содержать начальные или конечные пробелы.
— не должно содержать два последовательных пробела.
— Не должен содержать символ обратной косой черты \.
Область Так как глобальные списки доступны среди всех проектов, они не должны содержать элементы, определенные на уровне проекта, например определения учетной записи группы для конкретного проекта.

Определите имя ссылки при добавлении или создании типа ссылки или категории.

Тип ограничения Ограничение
Длина Не должно содержать более 70 символов Юникода.
Уникальность — Не должно совпадать с любым другим именем ссылки на поле в коллекции проектов.
— Не должно совпадать с любым другим именем ссылки на поле после того, как система обрабатывает имена для замены всех периодов . подчеркиванием _. Например, имена My._Field ссылок на поля и My..Field оба обрабатываются как одно и то же имя: My__Field
Специальные символы — может использовать буквенно-цифровые символы, символы подчеркивания, дефисы и периоды.
— Не может содержать последовательные дефисы --.
— должен содержать по крайней мере один период ., но не может начинаться или заканчиваться периодом.
Нельзя начинать с цифры или символа подчеркивания _.

Имена запросов рабочих элементов

Запросы рабочих элементов можно использовать для перечисления рабочих элементов на основе заданных условий поля. Дополнительные сведения см. в разделе Об управляемых запросах.

Тип ограничения Ограничение
Длина Не должно содержать более 255 символов Юникода.
Специальные символы - Не может быть пустым.
— не должен содержать один из следующих символов: /\<>*?"+|:
Уникальность — должен содержаться в папке и иметь уникальное имя внутри папки.

Имена тегов рабочих элементов

Теги рабочих элементов состоят из одного или двух ключевых слов, которые фильтруют или определяют средства отслеживания работы, такие как невыполненные работы, доски и запросы. Дополнительные сведения см. в разделе "Добавление тегов рабочих элементов для классификации и фильтрации списков и досок".

Имена тегов должны соответствовать следующим ограничениям.

Тип ограничения Ограничение
Длина — не должно содержать более 400 символов Юникода.
— не должно быть null или пустым.
Специальные символы — не должен содержать символы-разделители , или ;.
— Не должен содержать символы элемента управления Юникода или форматирования, такие как каналы строк, разделители абзацов, возвращаемые каретки или другие несовпадные суррогатные символы.

Azure Pipelines (система конвейеров Azure)

Объекты Azure Pipeline должны соответствовать следующим ограничениям именования.

Тип объекта Ограничение
Выражения — Должен начинаться со строчной или прописной буквы либо символа подчеркивания, за которыми могут следовать строчные или прописные буквы, цифры или символы подчеркивания _.
Переменные — должен содержать только буквенно-цифровые символы, периоды .и символы подчеркивания _.
— Не удается начать с зарезервированных префиксов endpoint, input, secret, pathили securefile, не учитывает регистр.
Этапы — Имя этапа должно содержать только алфавитно-цифровые символы и символы подчеркивания _.
— Имя не должно начинаться с цифры.
Задачи и задания развертывания — Имя задания должно содержать только буквенно-цифровые символы и символы подчеркивания _.
— Имя не должно начинаться с цифры.
— Имя не может содержать такие ключевые слова, как deploy.
Стратегия задания матрицы — Имя конфигурации матрицы должно содержать только буквенно-цифровые символы и символы подчеркивания _.
— Имя должно начинаться с алфавитного символа.
— максимальная длина: 100 символов.
Создание ресурса — Псевдоним или имя артефакта сборки должен содержать только буквенно-цифровые символы, дефисы -и символы подчеркивания _.
Ресурсы контейнера — Идентификатор контейнера должен содержать только буквенно-цифровые символы, дефисы -и символы подчеркивания _.
Ресурсы пакета — Псевдоним артефакта пакета должен содержать только буквенно-цифровые символы, дефисы - и символы подчеркивания _.
Ресурсы потока — Идентификатор конвейера должен содержать только буквенно-цифровые символы, дефисы -и символы подчеркивания _.
Ресурсы репозитория — псевдоним репозитория должен содержать только буквенно-цифровые символы -, дефисы и символы подчеркивания _.
Ресурсы вебхука — имя веб-хука должно содержать только алфавитно-цифровые символы, дефисы -, и символы подчеркивания _.
Этапы — Идентификатор имени шага должен содержать только буквенно-цифровые символы, дефисы -и подчеркивания _.

Дополнительные сведения см. в документации по Azure Pipelines.

Azure Repos

Репозитории Azure Repos можно использовать на основе Git или Team Foundation Version Control (TFVC).

Каждый проект Azure DevOps может содержать несколько репозиториев Git. Дополнительные сведения см. в документации по Azure Repos Git.

Имена репозитория Git должны соответствовать следующим ограничениям.

Тип ограничения Ограничение
Длина Не должно содержать более 64 символов Юникода.
Уникальность Не должно совпадать с любым другим именем репозитория Git в проекте.
Специальные символы — Не должно содержать управляющих символов Юникода или суррогатных символов.
— не должен содержать следующие печатные символы: \/:*?"<>;#$*{},+=[]|
- Не должно начинаться с подчеркивания _.
— не должно начинаться или заканчиваться периодом ..
— не должно быть зарезервированным системой именем.
- Важно. Хотя можно включить пробелы в имена репозитория, не рекомендуется.

Сведения об ограничениях именования для других элементов Git, таких как ветви и теги, см. в разделе Git check-ref-format.

Имена компьютеров

Имя компьютера, в котором устанавливается Azure DevOps, связано с именем сервера. Операционная система и Active Directory накладывают определенные ограничения на имена компьютеров, как описано в следующих статьях:

Создание Team Foundation

Team Foundation Build позволяет управлять всеми аспектами процесса сборки на одном компьютере. С помощью Team Foundation Build можно синхронизировать источники, скомпилировать приложение, выполнять связанные модульные тесты, выполнять анализ кода, выпуски на файловом сервере и публиковать отчеты о сборке.

Сборка компьютера

Team Foundation Build — это отдельная установка с уровня приложений Azure DevOps Server, уровня данных или клиента Visual Studio. Вы можете выбрать отдельный компьютер или установить сборку параллельно на клиентском компьютере или серверах.

Локальный компьютер сборки должен соответствовать следующим ограничениям.

Тип ограничения Ограничение
Место на диске Должен содержать достаточно места для сборки, так как недостаточно места приводит к неудачным сборкам.
Каталог построения Должен быть локальным путем, например C:\BuildDirectory.
Каталог расположения для выгрузки Должен быть UNC-путь, например \server\share*.
Отказаться от разрешений на доступ к местоположению Каждая созданная сборка должна быть помещена в новый каталог внутри папки для выгрузки.
— Учетная запись службы Team Foundation Server, например Domain\TFSSERVICE, должна иметь полный доступ к расположению удаления UNC.
— Расположение удаления UNC должно быть общей папкой.
Учетная запись службы сборки Team Foundation При изменении учетной записи службы TFS после первоначальной установки необходимо убедиться в том, что:
— учетная запись является членом группы «Build Services».
— У учетной записи есть разрешения на чтение и запись временных папок и временную папку ASP.NET.
— Учетная запись имеет разрешение на полный доступ к каталогу сборки и каталогу хранения.
Firewall Если на компьютер для сборки включен брандмауэр, убедитесь, что программа tfsbuildservice находится в списке исключений.

Типы сборки

Типы сборки — это условия для создания одного решения или набора решений в проекте. Чтобы запустить сборку, можно создать новый тип сборки или использовать существующий тип сборки.

Имена типов сборки должны соответствовать следующим ограничениям.

Тип ограничения Ограничение
Уникальность Не должно совпадать с любым другим именем типа сборки в проекте.
Специальные символы Не должен содержать знак доллара символ $.

Качество сборки

Качество сборки позволяет присвоить уровень качества или состояние завершения готовой сборке. Список значений качества сборки по умолчанию см. в разделе "Частота качества завершенной сборки". Team Foundation Build также позволяет создавать новые значения для типа качества сборки.

Имена качества сборки должны соответствовать следующим ограничениям.

Тип ограничения Ограничение
Длина Не должно содержать более 256 символов Юникода.
Уникальность Не должно совпадать с любым другим именем качества сборки на компьютере Team Foundation Build.

Имена коллекций проектов

Коллекция проектов — это упорядоченная структура, используемая для определения и управления группой проектов для Azure DevOps Server. Коллекция проектов определяет группу проектов и их ресурсов. Имя коллекции проектов также является частью строки подключения, используемой для подключения участников команды к проектам.

Имя коллекции по умолчанию, назначенное коллекции проектов, соответствует DefaultCollection. Дополнительные сведения см. в разделе "Управление коллекциями проектов".

Имена коллекций проектов должны соответствовать следующим ограничениям.

Тип ограничения Ограничение
Длина Не должно содержать более 64 символов Юникода.
Уникальность — не должно совпадать с любым другим именем коллекции в локальном развертывании.
— Если развертывание включает в себя продукты SharePoint или службы SQL Server Reporting Services, их имена не могут совпадать с именем и полным путем существующего сайта SharePoint, сервера отчетов или веб-сайта служб Reporting Services.
Специальные символы — Не должно содержать управляющих символов Юникода или суррогатных символов.
— не должен содержать следующие печатные символы: \/:*?"<>;#$*{},+=[]|
— не должен содержать многоточие ... или двойной период ...
- Не должно начинаться с подчеркивания _.
— не должно начинаться или заканчиваться периодом ..
Не должно быть зарезервированным системой именем.

названия организаций;

Организация — это упорядоченная структура, используемая для определения и управления группой проектов для Azure DevOps Services. Организация определяет группу проектов и их ресурсов.

Внимание

При создании имени организации соблюдайте следующие рекомендации.

  • Используйте только буквы из английского алфавита
  • Начните имя вашей организации с буквы или цифры.
  • Используйте буквы, цифры или дефисы после начального символа
  • Убедитесь, что ваша организация не превышает 50 символов Юникода
  • Заканчивается буквой или номером

Если вы используете любой из запрещенных символов, вы получите следующее сообщение об ошибке: VS850015: указанное имя не допускается использовать: {Название организации}.

Процессы и шаблоны процессов

Процесс определяет стандартные блоки системы отслеживания рабочих элементов и других подсистем, к которым можно получить доступ после подключения к проекту. Как шаблон процесса , так и шаблон процесса относятся к взаимозависимому набору файлов, используемых для создания проекта. Сведения о процессах по умолчанию см. в разделе "Сведения о процессах и шаблонах процессов".

Процессы, определяемые или настраиваемые, должны соответствовать следующим ограничениям.

Тип ограничения Ограничение
Длина Не должно содержать более 256 символов Юникода.
Уникальность — должен быть уникальным в Azure DevOps. Если вы отправляете шаблон с тем же именем, что и существующий шаблон, существующий шаблон перезаписывается.
Размер файла шаблона процесса Не должно превышать 2 гигабайта.

Имена проектов

Проект устанавливает репозиторий для исходного кода и место для команд для планирования, отслеживания хода выполнения и совместной работы. Имя проекта является частью строки подключения, используемой для подключения участников команды к проекту.

Имена, назначенные создаваемым проектам, должны соответствовать следующим ограничениям.

Тип ограничения Ограничение
Длина Не должно содержать более 64 символов Юникода.
Уникальность Не должно совпадать с любым другим именем в организации, коллекции проектов или веб-приложении SharePoint или отчете SQL Server для коллекции.
Зарезервированные имена — не должно быть зарезервированным системой именем.
— не должно быть одним из скрытых сегментов, используемых для фильтрации запросов IIS, таких как App_Browsers, App_code, App_Data, App_GlobalResources, App_LocalResourcesApp_ThemesApp_WebResourcesbin, или .web.config
Специальные символы — Не должно содержать управляющих символов Юникода или суррогатных символов.
— не должен содержать следующие печатные символы: \/:*?"'<>;#$*{},+=[]|
- Не должно начинаться с подчеркивания _.
— не должно начинаться или заканчиваться периодом ..

Группы безопасности

Группы безопасности Azure DevOps можно использовать для применения определенных прав или разрешений к группе пользователей. Группы могут состоять из учетных записей Microsoft Entra ID или Active Directory, групп безопасности Azure DevOps, учетных записей пользователей или групп Windows или сочетания. Дополнительные сведения см. в разделе "Добавление пользователей или групп Microsoft Entra" в встроенную группу безопасности.

Группы безопасности должны соответствовать следующим ограничениям.

Тип ограничения Ограничение
Длина имени учетной записи группы безопасности Не должно содержать более 256 символов Юникода.
Уникальность — Учетные записи групп уровня проекта не должны соответствовать другому имени группы в том же проекте.
— Учетные записи группы уровня организации или коллекции не должны соответствовать другому имени учетной записи группы в организации или коллекции проектов.
Зарезервированные имена групп Не должно быть названо как $NAMESPACE ни на уровне проекта, ни на уровне сервера.
Специальные символы — Не должно содержать управляющих символов Юникода или суррогатных символов.
— не должен содержать следующие печатные символы: ,/\[]:<>+=;?*|
— не должно включать непечатываемые символы в диапазон значений ASCII 1–31.
— не должен заканчиваться периодом ..

Имена команд

Имена групп определяют группу отдельных лиц или групп, которые работают вместе в качестве команды в проекте. Участники команды используют это имя для подключения к команде или поиска участников, указанных для команды. Имена команд должны соответствовать соглашениям, которые позволяют отображать их как часть допустимого URL-адреса.

Каждое имя команды должно быть уникальным в рамках одного проекта, но в разных проектах или коллекции проектов нет ограничений на использование одного имени команды. Дополнительные сведения см. в разделе "Добавление другой команды" или иерархии команд.

Имена команд должны соответствовать следующим ограничениям.

Тип ограничения Ограничение
Длина Не должно содержать более 64 символов Юникода.
Уникальность Не должно совпадать с любым другим именем команды в проекте.
Зарезервированные имена Не должно быть зарезервированным системой именем.
Специальные символы — Не должно содержать управляющих символов Юникода или суррогатных символов.
— не должен содержать следующие печатные символы: \/:*?"<>;#$*{},+=[]|
— не должен содержать многоточие ... или двойной период ...
- Не должно начинаться с подчеркивания _.
— не должно начинаться или заканчиваться периодом ..

Имена учетных записей пользователей

Учетные записи пользователей идентифицируют пользователей, добавленных в проект или коллекцию проектов. Учетные записи пользователей могут соответствовать записям в Active Directory, идентификаторе Microsoft Entra или группе серверов Windows.

Сведения о добавлении учетных записей пользователей в проект см. в разделе "Добавление пользователей в проект или команду". Учетные записи пользователей, добавляемые в организацию или коллекцию, должны соответствовать следующим ограничениям.

Тип ограничения Ограничение
Длина имени учетной записи Не должно содержать более 256 символов Юникода.
Уникальность Не должно соответствовать какой-либо другой учетной записи пользователя в коллекции организаций или проектов.
Зарезервированные имена групп Не должно быть названо как $NAMESPACE ни на уровне проекта, ни на уровне сервера.
Специальные символы — не должно содержать следующие печатные символы: ,"/\[]:<>+=;?*|
— не должно включать непечатываемые символы в диапазон значений ASCII 1–31.
- Не должно заканчиваться на точку . или знак $ доллара.
— не должно включать следующие категории Юникода: LineSeparator, ParagraphSeparator, Control, Format. OtherNotAssigned

Вики-страницы и имена файлов

Каждая вики-страница соответствует файлу в репозитория вики-сайта Git. Следующие ограничения применяются к именам файлов страниц и размеру файла:

  • Имя файла. При выборе имени файла страницы помните, что полный путь к файлу должен составлять 235 символов или меньше. Полный путь к странице состоит из URL-адреса репозитория, пути к файлу страницы и имени файла страницы. Например: https://github.com/ExampleWiki/Contributors/Code/How-to-add-code-to-the-project.md.

  • Уникальность: имя файла страницы должно быть уникальным в папке в иерархии вики-репозитория. Имя чувствительно к регистру.

  • Специальные символы: имя файла страницы имеет ограничения на следующие специальные символы:

    • Без символов элемента управления Юникода или суррогатных символов
    • Нет печатных символов: косая черта /, обратная косая черта \, хэш #
    • Нет символа точки . в начале или конце имени

  • Размер файла: максимальный размер файла страницы составляет 18 МБ.

  • Размер файла вложения: максимальный размер любого вложения к файлу страницы составляет 19 МБ.

Разрешенные специальные символы

В имени файла страницы разрешено несколько специальных символов, таких как двоеточие : и дефис -. Например, файл Markdown можно назвать как часто задаваемые вопросы:0525 или руководство по настройке.

Внимание

Чтобы избежать ошибок в синтаксисе страницы и навигации в браузере, не используйте пробел ( ) в именах файлов страниц. Если вы назовете файлы страниц на основе заголовка страницы, замените все пробелы в заголовке страницы дефисом (-) в имени файла.

В следующей таблице перечислены специальные символы, разрешенные в именах файлов вики-страницы, и соответствующая строка в кодировке URI:

Символ Символ Строка URI
Двоеточие : %3A
Левая угловая скобка < %3C
Правая угловая скобка > %3E
Звездочка (подстановочный знак) * %2A
Вопросительный знак ? %3F
канал | %7C
Дефис (тире) - %2D
Двойная кавычка " 22 %

Например, имя файла часто задаваемые вопросы:0525 закодировано как FAQ%3A0525.

Связанный контент

  • Last updated on