Modelo de datos para Analytics
Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019
El modelo de datos de analytics 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 para todos los Azure DevOps Services. Se admite para su uso en producción. Power BI integración y el acceso a la fuente OData del servicio Analytics se encuentran en versión preliminar. Le recomendamos que lo use y nos proporcione sus comentarios. .
Nota
El servicio Analytics se instala automáticamente en todas las nuevas colecciones de proyectos para Azure DevOps Server 2020. Se admite para su uso en producción. Power BI integración y el acceso a la fuente OData del servicio Analytics se encuentran en versión preliminar. Le recomendamos que lo use y nos proporcione sus comentarios. Si actualizó desde Azure DevOps Server 2019, se le proporciona la opción de instalar el servicio Analytics durante la actualización.
Nota
El servicio Analytics está en versión preliminar para Azure DevOps Server 2019. Puede acceder a Analytics habilitando o instalando para una colección de proyectos. Power BI integración y el acceso a la fuente OData del servicio Analytics se encuentran en versión preliminar. Le recomendamos que lo use y nos proporcione sus comentarios.
EntityTypes y EntitySets
Los tipos de entidad se denominan tipos estructurados con una clave. Definen las propiedades con nombre y las relaciones de cada entidad. La clave de un EntityType se forma a partir de un subconjunto de las propiedades primitivas, porejemplo, WorkItemId, PipelineId,ReleasePipelineIdy mucho más del tipo de entidad.
Los conjuntos de entidades son colecciones con nombre 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.
Nota
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.
https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}/$metadata
https://{servername}:{port}/tfs/{OrganizationName}/{ProjectName}/_odata/{version}/$metadata
Nota
El {version} valor tiene el formato v1.0 . La versión compatible más reciente es v2.0 y 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.
Los siguientes EntitySets se admiten con las versiones de API indicadas. Para obtener la información de la versión más reciente, consulte Control de versiones de la API de OData.
EntityTypes y EntitySets de seguimiento de trabajo
| 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 |
Rutas de iteración del elemento detrabajo , con propiedades para agrupar y filtrar por jerarquía de iteraciones. | ✔️ | ✔️ | ✔️ | ✔️ |
| BoardLocation BoardLocations |
Las ubicaciones de celdas del panel Kanban, identificadas por la columna del panel, el carril y la división, incluyen la configuración histórica del panel. Para obtener una descripción de cada campo de panel Kanban, vea Workflow and Kanban board fields (Campos de panel kanbany flujo de trabajo). | ✔️ | ✔️ | ✔️ | ✔️ |
| CalendarDate Fechas |
Fechas usadas para filtrar y agrupar otras entidades mediante relaciones. | ✔️ | ✔️ | ✔️ | ✔️ |
| Project Proyectos |
Todos los proyectos definidos para una organización. | ✔️ | ✔️ | ✔️ | ✔️ |
| Proceso Procesos |
Información de trabajos pendientes que se usa para expandir o filtrar elementos de trabajo y tipos de elementos de trabajo. Para obtener un ejemplo que usa Procesos para filtrar un informe, vea Informe de ejemplo de seguimiento de requisitos. | ✔️ | ✔️ | ✔️ | |
| Etiqueta Etiquetas |
Todas las etiquetas de elementos de trabajo para cada proyecto. Para obtener un ejemplo en el que se usan etiquetas para filtrar un informe, vea Release burndown sample report. | ✔️ | ✔️ | ✔️ | |
| 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 Power BI informe. | ✔️ | ✔️ | ✔️ | ✔️ |
| Usuario Usuarios |
Información de usuario que se usa para expandir o filtrar varias propiedades de elemento de trabajo, por ejemplo, Asignado a, creado por. | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemBoardSnapshot WorkItemBoardSnapshot |
(Compuesto) El 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, vea Informe de ejemplo Flow diagrama de archivos acumulativos (CFD). | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemLink WorkItemLinks |
Vínculos entre elementos de trabajo, por ejemplo, Secundario,Primarioy Relacionado. Incluye solo la revisión más reciente de los vínculos, sin historial. Los hipervínculos no se incluyen. | ✔️ | ✔️ | ✔️ | ✔️ |
| 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 del calendario, que se usa para admitir informes de tendencias. Para obtener un informe de ejemplo, vea 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, vea Rollup child work item values to parent sample report (Acumulación de valores de elementos de trabajo secundarios en un informe de ejemplo primario). | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemTypeField WorkItemTypeFields |
Las propiedades de elemento de trabajo para cada tipo y proceso de elemento de trabajo. Se usa para admitir la creación de informes. | ✔️ | ✔️ | ✔️ | ✔️ |
Recursos adicionales:
- Diseño del conjunto de registros de vistas de análisis
- Acerca de las rutas de acceso de área e iteración (sprint)
- Acerca de los equipos y las herramientas de Agile
- referencia rápida de Project equipo y de grupo
- Agregar etiquetas de elemento de trabajo para clasificar y filtrar listas y paneles
- Agregar equipos
- Referencia al tipo de vínculo
Branch, Pipelines y Test EntityTypes y EntitySets
Los siguientes EntityTypes yEntitySets son compatibles con las versiones de API v3.0-preview o v4.0-preview.
| 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, vea Informe de ejemplo de estado de progreso. | ✔️ | ✔️ |
| ParallelPipelineJobsSnapshot ParallelPipelineJobsSnapshot |
(Compuesto) Admite la comprensión del consumo de canalizaciones paralelas. Para obtener más información sobre las pruebas de canalización paralelas, vea Ejecutar pruebasen paralelo mediante la Visual Studio de prueba . | ✔️ | |
| 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, vea Pipeline pass rate trend sample report. | ✔️ | ✔️ |
| 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, vea Pipeline task duration sample report. | ✔️ | ✔️ |
| PipelineTask PipelineTasks |
Propiedades de las tareas que se usan dentro de una canalización. | ✔️ | ✔️ |
| TestConfiguration TestConfigurations |
Información de configuración del plan de prueba. Para más información sobre la configuración de pruebas, consulte Prueba de distintas 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, agrupado por Test (no TestRun). Para obtener un informe de ejemplo, vea 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 obtener más información sobre cómo definir casos de prueba, vea Crear 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, vea 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, vea Manual test execution trend sample report (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. | ✔️ | ✔️ |
| 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 para grupos de agentes muestra cómo se puede usar este conjunto de entidades. | ✔️ | |
| TaskAgentRequestSnapshot TaskAgentRequestSnapshots |
(Compuesto) | ✔️ |
Recursos adicionales:
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 una 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 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 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 tienen como resultado una sola entidad, mientras que otras tienen 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 y relaciones compuestas.
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 las propiedades de clave de fecha de entero correspondientes con el formato siguiente: YYYYMMDD.
Propiedades de entidad
En la tabla siguiente se proporciona una lista parcial de las propiedades de entidad WorkItemRevision para ilustrar algunos detalles comunes. Las tres primeras propiedades(CreatedDate, CreatedDateSKy CreatedOn)muestran que el mismo valor se suele expresar en varias propiedades, cada una diseñada para escenarios diferentes.
| Propiedad | Tipo | Descripción |
|---|---|---|
| CreatedDate | DateTimeOffset | Fecha en que se creó el elemento de trabajo, expresado en la zona horaria definida para la organización. Se usa normalmente para filtrar y para mostrar. |
| CreatedDateSK | Int32 | La fecha en que se creó el elemento de trabajo, expresada como en YYYYMMDD la zona horaria definida para la organización. Usado por herramientas externas para unir entidades relacionadas. |
| CreatedOn | Navegación | Propiedad de navegación a la entidad Date de la fecha en que se creó el elemento de trabajo, en la zona horaria definida para la organización. Se usa normalmente para hacer referencia a propiedades de la entidad Date en groupby instrucciones . |
| StoryPoints | Doble | Puntos asignados a un elemento de trabajo, normalmente agregados como suma. |
| Etiquetas | Navegación | Propiedad de navegación a una colección de entidades Tag. Se usa normalmente en $expand instrucciones para tener acceso a la propiedad Name para varias etiquetas de elemento de trabajo. |
| Título | String | Título del elemento de trabajo. |
| Revisión | Int32 | Revisión del elemento de trabajo. |
| WorkItemId | Int32 | Identificador del elemento de trabajo. |
| WorkItemRevisionSK | Int32 | Clave única de Analytics para la revisión del elemento de trabajo, que usan las herramientas externas para unir entidades relacionadas. |
| WorkItemType | String | Tipo de elemento de trabajo, por ejemplo, Error, Tarea, Caso de usuario. |
Nota
Los cambios en los campos de elementos de trabajo personalizados afectarán a la forma del modelo de datos y afectarán a todas las revisiones de elementos de trabajo. Por ejemplo, si agrega un campo nuevo, las consultas en los datos de revisión existentes previamente reflejarán la presencia del nuevo campo.