Mise en œuvre d'indicateurs personnalisés#
Communiquez les données d'indicateur personnalisé à vos chaînes de valeur et vos tableaux de bord.
Il est possible de définir les définitions d'indicateurs personnalisés dans le fichier value\_stream.json
joint à une chaîne de valeur. Vous pouvez ajouter des graphiques ou des histogrammes provenant des données à des tableaux de bord, à la chaîne de valeur, à la barre Indicateurs ou à la vue de la liste sur la page Chaînes de valeur.
Remarque : Jusqu'à ce que de nouveaux utilisateurs soient affectés à des équipes, ils sont automatiquement affectés à l'équipe Par défaut dans les rôles Spectateur et Participant. Les utilisateurs qui assument ces rôles peuvent afficher des objets, comme des versions et des chaînes de valeur, mais ils ne peuvent pas les créer ni les éditer. En outre, les utilisateurs qui assument ces rôles peuvent générer des jetons d'accès utilisateur et accéder à des nœuds finaux d'API avec des requêtes GET. Les administrateurs accordent des droits supérieurs aux utilisateurs lorsqu'ils leur affectent des rôles tels que Développeur principal ou Gestionnaire d'édition.
La procédure suivante décrit la manière d'ajouter des données d'indicateur personnalisé à IBM™ UrbanCode Velocity :
- Définissez une définition d'indicateur personnalisé à l'aide des propriétés présentées plus loin dans cette rubrique.
- Chargez la définition d'indicateur dans IBM UrbanCode Velocity.
- Envoyez des données vers IBM UrbanCode Velocity qui se conforment à la définition de l'indicateur.
- Ajoutez des graphiques basés sur des données personnalisées aux chaînes de valeur et aux tableaux de bord.
Propriétés de définition d'indicateur#
Les propriétés des données d'indicateur sont décrites dans le tableau suivant :
Propriété | Description |
---|---|
id | Cette propriété de type chaîne sert à lier des enregistrements d'un indicateur à la définition de l'indicateur. Obligatoire. |
nom | Cette propriété de type chaîne sert à identifier la définition de l'indicateur. Le nom s'affiche dans le champ Ajouter des graphiques de la page Tableaux de bord. Obligatoire. |
category | Cette propriété de type chaîne sert à définir la catégorie à laquelle appartient la définition de l'indicateur. Les catégories sont répertoriées dans la zone Ajouter des graphiques de la page Tableaux de bord. Les valeurs acceptées sont les suivantes : quality , deliveryFlow , risk , team et effort . Obligatoire. |
tenantId | Cette propriété de type chaîne est générée par IBM UrbanCode Velocity et permet au produit d'identifier votre installation. Vous pouvez trouver votre ID titulaire en téléchargeant un fichier JSON de chaîne de valeur. Obligatoire. |
valueType | Cette propriété de type chaîne indique la valeur attendue des données d'indicateur. Les valeurs acceptées sont les suivantes : percent , countset et count . |
chartDefaults | Ces objets JSON définissent les options par défaut pour le tableau associé à la définition de l'indicateur. Les propriétés des objets sont les suivantes : groupBy (chaîne), chartType (barre ou ligne), barMode (pile ou groupe), et threshold (nombre). |
agrégation | Cet objet JSON définit la logique d'agrégation par défaut. |
createdBy | Nom ou ID du créateur de la définition de l'indicateur. Chaîne |
description | Description de la définition de l'indicateur Chaîne. |
Exemple de définition d'indicateur#
L'exemple suivant montre la commande curl pour une définition d'indicateur. IBM UrbanCode Velocity utilise la propriété "Authorization: UserAccessKey"
pour authentifier l'accès au client. Vous pouvez créer un jeton d'accès utilisateur sur la page Clés d'accès utilisateur, Paramètres > Mon profil.
curl -X POST "https://localhost/api/v1/metricDefinition" \
-H "accept: application/json" \
-H "Authorization: UserAccessKey my_user_access_key" \
-H "Content-Type: application/json" \
-k \
-d '{
"id": "MY_CUSTOM_DEFINITION",
"name":"My Custom Definition",
"category": "quality",
"tenantId":"my_UCV_TenantID",
"chartDefaults":{
"groupBy":"result",
"chartType":"bar",
"barMode": "stack"
},
"aggregation":{
"operation":"sum"
},
"createdBy": "A. Coder",
"description": "New custom metric",
}'
Sujet parent : Indicateurs de chaîne de valeur