Ограничения именования в Team Foundation

Статья
06/09/2015

Множество компонентов в Visual Studio Team Foundation Server (TFS) имеют определенные ограничения в присваивании имен. Эти ограничения позволяют обеспечить соответствующее взаимодействие с пользователем и совместимость с другими программами. Эти ограничения могут включать длину, специальные символы, уникальность или другие атрибуты.

В этом разделе содержатся следующие подразделы:

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

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

Ограничения имен отслеживания проектов и рабочих элементов:

Имена командных проектов
Имена команд
Рабочие элементы
Настройка рабочих элементов
Шаблоны процессов

Ограничения имен для сборки и кода:

Team Foundation (подсистема контроля версий)
Team Foundation Build

Общие соображения

Ограничением по длине является максимально разрешенное количество символов юникода. Дополнительные сведения о Юникоде см. в статье "Юникод и наборы символов" (https://go.microsoft.com/fwlink/?LinkId=76837). Заменяемые символы состоят из двух символов юникода и считаются двумя символами в соответствии с ограничением.

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

Ограничения для имен учетных записей в Team Foundation Server

Учетные записи идентифицируют пользователей в TFS. Учетные записи могут быть учетными записями Windows, Active Directory или другого типа. Примеры добавления пользователей в группы, используемые в TFS, продуктах SharePoint и службах SQL Server Reporting Services, см. в разделе Добавление пользователей в командные проекты.

При добавлении пользователя в TFS имя пользователя должно соответствовать определенным ограничениям Team Foundation Server. В следующей таблице приведено описание этих ограничений.

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

Примечание

В Team Foundation Server добавляются существующие учетные записи пользователей.Создавать учетные записи пользователей в TFS нельзя.

Ограничения для имен учетных записей групп в Team Foundation Server

Team Foundation учетные записи групп позволяют предоставлять определенные права и разрешения группам пользователей. Эта Team Foundation группа может состоять из учетных записей пользователей Windows, учетных записей групп Windows, учетных записей групп Active Directory, учетных записей групп Team Foundation, или смеси этих записей. Дополнительные сведения об управлении пользователями с группами см. в разделах Пользователи, группы и разрешения в развертываниях Team Foundation Server и Управление пользователями или группами в TFS. Примеры добавления нового члена в группы, используемые в TFS, продуктах SharePoint и службах отчетов SQL Server, см. в разделе Добавление пользователей в командные проекты.

При изменении или создании учетной записи группы Team Foundation, она должна соответствовать определенным ограничениям Team Foundation Server. В следующей таблице приведено описание этих ограничений.

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

Примечание

Нельзя создавать учетные записи пользователей в Team Foundation Server.

Ограничения для имен компьютеров

Во время процесса установки TFS имя компьютера ассоциируется с именем сервера.

Операционная система и Active Directory определяют некоторые ограничения имен компьютеров. Дополнительные сведения о переименовании компьютера см. в статье "Переименование компьютера" (https://go.microsoft.com/fwlink/?LinkId=76839). Дополнительные сведения об Active Directory см. в статье "Windows Server 2003 Active Directory" (https://go.microsoft.com/fwlink/?LinkId=47541).

Ограничения для имен коллекций командных проектов

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

В следующей таблице приведено описание этих ограничений для имен коллекций.

Тип ограничения	Ограничение
Длина	Не должна превышать 64 символов Юникода в длину
Уникальность	Не должна совпадать с именем другой коллекции в развертывании Team Foundation Server. Если развертывание включает Продукты SharePoint или службы отчетов SQL Server, то не должна совпадать с именем и полным путем к существующему сайту SharePoint, серверу отчетов или веб-сайту служб отчетов.
Специальные символы	Не должна содержать непечатаемых символов Юникода или заменяемых символов. Имя не должно включать следующие печатные символы: / : \ ~ & % ; @ ' " ? < > \| # $ * } { , + = [ ] Не должна включать многоточие (...) или двойную точку (..). Не должно начинаться с символа нижнего подчеркивания (_) Не должно начинаться или заканчиваться точкой (.)
Зарезервированные имена	Не должна быть именем, зарезервированным системой, как PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON, AUX, Web или WEB. Дополнительные сведения об зарезервированных именах см. на странице веб-сайта Майкрософт: Имена файлов, пути и пространства имен.

Ограничения для имен проектов

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

В следующей таблице приведено описание этих ограничений для имен проектов.

Тип ограничения	Ограничение
Длина	Не должна превышать 64 символов Юникода в длину
Уникальность	Не должно совпадать с каким-либо другим именем в коллекции командных проектов, веб-приложении SharePoint, которое поддерживает коллекцию, или экземпляре служб отчетов SQL Server, поддерживающем коллекцию.
Специальные символы	Не должна содержать непечатаемых знаков Юникода или заменяемых символов. Имя не должно включать следующие печатные символы: / : \ ~ & % ; @ ' " ? < > \| # $ * } { , + = [ ] Не должна включать многоточие (...) или двойную точку (..). Не должно начинаться с символа нижнего подчеркивания (_) Не должно начинаться или заканчиваться точкой (.)
Зарезервированные имена	Не должно быть именем, зарезервированным системой, как PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON или AUX Дополнительные сведения о зарезервированных именах см. в статье Именование файлов, путей и пространств имен.

Ограничения для имен команд

Имена команд в TFS определяют группу отдельных лиц или групп, которые работают вместе как команда в проекте. Члены команды будут использовать это имя для подключения к команде в Team Web Access. Имя команды должно быть таким, чтобы его можно было представить как часть допустимого URL-адреса. Кроме того, в одном проекте все имена команд должны быть уникальны. Нет ограничений на использование одинаковых имен команд в разных проектах коллекции командных проектов. Дополнительные сведения о работе в командах см. в разделе Добавление команды или иерархии команд.

В следующей таблице перечислены ограничения для имен команд.

Тип ограничения	Ограничение
Длина	Не должна превышать 64 символов Юникода в длину
Уникальность	Не должны совпадать ни с каким другим именем в проекте.
Специальные символы	Не должна содержать непечатаемых знаков Юникода или заменяемых символов. Имя не должно включать следующие печатные символы: / : \ ~ & % ; @ ' " ? < > \| # $ * } { , + = [ ] Не должна включать многоточие (...) или двойную точку (..). Не должно начинаться с символа нижнего подчеркивания (_) Не должно начинаться или заканчиваться точкой (.)
Зарезервированные имена	Не должно быть именем, зарезервированным системой, как PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON или AUX Дополнительные сведения о зарезервированных именах см. в статье Именование файлов, путей и пространств имен.

Ограничения для рабочих элементов

Microsoft Visual Studio Application Lifecycle Management отслеживает ход выполнения проекта с помощью таких элементов, как ошибки, требования, задачи и риски. Эти элементы обычно называются рабочими элементами. В этом разделе описаны ограничения данных, хранимых в рабочих элементах.

Ограничения для вложений рабочих элементов

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

Тип ограничения	Ограничение
Размер файла	По умолчанию, ограничения размера файла, для вложения в рабочий элемент, составляет 4 096 килобайт. Это значение может быть изменено Team Foundation администратором. Максимальный размер, который может быть указан администратором – 2 гигабайта. Размер по умолчанию — 4 096 килобайт Максимальный размер – 2 гигабайта

Размер файла

По умолчанию, ограничения размера файла, для вложения в рабочий элемент, составляет 4 096 килобайт. Это значение может быть изменено Team Foundation администратором. Максимальный размер, который может быть указан администратором – 2 гигабайта.
Размер по умолчанию — 4 096 килобайт
Максимальный размер – 2 гигабайта

Ограничения областей рабочих элементов и итераций

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

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

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

Ограничение для настройки рабочих элементов

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

Администраторы командных проектов могут принимать решения изменения определения типа рабочего элемента на уровне проекта или в шаблоне процесса. Дополнительные сведения о настройке типов рабочих элементов см. в разделе Настройка объектов отслеживания работ для поддержки командных процессов. В этой части описаны ограничения, с которыми придется столкнуться при настройке рабочих элементов и связанных с ними элементов.

Ограничения для имен полей рабочих элементов

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

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

Тип ограничения	Ограничение
Длина	Не должна превышать 128 символов Юникода в длину
Специальные символы	Не должно содержать начальные или конечные пробелы Не должно содержать последовательных пробелов Не должно содержать точки (.) Не должно содержать открывающую или закрывающую квадратные скобки ([ ])
Область	Имена полей рабочих элементов действуют во всем развертывании TFS. При изменении имени поля, произойдут соответствующие изменения во всех проектах и рабочих элементах, содержащих измененное поле рабочего элемента.

Ограничения для ссылочных имен полей рабочих элементов

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

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

Ограничения для пояснительного текста полей рабочих элементов

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

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

Тип ограничения	Ограничение
Длина	Не должна превышать 255 символов Юникода в длину
Область	В отличии от имени и типа поля, пояснительный текст рассматривается в рамках определенного рабочего элемента в определенном командном проекте.

Ограничения для глобальных списков

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

Глобальный список (GLOBALLIST) содержит один или больше элементов списка (элементы LISTITEM).

В следующей таблице приведено описание этих ограничений для элементов списка.

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

В следующей таблице приведено описание ограничений для глобального списка.

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

Ограничения для шаблонов процессов

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

В следующей таблице приведены ограничения для шаблонов процесса.

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

Ограничение построения для Team Foundation Server

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

Ограничения компьютера сборки

Team Foundation Build является отдельной установкой из уровня приложений Team Foundation Server, уровня данных или клиента Visual Studio. Можно указать отдельный компьютер. В противном случае можно установит вмести построение на клиентском компьютере или на серверах.

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

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

Имена типов сборки

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

В следующей таблице описаны ограничения для имен типов построения.

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

Имена качества сборки

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

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

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

Ограничения для системы управления версиями

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

Пути системы управления версиями

В следующей таблице перечислены ограничения для пути системы управления версиями.

Тип ограничения	Ограничение
Длина пути папки сервера системы управления версиями	Не должна превышать 259 символов юникода для одного каталога или имени файла. Не должна превышать 388 символов юникода в длину для каталога. Не должна превышать 399 символов юникода в длину для каталога с именем файла.
Длина пути локальных папок	Не должна превышать 248 символов юникода в длину для каталога. Не должна превышать 260 символов юникода в длину для каталога с именем файла.

См. также: Оптимизация рабочей области.

Добавление файлов в систему управления версиями

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

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

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

Папки и файлы

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

Имена файлов

Не должно начинаться с символа $
Имя не должно включать следующие печатные символы: "/ \ : * ? " < > | ;

Имена меток

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

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

Наборы отложенных изменений

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

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

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

Имена рабочих областей

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

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