Restrictions d'affectation de noms dans Team Foundation

De nombreux composants dans Visual Studio Team Foundation Server ont certaines restrictions d'affectation de noms. Ces restrictions permettent de garantir la cohérence de l'expérience utilisateur et fournissent la compatibilité avec d'autres programmes. Ces restrictions peuvent inclure la longueur, les caractères spéciaux, l'unicité ou d'autres attributs.

Cette rubrique contient les sous-sections suivantes :

Éléments courants à prendre à compte

Restrictions pour les noms de comptes du groupe Team Foundation Server

Restrictions pour les noms d'ordinateurs

Restrictions pour les noms de collection de projets d'équipe

Restrictions pour les noms de projets d'équipe

Restrictions pour les éléments de travail

Restrictions pour les personnalisations d'éléments de travail

Restrictions pour les modèles de processus

Restrictions pour Team Foundation Build

Restrictions pour le contrôle de version

Voir aussi

Éléments courants à prendre à compte

Dans cette rubrique, les restrictions de longueur sont mesurées par le nombre de caractères Unicode autorisé. Pour plus d'informations sur Unicode, consultez « About Unicode and Character Sets » à l'adresse https://go.microsoft.com/fwlink/?LinkId=76837. Les caractères de substitution sont composés de deux caractères Unicode, lesquels compteront comme deux caractères par rapport à la restriction de longueur.

Comme avec d'autres fichiers de système d'exploitation, les caractères de contrôle ANSI (ASCII 1-31) et les combinaisons de remplacement ne sont pas non plus autorisés. Pour des informations générales sur les restrictions du système d'exploitation appliquées aux noms de fichiers, consultez « Naming a File » (LinkId=76838).

Restrictions pour les noms de comptes du groupe Team Foundation Server

Les comptes de groupes Team Foundation permettent d'appliquer certains droits ou autorisations à un groupe d'utilisateurs. Ce groupe Team Foundation peut se composer de comptes d'utilisateurs Windows ou de comptes de groupes Windows, Active Directory, Team Foundation ou d'une combinaison de ces types.

Si vous souhaitez créer un groupe qui possède des autorisations dans plusieurs projets, consultez Créer un groupe au niveau de la collection. Si vous souhaitez créer un groupe de sécurité pour votre projet d'équipe, consultez Créer un groupe de projets d'équipe. Si vous souhaitez ajouter un membre à l'un des groupes prédéfinis par Team Foundation Server, consultez Ajouter des utilisateurs aux projets d'équipe.

Lorsqu'un compte de groupe Team Foundation est créé ou est modifié, il doit respecter certaines restrictions Team Foundation Server. Le tableau suivant décrit ces restrictions.

Type de restriction	Restriction
Longueur du nom de compte du groupe	Ne doivent pas contenir plus de 256 caractères Unicode
Unicité (comptes de groupe au niveau de la collection)	Ne doit pas correspondre à un autre nom d'un compte de groupe dans la collection de projets d'équipe
Unicité (comptes de groupe au niveau du projet)	Ne doit pas correspondre à un autre nom de groupe dans le même projet
Noms de groupes réservés	Ne doivent pas être nommés $NAMESPACE au niveau du projet ou du serveur
Restrictions de caractères spéciaux	Ne doivent pas contenir les caractères imprimables suivants : "/ \ [ ] : | < > + = ; ? * Ne doivent pas contenir des caractères non imprimables dans la plage de valeurs ASCII comprise entre 1 et 31 Ne doivent pas se terminer par un point (.) Ne doivent pas inclure de virgules (,)

Restrictions pour les noms d'ordinateurs

Pendant la procédure d'installation de Team Foundation Server, le nom d'ordinateur est associé au nom du serveur Team Foundation.

Le système d'exploitation et Active Directory de Windows Server 2003 imposent certaines restrictions sur les noms d'ordinateur. Pour plus d'informations sur le changement de nom d'ordinateur, consultez « Rename a computer » à l'adresse https://go.microsoft.com/fwlink/?LinkId=76839. Pour plus d'informations sur Active Directory, consultez « Windows Server 2003 Active Directory » à l'adresse https://go.microsoft.com/fwlink/?LinkId=47541.

