Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Los campos Ruta de acceso de área e Ruta de acceso de iteración aparecen en todos los formularios de elementos de trabajo para cada tipo de elemento de trabajo. Estas rutas de acceso se definen para el proyecto (rutas de acceso de área y rutas de acceso de iteración) y, a continuación, se seleccionan las que desea asociar a un equipo.
Para entender cómo trabajar con caminos de área e iteración, ver Acerca de los equipos y herramientas ágiles.
Prerequisites
| Category | Requirements |
|---|---|
| Niveles de acceso | - Para ver y ejecutar consultas compartidas: Miembro del proyecto. - Para agregar y guardar una consulta compartida: Al menos acceso Básico . |
| Permissions | 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. |
Note
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.
| Category | Requirements |
|---|---|
| Niveles de acceso | - Para ver y ejecutar consultas compartidas: Miembro del proyecto. - Para agregar y guardar una consulta compartida: al menos acceso Básico. |
| Permissions | 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. |
Note
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 campos Ruta de acceso de área e 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 |
<> |
Filtrar una ruta de acceso de iteración o área específica |
In |
Filtrar por un conjunto de rutas de área o iteración |
Not In |
Excluir elementos asignados a un conjunto de rutas de acceso de área o iteración |
Under |
Especifica todas las rutas bajo un área seleccionada o un trayecto de iteración. |
Not Under |
Excluir elementos asignados en una ruta de acceso de iteración o área específica |
Puede usar las siguientes macros al seleccionar el campo Camino de Iteración. Para obtener ejemplos, consulte los ejemplos de consulta de esta página.
| Macro | Úselo cuando quiera... |
|---|---|
@CurrentIteration |
Especificar la iteración actual asociada al contexto del equipo seleccionado |
@CurrentIteration +/- n |
Filtrar elementos según su asignación en una ventana móvil de sprints asociados al contexto del equipo seleccionado |
@TeamAreas |
Filtrar elementos en función de las rutas de acceso de área asignadas a un equipo específico |
Note
El portal web de Azure DevOps evalúa macros como @CurrentIteration, @CurrentIteration +/- ny @TeamAreas (Servicios y servidor). Los clientes no web (Visual Studio/Team Explorer, Excel, Project) y las llamadas directas WIQL/REST requieren rutas de acceso explícitas de área o iteración, y no aceptan tokens de macro sin procesar. Al guardar una consulta en la interfaz de usuario web, el portal normalmente expande macros a valores concretos en el WIQL almacenado, compruebe este comportamiento en su entorno si necesita usar consultas fuera de la interfaz de usuario web.
Consultas de ruta de acceso al área
Puede filtrar los elementos de trabajo asignados a varias rutas de acceso de área mediante el operador In , como se muestra en el ejemplo siguiente.
Nombre del nodo y consultas basadas en palabras clave
Use el campo Nombre del nodo para filtrar los elementos de trabajo asignados a las rutas de acceso de área en función de una palabra clave mediante el operador Contains . 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 genera el mismo resultado que el ejemplo anterior.
En este ejemplo, el filtro devuelve elementos de trabajo asignados a una ruta de acceso de área cuyo último nodo contiene 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
Use la macro @TeamAreas para buscar elementos asignados a las rutas de acceso de área que usa un equipo específico. Especifique el operador =. El Editor de consultas le pide que escriba el nombre del equipo; seleccione el equipo en la lista sugerida.
Referencia del campo de clasificación
| Nombre del campo | Description | 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 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 datos=TreePath, tipo reportable=Dimension, atributo de índice=True.
Si define un nombre de ruta de acceso que supere los 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 siguientes campos no aparecen en los formularios de elementos de trabajo, pero Azure DevOps 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 defina para un proyecto. Puede usar estos campos para filtrar las consultas y crear los informes.
| Nombre del campo | Description | Nombre de referencia | Tipo de dato |
|---|---|---|---|
| Id. de área | Identificador único del área donde se asigna este elemento de trabajo. | System.AreaId | Integer |
| Identificador de iteración | Identificador único de la iteración donde se asigna este elemento de trabajo. | System.IterationId | Integer |
| 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 tienen índices. El nombre del nodo no lo hace. Para más información acerca de los atributos de campo, consulte Atributos y campos de los elementos de trabajo.
Contenido relacionado
- 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
REST API
Para interactuar mediante programación con las consultas, consulte uno de estos recursos sobre la API REST: