Compartir a través de

Restricciones de nomenclatura para Team Foundation Server

  • Artículo

Actualización: noviembre 2007

Muchos componentes de Team Foundation Server siguen algunas restricciones de nomenclatura. De esta forma, se garantiza una experiencia del usuario coherente y se proporciona 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 de nombres de proyectos de Team Foundation Server

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 código fuente

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.

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 Cómo: Crear un servidor de grupo de nivel de servidor. Si desea crear un grupo de seguridad para su proyecto de equipo, vea Cómo: Crear un grupo de proyecto de equipo. Si desea agregar un nuevo miembro a uno de los grupos predefinidos mediante Team Foundation Server, vea Cómo: Agregar usuarios a un grupo predeterminado.

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

Exclusividad (cuentas del grupo de nivel de servidor)

  • No debe ser idéntico a ningún otro nombre de cuenta del grupo de nivel de servidor

Exclusividad (cuentas del grupo de proyectos)

  • No debe ser idéntico a 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 Cómo: Agregar un usuario.

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. Para cambiar el nombre de un servidor de Team Foundation, debe seguir los procedimientos descritos en Cómo: Renombrar un servidor de nivel de aplicación o Cómo: Cambiar el nombre de un servidor de nivel de datos.

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 de nombres de proyectos de Team Foundation Server

El nombre de proyecto de Team Foundation Server identifica una colección de elementos, documentos, informes, generaciones de equipos de trabajo y un árbol de control de código fuente 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éntica a ningún otro nombre de Team Foundation Server, Windows SharePoint Services ni SQL Server Reporting Services

Caracteres especiales

  • No debe contener caracteres de control Unicode ni caracteres suplentes 1

  • No debe contener los caracteres siguientes imprimibles: / : \ ~ & % ; @ ' " ? < > | # $ * } { , + = [ ] < > | # $ * } { , + = [ ]

  • 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)

1Para obtener más información sobre caracteres suplentes, vea "Ask Dr. International, Column #18" (https://go.microsoft.com/fwlink/?LinkId=76840).

Restricciones de elementos de trabajo

Microsoft Visual Studio Team System 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 datos adjuntos de elementos de trabajo

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

Tipo de restricción

Restricción

Tamaño de archivo

  • De forma predeterminada, el tamaño del archivo adjunto 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. Para obtener más información, vea Establecer un tamaño límite para los archivos adjuntos.

  • 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. Para obtener más información, vea Establecer iteraciones o áreas de proyecto iniciales. 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 sólo 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 tipos de elemento de trabajo. 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. Para obtener más información sobre los nombres de campos de elementos de trabajo, vea Nombres de campo.

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 Nombres de referencia de campos. 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 del campo.

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 en todos los servidores de Team Foundation de una implementación de Team Foundation Server y se usa globalmente. 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 le permiten definir estos valores una vez y compartirlos entre varios tipos de elementos de trabajo. Para obtener más información, vea 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 proceso es un conjunto de elementos de trabajo, consultas de elementos de trabajo, plantillas de productos, informes, grupos de seguridad e instrucciones predeterminados que influyen en la estructura de un proyecto de Team Foundation. Team Foundation Server incluye dos plantillas de procesos predeterminadas con dos estilos diferentes para administrar el ciclo de vida 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 le permite administrar todos los aspectos del proceso de generació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. Para obtener más información, vea Información general sobre Team Foundation Build.

Restricciones del equipo de compilación

Team Foundation Build es una instalación independiente del nivel de aplicación de Team Foundation Server, del nivel de datos o del cliente de Visual Studio. Puede designar otro equipo. De lo contrario, puede realizar la instalación de generación en el cliente o en otros servidores. Para obtener más información sobre cómo instalar un equipo de compilación, vea Cómo: Configurar e instalar Team Foundation Build

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 del servicio de Team 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 Trabajar con definiciones de compilación en Team Foundation Build.

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 realización a una compilación finalizada. Team Foundation Build también permite crear nuevos valores para el tipo de calidad de compilación. Para obtener más información, vea Cómo: Crear una definición de compilación. Para obtener una lista de los valores de calidad de generación predeterminados, vea Cómo: Establecer la calidad de la compilación.

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 código fuente

El control de código fuente de Team Foundation proporciona un repositorio central de los archivos y los comandos que requieren que se administren 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.

Para obtener más información sobre control de código fuente de Team Foundation, vea Control de versiones de Team Foundation.

Rutas de acceso al servidor de control de código fuente

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

En la tabla siguiente, se describen las restricciones de longitud de la ruta de acceso al servidor de control de código fuente.

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 en el control de código fuente

El sistema de control de código fuente almacena muchos tipos diferentes de archivos. Para obtener más información sobre cómo agregar proyectos de Visual Studio existentes o soluciones en el control de código fuente, vea Agregar proyectos y soluciones al 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 Cómo: 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 código fuente.

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 código fuente de Team Foundation, una etiqueta es un nombre aplicado a un conjunto concreto de revisiones. Puede asociar las etiquetas a un conjunto de archivos no relacionados en el control de código fuente. De esta forma, puede recupera los archivos o trabajar con ellos como si fuesen un grupo. Para obtener más información, vea Trabajar con etiquetas. 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 del control de versiones.

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 de cliente de los archivos y carpetas de un servidor de control de código fuente. Al crear varias áreas de trabajo, puede tener versiones diferentes de la misma carpeta de control de código fuente en un equipo cliente. Para obtener más información sobre áreas de trabajo, vea Trabajar con espacios de trabajo del control de versiones. 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 en espacios ( ) ni puntos (.)

  • No debe contener los caracteres imprimibles siguientes: " / : < > \ | * ? @

Vea también

Tareas

Cómo: Crear un servidor de grupo de nivel de servidor

Cómo: Crear un grupo de proyecto de equipo

Cómo: Agregar usuarios a un grupo predeterminado

Cómo: Agregar un usuario

Cómo: Renombrar un servidor de nivel de aplicación

Cómo: Cambiar el nombre de un servidor de nivel de datos

Cómo: Configurar e instalar Team Foundation Build

Cómo: Crear una definición de compilación

Cómo: Establecer la calidad de la compilación

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

Cómo: Modificar las áreas de un proyecto de equipo

Cómo: Modificar las iteraciones de un proyecto de equipo

Conceptos

Administración de Team Foundation Server

Nombres de campo

Definir el texto de ayuda del campo

Listas globales

Información general sobre Team Foundation Build

Control de versiones de Team Foundation

Trabajar con etiquetas

Trabajar con conjuntos de cambios aplazados del control de versiones

Trabajar con espacios de trabajo del control de versiones

Nombres de referencia de campos

Establecer iteraciones o áreas de proyecto iniciales

Otros recursos

Solucionar problemas de Team Foundation Server

Personalizar tipos de elemento de trabajo

Personalizar plantillas de procesos

Trabajar con definiciones de compilación en Team Foundation Build

Agregar proyectos y soluciones al control de versiones