Ver, ejecutar o enviar por correo electrónico una consulta de elemento de trabajo
Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013
Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015 | Visual Studio 2013
Para buscar elementos de trabajo asignados a usted o a su equipo, ejecute una consulta. Muchas consultas de elementos de trabajo están predefinidas con el proceso. Los miembros del equipo pueden haber creado consultas compartidas que puede ver y ejecutar. A menudo, es más fácil definir una nueva consulta mediante la creación de la definición de consulta que ya está disponible.
Requisitos previos
- De forma predeterminada, todos los miembros del proyecto y los usuarios con acceso a las partes interesadas pueden ver y ejecutar todas las consultas compartidas. Puede cambiar los permisos establecidos para una carpeta de consulta compartida o una consulta compartida. Para obtener más información, vea Establecer permisos de consulta.
- Para agregar y guardar una consulta en Consultas compartidas,se le debe conceder acceso Básico o superior. Además, debe tener el permiso Contribuir establecido en Permitir para la carpeta a la que desea agregar la consulta. De forma predeterminada, el grupo Colaboradores no tiene este permiso.
Nota
Los usuarios con acceso de partes interesadas para un proyecto público tienen acceso total a las características de consulta, al igual que los usuarios con acceso básico. Para más información, consulte Referencia rápida de acceso de las partes interesadas.
- De forma predeterminada, todos los miembros del proyecto y los usuarios con acceso a las partes interesadas pueden ver y ejecutar todas las consultas compartidas. Puede cambiar los permisos establecidos para una carpeta de consulta compartida o una consulta compartida. Para obtener más información, vea Establecer permisos de consulta.
- Para agregar y guardar una consulta en Consultas compartidas,se le debe conceder acceso Básico o superior. Además, debe tener el permiso Contribuir establecido en Permitir para la carpeta a la que desea agregar la consulta. De forma predeterminada, el grupo Colaboradores no tiene este permiso.
Abrir consultas
En el explorador web, (1) compruebe que ha seleccionado el proyecto correcto, (2) elija Boards Consultasy, a continuación, (3) elija Todo.
Si es la primera vez que abre Consultas, la página se abre en Favoritos. En esta página se enumeran las consultas que ha indicado que son favoritas. De lo contrario, puede elegir Todo para ver todas las consultas definidas y compartidas definidas para el proyecto.
Sugerencia
Las consultas que usted o su equipo han elegido como favoritos se muestran en la página Favoritos. Las consultas favoritas junto con otros objetos también aparecen en la página Project usuario. Para más información, consulte Establecer favoritos personales o de equipo.
En el explorador web, abra Boards Consultas.
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 Azure DevOps línea de comandos.
Sugerencia
La página Consultas, al igual que con otras páginas del portal web, recuerda la vista a la que se ha navegado por última vez y le devuelve a esa vista.
Elija Todos para abrir la página donde puede ver todas las consultas que ha definido o que se comparten dentro del proyecto.
Elija 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 enumerar todos los elementos de trabajo asignados.
- Para ver todos los elementos de trabajo que está siguiendo, elija Elementos de trabajo seguidos. Esta consulta usa la macro @Follows (identificador 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 extracción.
Elija Consultas compartidas para expandir la carpeta y acceder a las consultas guardadas como consultas compartidas.
Elija una carpeta dentro de una ruta de navegación para abrir una carpeta de consulta.
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 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:la consulta en lenguaje de consultas de elemento de trabajo formato. Se omite si se especifica --id o --path.
- path:ruta de acceso de una consulta existente. Se omite si se especifica --id.
- org: Azure DevOps url de la organización. Puede configurar la organización predeterminada mediante
az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o se selecciona mediantegit 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 se selecciona mediantegit 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 consulta, carpetas de consulta y rutas de navegación
Carpetas de consulta
Nota
No se pueden agregar carpetas a Mis favoritos o Favoritos del equipo.
La página Consultas contiene una vista centrada en el directorio que puede filtrar para buscar consultas específicas de interés. Al trabajar en las páginas Consultas, puede navegar a una subcarpeta, una carpeta o una página.
Además, puede elegir una consulta que haya favorito en el menú selector, o bien, puede examinar todas las consultas, lo que le devuelve a la página Todas las consultas.
La página Consultas muestra la estructura de carpetas en el panel izquierdo. 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 obtener más información, vea Preguntas más frecuentes sobre consultas, Navegar y Carpetas.
Todas las tareas admitidas y Favoritos
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 tengan favoritos se mostrarán en Mis favoritos. Solo las consultas guardadas en Consultas compartidas pueden ser favoritas de un equipo.
Tarea |
Favoritos (Explorador) |
All (Explorador) |
Elementos de trabajo (Team Explorer) |
|---|---|---|---|
| Ver todo consultas favoritas, las de usted o un equipo al que pertenezca | ✔️ | ✔️ | |
| Ver todo consultas o consultas compartidas para el 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 | ✔️ | ✔️ | |
Favoritos de una consulta (para el portal web, elija  |
✔️ | ||
Desfavorite una consulta (para el portal web, elija  ) |
✔️ | ✔️ | ✔️ |
Agregar una nueva consulta: Elegir 
|
✔️ | ✔️ | ✔️ |
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 Favoritoso Todos. Para más información sobre el filtrado, consulte Filtrado de los proyectos pendientes, paneles, consultas y planes.
Para obtener más información, vea Preguntas más frecuentes sobre consultas, Navegar y Carpetas.
Enviar por correo electrónico elementos de consulta o compartir una dirección URL de consulta
Desde el Editor de consultas o la vista 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 
enumeradas, Consulta de correo electrónico o Copiar dirección URL de consulta.
Solo puede enviar el correo electrónico a la dirección individual de un miembro del proyecto reconocido por el sistema. No se admite la adición de un grupo de equipos o un grupo de seguridad a la línea a . Si agrega una cuenta de correo electrónico que el sistema no reconoce, recibirá un mensaje que indica que uno o varios destinatarios del correo electrónico no tienen permisos para leer los elementos de trabajo enviados por correo.
Nota
Para enviar por correo electrónico una lista con formato a personas que no son 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 las Azure DevOps locales, todas las acciones de correo electrónico requieren que se configure un servidor SMTP. Si no tiene configurado un servidor SMTP, puede evitarlo mediante Copiar como HTML.
Elija Copy query URL (Copiar dirección URL de consulta). Para enviar por correo electrónico elementos de consulta, vea Copiar una lista de elementos de trabajo.
Nota
Con la consulta de correoelectrónico, el sistema enviará por correo electrónico la lista con formato a los compañeros de equipo que seleccione. Para enviar por correo electrónico una lista con formato a personas que no forman parte del proyecto, deberá usar la opción Copiar como HTML que se describe en Copiar una lista de elementos de trabajo. Todas las acciones de correo electrónico requieren que se configure un servidor SMTP. Si no tiene configurado un servidor SMTP, puede evitarlo mediante Copiar como HTML.
