...

Image Added

¿No podemos encontrar la Solicitud del Usuario con la que hemos estado trabajando? Para ello utilizaremos la opción [BusquedasBúsquedas] de la parte superior de la pantalla, accederemos a la ventana Navegador de comunicaciones.

Image RemovedImage Added

En esta página les mostraremos cómo buscar problemas en Jira Service Desk. Cualquier gestor puede buscar Solicitudes, aunque únicamente veremos los resultados de los proyectos a los que tenemos acceso. 

Definir los criterios de búsqueda

...

• Buscar [1]: pulsaremos en cualquier lugar del cuadro para mostrar nuestro trabajo reciente o comenzar a escribir para buscar entre todas las incidencias y Proyectos.
• Solicitudes [2]: solicitudes recientes (antes de la búsqueda) o solicitudes que coinciden con su búsqueda.
• Proyectos [3]: Proyectos recientes (antes de la búsqueda) o proyectos que coinciden con nuestra búsqueda.

Image RemovedImage AddedComprender la búsqueda rápida

...

• Si no tenemos criterios de búsqueda complejos, es posible que deseamos utilizar la búsqueda rápida en su lugar.
• Si nos sentimos cómodos con Jira Query Language (JQL), es posible que deseemos utilizar la búsqueda avanzada en su lugar. Esta búsqueda es más poderosa que la búsqueda básica.

Image RemovedImage Added

Elegiremos la opción [Búsquedas] [Buscar comunicaciones...].

...

• Si estamos buscando y no podemos encontrar el campo que desea, o si el campo muestra el texto en gris, podemos consultar el punto de Solucionar problemas a continuación.
• Si estamos buscando texto, podemos utilizar caracteres especiales y modificadores en nuestro texto de búsqueda, como comodines y operadores lógicos. Consultaremos la página de 5.1.- Sintaxis de búsqueda para búscar campos de texto.

Los resultados de la búsqueda se actualizarán automáticamente en el navegador de problemas, a menos que su administrador haya desactivado las actualizaciones automáticas de los resultados de la búsqueda. Si es así, deberemos pulsar en el botón [Actualizar] en el menú desplegable del campo después de cada cambio.

...

Las búsquedas guardadas (también conocidas como filtros) se muestran en el panel izquierdo, cuando se utiliza la búsqueda básica. Si el panel izquierdo no se muestra, pasaremos el ratón sobre el lado izquierdo de la pantalla para mostrarlo.

Image RemovedImage Added

Para ejecutar un filtro, por ejemplo Mis comunicaciones abiertas, simplemente pulsaremos sobre él. Se establecerán los criterios de búsqueda para la búsqueda básica y se mostrarán los resultados de la búsqueda.

...

Debemos tener en cuenta que JQL no es un lenguaje de consulta de bases de datos, aunque utiliza una sintaxis similar al SQL.

Image RemovedImage Added

Elegiremos la opción [Búsquedas] [Buscar comunicaciones...].

...

Una consulta simple en JQL (también conocida como cláusula) consta de un campo,

Cambiar la vista de los resultados de búsqueda

seguido de un operador, seguido de uno o más valores o funciones.

                     project = "TEST"

Esta consulta encontrará todos los problemas en el proyecto "TEST". Utiliza un campo project, el operador EQUALS y el valor "TEST".

Una consulta más compleja podría ser:

                     project = "TEST" AND assignee = currentUser()

Esta consulta encontrará todos los problemas en el proyecto "TEST" donde el gestor asignado es el usuario que actualmente conectado. Utilizar el campo project, el operador EQUALS, el valor "TEST", la palabra clave "AND" y la función currentUser().

Para más información sobre campos, operadores, palablas clave y funciones, podemos consultar el cuadro siguiente:

Image Added_{Fuente: Atlassian Documentation [Jira Service Desk Server 4.7]}

Prioridad en consultas JQL

