Consulta por área o camino de iteración
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
La ruta de acceso al área y la ruta de acceso de la iteración son dos campos que aparecen en el formulario de seguimiento del trabajo para todos los tipos de elementos de trabajo. Se definen para un proyecto (rutas de acceso al área y rutas de acceso a la iteración) y, a continuación, se seleccionan los que se quieren asociar a un equipo.
Para comprender mejor cómo trabajar con rutas de área e iteración, consulte Acerca de los equipos y herramientas de Agile.
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 parte interesada para un proyecto público tienen acceso total a las características de consultas, al igual que los usuarios con acceso Básico. Para obtener más información, consulte guía rápida de acceso para las partes interesadas.
| Categoría | Requisitos |
|---|---|
| Niveles de acceso | - Para ver y ejecutar consultas compartidas: Miembro del proyecto. - Para agregar y guardar una consulta compartida, al menos tiene 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:
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 al área y Ruta de acceso de iteración, puede usar los operadores siguientes:
| Operator | Úselo cuando quiera... |
|---|---|
= |
Especificar una ruta de acceso específica a un área o una iteración |
<> |
Filtre un área específica o una ruta de iteración. |
In |
Filtrar por un conjunto de rutas de acceso a un área o una iteración. |
Not In |
Excluir los elementos asignados a un conjunto de rutas de acceso a un área o una iteración. |
Under |
Especificar todas las rutas de acceso de una ruta de acceso a un área o una iteración seleccionada. |
Not Under |
Excluir los elementos asignados en un área específica o ruta de iteración. |
Junto con estos operadores, puede usar las siguientes macros al seleccionar la Ruta de Iteración. Para ejemplos, consulte Consulta por fecha o iteración actual.
| Macro | Úselo cuando quiera... |
|---|---|
@CurrentIteration |
Especificar la iteración actual asociada al contexto del equipo seleccionado. |
@CurrentIteration +/- n |
Filtrar los elementos en función de la asignación a una ventana deslizante de sprints asociada al contexto del equipo seleccionado. |
@TeamAreas |
Filtrar los elementos en función de las rutas de acceso al área asignadas a un equipo específico. |
Nota:
Las macros @CurrentIteration +/- n y @TeamAreas son compatibles con 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 al área
Puede especificar que se filtren los elementos de trabajo asignados a varias rutas de área mediante el operador In, como se muestra en el ejemplo siguiente.
Nombre del nodo y consultas basadas en palabras clave
Utilice el campo Nombre de nodo para filtrar los elementos de trabajo asignados a las rutas de área en función de una palabra clave mediante el operador Contiene. Nombre de nodo especifica el último nodo de una ruta de acceso al área, que corresponde al último nodo de la jerarquía del árbol.
La consulta siguiente produce el mismo resultado que el ejemplo anterior.
En este ejemplo, el filtro plasma los elementos de trabajo asignados a una ruta de acceso de área cuyo último nodo contenga la palabra "Azure".
Este es otro ejemplo que utiliza el nombre de nodo y el operador In.
Consultas de ruta de acceso al área del equipo
Usa la macro @TeamAreas para buscar rápidamente los elementos asignados a las rutas de área que un equipo específico tiene asignadas. Especifique el operador =. El editor de consultas solicita automáticamente que escriba el nombre del equipo. Puede agregarlo introduciendo el nombre del equipo y eligiendo el valor del equipo que aparece en los criterios del filtro de búsqueda.
Referencia del campo de clasificación
| Nombre del campo | Descripción | Nombre de referencia |
|---|---|---|
| Ruta de acceso a á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 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. | Ruta de Iteración del Sistema |
Para cada campo, ruta de datos=TreePath, tipo reportable=Dimension, atributo de índice=True.
Si define un nombre de ruta que tenga más de 256 caracteres, no puede especificarlo en Microsoft Project. Para evitar este problema, defina nombres de rutas de acceso que no tengan más de 10 caracteres y no anide los nodos en más de 14 niveles de profundidad.
No puede aplicar la mayoría de las reglas de campo a los campos de sistema, como System.AreaPath y System.IterationPath. Para obtener más información, consulte Reglas y evaluación de reglas.
Los campos siguientes no aparecen en los formularios de elemento de trabajo, pero se realiza un seguimiento de ellos para cada tipo de elemento de trabajo. Estos campos proporcionan un valor numérico para cada valor de clasificación que se define 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 al á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 es ninguno. El identificador de área y el identificador de iteración se indexan, el nombre de nodo, no. Para más información acerca de los atributos de campo, consulte Atributos y campos de los elementos de trabajo.
Artículos relacionados
- Referencia rápida de consultas.
- Definir rutas de área y asignarlas a un equipo
- Definición de rutas de iteración (sprint) y configuración de las iteraciones del equipo
- Establecimiento de permisos y acceso para el seguimiento del trabajo
API de REST
Para interactuar mediante programación con las consultas, consulte uno de estos recursos sobre la API REST: