Definición de rutas de acceso de área y asignación a un equipo

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Agregue rutas de área para organizar equipos y agrupar elementos de trabajo por producto, característica o área de negocio. La asignación de rutas de acceso de área a los equipos garantiza que los elementos de trabajo de esas rutas aparezcan en los trabajos pendientes y los paneles del equipo correspondientes. De forma predeterminada, todos los elementos de trabajo se asignan a la ruta de área raíz y aparecen en el equipo predeterminado del proyecto.

Después de definir las rutas de área en el nivel del proyecto, asígnelas a los equipos dentro de la configuración del equipo. También puede crear una estructura jerárquica de rutas de de áreas para admitir subáreas, con hasta 14 niveles de profundidad.

Para realizar las siguientes tareas, debe definir rutas de acceso al área:

Sugerencia

Puede definir la estructura de la ruta de acceso al área y asignar rutas de acceso al área a los equipos. También puede agregar un equipo y crear la ruta de acceso del área con el nombre del equipo al mismo tiempo. Si los equipos son totalmente independientes, cree un conjunto plano de rutas de acceso al área. Para crear una jerarquía de equipos, establezca una estructura jerárquica en árbol de rutas de área. Para obtener más información, consulte Configuración de una jerarquía de equipos.

Para usar las siguientes herramientas, los equipos deben suscribirse a rutas de acceso al área:

Para comprender cómo utiliza el sistema las rutas de área, consulte Acerca de las rutas de área y de iteración.

Requisitos previos

Categoría	Requisitos
Permisos	- Para establecer rutas de área de equipo o de iteración: Administrador de equipo o un miembro del grupo Administradores de Proyecto . De forma predeterminada, el usuario que ha creado el proyecto tiene estos permisos. - Para agregar una ruta de acceso de área bajo el nodo raíz, o editar o eliminar cualquier nodo secundario: miembro del grupo de Administradores del proyecto. - Para agregar, editar y administrar rutas de acceso de área en un nodo: uno o varios de los siguientes permisos establecidos en Permitir: - Crear nodos secundarios - Eliminar este nodo - Editar este nodo - Ver permisos en este nodo

Categoría

Requisitos

Permisos

- Para establecer rutas de área de equipo o de iteración: Administrador de equipo o un miembro del grupo Administradores de Proyecto . De forma predeterminada, el usuario que ha creado el proyecto tiene estos permisos.
- Para agregar una ruta de acceso de área bajo el nodo raíz, o editar o eliminar cualquier nodo secundario: miembro del grupo de Administradores del proyecto.
- Para agregar, editar y administrar rutas de acceso de área en un nodo: uno o varios de los siguientes permisos establecidos en Permitir:
- Crear nodos secundarios
- Eliminar este nodo
- Editar este nodo
- Ver permisos en este nodo

Para más información, consulte Establecimiento de permisos y acceso para el seguimiento del trabajo.

Para conocer las restricciones de nomenclatura en las rutas de acceso de área, consulte Acerca de las áreas y las iteraciones, restricciones de nomenclatura.

Primeros pasos

Cada equipo tiene acceso a varias herramientas Agile, como se describe en Acerca de los equipos y las herramientas Agile. Estas herramientas hacen referencia a las rutas de acceso de área predeterminadas del equipo. La mayoría de los equipos usan una ruta de acceso de área y varias rutas de iteración para el seguimiento del trabajo, pero los equipos también pueden usar varias rutas de acceso de área en sus trabajos pendientes y paneles para admitir diferentes escenarios.

Los nuevos proyectos incluyen un área raíz única correspondiente al nombre del proyecto y un equipo predeterminado con el mismo nombre asignado a esta ruta de área raíz.

Si no está familiarizado con la administración de proyectos y equipos, siga estos pasos para configurarlos:

