Ограничение имен для Team Foundation Server

Обновлен: Ноябрь 2007

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

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

Общие данные

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

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

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

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

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

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

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

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

См. также

Общие данные

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

Для общей информации относительно ограничений имен файлов в операционной системе, см. "Именование файлов" (https://go.microsoft.com/fwlink/?LinkId=76838).

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

Team Foundation учетные записи групп позволяют предоставлять определенные права и разрешения группам пользователей. Эта Team Foundation группа может состоять из учетных записей пользователей Windows, учетных записей групп Windows, учетных записей групп Active Directory, учетных записей групп Team Foundation, или смеси этих записей.

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

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

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

Примечание.
Нельзя создавать учетные записи пользователей в Team Foundation Server. В некоторых случаях может понадобится добавление определенного пользователя Windows в группу Team Foundation или Team Foundation Server. Дополнительные сведения см. в разделе Практическое руководство. Добавление пользователя.

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

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

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

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

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

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

Тип ограничения	Ограничение
Длина	Недолжна превышать 64 символов юникода в длину
Уникальность	Не должно совпадать с любым другим именем в Team Foundation Server, службах Windows SharePoint или серверных службах отчетов SQL
Специальные символы	Не должно содержать непечатаемых знаков юникода или заменяемых символов 1 Имя не должно включать следующие печатные символы: / : \ ~ & % ; @ ' " ? < > | # $ * } {, + = [ ] Не должно начинаться с символа нижнего подчеркивания (_) Не должно начинаться или заканчиваться точкой (.)
Зарезервированные имена	Не должно быть именем, зарезервированным системой, как 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)

1Для дальнейшей информации о заменяемых символах, см. "Ask Dr. International, Column #18" (https://go.microsoft.com/fwlink/?LinkId=76840).

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

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

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

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

Тип ограничения	Ограничение
Размер файла	По умолчанию, ограничения размера файла, для вложения в рабочий элемент, составляет 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. При изменении имени поля, произойдут соответствующие изменения во всех проектах и рабочих элементах, содержащих измененное поле рабочего элемента.

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

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

Тип ограничения	Ограничение
Длина	Недолжна превышать 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 Build является отдельной установкой из уровня приложений Team Foundation Server, уровня данных или клиента Visual Studio. Можно указать отдельный компьютер. В противном случае можно установит вмести построение на клиентском компьютере или на серверах. Дополнительные сведения о настройке компьютера построения см. в разделе Практическое руководство. Установка и настройка Team Foundation Build.

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

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

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

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

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

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

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

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

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

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

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

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

Дополнительные сведения о системе управления версиями в Team Foundation см. в разделе Система управления версиями Team Foundation.

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

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

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

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

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

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

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

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

Имена меток

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

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

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

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

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

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

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

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

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

См. также

Задачи

Создание группы уровня сервера

Практическое руководство. Создание группы командного проекта

Добавление пользователей в группу по умолчанию

Практическое руководство. Добавление пользователя

Переименование сервера уровня приложений

Переименование сервера уровня данных

Практическое руководство. Установка и настройка Team Foundation Build

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

Практическое руководство. Задание качества построения

Практическое руководство. Добавление в систему управления версиям файлов и папок, не относящихся к проекту или решению

Практическое руководство. Изменение областей командного проекта

Практическое руководство. Изменение итераций командного проекта

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

Администрирование Team Foundation Server

Имена полей

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

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

Общие сведения о Team Foundation Build

Система управления версиями Team Foundation

Работа с метками

Работа с наборами отложенных изменений системы управления версиями

Работа с рабочими областями системы управления версиями

Ссылочные имена полей

Создание исходных областей и итераций проекта

Другие ресурсы

Устранение неполадок Team Foundation Server

Настройка типов рабочих элементов

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

Работа с определениями построений в Team Foundation Build

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