Consulta por fecha o iteración actual

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

En este artículo se muestra cómo enumerar elementos de trabajo por creación, cambio, resolución o fechas cerradas y cómo usar macros de fecha (por ejemplo, @Today) y macros de iteración para sprints de equipo. Para conocer los aspectos básicos de la ruta de acceso de iteración y las restricciones de cliente o macro, consulte Consulta por área o ruta de acceso de iteración.

Requisitos previos

Operadores admitidos y macros de fecha

Utilice los siguientes operadores y macros para los campos DateTime y Ruta de iteración en el Editor de consultas.

• Operadores de Fecha y Hora: = , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever
• Macros de fecha: @StartOfDay, @StartOfWeek, @StartOfMonth, , @StartOfYear, @Today
  Puede combinar +/- n con estas macros (por ejemplo, @Today - 7).
• Macros de iteración: @CurrentIteration y @CurrentIteration +/- n (consulte la siguiente nota y vínculo para las restricciones de cliente y el comportamiento de los parámetros de equipo).

Ejemplos de fechas rápidas (consultas comunes)

• Elementos creados en los últimos 30 días:

• Elementos modificados en una fecha específica:

• Elementos resueltos hoy:

• Elementos cerrados dentro de un período de tiempo especificado:

• Elementos cuya fecha de cierre es nula (no cerrada):

• Elementos cuyo estado ha cambiado en la última semana:

Uso de las @CurrentIteration macros (guía corta)

Use @CurrentIteration para enfocarse en el sprint actual del equipo y @CurrentIteration +/- n para crear una ventana deslizante de sprints (por ejemplo, los dos últimos, el actual y los dos siguientes). Puntos importantes:

• @CurrentIteration devuelve los elementos que están asignados al sprint actual dentro del contexto del equipo utilizado al ejecutar la consulta.
• @CurrentIteration +/- n desplaza esa ventana de sprints por n; útil para los análisis de tendencias o de traslado.
• Dado que el comportamiento de las macros y la compatibilidad con el cliente varían, consulte Consulta por área o ruta de acceso de iteración para obtener más información sobre los parámetros del equipo, qué clientes evalúan las macros y cómo se almacenan o expanden las macros al guardar consultas.

Imágenes de ejemplo (Editor de consultas del portal web):

Macros de fecha: inicio de día/semana/mes/año

Las macros de inicio ayudan a crear intervalos de fechas relativos coherentes:

• @StartOfDay, @StartOfWeek, , @StartOfMonth, @StartOfYear: use estas macros con +/- n para compilar intervalos como "desde el inicio de la semana" o "últimos 3 meses".
• Estas macros se evalúan mediante la interfaz de usuario del portal web; su comportamiento en escenarios que no son web puede diferir: probar en el cliente de destino.

Consultas de ejemplo:

Cuándo usar WIQL directamente

Use WIQL cuando:

• ** Necesita operadores avanzados como WAS EVER para los cambios en el camino de iteración.
• El Editor de consultas bloquea o marca una cláusula como no soportada (por ejemplo, algunos Was Ever usos). La extensión WIQL Editor le permite crear esas consultas y guardarlas.

Consulte Sintaxis del lenguaje de consulta de elementos de trabajo (WIQL) y la extensión de Marketplace de WIQL Editor para obtener ejemplos.

Contenido relacionado

• Consulta por ruta de acceso al área o la iteración
• Sintaxis de lenguaje de consultas de elemento de trabajo (WIQL)
• Campos de consulta, operadores y macros
• Atributos y campos de elementos de trabajo

API de REST

Para interactuar mediante programación con las consultas, consulte uno de estos recursos sobre la API REST:

• Referencia de la API REST de Azure DevOps Services
• Consultas
• Lenguaje de consultas de elemento de trabajo
• Capturar elementos de trabajo con consultas mediante programación