Consulta por área o ruta de acceso de iteración

  • Artículo
  • Tiempo de lectura: 5 minutos

Azure DevOps Services | Azure DevOps Server 2022: Azure DevOps Server 2019 | TFS 2018

La ruta de acceso del área y la ruta de acceso de iteración son dos campos que aparecen en el formulario de seguimiento de trabajo para todos los tipos de elementos de trabajo. Los define para un proyecto (rutas de acceso de área y rutas de acceso de iteración) y, a continuación, selecciona los que quieres asociar a un equipo.

Para comprender mejor cómo trabajar con rutas de acceso de área e iteración, consulte Acerca de los equipos y las herramientas de Agile.

Nota

Las macros siguientes solo se admiten desde el portal web: @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity y @TeamAreas. Las consultas que contienen estas macros no funcionarán cuando se abran en Visual Studio/Team Explorer, Microsoft Excel o Microsoft Project.

Operadores y macros admitidos

Al crear consultas y especificar los campos Ruta de acceso de área e Ruta de acceso de iteración, puede usar los operadores siguientes:

Operator Úsalo cuando quieras...
= Especificar una ruta de acceso específica de área o iteración
<> Filtre una ruta de acceso específica o de iteración.
In Filtre por un conjunto de rutas de acceso de área o iteración.
Not In Excluya los elementos asignados a un conjunto de rutas de acceso de área o iteración.
Under Especifique todas las rutas de acceso en un área de selección o ruta de acceso de iteración.
Not Under Excluya los elementos asignados en un área específica o ruta de acceso de iteración.

Junto con estos operadores, puede usar las macros siguientes al seleccionar la ruta de acceso de iteración. Para obtener ejemplos, consulte Consulta por fecha o iteración actual.

Macro Úsalo cuando quieras...
@CurrentIteration Especifique la iteración actual asociada al contexto del equipo seleccionado.
@CurrentIteration +/- n Filtre los elementos en función de la asignación a una ventana deslizante de sprints asociada al contexto de equipo seleccionado.
@TeamAreas Filtre los elementos en función de las rutas de acceso del área asignadas a un equipo específico.

Nota

Las @CurrentIteration +/- n macros y @TeamAreas se admiten para Azure DevOps Server 2019 y versiones posteriores. Estas macros solo se admiten desde el portal web. Las consultas que contienen estas macros no funcionarán cuando se abran en Visual Studio/Team Explorer, Microsoft Excel o Microsoft Project.

Consultas de ruta de acceso de área

Puede especificar que filtre los elementos de trabajo asignados a varias rutas de acceso de área mediante el operador In , como se muestra en el ejemplo siguiente.

Consulta en la ruta de acceso del área para varias áreas

Nombre del nodo y consultas basadas en palabras clave

Use el campo Nombre del nodo para filtrar por los elementos de trabajo asignados a las rutas de acceso de área en función de una palabra clave mediante el operador Contains . El nombre del nodo especifica el último nodo de una ruta de acceso de área, que corresponde al último nodo de la jerarquía de árbol.

La consulta siguiente produce el mismo resultado que el ejemplo anterior.

Consulta en nombre de nodo para varias áreas

En este ejemplo, el filtro devolverá los elementos de trabajo asignados a una ruta de acceso de área cuyo último nodo contiene la palabra "Azure".

Consulta de varios sprints

Este es otro ejemplo que usa el nombre del nodo y el operador In .

Consulta en nombre de nodo para varias áreas

Consultas de ruta de acceso del área de equipo

Use la macro @TeamAreas para buscar rápidamente los elementos asignados a las rutas de acceso de área asignadas a un equipo específico. Especifique el = operador . El Editor de Power Query solicita automáticamente que escriba el nombre del equipo. Puede agregarlo escribiendo el nombre del equipo y eligiendo el valor del equipo que aparece en los criterios de filtro de búsqueda.

Consulta en rutas de acceso de área asignadas a un equipo

Referencia de campo de clasificación

Nombre del campo Descripción Nombre de referencia
Ruta de acceso del área Agrupa los elementos de trabajo por característica del producto o áreas de equipo. El área debe ser un nodo válido en la jerarquía del proyecto. System.AreaPath
Ruta de acceso de la iteración Agrupa los elementos de trabajo por sprints con nombre o períodos de tiempo. La iteración debe ser un nodo válido en la jerarquía del proyecto. System.IterationPath

Para cada campo, data path=TreePath, reportable type=Dimension, index attribute=True.

Si define un nombre de ruta de acceso superior a 256 caracteres, no puede especificarlo en Microsoft Project. Para evitar este problema, defina los nombres de ruta de acceso de no más de 10 caracteres y no anida los nodos más de 14 niveles de profundidad.

No se pueden aplicar la mayoría de las reglas de campo a los campos del sistema, como los campos System.AreaPath y System.IterationPath. Para más información, consulte Reglas y evaluación de reglas.

Los campos siguientes no aparecen en los formularios de elementos de trabajo, pero se realiza un seguimiento de cada tipo de elemento de trabajo. Estos campos proporcionan un valor numérico para cada valor de clasificación definido para un proyecto. Puede usar estos campos para filtrar las consultas y crear los informes.

Nombre del campo Descripción Nombre de referencia Tipo de datos
Identificador de área Identificador único del área a la que está asignado este elemento de trabajo. System.AreaId Entero
Id. de iteración Identificador único de la iteración a la que está asignado este elemento de trabajo. System.IterationId Entero
Nombre del nodo Nombre del último nodo de una ruta de acceso de área. Por ejemplo, si la ruta de acceso es Project\A1\B2\C3, el nombre del nodo es C3. System.NodeName String

El tipo notificable predeterminado no es ninguno. El identificador de área y el identificador de iteración se indexan, no es el nombre del nodo. Para obtener más información sobre los atributos de campo, consulte Campos y atributos del elemento de trabajo.

API de REST

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