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

Azure DevOps Services | Azure DevOps Server 2022: Azure DevOps Server 2019 | TFS 2018

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 compilación de la definición de consulta que ya está disponible.

Prerrequisitos

  • De forma predeterminada, todos los miembros del proyecto y los usuarios con acceso a 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 más información, consulte Establecimiento 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 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 sobre el acceso de las partes interesadas.

  • De forma predeterminada, todos los miembros del proyecto y los usuarios con acceso a 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 más información, consulte Establecimiento 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 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 Consultas de paneles> y, a continuación, (3) elija Todo.

Abrir consultas de paneles>, navegación vertical

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 . Las consultas favoritas junto con otros objetos también aparecen en la página Proyecto . Para obtener más información, consulte Establecimiento de favoritos personales o de equipo.

En el explorador web, abra Consultas de paneles>.

En el explorador web, abra Consultas de paneles>.

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 con otras páginas del portal web, recuerda la vista a la que ha navegado por última vez y le devuelve a esa vista.

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

    Portal web, elija La página Consultas>de paneles>todo

  2. 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 sigue, elija Elementos de trabajo seguidos. 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 Seguir un elemento de trabajo o una solicitud de incorporación 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.

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: la 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 if--id.
  • org: dirección 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 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 directorios que puede filtrar para buscar consultas específicas de interés. Al trabajar en las páginas Consultas , puede navegar a una subcarpeta, carpeta o página.

Rutas de navegación de consultas

Además, puede elegir una consulta que haya favorito en el menú del selector, O bien, puede elegir examinar todas las consultas, que le devuelve a la página Todas las consultas .

Captura de pantalla de Consultas, selector de 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.

Captura de pantalla de la página Consultas, TFS 2018 y versiones anteriores.

Para obtener más información, vea Preguntas más frecuentes sobre consultas, Navegar y Carpetas.

Todas las tareas admitidas por favoritos y

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 se muestren favoritos en Mis favoritos. Solo las consultas guardadas en Consultas compartidas pueden ser favoritas por un equipo.


Tarea
Favoritos
(Explorador)
All
(Explorador)
Elementos de trabajo
(Team Explorer)
Ver todas las consultas favoritas, las suyas o 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 ✔️ ✔️
Favoritos de una consulta (para el portal web, elija Favorito) ✔️
Anulación de la vocación de una consulta (para el portal web, elija ) ✔️ ✔️ ✔️
Agregar una nueva consulta: Elija ✔️ ✔️ ✔️

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 Favoritos o Todos . 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 por criterios de palabra clave de WIT IQ.

Para obtener más información, vea Preguntas más frecuentes sobre consultas, Navegar y Carpetas.

Email elementos de consulta o compartir 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 seleccionar entre las opciones enumeradas, Email consulta o Copiar dirección URL de consulta.

Portal web, Editor de Power Query/Resultados, menú Abrir acciones, Elegir Email consulta o Copiar dirección URL de consulta
Solo puede enviar el correo electrónico a una dirección individual para 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 . 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 las 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 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.

Elija Copiar dirección URL de consulta. Para enviar por correo electrónico elementos de consulta, vea Copiar una lista de elementos de trabajo.

Portal web, Editor de Power Query/Resultados, Copiar dirección URL de consulta

Nota

Con Email consulta, el sistema enviará por correo electrónico la lista con formato a esos 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 descrita 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 solucionarlo mediante Copiar como HTML.

Pruebe esto a continuación