Compartir a través de


Administración y organización de consultas en Azure Boards y Azure DevOps

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

Visual Studio 2019 | Visual Studio 2022

Organice las consultas personales o compartidas agregando una carpeta de consulta. Después, puede agregar consultas a esas carpetas o moverlas a ellas. Puede crear consultas y carpetas de consultas desde el portal web o desde un cliente compatible, como Visual Studio Team Explorer.

Nota

Para crear y administrar consultas en Visual Studio 2019, debe establecer la experiencia de los elementos de trabajo en la opción heredada. Además, puede realizar la operación en bloque de arrastrar y colocar consultas en carpetas de consulta desde Visual Studio, pero no desde el portal web.

Nota:

Las imágenes del explorador que se usan en este artículo proceden de la nueva característica de concentradores de paneles, que está habilitada de forma predeterminada. Si esta característica no está habilitada, es posible que esté usando la experiencia anterior de paneles. Para mostrar las imágenes de la experiencia anterior, seleccione la versión de Azure DevOps Server 2022 de este artículo.

Requisitos previos

  • Niveles de acceso:
    • Tiene acceso de Parte interesada para ver y ejecutar consultas compartidas. De forma predeterminada todos los miembros del proyecto tienen acceso de parte interesada. Para más información, consulte Cambiar los permisos de una consulta o carpeta compartidas.
    • Tiene acceso Básico o superior para agregar y guardar una consulta compartida.
  • Permisos: El permiso Contribuir tiene activada la opción Permitir en la carpeta a la que desea agregar la 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 Referencia rápida sobre el acceso de parte interesada.

  • Niveles de acceso: De manera predeterminada, todos los miembros del proyecto y los usuarios con acceso de Parte interesada pueden ver y ejecutar todas las consultas compartidas. Puede cambiar los permisos establecidos para una carpeta de consultas compartidas o una consulta compartida. Para más información, consulte Configuración de permisos de consulta.
  • Permisos: Para agregar y guardar una consulta en Consultas compartidas, debe tener acceso Básico o superior. Además, debe tener establecido el permiso Contribuir en Permitir para la carpeta a la que desea agregar la consulta. De manera predeterminada, el grupo Colaboradores no tiene este permiso.

Apertura de una consulta

En el explorador web, (1) compruebe que seleccionó el proyecto correcto (2) elija Paneles > Consultas y, a continuación, (3) elija Todas.

Captura de pantalla de la página de consultas.

La página Consultas se abre en la pestaña Favoritos que muestra las consultas que estableció como favoritos. Puede elegir la pestaña Todas para ver todas las consultas definidas y compartidas definidas para el proyecto.

Sugerencia

Las consultas que usted o su equipo han elegido como favoritos aparecen en la página Favoritos. Junto con otros objetos, las consultas favoritas también aparecen en la página Proyecto. Para más información, consulte Establecer favoritos personales o de equipo.

En el proyecto, elija Paneles > Consultas y, a continuación, elija Todas.

Captura de pantalla de la página de consultas.

La página Consultas se abre en la pestaña Favoritos que muestra las consultas que estableció como favoritos. Puede elegir la pestaña Todas para ver todas las consultas definidas y compartidas definidas para el proyecto.

Sugerencia

Las consultas que usted o su equipo han elegido como favoritos aparecen en la página Favoritos. Junto con otros objetos, las consultas favoritas también aparecen en la página Proyecto. Para más información, consulte Establecer favoritos personales o de equipo.

Ejecutar, editar y guardar una consulta

