Consulta por área o ruta de acceso de iteración
Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013
La ruta de acceso de á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. Las define para un proyecto (rutas deacceso de área y rutas de iteración) y, a continuación, selecciona las que desea 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, @RecentProjectActivityy @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 y Ruta de iteración, puede usar los operadores siguientes:
| Operador | Use cuando desee... |
|---|---|
| = | Especificar un área específica o ruta de acceso de iteración |
| <> | Filtre una ruta de acceso de área o iteración específica. |
| In | Filtre por un conjunto de rutas de acceso de área o iteración. |
| No en el | Excluir elementos asignados a un conjunto de rutas de acceso de área o iteración. |
| Bajo | Especifique todas las rutas de acceso en un área de selección o ruta de iteración. |
| No pertenece a | Excluya los elementos asignados en una ruta de acceso de iteración o área específica. |
Junto con estos operadores, puede usar las macros siguientes al seleccionar la ruta de iteración. Para obtener ejemplos, vea Consulta por fecha o iteración actual.
| Macro | Use cuando desee... |
|---|---|
| @CurrentIteration | Especifique la iteración actual asociada al contexto de equipo seleccionado. |
| @CurrentIteration +/- n | Filtrar elementos en función de la asignación a una ventana deslizante de sprints asociados al contexto de equipo seleccionado. |
| @TeamAreas | Filtrar elementos en función de las rutas de acceso de área asignadas a un equipo específico. |
Nota:
La @CurrentIteration macro es compatible con TFS 2015 y versiones posteriores. Las @CurrentIteration +/- ny @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 se filtre por los elementos de trabajo asignados a varias rutas de acceso de área mediante el operador In, como se muestra en el ejemplo siguiente.
Nombre de nodo y consultas basadas en palabras clave
Use el campo Nombre de nodo para filtrar por elementos de trabajo asignados a 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.
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".
Este es otro ejemplo que usa el nombre del nodo y el operador In.
Consultas de ruta de acceso de á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 consultas le pide automáticamente que escriba el nombre del equipo. Puede agregarlo escribiendo el nombre del equipo y eligiendo el valor de equipo que aparece en los criterios de filtro de búsqueda.
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, ruta de acceso de datos= TreePath , tipo informable= Dimension , atributo de índice= True .
Si define un nombre de ruta de acceso de más de 256 caracteres, no puede especificarlo en Microsoft Project. Para evitar este problema, defina nombres de ruta de acceso de no más de 10 caracteres y no anida nodos de 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 Rules and rule evaluation (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 de informe predeterminado no es ninguno. El identificador de área y el identificador de iteración están indexados, el nombre del nodo no. Para obtener más información sobre los atributos de campo, vea Campos y atributos de elementos de trabajo.
Artículos relacionados
- Referencia rápida de KQL
- Definición de rutas de acceso de área y asignación a un equipo
- Definición de rutas de iteración (sprint) y configuración de iteraciones de equipo
- Establecer permisos y acceso para el seguimiento del trabajo
API de REST
Para interactuar mediante programación con las consultas, consulte uno de estos recursos de api REST:
Recursos del SDK
Para interactuar mediante programación con consultas, vea Consulta de errores, tareas y otros elementos de trabajo.