Modelo de datos para Analytics

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

El modelo de datos de Analytics para Azure DevOps consta de conjuntos de entidades, cuyos miembros (entidades) contienen propiedades que se pueden filtrar, agregar y resumir. Además, contienen propiedades de navegación que relacionan entidades entre sí, lo que proporciona acceso a otras propiedades para seleccionar, filtrar y agrupar.

Nota:

El servicio Analytics se habilita automáticamente y se admite en producción para todos los servicios de Azure DevOps. La integración de Power BI y el acceso a la fuente OData del servicio Analytics están disponibles con carácter general. Le recomendamos que lo use y nos envíe sus 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 obtener más información, consulte Control de versiones de la API de OData.

Espacios de nombres de esquema

El modelo de datos de Analytics se basa en dos espacios de nombres de esquema:

• Microsoft.VisualStudio.Services.Analytics.Model
• Microsoft.VisualStudio.Services.Analytics.

Conjuntos de entidades y tipos de entidad

Los tipos de entidad se denominan tipos estructurados con una clave. Definen las propiedades y relaciones con nombre de cada entidad. La clave de se EntityType forma a partir de un subconjunto de las propiedades primitivas, por ejemplo, WorkItemId, PipelineId, ReleasePipelineId y mucho más del tipo de entidad.

Los conjuntos de entidades se denominan colecciones de entidades. Por ejemplo, WorkItems es un conjunto de entidades que contiene WorkItem entidades. La clave de una entidad identifica de forma única la entidad dentro de un conjunto de entidades. Si varios conjuntos de entidades usan el mismo tipo de entidad, la misma combinación de valores de clave puede aparecer en más de un conjunto de entidades e identifica diferentes entidades, una por conjunto de entidades donde aparece esta combinación de claves. Cada una de estas entidades tiene un identificador de entidad diferente. Los conjuntos de entidades proporcionan puntos de entrada en el modelo de datos.

Los conjuntos de entidades se describen en metadatos de OData y varían según el proyecto. Puede explorar la lista completa de conjuntos de entidades, tipos de entidad y propiedades solicitando los metadatos de OData para el proyecto. Para obtener información sobre cómo hacerlo, consulte Construcción de consultas de OData para Analytics.

Entidades compuestas

Las entidades compuestas admiten escenarios específicos. Se componen de entidades más sencillas, a menudo requieren más recursos informáticos para generar y pueden devolver conjuntos de resultados más grandes. Para lograr el mejor rendimiento y evitar la limitación innecesaria, asegúrese de consultar la entidad correcta para su escenario.

Por ejemplo, WorkItemSnapshot combina WorkItemRevisions y Dates de modo que cada fecha tiene una revisión para cada elemento de trabajo. Esta representación admite consultas de OData que se centran en los datos de tendencia para un conjunto filtrado de elementos de trabajo. Sin embargo, no debe usar esta entidad compuesta para consultar el estado actual de los elementos de trabajo. En su lugar, debe usar el WorkItems conjunto de entidades para generar una consulta de ejecución más rápida.

De forma similar, algunas entidades pueden contener todos los valores históricos, mientras que otras solo pueden contener valores actuales. WorkItemRevisions contiene todo el historial de elementos de trabajo, que no debe usar en escenarios en los que los valores actuales son de interés.

Relaciones

Para generar resultados de consulta más complejos, puede combinar entidades mediante relaciones. Puede emplear relaciones para expandir, filtrar o resumir datos.

Algunas propiedades de navegación dan como resultado una sola entidad, mientras que otras dan como resultado una colección de entidades. En el diagrama siguiente se muestran las entidades seleccionadas y sus propiedades de navegación. Para mayor claridad, se han omitido algunas entidades compuestas y relaciones.

Claves de relación

Las relaciones de entidad también se representan como claves externas para que las herramientas externas puedan unir entidades. Estas propiedades tienen el sufijo "SK" y son tipos de datos enteros o GUID. Las propiedades de fecha tienen propiedades de clave de fecha entera correspondientes con el siguiente formato: AAAAMMDD.

Tipos de entidad y conjuntos de entidades de seguimiento de trabajos

Los siguientes tipos de entidad y conjuntos de entidades se admiten con las versiones de API indicadas. Para obtener una referencia completa, consulte Referencia de metadatos de seguimiento del trabajo para Azure Boards Analytics.

EntityType/EntitySet	Descripción	v1.0	v2.0	v3.0-preview	v4.0-preview
Ámbito/ Áreas	Las rutas de acceso de área del elemento de trabajo, con propiedades para agrupar y filtrar por jerarquía de áreas.	✔️	✔️	✔️	✔️
Iteración/ Iteraciones	Las rutas de acceso de iteración del elemento de trabajo, con propiedades para agrupar y filtrar por jerarquía de iteración.	✔️	✔️	✔️	✔️
BoardLocation/ BoardLocations	Las ubicaciones de las celdas de la placa, tal y como se identifica en la columna de la placa, la calle y la división, incluyen la configuración histórica de la placa. Para obtener una descripción de cada campo de panel, consulte Campos de flujo de trabajo y panel.	✔️	✔️	✔️	✔️
CalendarDate/ Fechas	Fechas usadas para filtrar y agrupar otras entidades mediante relaciones.	✔️	✔️	✔️	✔️
Proyecto/ Proyectos	Todos los proyectos definidos para una organización (nube) o colección de proyectos (local).	✔️	✔️	✔️	✔️
Process/ Procesos	Información de trabajo pendiente usada para expandir o filtrar elementos de trabajo y tipos de elementos de trabajo. Para obtener un ejemplo que usa Procesos para filtrar un informe, consulte Informe de ejemplo de seguimiento de requisitos.		✔️	✔️	✔️
Tag/ Etiquetas	Todas las etiquetas de elemento de trabajo de cada proyecto. Para obtener un ejemplo en el que se usan etiquetas para filtrar un informe, consulte Informe de ejemplo de agotamiento de versión.	✔️	✔️	✔️	✔️
Equipo/ Teams	Todos los equipos definidos para el proyecto. Para obtener un ejemplo que usa Teams para filtrar un informe, vea Agregar una segmentación de equipos a un informe de Power BI.	✔️	✔️	✔️	✔️
User/ Usuarios	Información de usuario que se usa para expandir o filtrar varias propiedades de elemento de trabajo, por ejemplo , Asignadas a, Creadas por.	✔️	✔️	✔️	✔️
WorkItemBoardSnapshot/ WorkItemBoardSnapshot	(Compuesto) Estado de cada elemento de trabajo en cada fecha de calendario, incluida la ubicación del panel, que se usa para generar informes de tendencias. Para obtener un informe de ejemplo, consulte El informe de ejemplo diagrama de flujo acumulado (CFD).	✔️	✔️	✔️	✔️
WorkItemLink/ WorkItemLinks	Los vínculos entre elementos de trabajo, por ejemplo, Secundario, Primario y Relacionado. Incluye solo la revisión más reciente de vínculos, sin historial. No se incluyen hipervínculos.	✔️	✔️	✔️	✔️
WorkItemRevision/ WorkItemRevisions	Todas las revisiones de elementos de trabajo históricos, incluida la revisión actual. No incluye elementos de trabajo eliminados.	✔️	✔️	✔️	✔️
WorkItemSnapshot/ WorkItemSnapshot	(Compuesto) Estado de cada elemento de trabajo en cada fecha de calendario, que se usa para admitir informes de tendencias. Para obtener un informe de ejemplo, consulte Informe de ejemplo de tendencias de errores.	✔️	✔️	✔️	✔️
Workitem/ WorkItems	Estado actual de los elementos de trabajo. Se usa para admitir informes de estado. Para obtener un informe de ejemplo, consulte Acumulación de valores de elementos de trabajo secundarios en el informe de ejemplo primario.	✔️	✔️	✔️	✔️
WorkItemTypeField/ WorkItemTypeFields	Propiedades del elemento de trabajo para cada tipo y proceso de elemento de trabajo. Se usa para admitir la creación de informes.	✔️	✔️	✔️	✔️

Tipos de entidad y conjuntos de entidades de canalizaciones

Los siguientes tipos de entidad y conjuntos de entidades se admiten con la versión de Analytics v3.0-preview o v4.0-preview . Para obtener una referencia completa, consulte Referencia de metadatos de canalización .

