Referencia de metadatos para Azure Boards Analytics

  • Artículo

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

El servicio Analytics recopila toda la actividad de seguimiento del trabajo definida y actualizada a través de Azure Boards. Analytics almacena como propiedades todos los campos de seguimiento de trabajo, excepto los campos HTML/rich-text y History. Las propiedades personalizadas para campos personalizados se agregan automáticamente a Analytics.

En este artículo se describe la mayoría de las propiedades que puede usar para generar un informe de Analytics para el seguimiento del trabajo. Se usa una combinación de propiedades para filtrar una consulta, agregar datos o crear un informe. Puede ejecutar estas consultas directamente en el explorador. Para más información, consulte Definición de consultas básicas mediante OData Analytics. Si no está familiarizado con el seguimiento del trabajo y Azure Boards, le recomendamos que revise los siguientes artículos:

Nota

Se proporcionan descripciones de las entidades, propiedades y tipos enumerados admitidos por el modelo de datos de Analytics. Este es un borrador temprano. Proporcione comentarios sobre las áreas que le gustaría tener más información. Para consultar el modelo de datos, consulte Construcción de consultas de OData para Analytics.

Introducción a los conjuntos de entidades

Al consultar Analytics para los datos de seguimiento del trabajo, use uno de los siguientes tipos de entidad o conjuntos de entidades.

  • Consulta WorkItems para generar informes de estado y acumulación
  • Consulta WorkItemSnapshot para generar informes de tendencias, agotamiento y quema

Use otros tipos de entidad, como Area, IterationProject, , Teamu otras entidades para filtrar los datos o seleccionar las propiedades en las que informar. Para obtener un resumen de los informes de ejemplo, consulte Informes de ejemplo y índice de referencia rápida.

Nota

Para generar informes de estado y tendencias sobre tipos de elementos de trabajo específicos de prueba, consulte los WorkItems tipos de entidad y WorkItemSnapshot y filtre según el tipo de elemento de trabajo. Para obtener información sobre las ejecuciones de pruebas, los resultados de las pruebas u otros datos de prueba, consulte los TestRunstipos de entidad , TestPoints, TestResultsDailyTestSuite o TestPointHistorySnapshot . Para más información, consulte Referencia de metadatos de prueba para Azure DevOps.

EntitySet EntityType Descripción
Áreas Ámbito Las rutas de acceso de área del elemento de trabajo, con propiedades para agrupar y filtrar por jerarquía de áreas.
Fechas CalendarDate Fechas usadas para filtrar y agrupar otras entidades mediante relaciones.
Iteraciones Iteración Las rutas de acceso de iteración del elemento de trabajo, con propiedades para agrupar y filtrar por jerarquía de iteración.
BoardLocations BoardLocation Las ubicaciones de 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 panel Kanban y Flujo de trabajo.
Procesos Process 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. Compatible con la versión 2.0 de Analytics y versiones posteriores.
Proyectos Proyecto Todos los proyectos definidos para una organización (nube) o colección de proyectos (local).
Etiquetas Tag 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.
Teams Equipo 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.
Usuarios User 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 Kanban, que se usa para generar informes de tendencias. Para obtener un informe de ejemplo, consulte El informe de ejemplo diagrama de flujo acumulado (CFD).
WorkItemLinks WorkItemLink 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.
WorkItemRevisions WorkItemRevision Todas las revisiones históricas del elemento de trabajo, 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.
WorkItems Workitem 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.
WorkItemTypeFields WorkItemTypeField Propiedades del elemento de trabajo para cada tipo y proceso de elemento de trabajo. Se usa para admitir la creación de informes.

Acerca de las instantáneas

Hay dos conjuntos de entidades de instantáneas de seguimiento de trabajo: WorkItemSnapshot y WorkItemBoardSnapshot.

Una instantánea proporciona un registro de los valores definidos para un elemento de trabajo cada día. El registro se escribe en Analytics una vez al día al mismo tiempo cada día. Las instantáneas se usan cuando desea generar un informe de tendencias. De forma predeterminada, todas las tablas de instantáneas se modelan como tablas de hechos de instantáneas diarias. Si consulta un intervalo de tiempo, obtendrá un valor para cada día. 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 incluso mensuales.

Para más información, consulte Directrices de consulta de OData, Use instantáneas semanales o mensuales para consultas de tendencia que abarcan un período de tiempo largo.

Acerca de las revisiones de elementos de trabajo

Cada vez que actualiza un elemento de trabajo, el sistema crea una nueva revisión y registra esta acción en el System.RevisedDate campo, lo que hace que sea útil especificar un filtro de historial. La fecha revisada se representa mediante RevisedDate las propiedades (DateTime) y RevisedDateSK (Int32). Para obtener el mejor rendimiento, use la última clave suplente de fecha. Representa la fecha en que se creó una revisión o tiene un valor NULL para las revisiones activas o incompletas.

Si desea todas las fechas desde el {startDate} inclusive, agregue el siguiente filtro a la consulta.

RevisedDateSK eq null or RevisedDateSK gt {startDateSK}

Use el WorkItemRevisions conjunto de entidades 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 filtra. No incluye elementos de trabajo eliminados.

Propiedades compartidas en varios tipos de entidad

