Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Use consultas para enumerar errores, casos de usuario u otros elementos de trabajo en función de los criterios de campo que especifique. Los equipos ejecutan estas listas para evaluar el trabajo, actualizar elementos en masa o revisar jerarquías. La búsqueda semántica ofrece funcionalidades superpuestas y complementarias que merece la pena explorar.
Use consultas administradas para:
- Actualización masiva de elementos de trabajo mediante el portal web
- Evaluación de prioridades y actualización de elementos de trabajo
- Revisión de una jerarquía de elementos de trabajo
- Compartir una lista de elementos de trabajo con un compañero de equipo
Puede crear consultas y carpetas de consulta desde el portal web o Visual Studio Team Explorer. Los cambios realizados en un cliente aparecen en los demás porque todos los cambios se almacenan en el almacén de datos de seguimiento del trabajo.
Introducción al uso de consultas
Si está comenzando, lea Ver, ejecutar o enviar por correo electrónico una consulta de elemento de trabajo. Para obtener una referencia rápida sobre las tareas del editor de consultas y las consultas de ejemplo, consulte Referencia rápida de consultas.
- Para buscar los elementos de trabajo asignados a usted, use la macro @Me como valor para el campo "Asignado a" en una cláusula.
- Todos los usuarios válidos con acceso estándar pueden crear consultas y carpetas en Mis consultas. Para crear consultas o carpetas en Consultas compartidas, debe tener el permiso Contribuir. Consulte Establecer permisos en consultas.
- Modifique 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.
- Abra cualquier consulta en Excel para actualizar campos y publicar cambios en la base de datos.
- Visualice el estado o el progreso mediante la creación de un gráfico circular, columna o tendencia para consultas de lista plana. Para obtener más información, consulte Gráficos.
Funciones de consultas
En las secciones siguientes se resumen las funciones que se usan para definir y administrar consultas de elementos de trabajo.
- Defina filtros de consulta con el Editor de consultas.
- Use macros de consulta en cláusulas para dirigir campos dinámicamente.
- Administre los resultados y carpetas de la consulta desde 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 de Azure DevOps.
Nota
Las consultas administradas no admiten búsquedas por proximidad, pero sí las admiten las 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 que coincida con más de un carácter. Para más información, consulte Búsqueda de elementos de trabajo funcionales.
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 entre mayúsculas y minúsculas.
Todas las versiones
Carácter comodín = *
Todas las versiones
Busque elementos de trabajo basados en vínculos directos o tipos de vínculos topológicos o jerárquicos.
Filtre elementos de trabajo vinculados basados en MODE (sintaxis WIQL)
Todas las versiones
Agrupe y anide cláusulas mediante los operadores booleanos AND y OR.
Todas las versiones
Busque 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 admitido: ASOF (sintaxis WIQL)
Todas las versiones
Use macros para crear consultas relativas a una fecha, otras herramientas, como la ruta de acceso al área de equipo, la iteración del 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 Proyecto de equipo para consultar en dos o más proyectos.
Todas las versiones
Busque elementos de trabajo basados en cómo se comparan dos campos entre sí.
Operadores admitidos: =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field]
Todas las versiones
Busque elementos de trabajo en función de si contienen o no una etiqueta.
Operadores admitidos: Contains, Does Not Contain
Todas las versiones
Busque elementos de trabajo basados en campos de texto HTML o enriquecido vacíos o no vacíos.
Operadores admitidos: Is Empty, Is Not Empty
Todas las versiones
Busque el 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, puede usar una coma (,).
Todas las versiones
Busque elementos de trabajo basados en el valor de campo booleano.
Todas las versiones
Busque elementos de trabajo basados en palabras clave o frases agregadas a través de la discusión.
Todas las versiones
Busque elementos de trabajo en función de su columna, carril o estado En curso o Hecho.
Todas las versiones
Filtre los resultados de la consulta en función de una palabra clave o campos seleccionados.
Todas las versiones
Para mover, copiar o pegar cláusulas de consulta de forma masiva, instale y use el editor de WIQL.
Macros admitidas
En la tabla siguiente se resumen las macros de consulta o las variables compatibles con las versiones de Azure DevOps. Puede usar algunas de estas macros para filtrar las notificaciones.
Nota
Solo puede usar determinadas macros desde el portal web. Entre estas se incluyen: @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity y @TeamAreas. Estas macros no se admiten al exportar una consulta a Excel, filtros de notificación o ejercicios de Team Explorer o API REST.
Para obtener descripciones y vínculos más detallados a ejemplos, consulte Campos de consulta, operadores y macros.
Macro
Compatibilidad con consultas
Versiones compatibles
Busque cualquier tipo de elemento de trabajo, Work Item Type=[Any], o cualquier estado, State=[Any].
Todas las versiones
Busque trabajo en el que Identity field=logged in user.
Todas las versiones
Busque trabajo en el que Date-Time field=today.
Todas las versiones
Busque trabajos definidos en uno o varios proyectos.
Todas las versiones
Busque el trabajo definido en la iteración actual de un equipo.
Todas las versiones
Busque el trabajo definido en +/- n de la iteración actual de un equipo.
Todas las versiones
Busque el usuario actual que ha iniciado sesión en el trabajo como sigue, ID In @Follows.
Todas las versiones
Busque elementos de trabajo modificados recientemente, ID In @MyRecentActivity Consulte también Ver y agregar elementos de trabajo, página Elementos de trabajo.
Todas las versiones
Busque el trabajo en el que el campo de fecha y hora seleccionado esté dentro del día, mes, semana o año actual con un margen más/menos, por ejemplo: Closed Date>=@StartOfDay-7.
Todas las versiones
Busque el trabajo asignado a una ruta de acceso al área o de iteración del equipo especificado. Para obtener ejemplos, consulte Consulta por ruta de acceso al área o la iteración.
Todas las versiones
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.
-
Incorporar un gráfico de consultas a un panel
-
Aplicar filtros interactivos
-
Seleccionar orden de columnas
-
Seleccionar opciones de columna de la consulta
-
Copiar los resultados de la consulta
-
copiar dirección URL de consulta
-
Crear gráficos de consultas
-
Crear carpetas de consultas
Características no admitidas
Las consultas solo admiten elementos de trabajo y elementos de trabajo vinculados a otros elementos de trabajo. Las consultas administradas no admiten:
- Vistas jerárquicas de planes de prueba, conjuntos de pruebas y casos de prueba (estos elementos no usan vínculos primarios y secundarios). En su lugar, vea la jerarquía a través de la página Planes de prueba > .
- Vistas que muestran objetos vinculados, como compilaciones, versiones, código u otros objetos que no son de elemento de trabajo.
- Enumerar elementos de trabajo vinculados de un proyecto a otro.
- Exportar una consulta entre proyectos a Excel (las consultas de vínculos directos se exportan como una lista plana).
Tipos de consulta (plana, vínculos directos, árbol)
Azure Boards admite tres tipos de consulta; el icono situado junto a una consulta indica su tipo. Elija el tipo en función de los resultados que necesite.
Tipo de consulta
Guía de uso
Lista plana de elementos de trabajo
- Enumerar elementos para realizar actualizaciones masivas
- Evaluar las prioridades en una lista de elementos de trabajo
- Crear un gráfico de consultas y agregarlo a un panel
- Crear un gráfico para contar elementos o sumar un campo numérico
- Exportar una lista a Excel para actualizar campos
Elementos de trabajo y vínculos directos
- Enumerar elementos que dependen de otros elementos de trabajo
- Buscar elementos relacionados o dependientes
- Enumerar elementos de trabajo vinculados para realizar actualizaciones masivas
- Priorizar los elementos de trabajo vinculados, incluidos los vínculos de prueba.
- Buscar elementos de trabajo pendiente huérfanos (elementos sin padre)
Nota
Las consultas de elementos de trabajo y vínculos directos se exportan a Excel como una lista plana. Excel los importa como una lista plana porque Excel no admite la modificación de varios tipos de vínculo.
Árbol de elementos de trabajo
- Enumerar un árbol de elementos de trabajo Padre-Hijo u otros tipos de vínculo en topología de árbol
- Priorizar listas jerárquicas de tareas
- Exportación de una lista jerárquica a Excel para actualizar campos o modificar jerarquía
Para más información sobre los tipos de vínculo, consulte Referencia al tipo de vínculo.
Mis consultas, consultas compartidas y favoritos
Solo puede ver y ejecutar consultas guardadas en Mis consultas. Marcar una consulta como favorita para que aparezca en su selector de consultas.
Las consultas guardadas en Consultas compartidas son visibles para todos los usuarios con acceso al proyecto. Organice las consultas compartidas en carpetas y las prefiera para obtener acceso rápido. Puede establecer permisos en carpetas y consultas para evitar que otros usuarios los muevan o editen.
Para más información, vea:
- Administrar consultas y carpetas de consultas
- Establecer permisos de consulta
- Marcar una consulta como favorita y Establecer favoritos personales o de equipo
Directorio de consultas, carpetas de consultas y rutas de navegación
La página Consultas proporciona favoritos y todas las pestañas. Cada pestaña muestra una vista de directorio que puede filtrar para buscar consultas específicas.
Al navegar por las páginas Consultas , puede abrir una carpeta, una subcarpeta o una página de consulta.
Al realizar las selecciones, las migas de pan aparecen en la parte superior de la página. Úselos para navegar a una carpeta, una subcarpeta o una 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.
Para más información, consulte Preguntas más frecuentes sobre consultas, navegación y carpetas.
Consulta de gráficos y widgets
Cree gráficos circulares, de barras, dinámicos y de tendencia a partir de una consulta de lista plana (las consultas deben devolver 1000 elementos de trabajo o menos). Agregue gráficos de consulta a los paneles, retitútelos y vuelva a configurarlos según sea necesario.
Los widgets basados en consultas muestran información de consulta en un panel (por ejemplo, el número de errores activos o una lista interactiva de elementos de trabajo). Para más información, consulte:
- Gráfico de una consulta de lista plana
- Gráfico de widgets 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 consultas, consulte Personalización de la experiencia de seguimiento del trabajo.
Panel de tareas frente a elementos de la lista de consultas
Si el contenido del panel de tareas difiere de los resultados de una consulta creada, consulte Elementos de panel de tareas frente a elementos de lista de consultas para obtener más información.
Configuración de intercalación y consultas de búsqueda de texto completo
Si utiliza consultas de búsqueda de texto completo con los operadores Contains o Contains Words, asegúrese de que la intercalación de SQL Server corresponda a un idioma con un separador de palabras registrado. Los idiomas no admitidos pueden producir resultados inesperados.
Para más información, vea:
API de REST
Para interactuar mediante programación con las consultas, consulte uno de estos recursos sobre la API REST:
- Referencia de la API REST de Azure DevOps Services
- Consultas
- Lenguaje de consultas de elemento de trabajo
- Capturar elementos de trabajo con consultas mediante programación