Partager via

Restrictions et conventions de nommage

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

Cet article décrit les règles d’affectation de noms, les conventions et les restrictions pour les composants Azure DevOps. Les règles de nommage, les restrictions et les conventions permettent de garantir une expérience utilisateur cohérente et de garantir la compatibilité avec d’autres applications.

Considérations d’ordre général

Les restrictions courantes incluent le fait de ne pas dépasser une certaine longueur de caractères pour un nom, de ne pas comporter de caractères spéciaux et de maintenir l’unicité des noms au sein d’un jeu d’objets.

  • Les restrictions de longueur comptent le nombre de caractères Unicode. Les caractères de substitution sont composés de deux caractères Unicode, qui comptent par rapport à la restriction de longueur sous la forme de deux caractères. Pour plus d’informations, consultez À propos d’Unicode et des jeux de caractères.

  • Comme pour les autres fichiers du système d’exploitation, les caractères de contrôle ASCII 1 à 31 et les combinaisons de substitution ne sont pas autorisés. Pour plus d’informations sur les restrictions du système d’exploitation appliquées aux noms de fichiers, consultez Noms de fichiers, chemins d’accès et espaces de noms.

  • Pour connaître les limites pour le nombre d’éléments que vous pouvez définir, consultez Limites du suivi du travail, des processus et des projets.

Importante

Lorsque vous utilisez les API Azure DevOps plutôt que l’interface utilisateur, vous pouvez spécifier directement un nom qui peut inclure des caractères restreints dans l’interface utilisateur. Pour maintenir la cohérence et empêcher les problèmes inattendus, suivez les restrictions de l’interface utilisateur. Validez les noms par programmation et gérez les caractères spéciaux de manière appropriée.

Noms réservés par le système

Évitez d’utiliser des noms réservés système comme les exemples suivants :

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

Pour en savoir plus sur les noms réservés, consultez Noms de fichiers, chemins d’accès et espaces de noms.

Artifacts d'Azure

Les packages et flux universels Azure Artifacts doivent être conformes aux restrictions suivantes :

Type de restriction Limitation
Nom du package - Doit être en minuscules.
- Doit commencer et se terminer par des caractères alphanumériques.
- Peut contenir uniquement des caractères alphanumériques et des traits d’union non consécutifs -, des traits de soulignement _ ou des points ..
Version du package - Doit être en minuscules sans métadonnées de build.
Nom du flux - Doit commencer et se terminer par des caractères alphanumériques.
- Non sensible à la casse, mais ne peut pas différer d’un autre nom de flux uniquement par mise en majuscule.
- Impossible de commencer par un point . ou un trait de soulignement _, ou de terminer par un point ..
- Impossible d’inclure l’un des caractères suivants : @~;{}'+=,<>|/\?:&$*"#[]%.

Azure Boards

Azure Boards utilise des éléments de travail pour planifier et suivre les projets de développement de logiciels. Les éléments de travail décrivent le travail à effectuer, affecter le travail, suivre l’état et coordonner les efforts au sein d’une équipe. Différents types d’éléments de travail, tels que les récits utilisateur, les tâches, les bogues et les problèmes, effectuent le suivi de différents types d’informations. Pour plus d’informations, consultez la documentation Azure Boards.

Les objets de suivi des éléments de travail sont associés à un ou plusieurs noms. Tous les objets, à l’exception des types d’éléments de travail et des listes globales, ont des noms d’affichage conviviaux, qui sont des identificateurs uniques et visibles par l’utilisateur pour les champs. L’utilisation de noms conviviaux garantit la cohérence entre les projets et les types d’éléments de travail dans une collection de projets.

Les types d’éléments de travail et les listes globales sont associés aux noms de référence. Le système utilise les noms de référence en interne et vous ne pouvez pas les modifier une fois définis.

Plusieurs éléments associés aux éléments de travail ont des restrictions, notamment les noms de référence, les noms conviviaux, les noms de champs et la taille des pièces jointes.

Chemins d'accès d'itération et de zone

