Consulta por fecha o iteración actual

Notas:

1. Las macros @StartOfDay, @StartOfWeek, @StartOfMonth, @StartOfYear se admiten para Azure DevOps Server 2019.1 y versiones posteriores, y solo cuando se ejecutan desde el portal web.
2. La @CurrentIteration macro es compatible con TFS 2015 y versiones posteriores, y solo cuando se ejecuta desde el portal web.
3. La macro @CurrentIteration +/- n se admite para Azure DevOps Server 2019 y versiones posteriores, y solo cuando se ejecuta desde el portal web.

Restricciones de cliente sobre el uso de las @CurrentIteration macros

Puede usar el @CurrentIteration en una consulta de los siguientes clientes:

• Portal web que se conecta a Azure Boards
• Portal web que se conecta a una versión local Azure DevOps 2015 o posterior
• Visual Studio 2015 o Team Explorer 2015 o versiones posteriores conectadas a Azure Boards o TFS 2015 o versiones posteriores.
• Mediante la API de REST

Puede usar la macro @CurrentIteration +/- n en una consulta en Azure Boards, Azure DevOps Server 2019 y versiones posteriores, y con una API REST que incluya el equipo como parámetro, por ejemplo, .

Se produce un error si abre una consulta que contiene la macro @CurrentIteration en versiones anteriores de Visual Studio o desde Excel o Project. Además, no puede usar la macro al copiar o clonar conjuntos de pruebas y casos de prueba,definir alertas o con api REST.

Consultas basadas en fechas

Puede filtrar los elementos de trabajo por la fecha en la que se cambiaron o para un período de tiempo concreto. Cuando se limita el ámbito de la consulta, puede ayudar al rendimiento devolviendo solo los resultados que se ajusten al intervalo de fechas que desea incluir. Si no está nuevo en la creación de consultas, consulte Uso del editor de consultas para enumerar y administrar consultas.

No todos los campos son válidos para todos los tipos de elementos de trabajo (WIT). Vaya a campos de fecha para el conjunto de campos que puede incluir en las consultas y a qué WIT se aplican.

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 que no se han cerrado (la fecha de cierre es null)

Elementos cuyo estado se actualizó en la última semana

Elementos cerrados durante el sprint actual (la @CurrentIteration macro hace referencia al sprint definido para el contexto del equipo actual)

Filtro para

Incluir estas cláusulas de consulta

---

Errores cerrados en las últimas dos semanas

---

Elementos modificados en los últimos 10 días

---

Características programadas para completarse en los próximos tres meses

---

No todos los campos son válidos para todos los tipos de elementos de trabajo. Vaya a campos de fecha para el conjunto de campos que puede incluir en las consultas y a qué tipos de elementos de trabajo se aplican. Escriba fechas en el patrón de fecha que estableció para su perfil personal. (Consulte Establecer preferencias personales para obtener más información).

Creación de consultas para la iteración actual del equipo

Si el equipo sigue los procesos de Scrum, programe que el trabajo se complete en sprints. Puede realizar un seguimiento del progreso de los requisitos, errores y otros trabajos que se completarán en el sprint actual mediante la macro @CurrentIteration datos.

Se encontrará cualquier elemento asignado a un sprint que corresponda a la ruta de acceso de iteración actual del equipo. Por ejemplo, si un equipo está en Sprint 5, la consulta devolverá los elementos asignados a Sprint 5. Más adelante, cuando el equipo trabaje en Sprint 6, la misma consulta devolverá los elementos asignados a Sprint 6.

Enumeración de elementos de trabajo que se han movido fuera de un sprint

Puede enumerar los elementos de trabajo definidos para un sprint, pero que posteriormente se han movido mediante una consulta con una cláusula que contiene el operador Was Ever para la ruta de iteración. Solo puede construir esta consulta mediante la sintaxis WIQL. Puede editar la sintaxis de WIQL en el Editor de consultas instalando la extensión de Marketplace del editor de Wiql.

Por ejemplo, las siguientes consultas de sintaxis para elementos de trabajo que cumplen los criterios siguientes:

1. Definido en el proyecto actual
2. El tipo de elemento de trabajo es igual a Caso de usuario o Error
3. Los elementos de trabajo se encuentran en la ruta de acceso del área del equipo web de fibra de Fabrikam
4. Los elementos de trabajo no están en estado Cerrado, Completado, Cortar o Resuelto
5. No está en la ruta de iteración actual del equipo de Fabrikam Fiber Web
6. Pero se asignaron a la ruta de iteración actual para el equipo de Fabrikam Fiber Web
7. Ahora se asignan a la iteración actual +1 para el equipo de Fabrikam Fiber Web
8. Y se cambiaron en los últimos 30 días (la longitud del sprint)

SELECT
    [System.Id],
    [System.WorkItemType],
    [System.AssignedTo],
    [System.Title],
    [System.State],
    [System.Tags],
    [System.IterationPath],
    [System.AreaPath]
