...

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

...

Los términos de búsqueda que reconoce la búsqueda rápida son:

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

Búsqueda básica

La búsqueda básica proporciona una interfaz fácil de utilizar que nos permite definir consultas complejas, sin necesidad de saber cómo utilizar JQL (búsqueda avanzada).

• 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 existen criterios de búsqueda, pulsaremos sobre el botón [Filtro nuevo] para establecer los criterios de búsqueda.
• Si se muestra la búsqueda avanzada en lugar de la búsqueda básica, pulsaremos en Básica (junto al botón de ).

Introduciremos los criterios para la búsqueda. Podemos buscar en campos específicos y/o buscar texto específico.

• 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 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.

Ejecutando una búsqueda guardada

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 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 al pulsar sobre Vistas Recientemente, pasará a la búsqueda avanzada, ya que la búsqueda básica no puede representar la cláusula ORDER BY en este filtro.

Búsqueda avanzada

La búsqueda avanzada nos permite crear consultas estructuradas utilizando Jira Query Language (JQL) para buscar solicitudes. Podemos especificar criterios que no se pueden definir en las búsquedas rápidas o básicas (por ejemplo, cláusula ORDER BY).

Si no tenemos criterios de búsqueda complejos, es posible que deseemos utilizar la búsqueda rápida en su lugar.

Si no nos sentimos cómodos con Jira Query Language (JQL), es posible que deseemos utilizar la búsqueda básica en su lugar.

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

Image Added

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

• Si existen criterios de búsqueda, pulsaremos sobre el botón [Filtro nuevo] para establecer los criterios de búsqueda.
• Si se muestra la búsqueda avanzada en lugar de la búsqueda básica, pulsaremos en Básica (junto al botón de Image Added).

Introduciremos nuestra consulta JQL. A medida que escribimos, Jira nos ofrecerá una lista de sugerencias de "autocompletar" basadas en el contexto de nuestra consulta. Debemos tener en cuenta que las sugerencias de autocompletar solo incluyen las primeras 15 coincidencias, que se mostrarán alfabéticamente, por lo que es posible que debamos introducir más texto si no podemos encontrar una coincidencia.

Los siguientes puntos nos ayudarán a aprender cómo aprovechar al máximo la búsqueda avanzada:

Construyendo consultas JQL

Una consulta simple en JQL (también conocida como cláusula) consta de un campo, 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

...

• 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.

...