Compartir vía


Ver, ejecutar o enviar por correo electrónico una consulta de elementos de trabajo

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

Visual Studio 2019 | Visual Studio 2022

Para buscar elementos de trabajo asignados a usted o a su equipo, puede ejecutar una consulta. El proceso podría incluir varias consultas predefinidas a las que puede acceder y ejecutar. A menudo, es más fácil crear una nueva consulta modificando una definición de consulta existente.

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.

Abrir consultas

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.

Ejecución de una consulta en Azure Boards

Para ejecutar cualquier consulta, expanda una carpeta y elija el título de la consulta. Se abre la vista para mostrar los resultados de la consulta.

También puede ejecutar una consulta mediante la interfaz de la línea de comandos de Azure DevOps.

Sugerencia

La página Consultas, al igual que otras páginas del portal web, recuerda la vista a la que ha ido por última vez y le devuelve a esa vista.

  1. Elija Todas para abrir la página donde puede ver todas las consultas que ha definido o que se comparten en el proyecto.

    Captura de pantalla de la visualización de todas las consultas.

  2. Seleccione Mis consultas según sea necesario.

    • Para ver todos los elementos de trabajo asignados, elija Asignado a mí. Esta consulta usa la macro @Me para mostrar todos los elementos de trabajo asignados a usted.
    • Para ver todos los elementos de trabajo que sigue, seleccione Elementos de trabajo con seguimiento. Esta consulta usa la macro @Follows (id. en @Follows) para enumerar todos los elementos de trabajo que ha elegido seguir). Para más información, consulte Seguimiento de un elemento de trabajo o una solicitud de cambios.
  3. Elija Consultas compartidas para expandir la carpeta y acceder a las consultas guardadas como consultas compartidas.

  4. Elija una carpeta dentro de una ruta de navegación para abrir una carpeta de consulta.

    Captura de pantalla del ejemplo de ruta de navegación de consultas.

Sugerencia

La página Consultas, al igual que otras páginas del portal web, recuerda la vista a la que ha ido por última vez y le devuelve a esa vista.

  1. Elija Todas para abrir la página donde puede ver todas las consultas que ha definido o que se comparten en el proyecto.

    Captura de pantalla de la visualización de todas las consultas.

  2. Seleccione Mis consultas según sea necesario.

    • Para ver todos los elementos de trabajo asignados, elija Asignado a mí. Esta consulta usa la macro @Me para mostrar todos los elementos de trabajo asignados a usted.
    • Para ver todos los elementos de trabajo que sigue, seleccione Elementos de trabajo con seguimiento. Esta consulta usa la macro @Follows (id. en @Follows) para enumerar todos los elementos de trabajo que ha elegido seguir). Para más información, consulte Seguimiento de un elemento de trabajo o una solicitud de cambios.
  3. Elija Consultas compartidas para expandir la carpeta y acceder a las consultas guardadas como consultas compartidas.

Ejecución de una consulta desde la línea de comandos

Puede ejecutar una consulta en la CLI con el comando az boards query. Para empezar, consulte Introducción a la CLI de Azure DevOps.

az boards query [--id]
                [--org]
                [--path]
                [--project]
                [--wiql] 

Parámetros

  • id: Identificador de una consulta existente. Obligatorio a menos que se especifique --path o --wiql.
  • wiql: consulta en formato del lenguaje de consulta del elemento de trabajo (WIQL). Se omite si se especifica --id o --path.
  • path: ruta de acceso de una consulta existente. Se omite si se especifica --id.
  • org: la URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado mediante git config. Ejemplo: --org https://dev.azure.com/MyOrganizationName/.
  • project: nombre o identificador del proyecto. Puede configurar el proyecto predeterminado mediante az devops configure -d project=NAME_OR_ID. Obligatorio si no está configurado como predeterminado o seleccionado mediante git config.

Ejemplo

El siguiente comando ejecuta una consulta con el identificador especificado y muestra el resultado en formato de tabla.

az boards query --id 6c286d74-26a5-4cce-bfcf-bf9123495bfe  --output table

Priority    Node Name         Work Item Type    Title                             Remaining Work
----------  ----------------  ----------------  --------------------------------  ----------------
1           Voice             Bug               Apply fix elsewhere as needed
2           CMMI              Bug               Slow response on form
1           Fiber             Bug               Check issues with permissions     0
2           Fiber             Bug               Voicemail hang issue              0
2           FabrikamBB        Bug               Research slow response time
1           FabrikamBB        Bug               Fix performance issues            0 

El siguiente comando ejecuta una consulta con el WIQL especificado y muestra el resultado en formato de tabla.

az boards query --wiql "SELECT [Microsoft.VSTS.Common.Priority], [System.NodeName], [System.WorkItemType], [System.Title], [Microsoft.VSTS.Scheduling.RemainingWork], [System.AssignedTo], [System.State], [System.Tags], [System.AreaPath] FROM workitems WHERE [System.WorkItemType] = 'Bug' AND [System.AreaPath] = 'Fabrikam Fiber' ORDER BY [System.WorkItemType]" --output table

Priority    Node Name       Work Item Type    Title                  Remaining Work
----------  --------------  ----------------  ----------------       ----------------
2           Fabrikam Fiber  Bug               Slow response on form
2           Fabrikam Fiber  Bug               Check permissions
2           Fabrikam Fiber  Bug               Fix performance issue
2           Fabrikam Fiber  Bug               Secure Sign-in 

Directorio de consultas, carpetas de consultas y rutas de navegación

Nota:

No se pueden agregar carpetas a Mis favoritos o Favoritos del equipo.

La página Consultas contiene una pestaña Favoritos y una pestaña Todas. Cada una contiene una vista centrada en el directorio que puede filtrar para buscar consultas específicas de interés.

Al trabajar en las páginas de consultas, puede ir a una subcarpeta, carpeta o página de consulta.

Captura de pantalla de la página de consultas.

Al realizar selecciones, las rutas de navegación se muestran en la parte superior de la página. Puede navegar a una carpeta, una subcarpeta o una página de consulta.

Captura de pantalla de las rutas de navegación en la página de consulta.

También puede seleccionar una consulta favorita o volver a la página Todas en el menú desplegable de una consulta abierta.

Captura de pantalla de la lista desplegable de consultas.

Captura de pantalla de la lista desplegable de navegación de consultas.

Para más información, consulte Preguntas más frecuentes sobre consultas, navegación y carpetas.

Todas las tareas admitidas y las marcadas como favoritas

Puede realizar la mayoría de las tareas para ver y ejecutar consultas desde cada una de las páginas de lista de consultas como se indica en la tabla siguiente. Solo las consultas que guarde en Mis consultas y que marque como favoritas aparecerán en Mis favoritos. Un equipo solo puede marcar como favoritas las consultas guardadas en Consultas compartidas.


Tarea
Favoritos
(Explorador)
All
(Explorador)
Elementos de trabajo
(Team Explorer)
Ver todas las consultas marcadas como favoritas, las suyas o las de un equipo al que pertenece ✔️ ✔️
Ver todas las consultas o consultas compartidas del proyecto actual ✔️ ✔️
Ejecutar una consulta, abrir el menú contextual de una consulta ✔️ ✔️ ✔️
Expandir o contraer carpetas de contenedor o carpetas de consulta ✔️ ✔️ ✔️
Filtrar la lista de consultas ✔️ ✔️
Marcar como favorita una consulta (para el portal web, elija Favoritos) ✔️
Quitar de favoritos una consulta (para el portal web, elija ) ✔️ ✔️ ✔️
Agregar una nueva consulta: seleccione ✔️ ✔️ ✔️

Filtrar la lista de consultas

Escriba una palabra clave en el cuadro de filtro para filtrar el conjunto de consultas que se muestran en las páginas Favoritas o Todas. Para más información sobre el filtrado, consulte Filtrado de trabajos pendientes, paneles, consultas y planes.

Captura de pantalla que muestra todas las consultas del proyecto filtradas según los criterios de palabra clave.

Captura de pantalla que muestra todas las consultas del proyecto filtradas según los criterios de palabra clave.

Para más información, consulte Preguntas más frecuentes sobre consultas, navegación y carpetas.

Envío por correo electrónico de elementos de consulta o uso compartido de una dirección URL de consulta

Desde la vista Editor de Power Query o Resultados, puede enviar por correo electrónico una lista con formato de elementos de consulta o copiar la dirección URL de la consulta.

Elija el icono de acciones para abrir el menú y seleccione entre las opciones mostradas, Enviar consulta por correo electrónico o Copiar dirección URL de consulta.

Captura de pantalla de Elegir Enviar consulta por correo electrónico o Copiar dirección URL de consulta.

Elija el icono de más acciones para abrir el menú y seleccione entre las opciones mostradas, Enviar consulta por correo electrónico o Copiar dirección URL de consulta.

Captura de pantalla de Elegir Enviar consulta por correo electrónico o Copiar dirección URL de consulta.

Solo puede enviar el correo electrónico a una dirección individual de un miembro del proyecto reconocido por el sistema. No se admite añadir un grupo de equipos o un grupo de seguridad a la línea "Para". Si agrega una cuenta de correo electrónico que el sistema no reconoce, recibirá un mensaje indicándole que uno o varios destinatarios del correo electrónico no tienen permisos para leer los elementos de trabajo enviados.

Nota:

Para enviar por correo electrónico una lista con formato a personas que no sean miembros del proyecto, deberá usar la opción Copiar como HTML que se describe en Copiar una lista de elementos de trabajo. En el caso de Azure DevOps local, todas las acciones de correo electrónico requieren que se configure un servidor SMTP. Si no tiene configurado un servidor SMTP, puede solucionarlo mediante Copiar como HTML.

Pasos siguientes