La precedencia en las consultas JQL depende de las palabras clave que utilicemos para conectar nuestras cláusulas (una cláusula es, por ejemplo, project = "Equipos en el espacio"). La forma más sencilla de ver esto es tratar la palabra clave AND como la única que agrupa las cláusulas y OR como la que las separa. La palabra clave AND tiene prioridad sobre otras palabras clave, porque agrupa cláusulas juntas, esencialmente convirtiéndolas en una cláusula combinada.

Ejemplo 1:

           status = resolved AND project = "Equipos en el espacio" OR assignee = ctarazon

Esta consulta devolverá todas las solicitudes resueltas del proyecto "Equipos en el espacio" (cláusulas agrupadas por AND), y también todas las solicitudes existentes asignados al gestor ctarazon.

Ejemplo 2:

           status = resolved OR project = "Equipos en el espacio" AND assignee = ctarazon

Esta consuta, por otro lado, devolverá las solicitudes de ctarazon del proyecto "Equipos en el espacio" (cláusulas agrupadas por AND), y también todas las solicitudes resueltas existentes (una cláusula separada por OR).

Ejemplo 3:

           status = resolved OR project = "Equipos en el espacio" OR assignee = ctarazon

Cuando únicamente utilizamos la palabra clave OR, todas las cláusulas se tratarán como separadas e iguales en términos de precedencia.

Establecer la precedencia

Podemos establecer la precedencia en nuestras consultas JQL utilizando paréntesis. Los paréntesis agruparán ciertas cláusulas juntas y harán cumplir la precedencia.

Ejemplo 1:

Como podemos visualizar a continuación, los paréntesis pueden cambiar nuestra consulta JQL de ejemplo. Esta consulta devolvería solicitudes resueltas que pertenecen al proyecto "Equipos en el espacio" o que están asignados a ctarazon.

           status = resolved AND (project = "Equipos en el espacio" OR assignee = ctarazon)

Ejemplo 2:

Si utilizamos paréntesis como en el siguiente ejemplo, no tendrían ningún efecto, porque las cláusulas entre paréntesis ya estaban conectadas por AND. Esta consulta devovería los mismos resultados con o sin paréntesis.

           (status = resolved AND project = "Equipos en el espacio") OR assignee = ctarazon

Palabras y caracteres reservados

Caracteres reservados

JQL tiene una lista de caracteres reservados:

Image Added

Si deseamos utilizar estos caracteres en consultas, deberemos:

