Restricciones y convenciones de nomenclatura

  • Artículo

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

La mayoría de los componentes de Azure DevOps deben seguir las restricciones y convenciones de nomenclatura. Las restricciones ayudan a garantizar una experiencia de usuario coherente y proporcionan compatibilidad con otras aplicaciones.

Las restricciones comunes incluyen no superar la longitud de caracteres de un nombre, no contener caracteres especiales y mantener la unicidad de los nombres dentro de un conjunto de objetos.

Nota:

Para conocer los límites del número de elementos que puede definir, consulte Seguimiento del trabajo, proceso y límites del proyecto.

Consideraciones generales

Las restricciones de longitud de este artículo se miden según el número de caracteres Unicode permitidos. Los caracteres suplentes se componen de dos caracteres Unicode, que cuentan como dos caracteres con respecto a la restricción de longitud. Para obtener más información, vea Acerca de Los conjuntos de caracteres y Unicode.

Al igual que con otros archivos del sistema operativo, tampoco se permiten caracteres de control ASCII (ASCII 1-31) ni combinaciones suplentes. Para obtener información general sobre las restricciones del sistema operativo aplicadas a los nombres de archivo, vea Nomenclatura de archivos, rutas de acceso y espacios de nombres.

Nombres reservados del sistema

Evite usar nombres reservados del sistema, como los ejemplos siguientes:

  • AUX
  • COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10
  • CON
  • DefaultCollection
  • LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9
  • NUL
  • PRN
  • SERVER, SignalR
  • Web o WEB

Para obtener más información sobre los nombres reservados, vea Nombres de archivo, rutas de acceso y espacios de nombres.

Azure Artifacts

Los paquetes universales deben cumplir las restricciones siguientes.

Tipo de restricción Restricción
Nombre del paquete - Debe estar en minúsculas.
- Debe comenzar y terminar con letras o números.
- Solo debe contener letras, números y guiones noconsecutivos, caracteres de subrayado o puntos.
Versión del paquete Debe estar en minúsculas sin metadatos de compilación.

Azure Boards

Los elementos de trabajo se usan para capturar información para planear y realizar un seguimiento de los proyectos de desarrollo de software. Con los elementos de trabajo, puede describir el trabajo que se va a realizar, asignar trabajo, realizar un seguimiento del estado y coordinar los esfuerzos dentro de su equipo. Diferentes tipos de elementos de trabajo, como casos de usuario, tareas, errores y problemas, realizan un seguimiento de diferentes tipos de información. Para más información, consulte la documentación de Azure Boards.

Todos los objetos de seguimiento de elementos de trabajo están asociados a uno o varios nombres. La mayoría tiene nombres para mostrar descriptivos, excepto los tipos de elementos de trabajo y las listas globales, que están asociados a nombres de referencia. Un nombre descriptivo es un identificador único visible para un usuario para un campo. El uso de nombres descriptivos garantiza la coherencia entre proyectos y tipos de elementos de trabajo en una colección de proyectos. El sistema usa el nombre de referencia internamente y no se puede cambiar después de definirlo.

Hay restricciones en varios elementos asociados a elementos de trabajo, incluidos nombres descriptivos y de referencia, nombres de campo y tamaño de datos adjuntos.

Rutas de área y de iteración

Dos campos de elemento de trabajo, Ruta de acceso de área y Ruta de acceso de iteración, proporcionan una jerarquía de estructura de árbol para el trabajo de agrupación. Las rutas de acceso de área agrupan elementos de trabajo por producto, funcional o área de características. Las rutas de acceso de iteración agrupan elementos de trabajo en sprints, hitos o períodos de tiempo para abordar esos elementos de trabajo.

Estos campos de varios nodos usan los caracteres de barra diagonal \ inversa para indicar la jerarquía de nodos dentro de la estructura de árbol.

Los nombres que asigne a los nodos secundarios a estos campos deben cumplir las restricciones siguientes.

