Creación de un widget de Analytics para Azure DevOps

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

Puede crear su propio widget de Analytics para mostrarlo en un panel de Azure DevOps. En el widget de ejemplo de GitHub se muestra lo siguiente:

  • Representación de líneas de tendencia asociadas a estados de elementos de trabajo
  • Cómo consultar un conjunto de datos, si un usuario se configurará a través de la vista de configuración del widget
  • Compilación y publicación del widget en Marketplace de Azure DevOps

Con esta información, podrá crear su propio widget de Analytics.

Vista de la configuración con vista previa del widget

Nota

El servicio Analytics se habilita automáticamente para todos los Azure DevOps Services. Se admite para su uso en producción. La integración de Power BI y el acceso a la fuente OData del servicio Analytics están disponibles con carácter general. Le animamos a que lo use y nos proporcione comentarios. >
Los datos disponibles dependen de la versión. La versión más reciente admitida es v2.0y la versión preliminar más reciente es v4.0-preview. Para más información, consulte Control de versiones de la API de OData.

Nota

El servicio Analytics se instala automáticamente en todas las colecciones de proyectos nuevas para Azure DevOps Server 2020 y versiones posteriores. Se admite para su uso en producción. La integración de Power BI y el acceso a la fuente OData del servicio Analytics están disponibles con carácter general. Le animamos a que lo use y nos proporcione comentarios. Si ha actualizado desde Azure DevOps Server 2019, se le proporciona la opción de instalar el servicio Analytics durante la actualización.

Los datos disponibles dependen de la versión. La versión más reciente admitida es v2.0y la versión preliminar más reciente es v4.0-preview. Para más información, consulte Control de versiones de la API de OData.

Nota

El servicio Analytics está en versión preliminar para Azure DevOps Server 2019. Para acceder a Analytics, habilite o instale para una colección de proyectos. La integración de Power BI y el acceso a la fuente OData del servicio Analytics se encuentran en versión preliminar. Le animamos a que lo use y nos proporcione comentarios.

Los datos disponibles dependen de la versión. La versión más reciente admitida es v2.0y la versión preliminar más reciente es v4.0-preview. Para más información, consulte Control de versiones de la API de OData.

Requisitos previos

En este ejemplo se proporciona un widget listo, que abarca aspectos básicos de los temas de Paneles, Gráficos y Análisis. Los siguientes documentos proporcionan más detalles que se muestran en este ejemplo:

  1. Creación de una extensión de widget de Azure DevOps, consulte el ejemplo de extensiones de widget.
  2. Representar un control de gráfico de Azure DevOps, hacer referencia a Agregar un gráfico
  3. Consulta de OData desde Analytics

Proporcionar una vista de configuración

  1. Ejecute consultas de análisis simples requeridas por los controles de interfaz de usuario que se usan para configurar una vista.
  2. Administre el estado de la interfaz de usuario de configuración, con actualizaciones basadas en acciones de usuario y con nuevos datos de consultas de Analytics.
  3. Representación de la interfaz de usuario de configuración mediante Typescript y React.

Representación de datos dentro de un widget

  1. Ejecución de una consulta configurada por el usuario como solicitud POST
  2. Interpretación de datos de análisis para representar un gráfico

Pasos siguientes

Para evitar la complejidad excesiva en el ejemplo, se omiten determinadas tecnologías y prácticas, que un widget de producción debería incluir sin duda. El ejemplo ui-fabric-react de GitHub resalta un proceso de compilación que ejerce estos detalles.

  1. Agrupación de JavaScript y minificación de contenido : el conjunto de archivos de script pequeños y sueltos del ejemplo se puede cargar mucho más rápidamente cuando se combina en un único archivo y se minimiza.
  2. Controles de interfaz de usuario de Fabric: los controles de interfaz de usuario de Fabric proporcionan un amplio conjunto de componentes de la interfaz de usuario de configuración para React.