Definir rutas de área: determine el número y los nombres de las rutas de área necesarias para categorizar su trabajo. Agregue al menos una ruta de acceso de área por equipo. Para obtener más información, consulte Acerca de las áreas y las iteraciones.
Definir equipos: Decida el número y los nombres de los equipos necesarios. Para obtener más información, consulte Acerca de los equipos y las herramientas de Agile.
Configurar rutas de área: vaya a Configuración del proyecto>Configuración del proyecto>Áreas y definas las rutas de área del proyecto. Siga los pasos descritos en Añadir rutas de área.
Crear equipos: Cree los equipos necesarios basándose en el paso 2. Para obtener más información, consulte Añadir un equipo, pasar de un equipo predeterminado a varios equipos.
Asignar rutas de área a equipos: en la configuración del equipo, asigne las rutas de área predeterminadas y otras rutas de área a cada equipo. Siga los pasos que se indican en Establecer rutas de área predeterminadas para el equipo.
Asignar rutas de área a elementos de trabajo: asigne elementos de trabajo a las rutas de área definidas mediante la modificación masiva para actualizar varios elementos a la vez.

Nota

La asignación de la misma ruta de acceso de área a varios equipos puede provocar conflictos sobre la propiedad del elemento de trabajo y puede provocar un comportamiento inesperado en los paneles de equipo. Para obtener más información, consulte Limitaciones de las vistas del panel para varios equipos.

Según sea necesario, puede realizar las siguientes acciones en cualquier momento:

Añadir otros nodos secundarios
Cambiar el nombre de una ruta de acceso de área (excepto la ruta de acceso del área raíz)
Mover un nodo secundario debajo de otro nodo
Eliminación de un nodo secundario
Cambiar el nombre de un equipo
Cambiar las asignaciones de ruta de área realizadas a un equipo

Enumerar áreas de proyecto

Para enumerar las áreas de proyecto, siga estos pasos:

Navegador
CLI de Azure DevOps

En el portal web, seleccione (1) Configuración del proyecto> (2) Configuración del proyecto> (3) Áreas.

La captura de pantalla muestra las selecciones, la configuración del proyecto y la configuración del proyecto.

Puede enumerar las rutas de acceso de área definidas para un proyecto mediante el comando az boards area project list . Para empezar a trabajar con la CLI, consulte Introducción a la CLI de Azure DevOps.

az boards area project list [--depth]
                            [--path]
                            [--project]

Parámetros

profundidad: opcional. Profundidad de los nodos secundarios que se van a enumerar. Ejemplo: --depth 3. Cuando no está especificado, solo se devuelven las rutas principales de acceso al área.
ruta: Optional. Ruta absoluta de un área. \Area\ debe incluirse después de \ProjectName, que distingue esta ruta de una ruta de iteración. Por ejemplo, --path \ProjectName\Area\AreaName. Si se usan espacios dentro de un nodo, escriba entre comillas dobles, por ejemplo, --path "\Fabrikam Fiber\Area\Service Delivery\Performance". Si no se especifica, muestra las rutas de área desde el nivel raíz.
proyecto: Opcional. Nombre o id. del proyecto. Ejemplo: --project "Fabrikam Fiber".

Ejemplo

Por ejemplo, el siguiente comando enumera las rutas de acceso de área a una profundidad de 3 para el proyecto Fabrikam Fiber. Para ver otras opciones de formato de salida, consulte Formatos de salida para comandos de la CLI de Azure.

az boards area project list --depth 3 --project 'Fabrikam Fiber' --output table
ID     Identifier                            Name                Path                                                Has Children
-----  ------------------------------------  ------------------  --------------------------------------------------  --------------
55302  91d8644a-e430-4fd0-aa95-742ea98770a3  Fabrikam Fiber      \Fabrikam Fiber\Area                                True
55373  26be05fd-e68a-4fcb-833f-497f6bee45f2  Service Delivery    \Fabrikam Fiber\Area\Service Delivery               True
55303  637dc203-0549-4415-9663-b6358ac27d21  Internet            \Fabrikam Fiber\Area\Service Delivery\Internet      False
55306  3f2067f9-684f-4121-8004-4a4745198b39  Voice               \Fabrikam Fiber\Area\Service Delivery\Voice         False
55372  4afc9ede-db1d-4703-8be6-95899b99be44  Email               \Fabrikam Fiber\Area\Service Delivery\Email         False
55381  f96d4738-c67e-42d0-bd4e-99f6b3fdeb22  Service Status      \Fabrikam Fiber\Area\Service Delivery\Service S...  False
55384  3a0c1189-6454-4ccd-9354-d72b653b7f74  TV                  \Fabrikam Fiber\Area\Service Delivery\TV            False
55380  4ea27e90-248c-41a0-8d11-eace6c9fd90e  Account Management  \Fabrikam Fiber\Area\Account Management             True
55382  4235f40d-753b-49dd-868f-82372065ec83  Shopping Cart       \Fabrikam Fiber\Area\Account Management\Shoppin...  False
55383  49d34650-6c65-446c-aff6-79edd3a21a75  Customer Profile    \Fabrikam Fiber\Area\Account Management\Custome...  False

