Restricciones de nomenclatura en Team Foundation

Artículo
02/20/2013

Muchos componentes de Visual Studio Team Foundation Server (TFS) 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 para los nombres 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.Para obtener más información acerca de la administración de usuarios con grupos, vea Users, groups, and permissions in Team Foundation Server deployments y Configurar usuarios, grupos y permisos.Si desea obtener ejemplos de cómo agregar un nuevo miembro a grupos utilizados en TFS, Productos de SharePoint y SQL Server Reporting Services, vea Agregar usuarios a proyectos de equipo.Si desea saber más sobre cómo comprobar los permisos de su cuenta, vea Administrar mi perfil y ver mis permisos.

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.

Restricciones de nombres de equipos

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

El sistema operativo y Active Directory 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 TFS.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 . Para obtener más información, vea TFS. 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 TFS 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 TFS en concreto.Los miembros del equipo usarán el nombre de este proyecto para conectarse al proyecto de TFS.

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 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 para los nombres de equipo

Los nombres de equipo de TFS identifican un grupo de personas o de grupos que trabajan colectivamente en equipo en un proyecto de TFS.Los miembros del equipo usarán este nombre para conectarse al equipo en Team Web Access.El nombre del equipo debe ser un nombre que se puede presentar como parte de una dirección URL válida.Además, cada nombre de equipo debe ser único dentro de un mismo proyecto, pero no hay ninguna restricción que impida utilizar el mismo nombre de equipo en distintos proyectos dentro de una colección de proyectos de equipo.Para obtener más información acerca de cómo trabajar en equipos en TFS, vea Introducción al equipo.

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

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 del proyecto
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, 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 trabajoEn 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 elemento 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 campo de los elementos de trabajo abarca una implementación completa de TFS.Si se cambia un nombre de campo, este cambio se reflejará en todos los proyectos y los tipos de elemento 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.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 de 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 elemento 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 deben estar vacías
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 compilació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 compilación; de lo contrario, se produciría un error de compilación.
Directorio de compilació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 TFS 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 compilació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 compilación

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

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

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

Nombres de calidad de la compilació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.Para obtener una lista de los valores de calidad de compilació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 compilació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 control de versiones

En la tabla siguiente se describen las restricciones de una ruta de acceso de control de versiones.

Tipo de restricción	Restricción
Longitud de la ruta de acceso de la carpeta de control de código fuente del servidor	No debe contener más de 259 caracteres Unicode para una carpeta única o nombre de archivo. No debe contener más de 388 caracteres Unicode para un directorio. No debe contener más de 399 caracteres Unicode para un directorio combinado y nombre de archivo.
Longitud de la ruta de acceso de la carpeta local	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.

Vea también: Optimizar las áreas de trabajo.

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 Configurar el equipo de desarrollo y empezar a usar el 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.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.

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 Administrar las áreas de trabajo.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: " / : < > \ \| * ?;