Les champs Chemin de zone et Chemin d'itération fournissent une hiérarchie de structure d’arborescence pour regrouper le travail. Les chemins d’accès de zone regroupent les éléments de travail par produit, fonction ou zone de fonctionnalité. Les chemins d’itération regroupent les éléments de travail en sprints, jalons ou périodes pour accomplir les tâches.

Ces champs à plusieurs nœuds utilisent la barre oblique \ inverse pour indiquer la hiérarchie des nœuds au sein de l’arborescence. Les noms que vous attribuez aux nœuds enfants doivent être conformes aux restrictions suivantes.

Type de restriction Limitation
Longueur de nœud Ne doit pas contenir plus de 255 caractères.
Noms réservés - Ne doit pas se composer uniquement d’une période . ou de deux périodes ...
- Ne doit pas être un nom réservé par le système, tel que PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON ou AUX. Pour en savoir plus sur les noms réservés, consultez Noms de fichiers, chemins d’accès et espaces de noms.
Caractères spéciaux pour les nœuds - Ne doit pas contenir de caractères de contrôle Unicode.
- Ne doit contenir aucun des caractères suivants : \ / : * ? " < > | # $ & * +.
- Ne doit pas contenir de caractères interdits par le système de fichiers local. Pour plus d’informations sur les restrictions de caractères Windows, consultez Nommage des fichiers, Chemins et Espaces de noms.
Longueur des chemins d'accès Ne doit pas comporter plus de 4 000 caractères Unicode.
Niveau de détail de la hiérarchie des chemins d'accès Doit être inférieur à 14 niveaux de profondeur.

Pièces jointes

Les fichiers joints aux éléments de travail doivent respecter les restrictions suivantes :

Type de restriction Limitation
Taille de fichier Ne doit pas dépasser la taille maximale :
- Taille maximale par défaut : 4 096 kilo-octets.
- Taille maximale absolue : 2 giga-octets.

Pour plus d'informations, voir Comment définir la taille maximale des pièces jointes pour les documents de travail.

Noms des colonnes et des couloirs du tableau

Un tableau fournit un flux de visualisation du travail en attente. À mesure que le travail passe de la planification à la fin, vous mettez à jour les éléments du tableau. Chaque colonne représente une étape de travail, et chaque carte représente un élément de travail à ce stade de travail.

Vous pouvez personnaliser un tableau en ajoutant, en supprimant ou en renommant des colonnes et des swimlanes. Les colonnes soutiennent le flux de travail à travers le tableau, et les swimlanes vous permettent de gérer différents travaux comme des voies horizontales sur le tableau.

Les noms des colonnes et des couloirs doivent respecter les restrictions suivantes.

Type de restriction Limitation
Length Ne doit pas comporter plus de 256 caractères Unicode.
Unicité - Les noms de colonnes ne doivent être identiques à aucun autre nom de colonne du tableau.
- Les noms des couloirs ne doivent pas être identiques à ceux des autres couloirs du tableau.
Caractères spéciaux Ne doit pas comporter de caractères de contrôle Unicode ni de caractères de substitution.

Noms de champs

Chaque type d’élément de travail contient un ou plusieurs champs qui définissent les informations stockées pour ce type d’élément de travail. Chaque champ d’élément de travail a un nom de référence de champ associé qui identifie de manière unique le champ et ne peut pas être modifié une fois affecté. Pour plus d’informations sur les champs d’élément de travail intégrés, consultez l’index du champ Élément de travail.

Les noms des champs d’élément de travail sont limités à la collection de projets. Si vous renommez un nom de champ, vous le modifiez pour tous les éléments de travail et les types d’éléments de travail définis dans tous les projets de la collection.

Les noms de champs d’élément de travail doivent respecter les restrictions suivantes :

Type de restriction Limitation
Length Ne doit pas comporter plus de 128 caractères Unicode.
Unicité Doit être unique au sein de l’organisation ou de la collection de projets.
Caractères spéciaux - Doit contenir au moins un caractère alphabétique.
- Ne doit contenir aucun des caractères suivants : .,;':~\/*?"&%$!+=()[]{}<>-|.
- Ne doit pas comporter d’espaces au début ou à la fin.
- Ne doit pas comporter deux espaces consécutives ou plus.

