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 AI para ayudar con esta tarea más adelante en este artículo o consulte Habilitación de la asistencia de IA con el servidor MCP de Azure DevOps para empezar.

Requisitos previos

Categoría	Requisitos
Niveles de acceso	- Para ver y ejecutar consultas compartidas: Miembro del proyecto. - Para agregar y guardar una consulta compartida: al menos acceso Básico.
Permisos	Colaborar permisos establecidos en Permitir para la carpeta a la que desea añadir una consulta. De manera predeterminada, el grupo Colaboradores no tiene este permiso.

Nota

Los usuarios con acceso de Stakeholder para un proyecto público tienen acceso completo a las características de consulta, al igual que los usuarios con acceso de Básico. Para obtener más información, consulte Referencia rápida sobre el acceso de parte interesada.

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, 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 acceso de iteración abarca las macros de iteración y las restricciones del cliente en detalle. 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:

• 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 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 consultas del portal web):

Sugerencia

Si @CurrentIteration no devuelve resultados esperados, confirme la iteración seleccionada del equipo y los intervalos de fechas de iteración en 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:

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 de vencimiento	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.
• 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.

Utilizar IA para hacer consultas por fecha o iteración

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

Tarea	Ejemplo de sugerencia
Buscar elementos creados recientemente	copilot-prompt Show all work items created in the last 7 days in project <Contoso>
Consulta por sprint actual	copilot-prompt List all active bugs in the current sprint for team <Contoso Team>
Buscar elementos obsoletos	copilot-prompt Show user stories that haven't been updated in the last 30 days in <Contoso>
Consulta de elementos resueltos por intervalo de fechas	copilot-prompt List bugs resolved between January 1 and January 31 in project <Contoso>
Resumen cerrado semanal	copilot-prompt 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	copilot-prompt List work items in <Contoso> with a target date within the next 5 days that are still active
Comprobación de agotamiento de sprints	copilot-prompt Show how many story points remain incomplete vs total planned for the current sprint in <Contoso>
Adiciones de final de sprint	copilot-prompt List work items added to the current sprint in <Contoso> in the second half of the sprint
Comparación mes a mes	copilot-prompt Compare the number of bugs created this month vs last month in <Contoso>
Análisis del impacto de las vacaciones	copilot-prompt Show work items in <Contoso> that had no updates between December 23 and January 2

Nota

Si usa Visual Studio Code, el modo de agente es especialmente útil para consultas complejas basadas en fechas.

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