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

  • Статья

Azure DevOps Services | Azure DevOps Server 2022 г. - Azure DevOps Server 2019 г. | TFS 2018

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

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

Примечание

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

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

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

Как и в других файлах операционной системы, также нельзя использовать управляющие символы в кодировке ASCII (ASCII 1-31) и заменяемые комбинации. Общие сведения об ограничениях операционной системы, применяемых к именам файлов, см. в разделе Именование файлов, путей и пространств имен.

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

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

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

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

Azure Artifacts

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

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

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 гигабайта.
Тип ограничения Ограничение
Размер файла Не должен превышать максимальный размер:
— Максимальный размер по умолчанию: 4096 килобайт.
— Абсолютный максимальный размер: 2 гигабайта. Дополнительные сведения см. в разделе Изменение максимального размера вложения для рабочих элементов.

Имена столбцов и дорожки доски

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

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

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

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

Имена полей

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

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

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

Имена ссылок полей и переносимость

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

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

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

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

Важно!

  • Имена ссылок на поля не могут быть переименованы. Если, например, имя поля "Title" изменено на "Header", имя ссылки на поле остается прежним. Интеграции и внутренние представления полей должны использовать имя ссылки поля, а не зависеть от самого имени поля.
  • Хотя вы можете создать собственное поле Microsoft.X, мы не рекомендуем это делать, так как это может помешать работе или возможности мастера настройки компонентов успешно обновить проект после обновления.

Примеры имен ссылок полей

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

Примеры в пространстве имен System Примеры в пространстве имен Microsoft Другие примеры пространств имен
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 Вымышленная компания Fabrikam Fibre может определить следующие настраиваемые поля рабочих элементов:
FabrikamFiber.Common.Severity, FabrikamFiber.Common.Phase, FabrikamFiber.RiskManagement.RiskType, FabrikamFiber.RiskManagement.Resolution

Вымышленная компания Contoso Corporation может определить следующие поля рабочих элементов:
Contoso.Common.BusinessPriority, Contoso.Bug.FoundInPhase, Contoso.Bug.FixInPhase

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

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

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

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

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

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

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

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

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

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

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

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

Определите имя ссылки при каждом добавлении или создании типа ссылки или категории. Все имена ссылок могут содержать до 70 символов Юникода.

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

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

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

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

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

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

Azure Pipelines

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

Тип ограничения Ограничение
Имя задания — должен содержать только буквенно-цифровые символы и '_'.
— не должно начинаться с числа.
— должно иметь уникальное имя.
— не должен содержать ключевые слова, например "deployment".
Название этапа — должен содержать только буквенно-цифровые символы и '_'.
— не должно начинаться с числа.
— не должен содержать ключевые слова, например "deployment".
Выражения Должен начинаться с a-Z или _AND, за которым следует a-Z, 0-9или _.

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

Azure Repos (Git)

Каждый проект Azure DevOps может содержать несколько репозиториев Git. Имена, назначенные репозиториям Git, должны соответствовать следующим ограничениям. Дополнительные сведения см. в Azure Repos документации по Git. Дополнительные сведения об ограничениях именования для других элементов Git, таких как ветви и теги, см. в статье Git проверка-ref-format.

Важно!

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

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

Azure Repos (TFVC)

Система управления версиями Team Foundation (TFVC) предоставляет центральный репозиторий для файлов и команд, необходимых для управления этими файлами в команде. Также предоставляет настраиваемые политики возвращения, ветвления, совмещения, включения в набор отложенные изменений, и многое другое. Дополнительные сведения см. в документации по Azure Repos TFVC.

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

Тип ограничения Ограничение
Длина пути папки сервера системы управления версиями — не должно содержать более 259 символов Юникода для одной папки или имени файла.
— не должно содержать более 388 символов Юникода для каталога.
— не должно содержать более 399 символов Юникода для объединенного каталога и имени файла.
Длина пути локальных папок — не должно содержать более 248 символов Юникода для каталога.
— не должно содержать более 260 символов Юникода для объединенного каталога и имени файла.
Ограничения длины веб-портала и REST Не должно содержать более 215 символов Юникода для объединенного имени проекта, каталога и имени файла.

На веб-портале и REST API некоторые операции имеют более ограниченную длину пути, чем Visual Studio и клиенты TF.exe. Эти операции включают в себя изменение, переименование и удаление, и происходят, поскольку веб-портал или REST использует случайно созданную рабочую область для параллелизма при ожидании изменений.