Noms de référence de champ

Le langage de définition du type d’élément de travail inclut le concept d’un nom de référence de champ. Les noms de référence de champ peuvent vous aider à porter des définitions entre les collections de projets Team Foundation et autoriser les intégrations non-Microsoft à rechercher et faire référence à des champs spécifiques. Ces noms, comme les espaces de noms dans les applications .NET Framework, sont globalement uniques.

Les champs suivants sont définis dans une définition de type d’élément de travail des modèles de processus :

  • L’espace de noms Système n’est utilisé que pour définir tous les champs système principaux obligatoires pour les fonctions système de Team Foundation. Vous ne pouvez pas créer votre propre System.X champ, car il peut entraver les fonctionnalités.

  • L’espace de noms Microsoft est utilisé pour définir les champs de suivi des éléments de travail. Bien que vous puissiez créer votre propre Microsoft.X champ, il n’est pas recommandé, car il peut entraver les fonctionnalités ou la possibilité de mettre à jour un projet après une mise à niveau.

Les clients et partenaires peuvent créer leurs propres espaces de noms de champs pour les types d’éléments de travail personnalisés. Pour obtenir des descriptions des champs système et des champs définis dans les modèles de processus par défaut, consultez l’index des champs d’élément de travail.

Importante

Vous ne pouvez pas modifier les noms de référence de champ. Par exemple, si vous modifiez le nom du champ En-tête, le nom de référence de champ de ce champ ne change pas. Les intégrations et les représentations internes des champs doivent utiliser le nom de référence de champ au lieu du nom de champ.

Exemples de noms de référence de champ

Les exemples suivants montrent des noms de référence de champ valides dans différents espaces de noms.

Exemples d’espaces de noms système Exemples d’espaces de noms Microsoft Autres exemples d’espaces de noms
System.Id, System.Title, System.CrééPar, System.DateDeCréation, System.ChangéPar, System.DateDeChangement, System.État, System.Raison 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 FabrikamFiber.Common.Severity, FabrikamFiber.Common.Phase, FabrikamFiber.RiskManagement.RiskType, FabrikamFiber.RiskManagement.Resolution

Contoso.Common.PrioritéCommerciale, Contoso.Bug.TrouvéDansLaPhase, Contoso.Bug.CorrigéDansLaPhase

Texte d’aide sur le champ

Le système affiche du texte d’aide au moment de l’exécution pour aider les utilisateurs à savoir quoi entrer dans le champ. Le texte d’aide est limité à un type d’élément de travail spécifique dans un projet spécifique.

Pour le processus d’héritage, vous spécifiez le texte d’aide d’un champ dans la boîte de dialogue Modifier le champ, dans l’onglet Définition, Description. Consultez Ajouter un champ personnalisé à un type d’élément de travail. Pour le processus XML local, vous spécifiez le texte d’aide à l’aide de l’élément HELPTEXT . Consultez Ajouter ou modifier un champ pour le suivi du travail.

Le texte d’aide que vous ajoutez doit respecter les restrictions suivantes.

Type de restriction Limitation
Length Ne doit pas comporter plus de 255 caractères Unicode.

Listes globales

Lorsque vous définissez des types d’éléments de travail, vous constaterez peut-être que certains champs d’élément de travail partagent le même ensemble de valeurs autorisées ou suggérées. Une liste globale est un ensemble de valeurs d’élément de liste que vous pouvez définir une seule fois et utiliser globalement dans toutes les collections de projets dans une instance d’Azure DevOps Server local.

Une liste globale définie à l’aide de l’élément GLOBALLIST contient un ou plusieurs éléments de liste spécifiés à l’aide de l’élément LISTITEM . Pour en savoir plus, consultez Définir des listes globales.

Les listes globales doivent respecter les restrictions suivantes.

Type de restriction Limitation
Unicité La liste globale doit être unique dans l’instance Azure DevOps Server.
Nombre d’articles Ne doit pas être vide. La liste globale doit comporter au moins un élément LISTITEM.

