El lenguaje de búsqueda es la sintaxis que usas para realizar las búsquedas de problemas en la Herramienta de seguimiento de errores de Google. Puedes usar el idioma en las consultas que ingresas 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 con 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 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, los 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 manera global en todos los componentes y muestra aquellos cuyos campos anteriores contienen ambas palabras clave, según lo regido por 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 string de varias palabras se debe considerar como una sola palabra clave. Las búsquedas en la Herramienta de seguimiento de errores no distinguen mayúsculas de minúsculas, independientemente de si usas comillas.
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 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 Title. 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 ninguno
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 búsqueda, revisa la Referencia de consulta de búsqueda.
Operadores lógicos
Los operadores lógicos te permiten especificar más de un criterio y también indicar la relación entre ellos. Como se indicó antes, los caracteres de espacio fuera de 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 |
---|---|---|---|
Y | {espacio en blanco} | Coincide si el problema contiene ambos criterios | star:true AND componentid:46046 |
O | | | Coincide si el problema contiene alguno 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 entrecomillada (las palabras de la cita 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
yNOT
.El operador
NOT
tiene el mismo significado si antecede al nombre o al valor del campo. Esto significa que-assignee:jim
yassignee:-jim
son equivalentes.Utiliza paréntesis sin restricciones para agrupar los términos de la búsqueda con claridad. De forma predeterminada, la Herramienta de seguimiento de errores asocia
NOT
con el término inmediatamente posterior y agrupaOR
con los dos términos que lo rodean. Por ejemplo, la búsquedatitle:(a OR b NOT c AND d)
es equivalente atitle:((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 considera el guion que precede a una palabra en una búsqueda como un operador
NOT
. Por ejemplo, los criterios de búsqueda-assignee:none
oassignee:-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"
.En la Herramienta de seguimiento de errores, las palabras con guion en los campos de problemas se consideran independientes y 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úsquedatitle:(of art state the)
otitle:("state of the art")
, el problema se muestra como parte de los resultados de la búsqueda.
Operadores relacionales
La sintaxis base para los criterios de búsqueda de campo/valor es [field]:[value]
. El carácter de dos puntos (:
) especifica que el campo dado debe ser igual al valor especificado o contener el valor especificado para que se muestre un problema en los resultados de la búsqueda.
Los campos que contienen un valor de tiempo (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 el 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 mayor que/después o igual que el valor de búsqueda. |
Búsquedas de tiempo
El lenguaje de búsqueda proporciona una sintaxis especial para hacer coincidir campos que contienen un valor de tiempo. De esta manera, la Herramienta de seguimiento de errores puede buscar en un intervalo de veces o en horas relativas según sea necesario.
Formato de hora 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 están en UTC.
Puedes proporcionar el nivel de especificidad que desees cuando busques problemas creados antes o después de un momento determinado. Por ejemplo, puedes especificar created:2014-06
para encontrar problemas que se crearon en cualquier momento en junio de 2014. Si quieres ser más específico, puedes buscar en created:2014-06-03T04
para encontrar 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 hoy. Para hacerlo, usa el formato [days]d
, en el que [days]
es la cantidad de días del pasado 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 verificaron, pero que no
en los últimos 10 días, puedes usar (-verified:10d) AND status:verified
.