Restrictions pour les noms de collection de projets d'équipe

Le nom d'une collection de projets d'équipe identifie un regroupement de projets d'équipe et les ressources associées à ces projets. Une collection de projets d'équipe est une structure d'organisation que vous pouvez utiliser pour définir et contrôler un groupe de projets d'équipe dans Team Foundation Server. Les membres de l'équipe utilisent le nom de la collection de projets d'équipe lorsqu'ils se connectent aux projets d'équipe dans Team Explorer. Pour plus d'informations, consultez Organisation de votre serveur avec des collections de projets d'équipe

Le tableau décrit les restrictions pour les noms de collections.

Type de restriction	Restriction
Length	Ne doivent pas contenir plus de 64 caractères Unicode
Unicité	Ne doit pas être identique à un autre nom de collection dans votre déploiement de Team Foundation Server. Si votre déploiement inclut les produits SharePoint ou SQL Server Reporting Services, il ne doit pas être identique au nom et au chemin d'accès complet d'un site SharePoint existant, un serveur de rapports ou un site Web Reporting Services.
Caractères spéciaux	Ne doivent pas contenir de caractère de contrôle Unicode ou de caractère de substitution. Ne doivent pas contenir les caractères imprimables suivants : / : \ ~ & % ; @ ' " ? < > | # $ * } { , + = [ ] Ne doivent pas contenir des points de suspension (...) ou un point double (..) Ne doivent pas commencer par un trait de soulignement (_) Ne doivent pas commencer ou se terminer par un point (.)
Noms réservés	Ne doivent pas être un mot réservé par le système tel que PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON, AUX, Web ou WEB Pour plus d'informations sur les mots réservés, consultez cette page sur le site Web Microsoft: File Names, Paths, and Namespaces (page éventuellement en anglais).

Restrictions pour les noms de projet

Les noms du projet dans Team Foundation Server identifient une collection d'éléments de travail, des documents, des rapports, des builds d'équipe et une arborescence de contrôle de version qui composent un projet particulier dans Team Foundation. Les membres d'équipe utilisent ce nom de projet pour se connecter au projet dans Team Foundation Server.

Le tableau suivant décrit les restrictions pour les noms de projets.

Type de restriction	Restriction
Longueur	Ne doivent pas contenir plus de 64 caractères Unicode
Unicité	Ne doit pas être identique à un autre nom de la collection de projets d'équipe, à l'application Web SharePoint qui prend en charge la collection ou à l'instance de SQL Server Reporting Services qui prend en charge la collection
Caractères spéciaux	Ne doivent contenir aucun caractère de contrôle Unicode ou substitut1 Ne doivent pas contenir les caractères imprimables suivants : / : \ ~ & % ; @ ' " ? < > | # $ * } { , + = [ ] Ne doivent pas contenir des points de suspension (...) ou un point double (..) Ne doivent pas commencer par un trait de soulignement (_) Ne doivent pas commencer ou se terminer par un point (.)
Noms réservés	Ne doivent pas être un mot réservé pour le système, par exemple PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON ou AUX Pour plus d'informations sur les noms réservés, consultez « Naming a File » à l'adresse https://go.microsoft.com/fwlink/?LinkId=76838.

Restrictions pour les éléments de travail

Microsoft Visual Studio Application Lifecycle Management suit la progression d'un projet en utilisant des éléments tels que les bogues, les composants requis, les tâches et les risques. Ces éléments sont génériquement appelés éléments de travail. Cette section décrit les restrictions sur les données stockées dans les éléments de travail.

Restrictions pour les pièces jointes aux éléments de travail

Les fichiers peuvent être joints aux éléments de travail. Le tableau suivant décrit les restrictions sur les pièces jointes aux éléments de travail.

Type de restriction	Restriction
Taille du fichier	Par défaut, la limite de taille des pièces jointes d'élément de travail est de 4 096 kilo-octets. Cette valeur peut être modifiée par l'administrateur Team Foundation. La taille maximale pouvant être définie par l'administrateur est de 2 gigaoctets. Taille par défaut : 4096 kilo-octets Taille maximale : 2 gigaoctets