Tipo de restricción Restricción
Longitud de nodo No debe contener más de 255 caracteres.
Nombres reservados - No debe constar únicamente de un período . o de dos puntos ...
- No debe ser un nombre reservado por el sistema, como PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON o AUX. Para obtener más información sobre los nombres reservados, vea Nombres de archivo, rutas de acceso y espacios de nombres.
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 las restricciones de caracteres de Windows, vea Asignar nombres a archivos, rutas de acceso y espacios de nombres.
Longitud de la ruta de acceso No debe contener más de 4000 caracteres Unicode.
Profundidad de jerarquía de la ruta de acceso Debe tener menos de 14 niveles de profundidad.

Datos adjuntos

Los archivos adjuntos a los elementos de trabajo deben cumplir las restricciones siguientes.

Tipo de restricción Restricción
Tamaño de archivo No debe superar el tamaño máximo:
- Tamaño máximo predeterminado: 4096 kilobytes.
- Tamaño máximo absoluto: 2 gigabytes.
Tipo de restricción Restricción
Tamaño de archivo No debe superar el tamaño máximo:
- Tamaño máximo predeterminado: 4096 kilobytes.
- Tamaño máximo absoluto: 2 gigabytes. Para obtener más información, consulte Cambio del tamaño máximo de datos adjuntos para los elementos de trabajo.

Nombres de columnas y calles de la placa

El panel Kanban convierte el trabajo pendiente en un panel de inicio de sesión interactivo, lo que proporciona un flujo visual de trabajo. A medida que avanza el trabajo desde su concepción hasta la finalización, puede actualizar los elementos en el panel. Cada columna representa una fase de trabajo y cada tarjeta representa un caso de usuario (tarjetas azules) o un error (tarjetas rojas) en esa fase de trabajo.

Personalice los paneles Kanban agregando, quitando o cambiando el nombre de columnas y calles. Las columnas admiten el flujo de trabajo en todo el panel. Las calles le permiten administrar diferentes clases de trabajo como carriles horizontales en el tablero.

Los nombres de columnas y calles deben cumplir las restricciones siguientes.

Tipo de restricción Restricción
Length No debe contener más de 256 caracteres Unicode.
Unicidad - Los nombres de columna no deben ser iguales que cualquier otro nombre de columna en el panel Kanban.
- Los nombres de las calles no deben ser los mismos que cualquier otro nombre de calle de natación en el tablero Kanban.
Caracteres especiales No debe contener ningún carácter de control Unicode ni caracteres suplentes.

Nombres de campo

Cada tipo de elemento de trabajo contiene uno o varios campos de elemento de trabajo. Estos campos definen la información almacenada para los elementos de trabajo en función del tipo de elemento de trabajo. Cada campo de elemento de trabajo tiene un nombre de referencia de campo asociado. El nombre de referencia de campo identifica de forma única cada campo y no se puede cambiar después de asignarlo. Para obtener más información sobre los campos de elementos de trabajo integrados, vea Índice de campo de elemento de trabajo.

Los nombres de campo del elemento de trabajo deben cumplir las restricciones siguientes.

Tipo de restricción Restricción
Length No debe contener más de 128 caracteres Unicode.
Unicidad - Los nombres de campo deben contener al menos un carácter alfabético.
- No debe contener ninguno de los siguientes caracteres: .,;':~\/\*|?"&%$!+=()[]{}<>-.
- No debe contener espacios iniciales o finales.
- No debe contener dos o más espacios consecutivos.
Caracteres especiales Debe ser único dentro de la organización o la colección de proyectos. Los nombres de campo de elemento de trabajo se limitan a la colección de proyectos. Si cambia el nombre de un nombre de campo, cámbielo para todos los elementos de trabajo y WIT definidos en todos los proyectos de la colección.

Nombres de referencia de campo y portabilidad

El lenguaje de definición de tipo de elemento de trabajo incluye el concepto de un nombre de referencia de campo. Los nombres de referencia de campo pueden ayudarle a migrar definiciones entre colecciones de proyectos de Team Foundation y también para permitir que las integraciones de terceros busquen y hagan referencia a campos específicos. Estos nombres son únicos globalmente, al igual que un espacio de nombres en la aplicación de .NET Framework es globalmente único.

El espacio de nombres System solo se usa para definir todos los campos principales del sistema que son obligatorios para las funciones del sistema de Team Foundation. No puede crear su propio campo System.X porque podría impedir la funcionalidad.

