Capítulo 10. Informes

Tabla de contenidos

10.1. Informes personalizados
10.1.1. Agregar informe personalizado
10.1.2. Editar Informes Personalizados
10.1.3. Ejecutar informes personalizados
10.2. Informes estadísticos
10.2.1. Estadísticas de adquisiciones
10.2.2. Estadística de usuarios
10.2.3. Estadísticas del catálogo
10.2.4. Estadísticas de circulación
10.2.5. Estadísticas de publicaciones periódicas
10.2.6. Estadísticas de reservas
10.2.7. Usuarios con más préstamos
10.2.8. Ítems con más préstamos
10.2.9. Usuarios sin préstamos
10.2.10. Ítems no prestados nunca
10.2.11. Catálogo por tipo de ítem
10.2.12. Ítems perdidos
10.2.13. Promedio de tiempo de préstamo
10.3. Diccionario de informes

Los informes en Koha es una manera de reunir datos. Los informes se usan para generar estadísticas, listas de miembros, listas de ubicaciones, o cualquier listado de datos en su base de datos.

10.1. Informes personalizados

Los datos en Koha se almacenan en una base de datos MySQL lo cual significa que los bibliotecarios pueden generar casi cualquier informe que deseen ya sea usando el Asistente de informes guiados o escribiendo su propia consulta SQL.

10.1.1. Agregar informe personalizado

10.1.1.1. Asistente guiado para informes

El asistente guiado de informes le guiará a través de un proceso de seis pasos para generar un informe.

Paso 1: Elegir el módulo sobre el que desea elaborar el informe. Esto determinará qué tablas y campos están disponibles para que usted haga la consulta.

'Informe es público' debería dejarse por defecto como 'No' en la mayoría de los casos. Un informe puede hacerse público si tiene la intención de permitir el acceso al mismo a través de la interfaz de servicio web JSON. Este es un sistema que puede ser utilizado por los desarrolladores para hacer presentaciones personalizadas de los datos del informe, por ejemplo mostrándolos usando una API gráfica. Para obtener más información hable con su desarrollador local.

  • Un informe público es accesible vía una URL del tipo: http://MYOPAC/cgi-bin/koha/svc/report?id=REPORTID

Sugerencia

Si su administrador de sistemas ha configurado memcache en su servidor podrá ver una opción más en expiración de la caché. Esto está relacionado con sus informes públicos. Si usted hace público el informe entonces este se ejecuta continuamente y causará una gran carga en el sistema. Configurando este valor se evita esto.

Paso 2: Elegir un tipo de informe. Por ahora, la única opción disponible es tabular.

Paso 3: Elegir los campos que desea en su informe. Puede seleccionar varios campos y agregar todos a la vez mediante el uso de CTRL+Clic en cada ítem que desee agregar, antes de hacer clic en el botón Agregar.

Paso 4: Elegir los límites donde desea aplicar su informe (como los tipos de ítems o sedes). Si no desea aplicar límites, simplemente haga clic en Siguiente en vez de elegir una opción.

Paso 5: Realizar funciones matemáticas. Si no quiere hacer ningún cálculo, simplemente haga clic en Siguiente en vez de elegir una opción.

Paso 6: Seleccionar orden de los datos. Si desea que los datos estén en el orden que se encontraban en la base de datos, simplemente haga clic en Finalizar.

Cuando termine se mostrar el SQL generado por el asistente de informes. Desde aquí se puede optar por guardar el informe haciendo clic en 'Guardar' o copiar el código SQL y realizar modificaciones a mano.

If you choose to save the report you will be asked to name your report, sort it in to groups and subgroups and enter any notes regarding it.

Una vez que se ha guardado el informe, este aparecerá en la página 'Usar guardado' junto a los demás informes guardados.

From here you can make edits, run the report, or schedule a time to have the report run. To find the report you created you can sort by any of the columns by clicking the on the column header (creation date is the best bet for finding the report you just added). You can also filter your results using the filter menu on the left or use the tabs to find reports based on your custom groups.

10.1.1.2. Informe con SQL

Además del asistente de informes, usted tiene la opción de escribir sus propias consultas en SQL. Para encontrar los informes escritos por otros usuarios de Koha, visite el Wiki de Koha: http://wiki.koha-community.org/wiki/SQL_Reports_Library. También puede encontrar la estructura de su base de datos en /installer/data/mysql/kohastructure.sql o en línea en: http://schema.koha-community.org.

To add your query, click the link to 'Create from SQL' on the main reports module or the 'New report' button at the top of the 'Saved reports' page.

