Seguimiento del trabajo mediante consultas administradas
Función de filtro
Compatibilidad con consultas
Versiones compatibles
Búsquedas de cadenas de texto (texto único, texto de varias líneas, texto enriquecido)
Las búsquedas no distinguen mayúsculas de minúsculas.
Todas las versiones
Comodín = *
Todas las versiones
Busque elementos de trabajo basados en vínculos directos o tipos de vínculos topológicos o jerárquicos.
Filtrar elementos de trabajo vinculados en función MODE de (MODE)
Todas las versiones
Agrupar y anidar cláusulas mediante operadores booleanos AND y OR.
Todas las versiones
Buscar elementos de trabajo basados en una coincidencia de campo con un valor anterior.
Operador admitido: Was Ever busque elementos de trabajo basados en un valor definido en una fecha específica.
Operador compatible: ASOF (ASOF)
Todas las versiones
Use macros para crear consultas relativas a una fecha, otras herramientas, como la ruta de acceso del área de equipo, la iteración de equipo, etc.
Todas las versiones
Busque elementos de trabajo en uno o varios proyectos de una organización o colección. El valor predeterminado es el proyecto actual. Use el campo Team Project para consultar dos o más proyectos.
TFS 2015-TFS 2018, Azure DevOps 2019-2020, Azure DevOps Services
Busque elementos de trabajo en función de cómo se comparan dos campos entre sí.
Operadores admitidos:
Todas las versiones
Busque elementos de trabajo en función de si contienen o no una etiqueta. Operadores admitidos:
Todas las versiones
Busque elementos de trabajo basados en campos HTML o texto enriquecido vacíos o no vacíos.
Operadores admitidos:
Azure DevOps 2019-2020, Azure DevOps Services
Buscar trabajo cuyo valor de campo coincida con cualquier valor de un conjunto delimitado, como un conjunto de tipos de elementos de trabajo, estados de flujo de trabajo o valores de lista desplegable. Separe los valores con el separador de lista que corresponde a la configuración regional definida en el equipo cliente. Por ejemplo, se puede utilizar la coma (,).
TFS 2018, Azure DevOps 2019-2020, Azure DevOps Services
Buscar elementos de trabajo basados en el valor de campo booleano.
TFS 2017-TFS 2018, Azure DevOps 2019-2020, Azure DevOps Services
Buscar elementos de trabajo basados en palabras o frases clave agregadas a través de la explicación.
TFS 2017.2-TFS 2018, Azure DevOps 2019-2020, Azure DevOps Services
Busque elementos de trabajo en función de su columna Kanban, calle o estado Haciendo/Listo.
Azure DevOps 2019-2020, Azure DevOps Services
Filtre los resultados de la consulta en función de una palabra clave o seleccione campos.
Azure DevOps 2019-2020, Azure DevOps Services
Para mover, copiar o pegar cláusulas de consulta de forma masiva, instale y use el editor WIQL. Para más información, consulte Operaciones de consulta entre servicios y mejoradas.
Macros admitidas
En la tabla siguiente se resumen las macros o variables de consulta admitidas por las Azure DevOps de consulta. Puede usar algunas de estas macros para filtrar las notificaciones.
Nota
Solo puede usar determinadas macros desde el portal web. Tfese incluye @CurrentIteration ,@CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivityy @TeamAreas macros. Estas macros no se admiten al exportar una consulta a Excel, filtros de notificación o que se han aplicado desde Team Explorer API REST.
Para obtener descripciones más detalladas y vínculos a ejemplos, vea Campos de consulta, operadores y macros.
Macro
Compatibilidad con consultas
Versiones compatibles
Busque cualquier tipo de elemento de Work Item Type=[Any] trabajo, , o cualquier estado, State=[Any] .
Todas las versiones
Busque trabajo donde Identity field=logged in user .
Todas las versiones
Busque trabajo donde Date-Time field=today .
Todas las versiones
Busque el trabajo definido en uno o varios proyectos.
TFS 2015-TFS 2018, Azure DevOps 2019-2020, Azure DevOps Services
Buscar trabajo definido en la iteración actual de un equipo.
Todas las versiones
Busque el trabajo definido en +/- n de la iteración actual para un equipo.
Azure DevOps 2019-2020, Azure DevOps Services
Busque el trabajo que el usuario que ha iniciado sesión está siguiendo, ID In @Follows .
TFS 2017-TFS 2018, Azure DevOps 2019-2020, Azure DevOps Services
Buscar elementos de trabajo modificados recientemente; vea también ID In @MyRecentActivity Ver y agregar elementos de ID In @MyRecentActivity.
TFS 2018, Azure DevOps 2019-2020, Azure DevOps Services
Busque trabajo donde el campo de fecha y hora seleccionado esté dentro del día, mes, semana o año actuales con un desplazamiento más/menos, por ejemplo: Closed Date>=@StartOfDay-7 .
Azure DevOps 2019-2020, Azure DevOps Services
Busque el trabajo asignado a una ruta de acceso de área o ruta de iteración del equipo especificado. Para obtener ejemplos, vea Consulta por ruta de acceso de área o iteración.
Azure DevOps 2019-2020, Azure DevOps Services
Resultados de consultas y características de administración de consultas
Las siguientes características proporcionan compatibilidad para trabajar con resultados de consulta, guardar y compartir consultas, etc.
- -
- -
- -
- -
- -
- -
- -
- -
- -
- -
- -
- -
- -
- -
- -
- -
- -
- -
- -
- -
- -
- -
- -
Características no admitidas
Las consultas de elementos de trabajo solo admiten consultas de elementos de trabajo y elementos de trabajo vinculados a otros elementos de trabajo. Estas son algunas de las tareas que las consultas administradas no admiten:
- Vistas jerárquicas de Test Plans, conjuntos de pruebas y casos de prueba. Estos elementos no se vinculan entre sí mediante tipos de vínculos de elementos primarios y secundarios. En su lugar, puede ver la jerarquía a través de la página Test Plans prueba.
- Vistas que muestran objetos vinculados como compilaciones, versiones, código u otros objetos de elementos que no son de trabajo.
- Enumerar los elementos de trabajo vinculados de un proyecto a otro.
- Exportar una consulta entre proyectos a Excel. Las consultas de vínculos directos se exportan Excel como una lista plana.
Tipos de consulta (planos, vínculos directos, árbol)
Azure Boards admite tres tipos de consulta. El icono situado junto a cada consulta indica el tipo de consulta. Use las instrucciones siguientes para elegir el tipo de consulta en función de lo que desea lograr con la consulta.