Las propiedades que puede seleccionar en una vista de Análisis corresponden a los campos de seguimiento de trabajo normales y seleccionan propiedades de Analytics, como Cycle Time Days y Lead Time Days. Estas propiedades, la mayoría de las cuales se enumeran y se describen en la tabla siguiente, se definen para los siguientes tipos de entidad, a menos que se especifique lo contrario.

  • WorkItem
  • WorkItemRevision
  • WorkItemSnapshot
  • WorkItemBoardSnapshot

Nota

El servicio Analytics no almacena datos para campos de texto largos asignados al tipo de datos HTML o de texto enriquecido. Esto incluye los campos Descripción e Historial . Analytics no almacena recuentos de vínculos ni archivos adjuntos. Para obtener una lista completa de los campos definidos en las plantillas de proceso predeterminadas, vea Índice de campo de elemento de trabajo. Para obtener descripciones de cada tipo de datos, vea Campos de consulta, operadores y macros.
No todas las propiedades asociadas a los campos específicos del proceso Scrum y CMMI se incluyen en la tabla siguiente. Para obtener una lista de estos campos, vea Descripciones de campos para campos predeterminados y de elementos de trabajo usados en plantillas de proceso, Campos usados para realizar un seguimiento de los elementos de trabajo de CMMI.

Muchas propiedades están basadas en fechas o basadas en el usuario. Estas propiedades están asociadas a los conjuntos de entidades CalendarDate y Userdescritos en Referencia de metadatos de fecha del calendario, Proyecto y Usuario.

Nombre para mostrar
Property name		 Tipo de datos Descripción
Reference name
Aceptado por
Microsoft_VSTS_CodeReview_AcceptedBy		 UserSK Nombre de la persona que respondió a una revisión de código. (proceso CMMI)
Microsoft.VSTS.CodeReview.AcceptedBy
Fecha de aceptación
AcceptedDate		 DateTime Fecha y hora en que la persona respondió a la revisión del código. (proceso CMMI)
Microsoft.VSTS.CodeReview.AcceptedDate
Activado por
ActivatedBy
ActivatedByUserSK		 UserSK Nombre del miembro del equipo que ha activado o reactivado el elemento de trabajo.
Microsoft.VSTS.Common.ActivatedBy
Fecha de activación
ActivatedDate		 DateTime Fecha y hora en que un miembro del equipo ha activado o reactivado un error o elemento de trabajo.
Microsoft.VSTS.CodeReview.ActivatedDate
Actividad
Activity		 String Tipo de actividad necesaria para realizar una tarea.
Microsoft.VSTS.Common.Activity