Cumplimente el formulario presentado

  • The 'Name' is what will appear on the Saved Reports page to help you identify the report later. It will also be searchable using the filters found the left of the Saved Reports page.

  • Usted puede utilizar el "grupo Informe' para organizar sus informes para que pueda filtrar fácilmente los informes de grupos. Los grupos de informes se establecen en la categoría de valores autorizados REPORT_GROUP o se pueden añadir al vuelo al crear el informe seleccionado el botón 'o crear'.

    • Sugerencia

      Si va a añadir un grupo de informes sobre la marcha, recuerde que el código debe tener menos de 10 caracteres y no debe contener caracteres especiales o espacios.

    .

  • Usted puede utilizar 'Subgrupo Informe' para organizar aún más sus informes para que pueda filtrar fácilmente los informes de los grupos y subgrupos. Los subgrupos de informes se establecen en la categoría de valores autorizados REPORT_SUBGROUP o se pueden añadir sobre la marcha al crear el informe eligiendo la opción 'o crear'.

    • Sugerencia

      Si va a añadir un subgrupo informe sobre la marcha, recuerde que el código debe tener menos de 10 caracteres y no debe contener caracteres especiales o espacios.

  • 'Informe es público' debería dejarse por defecto como 'No' en la mayoría de los casos. Un informe puede hacerse público si tiene la intención de permitir el acceso al mismo a través de la interfaz de servicio web JSON. Este es un sistema que puede ser utilizado por los desarrolladores para hacer presentaciones personalizadas de los datos del informe, por ejemplo mostrándolos usando una API gráfica. Para obtener más información hable con su desarrollador local.

    • Un informe público es accesible vía una URL del tipo: http://MYOPAC/cgi-bin/koha/svc/report?id=REPORTID

  • 'Notes' will also appear on the Saved Reports page, this can be used to provide more details about the report or tips on how to enter values when it runs

  • El tipo debe ser siempre 'Tabular' en este momento ya que los otros formatos no se han implementado todavía

  • In the 'SQL' box you will type or paste the SQL for the report

  • Si usted cree que su informe puede consumir demasiados recursos podría considerar el uso de parámetros de ejecución de la consulta. Los parámetros en tiempo de ejecución básicamente hacen que aparezca un filtro antes de que se ejecute el informe con el fin de ahorrar recursos a su sistema.

    Existe una sintaxis específica que Koha entenderá como 'pedir valores al ejecutar el informe'. La sintaxis es <<Pregunta|valores_autorizados>>.

    • Los << y >> son solo delimitadores. Usted deberá poner << al principio y >> al final de sus parametros

    • La 'Pregunta' se mostrará a la izquierda de la cadena para ingresar.

    • El authorized_value se puede omitir si no es aplicable. Si contiene una categoría de valor autorizado, o sitios o itemtype o categorycode, se mostrará una lista con los valores autorizados de Koha en lugar de un campo libre. Note que se puede tener más de un parámetro en una SQL dada. Tenga en cuenta que no introduce nada en tiempo de ejecución probablemente no funcione como espera. Se considerará como "valor vacío", no como "ignorar este parámetro". Por ejemplo si no introduce nada en: "title=<<Introduzca título>>" mostrará los resultados con el título=" (no titulo). Si quiere tener algo no obligatori, use "title like <<Introduza título>>" e introduzca un % en el tiempo de ejecucion en vez de nada

    Ejemplos:

    • SELECT surname,firstname FROM borrowers WHERE branchcode=<<Introduzca usuarios de biblioteca|branches>> AND surname like <<Introduzca filtro para nombre de usuario(% si ninguno)>>

    • SELECT * FROM items WHERE homebranch = <<Elija su sucursal|branches>> and barcode like <<Valor parcial del código de barras aquí>>

    Sugerencia

    Para generar un selector de fechas de calendario a la derecha del campo cuando se ejecuta un informe, puede utilizar la palabra clave 'date' como esta: <<Introduzca fecha|date>>

    Sugerencia

    Debe poner "%" en la caja de texto y 'dejarlo en blanco'. De otra manera, literalmente buscará "" (cadena vacía) como el valor para el campo.

    Importante

    Además de utilizar cualquier código de valor autorizado para generar un menú desplegable, se pueden utilizar los siguientes valores, así: Sucursales (branches), Tipo de ítems (itemtypes) y Categoría de usuario (categorycode). Por ejemplo un menú desplegable generará algo como esto <<Sucursal|branches>>

Nota

There is a limit of 10,000 records put on SQL statements entered in Koha. To get around this you want to add 'LIMIT 100000' to the end of your SQL statement (or any other number above 10,000).

Sugerencia

Si su administrador de sistemas ha configurado memcache en su servidor podrá ver una opción más en expiración de la caché. Esto está relacionado con sus informes públicos. Si usted hace público el informe entonces este se ejecuta continuamente y causará una gran carga en el sistema. Configurando este valor se evita esto.

Una vez que todo se ha introducido dé clic en el botón 'Guardar informe' y se le presentará con opciones para ejecutarlo. Una vez que el informe se guarda usted no tiene que volver a crearlo sólo tiene que buscarlo en la página Informes guardados y ejecutarlo o editarlo.

10.1.1.3. Duplicar informe

Los informes también se pueden añadir mediante la duplicación de un informe existente. Visite la página de los 'Informes guardados' para ver la relación de todos los informes en su sistema.

A la derecha de cada informe hay un enlace 'Duplicar' en la columna 'SQL guardado. Haga clic en ese enlace 'Duplicar' para utilizar un informe existente como base para su nuevo informe. Eso llenará el formulario del nuevo informe con el SQL existente para facilitar la edición y volver a guardar.

10.1.2. Editar Informes Personalizados

Cada informe se puede editar yendo a la lista de los informes. Para ver la lista de informes que ya está almacenada en Koha, haga clic en 'Usar guardados'.

To find the report you'd like to edit you can sort by any of the columns by clicking the on the column header. You can also filter your results using the filter menu on the left or use the tabs to find reports based on your custom groups.

From this list you can edit any custom report by clicking 'Edit' in the 'Saved SQL' column.

10.1.3. Ejecutar informes personalizados

Once custom reports are saved to Koha, you can run them by going to the Saved Reports page and clicking the 'Run' link to the right of the report.

Cuando se ejecuta el infome se le pedirá algunos valores

o verá los resultados enseguida

Desde los resultados se puede optar por volver a ejecutar el informe haciendo clic en 'Ejecutar informe' en la parte superior, modificar el informe haciendo clic en el botón 'Editar' o empezar de nuevo y crear un informe nuevo mediante el botón 'Nuevo'. También puede descargar los resultados seleccionando un tipo de archivo en la parte inferior de los resultados junto a la etiqueta 'Descargar el informe' y hacer clic en 'Descargar'.

Sugerencia

Un archivo de texto separado por comas es un archivo CSV y puede ser abierto por cualquier aplicación de hoja de cálculo.