Restrictions de dénomination pour Team Foundation Server

Mise à jour : novembre 2007

De nombreux composants de Team Foundation Server respectent certaines restrictions de dénomination. Cela garantit une expérience cohérente à l'utilisateur et offre une 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 projets Team Foundation Server

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 code source

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.

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 Comment : créer un groupe de niveau serveur. Si vous souhaitez créer un groupe de sécurité pour votre projet d'équipe, consultez Comment : 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 Comment : ajouter des utilisateurs à un groupe par défaut.

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 doit pas contenir plus de 256 caractères Unicode
Unicité (comptes de groupe de niveau serveur)	Ne doit être identique à aucun autre nom du compte de groupe de niveau serveur
Unicité (comptes de groupes de projets)	Ne doit être identique à aucun autre nom de groupe du 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 (,)

Remarque :
Vous ne créez pas de comptes d'utilisateurs dans Team Foundation Server. Dans certains cas, vous pouvez ajouter un utilisateur Windows spécifique à un groupe Team Foundation ou à Team Foundation Server lui-même. Pour plus d'informations, consultez Comment : ajouter un utilisateur.

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. Pour renommer un serveur Team Foundation, vous devez suivre les procédures décrites dans Comment : renommer un serveur de couche Application ou Comment : renommer un serveur de couche Données.

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 projets Team Foundation Server

Le nom de projet Team Foundation Server identifie une collection d'éléments de travail, de documents, de rapports, de builds d'équipe et une arborescence de contrôle de code source qui composent un projet Team Foundation particulier. 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 doivent être identiques à aucun autre nom dans Team Foundation Server, Windows SharePoint Services ou SQL Server Reporting Services
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 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.

^{1Pour plus d'informations sur les caractères de substitution, consultez « Ask Dr. International, Column #18 » (}https://go.microsoft.com/fwlink/?LinkId=76840).

Restrictions pour les éléments de travail

Microsoft Visual Studio Team System 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. Pour plus d'informations, consultez Attribution d'une taille limite aux pièces jointes. 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. Pour plus d'informations, consultez Définition des itérations ou des zones initiales d'un 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 types d'éléments de travail. 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. Pour plus d'informations sur les noms de champs d'éléments de travail, consultez Noms des champs.

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 Noms de références des champs. 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 des champs.

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 doit 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 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 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 ensemble d'éléments de travail, de requêtes d'éléments de travail, de modèles de produits, de rapports, de groupes de sécurité et d'aide par défaut influençant la structure d'un projet dans Team Foundation. Team Foundation Server comprend deux modèles de processus par défaut englobant deux styles différents de gestion du cycle de logiciels. 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. Pour plus d'informations, consultez Vue d'ensemble de Team Foundation Build.

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. Pour plus d'informations sur la configuration d'un ordinateur de build, consultez Comment : configurer et installer Team Foundation Build.

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 du service Team 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 un 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 Utilisation de définitions de build dans Team Foundation 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 permet d'affecter un niveau de qualité ou un état d'achèvement à une build exécutée. Team Foundation Build permet également de créer des valeurs pour le type de qualité de build. Pour plus d'informations, consultez Comment : créer une définition de build. Pour obtenir une liste des valeurs de qualité de build par défaut, consultez Comment : définir la qualité de build.

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 code source

Le contrôle de code source 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.

Pour plus d'informations sur le contrôle du code source dans Team Foundation, consultez Contrôle de version Team Foundation.

Chemins d'accès du serveur de contrôle de code source

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

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

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 code source

Le système de contrôle de code source 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 code source, consultez Ajout de projets et de solutions au 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 Comment : 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 code source.

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 code source 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 code source. Cela permet de récupérer les fichiers ou d'agir sur eux en tant que groupe. Pour plus d'informations, consultez Utilisation d'étiquettes. 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 des jeux de réservations du contrôle de version.

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 représente une copie côté client des fichiers et dossiers présents sur le serveur de contrôle de code source. Lorsque vous créez plusieurs espaces de travail, vous pouvez avoir différentes versions du même dossier de contrôle de code source sur un ordinateur client. Pour plus d'informations sur les espaces de travail, consultez Utilisation des espaces de travail du contrôle de version. 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 ( ) ni par un point (.) Ne doivent pas contenir les caractères imprimables suivants : " / : < > \ | * ? @

Voir aussi

Tâches

Comment : créer un groupe de niveau serveur

Comment : créer un groupe de projets d'équipe

Comment : ajouter des utilisateurs à un groupe par défaut

Comment : ajouter un utilisateur

Comment : renommer un serveur de couche Application

Comment : renommer un serveur de couche Données

Comment : configurer et installer Team Foundation Build

Comment : créer une définition de build

Comment : définir la qualité de build

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

Comment : modifier les zones du projet d'équipe

Comment : modifier les itérations du projet d'équipe

Concepts

Administration de Team Foundation Server

Noms des champs

Définition du texte d'aide des champs

Listes globales

Vue d'ensemble de Team Foundation Build

Contrôle de version Team Foundation

Utilisation d'étiquettes

Utilisation des jeux de réservations du contrôle de version

Utilisation des espaces de travail du contrôle de version

Noms de références des champs

Définition des itérations ou des zones initiales d'un projet

Autres ressources

Dépannage de Team Foundation Server

Personnalisation des types d'éléments de travail

Personnalisation des modèles de processus

Utilisation de définitions de build dans Team Foundation Build

Ajout de projets et de solutions au contrôle de version