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
En este artículo se describen los tipos de datos de campo, los operadores de consulta y las macros de consulta que se usan en el Editor de consultas. Algunos tipos, operadores y macros solo se aplican a versiones específicas de Azure DevOps.
Para ver ejemplos rápidos y tareas del editor, consulte Referencia rápida de consultas y Administración y organización de consultas.
Requisitos previos
| Categoría | Requisitos |
|---|---|
| Niveles de acceso | - Para ver y ejecutar consultas compartidas: Miembro del proyecto. - Para agregar y guardar una consulta compartida: al menos acceso Básico. |
| Permisos | Colaborar permisos establecidos en Permitir para la carpeta a la que desea añadir una consulta. De manera predeterminada, el grupo Colaboradores no tiene este permiso. |
Nota
Los usuarios con acceso Stakeholder a un proyecto público tienen acceso completo a las características de consulta, 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.
| Categoría | Requisitos |
|---|---|
| Niveles de acceso | - Para ver y ejecutar consultas compartidas: Miembro del proyecto. - Para agregar y guardar una consulta compartida: al menos acceso básico. |
| Permisos | Colaborar permisos establecidos en Permitir para la carpeta a la que desea añadir una consulta. De manera predeterminada, el grupo Colaboradores no tiene este permiso. |
Valores y tipos de datos de campo de consulta
Debe especificar un valor que coincida con el tipo de datos de un campo. En la tabla siguiente se enumeran los tipos de datos admitidos:
Nota
Para Azure Boards (nube), el tipo de datos coincide con el campo que se muestra en la página Campos de proceso>. Para las implementaciones locales, el tipo de datos corresponde al type atributo en una FIELD definición. Consulte Campos de elemento de trabajo y atributos de campo para obtener más información.
Tipo de datos
Descripción
Booleano
Almacena un valor True/False.
DateTime o Fecha y hora
Use una variable de fecha (por ejemplo, @Today o ) o @Today-1una fecha explícita como 01/01/2025. Introduzca las fechas en el formato configurado en su perfil. Para obtener ejemplos de consultas, vea Query by date or @CurrentIteration.
En el caso de las consultas WIQL, también puede especificar fechas en UTC. Consulte Sintaxis para el lenguaje de consulta de elementos de trabajo (WIQL).
Doble o Decimal
Almacena un número real, como 0,2 o 3,5. Consulte Consulta por campos numéricos para obtener ejemplos.
GUID
Almacena una cadena de identificador única.
Historial
Campo con formato personalizado usado para la información histórica (el campo Historial ). Cuando la búsqueda de texto completo está disponible, este campo se indexa para las consultas de texto completo. Consulte Historial y auditoría.
HTML
Almacena texto con formato (por ejemplo, Descripción o Pasos para reproducir). Cuando la búsqueda de texto completo está disponible, estos campos se indexan. Para consultar campos de texto enriquecido, consulte Consulta por títulos, identificadores y campos de texto enriquecido.
Identidad
Almacena una cadena de texto corta que identifica una identidad de usuario.
Entero
Almacena un entero de 32 bits con signo (por ejemplo, 0, 1, 2, 34).
Texto sin formato o Campo de texto (varias líneas)
Almacena valores de texto largos (por ejemplo, Información de inicio de la aplicación). Los campos se indexan para la búsqueda de texto completo cuando se admite. Consulte Consulta por títulos, identificadores y campos de texto enriquecido.
picklistDouble
Campo personalizado que contiene una lista de selección de valores decimales.
picklistInteger
Campo personalizado que contiene una lista de selección de valores enteros.
picklistString
Campo personalizado que contiene una lista de selección de valores de texto corto (255 caracteres o menos).
Campo de cadena o de texto (una sola línea)
Almacena texto corto de hasta 255 caracteres Unicode. Los equipos suelen usar estos campos para listas de selección o menús desplegables.
TreePath
Representa un árbol ramificado (por ejemplo, Ruta de área o Ruta de iteración). Elija un valor de nodo válido. Puede filtrar por igualdad, desigualdad, "Under" / "Not Under" o usar los In / Not In operadores para especificar varios valores. Defina estructuras de árbol para un proyecto (rutas de acceso de área y rutas de acceso de iteración) y seleccione los nodos que se van a asociar a los equipos.
Para obtener ejemplos de consultas, consulte Consulta por área o ruta de acceso de iteración y Consulta por fecha o iteración actual.
Nota
Los picklist... tipos solo se aplican a los campos personalizados definidos para un proceso heredado.
Patrón de fecha y hora
El patrón de fecha y hora que escriba para los campos DateTime debe coincidir con el que seleccione mediante el perfil. Para ver o cambiar la selección, consulte Establecimiento de preferencias de usuario.
Operadores de consulta
Use operadores para definir cómo debe relacionarse un valor de cláusula con el valor de campo de un elemento de trabajo. Para los tipos de datos de campo, consulte Referencia de los campos de elementos de trabajo. Para obtener ayuda para crear consultas, consulte Definición de una consulta.
Operador de consulta
Cuando el operador devuelve elementos de trabajo coincidentes
Tipos de datos aplicables
=
Coincide con el valor de la cláusula .
Number (Double/Decimal/GUID/Integer), String, DateTime, TreePath
<>
No coincide con el valor de la cláusula .
Number, String, DateTime, TreePath
>
Es mayor que el valor de la cláusula.
Número, Cadena, Fecha y Hora
<
Es menor que el valor de la cláusula.
Número, Cadena, Fecha y Hora
>=
Es mayor o igual que el valor de la cláusula.
Número, Cadena, Fecha y Hora
<=
Es menor o igual que el valor de la cláusula.
Número, Cadena, Fecha y Hora
Campo
Coincide con el valor de otro campo especificado (debe ser el mismo tipo de datos).
Nombre de un campo del mismo tipo de datos (los campos booleanos comparan la igualdad con otros campos).
<>[Campo]
No coincide con el valor de otro campo especificado.
Nombre de un campo del mismo tipo de datos.
>[Campo]
Es mayor que el valor de otro campo especificado.
Nombre de un campo del mismo tipo de datos.
<[Campo]
Es menor que el valor de otro campo especificado.
Nombre de un campo del mismo tipo de datos.
>=[Campo]
Es mayor o igual que el valor de otro campo especificado.
Nombre de un campo del mismo tipo de datos.
<=[Campo]
Es menor o igual que el valor de otro campo especificado.
Nombre de un campo del mismo tipo de datos.
Contains
Contiene una coincidencia de texto exacta o parcial.
String
No contiene
No contiene una coincidencia de texto exacta o parcial.
String
Contiene palabras
Coinciden con una frase exacta o palabras (admite un comodín al final *). Límite: 100 caracteres. Este operador usa la indexación de texto completo; consulte la sección Texto completo de este artículo para conocer los requisitos de intercalación y servidor.
Campos de texto largo indexados para la búsqueda de texto completo (Texto sin formato, HTML, Historial y Título).
No contiene palabras
Excluye los elementos que contienen la frase o palabras especificadas. Límite: 100 caracteres. Use Contains Words con cláusulas complementarias para incluir o excluir términos clave.
Campos de texto indexados para la búsqueda de texto completo.
En
Coincide con cualquier valor de un conjunto delimitado (use el separador de lista regional del sistema operativo, normalmente una coma).
Number, String, DateTime, TreePath
Está vacío
Coincide con los elementos en los que un campo HTML no contiene contenido (ningún valor especificado). Compatible con Azure Boards y Azure DevOps Server.
HTML
No está vacío
Coincide con los elementos en los que un campo HTML contiene contenido. Compatible con Azure Boards y Azure DevOps Server.
HTML
No en el
Excluye los valores de un conjunto delimitado (use el separador de lista regional). Compatible con Azure Boards y Azure DevOps Server.
Number, String, DateTime, TreePath
En grupo
Coincide con valores que pertenecen a un grupo nombrado (equipo, grupo de seguridad o categoría). Por ejemplo, use el grupo Colaboradores o un grupo de equipos denominado en el patrón [Project Name]\Team Name. Consulte Consulta por asignación o cambios de flujo de trabajo para obtener ejemplos.
Cadena de texto (coincide con el nombre de grupo o equipo) o tipo de elemento de trabajo
Nota
Utilice In Group solo con campos de tipo Cadena o Tipo de Elemento de Trabajo. Puede usar grupos de identificadores de Microsoft Entra cuando su cuenta usa el identificador de Microsoft Entra o los grupos de Active Directory para el entorno local. :::column-end:::
No en grupo
Excluye a los miembros de un grupo específico.
Cadena que coincide con un grupo de usuarios o una categoría de proyecto.
No pertenece a
Excluye los elementos iguales o contenidos en el nodo de árbol especificado.
TreePath
En
Coincide con los elementos que son iguales o que están contenidos bajo el nodo del árbol especificado.
TreePath
Fue
Corresponde a un valor que un campo mantuvo en cualquier momento anterior.
String, FechaHora
Nota
El Editor de consultas no admite actualmente Was Ever en los campos de fecha; use una consulta WIQL directa para esos casos.
:::column-end:::
Sugerencia
Puede construir consultas WIQL que usen operadores (por ejemplo, `Was Ever`) contra otros tipos de datos, como la Ruta de Acceso de Iteración. Consulte Enumerar elementos de trabajo movidos fuera de un sprint para obtener un ejemplo.
Consulta de macros y variables
Use las macros siguientes para filtrar las consultas dinámicamente.
Nota
Las macros siguientes solo se admiten desde el portal web: @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity y @TeamAreas. Las consultas que contienen estas macros no funcionarán cuando se abran en Visual Studio/Team Explorer, Microsoft Excel o Microsoft Project.
Macro
Descripción
[Any]
Utilizar con tipo de elemento de trabajo o estado para buscar en todos los tipos o estados. Por ejemplo, Work Item Type=[Any] quita el filtrado basado en tipos.
@CurrentIteration
Use con Iteration Path para filtrar los elementos de trabajo en el sprint actual según el contexto del equipo actual. Consulte Consulta por fecha o iteración actual para obtener ejemplos. @CurrentIteration solo funciona cuando se ejecuta desde el portal web (no en las API REST ni en algunas operaciones de copia o clonación).
@CurrentIteration +/-n
Use la ruta de iteración para incluir sprints relativos a la iteración actual (por ejemplo, @CurrentIteration-1 o @CurrentIteration+2). Se admite en el portal web para Azure Boards y Azure DevOps Server.
@Follows
Utilice con ID y el operador In para enumerar los elementos de trabajo que sigue en el proyecto. Consulte Seguir un elemento de trabajo o una solicitud de incorporación de cambios. Esta macro solo funciona desde el portal web.
@Me
Use con campos de identidad para filtrar los elementos vinculados a su cuenta (por ejemplo, Created By=@Me). Consulte Consulta por asignación, flujo de trabajo o cambios en el panel.
@MyRecentActivity
Usa con ID y In para enumerar los elementos de trabajo que has visto o actualizado en los últimos ~30 días. Consulte la página de Elementos de trabajo en el pivote Mi actividad para ver la misma lista.
@Project
Use con Team Project para filtrar los elementos de trabajo en el proyecto actual (por ejemplo, Team Project=@Project). Consulte Consulta entre proyectos.
@RecentMentions
Use con ID y In para enumerar los elementos de trabajo donde se le menciona en Discusiones. Consulte la pestaña Mencionado en la página de Elementos de trabajo.
@RecentProjectActivity
Usar con ID y In para listar ítems de trabajo actualizados recientemente en el proyecto. La macro devuelve hasta 5000 elementos; la ventana real depende de la actividad del proyecto.
@StartOfDay
Use con campos DateTime para filtrar en relación con hoy (por ejemplo, Closed Date>=@StartOfDay-7).
@StartOfMonth
Use con campos DateTime para filtrar con respecto al inicio del mes (por ejemplo, Created Date>=@StartOfMonth-3).
@StartOfWeek
Use con campos DateTime para filtrar en relación con el inicio de la semana (por ejemplo, Changed Date>=@StartOfWeek-2).
@StartOfYear
Use con campos DateTime para filtrar en relación con el inicio del año (por ejemplo, Target Date>=@StartOfYear).
@TeamAreas
Use solo con Ruta de Área y el = operador para buscar elementos asignados a las rutas de áreas del equipo (por ejemplo, Area Path=@TeamAreas [Fabrikam Fiber]\Web). Compatible con el portal web de Azure DevOps Server.
@Today
Use con campos DateTime para filtrar en relación con hoy (por ejemplo, Created Date>=@Today-7). Consulte Consulta por fecha o iteración actual.
Búsquedas parciales y de texto completo
Use Contains o Does Not Contains para buscar coincidencias exactas o parciales en campos de texto largo (estos operadores usan el índice de consulta). Use Contiene palabras o No contiene palabras para buscar frases exactas o usar un comodín al final (*); requieren el uso del índice de texto completo.
Puede usar el carácter comodín solo al final de una palabra o frase parcial. Si desea ver algunos ejemplos, consulte Ejemplo de consultas de elemento de trabajo y Consulta de elementos de trabajo mediante el campo Historial.
Nota
No todas las implementaciones admiten la búsqueda de texto completo. Por ejemplo, SQL Express y algunas configuraciones de SQL en la nube no admiten la búsqueda de texto completo. En esas implementaciones, solo los operadores Contains y Does Not Contains están visibles.
Azure DevOps Server indexa campos de texto largo (Texto sin formato y HTML) y el campo Título para la búsqueda de texto completo cuando SQL Server subyacente admite la indexación de texto completo.
La búsqueda de texto completo también requiere una colación de SQL con un separador de palabras registrado para el idioma que uses. Si la collation de la base de datos de recopilación no coincide con un idioma admitido, es posible que los resultados no coincidan con las expectativas; en esos casos, use Contains o Does Not Contain en su lugar.
Para más información, vea Consultas de búsqueda de texto completo y la configuración de intercalación.
Contenido relacionado
- Usar la referencia rápida sobre consultas
- Detalles sobre las consultas administradas
- Acceso al índice del campo del elemento de trabajo
- Descripción de la sintaxis de WIQL
REST API
Para interactuar mediante programación con las consultas, consulte uno de estos recursos sobre la API REST: