Lenguaje de búsqueda

El lenguaje de las búsquedas es la sintaxis que usas para realizar búsquedas de problemas en la Herramienta de seguimiento de errores de Google. Puedes usar el idioma en las consultas que escribas en la barra de búsqueda. También puedes usar el compilador de búsqueda para seleccionar gráficamente los criterios, que luego se convierten al lenguaje de consulta cuando se cierra el compilador de búsquedas.

El lenguaje de consulta te permite buscar según los siguientes criterios:

  • Palabras clave
  • Pares de campo/valor

Las búsquedas que realizas pueden contener varios criterios, incluida una combinación de palabras clave y pares de campo/valor. La sintaxis del lenguaje de consulta te permite especificar la relación y el orden en que los criterios se consideran mediante el uso de operadores lógicos, paréntesis y comillas.

Búsquedas de palabras clave

Las palabras clave son cadenas de texto que puedes usar para buscar en ciertos campos de los problemas. Estos campos son los siguientes:

  • Título
  • Comentarios
  • Nombres de archivos adjuntos
  • Campos que contienen usuarios (por ejemplo, Destinatario o CC)
  • Campos que contienen un número de ID interno (por ejemplo, aquellos que especifican el componente o las hotlists que contienen un problema)
  • Campos que contienen números de versión
  • Campos personalizados

Un ejemplo de criterios de búsqueda de palabras clave es la cadena configuration properties. Cuando ingresas estos criterios en una búsqueda, la Herramienta de seguimiento de errores busca problemas de forma global en todos los componentes y muestra aquellos cuyos campos anteriores contienen ambas palabras clave, según tus permisos de control de acceso. Las palabras clave pueden estar en campos diferentes o en los mismos campos.