Tipo de actividad o disciplina asignada a una tarea. Los valores permitidos son: Implementación, Diseño, Desarrollo, Documentación, Requisitos y Pruebas. (Proceso ágil, Scrum y Básico)
Microsoft.VSTS.Common.Activity
AnalyticsUpdatedDate DateTimeOffset Los datos y la hora en que se actualizó por última vez la entidad.
Tipo de aplicación String Tipo de aplicación sobre el que las partes interesadas proporcionarán comentarios. Los valores predeterminados son Aplicación web, Máquina remota y Aplicación cliente. Los tipos válidos se especifican en el archivo de configuración de procesos para los proyectos que usan un proceso XML local.
Microsoft_VSTS_Feedback_ApplicationType
Ruta de acceso del área
AreaPath
AreaSK		 String Agrupa elementos de trabajo por característica del producto o áreas de equipo. El área debe ser un nodo válido en la jerarquía del proyecto.
System.AreaPath
Asignado a
AssignedTo
AssignedToUserSK		 UserSK Nombre del miembro del equipo que tiene actualmente la propiedad del elemento de trabajo.
System.AssignedTo
Id. de prueba automatizada
AutomatedTestId		 String Tipo de prueba que automatiza el caso de prueba.
Microsoft.VSTS.TCM.AutomatedTestId
Nombre de prueba automatizada
AutomatedTestName		 String Nombre del miembro del equipo que ha activado o reactivado el elemento de trabajo.
Microsoft.VSTS.TCM.AutomatedTestName
Almacenamiento de pruebas automatizadas
AutomatedTestStorage		 String Ensamblado que contiene la prueba que automatiza el caso de prueba.
Microsoft.VSTS.TCM.AutomatedTestStorage
Tipo de pruebas automatizadas
AutomatedTestType		 String Tipo de prueba que automatiza el caso de prueba.
Microsoft.VSTS.TCM.AutomatedTestType
Estado de automatización
AutomatedStatus		 String El estado de un caso de prueba con los siguientes valores aceptados: Automated, Not Automated o Planned.
Microsoft.VSTS.TCM.AutomationStatus
Prioridad del trabajo pendiente
BacklogPriority		 Double Número asignado por un proceso en segundo plano del sistema que se usa para apilar rango o realizar un seguimiento de la secuencia de elementos en un trabajo pendiente o panel. (Proceso de Scrum)
Microsoft.VSTS.Common.BacklogPriority
Bloqueado
Blocked		 String Indica que no se puede realizar ningún trabajo adicional en el elemento de trabajo. Los valores válidos son Sí o No. (proceso CMMI)
Microsoft.VSTS.CMMI.Blocked
Valor empresarial
BusinessValue		 Double Unidad de medida subjetiva que captura el valor empresarial relativo de una característica o elemento de trabajo pendiente del producto, en comparación con otros elementos del mismo tipo. Se debe considerar que un elemento que tenga asignado un número mayor tiene más valor empresarial que un elemento que tenga asignado un número menor.
Microsoft.VSTS.Common.BusinessValue
Cambiado por
ChangedBy
ChangedByUserSK		 UserSK Nombre de la persona que modificó el elemento de trabajo más recientemente.
System.ChangedBy
Fecha de modificación
ChangedDate		 DateTime Fecha y hora en que se modificó el elemento de trabajo.
System.ChangedDate
ChangedDateSK Int32 Fecha en que se modificó el elemento de trabajo, expresado como YYYYMMDD en la zona horaria definida para la organización. Se usa en herramientas externas para unir entidades relacionadas.
ChangedOn Navegación Propiedad de navegación a la entidad para la Date fecha en que se modificó el elemento de trabajo, en la zona horaria definida para la organización. Se usa normalmente para hacer referencia a propiedades de la Date entidad en groupby instrucciones .
Cerrado por
ClosedBy
ClosedByUserSK		 UserSK Nombre de la persona que cerró un elemento de trabajo.
Microsoft.VSTS.Common.ClosedBy
Fecha de cierre
ClosedDate
ClosedDateSK
ClosedOn		 DateTime Fecha y hora en que se cerró un elemento de trabajo.
Microsoft.VSTS.Common.ClosedDate
Recuento de comentarios
CommentCount		 Int32 Número de comentarios agregados a la sección Discusión del elemento de trabajo.
System.CommentCount
Comprometido
Committed		 String Indica si el requisito se confirma en el proyecto. Los valores válidos son Sí o No. (proceso CMMI)
Microsoft.VSTS.CMMI.Committed
CompletedDateSK Int32 Fecha de propiedad de navegación capturada por Analytics que almacena cuando el elemento de trabajo entró en un estado de flujo de trabajo asociado a la categoría Estado de flujo de trabajo Completado.
CompletedOn Navegación Propiedad de navegación a la entidad para la Date fecha en que el elemento de trabajo especificó un estado de flujo de trabajo asociado a la categoría Estado de flujo de trabajo Completado, en la zona horaria definida para la organización. Se usa normalmente para hacer referencia a las propiedades de la entidad en groupby instrucciones Date .
Trabajo completado
CompletedWork		 Double Medida de la cantidad de trabajo invertida en una tarea.
Microsoft.VSTS.Scheduling.CompletedWork
Creada por
CreatedBy
CreatedByUserSK		 UserSK Nombre de la persona que creó el elemento de trabajo.
Microsoft.VSTS.Common.CreatedBy
Fecha de creación
CreatedDate
CreatedDateSK		 DateTime 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 mostrar.
Microsoft.VSTS.Common.CreatedDate
CreatedDateSK Int32 Fecha en que se creó el elemento de trabajo, expresado como YYYYMMDD en la zona horaria definida para la organización. Se usa en herramientas externas para unir entidades relacionadas.
CreatedOn Navegación Propiedad de navegación a la entidad para la Date 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 las propiedades de la entidad en groupby instrucciones Date .
Días de tiempo de ciclo
CycleTimeDays		 Double El tiempo del ciclo se calcula a partir de la primera entrada de una categoría de estado En curso o Resuelta para escribir una categoría de estado Completado . Para más información, consulte widgets tiempo de ejecución y tiempo de ciclo.
Materia
Discipline		 String Tipo de actividad o disciplina asignada a una tarea. Los valores permitidos son: Analysis*, Development, Test, User Education y User Experience. (Proceso CMMI)
Microsoft.VSTS.Common.Activity
Due Date
DueDate		 DateTime Fecha de vencimiento prevista por la que se resolverá un problema o un elemento de trabajo. (Proceso ágil)
Microsoft.VSTS.Scheduling.DueDate
Esfuerzo
Effort		 Double Una estimación de la cantidad de trabajo que un artículo de trabajo pendiente de producto (proceso de Scrum) o un problema (proceso básico) requerirá implementar.
Microsoft.VSTS.Scheduling.Effort
Fecha final
FinishDate		 DateTime Fecha y hora en que la programación indica que se completará un elemento de trabajo.
Microsoft.VSTS.Scheduling.FinishDate
Encontrado en
FoundIn		 String Número de compilación del producto, también denominada revisión, en la que se encontró un error.
Microsoft.VSTS.Build.FoundIn
Fecha de entrada
InProgressDate		 DateTime Fecha almacenada de Analytics que captura la fecha y hora en que un elemento de trabajo se movió a un estado que pertenece a la categoría de estado En curso .
InProgressDateSK Int32 Fecha en que el elemento de trabajo se movió a un estado que pertenece a la categoría de estado En curso , expresada como YYYYMMDD en la zona horaria definida para la organización. Se usa en herramientas externas para unir entidades relacionadas.
Compilación de integración
IntegrationBuild		 String Número de compilación de producto que contiene el código o corrige un error.
Microsoft.VSTS.Build.IntegrationBuild
Es actual
IsCurrent		 Boolean Admite el filtrado de los datos para ver la instantánea más reciente del conjunto filtrado de elementos de trabajo estableciendo el valor en True.
Válido para estos tipos de entidad: WorkItemRevision, WorkItemBoardSnapshoty BoardLocation.
Es la última revisión del día
IsLastRevisionOfDay		 Boolean Indica que la instantánea representa la última revisión del día cuando se establece en True.
Es la última revisión del período
IsLastRevisionOfPeriod		 Boolean Indica que la instantánea representa la última revisión del período cuando se establece en True.
Problema
Issue		 String Indica que el paso compartido va asociado a un resultado esperado. Los valores permitidos son Sí y No.
Microsoft.VSTS.Common.Issue
Días de tiempo de ejecución
LeadTimeDays		 Double El tiempo de espera se calcula a partir de la creación del elemento de trabajo o escribe una categoría de estado Propuesta para escribir una categoría de estado Completado . Para más información, consulte widgets tiempo de ejecución y tiempo de ciclo.
Estimación original
OriginalEstimate		 Double Medida de la cantidad de trabajo necesaria para llevar a cabo una tarea.
Microsoft.VSTS.Scheduling.OriginalEstimate
Id. de elemento de trabajo primario
ParentWorkItemId		 Int32 Identificador único que identifica el elemento de trabajo vinculado como primario. Resulta útil para generar informes acumulativos. El campo Primario está disponible en Azure DevOps Server 2020 y versiones posteriores. Válido para estos tipos de entidad: WorkItemRevision y WorkItem.
System.Parent
Prioridad
Priority		 Int32 Calificación subjetiva del error, problema, tarea o caso de prueba respecto al negocio. Los valores incluyen: - 1, 2 o 3.
Microsoft.VSTS.Common.Priority
Nombre del proyecto
ProjectName		 Navegación Nombre del proyecto al que pertenece el elemento de trabajo. Para obtener más información, vea Fecha del calendario, Referencia de metadatos de Project y Usuario, Propiedades de Project.
System.TeamProject
ProjectSK GUID GUID asignado al proyecto al que pertenece el elemento de trabajo.
Rating
Reason		 String Número de estrellas que recibe un elemento de un revisor, según un sistema de calificación basado en estrellas. (Respuesta de comentarios) El número se almacena en el sistema y se escribe como sigue:- 0 - No clasificado, 1 - Pobre, 2 - Feria, 3 - Bueno, 4 - Muy Bueno, y 5 - Excelente. Válido para estos tipos de entidad: WorkItemRevision y WorkItem.
Microsoft.VSTS.Common.Rating
Motivo
Reason		 String Motivo por el que el elemento de trabajo está en el estado actual. Cada transición de un estado de flujo de trabajo a otro está asociado a un motivo correspondiente.
System.Reason
Trabajo restante
RemainingWork		 Double Medida de la cantidad de trabajo que todavía queda para llevar a cabo una tarea.
Microsoft.VSTS.Scheduling.RemainingWork
Resuelto por
ResolvedBy
ResolvedByUserSK		 UserSK Nombre del miembro del equipo que resolvió el error o caso de usuario.
Microsoft.VSTS.Common.ResolvedBy
Fecha de resolución
ResolvedDate		 DateTime Fecha y hora en que se resolvió el error o caso de usuario.
Microsoft.VSTS.Common.ResolvedDate
ResolvedDateSK Int32 Fecha en que se resolvió el elemento de trabajo, expresado como YYYYMMDD en la zona horaria definida para la organización. Se usa en herramientas externas para unir entidades relacionadas.
ResolvedOn Navegación Propiedad de navegación a la entidad para la Date fecha en que se resolvió el elemento de trabajo, en la zona horaria definida para la organización. Se usa normalmente para hacer referencia a las propiedades de la entidad en groupby instrucciones Date .
Motivo de resolución
ResolvedReason		 String Motivo por el que se resolvió el error; por ejemplo, se corrigió.
Microsoft.VSTS.Common.ResolvedReason
Revisión
Revision		 Int32 Número que se asigna a la revisión histórica de un elemento de trabajo.
System.Rev
Fecha de revisión
RevisedDate		 DateTime Fecha y hora en que se modificó o actualizó un elemento de trabajo.
RevisedDateSK Int32 Fecha en que se revisó el elemento de trabajo, expresado como YYYYMMDD en la zona horaria definida para la organización. Se usa en herramientas externas para unir entidades relacionadas.
RevisedOn Navegación Propiedad de navegación a la entidad para la Date fecha en que se revisó el elemento de trabajo, en la zona horaria definida para la organización. Se usa normalmente para hacer referencia a las propiedades de la entidad en groupby instrucciones Date .
Riesgo
Risk		 Double Calificación subjetiva de la incertidumbre relativa sobre si un caso de usuario se completará correctamente o no. Los valores válidos incluyen: 1 - Alto, 2 - Medio y 3 - Bajo.
Microsoft.VSTS.Common.Risk
Gravedad
Severity		 Double Calificación subjetiva del efecto de un error, problema o riesgo en el proyecto. Los valores válidos incluyen: 1 - Crítico, 2 - Alto, 3 - Medio y 4 - Bajo.
Microsoft.VSTS.Common.Severity
Tamaño
Size		 Double Una estimación de la cantidad de trabajo que requiere un requisito (proceso cmMI) para implementar.
Microsoft.VSTS.Scheduling.Size
Rango en la pila
StackRank		 Double Número asignado por un proceso en segundo plano del sistema que se usa para apilar rango o realizar un seguimiento de la secuencia de elementos en un trabajo pendiente o panel. (Procesos ágiles, Scrum y básicos)
Microsoft.VSTS.Common.StackRank
Fecha de inicio
StartDate		 DateTime Fecha y hora asignadas a un elemento de trabajo para que se inicie el trabajo.
Microsoft.VSTS.Scheduling.StartDate
State
State		 String Estado actual del elemento de trabajo. Los valores válidos para el estado son específicos de cada tipo de elemento de trabajo y personalizaciones realizadas en él.
System.State
Categoría de estado
StateCategory		 String Las categorías de estado determinan cómo Azure Boards y seleccionar widgets de panel tratan cada estado de flujo de trabajo. Las categorías de estado que se usan incluyen: Propuesta, En curso, Resuelta, Quitada y Completada. Para más información, consulte Uso de estados de flujo de trabajo y categorías de estado. Válido solo para el tipo de WorkItemRevision entidad.
Fecha de cambio de estado
StateChangeDate		 DateTime Fecha y hora en que cambió el valor del campo Estado .
Microsoft.VSTS.Common.StateChangeDate
StateChangeSK Int32 Fecha en la que se cambió el estado de un elemento de trabajo, expresado como YYYYMMDD en la zona horaria definida para la organización. Se usa en herramientas externas para unir entidades relacionadas.
StateChangeOn Navegación La propiedad de navegación a la entidad para la Date fecha en que se cambió el estado de un elemento de trabajo, en la zona horaria definida para la organización. Se usa normalmente para hacer referencia a las propiedades de la entidad en groupby instrucciones Date .
Puntos de historia
StoryPoints		 Double Una estimación de la cantidad de trabajo que requiere un artículo de usuario (proceso ágil) para implementar, normalmente agregado como suma.
Microsoft.VSTS.Scheduling.StoryPoints
Etiquetas
TagNames		 String Lista delimitada por punto y coma de etiquetas asignadas a uno o varios elementos de trabajo con fines de filtrado o consulta.
System.Tags
Fecha prevista
TargetDate		 DateTime Fecha de vencimiento prevista por la que se resolverá o completará un problema u otro elemento de trabajo.
Microsoft.VSTS.Scheduling.TargetDate
Tipo de conjunto de pruebas String Especifica el tipo de conjunto de pruebas. Entre los valores válidos se incluyen: Basado en consultas, Basado en requisitos y Estático.
Microsoft_VSTS_TCM_TestSuiteType
Identificador de tipo de conjunto de pruebas Int64 Número asignado por el sistema que corresponde a la categoría del conjunto de pruebas y que solo se aplica a los conjuntos de pruebas. Los valores asignados son: 1 (estático), 2 (basado en consultas) y 3 (basado en requisitos).
Microsoft_VSTS_TCM_TestSuiteTypeId
Importancia de tiempo
TimeCriticality		 Double Unidad de medida subjetiva que captura cómo disminuye el valor empresarial con el tiempo. Los valores más altos indican que la característica o la epopeya es inherentemente más crítica en el tiempo que los elementos con valores más bajos.
Microsoft.VSTS.Common.TimeCriticality
Título
Title		 String Breve descripción que resume lo que es el elemento de trabajo y que sirve para que los miembros del equipo lo distingan de los otros elementos de trabajo de una lista.
System.Title
Área de valores
ValueArea		 String Área del valor de cliente dirigida por la epopeya, la característica o el elemento de trabajo pendiente. Los valores incluyen: Arquitectura o Empresa.
Microsoft.VSTS.Common.ValueArea
Marca de agua
Watermark		 String Campo administrado por el sistema que aumenta con los cambios realizados en un elemento de trabajo. Válido para estos tipos de entidad: WorkItemRevision y WorkItem.
System.Watermark
Identificador de elemento de trabajo
WorkItemId		 Int32 Identificador único que se ha asignado a un elemento de trabajo. Los identificadores de elemento de trabajo son únicos en todos los proyectos y dentro de una organización o colección de proyectos.
System.Id
WorkItemRevisionSK Int32 La clave única de Analytics para la revisión del elemento de trabajo que usan las herramientas externas para unir entidades relacionadas.
Tipo de elemento de trabajo
WorkItemType		 String Nombre del tipo de elemento de trabajo. Los tipos de elementos de trabajo se definen en función del proceso usado al crear el proyecto. Para obtener más información, consulte Acerca de los procesos y las plantillas de proceso.
System.WorkItemType

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.