Les noms LISTITEM doivent respecter les restrictions suivantes.

Type de restriction Limitation
Length - Ne doit pas comporter plus de 254 caractères Unicode.
- Ne doit pas être vide.
Caractères spéciaux - Ne doit pas comporter d’espace au début ou à la fin.
- Ne doit pas comporter deux espaces consécutives.
- Ne doit pas contenir le symbole de barre oblique inversée \.
Portée Comme les listes globales sont disponibles parmi tous les projets, elles ne doivent pas comporter d’éléments définis au niveau du projet, comme des définitions de compte de groupe spécifiques au projet.

Définissez un nom de référence lorsque vous ajoutez ou créez un type de lien ou une catégorie.

Type de restriction Limitation
Length Ne doit pas comporter plus de 70 caractères Unicode.
Unicité - Ne doit pas être identique à n’importe quel autre nom de référence de champ dans la collection de projets.
- Ne doit pas être identique à un autre nom de référence de champ après que le système traite les noms pour remplacer tous les points par des traits de soulignement ._. Par exemple, les noms My._Field de référence de champ et My..Field traiteraient tous les deux comme le même nom : My__Field.
Caractères spéciaux - Peut utiliser des caractères alphanumériques, des traits de soulignement, des traits d’union et des points.
- Impossible de contenir des traits d’union consécutifs --.
- Doit contenir au moins une période ., mais ne peut pas commencer ou se terminer par une période.
- Impossible de commencer par un chiffre ou un trait de soulignement _.

Noms de requête de tâche

Vous pouvez utiliser des requêtes d’élément de travail pour répertorier les éléments de travail en fonction des critères de champ que vous spécifiez. Pour plus d’informations, consultez À propos des requêtes gérées.

Type de restriction Limitation
Length Ne doit pas comporter plus de 255 caractères Unicode.
Caractères spéciaux - Impossible d’être vide.
- Ne doit contenir aucun des caractères suivants : /\<>*?"+|:.
Unicité - Doit être contenu dans un dossier et être nommé de manière unique dans le dossier.

Noms des balises d’élément de travail

Les balises d’élément de travail se composent d’un ou deux mots clés qui filtrent ou définissent des outils de suivi de travail tels que les backlogs, les tableaux et les requêtes. Pour en savoir plus, consultez Ajouter des balises d’élément de travail pour classer et filtrer les listes et tableaux.

Les noms des balises doivent respecter les restrictions suivantes :

Type de restriction Limitation
Length - Ne doit pas comporter plus de 400 caractères Unicode.
- Ne doit pas être Null ni vide.
Caractères spéciaux - Ne doit pas contenir de caractères , de séparation ou ;.
- Ne doit pas contenir de caractères de contrôle ou de format Unicode tels que les flux de ligne, les séparateurs de paragraphes, les retours chariots ou d’autres caractères de substitution incompatibles.

Azure Pipelines

Les objets Azure Pipeline doivent se conformer aux restrictions d’affectation de noms suivantes.