El espacio de nombres de Microsoft se usa para definir campos de seguimiento de elementos de trabajo. Estos campos se definen en una definición de tipo de elemento de trabajo de las plantillas de proceso.

Los clientes y asociados pueden crear sus propios espacios de nombres de campo para tipos de elementos de trabajo personalizados. Para obtener descripciones de campos y campos del sistema definidos en las plantillas de proceso predeterminadas, vea Índice de campos de elementos de trabajo.

Importante

  • No se puede cambiar el nombre de los nombres de referencia de campo. Si, por ejemplo, ha cambiado el nombre de campo "Title" a "Header", el nombre de referencia de campo de ese campo sigue siendo el mismo. Las integraciones y las representaciones internas de los campos deben usar el nombre de referencia de campo en lugar del propio nombre del campo.
  • Aunque puede crear su propio campo Microsoft.X, no se recomienda hacerlo, ya que podría impedir la funcionalidad o la capacidad del Asistente para configurar características para actualizar correctamente un proyecto después de una actualización.

Ejemplos de nombres de referencia de campo

En los ejemplos siguientes se muestran nombres de referencia de campo válidos, en varios espacios de nombres. Los clientes y asociados también pueden definir sus propios espacios de nombres para admitir sus tipos de elementos de trabajo personalizados.

Ejemplos de espacio de nombres del sistema Ejemplos de espacios de nombres de Microsoft Otros ejemplos de espacio de nombres
System.Id, System.Title, System.CreatedBy, System.CreatedDate, System.ChangedBy, System.ChangedDate, System.State, System.Reason Microsoft.VSTS.Build.FoundIn, Microsoft.VSTS.Common.Activity, Microsoft.VSTS.Common.Discipline, Microsoft.VSTS.Common.Priority, Microsoft.VSTS.CMMI.TaskType, Microsoft.VSTS.TCM.AutomationStatus, Microsoft.VSTS.TCM.TestSuiteType La empresa ficticia Fabrikam Fiber podría definir los siguientes campos de elementos de trabajo personalizados:
FabrikamFiber.Common.Severity, FabrikamFiber.Common.Phase, FabrikamFiber.RiskManagement.RiskType, FabrikamFiber.RiskManagement.Resolution

La empresa ficticia de software Contoso Corporation podría definir los siguientes campos de elemento de trabajo:
Contoso.Common.BusinessPriority, Contoso.Bug.FoundInPhase, Contoso.Bug.FixInPhase

Texto de ayuda de campo

El sistema muestra texto de ayuda en tiempo de ejecución para ayudar a los usuarios a saber qué escribir en el campo. El texto de ayuda tiene como ámbito un tipo de elemento de trabajo específico en un proyecto específico.

Para el proceso de herencia, especifique texto de ayuda para un campo a través del cuadro de diálogo Editar campo , pestaña Definición , Descripción. Consulte Agregar un campo personalizado a un tipo de elemento de trabajo. Para el proceso XML local, especifique texto de ayuda mediante el HELPTEXT elemento . Consulte Adición o modificación de un campo para realizar un seguimiento del trabajo.

El texto de ayuda que agregue debe cumplir las restricciones siguientes.

Tipo de restricción Restricción
Length No debe contener más de 255 caracteres Unicode.

Listas globales

Una lista global es un conjunto de valores de elemento de lista que puede usar globalmente en todas las colecciones de proyectos dentro de una instancia de Azure DevOps Server local. A medida que defina los tipos de elementos de trabajo, es posible que algunos campos de elemento de trabajo compartan el mismo conjunto de valores permitidos o sugeridos. Las listas globales le permiten definir estos valores una vez y compartirlos entre varios tipos y proyectos de elementos de trabajo. Para obtener más información, consulte Definir listas globales.

Una lista global, definida mediante el GLOBALLIST elemento contiene uno o varios elementos de lista, especificados mediante el LISTITEM elemento .

LISTITEM los nombres deben cumplir las restricciones siguientes.