Nombre para mostrar Nombre
Restricción y propiedad referenciales		 Válido para tipos de entidad
ChangedOn
ChangedDateSK, DateSK		 WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
ClosedOn
ClosedDateSK, DateSK		 WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
CreatedOn
CreatedDateSK, DateSK		 WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
ResolvedOn
ResolvedDateSK, DateSK		 WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
StateChangeOn
StateChangeDateSK, DateSK		 WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
InProgressOn
InProgressDateSK, DateSK		 WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
CompletedOn
CompletedDateSK, DateSK		 WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
ChangedOn
ChangedDateSK, DateSK		 WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
RevisedOn
RevisedDateSK, DateSK		 WorkItemRevision, WorkItemSnapshot
Date
DateSK, DateSK		 WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
Áreas Area
AreaSK		 WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
BoardLocation WorkItemRevision, WorkItem, WorkItemBoardSnapshot
Iteraciones Iteration
IterationSK		 WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Asignado a AssignedTo
AssignedToUserSK, UserSK		 WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Modificado por ChangedBy
ChangedByUserSK, UserSK		 WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Creada por CreatedBy
CreatedByUserSK, UserSK		 WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Activado por ActivatedBy
ActivatedByUserSK, UserSK		 WorkItemRevision,WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Cerrado por ClosedBy
ClosedBySK, UserSK		 WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
ResolvedBy ResolvedBy
ResolvedByUserSK, UserSK		 WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
Teams Area, BoardLocation, Iteration, WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
Etiquetas WorkItem, WorkItemRevision, WorkItemBoardSnapshot
Proyecto Project
ProjectSK, ProjectSK		 Tag, WorkItemBoardSnapshot, WorkItemLink, WorkItemRevision, WorkItemSnapshot, WorkItemTypeField,
Procesos WorkItemRevision, WorkItem, WorkItemSnapshot
Revisiones WorkItem
Vínculos WorkItem
Children WorkItem
Parent WorkItem
Descendants WorkItem
Workitem WorkItemId WorkItemRevision