Файлы TFVC

В системе управления версиями хранятся файлы множества различных типов. Настройка управления версиями Team Foundation на компьютере разработки содержит сведения о том, как добавить существующие проекты или решения Visual Studio.

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

Тип ограничения Ограничение
Файлы и папки — Имена не должны содержать следующие печатные символы: \ / : * ? " < > | ;.
— Папки не должны находиться за пределами сопоставленного каталога для активной рабочей области.
Имена файлов — не должно начинаться с $.
— не должен содержать следующие печатные символы: \ / : * ? " < > | ;.

Метки TFVC

В системе управления версиями Team Foundation (TFVC) метка — это имя, применяемое к определенному набору редакций. Метки можно прикрепить к набору несвязанных файлов в управлении версиями, что позволяет извлекать файлы или действовать с ними как группа. В следующей таблице описаны ограничения для имен ярлыков.

Тип ограничения Ограничение
Длина Не должно содержать более 64 символов Юникода.
Специальные символы — не может заканчиваться пробелом ( ) или точкой ..
— не должен содержать следующие печатные символы: \ / : * ? " < > | ; @.

Наборы полок TFVC

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

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

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

Рабочие области TFVC

Рабочая область — это клиентская копия файлов и папок в системе управления версиями Team Foundation (TFVC). При создании нескольких рабочих областей на клиентском компьютере могут находиться различные версии одной и той же папки системы управления версиями. Дополнительные сведения см. в статье Создание рабочих областей и работа с ней.

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

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

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

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

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

Важно!

В настоящее время в названии организации можно использовать только буквы из английского алфавита. Начните название организации с буквы или цифры, за которыми следуют буквы, цифры или дефисы. Названия организаций не должны содержать более 50 символов Юникода и должны заканчиваться буквой или цифрой.

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

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

Примечание

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

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

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

Коллекции проектов

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

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

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

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

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

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

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

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

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

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

Локальные группы могут состоять из учетных записей групп Active Directory, групп безопасности Azure DevOps, учетных записей пользователей Windows, учетных записей групп Windows или любого сочетания этих типов. Дополнительные сведения см. в статье Добавление пользователей или групп AD/Azure AD во встроенную группу безопасности.

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

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

построение 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 после начальной установки необходимо убедиться, что выполняются следующие условия:
— Учетная запись входит в группу Служб сборки.
— Учетная запись имеет разрешения на чтение и запись для временных папок и ASP.NET временной папки.
— Учетная запись имеет разрешение на полный доступ к каталогу сборки и расположению удаления.
Проблемы с брандмауэром Если на компьютере сборки включен брандмауэр, убедитесь, что программа tfsbuildservice находится в списке исключений.

Типы сборки

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

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

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

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

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

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

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

Имена команд

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

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

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

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

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

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

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

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

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

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

Тип ограничения Ограничение
Имя файла Полный путь к странице не должен превышать 235 символов.
Уникальность Заголовки должны именоваться с учетом регистра и быть уникальными в иерархии вики-сайта.
Специальные символы — Имя не должно содержать непечатаемых символов Юникода или заменяемых символов.
— не должен содержать следующие печатные символы: / \ #.
— не должно начинаться или заканчиваться точкой ..
Размер файла Размер не должен превышать максимального значения в 18 МБ.
Размер вложенного файла Размер не должен максимального значения в 19 МБ.

Специальные символы в заголовках вики-страниц

Вы можете указать заголовки страниц, содержащие один или несколько из этих специальных символов : < > * ? | -. Например, можно присвоить файлу Markdown имя "Вопросы и ответы?" или "Руководство по настройке". Символы имеют следующие строки в кодировке URI:

Знак Закодированная строка
: %3A
< %3C
> %3E
* %2A
? %3F
| %7C
- %2D
" %22
Тип ограничения Ограничение
Имя файла Полный путь к странице не должен превышать 235 символов.
Уникальность Заголовки должны именоваться с учетом регистра и быть уникальными в иерархии вики-сайта.
Специальные символы — Имя не должно содержать непечатаемых символов Юникода или заменяемых символов.
— не должен содержать следующие печатные символы: / \ : < > * ? | - #.
— не должно начинаться или заканчиваться точкой ..
— Заголовки страниц, добавленных в автономном режиме, не должны содержать пустое пространство.
Размер файла Размер не должен превышать максимального значения в 18 МБ.
Размер вложенного файла Размер не должен максимального значения в 19 МБ.