Gestion des champs de problème dans votre organisation

Les champs de problème vous permettent d’ajouter des métadonnées structurées à des problèmes au sein de votre organisation. Au lieu de vous appuyer sur des étiquettes ou des solutions de contournement en texte libre, vous pouvez créer des champs tels que la priorité, l’effort, l’impact ou toute catégorie personnalisée dont votre équipe a besoin. Les champs sont définis au niveau de l’organisation et s’appliquent à tous les référentiels de votre organisation.

À propos des types de champs de problème

Vous pouvez créer jusqu’à 25 champs d’émission par organisation. Les types de champs suivants sont disponibles :

Sélection unique : choisissez une option dans une liste prédéfinie. Les options peuvent avoir des noms, des descriptions et des couleurs.
Texte : capturer du texte de forme libre. Les URL sont automatiquement détectées et affichées en tant que liens cliquables.
Nombre : acceptez l’entrée numérique, y compris les décimales.
Date : indiquez un sélecteur de dates pour sélectionner des dates.

Champs par défaut

Lorsque les champs de problème sont activés pour votre organisation, quatre champs par défaut sont créés automatiquement :

Priorité (sélection unique) : urgent, élevé, moyen, faible
Effort (sélection unique) : Élevé, Moyen, Faible
Date de début (date )
Date cible (date)

Ces champs par défaut sont associés aux types de tickets comme suit :

Champ	Aucun type	Bug	Tâche	Fonctionnalité
Priority
Effort
Date de début
Date cible

Ces champs par défaut sont entièrement personnalisables. Vous pouvez modifier leurs noms, descriptions et options, ou les supprimer s’ils ne correspondent pas à votre flux de travail.

Conseil

Vous pouvez renommer des options, modifier leurs couleurs, les réorganiser ou ajouter de nouvelles valeurs pour correspondre au flux de travail de votre équipe. Par exemple, vous pouvez modifier les options Effort en tailles T-shirt (XS, S, M, L, XL).

Création d’un champ de problème

Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.
Sélectionnez une organisation en cliquant dessus.
Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.
Dans la section « Planning » de la barre latérale, cliquez sur Champs des tickets.
Cliquez sur Nouveau champ.
Sous « Nom du champ », tapez le nom de votre nouveau champ.
Si vous le souhaitez, sous « Description », tapez une description pour aider d’autres personnes à comprendre l’objectif du champ.
Sous « Type de champ », sélectionnez le type de champ que vous souhaitez créer.
Si vous avez sélectionné Sélection unique, ajoutez des options pour le champ :
- Cliquez sur Ajouter une option et tapez le nom de l’option.
- Si vous le souhaitez, pour définir une couleur pour une option, cliquez en regard de , cliquez **** sur Modifier, choisissez une couleur, puis cliquez sur Enregistrer.
- Répétez cette opération pour ajouter d’autres options.
Sous « Visibilité du champ », choisissez l’une des options suivantes :
- Autorisations : choisissez qui peut voir le champ et sa valeur. Les options sont Organisation uniquement (par défaut) ou Public. Ce paramètre s’applique uniquement aux tickets dans les référentiels publics.
- Épingler à des types: cliquez pour choisir les types de tickets qui affichent ce champ dans l’affichage et la création des tickets. Sélectionnez un ou plusieurs types de problèmes, ou « Problèmes sans type ». Les champs qui ne sont pas épinglés et qui n’ont aucune valeur restent masqués dans l’affichage et la création de tickets.
Cliquez sur Créer.

Modification d’un champ de problème

Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.
Sélectionnez une organisation en cliquant dessus.
Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.
Dans la section « Planning » de la barre latérale, cliquez sur Champs des tickets.
À droite du champ que vous souhaitez modifier, cliquez sur .
Cliquez sur Modifier et apportez vos modifications.
Cliquez sur Enregistrer le champ.

Suppression d’un champ de problème

Lorsque vous supprimez un champ de problème, toutes les valeurs définies sur les problèmes de ce champ sont définitivement supprimées.

Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.
Sélectionnez une organisation en cliquant dessus.
Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.
Dans la section « Planning » de la barre latérale, cliquez sur Champs des tickets.
À droite du champ à supprimer, cliquez sur .
Cliquez sur Supprimer et confirmez la suppression.

Conseil

Si vous ne souhaitez pas utiliser de champs de problème, vous pouvez supprimer tous les champs par défaut de vos paramètres d’organisation. Cela les supprime de tous les problèmes de votre organisation. Vous pouvez recréer des champs à tout moment.

Réorganiser les champs de problème

L’ordre des champs épinglés est géré pour chaque type de ticket. L’ordre des champs détermine comment les champs apparaissent dans la barre latérale du problème et le mode de création du problème.

Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.
Sélectionnez une organisation en cliquant dessus.
Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.
Dans la section « Planification » de la barre latérale, cliquez sur Types de problèmes.
Cliquez sur le type de problème pour lequel vous souhaitez réorganiser les champs.
Sous « Champs de ticket épinglés », faites glisser les champs pour les réorganiser.
Cliquez sur Enregistrer.