Tipo de consulta
Guía de uso
Lista plana de elementos de trabajo
- Enumeración de elementos para realizar actualizaciones masivas en campos
- Ejeje una lista de elementos de trabajo
- Crear un gráfico de consultas y agregarlo a un panel
- Crear un gráfico para obtener un recuento de elementos o sumar un campo
- Exportación de una lista de elementos para Excel actualizar campos
Elementos de trabajo y vínculos directos
- Enumerar los elementos que dependen de otros elementos de trabajo
- Buscar elementos relacionados o dependientes de otros elementos de trabajo
- Enumeración de elementos de trabajo vinculados para realizar actualizaciones masivas en campos
- Ejeje una lista de elementos de trabajo vinculados
- Enumeración de elementos de trabajo vinculados relacionados con pruebas
- Buscar elementos de trabajo pendiente huérfanos, elementos de trabajo que no tienen ningún elemento primario
Nota
Las consultas de vínculos directos y elementos de trabajo se exportan a Excel como una lista plana. Las consultas de vínculos directos se importan como una lista plana, ya que la modificación de varios tipos de vínculos no es una característica admitida en Excel.
Árbol de elementos de trabajo
- Enumerar un árbol de Parent-Child de trabajo relacionados u otro tipo de vínculo de topología de árbol
- Administración de una lista jerárquica de elementos de trabajo
- Exportar una lista jerárquica de elementos para Excel actualizar campos o modificar la jerarquía
Para más información sobre los tipos de vínculo, consulte Referencia de tipos de vínculo.
Mis consultas, Consultas compartidas y Favoritos
Solo puede ver y ejecutar las consultas que guarde en Mis consultas con el directorio de consultas. Además, puede elegir una de estas consultas como favorita para que aparezca en el selector de consultas.
Las consultas que usted y otras personas guarden en Consultas compartidas pueden ser vistas por todos los usuarios con acceso al proyecto. Las consultas compartidas se pueden organizar dentro de carpetas y ser favoritas para usted o para un equipo. Además, puede establecer permisos en las carpetas y consultas para evitar que otros usuarios las muevan o editen.
Para obtener detalles, consulte:
- Administrar las carpetas de consulta de consultas
- Establecer permisos de consulta
- Favoritos de una consulta y Establecer favoritos personales o de equipo
Directorio de consulta, carpetas de consulta y rutas de navegación
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ú del selector. O bien, puede examinar todas las consultas que le devuelvan a la página Todas las consultas.

Para obtener más información, vea Preguntas más frecuentes sobre consultas, Navegar y Carpetas.
Gráficos y widgets de consulta
Puede crear rápidamente gráficos circulares, de barras, dinámicos y de tendencias a partir de una consulta de lista plana. Las consultas deben ser de lista plana y devolver 1000 o menos elementos de trabajo. Puede agregar los gráficos de consulta a un panel, volver a dar título y volver a configurarlos.