Tipo de restricción Restricción
Length - No debe contener más de 254 caracteres Unicode.
- No debe estar vacío.
Caracteres especiales - No debe contener espacios en blanco iniciales o finales.
- No debe contener dos espacios consecutivos.
- No debe contener caracteres de barra diagonal \ inversa.
Ámbito Dado que las listas globales están disponibles entre todos los proyectos, no deben contener elementos definidos en el nivel de proyecto, como definiciones de cuentas de grupo específicas del proyecto.

Las listas globales deben cumplir las restricciones siguientes.

Tipo de restricción Restricción
Número de artículos No puede estar vacío. La lista global debe contener al menos un LISTITEM elemento.
Unicidad No puede estar vacío. La lista global debe contener al menos un LISTITEM elemento.

Defina un nombre de referencia cada vez que agregue o cree un tipo de vínculo o una categoría. Todos los nombres de referencia pueden tener hasta 70 caracteres Unicode.

Defina un nombre de referencia mediante caracteres alfanuméricos, caracteres de subrayado y caracteres de guion. Cada nombre de referencia debe contener al menos un punto ., pero ningún punto puede aparecer al principio o al final de un nombre. Un nombre de referencia no debe comenzar con un número o un carácter de subrayado, y no puede tener varios guiones consecutivos, como --.

Tipo de restricción Restricción
Length No debe contener más de 70 caracteres Unicode.
Unicidad : no debe ser idéntico a ningún otro nombre de referencia de campo dentro de la colección de proyectos.
- No debe ser idéntico a ningún otro nombre de referencia de campo después de que el equipo procese esos nombres para reemplazar todos los períodos . por caracteres de _subrayado . Por ejemplo, los nombres My.*Field* de referencia de campo y My.Field ambos procesarían como el mismo nombre: My__Field
Caracteres especiales - No debe contener guiones -.
- Debe contener al menos un punto ..
- No debe comenzar ni terminar con un punto ..
- No debe comenzar con un númeroMust no empezar con un carácter de subrayado _.

Etiquetas de elemento de trabajo

Las etiquetas de elemento de trabajo corresponden a una o dos frases clave para filtrar herramientas de seguimiento de trabajo, como trabajos pendientes, paneles y consultas o definir consultas. Para obtener más información, vea Agregar etiquetas de elemento de trabajo para clasificar y filtrar listas y paneles.

Los nombres de etiqueta deben cumplir las restricciones siguientes.

Tipo de restricción Restricción
Length - No debe contener más de 400 caracteres Unicode.
- No debe ser null ni estar vacío.
Caracteres especiales - No debe contener caracteres separadores: , o ;.
- No debe contener caracteres de formato o control Unicode, como una fuente de líneas, separador de párrafos, retorno de carro u otros caracteres suplentes no coincidente.
Ámbito Dado que las listas globales están disponibles entre todos los proyectos, no deben contener elementos definidos en el nivel de proyecto, como definiciones de cuentas de grupo específicas del proyecto.

Azure Pipelines

Las definiciones de Azure Pipeline deben cumplir las restricciones siguientes.

Tipo de restricción Restricción
Nombre del trabajo - Solo debe contener caracteres alfanuméricos y '_'.
- No debe comenzar con un número.
- Debe tener un nombre único.
- No debe contener palabras clave, por ejemplo: "implementación".
Nombre de la fase - Solo debe contener caracteres alfanuméricos y '_'.
- No debe comenzar con un número.
- No debe contener palabras clave, por ejemplo: "implementación".
Expresiones Debe comenzar con a-Z o _AND, seguido de a-Z, 0-9o _.

Para más información, consulte la documentación de Azure Pipelines.

Azure Repos (Git)

Cada proyecto de Azure DevOps puede contener varios repositorios de Git. Los nombres que asigne a los repositorios de Git deben cumplir las restricciones siguientes. Para más información, consulte la documentación de Git de Azure Repos. Para obtener más información sobre las restricciones de nomenclatura para otros elementos de Git, como ramas y etiquetas, consulte git check-ref-format.

Importante

Aunque puede incluir espacios en los nombres de repositorio, no se recomienda hacerlo.

