Compartir a través de

Consulta por fecha o iteración actual

Servicios Azure DevOps | 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
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.

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.

Operadores admitidos y macros de fecha

Utilice los siguientes operadores y macros para los campos DateTime y Ruta de acceso 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: Screenshot que muestra la cláusula Query Editor para buscar elementos creados en los últimos 30 días.

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

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

  • Elementos cerrados dentro de un período de tiempo especificado: Screenshot que muestra la cláusula Query Editor 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 Query Editor 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 Query Editor 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 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 (Query Editor 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 CurrentIteration más y menos para una ventana deslizante de sprints.

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:

Screenshot que muestra las cláusulas del Editor de Consultas para buscar ítems modificados en los últimos 10 días.

Screenshot que muestra las cláusulas del Query Editor 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.
  • Query Editor 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 de agotamiento de sprints Show how many story points remain incomplete vs total planned for the current sprint in <Contoso>
Adiciones tardías 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