Partager via


Créer un widget Analytics pour Azure DevOps

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Vous pouvez créer votre propre widget Analytics pour l’afficher dans un tableau de bord dans Azure DevOps. L’exemple de widget sur github illustre :

  • Comment afficher des lignes de tendance associées à des états d’élément de travail
  • Comment interroger un jeu de données lorsqu'un utilisateur le configure via la vue de configuration du widget.
  • Comment générer et publier le widget sur la Place de marché Azure DevOps

Avec ces informations, vous serez en mesure de créer votre propre widget Analytics.

vue de configuration avec préversion du widget

Note

Le service Analytics est automatiquement activé et pris en charge en production pour tous les services Azure DevOps. L'intégration de Power BI et l'accès au flux OData du service Analytics sont généralement disponibles. Nous vous encourageons à l’utiliser et à nous faire part de vos commentaires. Les données disponibles dépendent de la version. La dernière version prise en charge est v2.0, et la dernière version préliminaire est v4.0-preview. Pour plus d’informations, consultez sur la gestion des versions de l’API OData.

Note

Le service Analytics est automatiquement installé et pris en charge en production pour toutes les nouvelles collections de projets pour Azure DevOps Server 2020 et versions ultérieures. L'intégration Power BI et l’accès au flux OData du service Analytics sont maintenant disponibles. Nous vous encourageons à l’utiliser et à nous faire part de vos commentaires. Si vous avez effectué une mise à niveau à partir d’Azure DevOps Server 2019, vous pouvez installer le service Analytics pendant la mise à niveau.

Les données disponibles dépendent de la version. La dernière version prise en charge est v2.0, et la dernière version préliminaire est v4.0-preview. Pour plus d’informations, consultez gestion des versions de l’API OData .

Note

Le service Analytics est en préversion pour Azure DevOps Server 2019. Vous pouvez activer ou l’installer pour une collection de projets. L'intégration de Power BI et l’accès au flux OData du service Analytics sont en préversion. Nous vous encourageons à l’utiliser et à nous faire part de vos commentaires.

Les données disponibles dépendent de la version. La dernière version prise en charge est v2.0, et la dernière version préliminaire est v4.0-preview. Pour plus d’informations, consultez gestion des versions de l’API OData .

Conditions préalables

Catégorie Exigences
niveaux d’accès - membre du projet.
- Au moins accès de base.
autorisations Par défaut, les membres du projet ont l’autorisation d’interroger Analytics et de créer des vues. Pour plus d’informations sur les autres conditions préalables concernant l’activation du service et des fonctionnalités et les activités de suivi des données générales, consultez Autorisations et conditions préalables pour accéder à Analytics.

L’exemple de cet article fournit un widget prêt à l’utilisation, couvrant les concepts de base des rubriques des tableaux de bord, des graphiques et de l’analytique. Les documents suivants fournissent des informations plus détaillées illustrées dans cet exemple :

  1. Créer une extension de widget Azure DevOps, référencez l’exemple d’extensions de widget
  2. Afficher un composant de graphique Azure DevOps, référence Ajouter un graphique
  3. Interroger OData à partir de Analytics

Fournir une vue de configuration

  1. Exécuter des requêtes analytiques simples requises par les contrôles d’interface utilisateur utilisés pour la configuration d’une vue.
  2. Gérer l’état de l’interface utilisateur de configuration, avec des mises à jour basées sur des actions utilisateur et avec de nouvelles données à partir de requêtes Analytics.
  3. Configurer l'interface utilisateur de rendu à l'aide de Typescript et React.

Afficher des données dans un widget

  1. Exécuter une requête configurée par l'utilisateur en tant qu'une requête POST
  2. Interpréter les données analytiques pour afficher un graphique

Étapes suivantes

Pour éviter l’excès de complexité dans l’exemple, nous avons omis certaines technologies et pratiques, qu’un widget de production doit certainement inclure. L’exemple ui-fabric-react sur GitHub met en évidence un processus de génération qui met en œuvre ces détails.

  1. regroupement javaScript et de minification de contenu : l’ensemble de petits fichiers de script libres dans l’exemple peut se charger beaucoup plus rapidement lorsqu’ils sont combinés dans un fichier unique et minifiés.
  2. contrôles d’interface utilisateur Fabric - Les contrôles d’interface utilisateur Fabric fournissent un ensemble complet de composants d’interface utilisateur de configuration pour React.