Referencia de metadatos para Azure Boards Analytics

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

El servicio Analytics recopila toda la definición de seguimiento del trabajo y la actividad de actualización de Azure Boards. Puede ejecutar consultas de Analytics directamente en el explorador y usar una combinación de propiedades para filtrar una consulta, agregar datos o crear un informe. Para obtener más información, consulte Definición de consultas básicas mediante OData Analytics.

En este artículo se describen la mayoría de las propiedades que puede usar para generar un informe de Análisis de seguimiento de trabajo. Analytics almacena todos los campos de seguimiento de trabajo como propiedades, excepto los campos html/texto enriquecido y historial. Los campos personalizados se agregan automáticamente a Analytics como propiedades personalizadas.

Introducción a los conjuntos de entidades

Al consultar Analytics para datos de seguimiento de trabajo, consulte la entidad WorkItems establecida para generar informes de estado y acumulación. Use el conjunto de entidades WorkItemSnapshot para generar informes de tendencia, agotamiento y grabación.

Use otros tipos de entidad, como Área, Iteración, Proyecto o Equipo para filtrar datos o seleccionar propiedades en las que se va a informar. Para obtener informes de ejemplo, consulte Informes de ejemplo y índice de referencia rápida.

Instantáneas

Los conjuntos de entidades de instantáneas de seguimiento de trabajo son WorkItemSnapshot y WorkItemBoardSnapshot. Una instantánea escribe en Analytics al mismo tiempo cada día y proporciona un registro de los valores definidos para un elemento de trabajo para ese día. Puede usar instantáneas para generar informes de tendencias.

De forma predeterminada, todas las tablas de instantáneas se modelan como tablas de hechos de instantáneas diarias. Una consulta para un intervalo de tiempo obtiene un valor para cada día y los intervalos de tiempo largos dan lugar a un gran número de registros. Si no necesita una precisión tan alta, puede usar instantáneas semanales o mensuales. Para obtener más información, consulte Uso de instantáneas semanales o mensuales para consultas de tendencia que abarcan un período de tiempo largo.

Revisiones de elementos de trabajo

Cada vez que actualiza un elemento de trabajo, el sistema crea una nueva revisión y la registra en el System.RevisedDate campo, lo que resulta útil para especificar un filtro de historial. Puede representar la fecha revisada por las RevisedDate (DateTime) propiedades y RevisedDateSK (Int32) .

Use la última propiedad de clave suplente de fecha para obtener el mejor rendimiento. Esta clave muestra la fecha en que se creó una revisión o muestra el valor "9999-01-01T00:00:00Z" null datetime de OData para revisiones activas o incompletas. Si desea todas las fechas desde {startDate}, inclusive, agregue el siguiente filtro a la consulta: RevisedDateSK eq null or RevisedDateSK gt {startDateSK}.

Use la entidad WorkItemRevisions establecida para cargar todas las revisiones de un elemento de trabajo determinado. La consulta devuelve todas las revisiones de elementos de trabajo históricos, incluida la revisión actual, para los elementos de trabajo en los que se filtra, no incluidos los elementos de trabajo eliminados.

Propiedades compartidas entre tipos de entidad

Las propiedades que puede seleccionar en una vista de Análisis corresponden a campos de seguimiento de trabajo normales y propiedades de Análisis seleccionadas, como Días de tiempo de ciclo y Días de tiempo de clientes potencial. Estas propiedades se definen para los siguientes tipos de entidad, a menos que se especifique lo contrario:

• Workitem
• WorkItemRevision
• WorkItemSnapshot
• WorkItemBoardSnapshot

En la tabla siguiente se enumeran y describen la mayoría de las propiedades que puede seleccionar en una vista analytics, incluidos los campos de seguimiento de trabajo normales y otras propiedades de Analytics.

Propiedades de navegación

Las propiedades de navegación de OData son los atributos de referencia de una entidad que apunta a otra entidad. En la tabla siguiente se proporciona un resumen de las propiedades de navegación, sus restricciones referenciales y los tipos de entidad para los que son válidos.

*La entidad WorkItem también admite las PredictTags funciones y Predict , que admiten tendencias predictivas en informes y widgets integrados de Análisis seleccionados.

BoardLocation y WorkItemBoardSnapshot

En la tabla siguiente se enumeran y describen las propiedades definidas para los tipos de entidad BoardLocation y WorkItemBoardSnapshot , a menos que se indique. Puede usar estos campos para filtrar los datos del elemento de trabajo en función del estado de un elemento de trabajo dentro de la columna de panel de un equipo, el callente o el nivel de trabajo pendiente. Para obtener un ejemplo que consulta el conjunto de entidades WorkItemBoardSnapshot , consulte el informe de ejemplo Diagrama de flujo acumulativo (CFD).

*En la tabla siguiente se enumeran los nombres de miembro para el BoardColumnSplit tipo enumerado, que puede usar para filtrar los elementos de trabajo en las columnas del panel Hacer o Listo .

Para obtener más información sobre las columnas de panel de un equipo, consulte los artículos siguientes:

• Adición de columnas al panel
• Dividir columnas en el panel para mostrar el trabajo en curso

Áreas

Las siguientes propiedades son válidas para el conjunto de entidades Areas , que está asociado al campo Ruta de acceso del área. Las claves suplentes asociadas a Area incluyen AreaSK y ProjectSK. Puede usar estas propiedades para filtrar o informar sobre los datos de seguimiento del trabajo en función de las asignaciones de ruta de acceso del área.

Las propiedades de navegación para el tipo de entidad Area y el conjunto de entidades Areas incluyen Project y Teams.

Para obtener más información sobre la ruta de acceso del área, consulte los siguientes artículos:

• Acerca de las rutas de acceso de área e iteración (sprint)
• Definición de rutas de acceso de área y asignación a un equipo

Iteraciones

Las siguientes propiedades son válidas para el conjunto de entidades Iteraciones , que está asociada al campo Ruta de acceso de iteración . Las claves suplentes asociadas a iteración incluyen IterationSK y ProjectSK. Puede usar estas propiedades para filtrar o informar sobre los datos de seguimiento del trabajo en función de las asignaciones de rutas de acceso de iteración.

Las propiedades de navegación para el tipo de entidad iteración y el conjunto de entidades Iteraciones incluyen Project y Teams.

Para obtener más información sobre las rutas de acceso de iteración, consulte los siguientes artículos:

• Acerca de las rutas de acceso de área e iteración (sprint)
• Definición de rutas de iteración (sprints) y configuración de las iteraciones del equipo

Procesos

Las siguientes propiedades son válidas para el tipo de entidad Process y el conjunto de entidades Processes . Las claves suplentes asociadas con Process incluyen ProcessSK, ProjectSKy TeamSK. Use estas propiedades para filtrar o notificar los datos de seguimiento del trabajo en los tipos de elementos de trabajo de un proyecto o equipo.

Puede usar estas propiedades para filtrar los datos de seguimiento del trabajo en función de un nivel de trabajo pendiente.

Para obtener más información sobre los trabajos pendientes de proceso y los tipos de elementos de trabajo, consulte los siguientes artículos:

• Creación y administración de procesos heredados
• Agregar y administrar tipos de elemento de trabajo
• Personalización de los trabajos pendientes o paneles (proceso de herencia)

Etiquetas

Las siguientes propiedades son válidas para el conjunto de entidades Tags . Las claves suplentes asociadas a Tag incluyen TagSK y ProjectSK. Las propiedades de navegación incluyen Project y su restricción ProjectSKreferencial . Para obtener más información sobre el uso de etiquetas, vea Agregar etiquetas de elemento de trabajo para clasificar y filtrar listas y paneles.

Puede usar estas propiedades para filtrar o informar sobre los datos de seguimiento del trabajo.

Equipos

Las siguientes propiedades son válidas para el tipo de entidad Team y el conjunto de entidades de Teams . Las claves suplentes asociadas con Team incluyen TeamSK y ProjectSK. Puede usar estas propiedades para filtrar o informar sobre los datos de seguimiento del trabajo en función de las asignaciones de equipo. Para obtener información sobre cómo usar y agregar equipos, consulte Acerca de los equipos y herramientas de Agile y Crear o agregar un equipo.

Las propiedades de navegación del conjunto de entidades de Teams incluyen Proyectos, Áreas e Iteraciones.

EnlacesDeElementosDeTrabajo

Las propiedades siguientes son válidas para el conjunto de entidades WorkItemLinks . La clave suplente de referencia de propiedad es WorkItemLinkSK. Consulte WorkItemLinks para informar sobre los tipos de vínculo primarios o secundarios, relacionados, predecesores o sucesores u otros tipos de vínculo.

Las propiedades de navegación del tipo de entidad WorkItemLink incluyen Projects, SourceWorkItem y TargetWorkItem.

Para obtener más información sobre los vínculos y los tipos de vínculo, consulte los siguientes artículos:

• Uso de vínculos para ver dependencias y realizar un seguimiento del trabajo relacionado
• Guía de referencia de los tipos de vínculo usados en Azure DevOps

CamposDeTipoDeElementoDeTrabajo

Las propiedades siguientes son válidas para el conjunto de entidades WorkItemTypeFields . Las claves de referencia de propiedad son FieldName, ProjectSKy WorkItemType.

Las propiedades de navegación incluyen Project. Para obtener un índice de todos los campos definidos para un proyecto, vea Descripciones de campos para campos de elementos de trabajo. Para obtener más información, consulte los artículos siguientes:

• Atributos y campos de elementos de trabajo
• Agregar y administrar campos (proceso de herencia)

Propiedades personalizadas

Los campos personalizados se agregan automáticamente al servicio Analytics como propiedades personalizadas. Custom_ o Custom. se antepone al nombre de la propiedad. Compruebe los metadatos de la colección como se describe en Consulta de los metadatos. En el ejemplo siguiente se muestra la sintaxis de metadatos para el campo personalizado Oportunidad de riesgo.

<Property Name="Custom_RiskOpportunity" Type="Edm.Double">
<Annotation Term="Display.DisplayName" String="Risk Opportunity"/>
<Annotation Term="Ref.ReferenceName" String="Custom.RiskOpportunity"/>
<Annotation Term="Display.Description" String="Risk Reduction | Opportunity Enablement Value. Enter a value from 1 to 5. 5 represents high risk reduction or high opportunity enablement."/>
</Property>

Tipos de elementos de trabajo personalizados y categorías de trabajos pendientes

Los datos de los tipos de elementos de trabajo personalizados se agregan automáticamente al servicio Analytics. Se crea una categoría personalizada cuando se define un tipo de elemento de trabajo personalizado y el nivel de trabajo pendiente, con Custom_ o Custom. anteponedo al GUID de categoría. Por ejemplo, una categoría personalizada, como Custom.49b81c4e-9c4f-4c04-94fd-d660cbf3a000 , por ejemplo, podría asignarse al tipo de elemento de trabajo personalizado portfolio en un trabajo pendiente de portfolios.

Contenido relacionado

• ¿Qué es Azure Boards?
• Seguimiento de casos, problemas, errores y otros elementos de trabajo en Azure Boards
• Atributos y campos de elementos de trabajo
• Índice de campos de elementos de trabajo
• Seguimiento del trabajo, proceso y límites del proyecto
• Representación de datos históricos en Analytics
• Modelo de datos para Analytics
• Directrices de consulta de OData Analytics