La manera más fácil de definir una consulta es empezar por una consulta compartida existente. El siguiente ejemplo muestra cómo buscar todos los errores cerrados modificando la consulta compartida Errores activos proporcionada con la plantilla de proceso de Agile. Los ejemplos se basan en la interfaz de usuario proporcionada en el portal web.

  1. Abra una consulta compartida. Por ejemplo, en el portal web, abra Errores activos o una consulta de lista plana similar.

    Captura de pantalla de la selección de consulta.

    Sugerencia

    Si está trabajando en Visual Studio Team Explorer, abra la página Trabajo para acceder a las consultas y las consultas compartidas. Si Team Explorer no está visible, elija Ver>Team Explorer en el menú de nivel superior.

  2. Modifique la consulta para buscar errores cerrados y después ejecute la consulta. Use Insertar nueva línea de filtro para insertar una cláusula sobre la cláusula actual. Use Quitar esta línea de filtro para eliminar una cláusula. Las consultas se limitan automáticamente al proyecto actual. Para buscar elementos de trabajo definidos en varios proyectos, consulte Consulta entre proyectos.

    Captura de pantalla del editor de consultas.

  3. Guarde la consulta en la carpeta Mis consultas.

    Captura de pantalla del cuadro de diálogo de consulta Guardar como, nueva experiencia.

    Para guardar una consulta en la carpeta Consultas compartidas, debe ser miembro del grupo Administradores de proyectos o tener los permisos Contribuir de la carpeta establecidos en Permitir. Para más información, consulte Configuración de permisos de consulta.

  1. Abra una consulta compartida. Por ejemplo, en el portal web, abra Errores activos o una consulta de lista plana similar.

    Captura de pantalla de la lista de selección de consulta.

    Sugerencia

    Si está trabajando en Visual Studio Team Explorer, abra la página Trabajo para acceder a las consultas y las consultas compartidas. Si Team Explorer no está visible, elija Ver > Team Explorer en el menú de nivel superior.

  2. Modifique la consulta para buscar errores cerrados y después ejecute la consulta. Use Insertar nueva línea de filtro para insertar una cláusula sobre la cláusula actual. Use Quitar esta línea de filtro para eliminar una cláusula. Las consultas se limitan automáticamente al proyecto actual. Para buscar elementos de trabajo definidos en varios proyectos, consulte Consulta entre proyectos.

    Captura de pantalla del cuadro de diálogo de edición de consulta.

  3. Seleccione Guardar como en el menú Más acciones Más acciones.

    Nota:

    Cuando la característica Nuevo centro de paneles no está habilitada, la selección de Guardar como se encuentra en la parte superior de la página.

  4. Guarde la consulta en la carpeta Mis consultas.

    Captura de pantalla del cuadro de diálogo Guardar como consulta, experiencia de centros de paneles nuevos.

    Para guardar una consulta en la carpeta Consultas compartidas, debe ser miembro del grupo Administradores de proyectos o tener los permisos Contribuir de la carpeta establecidos en Permitir. Para más información, consulte Configuración de permisos de consulta.

Cambiar el nombre de una consulta o eliminarla

En la página Favoritos o Todos, elija el icono de acciones de una consulta para ejecutar, editar, cambiar el nombre o eliminar la consulta.

Captura de pantalla de nueva experiencia de consulta, página Favoritos, menú contextual de consulta.

Captura de pantalla del menú contextual de consulta.

En el caso de las consultas compartidas, también puede elegir realizar una de estas tareas:

  • Agregar a consultas de equipo: seleccione el equipo para agregar la consulta como favorita del equipo.
  • Seguridad...:: para establecer permisos para la consulta. Para más información, consulte Configuración de permisos de consulta.
  • Agregar al panel: agrega un widget de icono de consulta al panel de equipo que seleccione. Para más información, consulte Adición de widgets a un panel.

Agregar una carpeta de consulta y mover elementos a una carpeta

Sugerencia

Necesita permisos de eliminación para cambiar el nombre o mover una consulta o carpeta compartidas, y permisos de colaboración para la carpeta a la que se mueve la consulta. Para ver o establecer permisos, consulte Establecimiento de permisos en consultas y carpetas de consulta.

Puede agregar carpetas de consulta desde la página Paneles > Consultas > Todas.

  1. Elija Todo. Expanda Mis consultas o Consultas compartidas en función de dónde quiera agregar una carpeta de consulta.

  2. Para agregar una carpeta, elija el icono de acciones para una carpeta existente o la carpeta de contenedor principal y elija Nueva carpeta.

    Captura de pantalla del menú Abrir acciones, elija Nueva carpeta.

  3. Escriba el nombre de la carpeta en el cuadro de diálogo Nueva carpeta. Si quiere cambiar la ubicación de la carpeta, selecciónela en el menú desplegable de la carpeta.

    Captura de pantalla del cuadro de diálogo Nueva carpeta.

  4. Para mover elementos a una carpeta, arrastre y coloque una consulta en la carpeta. Desde el portal web, solo puede arrastrar una sola consulta desde fuera de una carpeta a una carpeta.

    Como opción alternativa, seleccione Más comandos en una consulta existente, elija Editar y luego Guardar como. En el cuadro de diálogo Guardar consulta como, elija la carpeta en la que desea guardar la consulta.

    Captura de pantalla del cuadro de diálogo Guardar consulta como.

