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:
  • Para ver y ejecutar consultas compartidas, sea miembro del proyecto.
  • Para agregar y guardar una consulta compartida, tenga al menos acceso básico .
• 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.

Abrir consultas

Browser

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

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.

Visual Studio

Importante

Se recomienda encarecidamente usar la vista predeterminada, en lugar de esta vista heredada. Está diseñado para que se pueda acceder rápidamente a una lista de elementos de trabajo en función de la asignación, los elementos siguientes, los mencionados o las actualizaciones recientes. La vista heredada ya no se mejora y esperamos quitarla en una versión futura de Visual Studio.

1. En la página principal de Team Explorer, seleccione Elementos de trabajo.

   

2. Para abrir una consulta, abra el menú contextual de la consulta (haga clic con el botón derecho con el mouse) y seleccione Ver resultados. O bien, haga doble clic en la consulta para abrirla.

   

O selecciona una de las opciones siguientes:

• Editar consulta: abre el Editor de consultas de la consulta seleccionada.
• Nueva consulta: abre el Editor de consultas con las opciones de nueva consulta predeterminadas.
• Abrir en Microsoft Excel (plano): abre la consulta en Microsoft Excel.
• Enviar a Microsoft Outlook: Abrir
• Cortar: corta la consulta. Después, puede pegar la consulta en otra carpeta.
• Copiar: copia la consulta. A continuación, puede pegar la consulta en la misma carpeta o en otra carpeta.
• Eliminar: elimina la consulta.
• Cambiar nombre: permite cambiar el nombre de la consulta.
• Agregar a mis favoritos: agrega la consulta a la sección Mis favoritos.
• Agregar a Favoritos del equipo: agrega la consulta a la sección Favoritos del equipo.
• Seguridad: Abre el cuadro de diálogo Permisos de la consulta.

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.

Browser

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.

   

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.

Visual Studio

Importante

Se recomienda encarecidamente usar la vista predeterminada, en lugar de esta vista heredada. Está diseñado para que se pueda acceder rápidamente a una lista de elementos de trabajo en función de la asignación, los elementos siguientes, los mencionados o las actualizaciones recientes. La vista heredada ya no se mejora y esperamos quitarla en una versión futura de Visual Studio.

• En la página Elementos de trabajo de Team Explorer, abra el menú contextual de la consulta (haga clic con el botón derecho con el mouse) y seleccione Ver resultados. O bien, haga doble clic en la consulta para abrirla.

  

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.

Browser

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.

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

Visual Studio

La página Elementos de trabajo muestra la misma estructura de carpetas que se define en el portal web. Los cambios realizados a través de Visual Studio se reflejan en el portal web.

Puede expandir y contraer carpetas, cambiar el nombre de las carpetas y arrastrar y colocar consultas de una carpeta a otra. Para más información, consulte Administración y organizació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 )		✔️
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.

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

Browser

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 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.

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.

Visual Studio

Puede enviar por correo electrónico una lista de consultas con formato si elige la opción Enviar a Microsoft Outlook en el menú contextual.

Nota

Esta característica requiere que esté instalado Microsoft Outlook. 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 la opción Copiar como HTML desde el portal web.

Pasos siguientes

Definir una consulta

Artículos relacionados

• Administrar consultas y carpetas de consultas
• Filtrado interactivo de trabajos pendientes, paneles, consultas y planes en Azure Boards
• Cambiar opciones de columna
• Establecimiento de favoritos personales o de equipo
• Métodos abreviados de teclado