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

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

Agregue rutas de acceso de área para organizar equipos y agrupar elementos de trabajo por producto, característica o áreas 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 acceso del área raíz y aparecen en el equipo predeterminado del proyecto.

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

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

• Consulta y elementos de trabajo de gráficos basados en una ruta de acceso al área
• Asignación de trabajo a más de un equipo
• Colaboración con equipos de administración y de características
• Filtrado de un trabajo pendiente, una consulta, un panel o un plan mediante 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. O bien, puede agregar un equipo y crear la ruta de acceso al área con el nombre del equipo en ese momento. Si los equipos son totalmente independientes, cree un conjunto plano de rutas de acceso al área. Sin embargo, si desea crear una jerarquía de equipos, debería crear una jerarquía de árbol de rutas de acceso al á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:

• Paneles> todas las herramientas
• Trabajos pendientes> todas las herramientas
• Sprints> todas las herramientas
• Planes de entrega
• Paquete acumulativo
• Análisis> todos

Para comprender cómo usa el sistema las rutas de acceso de área, consulte Acerca de las rutas de acceso de área e iteración.

Requisitos previos

Permisos:

• Para establecer rutas de acceso de área de equipo, sea un administrador de equipo o miembro del grupo Administradores de proyectos. De forma predeterminada, el usuario que creó el proyecto tiene estos permisos.
• Para agregar una ruta de acceso de área en el nodo raíz o editar o eliminar cualquier nodo secundario, sea miembro del grupo Administradores de proyectos.
• Para agregar, editar y administrar rutas de acceso de área en un nodo, tenga uno o varios de los permisos siguientes establecidos en Permitir:
  • Crear nodos secundarios
  • Eliminar este nodo
  • Editar este nodo
  • Ver permisos de 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.

Introducción

Cada equipo tiene acceso a varias herramientas ágiles, como se describe en Acerca de los equipos y las herramientas de 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 único área raíz correspondiente al nombre del proyecto y un equipo predeterminado con el mismo nombre asignado a esta ruta de acceso del área raíz.

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

1. Definir rutas de acceso de área: determine el número y los nombres de las rutas de acceso de área necesarias para clasificar el trabajo. Agregue al menos una ruta de acceso de área por equipo. Para obtener más información, vea Acerca de las áreas e iteraciones.
2. 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.
3. Configurar rutas de acceso de área: vaya a Configuración del>proyecto Áreas de configuración>del proyecto y defina las rutas de acceso de área para el proyecto. Siga los pasos descritos en Agregar rutas de acceso de área.
4. Crear equipos: cree los equipos necesarios en función del paso 2. Para obtener más información, consulte Agregar un equipo, pasar de un equipo predeterminado a varios equipos.
5. Asignar rutas de acceso de área a los equipos: en la configuración del equipo, asigne las rutas de acceso predeterminadas y otras áreas a cada equipo. Siga los pasos descritos en Establecer rutas de acceso de área predeterminadas del equipo.
6. Asignar rutas de acceso de área a elementos de trabajo: asigne elementos de trabajo a las rutas de acceso 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. Para obtener más información, consulte Limitaciones de las vistas del panel de varios equipos.

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

• Adición de 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 del proyecto, siga estos pasos:

Browser

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

CLI de Azure DevOps

Enumerar rutas | de acceso del área de proyecto Agregar una ruta | de acceso de área de proyecto Enumerar rutas | de acceso de equipo Establecer rutas | de acceso de área de equipo Cambiar nombre o mover una ruta | de acceso de área de proyecto Quitar ruta de acceso de área de un equipo

Puede enumerar las rutas de acceso de área definidas para un proyecto mediante az boards area project list. Para empezar, 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 se especifica, solo se devuelven las rutas de acceso de área de nivel superior.
• ruta de acceso: opcional. Ruta absoluta de un área. \Area\ debe seguir después de , \ProjectNameque distingue esta ruta de acceso de una ruta de acceso 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". Cuando no se especifica, enumera las rutas de acceso de área desde el nivel raíz.
• project: opcional. Nombre o identificador 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

Agregar una ruta de acceso de área

De forma predeterminada, solo se define un área raíz. 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 acceso de área se agregan al nodo raíz de forma predeterminada.

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

Browser

Para agregar una nueva ruta de acceso de área, siga estos pasos:

1. Resalte la ruta de acceso del área y elija Nuevo elemento secundario. Opcionalmente, 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.

2. Escriba un nombre (255 caracteres o menos) para el nodo. Para obtener más restricciones de nombres, consulte Acerca de las áreas y las iteraciones, Restricciones de nomenclatura.

   

3. Seleccione Guardar y cerrar.

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

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

1. Resalte la ruta de acceso del área y elija Nuevo elemento secundario. Opcionalmente, puede seleccionar la ruta de acceso del área y elegir Nuevo elemento secundario o seleccionar Nuevo elemento secundario en el menú de la parte superior de la lista de áreas.

2. Escriba un nombre (255 caracteres o menos) para el nodo. Para obtener más restricciones de nombres, consulte Acerca de las áreas y las iteraciones, Restricciones de nomenclatura.

   

3. Seleccione Guardar y cerrar.

También puede agregar rutas de acceso de área a un equipo en la página Áreas de configuración>del equipo.

CLI de Azure DevOps

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 nodo secundario a la ruta de acceso especificada. Si no especifica el --path parámetro , la nueva ruta de acceso de á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 de acceso: opcional. Ruta absoluta de un área. Ejemplo: --path \ProjectName\Area\AreaName. Cuando no se especifica, agrega un área en el nivel raíz.
• project: opcional. Nombre o identificador del proyecto. Ejemplo: --project "Fabrikam Fiber".

Ejemplo: formato JSON

Por ejemplo, el siguiente comando agrega la ruta de acceso 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 este es el mismo comando con el formato de salida de la 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

Enumerar rutas de acceso del área de equipo

Los valores predeterminados del equipo se establecen en 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.

Browser

1. Abra el proyecto y, a continuación, seleccione Configuración del>proyecto Áreas de configuración>del equipo.

   

2. Si necesita cambiar el contexto del equipo, use el selector de equipos dentro de las rutas de navegación.

   

CLI de Azure DevOps

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

• team: Obligatorio. Nombre o identificador del equipo.
• project: opcional. Nombre o identificador 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

Apertura de la configuración del equipo desde el perfil de equipo

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

1. Abra un trabajo pendiente o un panel para un equipo y elija Configuración del equipo perfil> de equipo.

   Aquí abremos la Junta para el equipo de Fabrikam Fiber y desde allí el perfil del equipo.

   

2. Elija Iteraciones y áreas.

   

3. 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. Puede seleccionar una o varias rutas de acceso de área y, opcionalmente, incluir sus rutas de acceso de subárea. Elija incluir rutas de acceso de subárea cuando desee admitir vistas de acumulación de trabajo realizadas en varios equipos o áreas.

Nota:

Se puede asignar a Teams un máximo de 300 rutas de acceso de área. Para obtener más información, consulte Seguimiento del trabajo, procesos y límites del proyecto.

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

Importante

Los elementos de trabajo que aparecen en más de una tabla de un equipo pueden producir resultados de consulta que no cumplen sus expectativas. Dado que cada equipo puede personalizar las columnas y las calles de la placa, es posible que los valores asignados a los elementos de trabajo que aparecen en paneles diferentes no sean los mismos. La solución alternativa principal para este problema es mantener la propiedad única de los elementos de trabajo por ruta de acceso al área de equipo.

Browser

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

1. Seleccione Configuración del>proyecto Áreas de configuración>del equipo.

2. Seleccione el equipo que desea configurar en la lista desplegable de la parte superior de la página.

   Aquí se muestran las áreas del equipo fabrikam Fiber.

   

3. Elija una o varias rutas de acceso de área para que estén activas para el equipo.

   

   En esta instancia, se elige activar las rutas de acceso de subárea para el proyecto. El equipo de administración ahora puede realizar un seguimiento del progreso en todos los equipos.

   

4. Cuando termine, actualice la página de trabajo pendiente del producto para el equipo y verá los elementos de trabajo asignados al equipo. Agregue la ruta de acceso de área a las columnas que se muestran para ver las asignaciones realizadas a los elementos de trabajo.

   

   

