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

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

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

Общие данные

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

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

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

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

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

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

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

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

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

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

См. также

Общие данные

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

Как и в других файлах операционной системы, также нельзя использовать управляющие символы в кодировке ASCII (ASCII 1-31) и заменяемые комбинации.Для общей информации относительно ограничений имен файлов в операционной системе, см. "Именование файлов" (https://go.microsoft.com/fwlink/?LinkId=76838).

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

Team Foundation учетные записи групп позволяют предоставлять определенные права и разрешения группам пользователей.Эта Team Foundation группа может состоять из учетных записей пользователей Windows, учетных записей групп Windows, учетных записей групп Active Directory, учетных записей групп Team Foundation, или смеси этих записей.Дополнительные сведения об управлении пользователями с помощью групп см. в разделах Users, groups, and permissions in Team Foundation Server deployments и Настройка пользователей, групп и разрешений.Если требуются примеры добавления нового члена в группы, используемые в Team Foundation Server, службах Продукты 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 Дополнительные сведения об зарезервированных именах см. в разделе "Именование файлов" (https://go.microsoft.com/fwlink/?LinkId=76838)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Тип ограничения	Ограничение
Длина	Не должна превышать 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 (например, Domain\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 метка — это имя, присваиваемое конкретному набору редакций.Метки можно присваивать набору несвязанных файлов в системе управления версиями.Это позволяет извлекать файлы или работать с ними, как с группой.В следующей таблице описаны ограничения для имен ярлыков.

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

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

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

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

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

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

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

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

См. также

Задачи

Создание определения построения

Оценка качества завершенного построения

Основные понятия

Настройка данных отслеживания, форм, рабочего процесса и других объектов для проекта

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

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

Настройка шаблонов процессов

Определение процесса построения

Управление рабочими областями