FROM workitems
WHERE
    [System.TeamProject] = @project
    AND [System.WorkItemType] IN ('User Story', 'Bug')
    AND [System.AreaPath] UNDER 'FabrikamFiber\Web'
    AND NOT [System.State] IN ('Completed', 'Closed', 'Cut', 'Resolved')
    AND NOT [System.IterationPath] = @currentIteration('[FabrikamFiber]\Web <id:cdf5e823-1179-4503-9fb1-a45e2c1bc6d4>')
    AND (
        EVER (
            [System.IterationPath] = @currentIteration('[FabrikamFiber]\Web <id:cdf5e823-1179-4503-9fb1-a45e2c1bc6d4>')
        )
        AND [System.IterationPath] = @currentIteration('[FabrikamFiber]\Web <id:cdf5e823-1179-4503-9fb1-a45e2c1bc6d4>') + 1
        AND [System.ChangedDate] >= @today - 30
    )
ORDER BY [System.Id]

La vista Del Editor de consultas de la sintaxis aparece como se muestra.

Enumeración de los elementos de trabajo agregados a un sprint después de la fecha de inicio

Para enumerar los elementos de trabajo recién creados agregados a un sprint después de su fecha de inicio, puede usar una consulta similar a la que se muestra en la imagen siguiente. Esta consulta funciona mediante el filtrado de elementos de trabajo asignados al sprint actual, pero se crearon después del inicio de la fecha de sprint. En este ejemplo, el filtrado se logra con la cláusula creada Date = @Today - 28.

Para obtener otras opciones para consultar los cambios en el ámbito de sprint, vea Acerca de sprints, Scrumy administración de proyectos, Cambio de ámbito de sprint.

Campos Ruta de acceso de fecha e iteración

Puede usar campos de fecha para filtrar las consultas. Algunos de estos campos se rellenan con información a medida que un elemento de trabajo progresa de un estado a otro. Algunos de estos campos no aparecen en el formulario de elemento de trabajo, pero se realiza un seguimiento de esos WIT enumerados en la tabla siguiente.

Notas:

1. Vea también Consultar por asignación o cambios de flujo de trabajo, Fecha e Identidad campos.

2. Para que estos campos se definan para un WIT, deben incluirse en la WORKFLOW sección de la definición de WIT. Por ejemplo, esta sintaxis se incluye dentro de la FIELDS definición al realizar la transición a un estado Resuelto:

    <FIELD refname="Microsoft.VSTS.Common.ResolvedDate" />  
       <SERVERDEFAULT from="clock"  />  
    </FIELD >  
   

3. Los campos Fecha de inicio y Fecha de finalización se calculan si crea un plan de proyecto en Microsoft Project y, a continuación, sincroniza ese plan con las tareas almacenadas en Azure Boards. Es posible que estos campos no aparezcan en el formulario de elemento de trabajo, pero se calculan para los elementos de trabajo pendiente y las tareas vinculadas a los elementos de trabajo pendiente. Puede ver sus valores de solo lectura en los resultados de una consulta o desde Microsoft Excel.

   Importante

   Microsoft Project integración y el comando TFSFieldMapping no se admiten para:

   • Visual Studio 2019 y Azure DevOps Office® Integration 2019
   • Azure DevOps Server 2019 y versiones posteriores, incluidos Azure DevOps Services.

   Sin embargo, se mantiene la compatibilidad completa Microsoft Excel integración y admite la importación y actualización masivas de elementos de trabajo. Entre las alternativas al Microsoft Project se incluyen las siguientes:

   • Planes de entrega
   • Una extensión de Marketplace, como Project Conectar gráfico GANTT.

Artículos relacionados

Para consultar elementos basados en el texto especificado en el campo Historial, vea Historial y auditoría.

• Consulta por cambios de asignación o flujo de trabajo
• Referencia rápida de KQL
• Definición de rutas de iteración (sprint) y configuración de iteraciones de equipo
• Creación de consultas administradas con el editor de consultas
• Macros de operadores de consulta
• Índice de campo de elemento de trabajo
• Permisos de consulta

Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013

Las macros @Today y @CurrentIteration son útiles para enumerar elementos de trabajo basados en fechas relativas o en su asignación a la iteración actual de un equipo. Para enumerar los elementos de trabajo en función del momento en que se crearon, cerraron, resolvieron o cambiaron el estado, use @Today especificar fechas. Para las consultas que enumen los elementos de trabajo en función de su asignación al sprint actual de un equipo,use @CurrentIteration .

Por ejemplo, puede encontrar elementos de trabajo que se modificaron en los últimos tres días con la consulta siguiente.

Operadores y macros admitidos

Las cláusulas de consulta que especifican un campo DateTime o la ruta de acceso de iteración pueden usar los operadores y macros enumerados en la tabla siguiente.