Predicción de funciones

Las dos funciones siguientes son compatibles con la entidad WorkItem . Estas funciones se usan para admitir tendencias predictivas en informes y widgets integrados de Analytics.

  • PredictTags
  • Predict

BoardLocation y WorkItemBoardSnapshot

Las propiedades enumeradas y descritas en la tabla siguiente se definen para los siguientes tipos de entidad, a menos que se indiquen específicamente. Con estos campos, puede filtrar los datos del elemento de trabajo en función del estado de un elemento de trabajo dentro de la columna de panel Kanban de un equipo, un callente o un nivel de trabajo pendiente.

  • BoardLocation
  • WorkItemBoardSnapshot

Para obtener un ejemplo que consulta el WorkItemBoardSnapshot conjunto de entidades, consulte el informe de ejemplo Diagrama de flujo acumulativo (CFD).

Nombre para mostrar
Property name		 Tipo de datos Descripción
Reference name
Id. del panel
BoardId		 Guid GUID único asignado a un panel Kanban. Cada equipo está asociado a una o varias tablas Kanban.
Nombre de referencia de categoría del panel
BoardCategoryReferenceName		 String Nombre asignado a la categoría de tipos de elementos de trabajo usados para rellenar un panel Kanban. Por ejemplo, la placa de trabajo pendiente del producto está asociada a la categoría Requisitos. Para más información, consulte Personalización de los trabajos pendientes o paneles (proceso de herencia).
Nombre del panel
BoardName		 String Nombre asignado al panel Kanban. Por ejemplo, Historias, Elementos de trabajo pendiente, Características y Epopeyas.
Nivel de panel
BoardLevel		 Int32 Número asignado al panel Kanban en función de dónde se encuentra dentro de la jerarquía de paneles Kanban.
Tipo de trabajo pendiente
BacklogType		 String Nombre del tipo de trabajo pendiente. Por ejemplo, iteración, requisito o cartera.
Nombre de la columna
ColumnName		 String Nombre de la columna del panel Kanban a la que se asigna actualmente un elemento de trabajo, como Active, Closed, Committed, Done u otra etiqueta de columna personalizada.
System.BoardColumn
Orden de columna
ColumnOrder		 Int32 Número asignado a la columna del panel Kanban en términos de su secuencia dentro del panel Kanban.
Listo
Done		 Enumerated Indica la ubicación de la columna dividida. Los valores válidos se enumeran a continuación para BoardColumnSplit.
Límite de elementos de columna
ColumnItemLimit		 Int32 Número asignado a la columna del panel Kanban en términos de su secuencia.
¿Está visible la placa?
IsBoardVisible		 Boolean Indica si el equipo ha elegido para que un panel sea visible o no.
Es la división de columnas
IsColumnSplit		 Boolean Indica si una columna se ha dividido en columnas Doing y Done como se describe en Split columns on your Kanban board (Dividir columnas en el panel Kanban) para mostrar el trabajo en curso.
Es actual
IsCurrent		 Boolean Propiedad que admite el filtrado de los datos para ver la instantánea más reciente del conjunto filtrado de elementos de trabajo estableciendo el valor en True.
Es el carril predeterminado
IsDefaultLane		 Boolean Propiedad que indica que el elemento de trabajo se asigna a la calle predeterminada (True) o no (False).
Listo
IsDone		 Boolean Asignación actual del elemento de trabajo a Hacer (False) o Listo (True) dentro de una columna Kanban. Solo se asigna cuando las columnas divididas están habilitadas para una columna de panel Kanban.
System.BoardColumnDone
Id. de carril
LaneId		 Guid Guid único asignado a un carril de natación de tabla Kanban. Cada equipo puede agregar una o varias carriles de natación a un tablero Kanban. Para obtener más información sobre las calles, consulte Acelerar el trabajo de su equipo mediante el uso de calles en el tablero Kanban.
Nombre del carril
LaneName		 String Nombre asignado a la calle del tablero Kanban.
System.BoardLane
Orden de carril
LaneOrder		 Int32 Número asignado a la calle del tablero Kanban en términos de su secuencia.