La Herramienta de seguimiento de errores trata el carácter de espacio que separa los criterios de búsqueda como un operador AND implícito. Puedes utilizar comillas (") para especificar que una cadena de varias palabras se debe considerar como una sola palabra clave. Todas las búsquedas de la Herramienta de seguimiento de errores no distinguen mayúsculas de minúsculas, independientemente de si usas comillas o no.

Búsquedas de pares de campo/valor

También puedes especificar criterios de búsqueda como un par de campo/valor. La sintaxis base es [field]:[value]. En el caso de los campos de texto, esta sintaxis coincide con problemas en los que el campo especificado contiene el valor. Para otros tipos de campos, coincide con los problemas en los que el valor del campo es equivalente.

Por ejemplo, una búsqueda de title:latency coincide con problemas con la palabra latency en el campo Título. Una búsqueda de priority:p0 encuentra problemas con una prioridad de p0.

Ten en cuenta que para los campos de tiempo y recuento, puedes usar otros símbolos relacionales además del carácter de dos puntos. Consulta Operadores relacionales a continuación.

Búsquedas de valores especiales con cualquiera y ninguna

Los campos opcionales se pueden consultar con los valores especiales any y none. any coincide con cualquier valor no nulo. none coincide con valores nulos. Para obtener una lista de todas las etiquetas de campo admitidas en el lenguaje de consulta de búsqueda, visita la Referencia de búsqueda.

Operadores lógicos

Los operadores lógicos te permiten especificar más de un criterio e indicar la relación entre ellos. Como se indicó anteriormente, los caracteres de espacio fuera de las comillas actúan como operadores AND implícitos. La Herramienta de seguimiento de errores admite los siguientes operadores lógicos explícitos adicionales:

Operador Símbolo alternativo Descripción Ejemplo
AND {espacio en blanco} Coincide si el problema contiene ambos criterios star:true AND componentid:46046
O | Coincide si el problema contiene cualquiera de los criterios type:(Bug|feature_request)
NOT - Coincide si el problema no contiene los criterios -assignee:jim
"..." Coincide si el problema contiene una frase entre comillas (las palabras aparecen en el mismo orden). comment:"We have a problem"
( ) Agrupa valores o criterios de búsqueda. status:open AND (priority:(p0|p1) OR severity:(s0|s1))

Ten en cuenta lo siguiente:

  • Debes escribir todo en mayúsculas en AND, OR y NOT.

  • El operador NOT tiene el mismo significado si antecede al nombre o al valor del campo. Esto significa que -assignee:jim y assignee:-jim son equivalentes.

  • Usa paréntesis con total claridad para agrupar los términos en la consulta de búsqueda. De forma predeterminada, la Herramienta de seguimiento de errores asocia NOT solo con el término que lo sigue y agrupa OR con los dos términos que lo encierran. Por ejemplo, la búsqueda title:(a OR b NOT c AND d) es equivalente a title:((a OR b) AND (NOT c) AND d).

Guiones

El carácter de guion (-) tiene significados diferentes según el contexto en una búsqueda:

  • La Herramienta de seguimiento de errores trata el guion que precede a una palabra en una búsqueda como un operador NOT. Por ejemplo, los criterios de búsqueda -assignee:none o assignee:-none muestran todos los problemas que tienen una persona asignada.

  • La Herramienta de seguimiento de errores trata las strings conectadas por un carácter de guion como si estuvieran entre comillas. Por ejemplo, el criterio de búsqueda state-of-the-art es equivalente a "state of the art".

  • La Herramienta de seguimiento de errores trata las palabras con guion de un campo de problema como palabras independientes separadas por espacios en blanco. Esto significa que, si un problema tiene la palabra state-of-the-art en el título y ejecutas la búsqueda title:(of art state the) o title:("state of the art"), el problema se muestra como parte de los resultados de la búsqueda.

Operadores relacionales

La sintaxis base para un criterio de búsqueda de campo/valor es [field]:[value], en la que el carácter de dos puntos (:) especifica que el campo dado debe ser igual o contener el valor especificado para que se muestre un problema en los resultados de la búsqueda.

Los campos que contienen un valor temporal (created, modified, resolved, verified y ciertos campos personalizados) o un valor de recuento (duplicatecount, votecount, commentcount y cccount) admiten los siguientes operadores relacionales adicionales:

Símbolo Descripción
< Coincide con un problema si su valor es inferior o anterior al valor de búsqueda.
<= Coincide con un problema si su valor es menor/anterior o igual que tu valor de búsqueda.
> Coincide con un problema si su valor es mayor o posterior al valor de búsqueda.
>= Coincide con un problema si su valor es superior, posterior o igual al valor de búsqueda.

Búsquedas de hora

El lenguaje de búsqueda proporciona una sintaxis especial para hacer coincidir campos que contienen un valor de tiempo. Esto permite que la Herramienta de seguimiento de errores busque un intervalo de tiempos o tiempos relativos según sea necesario.

Formato de tiempo absoluto

El formato para especificar una hora es el siguiente:

[yyyy]-[MM]-[dd]T[HH]:[mm]:[ss].

En este formato, [yyyy] es el año de 4 dígitos, [MM] es el mes de 2 dígitos, [dd] es el día de 2 dígitos, [HH] es la hora de 2 dígitos de un reloj de 24 horas, [mm] es el minuto y [ss] es el segundo. Todas las horas se expresan en UTC.

Puedes proporcionar el nivel de especificidad que desees cuando busques problemas creados en un momento determinado, antes o después. Por ejemplo, puedes especificar created:2014-06 para encontrar problemas que se crearon en cualquier momento en junio de 2014. Para obtener más especificidad, puedes buscar en created:2014-06-03T04 los problemas que se crearon el 3 de junio de 2014 en la cuarta hora (entre las 4 a.m. y las 5 a.m., UTC).

Intervalos de tiempo

Puedes usar dos caracteres de punto (..) para especificar un intervalo de tiempo en los criterios de búsqueda de campo/valor. La sintaxis es [field]:[start time]..[end time]. Las horas de inicio y finalización pueden tener el grado de especificidad que necesites. Por ejemplo, verified:2013..2015 muestra todos los problemas verificados en 2013, 2014 o 2015.

Formato de tiempo relativo

También puedes especificar una hora en términos de días anteriores a la fecha actual. Para hacerlo, usa el formato [days]d, en el que [days] es la cantidad de días pasados que deseas incluir en los resultados de la búsqueda. Por ejemplo, puedes usar modified:5d para encontrar los problemas modificados en los últimos cinco días.

Cuando se usa un formato de hora relativo, el operador debe ser el carácter de dos puntos (:), como created:5d. Si deseas encontrar problemas que no estén dentro del rango, puedes usar el operador NOT o -.

Por ejemplo, -verified:10d muestra problemas que no se verificaron en los últimos 10 días. Si deseas encontrar problemas que se hayan verificado, pero no en los últimos 10 días, puedes usar (-verified:10d) AND status:verified.

Búsquedas de "hoy" con la aritmética del día

Puedes usar el token today en las búsquedas de hora como sustituto de la fecha actual. Admite el uso de aritmética de día, como today+10 y today-2. El token today también se puede usar en intervalos de tiempo como today-2..today+3. Usar el token today en las búsquedas guardadas permite volver a usar la consulta.

Ejemplos:

  • created:today
  • modified<=today-10
  • nearestslo:today+10
  • resolved:2024-02-29..today+2
  • customfield1002:today..today+5

Advertencia: Como se mencionó en el formato de hora absoluta, las búsquedas de hora en la Herramienta de seguimiento de errores se realizan en UTC. Lo mismo se aplica a las búsquedas que usan today.