Restricciones de nomenclatura en Team Foundation

Muchos componentes de Visual Studio Team Foundation Server tienen algunas restricciones de nomenclatura. Estas restricciones ayudan a garantizar una experiencia del usuario coherente y proporcionan compatibilidad con otros programas. Estas restricciones pueden incluir longitud, caracteres especiales, exclusividad u otros atributos.

Este tema contiene las siguientes subsecciones:

Consideraciones comunes

Restricciones de nombres de cuentas de grupo de Team Foundation Server

Restricciones de nombres de equipos

Restricciones para los nombres de colecciones de proyectos de equipo

Restricciones para los nombres de proyectos de equipo

Restricciones de elementos de trabajo

Restricciones de personalizaciones de elementos de trabajo

Restricciones de las plantillas de procesos

Restricciones de Team Foundation Build

Restricciones de control de versiones

Vea también

Consideraciones comunes

El número de caracteres Unicode permitido evalúa las restricciones de longitud de este tema. Para obtener más información sobre Unicode, vea "About Unicode and Character Sets" (https://go.microsoft.com/fwlink/?LinkId=76837). Los caracteres suplentes están formados por dos caracteres Unicode, que se contarán como dos caracteres en la restricción de longitud.

Como sucede con otros archivos del sistema operativo, tampoco se permiten los caracteres de control ASCII (ASCII 1-31) y las combinaciones de caracteres suplentes. Para obtener información general sobre las restricciones del sistema operativo aplicadas a los nombres de archivo, vea "Naming a File" (https://go.microsoft.com/fwlink/?LinkId=76838).

Restricciones de nombres de cuentas de grupo de Team Foundation Server

Las cuentas del grupo de Team Foundation permiten aplicar algunos derechos o permisos a un grupo de usuarios. Este grupo de Team Foundation puede estar formado por las cuentas de usuario de Windows, las de grupo de Windows, las de grupo de Active Directory, las de grupo de Team Foundation o cualquier combinación de estos tipos.

Si desea crear un grupo que tenga permisos en varios proyectos, vea Crear un grupo de nivel de colección. Si desea crear un grupo de seguridad para su proyecto de equipo, vea Crear un grupo de proyectos de equipo. Si desea agregar un nuevo miembro a uno de los grupos predefinidos mediante Team Foundation Server, vea Agregar usuarios a proyectos de equipo.

Cuando se crea o modifica una cuenta de grupo de Team Foundation, ésta debe cumplir determinadas restricciones de Team Foundation Server. En la tabla siguiente se describen estas restricciones.

Tipo de restricción	Restricción
Longitud del nombre de la cuenta de grupo	No debe contener más de 256 caracteres Unicode
Unicidad (cuentas de grupo de nivel de colección)	No debe coincidir con ningún otro nombre de cuenta de grupo en la colección de proyectos de equipo
Unicidad (cuentas de grupo de nivel de proyecto)	No debe coincidir con ningún otro nombre de grupo del mismo proyecto
Nombres de grupo reservados	No se debe denominar $NAMESPACE ni en el proyecto ni en el nivel del servidor
Restricciones de caracteres especiales	No debe incluir los caracteres siguientes imprimibles: "/ \ [ ] : | < > + = ; ? * * No debe incluir caracteres no imprimibles en el intervalo de valores ASCII del 1 al 31 No debe finalizar en punto (.) No debe incluir comas (,)

Nota

No cree cuentas de usuario en Team Foundation Server. En algunos casos, quizá desee agregar un usuario específico de Windows a un grupo de Team Foundation o al propio Team Foundation Server. Para obtener más información, vea Agregar un usuario directamente a un proyecto de equipo o una colección de proyectos de equipo.

Restricciones de nombres de equipos

Durante el proceso de instalación de Team Foundation Server, el nombre del equipo se asocia al nombre del servidor de Team Foundation.

El sistema operativo y Active Directory de Windows Server 2003 imponen determinadas restricciones en cuanto a nombres de equipo. Para obtener más información sobre cómo cambiar el nombre de un equipo, vea "Rename a Computer" (https://go.microsoft.com/fwlink/?LinkId=76839). Para obtener más información acerca de Active Directory, vea "Windows Server 2003 Active Directory" (https://go.microsoft.com/fwlink/?LinkId=47541).

Restricciones para los nombres de colecciones de proyectos de equipo

El nombre de una colección de proyectos de equipo identifica una agrupación de proyectos de equipo y los recursos que están asociados a esos proyectos. Una colección de proyectos de equipo es una estructura organizativa que se puede usar para definir y controlar un conjunto de proyectos de equipo en Team Foundation Server. Los miembros del equipo utilizarán el nombre de la colección de proyectos de equipo cuando se conecten a los proyectos de equipo en Team Explorer. Para obtener más información, vea Organizar el servidor con colecciones de proyectos de equipo.

En la tabla siguiente, se describen las restricciones para los nombres de colecciones.

Tipo de restricción	Restricción
Longitud	No debe contener más de 64 caracteres Unicode
Exclusividad	No debe ser idéntico a ningún otro nombre de colección en su implementación de Team Foundation Server. Si su implementación incluye Productos de SharePoint o SQL Server Reporting Services, no debe ser idéntico al nombre y la ruta de acceso completa de ningún sitio de SharePoint, servidor de informes o sitio web de Reporting Services existente.
Caracteres especiales	No debe contener caracteres de control Unicode ni caracteres suplentes. No debe contener los caracteres siguientes imprimibles: / : \ ~ & % ; @ ' " ? < > | # $ * } { , + = [ ] < > | # $ * } { , + = [ ] No debe contener puntos suspensivos (…) ni un punto doble (..) No debe empezar por un carácter de subrayado (_) No debe empezar ni finalizar en punto (.)
Nombres reservados	No deben ser nombres reservados del sistema, como PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON, AUX, Web o WEB Para obtener más información sobre los nombres reservados, vea esta página en el sitio web de Microsoft: File Names, Paths, and Namespaces.

Restricciones para los nombres de proyectos

Los nombres de proyecto de Team Foundation Server identifican una colección de elementos de trabajo, documentos, informes, compilaciones de equipo y un árbol de control de versiones que constituyen un proyecto de Team Foundation en concreto. Los miembros del equipo usarán el nombre de este proyecto para conectarse al proyecto de Team Foundation Server.

En la tabla siguiente, se describen las restricciones de los nombres de proyecto.

Tipo de restricción	Restricción
Longitud	No debe contener más de 64 caracteres Unicode
Exclusividad	No debe ser idéntico a ningún otro nombre de la colección de proyectos de equipo, la aplicación web de SharePoint que admite la colección o la instancia de SQL Server Reporting Services que admite la colección
Caracteres especiales	No debe contener caracteres de control Unicode ni caracteres suplentes 1 No debe contener los caracteres siguientes imprimibles: / : \ ~ & % ; @ ' " ? < > | # $ * } { , + = [ ] < > | # $ * } { , + = [ ] No debe contener puntos suspensivos (…) ni un punto doble (..) No debe empezar por un carácter de subrayado (_) No debe empezar ni finalizar en punto (.)
Nombres reservados	No deben ser nombres reservados del sistema, como PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON, or AUX Para obtener información sobre nombres reservados, vea "Naming a File" (https://go.microsoft.com/fwlink/?LinkId=76838)

Restricciones de elementos de trabajo

Microsoft Visual Studio Application Lifecycle Management realiza el seguimiento del progreso de un proyecto mediante elementos como errores, requisitos, tareas y riesgos. Estos elementos se conocen genéricamente como elementos de trabajo. En esta sección se describen las restricciones en los datos almacenados en los elementos de trabajo.

Restricciones de los datos adjuntos del elemento de trabajo

Se pueden adjuntar archivos a los elementos de trabajo En la tabla siguiente, se describen las restricciones de los datos adjuntos de estos elementos.

Tipo de restricción	Restricción
Tamaño de archivo	De forma predeterminada, el tamaño de los datos adjuntos del elemento de trabajo es 4.096 kilobytes. El administrador de Team Foundation puede cambiar este valor. El tamaño máximo que puede establecer el administrador es de 2 gigabytes. Tamaño predeterminado: 4.096 kilobytes Tamaño máximo: 2 gigabytes

Restricciones de áreas de elementos de trabajo e iteraciones

Los elementos de trabajo contienen un campo para el Área del proyecto y otro para la Iteración del proyecto. Se utilizan para organizar y mostrar los elementos de trabajo en grupos lógicos.

El Área del proyecto y la Iteración del proyecto son rutas de acceso formadas por muchos elementos de nodo separados por caracteres de barra diagonal inversa (\). El administrador de Team Foundation Server define los nodos para reflejar las áreas y el ciclo del proyecto. En la tabla siguiente, se describen las restricciones de los nodos y las rutas de acceso.

Tipo de restricción	Restricción
Longitud de nodo	No debe contener más de 255 caracteres
Caracteres especiales de los nodos	No debe contener caracteres de control Unicode No debe contener ninguno de los siguientes caracteres: \ / $ ? * : " & > < # % | * : " & > < # % | No debe contener caracteres prohibidos por el sistema de archivos local. Para obtener más información sobre restricciones de caracteres de Windows, vea "Naming a File" (https://go.microsoft.com/fwlink/?LinkId=76838)
Nombres reservados	No deben estar formados solo por un punto (.) ni por dos puntos (..) No deben ser nombres reservados del sistema, como PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON, or AUX Para obtener información sobre nombres reservados, vea "Naming a File" (https://go.microsoft.com/fwlink/?LinkId=76838)
Longitud de la ruta de acceso	No debe contener más de 4000 caracteres Unicode
Profundidad de jerarquía de la ruta de acceso	No debe tener una profundidad que sobrepase los 14 niveles

Restricciones de personalizaciones de elementos de trabajo

Team Foundation Server realiza el seguimiento del progreso de un proyecto mediante elementos como errores, requisitos, tareas y riesgos. Estos elementos se conocen genéricamente como elementos de trabajo.

Los administradores de los proyectos de equipo pueden decidir cambiar las definiciones de tipo de elemento de trabajo del nivel de proyecto o en una plantilla de proceso. Para obtener más información sobre cómo personalizar los tipos de elementos de trabajo, vea Personalizar datos de seguimiento, formularios, flujos de trabajo y otros objetos de proyecto. En esta sección, se describen las restricciones con las que se encontrará cuando personalice elementos de trabajo y sus elementos asociados.

Restricciones de nombres de campos de elementos de trabajo

Cada tipo de elemento de trabajo contiene uno o más campos de elementos de trabajo. Estos campos definen la información almacenada en un tipo de elemento de trabajo. Un nombre de campo de elemento de trabajo identifica exclusivamente un campo de elemento de trabajo.

En la tabla siguiente, se describen las restricciones de los nombres de campos de elementos de trabajo.

Tipo de restricción	Restricción
Longitud	No debe contener más de 128 caracteres Unicode
Caracteres especiales	No debe contener espacios iniciales ni finales No debe contener dos o más espacios consecutivos No debe contener puntos (.) No debe contener corchetes de apertura ni de cierre ([])
Ámbito	El ámbito de los nombres de campos de elementos de trabajo es el servidor completo de Team Foundation. Si se cambia un nombre de campo, este cambio se reflejará en todos los proyectos y los tipos de elementos de trabajo que contengan ese campo de elemento de trabajo.

Restricciones de referencias de campos de elementos de trabajo

Cada campo de elemento de trabajo tiene un nombre de referencia de campo asociado. Este nombre de referencia identifica exclusivamente un campo y no se puede cambiar una vez asignado. Para obtener más información sobre los nombres de referencia de campos, vea Field Reference Names. En la tabla siguiente, se describen las restricciones aplicadas a los nombres de referencia de campo.

Tipo de restricción	Restricción
Longitud	No debe contener más de 70 caracteres Unicode
Caracteres especiales	No debe contener guiones (-) Debe contener al menos un punto (.) No debe empezar ni finalizar en punto (.) No debe empezar por un número No debe empezar por un carácter de subrayado (_)
Exclusividad	No debe ser idéntico a ningún otro nombre de referencia de campo de Team Foundation Server No debe ser idéntico a ningún otro nombre de referencia de campo después de que lo procese el equipo para reemplazar todos los puntos (.) por caracteres de subrayado (_) Por ejemplo, los nombres de referencia de campos Mi._campo y Mi_.campo los procesaría el equipo con el mismo nombre: Mi__campo

Restricciones del texto de ayuda de los campos de elementos de trabajo

Como opción, puede asociar el texto de ayuda con campos de elementos de trabajo mediante la etiqueta <HELPTEXT>. El sistema muestra este texto en tiempo de ejecución para que los usuarios sepan qué valor deben especificar en el campo. Para obtener más información sobre el texto de ayuda de los campos de elementos de trabajo, vea Definir el texto de ayuda para un campo de elemento de trabajo.

En la tabla siguiente, se describen las restricciones del texto de ayuda de los campos de elementos de trabajo.

Tipo de restricción	Restricción
Longitud	No debe contener más de 255 caracteres Unicode
Ámbito	A diferencia del nombre y tipo de campo, el campo del texto de ayuda se incluye en el ámbito de un tipo de elemento de trabajo específico de un proyecto de equipo.

Restricciones de las listas globales

Una lista global es un conjunto de valores de elementos de lista que se almacena y se usa globalmente en todos los servidores de Team Foundation de una implementación de Team Foundation Server. Cuando defina tipos de elemento de trabajo, puede que se dé cuenta de que algunos campos de los elementos de trabajo comparten el mismo conjunto de valores posibles. Las listas globales permiten definir estos valores una vez y compartirlos entre varios tipos de elementos de trabajo. Para obtener más información, vea Definir listas globales.

Una lista global (GLOBALLIST) contiene uno o más elementos de lista (elementos LISTITEM ).

En la tabla siguiente, se describen las restricciones de los elementos de lista.

Tipo de restricción	Restricción
Longitud	No debe contener más de 254 caracteres Unicode No debe estar vacío
Caracteres especiales	No debe contener espacios iniciales ni finales No debe contener dos espacios consecutivos No debe contener caracteres de barra diagonal inversa (\)
Ámbito	Puesto que todos los proyectos tienen acceso a las listas, no deben contener elementos definidos de nivel de proyecto, como definiciones de cuentas de grupo específicas del proyecto.

En la tabla siguiente, se describen las restricciones que se aplican a una lista global.

Tipo de restricción	Restricción
Número de elementos	La lista global no debe estar vacía. Debe contener al menos un elemento LISTITEM.
Exclusividad	El nombre de la lista global no debe ser idéntico a ningún otro nombre de la lista global de Team Foundation Server.

Restricciones de las plantillas de procesos

Una plantilla de procesos es un conjunto de elementos de trabajo, consultas de elementos de trabajo, plantillas de producto, informes, grupos de seguridad y guía predeterminados que afectan a la estructura de un proyecto en Team Foundation. Team Foundation Server incluye dos plantillas de procesos predeterminadas que abarcan dos estilos diferentes para administrar el ciclo del software. Estas plantillas se pueden personalizar para reflejar las necesidades específicas de la organización. Para obtener más información, vea Personalizar plantillas de procesos.

En la tabla siguiente, se describen las restricciones de las plantillas de procesos.

Tipo de restricción	Restricción
Longitud del nombre de la plantilla de proceso	No debe contener más de 256 caracteres Unicode.
Exclusividad del nombre de la plantilla de proceso	Debe ser único en el servidor de Team Foundation. Si descarga una plantilla con el mismo nombre de una plantilla existente, se sobrescribirá esta última.
Tamaño de archivo de las plantillas de procesos	El tamaño de archivo de las plantillas de procesos no debe sobrepasar los 2 GB (gigabytes).

Restricciones de Team Foundation Build

Team Foundation Build permite administrar todos los aspectos del proceso de compilación en un equipo único. Si usa Team Foundation Build, puede sincronizar el código fuente, compilar la aplicación, ejecutar las pruebas unitarias asociadas, realizar análisis de código, lanzar generaciones en un servidor de archivos y publicar informes de generación.

Restricciones del equipo de compilación

Team Foundation Build es una instalación independiente de la capa de aplicación de Team Foundation Server, de la capa de datos o del cliente de Visual Studio. Puede designar otro equipo. De lo contrario, puede realizar la instalación de generación en paralelo en el cliente o en otros servidores.

En la siguiente tabla se describen las restricciones del equipo de compilación.

Tipo de restricción	Restricción
Espacio en disco	Debe disponer de espacio en disco suficiente para la generación; de lo contrario, se produciría un error de generación.
Directorio de generación	Debe ser una ruta de acceso local (por ejemplo, C: \builddirectory).
Directorio de la ubicación de destino	Debe ser una ruta de acceso UNC (por ejemplo, \\server\share).
Permisos de la ubicación de destino	Cada generación compilada se coloca en un nuevo directorio de la carpeta de destino. La cuenta de servicio de Team Foundation Server (por ejemplo, Dominio\TFSSERVICE) debe tener permiso de acceso de control total a la ubicación de destino de UNC. La ubicación de destino de UNC debe ser una carpeta compartida.
Cuenta de servicio de Team Foundation Build	Si cambia la cuenta de servicio de Team Foundation Server después de la instalación inicial, debe asegurarse de que se cumplen las condiciones siguientes. La cuenta es miembro del grupo de Build Services. La cuenta tiene los permisos de lectura y escritura en las carpetas temporales y de ASP.NET. La cuenta tiene el permiso de control total en el directorio de generación y en la ubicación de destino.
Problemas del firewall	Si el equipo de compilación está habilitado para firewall, asegúrese de que tfsbuildservice está en la lista de excepciones.

Nombres de tipo de generación

Team Foundation Build utiliza tipos de generación para configurar las condiciones en las que se genera una solución única o un conjunto de soluciones en un proyecto de equipo. Para realizar una generación, debe crear un nuevo tipo de generación o utilizar un tipo de generación existente. Para obtener más información sobre los tipos de generación, vea Definir el proceso de compilación.

En la tabla siguiente, se describen las restricciones de los nombres de tipo de generación.

Tipo de restricción	Restricción
Exclusividad	No debe ser igual a ningún otro nombre de tipo de generación del proyecto
Caracteres especiales	No debe contener el carácter imprimible siguiente: $

Nombres de calidad de la generación

La calidad de compilación permite asociar un nivel de calidad o estado de finalización a una compilación completada. Team Foundation Build también permite crear nuevos valores para el tipo de calidad de compilación. Para obtener más información, vea Crear una definición de compilación básica. Para obtener una lista de los valores de calidad de generación predeterminados, vea Valorar la calidad de una compilación completada.

En la tabla siguiente, se describen las restricciones de los nombres de calidad de generación.

Tipo de restricción	Restricción
Longitud	No debe contener más de 256 caracteres Unicode
Exclusividad	No debe ser igual a ningún otro nombre de calidad de compilación en el equipo de Team Foundation Build

Restricciones de control de versiones

El control de versiones de Team Foundation proporciona un repositorio central de los archivos y los comandos necesarios para administrar esos archivos en un equipo. Además, proporciona directivas de protección personalizables, bifurcación, combinación, aplazamiento de cambios y muchas características más.

Rutas de acceso al servidor de control de versiones

La ruta de acceso al servidor de control de versiones es la ubicación de la ruta de acceso completa de un archivo almacenado en control de versiones.

En la tabla siguiente se describen las restricciones de longitud de la ruta de acceso al servidor de control de versiones.

Tipo de restricción	Restricción
Longitud	No debe contener más de 248 caracteres Unicode para un directorio. No debe contener más de 260 caracteres Unicode para un directorio combinado y nombre de archivo.

Agregar archivos al control de versiones

El sistema de control de versiones almacena muchos tipos diferentes de archivos. Para obtener más información sobre cómo agregar proyectos de Visual Studio existentes o soluciones al control de versiones, vea Colocar archivos bajo el control de versiones. También puede agregar archivos o carpetas que no estén asociadas a ningún proyecto o solución de Visual Studio. Para obtener más información, vea Agregar archivos y carpetas que no son de proyecto ni de solución al control de versiones.

En la tabla siguiente se describen las restricciones aplicadas a los archivos y carpetas que se van a agregar al control de versiones.

Tipo de restricción	Restricción
Extensión de archivo	No debe contener los caracteres imprimibles siguientes: / \ : * ? " < > | " < > |
Carpetas	No deben estar vacías No deben contener archivos con cambios pendientes No deben residir fuera del directorio asignado para el área de trabajo activa

Nombres de etiqueta

En el control de versiones de Team Foundation, una etiqueta es un nombre aplicado a un conjunto concreto de revisiones. Puede adjuntar etiquetas a un conjunto de archivos no relacionados en el control de versiones. De esta forma, puede recupera los archivos o trabajar con ellos como si fuesen un grupo. Para obtener más información, vea Uso de etiquetas para hacer una captura de los archivos. En la tabla siguiente, se describen las restricciones de los nombres de etiqueta.

Tipo de restricción	Restricción
Longitud	No debe contener más de 64 caracteres Unicode
Caracteres especiales	No puede finalizar en espacios ( ) ni puntos (.) No debe contener los caracteres imprimibles siguientes: " / : < > \ | * ? @

Conjuntos de cambios aplazados

Los conjuntos de cambios aplazados le permiten apartar temporalmente un lote de cambios pendientes y quitar, opcionalmente, los cambios pendientes del área de trabajo. Después, puede restaurar los cambios en un conjunto de cambios aplazados en el área de trabajo o colocarlos en el área de trabajo de otro usuario. Para obtener más información, vea Trabajar con conjuntos de cambios aplazados.

En la tabla siguiente, se describen las restricciones de nombres de conjuntos de cambios aplazados.

Tipo de restricción	Restricción
Longitud	No debe contener más de 64 caracteres Unicode
Caracteres especiales	No debe contener los caracteres imprimibles siguientes: " / : < > \ | * ? ;

Nombres del área de trabajo

Un área de trabajo es la copia del lado cliente de los archivos y carpetas en control de versiones de Team Foundation. Al crear varias áreas de trabajo, puede tener versiones diferentes de la misma carpeta de control de versiones en un equipo cliente. Para obtener más información sobre áreas de trabajo, vea Crear un área de trabajo para trabajar con el proyecto de equipo. En la tabla siguiente, se describen las restricciones de nombres de las áreas de trabajo.

Tipo de restricción	Restricción
Longitud	No debe contener más de 64 caracteres Unicode
Caracteres especiales	No puede finalizar con un espacio ( ) No debe contener los caracteres imprimibles siguientes: " / : < > \ | * ? ;

Vea también

Tareas

Crear un grupo de nivel de colección

Crear un grupo de proyectos de equipo

Agregar usuarios a un grupo predeterminado

Agregar un usuario directamente a un proyecto de equipo o una colección de proyectos de equipo

Crear una definición de compilación básica

Valorar la calidad de una compilación completada

Agregar archivos y carpetas que no son de proyecto ni de solución al control de versiones

Conceptos

Personalizar datos de seguimiento, formularios, flujos de trabajo y otros objetos de proyecto

Definir el texto de ayuda para un campo de elemento de trabajo

Definir listas globales

Uso de etiquetas para hacer una captura de los archivos

Trabajar con conjuntos de cambios aplazados

Crear un área de trabajo para trabajar con el proyecto de equipo

Otros recursos

Personalizar plantillas de procesos

Definir el proceso de compilación

Colocar archivos bajo el control de versiones

Field Reference Names

Historial de cambios

Fecha	Historial	Motivo
Diciembre de 2010	Información actualizada sobre las restricciones en los nombres de conjuntos de cambios aplazados y áreas de trabajo.	Comentarios de los clientes.
Octubre de 2010	Información actualizada sobre la unicidad necesaria para los nombres de proyectos de equipo.	Comentarios de los clientes.