Leçon 2 : Chargement de la définition d'indicateur#

Chargez la définition d'indicateur que vous avez créée lors de la leçon précédente.

Avant de commencer

Avant de commencer cette leçon, assurez-vous d'avoir terminé la leçon précédente.

Description de la tâche

Avant de pouvoir utiliser la définition d'indicateur que vous avez créée lors de la leçon précédente, vous devez la charger. IBM UrbanCode Velocity fournit des nœuds finaux d'API REST et une API GraphQL. Dans le tutoriel, nous utilisons curl pour accéder au nœud final d'API REST metricDefinition. Si vous préférez utiliser GraphQL, vous pouvez accéder aux informations du schéma via l'URL suivante : https://my_velocity:port/release-events-api/graphiql.

Pour charger la définition d'indicateur, procédez comme suit :

Procédure

  1. A l'aide de curl, créez l'en-tête pour une requête POST, comme le montre le fragment suivant.

    curl -X POST "https://my_velocity:port/api/v1/metricDefinition" \ -H "accept: application/json" \ -H "Authorization: UserAcessKey my_user_access_token" \ -H "Content-Type: application/json" \ -k \

    Les nœuds finaux d'API REST se trouvent à l'adresse https://my_velocity:port/api/v1/endpoint_name. Pour la propriété authorization, utilisez la clé d'accès utilisateur que vous avez configurée précédemment.

  2. Ajoutez la définition d'indicateur que vous avez créée lors de la dernière leçon à la requête curl, puis envoyez la requête.

    La requête complète s'affiche dans l'exemple de code suivant :

    curl -X POST "https://my_velocity:port/api/v1/metricDefinition" \ -H "accept: application/json" \ -H "Authorization: UserAccessKey my_user_access_token" \ -H "Content-Type: application/json" \ -k \ -v \ -d '{ "id": "TUTORIAL_DEFINITION", "name":"Tutorial Definition", "category": "quality", "tenantId":"my_tenant_id", "chartDefaults":{ "groupBy":"result", "chartType":"bar", "barMode": "stack" }, "aggregation":{ "operation":"sum" } }'

Résultats

Si la commande curl aboutit, le nouveau graphique est répertorié sur le tableau de bord. Pour confirmer que la commande a fonctionné, ouvrez le tableau de bord que vous avez créé précédemment, puis développez la liste des graphiques Qualité. Vous pouvez voir le graphique affiché en bas des graphiques de type qualité, comme le montre l'histogramme suivant :

Liste des graphiques Qualité

Si vous ajoutez le graphique à l'affichage du tableau de bord, il ne contiendra aucune donnée, étant donné que vous n'avez envoyé aucune donnée du type "Définition du tutoriel" vers IBM UrbanCode Velocity.

Que faire ensuite

Dans cette leçon, vous avez créé un enregistrement de données d'indicateur correspondant au type de données "Définition du tutoriel", puis vous l'avez chargé vers IBM UrbanCode Velocity.

Sujet parent : Mise en œuvre d'indicateurs personnalisés