Puede agregar carpetas de consulta desde la página Paneles > Consultas > Todas.

  1. Elija Todo. Expanda Mis consultas o Consultas compartidas en función de dónde quiera agregar una carpeta de consulta.

  2. Para agregar una carpeta, elija Nueva carpeta.

    Captura de pantalla de la selección de la nueva carpeta

  3. Escriba el nombre de la carpeta en el cuadro de diálogo Nueva carpeta. Si quiere cambiar la ubicación de la carpeta, selecciónela en el menú desplegable de la carpeta.

    Captura de pantalla del cuadro de diálogo Nueva carpeta.

  4. Para mover elementos a una carpeta, arrastre y coloque una consulta en la carpeta. Desde el portal web, solo puede arrastrar una sola consulta desde fuera de una carpeta a una carpeta.

    Como opción alternativa, seleccione Más comandos en una consulta existente, elija Editar y luego Guardar como. En el cuadro de diálogo Guardar consulta como, elija la carpeta en la que desea guardar la consulta.

    Captura de pantalla del cuadro de diálogo Guardar consulta como.

Guardar una consulta como favorita del equipo

Para guardar una consulta compartida como favorita del equipo, debe ser miembro del equipo.

Puede agregar una consulta compartida a favoritos del equipo. Comparta consultas con el equipo agregándolas a una carpeta en el contenedor Consultas compartidas. Para guardar una consulta en la carpeta Consultas compartidas, pida que le agreguen al grupo Administradores de la colección de proyectos o que le establezcan permisos para una carpeta en Consultas compartidas.

Solo puede agregar consultas compartidas como favoritos del equipo, y solo si dispone de permisos de administrador del equipo o permisos de administrador del proyecto.

  1. Para guardar una consulta como favorita del equipo, abra Más acciones o el menú contextual de la consulta desde la página Consultas.

  2. Elija Agregar a favoritos del equipo y, a continuación, seleccione uno de los equipos enumerados. Solo se muestran los equipos de los que usted es miembro.

    Captura de pantalla de Guardar consulta como favorita del equipo.

  1. Para guardar una consulta como favorita del equipo, abra el menú contextual Más acciones de la consulta desde Consultas compartidas en la página Consultas.

  2. Elija Agregar a favoritos del equipo y, a continuación, seleccione uno de los equipos enumerados. Solo se muestran los equipos de los que usted es miembro.

    Captura de pantalla de Guardar consulta como favorita del equipo.

Agregar un icono de consulta a un panel

Un icono de consulta muestra un recuento de los elementos de trabajo de una consulta. También puede abrir rápidamente la consulta desde el panel. Puede agregar un icono de consulta a un panel desde la página Consultas siguiendo los pasos siguientes o siguiendo los pasos descritos en Agregar widgets a un panel.

Nota:

Debe ser miembro del equipo o tener permisos para editar el panel.

  1. Para agregar una consulta a un panel desde la página Consultas, abra el menú Más acciones icono de acciones (o icono contextual ) de la consulta.

    Captura de pantalla del menú Más acciones, seleccionar Agregar al panel.

  2. En el cuadro de diálogo Seleccionar un panel, elija el panel al que desea agregar la consulta.

    Captura de pantalla del cuadro de diálogo Seleccionar un panel.

  3. Abra el panel y compruebe que se ha agregado el icono de consulta. Puede configurar el icono de consulta para cambiar el color predeterminado y especificar el color del icono en función de una regla condicional que especifique.

    Captura de pantalla del cuadro de diálogo Configurar para el widget de icono de consulta.

  1. Para agregar una consulta a un panel desde la página Consultas, abra el menú Más acciones de la consulta.

    Captura de pantalla del menú Más acciones, seleccionar Agregar al panel.

  2. En el cuadro de diálogo Seleccionar un panel, elija el panel al que desea agregar la consulta.

    Captura de pantalla del cuadro de diálogo Seleccionar un panel.

  3. Abra el panel y compruebe que se ha agregado el icono de consulta. Puede configurar el icono de consulta para cambiar el color predeterminado y especificar el color del icono en función de una regla condicional que especifique.

    Captura de pantalla del cuadro de diálogo Configurar para el widget de icono de consulta.