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

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

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

Общие данные

Ограничения для имен учетных записей групп в 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, или смеси этих записей.

Для информации о группах с разрешениями, распространяющимися на несколько проектов, см. раздел Создание группы уровня коллекции. Информацию о создании группы безопасности для командного проекта см. в разделе Создание группы командного проекта. Если необходимо добавить нового участника в одну из групп, ранее определенных 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.

Операционная система и 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. Члены группы будут использовать это имя коллекции командных проектов при подключении к командным проектам в Сред. Командный обозреватель. Дополнительные сведения см. в разделе Организация сервера с помощью коллекций командных проектов.

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

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

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

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

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

Тип ограничения	Ограничение
Длина	Не должна превышать 64 символов Юникода в длину
Уникальность	Не должно совпадать с каким-либо другим именем в коллекции командных проектов, веб-приложении SharePoint, которое поддерживает коллекцию, или экземпляре служб отчетов SQL Server, поддерживающем коллекцию.
Специальные символы	Не должно содержать непечатаемых знаков юникода или заменяемых символов 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)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Имена меток

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

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

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

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

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

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

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

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

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

См. также

Задачи

Создание группы уровня коллекции

Создание группы командного проекта

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

Добавление пользователя непосредственно в командный проект или коллекцию командных проектов

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

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

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

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

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

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

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

Использование меток для создания снимков файлов

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

Создание рабочей области для работы с командным проектом

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

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

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

Помещение файлов под контроль системы управления версиями

Field Reference Names

Журнал изменений

Дата	Журнал	Причина
Декабрь 2010	Обновленные сведения об ограничениях для наборов отложенных изменений и рабочих областей	Обратная связь от клиента.
Октябрь 2010	Обновленные сведения о требованиях к уникальности командных проектов.	Обратная связь от клиента.