• rodearlos con comillas (podemos utilizar comillas simples (') o comillas dobles ("));
• Si estamos buscando un campo de texto y el carácter está en la lista de caracteres especiales en las búsquedas de texto, deberemos precederlos con dos barras invertidas. Esto nos permitirá ejecutar la consulta que contiene un carácter reservado, pero el carácter en si se ignorará en la consulta.

Por ejemplo:

version = "[ejemplo]"

resumen ~ "\\ [ejemplo \\]"

Palabras reservadas

JQL también tiene una lista de palabras reservadas. Estas palabras deben ir entre comillas (simples o dobles) si deseamos utilizarlas en consultas:

"abort", "access", "add", "after", "alias", "all", "alter", "and", "any", "as", "asc", "audit", "avg", "before", "begin", "between", "boolean", "break", "by", "byte", "catch", "cf", "char", "character", "check", "checkpoint", "collate", "collation", "column", "commit", "connect", "continue", "count", "create", "current", "date", "decimal", "declare", "decrement", "default", "defaults", "define", "delete", "delimiter", "desc", "difference", "distinct", "divide", "do", "double", "drop", "else", "empty", "encoding", "end", "equals", "escape", "exclusive", "exec", "execute", "exists", "explain", "false", "fetch", "file", "field", "first", "float", "for", "from", "function", "go", "goto", "grant", "greater", "group", "having", "identified", "if", "immediate", "in", "increment", "index", "initial", "inner", "inout", "input", "insert", "int", "integer", "intersect", "intersection", "into", "is", "isempty", "isnull", "join", "last", "left", "less", "like", "limit", "lock", "long", "max", "min", "minus", "mode", "modify", "modulo", "more", "multiply", "next", "noaudit", "not", "notin", "nowait", "null", "number", "object", "of", "on", "option", "or", "order", "outer", "output", "power", "previous", "prior", "privileges", "public", "raise", "raw", "remainder", "rename", "resource", "return", "returns", "revoke", "right", "row", "rowid", "rownum", "rows", "select", "session", "set", "share", "size", "sqrt", "start", "strict", "string", "subtract", "sum", "synonym", "table", "then", "to", "trans", "transaction", "trigger", "true", "uid", "union", "unique", "update", "user", "validate", "values", "view", "when", "whenever", "where", "while", "with"

Realizar búsquedas de texto

Podemos utilizar las funciones de búsqueda de texto de Lucene al realizar búsquedas en los siguientes campos, utilizando el operador CONTAINS:

Resumen, Descripción, Entorno, Comentarios, campos personalizados que utilizan el "Buscador de texto libre" (es decir, campos personalizados de los siguientes tipos de campos personalizados integrados: Campo de texto libre, Campo de texto, Campo de texto de solo lectura).

Para obtener más información consultaremos la página de 5.1.- Sintaxis para búscar campos de texto.

Cambiar la vista de los resultados de búsqueda

Hemos elaborado los criterios de búsqueda Hemos elaborado los criterios de búsqueda y hemos realizado la búsqueda. Los resultados de nuestra búsqueda se mostrarán en el navegador de Solicitudes. El navegador de Solicitudes nos permite cambiar cómo se muestran los resultados de la búsqueda. Por ejemplo, es posible que deseemos destaacar los problemas de alta prioridad, ordenar ascendente/descendente de una columna, ocultar ciertos campos...

• Cambiar el orden de clasificación: pulsaremos sobre el nombre de la columna, pulsaremos una segunda vez para cambiar el orden.
• Mostrar/ocultar columnas: pulsaremos sobre la opción [Columnas] y elegiremos las columnas deseadas.

Image RemovedImage Added

Trabajar con los resultados de la búsqueda

...

• Visualizar la Solicitud: pulsaremos sobre la Clave o el Asunto de la Solicitud.
• Acciones sobre las Solicitudes individuales: pulsaremos sobre [···] junto a la fila de Solicitudes y selecionaremos una opción del menú que nos muestra.

Image RemovedImage AddedTodas las solicitudes en los resultados de la búsqueda:

• Exportar los resultados de la búsqueda a diferentes formatos, como Excel y XML: pulsaremos sobre la opción [Exportar] de la parte superior derecha de la pantalla y seleccionaremos el formato deseado.
• Compartir los resultados de la búsqueda: pulsaremos sobre la opción [Compartir] y luego introduciremos los detalles del destinatario.
• Crear una fuente RSS: pulsaremos sobre la opción [Exportar] [RSS (Comunicaciones)] o [RSS (Comentarios)].
• Modificación masiva de Solicitudes en los resultados de búsqueda: pulsaremos sobre la opción [Herramientas] y selecionar seleccionar todos los <n> comunicaciones en cambio masivo.

...

Si ejecutamos con frecuencia la misma búsqueda, podemos guardar los criterios de búsqueda como un filtro. Esto nos evitará tener que redefinir re definir manualmente los criterios de búsqueda cada vez. Las aplicaciones de JIRA también incluyen una serie de filtros de sistema predefinidos para consultas comunes: Mis problemas abiertos, Notificado por mi, Vistos recientemente, Todos los problemas, ...

Para guardar nuestra búsqueda como un filtro: En la página de resultados de la búsqueda pulsaremos sobre la opción [Guardar como] e introducir un nombre para el filtro. Nuestro nuevo filtro se mostrará en el panel izquierdo con nuestros otros filtros favoritos, los filtros compartidos con nosotros y los filtros del sistema. Para ejecutar un filtro, simplemente pulsaremos sobre él.

...