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 las entidades entre sí, lo que proporciona acceso a otras propiedades para seleccionar, filtrar y agrupar.
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.
Espacios de nombres de esquema
El modelo de datos de Analytics se basa en dos espacios de nombres de esquema:
Microsoft.VisualStudio.Services.Analytics.ModelMicrosoft.VisualStudio.Services.Analytics.
Tipos de entidad y conjuntos de entidades
Los tipos de entidad se denominan tipos estructurados con una clave. Definen las propiedades y relaciones con nombre de cada entidad. La clave de entityType se 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 entidades WorkItem . 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 entidades diferentes, 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 los 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 para que cada fecha tenga una revisión para cada elemento de trabajo. Esta representación admite consultas 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 conjunto de entidades WorkItems 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. WorkItemRevision 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 combinar entidades. Estas propiedades tienen el sufijo "SK" y son tipos de datos enteros o GUID. Las propiedades de fecha tienen las propiedades de clave de fecha entera correspondientes con el siguiente formato: AAAAMMDD.
Tipos de entidad y conjuntos de entidades de seguimiento de trabajo
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 |
|---|---|---|---|---|---|
| Área/ Áreas |
El elemento de trabajo Rutas de acceso de área, 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 Kanban, identificadas por columna de placa, calle y división, incluyen la configuración histórica de la placa. Para obtener una descripción de cada campo de panel Kanban, consulte Campos de flujo de trabajo y panel Kanban. | ✔️ | ✔️ | ✔️ | ✔️ |
| CalendarDate/ Fechas |
Las fechas usadas para filtrar y agrupar otras entidades mediante relaciones. | ✔️ | ✔️ | ✔️ | ✔️ |
| Project/ Proyectos |
Todos los proyectos definidos para una organización (nube) o colección de proyectos (local). | ✔️ | ✔️ | ✔️ | ✔️ |
| Proceso/ 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. | ✔️ | ✔️ | ✔️ | |
| Etiqueta/ Etiquetas |
Todas las etiquetas de elemento de trabajo para cada proyecto. Para obtener un ejemplo en el que se usan etiquetas para filtrar un informe, consulte Informe de ejemplo de desentreado de versión. | ✔️ | ✔️ | ✔️ | ✔️ |
| Equipo/ Teams |
Todos los equipos definidos para el proyecto. Para ver un ejemplo que usa Teams para filtrar un informe, vea Agregar una segmentación de equipos a un informe de Power BI. | ✔️ | ✔️ | ✔️ | ✔️ |
| Usuario/ Usuarios |
Información de usuario que se usa para expandir o filtrar varias propiedades de elemento de trabajo, por ejemplo , Asignada a, Creada por. | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemBoardSnapshot/ WorkItemBoardSnapshot |
(Compuesto) Estado de cada elemento de trabajo en cada fecha del calendario, incluida la ubicación del panel Kanban, que se usa para generar informes de tendencias. Para obtener un informe de ejemplo, consulte el informe de ejemplo Diagrama de flujo acumulativo (CFD). | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemLink/ WorkItemLinks |
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) El 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 un informe de ejemplo primario. | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemTypeField/ WorkItemTypeFields |
Las 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 v3.0-preview o v4.0-preview analytics. 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, consulte Ejecución de pruebas en paralelo mediante la tarea Prueba de Visual Studio. | ✔️ | |
| Tubería/ Canalizaciones |
Propiedades de una canalización. | ✔️ | ✔️ |
| PipelineJob/ PipelineJobs |
Resultados de ejecución individuales para una prueba específica asociada a un testRun | ✔️ | ✔️ |
| PipelineRun/ PipelineRuns |
Información de ejecución de canalizaciones. Para obtener un informe de ejemplo, consulte 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 tareas 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 |
Información de configuración del plan de prueba. Para más información sobre cómo configurar pruebas, consulte Probar diferentes configuraciones. | ✔️ | ✔️ |
| TestResult/ TestResults |
Resultados de ejecución individuales para una prueba específica asociada a un testRun. | ✔️ | ✔️ |
| TestResultsDaily/ TestResultsDaily |
Un agregado de instantánea diaria 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 de las 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/ TestPoints |
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 un testRun. Para obtener un informe de ejemplo, consulte Informe de ejemplo 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. | ✔️ | ✔️ |