Épingler des champs à des types de tickets

Vous pouvez associer des champs de problème à des types de problèmes spécifiques afin que seuls les champs les plus pertinents apparaissent lors de la création ou de l’affichage des problèmes de ce type. Par exemple, vous pouvez épingler « Gravité » aux anomalies et « Impact » aux fonctionnalités.

Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.
Sélectionnez une organisation en cliquant dessus.
Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.
Dans la section « Planning » de la barre latérale, cliquez sur Champs des tickets.
Cliquez sur le champ à épingler.
Sous « Épingler aux types », cliquez sur et sélectionnez les types de tickets pour lesquels ce champ doit s’afficher.
Cliquez sur Enregistrer le champ.

Les champs épinglés apparaissent automatiquement dans la barre latérale du ticket en fonction du type de ticket sélectionné. Pour épingler des champs aux problèmes qui n’ont aucun type, sélectionnez l’option « Problèmes sans type ».

Remarque

Les champs doivent être épinglés à au moins un type de ticket, ou à « Tickets sans type », pour apparaître dans la barre latérale du ticket. Les champs qui ne sont épinglés à aucun type ne sont accessibles que via le bouton Ajouter un champ ou dans des projets.

Si un champ n’apparaît pas sur vos problèmes, vérifiez qu’il est épinglé au type de problème approprié ou à « Problèmes sans type ». Les champs qui ne sont pas épinglés et pour lesquels aucune valeur n’est définie sont masqués dans la barre latérale du ticket.

Définition de la visibilité des champs

Pour les organisations disposant de dépôts publics, vous pouvez contrôler si chaque champ de problème est visible par tout le monde ou uniquement par les membres de l’organisation et les collaborateurs.

Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.
Sélectionnez une organisation en cliquant dessus.
Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.
Dans la section « Planning » de la barre latérale, cliquez sur Champs des tickets.
À droite du champ, cliquez sur .
Cliquez sur Modifier.
Sous « Visibilité du champ », choisissez l’une des options suivantes :
- Organisation uniquement : le champ est visible uniquement pour les membres de l’organisation et les collaborateurs du référentiel avec au moins un accès en lecture.
- Public : le champ est visible par toute personne consultant le ticket.
Cliquez sur Enregistrer.

Par défaut, tous les champs nouveaux et existants sont définis sur « Organisation uniquement ». Les paramètres de visibilité sont appliqués dans l’interface utilisateur web, l’API, les événements de chronologie des problèmes et les suggestions de recherche.

Champs et projets de demande

Les champs de problème sont disponibles dans n’importe quel projet de votre organisation, y compris les projets publics et internes. Pour plus d’informations sur l’ajout, la suppression et la modification des champs de problème dans les projets, consultez À propos des champs de problème dans les projets.

Visibilité dans les projets publics et internes

Seuls les champs avec visibilité publique sont disponibles dans les projets publics et internes. Les champs définis sur Organisation uniquement ne sont pas affichés. Lorsque vous ajoutez des champs à un projet public, seuls les champs de visibilité publique apparaissent dans la boîte de dialogue du champ de complément.

Si la visibilité d’un champ est remplacée par « Public » par « Organisation uniquement » lors de son utilisation dans un projet public, le champ est automatiquement supprimé du projet. Pour la rétablir, remettez la visibilité du champ sur « Public ».

Migration des champs de projet vers des champs de problème

Si vous utilisez déjà des champs personnalisés au niveau du projet pour les métadonnées telles que la priorité ou l’effort, vous pouvez adopter des champs de problème pour centraliser ces valeurs au niveau du problème.

Les champs de problème sont la source de vérité. La valeur réside dans le problème et est cohérente dans tous les projets auquel appartient le problème.
Les champs du projet sont propres à un seul projet. Le même problème peut avoir des valeurs de champ de projet différentes dans différents projets.
Les deux peuvent coexister. Vous n’avez pas besoin de supprimer immédiatement les champs du projet, mais les deux peuvent entraîner une confusion s’ils suivent le même concept (par exemple, deux champs « Priorité »).
Pour migrer, créez le champ de problème équivalent, puis supprimez le champ au niveau du projet des vues de votre projet lorsque votre équipe est prête.

Limites de champ dans les projets

Les projets prennent en charge jusqu’à 50 champs au total, et les champs de problème ainsi que les champs système sont comptabilisés dans cette limite. Si un projet est déjà à la limite de champs, vous devez supprimer les champs existants avant d’ajouter des champs de problème.

Limites

Ressource	Limite
Champs de problème par organisation	25
Options par champ sélection unique	100
Champs épinglés par type de problème	10
Nombre total de champs dans un projet (y compris les champs de problème et les champs système)	50