Restrictions pour les zones et itérations d'éléments de travail

Les éléments de travail contiennent un champ pour Zone de projet et un champ pour Itération de projet. Ils permettent d'organiser et d'afficher les éléments de travail en groupements logiques.

Les champs Zone de projet et Itération de projet constituent des chemins composés de plusieurs éléments de nœud séparés par des barres obliques inverses (\). Les nœuds sont définis par l'administrateur Team Foundation Server pour refléter les zones de projet et le cycle de projet. Le tableau suivant décrit les restrictions sur les nœuds et les chemins d'accès.

Type de restriction	Restriction
Longueur de nœud	Ne doivent pas contenir plus de 255 caractères
Caractères spéciaux pour les nœuds	Ne doivent pas contenir des caractères de contrôle Unicode Ne doivent contenir aucun des caractères suivants: \ / $ ? * : " & > < # % | Ne doivent pas contenir des caractères non autorisés par le système de fichiers local. Pour plus d'informations sur les restrictions de caractère Windows, consultez « Naming a File » à l'adresse https://go.microsoft.com/fwlink/?LinkId=76838.
Noms réservés	Ne doivent pas se composer uniquement d'un point (.) ou de deux points (..) Ne doivent pas être un mot réservé pour le système, par exemple PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON ou AUX Pour plus d'informations sur les noms réservés, consultez « Naming a File » à l'adresse https://go.microsoft.com/fwlink/?LinkId=76838.
Longueur des chemins d'accès	Ne doivent pas contenir plus de 4 000 caractères Unicode
Profondeur de la hiérarchie des chemins d'accès	Ne doivent pas être profonds de plus de 14 niveaux

Restrictions pour les personnalisations d'éléments de travail

Team Foundation Server suit la progression d'un projet en utilisant des éléments tels que les bogues, les composants requis, les tâches et les risques. Ces éléments sont génériquement appelés éléments de travail.

Les administrateurs de projets d'équipe peuvent décider de modifier des définitions de types d'éléments de travail soit au niveau du projet, soit dans un modèle de processus. Pour plus d'informations sur la personnalisation de types d'éléments de travail, consultez Personnalisation des données de suivi de projet, de formulaires, de flux de travail et d'autres objets. Cette section décrit les restrictions que vous rencontrez lorsque vous personnalisez des éléments de travail et leurs éléments associés.

Restrictions pour les noms de champs d'éléments de travail

Chaque type d'élément de travail contient un ou plusieurs champs d'éléments de travail. Ces champs définissent les informations stockées dans un type d'élément de travail. Un nom de champ d'élément de travail identifie uniquement chaque champ d'élément de travail.

Le tableau suivant décrit les restrictions pour les noms de champs d'éléments de travail.

Type de restriction	Restriction
Longueur	Ne doivent pas contenir plus de 128 caractères Unicode
Caractères spéciaux	Ne doivent pas contenir d'espace blanc en début ni en fin de chaîne Ne doivent pas contenir deux ou plusieurs espaces consécutifs Ne doivent pas contenir de points (.) Ne doivent pas contenir de crochets d'ouverture ou de fermeture ([ ])
Portée	Les noms de champs d'éléments de travail s'étendent sur l'ensemble du serveur Team Foundation. Si un nom de champ est modifié, la modification se répercute sur tous les projets et types d'éléments de travail contenant ce champ d'élément de travail.

Restrictions pour les noms de référence de champs d'éléments de travail

Chaque champ d'élément de travail a un nom de référence de champ associé. Le nom de référence du champ identifie uniquement chaque champ et ne peut pas être modifié une fois assigné. Pour plus d'informations sur les noms de référence de champs, consultez Field Reference Names. Le tableau suivant décrit les restrictions appliquées aux noms de référence de champ.

Type de restriction	Restriction
Longueur	Ne doivent pas contenir plus de 70 caractères Unicode
Caractères spéciaux	Ne doivent pas contenir de traits d'union (-) Doivent contenir au moins un point (.) Ne doivent pas commencer ou se terminer par un point (.) Ne doivent pas commencer par un chiffre Ne doivent pas commencer par un trait de soulignement (_)
Unicité	Ne doivent être identiques à aucun autre nom de référence de champ dans Team Foundation Server Ne doivent être identiques à aucun autre nom de référence de champ une fois ces noms traités par l'ordinateur pour remplacer tous les points (.) par des traits de soulignement (_) Par exemple, les noms de référence de champ My._Field et My_.Field seraient traités par l'ordinateur afin qu'ils soient identiques : My__Field

