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 :

  1. Définissez une définition d'indicateur personnalisé à l'aide des propriétés présentées plus loin dans cette rubrique.
  2. Chargez la définition d'indicateur dans IBM UrbanCode Velocity.
  3. Envoyez des données vers IBM UrbanCode Velocity qui se conforment à la définition de l'indicateur.
  4. 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