Compartir vía

Uso de un índice para consultar datos de referencia rápida en Azure Boards y Azure DevOps

  • Artículo

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Use este índice para acceder rápidamente a consultas de ejemplo e información sobre cómo abrir, definir y trabajar con consultas. Para obtener información sobre cómo usar el Editor de consultas, vea Definición de una consulta. Si las consultas tardan demasiado tiempo en devolver resultados, consulte Definición de una consulta o procedimientos recomendados.

Consultas de ejemplo

Puede enumerar elementos de trabajo en función de los siguientes criterios…

Palabras clave, consultas con caracteres comodín

Consultas basadas en etiquetas

Consultas de cambio de estado, motivo o flujo de trabajo

Consultas basadas en fecha e iteración

Consultas de recuento de vínculos y datos adjuntos

Consultas basadas en identidades

Recuento de elementos de trabajo y consultas de campos numéricos

Consultas de historial, discusión y revisión de cambios

Consultas de enfoque de equipo

Consultas de campos de compilación y prueba

Otros

Tareas de consulta

Operadores y macros admitidos para cada tipo de datos

En la tabla siguiente se indican los operadores y macros disponibles para los distintos tipos de datos de campo. Cada campo está asociado a un tipo de datos. Puede encontrar el tipo de datos en las descripciones de cada campo, que puede buscar mediante el índice de campos del elemento de trabajo. Los operadores disponibles para definir una cláusula de consulta dependen del tipo de datos del campo que haya seleccionado. Para obtener descripciones más detalladas de los tipos de datos, operadores y macros, vea Campos de consulta, operadores y macros.

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.

Tipo de datos

Descripción

Operadores y macros admitidos

Boolean

Admite un valor True/False. Ejemplos de consulta: Consulta por cambios de asignación o flujo de trabajo.

= , <> , =[Field] , <>[Field]

DateTime

Campo de fecha en el que puede especificar una variable, como @Today o @Today-1, o un valor, como 1/1/2012. Escriba las fechas en el patrón de fecha que estableció para su perfil personal. Vea Establecimiento de preferencias personales para obtener más información.

Para ver ejemplos de consultas, vea Consulta por fecha o @CurrentIteration.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever
Macros: @Today, válida con cualquier campo DateTime

Macros adicionales admitidas en Azure DevOps 2019 Update 1 y versiones posteriores:
@StartOfDay, @StartOfWeek, @StartOfMonth y @StartOfYear, válidas con cualquier campo DateTime

Double

También se conoce como Decimal e incluye picklistDouble1. Un número real, como 0,2 o 3,5.

Ejemplos de consulta: Consulta por campos numéricos.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

GUID

Una cadena de caracteres que representa un identificador único.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

Historial

Campo con formato personalizado usado para realizar un seguimiento de la información histórica y asignado únicamente al campo Historial.

Ejemplos de consultas: Historial y auditoría.

Contiene palabras, no contiene palabras

HTML

Cadenas de texto que admiten descripciones con formato, como los campos Descripción o Pasos de reproducción. Estos campos se indizan automáticamente para la búsqueda de texto completo cuando esta está disponible. Ejemplos de consulta: Consulta por títulos, identificadores y campos de texto enriquecido.

Contains Words, Does Not Contain Words, Is Empty2, Is Not Empty2

Identidad

Campo de cadena que se usa para contener una identidad de usuario. Ejemplos de consulta: Consulta por cambios de asignación o flujo de trabajo.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was EverMacros: @me, válida para todos los campos de identidad.

Entero

También incluye picklistInteger1. Un entero de 32 bits con signo, como 0, 1, 2, 34.

Ejemplos de consulta: Consulta por campos numéricos.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

Macros: @Follows, @MyRecentActivity, @RecentMentions y @RecentProjectActivity, válidas cuando se usan con el campo id.

PlainText

Cadenas de texto de varias líneas que admiten descripciones largas y se indexan automáticamente para la búsqueda de texto completo, cuando la búsqueda de texto completo está disponible.
Ejemplos de consulta: Consulta por títulos, identificadores y campos de texto enriquecido.

Contains Words, Does Not Contain Words, Is Empty, Is Not Empty

String

También incluye picklistString1. Texto corto de una sola línea que puede contener hasta 255 caracteres Unicode. Los campos de cadena admiten el campo Título, listas de selección (menús desplegables), cuentas de usuario, etiquetas y otros campos.

Ejemplos de consultas: Consulta por títulos, identificadores y campos de texto enriquecido y Consulta por valor de lista de selección.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was Ever

Macros: [Any], válida con el campo Tipo de elemento de trabajo; y @Project, válida con el campo Proyecto de equipo.

TreePath

Tipo de campo que admite los campos Ruta de acceso de área y Ruta de acceso de iteración. Defina la estructura de árbol de un proyecto: rutas de acceso de área y rutas de acceso de iteración.

Ejemplos de consultas: Consulta por ruta de acceso de área o de iteración y Consulta por fecha o iteración actual.

Under, Not Under, =, <>, In, Not In

Macros: @TeamAreas3, válida con el campo Ruta de acceso de área
@CurrentIteration y @CurrentIteration+/- n4, válidas con el campo Ruta de acceso de iteración

Nota

  1. Los tipos de datos picklist... solo se asignan a campos personalizados definidos para un proceso heredado. El modelo de proceso heredado solo se admite para Azure DevOps Server 2019 y versiones posteriores.
  2. Los operadores Is Empty y Is Not Empty se admiten para Azure DevOps Server 2019 RC2 y versiones posteriores.
  3. La macro @TeamAreas se admite para Azure Boards y Azure DevOps Server 2019 y versiones posteriores.
  4. La macro @CurrentIteration +/- n se admite para Azure DevOps Server 2019.1 y versiones posteriores, y solo cuando se ejecuta desde el portal web.

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.

Captura de pantalla de las opciones desplegables de Patrón de fecha en el panel Hora y configuración regional.Captura de pantalla de las opciones desplegables de Patrón de hora en el panel Hora y configuración regional.

Captura de pantalla del panel Hora y configuración regional con los campos Patrón de fecha y Patrón de hora.

Consultas de ejemplo para determinados campos

En la tabla siguiente se enumeran los campos de consulta comunes y su tipo de datos, para el que se proporcionan consultas de ejemplo. Para determinar el tipo de datos de un campo, vea Campos y atributos de elemento de trabajo, Enumerar atributos de campo.

A

B

C

D-E-F

H-P

R

S

T

V-W