CLI de Azure DevOps

Puede establecer la ruta de acceso de área predeterminada para un equipo o agregar una ruta de acceso 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

• path: obligatorio. Ruta absoluta de un área. Ejemplo: --path \ProjectName\AreaName.
• team: Obligatorio. Nombre o identificador del equipo.
• include-sub-areas: Opcional. Incluya nodos secundarios de la ruta de acceso del área. Valores aceptados: false, true.
• project: opcional. Nombre o identificador del proyecto. Ejemplo: --project "Fabrikam Fiber".
• set-as-default: opcional. Especifique como ruta de acceso 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

Cambiar el nombre o mover una ruta de acceso de área

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

Browser

1. Para cambiar el nombre de una ruta de acceso de área, abra la página Opciones de configuración>del proyecto del portal web Áreas de configuración>del proyecto.

2. Elija el menú contextual del nodo y seleccione Editar.

   

3. En el cuadro de diálogo que se abre, escriba el nuevo nombre.

   

4. Para mover el nodo dentro de la jerarquía, cambie el campo Ubicación .

   Nota:

   Al cambiar el nombre o cambiar el campo Ubicación de un nodo, el sistema actualiza automáticamente los elementos de trabajo existentes que hacen referencia a la ruta de acceso del área.

CLI de Azure DevOps

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

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

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

• path: 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 acceso del área.
• project: opcional. Nombre o identificador del proyecto. Ejemplo: --project "Fabrikam Fiber".

Ejemplo

Por ejemplo, el siguiente comando cambia el nombre de la ruta de acceso del área de 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

Eliminación de una ruta de acceso 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

• path: obligatorio. Ruta absoluta de un área. Ejemplo: --path \ProjectName\AreaName.
• team: Obligatorio. Nombre o identificador del equipo.
• project: opcional. Nombre o identificador del proyecto. Ejemplo: --project "Fabrikam Fiber".

Ejemplo

Por ejemplo, el siguiente comando quita la ruta de acceso del á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

Eliminar una ruta de acceso de área

Al eliminar una ruta de acceso de área, debe proporcionar una ruta de acceso de área que se usará para actualizar los elementos de trabajo asignados a la ruta de acceso del área que desea eliminar.

Importante

• La eliminación de rutas de acceso de área o la reconfiguración de las rutas de acceso de iteración provoca una pérdida de datos irreversible. Por ejemplo, los gráficos de widgets de grabación y de grabación, reducción de sprint y gráficos de velocidad para los equipos con rutas de área modificadas no mostrarán datos precisos. Los gráficos de tendencias históricos hacen referencia a la ruta de acceso del área y a la ruta de iteración tal como se definieron en el momento de cada elemento de trabajo. Una vez eliminado, no puede recuperar datos históricos para estas rutas de acceso.
• Solo puede eliminar rutas de acceso de área e iteración que ya no usan los elementos de trabajo.

1. Para eliminar una ruta de acceso de área, abra la página Opciones de configuración>del proyecto del portal web Áreas de configuración>del proyecto.

2. Elija el menú contextual del nodo y seleccione Eliminar o Quitar.

3. En el cuadro de diálogo que se abre, seleccione la ruta de acceso del área a la que reasignar los elementos de trabajo y, a continuación, elija Eliminar ruta de acceso.

   

Progreso del gráfico 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 acceso del área de cada equipo, como se muestra en el siguiente gráfico de barras apiladas. Elija Nombre de nodo para obtener el nodo hoja de la ruta de acceso del área.

Pasos siguientes

Establecer rutas de acceso o sprints de iteración

Artículos relacionados

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

• Más información sobre áreas e iteraciones
• Agregar otro equipo
• Configuración de la configuración del equipo y adición de administradores de equipo
• Uso de herramientas ágiles que dependen de áreas o iteraciones
• Consulta por área o ruta de acceso de iteración
• Establecimiento de permisos y acceso para el seguimiento del trabajo

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.

• Use el área az boards (CLI de Azure DevOps).
• Use Teams (API REST) para administrar las configuraciones del equipo.
• Use los nodos de clasificación (API REST) para organizar las clasificaciones de elementos de trabajo.