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 los elementos de trabajo mediante la creación, el cambio, la resolución o las fechas cerradas. También se muestra cómo usar macros de fecha, como @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.

Sugerencia

Puede usar la inteligencia artificial para ayudar con esta tarea más adelante en este artículo, o consulte Enable AI assistance with Azure DevOps MCP Server para empezar.

Requisitos previos

Categoría Requisitos
Pertenencia a proyectos Debe agregarse como miembro del proyecto.
Niveles de acceso - Para ver y ejecutar consultas compartidas: debe ser miembro de Project.
- Para agregar y guardar una consulta compartida: debe tener al menos acceso básico.
Permisos Asegúrese de que el permiso De contribución está establecido en Permitir para la carpeta en la que desea agregar una consulta. Es posible que su organización tenga que configurar manualmente el grupo Colaboradores para conceder este permiso.

Nota

Necesita un nivel de acceso suficiente y permiso De contribución para guardar consultas compartidas. El acceso básico no es suficiente.

Categoría Requisitos
Pertenencia a proyectos Debe agregarse como miembro del proyecto.
Niveles de acceso - Para ver y ejecutar consultas compartidas: debe ser miembro de Project.
- Para agregar y guardar una consulta compartida: debe tener al menos acceso básico.
Permisos Asegúrese de que el permiso De contribución está establecido en Permitir para la carpeta en la que desea agregar una consulta. Es posible que su organización tenga que configurar manualmente el grupo Colaboradores para conceder este permiso.

Nota

Necesita un nivel de acceso suficiente y permiso De contribución para guardar consultas compartidas. El acceso básico no es suficiente.

Operadores admitidos y macros de fecha

Utiliza los siguientes operadores y macros para los campos Fecha y hora 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, use @Today - 7.
  • Macros de iteración: @CurrentIteration y @CurrentIteration +/- n. Para conocer las restricciones de cliente y el comportamiento de los parámetros de equipo, consulte la siguiente nota y vínculo.

Nota

La página de iteración Consulta por área o ruta de iteración describe en detalle las macros de iteración y las restricciones de los clientes. Si necesita consultas para ejecutarse en clientes que no son web o a través de REST o WIQL fuera de la interfaz de usuario web, compruebe la compatibilidad con macros en su entorno. Considere la posibilidad de expandir macros a rutas de acceso explícitas.

Ejemplos de fechas rápidas (consultas comunes)

  • Elementos creados en los últimos 30 días: Screenshot que muestra la cláusula Editor de Power Query para buscar elementos creados en los últimos 30 días.

  • Elementos modificados en una fecha específica: Screenshot que muestra la cláusula Editor de Power Query para buscar elementos modificados en una fecha específica.

  • Elementos resueltos hoy: Screenshot que muestra la cláusula Editor de Power Query para buscar elementos resueltos hoy.

  • Elementos cerrados dentro de un período de tiempo especificado: Screenshot que muestra la cláusula Editor de Power Query para buscar elementos cerrados dentro de un período de tiempo especificado.

  • Elementos cuya fecha de cierre es null (no cerrada): Screenshot que muestra la cláusula Editor de Power Query para buscar elementos cuya fecha cerrada está vacía o null.

  • Elementos cuyo estado ha cambiado en la última semana: Screenshot que muestra la cláusula Editor de Power Query para los elementos cuyo estado se actualizó 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 en n; útil para análisis de tendencias o de traspasos.
  • Dado que el comportamiento de las macros y el soporte técnico de 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 y expanden las macros al guardar consultas.

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

Captura de pantalla que muestra el filtro del Editor de consultas usando la macro CurrentIteration con un parámetro de equipo.

Captura de pantalla que muestra las cláusulas más y menos de CurrentIteration para una ventana deslizante de sprints.

Sugerencia

Si @CurrentIteration no devuelve los resultados esperados, comprueba la iteración seleccionada por el equipo y los intervalos de fechas de la iteración en la configuración del equipo.

Macros de fecha: inicio del día, la semana, el mes y el año

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

  • @StartOfDay, @StartOfWeek, @StartOfMonthy @StartOfYear: use estas macros con +/- n para compilar intervalos como "desde el inicio de la semana" o "últimos 3 meses".
  • La interfaz de usuario del portal web evalúa estas macros. Su comportamiento en escenarios no web puede diferir, por lo que la prueba en el cliente de destino.

Consultas de ejemplo:

Captura de pantalla de cláusulas del editor de consultas para buscar elementos cambiados en los últimos 10 días.

Captura de pantalla de cláusulas del editor de consultas para las características programadas para completarse en los próximos tres meses.

Campos de fecha

En la tabla siguiente se describen los campos relacionados con la fecha que puede usar para filtrar y consultar elementos de trabajo. Estos campos ayudan a realizar un seguimiento de la información de programación de los elementos de trabajo.

Nombre del campo Description Nombre de referencia Tipo de dato
Fecha límite Fecha de vencimiento prevista de un problema o elemento de trabajo que se va a resolver. (Proceso ágil) Microsoft.VSTS.Scheduling.DueDate DateTime
Fecha de finalización Fecha y hora en que la programación indica que se va a completar un elemento de trabajo. Microsoft.VSTS.Scheduling.FinishDate DateTime
Fecha de inicio Fecha y hora asignadas a un elemento de trabajo para que se inicie el trabajo. Microsoft.VSTS.Scheduling.StartDate DateTime
Fecha prevista Fecha de vencimiento prevista de un problema u otro elemento de trabajo para resolver o completar. Microsoft.VSTS.Scheduling.TargetDate DateTime

Nota

Use los campos Fecha de inicio y Fecha de destino con Planes de entrega para visualizar las escalas de tiempo del elemento de trabajo. Para más información, consulte Revisión de los planes de entrega de un equipo.

Cuándo usar WIQL directamente

Use WIQL cuando:

  • ** Necesita operadores avanzados como WAS EVER para los cambios en el camino de iteración.
  • Editor de Power Query bloquea o marca una cláusula como no admitida (por ejemplo, algunos usos de Was Ever). 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.

Utilizar IA para hacer consultas por fecha o iteración

Si configura el Azure DevOps servidor MCP, puede formular preguntas basadas en fecha e iteración en lenguaje natural en lugar de crear cláusulas de consulta manualmente.

Tarea Ejemplo de sugerencia
Buscar elementos creados recientemente Show all work items created in the last 7 days in project <Contoso>
Consulta por sprint actual List all active bugs in the current sprint for team <Contoso Team>
Buscar elementos obsoletos Show user stories that haven't been updated in the last 30 days in <Contoso>
Consulta de elementos resueltos por intervalo de fechas List bugs resolved between January 1 and January 31 in project <Contoso>
Resumen cerrado semanal Show the count of work items closed each day this week in <Contoso> broken down by type
Buscar elementos que se aproximan a la fecha límite List work items in <Contoso> with a target date within the next 5 days that are still active
Comprobación del burn-down del sprint Show how many story points remain incomplete vs total planned for the current sprint in <Contoso>
Añadidos al final del sprint List work items added to the current sprint in <Contoso> in the second half of the sprint
Comparación mes a mes Compare the number of bugs created this month vs last month in <Contoso>
Análisis del impacto de las vacaciones Show work items in <Contoso> that had no updates between December 23 and January 2

Nota

Si usa Visual Studio Code, el modo agent resulta especialmente útil para consultas complejas basadas en fechas.

Contenido relacionado

API de REST

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

  • Last updated on