EntityType/EntitySet	Descripción	v3.0-preview	v4.0-preview
Rama/ Ramas	Información básica sobre las ramas usadas en pruebas o canalizaciones. Para obtener un informe de ejemplo, consulte Informe de ejemplo de estado de progreso.	✔️	✔️
ParallelPipelineJobsSnapshot/ ParallelPipelineJobsSnapshot	(Compuesto) Admite la comprensión del consumo de canalización en paralelo. Para obtener más información sobre las pruebas de canalización paralelas, vea Ejecutar pruebas en paralelo mediante la tarea Prueba de Visual Studio.		✔️
Canalización/ Canalizaciones	Propiedades de una canalización.	✔️	✔️
PipelineJob/ PipelineJobs	Resultados de ejecución individuales para una prueba específica asociada a testRun	✔️	✔️
PipelineRun/ PipelineRuns	Información de ejecución para canalizaciones. Para obtener un informe de ejemplo, consulte El informe de ejemplo de tendencia de frecuencia de paso de canalización.	✔️	✔️
PipelineRunActivityResult/ PipelineRunActivityResults	Registro combinado de todas las fases, pasos, trabajos y tareas dentro de una ejecución de canalización específica. Para obtener un informe de ejemplo, consulte Informe de ejemplo de duración de la tarea de canalización.	✔️	✔️
PipelineTask/ PipelineTasks	Propiedades de las tareas que se usan dentro de una canalización.	✔️	✔️
TaskAgentPoolSizeSnapshot/ TaskAgentPoolSizeSnapshots	(Compuesto) Admite la comprensión del tamaño del grupo, los trabajos de canalización y la simultaneidad. El gráfico histórico de los grupos de agentes muestra cómo se puede usar este conjunto de entidades.		✔️
TaskAgentRequestSnapshot/ TaskAgentRequestSnapshots	(Compuesto)		✔️

Probar tipos de entidad y conjuntos de entidades

Los siguientes tipos de entidad y conjuntos de entidades se admiten con la versión de Analytics v3.0-preview o v4.0-preview . Para obtener una referencia completa, consulte Referencia de metadatos de prueba.

EntityType/EntitySet	Descripción	v3.0-preview	v4.0-preview
TestConfiguration/ TestConfigurations	Pruebe la información de configuración del plan. Para obtener más información sobre la configuración de pruebas, consulte Probar distintas configuraciones.	✔️	✔️
TestResult/ TestResults	Resultados de ejecución individuales para una prueba específica asociada a testRun.	✔️	✔️
TestResultsDaily/ TestResultsDaily	Agregado de instantáneas diarias de ejecuciones TestResult agrupadas por Test (no TestRun). Para obtener un informe de ejemplo, consulte Informe de ejemplo de tendencias de resumen de pruebas.	✔️	✔️
TestRun/ TestRuns	Información de ejecución para pruebas que se ejecutan en una canalización con TestResult agregado.	✔️	✔️
Prueba/ Pruebas	Propiedades de un caso de prueba, como el nombre de la prueba y el propietario de la prueba. Para más información sobre cómo definir casos de prueba, consulte Creación de casos de prueba manuales.	✔️	✔️
TestPoint/ Puntos de prueba	Información de ejecución para puntos de prueba. Un punto de prueba es una combinación única de casos de prueba, conjunto de pruebas, configuración y evaluador. Para obtener un informe de ejemplo, consulte Informe de ejemplo de estado de progreso.	✔️	✔️
TestPointHistorySnapshot/ TestPointHistorySnapshots	(Compuesto) Resultados de ejecución individuales para una prueba específica asociada a testRun. Para obtener un informe de ejemplo, consulte Informe de tendencias de ejecución de pruebas manuales.	✔️	✔️
TestSuite/ TestSuites	Información de conjuntos de pruebas. Para más información sobre cómo definir conjuntos de pruebas, consulte Creación de planes de pruebas y conjuntos de pruebas.	✔️	✔️

Artículos relacionados

• Directrices de consulta de OData Analytics
• Análisis de WIT
• Agregar datos
• Exploración de metadatos de OData de Analytics
• Seguimiento del trabajo, proceso y límites del proyecto
• Diseño de conjuntos de datos de vistas de análisis