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, ejecute una consulta. Muchas consultas de elementos de trabajo están predefinidas con el proceso. Es posible que los miembros del equipo hayan creado consultas compartidas que pueda ver y ejecutar. A menudo, es más fácil definir una nueva consulta mediante la modificación de la definición de consulta que ya está disponible.
Requisitos previos
- Debe tener 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.
- Para agregar y guardar una consulta compartida, es preciso tener acceso Básico o superior.
- 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 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.
- 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.
- 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 ha seleccionado el proyecto correcto, (2) elija Paneles>Consultas y, después, (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 como 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 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.
Elija Todas para abrir la página donde puede ver todas las consultas que ha definido o que se comparten en el proyecto.
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.
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 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. 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 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 seleccionado 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 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 vista centrada en directorios 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.
Además, puede elegir una consulta que haya marcado como favorita en el menú del selector, o bien, puede elegir examinar todas las consultas, lo que le devolverá a la página Todas las 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
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.
Solo puede enviar el correo electrónico a una dirección individual de un miembro del proyecto reconocido por el sistema. No se admite la incorporación de un grupo de equipos o un grupo de seguridad en la línea. 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.