Type d’objet Limitation
Expressions - Doit commencer par un caractère alphabétique minuscule ou majuscule ou un trait de soulignement, suivi de caractères alphabétiques minuscules ou majuscules, de chiffres ou de traits de soulignement_.
Variables - Doit contenir uniquement des caractères alphanumériques, des points ., et des tirets bas _.
- Impossible de commencer par les préfixes réservés endpoint, input, secret, path ou securefile, sans tenir compte de la casse.
Étapes - Le nom de l’étape doit contenir uniquement des caractères alphanumériques et des soulignements _.
- Le nom ne doit pas commencer par un chiffre.
Tâches et tâches de déploiement - Le nom du travail doit contenir uniquement des caractères alphanumériques et des traits de soulignement _.
- Le nom ne doit pas commencer par un chiffre.
- Le nom ne peut pas contenir de mots clés tels que deploy.
Stratégie de travail matricielle - Le nom de la configuration de matrice doit contenir uniquement des caractères alphanumériques et des traits de soulignement _.
- Le nom doit commencer par un caractère alphabétique.
- Longueur maximale : 100 caractères.
Créer une ressource - L’alias ou le nom de l’artefact de build doit contenir uniquement des caractères alphanumériques, des traits d’union -, et des traits de soulignement _.
Ressources sur les conteneurs - L’ID de conteneur doit contenir uniquement des caractères alphanumériques, des traits -d’union et des traits de _soulignement.
Ressources du paquet - L'alias d'artefact de package doit contenir uniquement des caractères alphanumériques, des traits d'union et des traits de soulignement.
Ressources de pipeline - L’ID de pipeline doit contenir uniquement des caractères alphanumériques, des traits d’union - et des traits de soulignement _.
Ressources du référentiel - L’alias du référentiel doit contenir uniquement des caractères alphanumériques, des traits -d’union et des traits de _soulignement.
Les ressources webhook - Le nom du webhook doit contenir uniquement des caractères alphanumériques, des traits d’union - et des traits de soulignement _.
Étapes - L’ID du nom de l’étape doit contenir uniquement des caractères alphanumériques, des traits d'union - et des traits de soulignement _.

Pour plus d’informations, consultez la documentation Azure Pipelines.

Azure Repos

Les dépôts Azure Repos peuvent être basés sur Git ou Team Foundation Version Control (TFVC).

Chaque projet Azure DevOps peut comporter plusieurs dépôts Git. Pour plus d’informations, consultez la documentation Git d’Azure Repos.

Les noms de référentiel Git doivent être conformes aux restrictions suivantes.

Type de restriction Limitation
Length Ne doit pas comporter plus de 64 caractères Unicode.
Unicité Ne doit être identique à aucun autre nom de dépôt Git dans le projet.
Caractères spéciaux - Ne doit pas comporter de caractères de contrôle Unicode ni de caractères de substitution.
- Ne doit pas contenir les caractères imprimables suivants : \/:*?"<>;#$*{},+=[]|.
- Ne doit pas commencer par un trait de soulignement _.
- Ne doit pas démarrer ou se terminer par un point ..
- Ne doit pas être un nom réservé par le système.
- Important : Bien que vous puissiez inclure des espaces dans les noms de référentiel, il n’est pas recommandé.

Pour plus d’informations sur les restrictions d’affectation de noms pour d’autres éléments Git tels que les branches et les balises, consultez git check-ref-format.

Noms d’ordinateur

Le nom de l’ordinateur où vous installez Azure DevOps est associé au nom du serveur. Le système d’exploitation et Active Directory imposent certaines restrictions sur les noms d’ordinateurs, comme décrit dans les articles suivants :