Los comandos de la CLI de Azure DevOps no son compatibles con Azure DevOps Server.

Agregar una ruta de acceso de área

Solo se define un área raíz de forma predeterminada. Agregue rutas de acceso de área nuevas y secundarias en la ruta de acceso del área raíz para el proyecto, o como elemento secundario a otra ruta de acceso o equipo de área. Las nuevas rutas de área se añaden al nodo raíz de forma predeterminada.

La captura de pantalla muestra las áreas y los valores predeterminados definidos para el proyecto.

También puede agregar rutas de acceso de área nuevas y secundarias a un equipo. Para obtener más información, consulte Establecer rutas de área del equipo.

Navegador
CLI de Azure DevOps

Para añadir una nueva ruta de área, siga estos pasos:

Resalte la ruta de acceso del área y elija Nuevo subelemento. Como alternativa, puede seleccionar una ruta de acceso de área y elegir Nuevo o seleccionar el elemento de menú Nuevo en la parte superior de la lista de áreas.
Escriba un nombre (de 255 caracteres como máximo) para el nodo. Para obtener más restricciones de nombres, consulte Acerca de las áreas y las iteraciones, Restricciones de nombres.
Seleccione Guardar y cerrar.

Todas las áreas nuevas se agregan como un nodo secundario a la ruta de área raíz.

Para agregar una ruta de área secundaria, realice estos pasos:

Resalte la ruta de acceso del área y elija Nuevo subelemento. Como alternativa, puede seleccionar la ruta del área y elegir Nuevo elemento secundario o seleccionar Nuevo elemento secundario en el menú ubicado en la parte superior de la lista de áreas.
Escriba un nombre (de 255 caracteres como máximo) para el nodo. Para obtener más restricciones de nombres, consulte Acerca de las áreas y las iteraciones, Restricciones de nombres.
Seleccione Guardar y cerrar.

También puede añadir rutas de área a un equipo en la página Configuración del equipo>Zonas página.

Puede agregar rutas de acceso de área a un proyecto mediante az boards area project create. Para empezar, consulte Introducción a la CLI de Azure DevOps.

Si especifica el --path parámetro, la nueva ruta de acceso de área se agrega como un subnodo a la ruta de acceso especificada. Si no especifica el parámetro --path, la nueva ruta del área se agrega como un nodo secundario al nodo raíz.

az boards area project create --name
                              [--path]
                              [--project]

Parámetros

name: Necesario. Nombre de la ruta de acceso del área.
ruta: Optional. Ruta absoluta de un área. Ejemplo: --path \ProjectName\Area\AreaName. Si no se especifica, se agrega un área en el nivel raíz.
proyecto: Opcional. Nombre o id. del proyecto. Ejemplo: --project "Fabrikam Fiber".

Ejemplo: formato JSON

Por ejemplo, el siguiente comando agrega la ruta del área Voz al proyecto Fabrikam Fiber en el nodo raíz.

az boards area project create --name Voice --project "Fabrikam Fiber"
{
  "attributes": null,
  "children": null,
  "hasChildren": false,
  "id": 55412,
  "identifier": "b00f86a2-3d49-4ad2-af01-da2537947baa",
  "name": "Voice",
  "path": "\\Fabrikam Fiber\\Area\\Voice",
  "structureType": "area",
  "url": "https://dev.azure.com/fabrikam/56af920d-393b-4236-9a07-24439ccaa85c/_apis/wit/classificationNodes/Areas/Voice"
}

Ejemplo: formato de tabla

Y aquí está el mismo comando con el formato de salida de tabla.

az boards area project create --name Voice --project "Fabrikam Fiber" --output table
ID     Identifier                            Name    Path                         Has Children
-----  ------------------------------------  ------  ---------------------------  --------------
55413  3c16691b-160c-4498-ab42-aa77b7f354fc  Voice  \Fabrikam Fiber\Area\Voice  False

Los comandos de la CLI de Azure DevOps no son compatibles con Azure DevOps Server.

Enumerar las rutas de acceso del área de equipo

Los valores predeterminados del equipo se configuran desde la configuración del equipo. Si no es administrador del equipo, se agrega como uno. Solo los administradores de equipo o proyecto pueden cambiar la configuración del equipo.

Navegador
CLI de Azure DevOps

Abra su proyecto y seleccione Configuración del proyecto>Configuración del equipo>Áreas.
Si necesita cambiar el contexto del equipo, use el selector de equipos dentro de las rutas de navegación.

Puede enumerar las rutas de acceso de área definidas para un equipo mediante az boards area team list. Para empezar, consulte Introducción a la CLI de Azure DevOps.

az boards area team list --team
                         [--project]

Parámetros

equipo: Requerido. Nombre o identificador del equipo.
proyecto: Opcional. Nombre o id. del proyecto. Ejemplo: --project "Fabrikam Fiber".

Por ejemplo, el siguiente comando muestra las rutas de acceso de área para el equipo de entrega de servicios. Para ver otras opciones de formato de salida, consulte Formatos de salida para comandos de la CLI de Azure.

az boards area team list --team "Service Delivery" --project "Fabrikam Fiber" --output table
Area                             Include sub areas    Is Default
-------------------------------  -------------------  ------------
Fabrikam Fiber\Service Delivery  True                 True

Los comandos de la CLI de Azure DevOps no son compatibles con Azure DevOps Server.

Abra la configuración del equipo desde el perfil del equipo.

Las áreas y las iteraciones se definen desde Configuración del proyecto > Configuración del equipo. Puede navegar rápidamente a él desde un trabajo pendiente de seguimiento del trabajo en equipo, un panel o un panel.

Abra una lista de tareas pendientes o un tablero para un equipo y seleccione Perfil del equipo>Configuración del equipo.

Aquí abremos la Junta para el equipo de Fabrikam Fiber y desde allí el perfil del equipo.
Elija Iteraciones y áreas.
Si necesita cambiar el contexto del equipo, use el selector de equipos dentro de las rutas de navegación.

Establecimiento de rutas de acceso de área de equipo

Todos los elementos de trabajo asignados a una ruta de acceso del área de equipo aparecen en los trabajos pendientes y paneles de ese equipo. Si necesita cambiar el contexto del equipo, utilice el selector de equipos dentro de la ruta de navegación. Elija incluir rutas de acceso de subárea cuando desee admitir vistas resumidas de trabajo en varios equipos o áreas.

Nota

A los equipos se les puede asignar un máximo de 300 rutas de acceso de área para una organización y un rendimiento de trabajo eficientes. Para obtener más información sobre los límites, consulte Seguimiento de trabajos , procesos y límites de proyecto.

La ruta predeterminada del área determina la ruta de acceso asignada a los elementos de trabajo creados desde el contexto del equipo.

Importante

Los elementos de trabajo que aparecen en el tablero de más de un equipo pueden generar resultados de consulta inesperados. Dado que cada equipo puede personalizar sus columnas de tablero y calles, los valores de los elementos de trabajo pueden variar en diferentes paneles de equipo. Para evitar este problema, mantenga la propiedad única de los elementos de trabajo asignandolos a rutas de acceso de área de equipo específicas.

Navegador
CLI de Azure DevOps

Puede seleccionar rutas de área existentes o crear nuevas rutas de área o rutas secundarias en la configuración del equipo.

Seleccione Configuración del proyecto>Configuración del equipo>Áreas.
Seleccione el equipo que desea configurar en la lista desplegable situada en la parte superior de la página.

Aquí mostramos las áreas del equipo Fabrikam Fiber.
Elija una o varias rutas de acceso de área para que estén activas para el equipo.

En este caso, elegimos activar las rutas de subárea para el proyecto. El equipo directivo ahora puede realizar un seguimiento del progreso de todos los equipos.
Cuando termine, actualice la página del backlog del producto para el equipo, y vea los elementos de trabajo que se han asignado al equipo. Agregue la ruta de área a las columnas que se muestran para ver las tareas asignadas a los elementos de trabajo.

Puede establecer la ruta de área predeterminada para un equipo o añadir una ruta de área mediante az boards area team add. Para empezar, consulte Introducción a la CLI de Azure DevOps.

az boards area team add --path  --team
                        [--include-sub-areas {false, true}]
                        [--project]
                        [--set-as-default]

Parámetros

ruta: Obligatorio. Ruta absoluta de un área. Ejemplo: --path \ProjectName\AreaName.
equipo: Requerido. Nombre o identificador del equipo.
include-sub-areas: Opcional. Incluya nodos secundarios de la ruta de acceso del área. Valores aceptados: false, true.
proyecto: Opcional. Nombre o id. del proyecto. Ejemplo: --project "Fabrikam Fiber".
set-as-default: opcional. Especifique la ruta de área predeterminada para el equipo. Valor predeterminado: False.

Ejemplo

Por ejemplo, el siguiente comando agrega la ruta de acceso del área voz al equipo de voz del proyecto Fabrikam Fiber, lo establece como valor predeterminado e incluye subáreas.

az boards area team add --path "\Fabrikam Fiber\Voice" --team Voice --project "Fabrikam Fiber" --include-sub-areas --set-as-default --include-sub-areas true --output table
Area                                   Include sub areas    Is Default
-------------------------------------  -------------------  ------------
Fabrikam Fiber\Service Delivery\Voice  False                False
Fabrikam Fiber\Voice                   True                 True

Los comandos de la CLI de Azure DevOps no son compatibles con Azure DevOps Server.

Cambiar el nombre o mover una ruta de área

El sistema actualiza automáticamente los elementos de trabajo y las consultas que hacen referencia a la ruta de área actualizada. Cada Ruta de área está asociada a un GUID único.

Navegador
CLI de Azure DevOps

Para cambiar el nombre de una Ruta de área, abra la página del portal web Configuración del proyecto>Configuración del proyecto>Áreas.
Seleccione el menú contextual del nodo y seleccione Editar.
En el cuadro de diálogo que se abre, escriba el nuevo nombre.
Para mover el nodo dentro de la jerarquía, cambie el campo Ubicación.

Nota

Cuando renombra o cambia el campo Ubicación de un nodo, el sistema actualiza automáticamente los elementos de trabajo existentes que hacen referencia a la Ruta de área.

Cambiar el nombre o mover una ruta de área de un proyecto

Puede cambiar el nombre o mover una ruta de acceso de área para un proyecto, mediante el comando az boards area project update. Para empezar, consulte Introducción a la CLI de Azure DevOps.

az boards area project update --path
                              [--child-id]
                              [--name]
                              [--project]

ruta: Obligatorio. Ruta absoluta de un área. Ejemplo: --path \ProjectName\AreaName.
child-id: Opcional. Mueve una ruta de acceso de área existente y la agrega como un nodo secundario para el nombre o el identificador de ruta de acceso especificados.
name: opcional. Especifica el nuevo nombre de la ruta de área.
proyecto: Opcional. Nombre o id. del proyecto. Ejemplo: --project "Fabrikam Fiber".

Ejemplo

Por ejemplo, el siguiente comando cambia el nombre de la ruta de área Voz a Voz y Web para el proyecto Fabrikam Fiber.

az boards area project update --path "\Fabrikam Fiber\Area\Voice" --name "Voice and Web" --project "Fabrikam Fiber" --output table
ID     Identifier                            Name           Path                                Has Children
-----  ------------------------------------  -------------  ----------------------------------  --------------
55412  b00f86a2-3d49-4ad2-af01-da2537947baa  Voice and Web  \Fabrikam Fiber\Area\Voice and Web  False