Tipo de restricción Restricción
Length No debe contener más de 64 caracteres Unicode.
Unicidad No debe ser idéntico a ningún otro nombre de repositorio de Git en el proyecto.
Caracteres especiales - No debe contener ningún carácter de control Unicode ni caracteres suplentes.
- No debe contener los siguientes caracteres imprimibles: \ / : * ? " < > | ; # $ * { } , + = [ ].
- No debe comenzar con un carácter de subrayado _.
- No debe comenzar ni terminar con un punto ..
- No debe ser un nombre reservado del sistema.

Azure Repos (TFVC)

El control de versiones de Team Foundation (TFVC) proporciona un repositorio central para archivos y los comandos necesarios para administrar esos archivos en un equipo. También proporciona directivas de protección personalizables, bifurcaciones, combinación, archivador y muchas otras características. Para más información, consulte la documentación de TFVC de Azure Repos.

Las rutas de acceso de control de versiones deben cumplir las restricciones siguientes. Consulte también Optimización del área de trabajo.

Tipo de restricción Restricción
Longitud de la ruta de acceso de la carpeta del control de código fuente del servidor - No debe contener más de 259 caracteres Unicode para una sola carpeta 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 un 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 y un nombre de archivo combinados.
Restricciones de longitud específicas del portal web y rest No debe contener más de 215 caracteres Unicode para un nombre de proyecto combinado, directorio y nombre de archivo.

En el portal web y la API REST, ciertas operaciones tienen una longitud de ruta de acceso más restrictiva que Visual Studio y TF.exe clientes. Estas operaciones incluyen Editar, Cambiar nombre y eliminar, y se producen porque el portal web o REST usa un área de trabajo generada aleatoriamente para la simultaneidad cuando está pendiente de los cambios.

Archivos TFVC

El sistema de control de versiones almacena muchos tipos diferentes de archivos. La configuración del control de versiones de Team Foundation en la máquina de desarrollo proporciona detalles sobre cómo agregar soluciones o proyectos de Visual Studio existentes.

Los archivos y carpetas que agregue al control de versiones de Team Foundation deben cumplir las restricciones siguientes.

Tipo de restricción Restricción
Archivos y carpetas - Los nombres no deben contener los siguientes caracteres imprimibles: \ / : * ? " < > | ;.
- Las carpetas no deben estar fuera del directorio asignado para el área de trabajo activa.
Nombres de archivos - No debe comenzar con .$
- No debe contener los siguientes caracteres imprimibles: \ / : * ? " < > | ;.

Etiquetas de TFVC

En el control de versiones de Team Foundation (TFVC), una etiqueta es un nombre aplicado a un conjunto específico de revisiones. Puede adjuntar etiquetas a un conjunto de archivos no relacionados en el control de versiones, lo que le permite recuperar los archivos o actuar sobre ellos como un grupo. En la tabla siguiente se describen las restricciones que se colocan en los nombres de etiqueta.

Tipo de restricción Restricción
Length No debe contener más de 64 caracteres Unicode.
Caracteres especiales - No se puede terminar con un espacio ( ) o un punto ..
- No debe contener los siguientes caracteres imprimibles: \ / : * ? " < > | ; @.

Conjuntos de estantes de TFVC

Los conjuntos de estantes permiten reservar temporalmente un lote de cambios pendientes y, a continuación, como opción, quitar los cambios pendientes del área de trabajo. Más adelante, puede restaurar los cambios de un conjunto de estantes en el área de trabajo o colocarlos en el área de trabajo de otro usuario.

Los nombres del conjunto de estantes deben cumplir las siguientes restricciones.

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

Áreas de trabajo de TFVC

Un área de trabajo es una copia del lado cliente de los archivos y carpetas del control de versiones de Team Foundation (TFVC). Al crear varias áreas de trabajo, puede tener versiones diferentes de la misma carpeta de control de versiones en un equipo cliente. La creación y el trabajo con áreas de trabajo proporcionan más detalles.

Los nombres de área de trabajo deben cumplir las restricciones siguientes.

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

Nombres de equipo

El nombre del equipo en el que se instala Azure DevOps está asociado al nombre del servidor. Tanto el sistema operativo como Active Directory imponen ciertas restricciones en los nombres de equipo, tal como se describe en estos artículos:

Nombres de organización

Importante

Siga las instrucciones siguientes al crear un nombre de organización.

  • Usar solo letras del alfabeto inglés
  • Inicie el nombre de la organización con una letra o un número.
  • Usar letras, números o guiones después del carácter inicial
  • Asegúrese de que su organización no supere los 50 caracteres Unicode.
  • Terminar con una letra o un número

Si usa cualquiera de los caracteres no permitidos, recibirá el siguiente mensaje de error: VS850015: No se permite usar el nombre especificado: {Nombre de la organización}.

Plantillas de proceso y proceso

Un proceso define los bloques de creación del sistema de seguimiento de elementos de trabajo y otros subsistemas a los que tiene acceso después de conectarse a un proyecto.

Nota:

Terminología: tanto "proceso" como "plantilla de proceso" hacen referencia a un conjunto interdependente de archivos usados para crear un proyecto. Para obtener más información, vea Acerca de los procesos y las plantillas de proceso, que describe las diferencias entre los tres procesos predeterminados disponibles.

Los procesos que defina o personalice deben cumplir las restricciones siguientes.

Tipo de restricción Restricción
Length No debe contener más de 256 caracteres Unicode.
Unicidad : debe ser único en Azure DevOps.
- Si carga una plantilla con el mismo nombre que una plantilla existente, se sobrescribe la plantilla existente.
Tamaño del archivo de plantilla de proceso No debe superar los 2 GB (gigabytes).

Colecciones de proyectos

Una colección de proyectos identifica un grupo de proyectos y los recursos asociados a esos proyectos. Proporciona una estructura de organización que puede usar para definir y controlar un grupo de proyectos definidos para un servidor de Azure DevOps.

Además, el nombre de la colección forma parte del cadena de conexión que se usa para conectar miembros del equipo a proyectos. El valor predeterminado asignado corresponde a DefaultCollection. Administrar colecciones de proyectos proporciona más información.

Los nombres que asigne a las colecciones de proyectos deben cumplir las restricciones siguientes.

Tipo de restricción Restricción
Length No debe contener más de 64 caracteres Unicode.
Unicidad - No debe ser idéntico a ningún otro nombre de colección en la implementación local.
- Si la implementación incluye Productos de SharePoint o SQL Server Reporting Services, no pueden ser idénticas al nombre y la ruta de acceso completa de un sitio de SharePoint, servidor de informes o sitio web de Reporting Services existente.
Nombres reservados No debe ser un nombre reservado del sistema.
Caracteres especiales - No debe contener ningún carácter de control Unicode ni caracteres suplentes.
- No debe contener los siguientes caracteres imprimibles: \ / : * ? " < > | ; # $ * { } , + = [ ].
- No debe contener puntos suspensivos ... ni un punto ..doble .
- No debe comenzar con un carácter de subrayado _.
- No debe comenzar ni terminar con un punto ..

Nombres de proyecto

Un proyecto establece un repositorio para el código fuente y un lugar para que los equipos planeen, realicen un seguimiento del progreso y colaboren. El nombre del proyecto forma parte del cadena de conexión que se usa para conectar miembros del equipo a proyectos.

Los nombres que asigne a los proyectos que cree deben cumplir las restricciones siguientes.

Tipo de restricción Restricción
Length No debe contener más de 64 caracteres Unicode.
Unicidad No debe ser idéntico a ningún otro nombre de la colección de proyectos, la aplicación web de SharePoint que admita la colección o la instancia de SQL Server Reporting Services que admita la colección.
Reservas de nombres - No debe ser un nombre reservado del sistema.
- No debe ser uno de los segmentos ocultos que se usan para el filtrado de solicitudes iiS como App_Browsers, App_code, App_Data, App_GlobalResources, App_LocalResources, App_Themes, App_WebResources, bin o web.config.
Caracteres especiales - No debe contener ningún carácter de control Unicode ni caracteres suplentes.
- No debe contener los siguientes caracteres imprimibles: \ / : * ? " < > | ; # $ * { } , + = [ ].
- No debe comenzar con un carácter de subrayado _.
- No debe comenzar ni terminar con un punto ..

Grupos de seguridad

Con los grupos de seguridad de Azure DevOps, puede aplicar determinados derechos o permisos a un grupo de usuarios.

Los grupos locales pueden constar de cuentas de grupo de Active Directory, grupos de seguridad de Azure DevOps, cuentas de usuario de Windows, cuentas de grupo de Windows o cualquier combinación de estos tipos. Para obtener más información, vea Agregar usuarios o grupos de Active Directory/ Microsoft Entra a un grupo de seguridad integrado.

Los grupos de seguridad deben cumplir las restricciones siguientes.

Tipo de restricción Restricción
Longitud del nombre de la cuenta del grupo de seguridad No debe contener más de 256 caracteres Unicode.
Unicidad - Las cuentas de grupo de nivel de proyecto no deben coincidir con ningún otro nombre de grupo en el mismo proyecto.
- Las cuentas de grupo de nivel de colección no deben coincidir con ningún otro nombre de una cuenta de grupo en la colección de proyectos.
Nombres de grupo reservados No se debe llamar con un $NAMESPACE en el proyecto o en el nivel de servidor.
Caracteres especiales - No debe contener ningún carácter de control Unicode ni caracteres suplentes.
- No debe contener los siguientes caracteres imprimibles: / \ [ ] : | < > + = ; ? *.
- No debe incluir caracteres no imprimibles en el intervalo de valores ASCII de 1 a 31.
- No debe terminar en un punto ..
- No debe incluir comas ,.

Team Foundation Build

Team Foundation Build le permite administrar todos los aspectos del proceso de compilación en un solo equipo. Con Team Foundation Build, puede sincronizar los orígenes, compilar la aplicación, ejecutar pruebas unitarias asociadas, realizar análisis de código, publicar compilaciones en un servidor de archivos y publicar informes de compilación.

Compilar equipo

Team Foundation Build es una instalación independiente del nivel de aplicación de Azure DevOps Server, el nivel de datos o el cliente de Visual Studio. Puede elegir un equipo independiente. De lo contrario, puede instalar la compilación en paralelo en el equipo cliente o en los servidores.

El equipo de compilación local debe cumplir las restricciones siguientes.

Tipo de restricción Restricción
Espacio en disco Debe contener suficiente espacio para la compilación (el espacio insuficiente conduce a compilaciones con errores).
Directorio de compilación Debe ser una ruta de acceso local (por ejemplo, C:\BuildDirectory).
Quitar directorio de ubicación Debe ser una ruta de acceso UNC (por ejemplo, \server\share).
Quitar permisos de ubicación Cada compilación generada se coloca en un directorio nuevo en la carpeta drop.
- La cuenta de servicio de Team Foundation Server (por ejemplo, Domain\TFSSERVICE) debe tener acceso de permiso control total a la ubicación de colocación de UNC.
- La ubicación de colocación UNC debe ser una carpeta compartida.
Cuenta del servicio 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 Servicios de compilación.
- La cuenta tiene permisos de lectura y escritura en las carpetas temporales y la carpeta temporal ASP.NET.
- La cuenta tiene permiso control total para el directorio de compilación y la ubicación de colocación.
Problemas de firewall Si el equipo de compilación está habilitado para el firewall, asegúrese de que el programa, tfsbuildservice, se encuentra en la lista de excepciones.

Tipos de compilación

Los tipos de compilación configuran las condiciones en las que se compila una única solución o un conjunto de soluciones de un proyecto. Para realizar una compilación, debe crear un nuevo tipo de compilación o usar un tipo de compilación existente.

Los nombres de tipo de compilación deben cumplir las restricciones siguientes.

Tipo de restricción Restricción
Unicidad No debe ser el mismo que cualquier otro nombre de tipo de compilación en el proyecto.
Caracteres especiales No debe contener el siguiente carácter imprimible: $.

Calidad de compilación

La calidad de compilación le permite adjuntar un estado de nivel de calidad o finalización a una compilación completada. Team Foundation Build también le permite crear nuevos valores para el tipo de calidad de compilación. Consulte Evaluar la calidad de una compilación completada para obtener una lista de los valores de calidad de compilación predeterminados.

Los nombres de calidad de compilación deben cumplir las restricciones siguientes.

Tipo de restricción Restricción
Length No debe contener más de 256 caracteres Unicode.
Unicidad No debe ser el mismo que cualquier otro nombre de calidad de compilación en el equipo team Foundation Build.

Nombres de equipo

Los nombres de equipo identifican un grupo de individuos o grupos que trabajan conjuntamente como un equipo de un proyecto. Los miembros del equipo usan este nombre para conectarse al equipo o consultar a los miembros definidos para un equipo.

Los nombres de equipo deben cumplir con las convenciones que les permitan representarse como parte de una dirección URL válida. Cada nombre de equipo debe ser único dentro de un único proyecto. Sin embargo, no hay ninguna restricción en el uso del mismo nombre de equipo en proyectos diferentes dentro de una colección de proyectos. Para obtener más información, consulte Agregar otro equipo o una jerarquía de equipos.

Los nombres de equipo deben cumplir las restricciones siguientes.

Tipo de restricción Restricción
Length No debe contener más de 64 caracteres Unicode.
Unicidad No debe ser idéntico a ningún otro nombre del proyecto.
Nombres reservados No debe ser un nombre reservado del sistema.
Caracteres especiales - No debe contener ningún carácter de control Unicode ni caracteres suplentes.
- No debe contener los siguientes caracteres imprimibles: \ / : * ? " < > | ; # $ * { } , + = [ ].
- No debe contener puntos suspensivos ... ni un punto ..doble .
- No debe comenzar con un carácter de subrayado _.
- No debe comenzar ni terminar con un punto ..

Nombres de cuenta de usuario

Las cuentas de usuario identifican a las personas agregadas a un proyecto o colección de proyectos. Las cuentas de usuario pueden corresponder a entradas dentro de Active Directory, Microsoft Entra ID, grupo de servidores de Windows.

Las cuentas de usuario que agregue a una organización o colección deben cumplir las restricciones siguientes. Para agregar cuentas de usuario a un proyecto, consulte Agregar usuarios a un proyecto o equipo.

Tipo de restricción Restricción
Longitud del nombre de cuenta No debe contener más de 256 caracteres Unicode.
Unicidad No debe coincidir con ninguna otra cuenta de usuario agregada a la colección de proyectos.
Nombres de grupo reservados No se debe llamar con un $NAMESPACE en el proyecto o en el nivel de servidor.
Caracteres especiales - No debe incluir los siguientes caracteres imprimibles: "/ \ [ ] : | < > + = ; ? *.
- No debe incluir caracteres no imprimibles en el intervalo de valores ASCII de 1 a 31.
- No debe terminar en un período . o un signo $de dólar .
- No debe incluir comas ,.
- No debe incluir las siguientes categorías Unicode: LineSeparator, ParagraphSeparator, Control, Format, OtherNotAssigned.

Nombres de archivo y página wiki

Cada página wiki corresponde a un archivo dentro del repositorio de Git de la wiki. Los nombres que asigne a un título de página wiki deben cumplir las siguientes restricciones.

Tipo de restricción Restricción
Nombre de archivo La ruta de acceso de la página completa no debe superar los 235 caracteres.
Unicidad Los títulos de página distinguen mayúsculas de minúsculas y deben ser únicos dentro de la jerarquía wiki.
Caracteres especiales - No debe contener ningún carácter de control Unicode ni caracteres suplentes.
- No debe contener los siguientes caracteres imprimibles: / \ #.
- No debe comenzar ni terminar con un punto ..
Tamaño de archivo No deben superar el máximo de 18 MB.
Tamaño del archivo adjunto No debe superar el máximo de 19 MB.

Caracteres especiales en títulos de página wiki

Puede especificar títulos de página que contengan uno o varios de estos caracteres : < > * ? | -especiales. Por ejemplo, puede asignar un nombre a un archivo Markdown como "P+F" o "Guía de configuración". Los caracteres tienen las siguientes cadenas codificadas en URI:

Carácter Cadena codificada
: %3A
< %3C
> %3E
* %2A
? %3F
| %7C
- %2D
" %22