Miembros enumerados de BoardColumnSplit

En la tabla siguiente se enumeran los nombres de miembro para el BoardColumnSplit tipo enumerado, que se puede usar para filtrar los elementos de trabajo en la columna De la placa Hacer o Listo .

Nombre del miembro Valor Nombre para mostrar
Doing 0 En curso
Done 1 Listo
Unknown 2 Desconocido (no dividido)

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

Á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 área.

Nombre para mostrar Nombre Tipo de datos Descripción
AnalyticsUpdatedDate DateTime Marca de agua que indica la última vez que se actualizaron los datos de Analytics.
Number Int32 Valor entero asignado a un nodo Ruta de acceso de área cuando se crea.
Profundidad Depth Int32 Nivel en el que se define la ruta de acceso del área en función de su profundidad desde el nivel raíz.
Id. de área AreaId GUID Identificador único asignado a una ruta de acceso de área cuando se crea.
Nivel de área 1 a
Nivel de área 14		 AreaLevel1 mediante
AreaLevel14		 String Nombre asociado al nivel de nodo de una ruta de acceso de área. Se admiten hasta 14 niveles anidados. Por ejemplo, el nivel de área 1 siempre corresponde al nodo raíz y al nombre del proyecto.
Nombre del área AreaName String Nombre definido para la ruta de acceso del área cuando se crea.
Ruta de acceso del área AreaPath String Ruta de acceso completa de la ruta de acceso del área a partir del nodo raíz.

Importante

La eliminación de rutas de acceso de área o la reconfiguración de las rutas de acceso de iteración pueden provocar una pérdida de datos y no se pueden revertir. Por ejemplo, los gráficos de widgets de evolución o de evolución, la evolución del sprint y los gráficos de velocidad de los equipos cuyas rutas de acceso de área cambian no reflejarán los datos correctos. Los gráficos de tendencias históricos hacen referencia a la ruta de acceso del área y la ruta de acceso de iteración tal como se define en un punto del pasado para cada elemento de trabajo. Cuando se elimina una ruta de acceso de área o una ruta de acceso de iteración , no se pueden recuperar los datos históricos de ella.

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

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

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 ruta de iteración.

Nombre para mostrar Nombre Tipo de datos Descripción
AnalyticsUpdatedDate DateTime Marca de agua que indica la última vez que se actualizaron los datos de Analytics.
Number Int32 Valor entero asignado a un nodo Ruta de acceso de iteración cuando se crea.
Profundidad Depth Int32 Nivel en el que se define la ruta de acceso de iteración en función de su profundidad desde el nivel raíz.
Fecha de finalización EndDate DateTime Fecha de finalización definida para la ruta de acceso de iteración.
IsEnded IsEnded Boolean Cuando se establece en True, indica que la fecha de finalización de la ruta de acceso de iteración está en el pasado.
Identificador de iteración IterationId GUID Identificador único asignado a una ruta de acceso de iteración cuando se crea.
Nivel de iteración 1 a
Nivel de iteración 14		 IterationLevel1 mediante
IterationLevel14		 String Nombre asociado al nivel de nodo de una ruta de acceso de iteración. Se admiten hasta 14 niveles anidados. Por ejemplo, el nivel de iteración 1 siempre corresponde al nodo raíz y al nombre del proyecto.
Nombre de iteración IterationName String Nombre definido para una ruta de acceso de iteración cuando se crea.
Ruta de acceso de la iteración IterationPath String Ruta de acceso completa de la ruta de acceso de iteración a partir del nodo raíz. La iteración debe ser un nodo válido en la jerarquía del proyecto.
System.IterationPath
Fecha de inicio StartDate DateTime Fecha de inicio definida para la ruta de acceso de iteración.

Importante

La eliminación de rutas de acceso de área o la reconfiguración de las rutas de acceso de iteración pueden provocar una pérdida de datos y no se pueden revertir. Por ejemplo, los gráficos de widgets de evolución o de evolución, la evolución del sprint y los gráficos de velocidad de los equipos cuyas rutas de acceso de área cambian no reflejarán los datos correctos. Los gráficos de tendencias históricos hacen referencia a la ruta de acceso del área y la ruta de acceso de iteración tal como se define en un punto del pasado para cada elemento de trabajo. Cuando se elimina una ruta de acceso de área o una ruta de acceso de iteración , no se pueden recuperar los datos históricos de ella.

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

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

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. Puede usar estas propiedades para filtrar o informar sobre los datos de seguimiento del trabajo en función de los tipos de elementos de trabajo usados por un proyecto o equipo.

Nota

El tipo de entidad Process y process entity set son compatibles con las versiones v-2.0, v3.0-preview y v4.0-preview de Analytics.

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