Restrictions pour le texte d'aide des champs d'éléments de travail

Vous pouvez, si vous le souhaitez, associer le texte d'aide aux champs d'éléments de travail à l'aide de la balise <HELPTEXT>. Le système affiche ce texte au moment de l'exécution pour aider les utilisateurs à savoir ce qu'il faut entrer dans le champ. Pour plus d'informations sur le texte d'aide des éléments de travail, consultez Définition du texte d'aide d'un champ d'élément de travail.

Le tableau suivant décrit les restrictions pour le texte d'aide des champs d'éléments de travail.

Type de restriction	Restriction
Longueur	Ne doivent pas contenir plus de 255 caractères Unicode
Portée	Contrairement au nom et au type de champ, la portée du texte d'aide de champ est limitée à un type d'élément de travail spécifique d'un projet d'équipe spécifique.

Restrictions pour les listes globales

Une liste globale est un ensemble de valeurs d'éléments de liste stocké et utilisé globalement par tous les serveurs Team Foundation d'une implémentation Team Foundation Server. En définissant des types d'éléments de travail, vous pouvez constater que certains champs d'élément de travail ont le même ensemble de valeurs possibles. Les listes globales vous permettent de définir ces valeurs une fois et de les partager entre plusieurs types d'éléments de travail. Pour plus d'informations, consultez Définition des listes globales.

Une liste globale (GLOBALLIST) contient un ou plusieurs éléments de liste (éléments LISTITEM).

Le tableau suivant décrit les restrictions sur les éléments de liste.

Type de restriction	Restriction
Longueur	Ne doivent pas contenir plus de 254 caractères Unicode Ne doivent pas être vides
Caractères spéciaux	Ne doivent pas contenir d'espaces blancs à gauche ni en fin de chaîne Ne doivent pas contenir deux espaces consécutifs Ne doivent pas contenir de barres obliques inverse (\)
Portée	Étant donné que les listes globales sont disponibles dans tous les projets, elles ne doivent pas contenir d'éléments définis au niveau du projet, par exemple des définitions de comptes de groupes spécifiques au projet.

Le tableau suivant décrit les restrictions s'appliquant à une liste globale.

Type de restriction	Restriction
Nombre d'éléments	La liste globale ne doit pas être vide. Elle doit contenir au moins un élément LISTITEM.
Unicité	Le nom de la liste globale ne doit être identique à aucun autre nom de liste globale dans Team Foundation Server.

Restrictions pour les modèles de processus

Un modèle de processus est un jeu d'éléments de travail, de requêtes d'élément de travail, de modèles de produit, de rapports, de groupes de sécurité et de recommandations par défaut qui influencent la structure d'un projet dans Team Foundation. Team Foundation Server inclut deux modèles de processus par défaut qui comprennent deux styles différents pour la gestion du cycle logiciel. Vous pouvez personnaliser ces modèles pour refléter les besoins spécifiques de votre organisation. Pour plus d'informations, consultez Personnalisation des modèles de processus.

Le tableau suivant décrit les restrictions sur les modèles de processus.

Type de restriction	Restriction
Longueur des noms de modèles de processus	Ne doivent pas contenir plus de 256 caractères Unicode.
Unicité des noms de modèles de processus	Doivent être unique sur le serveur Team Foundation. Si vous téléchargez un modèle avec le même nom qu'un modèle existant, ce dernier est remplacé.
Taille de fichiers des modèles de processus	La taille du fichier de modèle de processus ne doit pas dépasser 2 Go (gigaoctets).

Restrictions pour Team Foundation Build

Team Foundation Build permet de gérer tous les aspects du processus de génération sur un ordinateur unique. Grâce à Team Foundation Build, vous pouvez synchroniser les sources, compiler l'application, exécuter des tests unitaires associés, effectuer une analyse de code, générer des builds sur un serveur de fichiers et publier des rapports de builds.

