Champs personnalisés

Une entité dans Targetprocess peut avoir plusieurs champs personnalisés, jusqu'à 100 en réalité. Nous allons décrire ici comment faire référence aux valeurs des champs personnalisés dans les formules utilisées pour les mesures de formule personnalisées et les champs personnalisés calculés.

Hériter les valeurs des champs personnalisés d'une entité elle-même

Indicateurs de formule personnalisés :

Les champs personnalisés peuvent être de différents types. Les métriques de formule personnalisées peuvent extraire des valeurs à partir des champs des types suivants :

  • Texte
  • Nombre
  • Date
  • Booléen
  • Entité
Avertissement : l'accès aux valeurs des champs personnalisés est différent pour les métriques et les champs personnalisés calculés. Dans les formules des champs personnalisés calculés, pour obtenir la valeur du champ personnalisé « Nom du champ », utilisez : FieldName Dans les formules des métriques, pour obtenir la valeur du champ personnalisé « Nom du champ », utilisez : CustomValues.Text("Nom du champ") CustomValues.Number("Nom du champ") CustomValues.Date("Nom du champ") CustomValues.Boolean("Nom du champ")

Le type d'une valeur extraite est déterminé automatiquement. Il n'est pas nécessaire de le spécifier manuellement. Il suffit d'utiliser le nom du champ. Si un nom de champ contient des espaces, ignorez-les dans vos formules.

Ressource Méta-informations Noeuds finaux
Tâche lien

/api/v1/TaskHistories

/api/v2/TaskHistories

/api/history/v2/Task

Bug lien

/api/v1/BugHistories

/api/v2/BugHistories

/api/history/v2/Bug

Récit utilisateur lien

/api/v1/UserStoryHistories

/api/v2/UserStoryHistories

/api/history/v2//UserStory

Fonctionnalité lien

/api/v1/FeatureHistories

/api/v2/FeatureHistories

/api/history/v2/Feature

Hériter les valeurs des champs personnalisés de l'entité parent

Outre les références aux champs de leur propre niveau, les entités peuvent hériter des valeurs de champs personnalisés des entités parentes. Supposons qu'une User Story, qui est le type d'entité le plus courant dans Targetprocess, puisse hériter des valeurs des champs personnalisés des entités parentes : fonctionnalités, épopées, projets, etc. Les mêmes formules sont valables pour d'autres types d'entités telles que les bogues et les tâches.

épopées et bogues
Remarque : tous les types de champs personnalisés sont pris en charge. Les exemples ci-dessous utilisent le type de CustomValues champ.Number, qui est le plus fréquemment utilisé. D'autres types tels que Texte, Date, Booléen, Entité sont également entièrement pris en charge dans les formules.
Ressource Méta-informations Noeuds finaux
Tâche lien

/api/v1/TaskHistories

/api/v2/TaskHistories

/api/history/v2/Task

Bug lien

/api/v1/BugHistories

/api/v2/BugHistories

/api/history/v2/Bug

Récit utilisateur lien

/api/v1/UserStoryHistories

/api/v2/UserStoryHistories

/api/history/v2//UserStory

Fonctionnalité lien

/api/v1/FeatureHistories

/api/v2/FeatureHistories

/api/history/v2/Feature