Nombre para mostrar Nombre Tipo de datos Descripción
AnalyticsUpdatedDate DateTime Marca de agua que indica la última vez que se actualizaron los datos de Analytics.
ProjectSK GUID Clave de proyecto asociada al proceso.
TeamSK GUID Clave de equipo asociada al proceso.
Nombre de referencia de categoría de trabajo pendiente BacklogCategoryReferenceName String Nombre de referencia de categoría asignado al trabajo pendiente asociado al tipo de elemento de trabajo. Entre los ejemplos se incluyen Microsoft.EpicCategory, Microsoft.FeatureCategory, Microsoft.RequirementCategory, Microsoft.TaskCategory.
Nombre del trabajo pendiente BacklogName Boolean Nombre de referencia asignado al trabajo pendiente asociado al tipo de elemento de trabajo.
Tipo de trabajo pendiente BacklogType GUID Identificador único asignado a una ruta de acceso de iteración cuando se crea.
Nivel de trabajo pendiente BacklogLevel String Especifica el nivel de trabajo pendiente asociado al tipo de elemento de trabajo. Si el tipo de elemento de trabajo no está asociado a un nivel de trabajo pendiente, el valor devuelto es null.
Tipo de elemento de trabajo WorkItemType String Nombre definido para un tipo de elemento de trabajo.
Tiene trabajo pendiente HasBacklog String Indica si el tipo de elemento de trabajo pertenece a un trabajo pendiente.
Es tipo oculto IsHiddenType Boolean Indica si el tipo de elemento de trabajo se ha deshabilitado.
Tipo de error IsBugType Boolean Indica si el tipo de elemento de trabajo pertenece a la categoría Error.
Está eliminado IsDeleted Boolean Indica si se ha eliminado el tipo de elemento de trabajo.

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

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

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. Custom_ se antepone al GUID de categoría. Por ejemplo, para el tipo de elemento de trabajo personalizado Portfolio con un trabajo pendiente de Portfolios , se asigna un GUID a la categoría personalizada, como Custom.49b81c4e-9c4f-4c04-94fd-d660cbf3a000.

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.

Nombre para mostrar Nombre Tipo de datos Descripción
Id. de etiqueta TagId GUID Identificador único asignado a la etiqueta cuando se crea.
Nombre de etiqueta TagName String El nombre de la etiqueta.

Teams

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.

Nombre para mostrar Nombre Tipo de datos Descripción
AnalyticsUpdatedDate DateTime Marca de agua que indica la última vez que se actualizaron los datos de Analytics.
Id. de equipo TeamId GUID Identificador único asignado al equipo cuando se crea.
Nombre del equipo TeamName String Nombre del equipo.

Las propiedades de navegación del conjunto de entidades de Teams incluyen Projects, Areasy Iterations.

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.

Nombre para mostrar Nombre Tipo de datos Descripción
AnalyticsUpdatedDate DateTime Marca de agua que indica la última vez que se actualizaron los datos de Analytics.
WorkItemLinkSK Int32 Clave suplente asignada a la WorkItemLink entidad.
Fecha de creación CreatedDate GUID Fecha en que se creó el vínculo.
Comment Comment String Comentario agregado al crear el vínculo.
Fecha de eliminación DeletedDate String Fecha en que se eliminó el vínculo.
Id. de tipo de vínculo LinkTypeId Int32 Identificador asignado al elemento de trabajo de destino al que está vinculado.
Nombre del tipo de vínculo LinkTypeName String Nombre descriptivo asignado al tipo de vínculo.
Nombre de referencia del tipo de vínculo LinkTypeReferenceName String Nombre de referencia asignado al tipo de vínculo.
El tipo de vínculo es acíclico LinkTypeIsAcyclic Boolean El valor del atributo de tipo de vínculo que indica el tipo de vínculo permite relaciones circulares cuando el valor se establece en True. Por ejemplo, los vínculos de tipo de árbol restringen las relaciones circulares.
El tipo de vínculo es direccional LinkTypeIsDirectional Boolean El valor del atributo de tipo de vínculo que indica que el tipo de vínculo es direccional. Los tipos de vínculo direccional se definen en pares con un componente hacia delante e inverso.
Id. de elemento de trabajo de origen SourceWorkItemId Int32 Identificador asignado al elemento de trabajo de origen al que está vinculado.
Id. de elemento de trabajo de destino TargetWorkItemId Int32 Identificador asignado al elemento de trabajo de destino al que está vinculado.

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

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

WorkItemTypeFields

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

Nombre para mostrar Nombre Tipo de datos Descripción
Nombre del campo FieldName String Nombre descriptivo asignado a un campo por el sistema o cuando se crea.
Nombre de referencia de campo FieldReferenceName String Nombre de referencia asignado a un campo por el sistema o cuando se crea un campo personalizado.
Tipo de campo FieldType String Tipo de datos asignado a un campo.
Tipo de elemento de trabajo WorkItemType String Nombre de los tipos de elementos de trabajo para los que se define un campo.

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:

Propiedades personalizadas

Los campos personalizados se agregan automáticamente al servicio Analytics como una propiedad personalizada. Custom_ o Custom. se antepone al nombre de la propiedad. Compruebe los metadatos de la colección como se describe en Construcción de consultas de OData para Analytics, componentes de dirección URL para consultar los metadatos. En el ejemplo siguiente se proporciona la sintaxis de metadatos para el campo personalizado, Risk Opportunity.

<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>