Los widgets basados en consultas proporcionan compatibilidad para presentar información de consulta en un panel. Por ejemplo, el número de errores activos o una lista de elementos de trabajo con los que puede interactuar. Para obtener información sobre los gráficos de consultas y los widgets, consulte estos artículos:
- Gráfico de una consulta de lista plana
- Gráfico para el widget de elementos de trabajo
- Widget de resultados de consulta
- Widget de icono de consulta
Adición de un campo personalizado para admitir consultas
Para agregar un campo personalizado para satisfacer sus necesidades de consulta, consulte Personalización de la experiencia de seguimiento de trabajo.
Panel de tareas frente a elementos de lista de consultas
¿Puede observar y preguntarse por qué el contenido del panel de tareas difiere del contenido enumerado con su consulta creada? Para más información, consulte Elementos del panel de tareas frente a elementos de lista de consultas.
Consultas de búsqueda de texto completo y configuración de intercalación
Para admitir consultas de búsqueda de texto completo, la configuración de intercalación de la base de datos SQL Server debe corresponder a un idioma que tenga un separador de palabras registrado con SQL Server. Si usa un lenguaje no compatible, podría recibir resultados inesperados al ejecutar una consulta de elemento de trabajo que especifica los operadores Contains o Contains Words con cadenas de texto.
Para obtener más información, consulte los artículos siguientes:
API de REST
Para interactuar mediante programación con las consultas, consulte uno de estos recursos de API REST:
Recursos del SDK
Para interactuar mediante programación con consultas, vea Consulta de errores, tareas y otros elementos de trabajo.
Artículos relacionados
- Preguntas más frecuentes sobre consultas
- Referencia rápida de KQL
- Operaciones de consulta transversales y mejoradas
- Índice de campo de elemento de trabajo
- Establecer permisos de consulta
- Campos, operadores y macros de consulta
- Agregar o modificar en bloque elementos de trabajo con Excel
Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013
Enumerar errores, casos de usuario u otros elementos de trabajo en función de los criterios de campo que especifique mediante consultas. A continuación, puede revisar estas listas con su equipo, el trabajo de evaluación de evaluación de las preguntas y las preguntas y las actualizaciones masivas de los elementos de trabajo. Junto con las consultas administradas, la herramienta de búsqueda semántica proporciona algunas funcionalidades superpuestas y diferentes que merece la pena explorar.
Use consultas administradas para admitir estas operaciones:
- Actualización masiva de elementos de trabajo mediante el portal web
- Eje y actualice elementos de trabajo
- Revisión de una jerarquía de elementos de trabajo
- Compartir una lista de elementos de trabajo con un miembro del equipo
Puede crear consultas y carpetas de consulta desde el portal web o desde un cliente compatible, como Visual Studio Team Explorer y Team Explorer Everywhere, un complemento para Eclipse. Los cambios realizados en un cliente se reflejan en otros clientes, ya que todos los cambios se almacenan en el almacén de datos de seguimiento de trabajo.
Introducción al uso de consultas
Si acaba de empezar, lea Ver, ejecutar o enviar por correo electrónico una consulta de elemento de trabajo. Para obtener una referencia rápida de las tareas del editor de consultas y las consultas de ejemplo, vea Consulta de referencia rápida.
- Para buscar elementos de trabajo asignados, agregue las macros @Me como valor del campo Asignado a en una de las cláusulas de consulta.
- Todos los usuarios válidos con acceso estándar pueden crear consultas y carpetas en el Mis consultas estándar. Para crear consultas y carpetas de consulta en Consultas compartidas,debe tener el conjunto de permisos Contribuir. Para obtener más información, vea Establecer permisos en consultas.
- Puede modificar cualquier consulta agregando criterios para centrarse en un área de producto, una iteración u otro campo. Para modificar una consulta, abra el editor de consultas.
- Puede abrir cualquier consulta en Excel. También puede actualizar los campos de uno o varios elementos de trabajo y publicar los cambios en la base de datos para realizar el seguimiento de los elementos de trabajo.
- Puede visualizar el estado o el progreso mediante la creación de un gráfico circular, un gráfico de columnas o un gráfico de tendencias para las consultas de lista plana.
Funciones de consultas
En las secciones siguientes se proporciona información general de las funciones admitidas para definir y administrar consultas de elementos de trabajo.
- Los filtros de consulta se definen a través del Editor de consultas.
- Se pueden seleccionar macros de consulta para campos específicos para crear una cláusula de consulta.
- Los resultados de las consultas y las características de administración de consultas son funcionalidades disponibles a través de la página Resultados de la consulta.
Filtros de consulta
En la tabla siguiente se resumen las funciones de filtro de consulta admitidas por cada versión Azure DevOps consulta.
Nota
Las consultas administradas no admiten búsquedas de proximidad, pero sí búsquedas semánticas. Además, las búsquedas semánticas admiten y como caracteres comodín y puede usar más de un carácter comodín para buscar coincidencias * con más de un ? carácter. Para más información, consulte Búsqueda de elementos de trabajo funcionales.