Eliminar una ruta de área de un equipo

Para quitar una ruta de acceso de área de un equipo, use az boards area team remove.

az boards area team remove --path
                           --team
                           [--project]

Parámetros

ruta: Obligatorio. Ruta absoluta de un área. Ejemplo: --path \ProjectName\AreaName.
equipo: Requerido. Nombre o identificador del equipo.
proyecto: Opcional. Nombre o id. del proyecto. Ejemplo: --project "Fabrikam Fiber".

Ejemplo

Por ejemplo, el siguiente comando quita la ruta de área \Service Delivery\Voice del Equipo de Voz del proyecto Fabrikam Fiber.

az boards area team remove --path "\Fabrikam Fiber\Service Delivery\Voice" --team Voice --project "Fabrikam Fiber" --output table

Los comandos de la CLI de Azure DevOps no son compatibles con Azure DevOps Server.

Eliminar una ruta de acceso de área

Cuando elimina una Ruta de área, debe proporcionar una Ruta de área para actualizar los elementos de trabajo asignados a la Ruta de área que desea eliminar.

Importante

Al eliminar valores de ruta de área o volver a configurar los valores de ruta de iteración, se produce una pérdida de datos irreversible en los gráficos siguientes:

Gráficos de widget de burndown y burn up
Gráficos de agotamiento de sprints
Gráficos de velocidad para equipos con rutas de áreas de trabajo modificadas
Gráficos de tendencias históricos que hacen referencia a los valores de Ruta de acceso de área e Ruta de acceso de iteración tal como se define en el momento de cada elemento de trabajo

Puede eliminar rutas de área e iteración solo cuando ya no sean utilizadas por ningún elemento de trabajo. Al eliminar estas rutas de acceso, ya no puede recuperar sus datos históricos.

Para eliminar una Ruta de área, abra la página del portal web Configuración del proyecto>Configuración del proyecto>Áreas.
Elija el menú contextual del nodo y seleccione Eliminar o Quitar.
En el cuadro de diálogo que se abre, seleccione la Ruta de área a la que desea reasignar los elementos de trabajo y, a continuación, seleccione Eliminar ruta.

Gráfico de progreso por área

Puede generar rápidamente consultas para ver el progreso en función de una ruta de acceso de área. Por ejemplo, visualice el progreso de los elementos de trabajo asignados a la ruta de área de cada equipo, como se muestra en el siguiente gráfico de barras apiladas. Seleccione Nombre del nodo para obtener el nodo hoja de la ruta del área.

La captura de pantalla muestra un gráfico de barras apiladas por área y estado.

Pasos siguientes

Establecer rutas de acceso de iteración o sprints

Como puede ver, las rutas de acceso de área desempeñan un papel importante en el soporte de herramientas ágiles, equipos ágiles y la gestión de elementos de trabajo. Obtenga más información sobre cómo trabajar con estos campos en los siguientes artículos:

Recursos mediante programación

Las rutas de acceso de área y las rutas de acceso de iteración también se conocen como nodos de clasificación.

Usar el área az boards (Azure DevOps CLI).
Utilizar los equipos (API REST) para administrar las configuraciones de los equipos.
Utilizar los nodos de clasificación (API REST) para organizar las clasificaciones de los elementos de trabajo.

Utilizar los equipos (API REST) para administrar las configuraciones de los equipos.
Utilizar los nodos de clasificación (API REST) para organizar las clasificaciones de los elementos de trabajo.
Configurar el proceso definiendo el complemento de clasificación (plantilla de proceso).

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2025-12-22

Compartir a través de

Definición de rutas de acceso de área y asignación a un equipo

Requisitos previos

Primeros pasos

Enumerar áreas de proyecto

Agregar una ruta de acceso de área

Enumerar las rutas de acceso del área de equipo

Abra la configuración del equipo desde el perfil del equipo.

Establecimiento de rutas de acceso de área de equipo

Cambiar el nombre o mover una ruta de área

Eliminar una ruta de acceso de área

Gráfico de progreso por área

Pasos siguientes

Contenido relacionado

Recursos mediante programación

Comentarios

Recursos adicionales