Restrictions sur l'ordinateur de build

Team Foundation Build est une installation distincte de la couche Application Team Foundation Server, de la couche Données ou du client Visual Studio. Vous pouvez désigner un ordinateur distinct. Sinon, vous pouvez installer la build côte à côte sur l'ordinateur client ou sur les serveurs.

Le tableau suivant décrit les restrictions pour l'ordinateur de build.

Type de restriction	Restriction
Espace disque	Doit contenir suffisamment d'espace pour la build (un espace insuffisant entraîne l'échec des builds).
Répertoire de build	Doit être un chemin d'accès local (par exemple, C:\builddirectory).
Répertoire d'emplacement cible	Doit être un chemin UNC (par exemple, \\server\share).
Autorisations d'emplacement cible	Chaque build générée est placée dans un nouveau répertoire du dossier cible. Le compte de service Team Foundation Server (par exemple, Domain\TFSSERVICE) doit avoir un accès d'autorisation de contrôle total à l'emplacement cible UNC. L'emplacement cible UNC doit être un dossier partagé.
Compte de Service Team Foundation Build	Si vous modifiez le compte de service Team Foundation Server après l'installation initiale, vous devez vous assurer que les conditions suivantes sont réunies. Le compte est membre du groupe Build Services. Le compte a des autorisations de lecture/écriture sur les dossiers temporaires et le dossier temporaire ASP.NET. Le compte a l'autorisation de contrôle total sur le répertoire de build et l'emplacement cible.
Problèmes de pare-feu	Si le pare-feu de l'ordinateur de build est activé, vérifiez que le programme tfsbuildservice figure dans la liste d'exceptions.

Noms de types de build

Team Foundation Build utilise des types de build pour configurer les conditions sous lesquelles une solution unique ou un ensemble de solutions dans un projet d'équipe sera généré. Pour effectuer une génération, vous devrez créer un type de build ou utiliser un type de build existant. Pour plus d'informations sur les types de build, consultez Définir votre processus de build.

Le tableau suivant décrit les restrictions sur les noms de type de build.

Type de restriction	Restriction
Unicité	Ne doivent être identiques à aucun autre nom de type de build dans le projet
Caractères spéciaux	Ne doivent pas contenir le caractère imprimable suivant : $

Noms de qualité des builds

La qualité de build vous permet de joindre un niveau de qualité ou un état d'achèvement à une build terminée. Team Foundation Build vous permet également de créer des valeurs pour le type de qualité de build. Pour plus d'informations, consultez Créer une définition de build de base. Pour obtenir une liste des valeurs de qualité de build par défaut, consultez Évaluer la qualité d'une build terminée.

Le tableau suivant décrit les restrictions sur les noms de qualité de build.

Type de restriction	Restriction
Longueur	Ne doivent pas contenir plus de 256 caractères Unicode
Unicité	Ne doivent être identiques à aucun autre nom de qualité de build sur l'ordinateur Team Foundation Build

Restrictions pour le contrôle de version

Le contrôle de version de Team Foundation fournit un référentiel central pour les fichiers et les commandes nécessaires pour gérer ces fichiers à travers une équipe. Il fournit également des stratégies d'archivage, de création de branches, de fusion, de réservation personnalisables et beaucoup d'autres fonctionnalités.

Chemins d'accès au serveur de contrôle de version

Le chemin d'accès du serveur de contrôle de version est l'emplacement de chemin complet d'un fichier stocké dans le contrôle de version.

Le tableau suivant décrit les restrictions sur la longueur du chemin d'accès du serveur de contrôle de version.

Type de restriction	Restriction
Longueur	Ne doit pas contenir plus de 248 caractères Unicode pour un répertoire. Ne doit pas contenir plus de 260 caractères Unicode pour un répertoire combiné et un nom de fichier.

Ajout de fichiers dans le contrôle de version

Le système de contrôle de version stocke de nombreux types de fichiers différents. Pour plus d'informations sur l'ajout de projets ou de solutions Visual Studio existants dans le contrôle de version, consultez Copie de fichiers sous contrôle de version. Vous pouvez également ajouter des fichiers ou dossiers qui ne sont pas associés à un projet ou une solution Visual Studio. Pour plus d'informations, consultez Ajouter au contrôle de version des fichiers et des dossiers non liés au projet ou à la solution.

Le tableau suivant décrit les restrictions appliquées aux fichiers et dossiers à ajouter au contrôle de version.

Type de restriction	Restriction
Extensions du fichier	Ne doivent pas contenir les caractères imprimables suivants : / \ : * ? « < > |
Dossiers	Ne doivent pas être vides Ne doivent pas contenir les fichiers qui ont des modifications en attente Ne doivent pas résider en dehors du répertoire mappé pour l'espace de travail actif

Noms d'étiquettes

Dans le contrôle de version de Team Foundation, une étiquette est un nom appliqué à un ensemble spécifique de révisions. Vous pouvez joindre des étiquettes à un ensemble de fichiers non liés dans le contrôle de version. Cela permet de récupérer les fichiers ou d'agir sur eux en tant que groupe. Pour plus d'informations, consultez Utiliser des étiquettes pour prendre un instantané de vos fichiers. Le tableau suivant décrit les restrictions appliquées aux noms d'étiquettes.

Type de restriction	Restriction
Longueur	Ne doivent pas contenir plus de 64 caractères Unicode
Caractères spéciaux	Ne peuvent pas se terminer par un espace ( ) ni par un point (.) Ne doivent pas contenir les caractères imprimables suivants : " / : < > \ | * ? @

Jeux de réservations

Le jeu de réservations permet de mettre temporairement de côté un lot de modifications en attente et de supprimer éventuellement les modifications en attente de votre espace de travail. Vous pouvez ultérieurement restaurer les modifications d'un jeu de réservations vers votre espace de travail ou les placer dans celui d'un autre utilisateur. Pour plus d'informations, consultez Utilisation de jeux de réservations.

Le tableau suivant décrit les restrictions sur les noms de jeux de réservations.

Type de restriction	Restriction
Longueur	Ne doivent pas contenir plus de 64 caractères Unicode
Caractères spéciaux	Ne doivent pas contenir les caractères imprimables suivants : " / : < > \ | * ? ;

Noms d'espaces de travail

Un espace de travail est une copie côté client des fichiers et dossiers de contrôle de version Team Foundation. Lorsque vous créez plusieurs espaces de travail, vous pouvez avoir différentes versions du même dossier de contrôle de version sur un ordinateur client. Pour plus d'informations sur les espaces de travail, consultez Créer un espace de travail pour utiliser le projet de votre équipe. Le tableau suivant décrit les restrictions sur les noms d'espaces de travail.

Type de restriction	Restriction
Longueur	Ne doivent pas contenir plus de 64 caractères Unicode
Caractères spéciaux	Ne peuvent pas se terminer par un espace ( ) Ne doivent pas contenir les caractères imprimables suivants : " / : < > \ | * ? ;

Voir aussi

Tâches

Créer un groupe au niveau de la collection

Créer un groupe de projets d'équipe

Ajouter des utilisateurs à un groupe par défaut

Ajouter un utilisateur directement à un projet d'équipe ou à une collection de projets d'équipe

Créer une définition de build de base

Évaluer la qualité d'une build terminée

Ajouter au contrôle de version des fichiers et des dossiers non liés au projet ou à la solution

Concepts

Personnalisation des données de suivi de projet, de formulaires, de flux de travail et d'autres objets

Définition du texte d'aide d'un champ d'élément de travail

Définition des listes globales

Utiliser des étiquettes pour prendre un instantané de vos fichiers

Utilisation de jeux de réservations

Créer un espace de travail pour utiliser le projet de votre équipe

Autres ressources

Personnalisation des modèles de processus

Définir votre processus de build

Copie de fichiers sous contrôle de version

Field Reference Names

Historique des modifications

Date	Historique	Motif
Décembre 2010	Informations mises à jour sur les restrictions applicables aux noms des jeux de réservations et des espaces de travail.	Commentaires client.
Octobre 2010	Informations mises à jour sur l'unicité requise des noms de projets d'équipe.	Commentaires client.