Ajout et gestion des champs de problème

Les champs des tickets apparaissent dans la barre latérale de droite des tickets, à côté des champs système tels que les responsables, les étiquettes et le type. Vous pouvez définir des valeurs lors de la création ou de la modification d’un problème. Lorsque vous sélectionnez un type de problème lors de la création d’un problème, tous les champs épinglés à ce type apparaissent automatiquement dans la barre latérale.

Définition d’une valeur de champ

1. Accédez au problème que vous souhaitez modifier.
2. Dans la barre latérale droite, si le champ souhaité n’est pas déjà visible, cliquez sur Ajouter un champ.
3. Dans la liste déroulante, sélectionnez le champ à ajouter.
4. Définissez la valeur :
   • Pour les champs à sélection unique , choisissez une option dans la liste déroulante.
   • Pour les champs de texte , tapez votre valeur. Les URL sont automatiquement détectées et affichées en tant que liens.
   • Pour les champs numériques , entrez une valeur numérique.
   • Pour les champs de date , utilisez le sélecteur de dates pour sélectionner une date ou tapez la date directement.
5. Les modifications sont enregistrées automatiquement.

Modification d’une valeur de champ

1. Accédez au ticket.
2. Dans la barre latérale droite, cliquez sur la valeur du champ à modifier.
3. Sélectionnez une nouvelle valeur ou tapez une nouvelle entrée.
4. Les modifications sont enregistrées automatiquement.

Effacement d’une valeur de champ

1. Accédez au ticket.
2. Dans la barre latérale droite, cliquez sur la valeur du champ.
3. Effacez la valeur :
   • Pour les champs à sélection unique , cliquez sur l’option actuellement sélectionnée pour la désélectionner.
   • Pour les champs texte et nombre , supprimez tout le texte de l’entrée.
   • Pour les champs de date , cliquez sur le bouton Effacer dans le sélecteur de dates.
4. Une fois le champ vidé, celui-ci disparaît de la barre latérale. Il peut être ajouté à nouveau à l’aide du bouton Ajouter un champ .

Champs épinglés

Si l’administrateur de votre organisation a épinglé des champs à des types de problèmes spécifiques, ces champs apparaissent automatiquement dans la barre latérale et le mode de création du problème lorsque vous créez ou affichez un problème de ce type. Vous n’avez pas besoin d’ajouter manuellement les champs épinglés.

Affichage des modifications de champ dans la chronologie

Lorsqu’une valeur de champ est modifiée, la mise à jour est enregistrée dans la chronologie du problème. L’entrée dans la ligne de temps indique :

• Quel champ a été modifié
• Nouvelle valeur définie
• Utilisateur ayant apporté la modification
• Le moment où le changement a été effectué

Les événements de la chronologie pour les champs configurés sur « Organisation uniquement » sont masqués aux personnes qui ne sont ni membres ni collaborateurs de l’organisation.

Visibilité des champs

Les administrateurs d’organisation peuvent définir la visibilité de chaque champ sur « Organisation uniquement » ou « Public ». Cela affecte ce que vous voyez :

• Si un champ est défini sur Organisation uniquement, il est visible uniquement par les membres de l’organisation et les collaborateurs du référentiel avec au moins un accès en lecture. Si vous n’êtes pas membre ou collaborateur, le champ n’apparaît pas dans la barre latérale, la chronologie ou les suggestions de recherche du problème.
• Si un champ est défini sur Public, il est visible par toute personne qui consulte le problème.

Pour plus d’informations sur la configuration de la visibilité, consultez Gestion des champs de problème dans votre organisation.

Utilisation des champs de problème dans les projets

Les champs de problème peuvent être ajoutés en tant que colonnes dans les vues de projet, où vous pouvez modifier des valeurs, regrouper, filtrer, trier et générer des graphiques. Pour plus d’informations, consultez « À propos des champs de problème dans les projets ».

Recherche par valeurs de champ

Vous pouvez filtrer et rechercher des problèmes en fonction des valeurs de champ sur le tableau de bord des problèmes et la page problèmes de votre dépôt. Dans la barre de recherche, tapez field. suivi du nom et de la valeur du champ. Par exemple:

•         `field.priority:high` pour rechercher des problèmes dont la priorité est définie sur « élevée »
  

•         `field."target date":>=2026-03-01` pour rechercher des problèmes avec une date cible à partir du 1er mars 2026 ou après
  

•         `field.priority:high,medium` pour rechercher des problèmes avec la priorité définie sur « élevé » ou « moyen »
  

Pour plus d’informations, consultez « Filtrage et recherche de problèmes et de demandes de tirage ».

Utilisation de champs de problème avec l’API

Les champs de ticket sont entièrement pris en charge par les API REST et GraphQL. Vous pouvez automatiser la gestion des champs, définir des valeurs par programmation et l’intégrer à des outils externes.

•         **Gestion des champs** : Créer, mettre à jour et supprimer des champs au niveau de l’organisation. Consultez les [champs de problème d’organisation API REST](/rest/orgs/issue-fields).
  

•         **Utilisation de champs** : Obtenir, définir et effacer des valeurs de champ sur des problèmes individuels. Consultez [l’API REST des valeurs de champ de ticket](/rest/issues/issue-field-values).
  

•         **GraphQL** : Les types de champs de problème et les mutations sont également disponibles via GraphQL. Voir [`IssueFields`l’union](/graphql/reference/unions#issuefields), [ émettre des objets de champ ](/graphql/reference/objects#issuefieldtext) (tels que `IssueFieldText`, `IssueFieldSingleSelect`, `IssueFieldNumber`, et `IssueFieldDate`), et [des mutations](/graphql/reference/mutations#createissuefield) (par exemple `createIssueField`, `updateIssueField`, et `setIssueFieldValue`).