Team Foundation Build (outil de construction d'équipe)

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

Ordinateur de build

Team Foundation Build est une installation distincte du niveau d’application Azure DevOps Server, de la couche de données ou du client Visual Studio. Vous pouvez choisir un ordinateur distinct ou installer la build côte à côte sur l’ordinateur client ou les serveurs.

Votre ordinateur de build local doit respecter les restrictions suivantes.

Type de restriction Limitation
Espace disque Doit contenir suffisamment d’espace pour la build, car l’espace insuffisant entraîne l’échec des builds.
Répertoire de build Doit être un chemin local tel que C :\BuildDirectory.
Répertoire d’emplacement de dépôt Doit être un chemin UNC tel que \server\share*.
Autorisations d’emplacement de dépôt Chaque build généré doit être placé dans un nouveau répertoire dans le dossier de dépôt.
- Le compte service Team Foundation Server, par exemple Domain\TFSSERVICE, doit avoir un accès Contrôle total à l'emplacement de dépôt UNC.
- L’emplacement de dépôt UNC doit être un dossier partagé.
Compte Team Foundation Build Service Si vous modifiez le compte de service TFS après l’installation initiale, vous devez vous assurer que :
- Le compte est membre du groupe Build Services.
- Le compte dispose d’autorisations de lecture/écriture pour les dossiers temporaires et le dossier temporaire ASP.NET.
- Le compte dispose de l’autorisation Contrôle total sur le répertoire de build et l'emplacement de dépôt.
Firewall Si le firewall est activé sur l’ordinateur de build, assurez-vous que le programme tfsbuildservice figure dans la liste des exceptions.

Types de builds

Les types de build sont les conditions de création d’une solution unique ou d’un ensemble de solutions dans un projet. Pour exécuter une build, vous pouvez créer un nouveau type de build ou utiliser un type de build existant.

Les noms des types de builds doivent respecter les restrictions suivantes.

Type de restriction Limitation
Unicité Ne doit être identique à aucun autre nom de type de build dans le projet.
Caractères spéciaux Ne doit pas contenir le signe dollar $.

Qualité de la build

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

Les noms de qualité de build doivent respecter les restrictions suivantes.

Type de restriction Limitation
Length Ne doit pas comporter plus de 256 caractères Unicode.
Unicité Ne doit pas être identique à tout autre nom de qualité de build sur l’ordinateur Team Foundation Build.

Noms de collection de projets

La collection de projets est la structure d’organisation que vous utilisez pour définir et contrôler un groupe de projets pour Azure DevOps Server. La collection de projets identifie un groupe de projets et leurs ressources. Le nom de la collection de projets fait également partie de la chaîne de connexion utilisée pour connecter les membres de l’équipe aux projets.

Le nom de collection par défaut attribué à une collection de projets correspond à DefaultCollection. Pour plus d’informations, consultez Gérer les collections de projets.

Les noms de collection de projets doivent être conformes aux restrictions suivantes.

Type de restriction Limitation
Length Ne doit pas comporter plus de 64 caractères Unicode.
Unicité - Ne doit être identique à aucun autre nom de collection dans votre déploiement local.
- Si votre déploiement inclut des produits SharePoint ou SQL Server Reporting Services, leurs noms ne peuvent pas être identiques au nom et au chemin complet d’un site SharePoint, d’un serveur de rapports ou d’un site web Reporting Services existant.
Caractères spéciaux - Ne doit pas comporter de caractères de contrôle Unicode ni de caractères de substitution.
- Ne doit pas contenir les caractères imprimables suivants : \/:*?"<>;#$*{},+=[]|.
- Ne doit pas contenir de points de suspension ... ou de point double ...
- Ne doit pas commencer par un trait de soulignement _.
- Ne doit pas démarrer ou se terminer par un point ..
Ne doit pas être un nom réservé par le système.

Noms d’organisation

L’organisation est la structure d’organisation que vous utilisez pour définir et contrôler un groupe de projets pour Azure DevOps Services. L’organisation identifie un groupe de projets et leurs ressources.

Importante

Suivez ces instructions lorsque vous créez le nom de votre organisation :

  • Utilisez uniquement des lettres de l’alphabet anglais
  • Le nom de votre organisation doit débuter par une lettre ou un chiffre
  • Utilisez des lettres, des chiffres ou des traits d’union après le caractère initial
  • Conserver le nom de votre organisation sous 50 caractères Unicode
  • Doit se terminer par une lettre ou un chiffre

Si vous utilisez des caractères non autorisés, le message d’erreur suivant s’affiche : VS850015 : le nom spécifié n’est pas autorisé à être utilisé : {Nom de l’organisation}.

Processus et modèles de processus

Un processus définit les blocs de construction du système de suivi des éléments de travail et d’autres sous-systèmes auxquels vous pouvez accéder après la connexion à un projet. Les modèles de processus et de processus font référence à un ensemble interdépendant de fichiers utilisés pour créer un projet. Pour plus d’informations sur les processus par défaut, consultez À propos des processus et des modèles de processus.

Les processus que vous définissez ou personnalisez doivent respecter les restrictions suivantes.

Type de restriction Limitation
Length Ne doit pas comporter plus de 256 caractères Unicode.
Unicité - Doit être unique dans Azure DevOps. Si vous chargez un modèle portant le même nom qu’un modèle existant, le modèle existant est remplacé.
Taille du fichier de modèle de processus Ne doit pas dépasser 2 gigaoctets.

Noms de projets

Un projet établit un dépôt pour le code source et un emplacement afin que les équipes puissent planifier, suivre la progression et collaborer. Le nom du projet fait partie de la chaîne de connexion permettant de connecter les membres de l’équipe aux projets.

Les noms que vous attribuez aux projets que vous créez doivent respecter les restrictions suivantes.

Type de restriction Limitation
Length Ne doit pas comporter plus de 64 caractères Unicode.
Unicité Ne doit pas être identique à un autre nom dans l’organisation, la collection de projets ou l’application web SharePoint ou le rapport SQL Server pour la collection.
Noms réservés - Ne doit pas être un nom réservé par le système.
- Ne doit pas être l’un des segments masqués utilisés pour le filtrage des requêtes IIS comme App_Browsers, , App_code, App_DataApp_GlobalResources, App_LocalResources, , App_Themes, , App_WebResourcesbinou web.config.
Caractères spéciaux - Ne doit pas comporter de caractères de contrôle Unicode ni de caractères de substitution.
- Ne doit pas contenir les caractères imprimables suivants : \/:*?"'<>;#$*{},+=[]|.
- Ne doit pas commencer par un trait de soulignement _.
- Ne doit pas démarrer ou se terminer par un point ..

Groupes de sécurité

Vous pouvez utiliser des groupes de sécurité Azure DevOps pour appliquer certains droits ou autorisations à un groupe d’utilisateurs. Les groupes peuvent être constitués d’ID Microsoft Entra ou de comptes Active Directory, de groupes de sécurité Azure DevOps, d’utilisateurs windows ou de comptes de groupe, ou d’une combinaison. Pour en savoir plus, consultez Ajouter des utilisateurs ou groupes Active Directory/Microsoft Entra à un groupe de sécurité intégré.

Les groupes de sécurité doivent respecter les restrictions suivantes.

Type de restriction Limitation
Longueur du nom du compte de groupe de sécurité Ne doit pas comporter plus de 256 caractères Unicode.
Unicité - Les comptes de groupe au niveau du projet ne doivent pas porter le même nom qu’un autre groupe dans le même projet.
- Les comptes de groupe au niveau de l’organisation ou du regroupement ne doivent correspondre à aucun autre nom d’un compte de groupe dans l’organisation ou la collection de projets.
Noms de groupes réservés Ne doit pas comporter de $NAMESPACE dans le nom au niveau du projet ou du serveur.
Caractères spéciaux - Ne doit pas comporter de caractères de contrôle Unicode ni de caractères de substitution.
- Ne doit pas contenir les caractères imprimables suivants : ,/\[]:<>+=;?*|.
- Ne doit pas inclure de caractères non imprimables dans la plage de valeurs ASCII comprise entre 1 et 31.
- Ne doit pas se terminer par un point ..

Noms d’équipes

Les noms d’équipe identifient un groupe d’individus ou de groupes qui travaillent ensemble en tant qu’équipe dans un projet. Ce nom permet aux membres de l’équipe de se connecter à l’équipe ou d’interroger les membres définis pour une équipe. Les noms d’équipes doivent respecter les conventions qui leur permettent de s’afficher dans le cadre d’une URL valide.

Chaque nom d’équipe doit être unique dans un seul projet, mais il n’existe aucune restriction sur l’utilisation du même nom d’équipe dans différents projets au sein d’une organisation ou d’une collection de projets. Pour en savoir plus, consultez Ajouter une autre équipe ou une hiérarchie d’équipes.

Les noms d’équipes doivent respecter les restrictions suivantes.

Type de restriction Limitation
Length Ne doit pas comporter plus de 64 caractères Unicode.
Unicité Ne doit pas être identique à un autre nom d’équipe dans le projet.
Noms réservés Ne doit pas être un nom réservé par le système.
Caractères spéciaux - Ne doit pas comporter de caractères de contrôle Unicode ni de caractères de substitution.
- Ne doit pas contenir les caractères imprimables suivants : \/:*?"<>;#$*{},+=[]|.
- Ne doit pas contenir de points de suspension ... ou de point double ...
- Ne doit pas commencer par un trait de soulignement _.
- Ne doit pas démarrer ou se terminer par un point ..

Noms de comptes d’utilisateur

Les comptes d’utilisateur identifient les utilisateurs ajoutés à un projet ou à une collection de projets. Les comptes d’utilisateur peuvent correspondre aux entrées dans Active Directory, Microsoft Entra ID ou groupe de serveurs Windows.

Pour ajouter des comptes d’utilisateur à un projet, consultez Ajouter des utilisateurs à un projet ou une équipe. Les comptes d’utilisateur que vous ajoutez à une organisation ou à une collection doivent respecter les restrictions suivantes.

Type de restriction Limitation
Longueur du nom de compte Ne doit pas comporter plus de 256 caractères Unicode.
Unicité Ne doit correspondre à aucun autre compte d’utilisateur dans l’organisation ou la collection de projets.
Noms de groupes réservés Ne doit pas comporter de $NAMESPACE dans le nom au niveau du projet ou du serveur.
Caractères spéciaux - Ne doit pas inclure les caractères imprimables suivants : ,."/\[]:<>+=;?*|
- Ne doit pas inclure de caractères non imprimables dans la plage de valeurs ASCII comprise entre 1 et 31.
- Ne doit pas se terminer par un point . ou le symbole du dollar $.
- Ne doit pas inclure les catégories Unicode suivantes : LineSeparator, , ParagraphSeparatorControl, Format, OtherNotAssigned.

Noms de pages et de fichiers Wiki

Chaque page wiki correspond à un fichier dans le référentiel Git wiki. Les restrictions suivantes s’appliquent aux noms de fichiers de page et à la taille de fichier :

  • Nom du fichier : lorsque vous choisissez un nom pour le fichier de page, n’oubliez pas que le chemin complet du fichier doit comporter 235 caractères ou moins. Le chemin complet de la page se compose de l’URL du dépôt, du chemin d’accès du dossier au fichier de page et du nom du fichier de page. Par exemple : https://github.com/ExampleWiki/Contributors/Code/How-to-add-code-to-the-project.md.

  • Unicité : le nom du fichier de page doit être unique dans son emplacement de dossier dans la hiérarchie du référentiel wiki. Le nom est sensible à la casse.

  • Caractères spéciaux : le nom du fichier de page a des restrictions sur les caractères spéciaux suivants :

    • Aucun caractère de contrôle Unicode ni caractères de substitution
    • Aucun caractère imprimable : barre oblique /, barre oblique inverse \, dièse #
    • Aucun symbole de point . au début ou à la fin du nom

  • Taille du fichier : la taille maximale du fichier de page est de 18 Mo.

  • Taille du fichier de pièce jointe : la taille maximale de toute pièce jointe à un fichier de page est de 19 Mo.

Caractères spéciaux autorisés

Plusieurs caractères spéciaux sont autorisés dans un nom de fichier de page, tels que le signe deux-points : et le trait d’union -. Par exemple, vous pouvez nommer un fichier Markdown en tant que FAQ :0525 ou Setup-Guide.

Importante

Pour éviter les erreurs dans la syntaxe de page et la navigation dans le navigateur, n’utilisez pas le caractère d’espace ( ) dans les noms de fichiers de page. Si vous nommez vos fichiers de page en fonction du titre de la page, remplacez les espaces du titre de la page par un trait d’union (-) dans le nom du fichier.

Le tableau suivant répertorie les caractères spéciaux autorisés dans les noms de fichiers de page wiki et la chaîne encodée d’URI correspondante :

Caractère Symbole Chaîne d’URI
Deux-points : %3A
Chevron ouvrant < %3C
Chevron fermant > %3E
Astérisque (caractère générique) * %2A
Point d’interrogation ? %3F
Barre verticale | %7C
Trait d’union (tiret) - %2D
Guillemet double " %22

Par exemple, le nom de fichier FAQ :0525 est encodé en tant que FAQ%3A0525.

Contenu connexe

  • Last updated on