Capítulo 17. Cron Jobs

Tabla de contenidos

17.1. Cron Jobs
17.1.1. Buscar
17.1.2. Circulación
17.1.3. Usuarios
17.1.4. Mensajeria
17.1.5. Cesta de libros/en proceso
17.1.6. Catálogo
17.1.7. OPAC
17.1.8. Administración del sistema
17.1.9. Adquisiciones
17.1.10. Scripts no aprobados

A cron job is a Linux command for scheduling a command or script on your server to complete repetitive tasks automatically. Scripts executed as a cron job are typically used to modify files or databases; however, they can perform other tasks that do not modify data on the server, like sending out email notifications. Koha has many cron jobs in place that you can enable (search engine indexing, overdue notice generation, data cleanup and more), this chapter will explain those for you.

17.1. Cron Jobs

Las ubicaciones que se mencionan asumen una instalación dev que coloca los crons en misc/, si su instalación es estándar puede localizar estos archivos en bin/ en caso que no pudiese encontrarlos en misc/

17.1.1. Buscar

17.1.1.1. Volver a generar índice

Ruta del script: misc/migration_tools/rebuild_zebra.pl

Qué hace: Actualiza los índices de Zebra con los datos recientemente modificados.

Requerido por: Zebra

Frecuencia sugerida: cada x minutos, (entre 5-15 minutos), dependiendo de las necesidades de rendimiento

17.1.2. Circulación

17.1.2.1. Cola de reservas

Ruta del script: misc/cronjobs/holds/build_holds_queue.pl

Qué hace: Actualiza el informe de cola de reservas

Requerido por: Informe de cola de reservas

Frecuencia sugerida: cada 1-4 horas

Descripción:

  • Un script que se debe ejecutar periódicamente si su sistema de bibliotecas permite a los usuarios hacer reservas. Este script decide qué biblioteca debe ser responsable del cumplimiento de una solicitud de reserva dada.

    Este comportamiento está controlado por las preferencias del sistema StaticHoldsQueueWeight y RandomizeHoldsQueueWeight.

    Si no se desea que todas las bibliotecas participen en el proceso de satisfacer reservas, se deberán incluir las bibliotecas que *sí* participan introduciendo los códigos de sucursal de todas las bibliotecas participantes, separados por comas (por ejemplo "MPL,CPL,SPL,BML" etc.).

    Por defecto, la cola de reservas se generará de manera que el sistema intentará primero satisfacer la reserva con los ítems disponibles en la biblioteca recogida si es posible. Si no hay ítems disponibles en la biblioteca de recogida para satisfacer la reserva, build_holds_queue.pl utilizará la lista de bibliotecas definidas en StaticHoldsQueueWeight. Si RandomizeHoldsQueueWeight está desactivado (el que está por defecto), el script asignará solicitudes de satisfacción en el orden de las sucursales indicado en la preferencia del sistema StaticHoldsQueueWeight.

    Por ejemplo, si su sistema cuenta con tres bibliotecas, de diferentes tamaños ( pequeño, mediano y grande ) y quiere que la carga de cumplimiento esté en las bibliotecas más grandes más que en las bibliotecas más pequeñas, usted querría que StaticHoldsQueueWeight fuese algo así "LRG,MED,SML".

    Si quiere que la carga de cumplimiento se extienda por igual por todas las bibliotecas del sistema, sólo tiene que activar RandomizeHoldsQueueWeight. Cuando esta preferencia del sistema está activada, el orden en el que las bibliotecas se les pedirá que satisfagan una reserva se asignará aleatoriamente cada vez que se vuelve a generar la lista.

    Entonces dejar StaticHoldsQueueWeight vacío está contraindicado. Si lo hace, hará que el script build_holds_queue ignore RandomizeHoldsQueueWeight, provocando que el script solicite que se satisfaga las reservas no al azar, sino por orden alfabético.

17.1.2.1.1. Documentación Perl

GetBibsWithPendingHoldRequests

my $biblionumber_aref = GetBibsWithPendingHoldRequests();

Devuelve una arrayref con los biblionumbers de todos los registros bibliográficos que tienen una o más solicitudes de reservas

GetPendingHoldRequestsForBib

my $requests = GetPendingHoldRequestsForBib($biblionumber);

Devuelve una arrayref de las hashsrefs pendientes, de solicitudes de reservas no cubiertas

el registro bibliográfico identificado por $biblionumber. Las siguientes claves están presentes en cada hashref:

  • biblionumber

  • borrowernumber

  • itemnumber

  • priority

  • branchcode

  • reservedate

  • reservenotes

  • borrowerbranch

La arrayref se ordena por prioridad ascendente.

GetItemsAvailableToFillHoldRequestsForBib

my $available_items =

GetItemsAvailableToFillHoldRequestsForBib($biblionumber);

Devuelve una arrayref de ítems disponibles para cubrir las solicitudes de reserva para el bibliográfico identificado por $biblionumber. Un ítem está disponible para completar una solicitud de reserva

si y sólo si:

  • no está préstado

  • que está retirado

  • no está marcado como 'no se presta'

  • actualmente no está en tránsito

  • no está perdido

  • no está colocado en la estantería de reservas

MapItemsToHoldRequests

MapItemsToHoldRequests($hold_requests, $available_items);

CreatePickListFromItemMap

AddToHoldTargetMap

_get_branches_to_pull_from

Preferencia del sistema sobre consultas para obtener la lista ordenada de sucursales a utilizar para cubrir las solicitudes de reservas.

17.1.2.2. Reservas caducadas

Ruta del script: misc/cronjobs/holds/cancel_expired_holds.pl

Qué hace: Por defecto este cron job cancelará automáticamente las reservas donde los usuarios han establecido fechas de caducidad. Si la biblioteca está usando las preferencias ExpireReservesMaxPickUpDelay y ExpireReservesMaxPickUpDelayCharge entonces este script también cancelará las reservas que llevan situadas en la estantería de reservas mucho tiempo y (si la biblioteca lo hace) cobrará al usuario por no recoger las reservas.

Frecuencia sugerida: diaria

17.1.2.3. Reservas no suspendidas

Ruta del script: misc/cronjobs/holds/auto_unsuspend_holds.pl

Qué hace: Este script busca reservas que no deberían estar más tiempo suspendidas y elimina la suspensión si la preferencia AutoResumeSuspendedHolds está establecidas a 'permitir'. Esto pone de nuevo a los socios a la cola donde estaban cuando las reservas fueron suspendidas.

Frecuencia sugerida: diaria

17.1.2.4. Las multas

Ruta del script: misc/cronjobs/fines.pl

Qué hace: Calcula y fija las multas en las cuentas de los usuarios

Requerido por: la preferencia del sistema finesMode

Frecuencia sugerida: todas las noches

17.1.2.5. Vencimientos prolongados

Ruta del script: misc/cronjobs/longoverdue.pl

Qué hace: permite especificar los retrasos para que los ítems cambien a estado de perdidos, y opcionalmente cobrar el precio de sustitución en el registro del ítem.

Frecuencia sugerida: todas las noches

17.1.2.5.1. Documentación Perl

NOMBRE

script cron longoverdue.pl para establecer estados perdidos en los materiales atrasados. Ejecutar sin opciones para obtener ayuda.

17.1.2.6. Seguimiento de total de préstamos

Ruta del script: misc/cronjobs/update_totalissues.pl

Qué hace: Actualiza el campo biblioitems.totalissues en la base de datos con el último total de préstamos.

Frecuencia sugerida: todas las noches

17.1.2.6.1. Documentación Perl

NOMBRE

update_totalissues.pl

SINOPSIS

update_totalissues.pl --use-stats

update_totalissues.pl --use-items

update_totalissues.pl --commit=1000

update_totalissues.pl --since='2012-01-01'

update_totalissues.pl --interval=30d

DESCRIPCIÓN

Este batch job rellena el contador de total de fondos de registros bibliográficos sobre la base del histórico de estadísticas de fondos.

--help Imprime esta ayuda

-v|--verbose

Proporciona información prolija del registro de logs (lista cada bibliográfico modificado).

--use-stats

Utilice los datos de la tabla de estadísticas para rellenar el total de fondos.

--use-items

Utilizar los datos de items.issues para cumplimentar los fondos totales. Tenga en cuenta que los datos de fondos de la tabla items no respeta, por definición las opciones --since o --interval. También tenga en cuenta que si se especifica ambos --use-stats y --use-items, el contador de registros bibliográficos procesados llevará a conclusiones erróneas.

-s|--since=FECHA

Solo procesa los fondos registrados en la tabla statistics desde FECHA.

-i|--interval=S

Solo proces los fondos registrados en la tabla statistics en la última N unidades de tiempo. El intervalo debe consistir en un número con una unidad de sufijo de una sola letra. Los sufijos son válidos h (horas), d (día), w (semanas), m (mes), e y (años). La unidad por defecto es de día.

--incremental

Añade el número de fondos que se encuentran en la tabla statistics para el recuento del total de fondos existentes. Se intenta así que este script se puede utilizar como un cron job para actualizar la información de popularidad durante los períodos de baja utilización. Si no se especifica ni --since, ni --interval, el modo incremental se toma por defecto para el procesamiento de las últimas veinticuatro horas.

--commit=N

Confirmar los resultados a la base de datos después de cada N registros procesados

--test

Solo probar el script de popularidad de la población.

ADVERTENCIA

Si la hora en su servidor de base de datos no coincide con la hora en el servidor Koha tendrá que tener esto en cuenta, y probablemente utilizar el argumento --since en vez de el argumento --interval para la actualización incremental.

CRÉDITOS

Este parche de Koha fue patrocinado por la Arcadia Public Library y la Arcadia Public Library Foundation en homenaje a Jackie Faust-Moreno, último director de la Arcadia Public Library.

AUTOR

Jared Camins-Esakov <jcamins AT cpbibliography DOT com>

17.1.2.7. Generación del fichero de usuarios para la circulación fuera de línea

Ruta del script: misc/cronjobs/create_koc_db.pl

Qué hace: Genera el archivo borrowers.db para usar con la herramienta de Circulación fuera de línea de Koha

Frecuencia sugerida: semanal

17.1.3. Usuarios

17.1.3.1. Registros no verificados

Ruta del script: misc/cronjobs/delete_expired_opac_registrations.pl

Qué hace: Elimina los registros de usuarios enviados a través del OPAC pero no han sido revisados por la biblioteca en el número de días introducido en la preferencia PatronSelfRegistrationExpireTemporaryAccountsDelay

Frecuencia sugerida: todas las noches

17.1.3.2. Registros no confirmados

Ruta del script: misc/cronjobs/delete_unverified_opac_registrations.pl

Qué hace: Elimina los auto-registros de usuarios enviados a través del OPAC, pero no confirmados vía correo electrónico en 24 horas. Esto es necesario únicamente si se está obligando a los usuarios que confirmen sus registros a través del correo electrónico con la preferencia PatronSelfRegistrationVerifyByEmail

Frecuencia sugerida: cada hora

17.1.3.3. Anonimizar datos de usuarios

Ruta del script: misc/cronjobs/advance_notices.pl

Qué hace: Se utiliza para anonimizar los datos de los usuarios. Esto eliminará los borrowernumbers del historial de circulación para que las estadísticas se mantienen, pero la información del usuario se elimina por razones de privacidad.

17.1.3.4. Actualizar usuario tipo niño a adulto

Script path: misc/cronjobs/j2a.pl

Qué hace: Convertir a los usuarios juveniles/niños de la categoría de usuarios juveniles y del código de categoría a la correspondiente categoría de usuario adulto y su código de categoría cuando ellos alcancen el límite superior definido en las Categorías de Usuarios.

Frecuencia sugerida: todas las noches

17.1.3.4.1. Documentación Perl

NOMBRE

juv2adult.pl - Convertir a los usuarios juveniles/niños de la categoría de usuarios juveniles y del código de categoría a la correspondiente categoría de usuario adulto y su código de categoría cuando ellos alcancen el límite superior definido en las Categorías de Usuarios.

SINOPSIS

juv2adult.pl [ -b=<branchcode> -f=<categorycode> -t=<categorycode> ]

Opciones:

--help mensaje de ayuda breve

--man documentación completa

-v modo verboso

-n no hacer nada, solo mostrar

-b <branchname> solo se ocupa de los usuarios de esta biblioteca/sucursal

-f <categorycode> cambiar categoría de usuario desde esta categoría

-t <categorycode> cambiar categoría de usuario a esta categoría

=head1 OPTIONS

--help Imprime un breve mensaje de ayuda y sale.

--man Imprime la página del manual y sale.

-v Verbose. Sin este atributo establecido, solo se reportan los errores fatales.

-n No Action. With this flag set, script will report changes but not actually execute them on the database.

-b changes patrons for one specific branch. Use the value in the branches.branchcode table.

-f *required* defines the juvenile category to update. Expects the code from categories.categorycode.

-t *required* defines the category juvenile patrons will be converted to. Expects the code from categories.categorycode.

DESCRIPCIÓN

Este script está diseñado para actualizar los usuarios tipos de usuario juvenil a adultos, retirar el garante, y actualizar sus códigos de categoría apropiada cuando llegan a la edad máxima definida en las Categorías de Usuarios.

EJEMPLOS DE USO

"juv2adult.pl" - Se sugiere que lea esta ayuda. :)

"juv2adult.pl" -b=<branchcode> -f=<categorycode> -t=<categorycode> - Procesa una sola sucursal, y actualiza las categorías de usuarios de fromcat to tocat.

"juv2adult.pl" -f=<categorycode> -t=<categorycode> -v -n - Procesa todas las sucursales, muestra todos los mensajes, e informa a los usuarios afectados. No hace nada en la base de datos.

17.1.4. Mensajeria

17.1.4.1. Cola de mensajes

Ruta al script: misc/cronjobs/process_message_queue.pl

Qué hace: procesa la cola de mensajes para enviar a los usuarios los correos electrónicos y mensajes SMS de préstamos, devoluciones y reservas cubiertas. Requiere que EnhancedMessagingPreferences esté activada

Frecuencia sugerida: 1-4 horas

Importante

Los ítems vencidos y los avisos de avances de vencimiento están controlados por el cron jobadvance_notices cron.

17.1.4.2. Aviso avanzado

Ruta del script: misc/cronjobs/advance_notices.pl

Qué hace: prepara avisos "pre-due" y avisos "item due" para los usuarios de los ítems vencidos o que vencen pronto. Requiere que EnhancedMessagingPreferences esté activada

Frecuencia sugerida: todas las noches

Nota

Este script no envía realmente los avisos. Los coloca en cola de mensajes para más tarde

17.1.4.2.1. Documentación Perl

NOMBRE

advance_notices.pl - script cron para poner los recordatorios de ítem vencido en la cola de mensajes

SINOPSIS

./advance_notices.pl -c

o, en la tabla de cron: 0 1 * * * advance_notices.pl -c

DESCRIPCIÓN

Este script prepara recordatorios de pre-vencimiento y de ítems vencidos para enviar a los usuarios. Los coloca en la cola de mensajes, los cuales son procesados por el cronjob process_message_queue.pl. El tipo de mensaje y el momento de ejecución puede ser configurado por los usuarios en sus pestañas de "Mis Alertas" en el OPAC.

MÉTODOS

parse_letter

17.1.4.3. Aviso de retraso

Ruta del script: misc/cronjobs/overdue_notices.pl

Qué hace: prepara los mensajes para alertar a los usuarios de mensajes de retrasos (ambas vías correo electrónico e impresión)

Frecuencia sugerida: todas las noches

Nota

Este script no envía realmente los anuncios. Los coloca en la cola de mensajes para más tarde o genera el código HTML para su posterior impresión

17.1.4.3.1. Documentación Perl

NOMBRE

overdue_notices.pl - prepara los mensajes para ser enviados a los usuarios con ítems retrasados

SINOPSIS

overdue_notices.pl [ -n ] [ -library <branchcode> ] [ -library <branchcode>...] [ -max <number of days> ] [ -csv [ <filename> ] ] [-itemscontent <field list> ]

Opciones:

-help mensaje de ayuda breve

-man documentación completa

-n No se enviará correo electrónico

-max <días> número máximo de días de retraso antes de gestionarlo

-library <nombre_sucursal> solo se ocupa de los retrasos de esta biblioteca (repetible : se pueden proporcionar varias bibliotecas)

-csv <nombre_archivo> llenar archivo CSV

-html <nombre_archivo> Salida html a archivo

-itemscontent <lista de campos> información de ítem en plantillas

-borcat <código_categoría> categoría del código que debe incluirse

-borcatout <código_categoría> categoría del código que debe excluirse

OPCIONES

-help Imprime un breve mensaje de ayuda y sale.

-man Imprime la página del manual y sale.

-v Verbose. Sin este atributo establecido, solo se reportan los errores fatales.

-n No envía ningún correo electrónico. Los avisos de retrasos que hubieran sido enviados a usuarios o administradores se imprimen en la salida estándar. Los datos CSV (si se ha seleccionado el atributo -csv) se escriben en la salida estándar o en el archivo csv dado.

-max Los ítems anteriores a un número de días índicado se asume serán manejados en otro sitio, probablemente por el script longoverdues.pl. Ellos son ignorados por este programa. No se envían avisos, y no se añaden a ningún archivos CSV. El valor predeterminado es 90 para que coincida con longoverdues.pl.

-library

selecciona vencimientos de una biblioteca específica. Usa el valor de la tabla branches.branchcode. Esta opción se puede repetir con el fin de seleccionar vencimientos para un grupo de bibliotecas.

-csv Genera datos CSV. si el atributo -n (no correo electrónico) está definida, entonces estos datos CSV se envía a la salida estándar o al archivo cuyo nombre se proporciona. De lo contrario, sólo los vencimientos que no pudieron ser enviados por correo electrónico se envían en formato CSV para la administración.

-itemscontent

lista de campos separados por comas que se sustituyen en las plantillas en lugar de los comodines <<items.content>>. Esto se incumple para issuedate,title,barcode,author

Otros valores posibles proceden de campos en las tablas biblios,items e issues.

-borcat Campo repetible, que permite seleccionar solo unos cuantas categorías de usuarios.

-borcatout

Campo repetible, que permite excluir algunas categorías de usuarios.

-t | --triggered

Esta opción causa que se genere un aviso si y solamente si un ítem está retrasado el número de días indicado

Por defecto, se envía un aviso cada vez que se ejecute el script, lo cual es adecuado para las ejecuciones menos frecuentes del script, pero requiere de la sincronización de disparadores de aviso con el cron programado para garantizar un comportamiento adecuado. Agregar la opción --triggered para ejecutar el cron diariamente, con el riesgo de no generar avisos si falla la ejecución del cron a la hora programada .

-list-all

Los items.content predeterminados listan solamente aquellos ítems que están en el rango de los avisos procesados actualmente. Seleccione -list-all para incluir todos los ítems retrasados en el listado (limitado por el atributo -max).

DESCRIPCIÓN

Este script está diseñado para alertar a los usuarios y administradores de los ítems atrasados​​.

Configuración

Este script atiende a la configuración de aviso de retrasos en la sección de "Disparadores de avisos de retraso/estado" en el área de "Herramientas" de la interfaz del bibliotecario en Koha. Allí puede elegir qué plantilla de carta se enviará después de configurar un número de días para los usuarios de cada biblioteca. Más información acerca del uso de esta sección de Koha está disponible en el manual de Koha.

Las plantillas usadas para elaborar los correos electrónicos se definen en la sección "Herramientas: Avisos" de la interfaz del personal en Koha.

Correos electrónicos salientes

Normalmente los mensajes se preparan para cada usuario con sus ítems atrasados. Para los usuarios que no disponen de correo electrónico en su registro, los mensajes son recopilados y enviados como archivos adjuntos en un solo correo electrónico a cada administrador, o si no está establecido, se envía al correo electrónico incluido en la preferencia del sistema "KohaAdminEmailAddress".

Estos correos electrónicos se colocan en la cola de mensajes salientes, como ocurre con los mensajes producidos por otras funcionalidades de Koha. Esta cola de mensajes debe ser procesada regularmente por el programa misc/cronjobs/process_message_queue.pl.

En el caso que se pase el atributo "-n" en este programa, no se envían correos electrónicos. En vez de eso, este programa envía los mensajes a la salida estándar. Pueden ser redirigidos a un archivo si se desea.

Plantillas

Las plantillas pueden incluir variables encerradas en símbolos dobles de menor que y mayor que, así <<this>>. Estas variables serán reemplazadas con valores concretos de los ítems retrasados o el usuario puntual. Las variables disponibles son:

<<bib>>

el nombre de la biblioteca

<<items.content>>

una línea con cada ítem, cada línea conteniendo una lista de valores separados por tabulador de: título, autor, código de barras, fecha en cuestión

<<borrowers.*>>

cualquier campo de la tabla borrowers

<<branches.*>>

cualquier campo de la tabla branches

Salida CSV

La opción "-csv" del comando, permite especificar un archivo en formato CSV al que enviar como salida la información de los ítems retrasados.

Con la opción "-n", los datos acerca de todos los retrasos son escritos en un archivo. Sin esa opción únicamente se guardará la información de retrasos que haya sido imposible enviar a los usuarios. En otras palabras, este archivo CSV reemplaza los datos que son normalmente enviados al correo electrónico del administrador.

EJEMPLOS DE USO

"overdue_notices.pl" - En el uso más básico, con ningún argumento en la línea de comandos, todas las bibliotecas se procesan individualmente, y los avisos se preparan para todos los usuarios que tienen correo electrónico con los ítems retrasados. Los mensajes de los usuarios que no tienen correo electrónico son enviados en un solo archivo como adjunto al correo electrónico del administrador, o al correo electrónico definido en la preferencia del sistema KohaAdminEmailAddress.

"overdue_notices.pl -n -csv /tmp/overdues.csv" - no hay envíos de correos electrónicos y se alimenta /tmp/overdues.csv con la información acerca de todos los ítems retrasados.

"overdue_notices.pl -library PRINCIPAL max 14" - prepara avisos de retrasos de las últimas 2 semanas de la biblioteca PRINCIPAL.

VEA TAMBIÉN

El programa misc/cronjobs/advance_notices.pl permite enviar con antelación mensajes a los usuarios, antes de que sus ítems pasen a estar retrasados, para avisarles que sus ítems están a punto de vencer.

MÉTODOS INTERNOS

Estos métodos son internos de overdue_notices.pl.

parse_letter

analiza la plantilla de carta, en sustitución de los comodines con los datos específicos de este usuario, biblio o ítem

los parámetros denominados:

letter - requiere hashref

borrowernumber - requiere entero

substitute - opcional hashref de otros pares clave/valor que deben ser sustituidos en el contenido de la carta

devuelve el hashref "letter", con el contenido actualizado para reflejar las claves y valores sustituidas.

prepare_letter_for_printing

devuelve una cadena de texto apropiado para la impresion en el caso de que un aviso de retrasos no se envíe al correo electrónico del usuario. Dependiendo del formato de salida deseado, puede ser un cadena CVS o una representación legible para humanos del aviso.

parámetros requeridos:

letter

borrowernumber

parámetros opcionales:

outputformat

17.1.4.4. Impresión de avisos de reservas

Ruta del script: misc/cronjobs/gather_print_notices.pl

Qué hace: busca en la cola de mensajes avisos de reserva que no pasaron porque el usuario no tenía correo electrónico y genera un aviso impreso

Frecuencia sugerida: todas las noches

17.1.4.5. Talking Tech

Para obtener más información sobre la configuración de este producto de terceros vea Talking Tech Appendix.

17.1.4.5.1. Enviando archivo de avisos

Ruta del script: misc/cronjobs/thirdparty/TalkingTech_itiva_outbound.pl

Qué hace: Script que genera el archivo de notificaciones salientes Spec C para el sistema de notificaciones por teléfono Talking Tech i-tiva.

Requerida por: TalkingTechItivaPhoneNotification

Frecuencia sugerida: todas las noches

17.1.4.5.1.1. Documentación Perl

USO

TalkingTech_itiva_outbound.pl

TalkingTech_itiva_outbound.pl --type=OVERDUE -w 0 -w 2 -w 6 --output=/tmp/talkingtech/outbound.csv

TalkingTech_itiva_outbound.pl --type=RESERVE --type=PREOVERDUE --lang=FR

Script que genera archivos de notificaciones salientes Spec C para el sistema Talking Tech i-tiva phone.

--help -h

Imprime esta ayuda

-v Proporciona información prolija del registro de logs.

--output -o

Destino de archivo de notificaciones de salida (formato CSV). Si no se especifica un valor, la salida se vuelca en la pantalla.

--lang

Establece el idioma para todos los mensajes salientes. Los valores actualmente soportados son EN, FR y ES. Si no se especifica un valor, EN se utiliza por defecto.

--type

REQUERIDO. Establece qué tipos de mensajes se van a utilizar. Puede utilizarse varias veces, para especificar los tipos múltiples en un único archivo de salida. Los valores actualmente soportados son RESERVE, PREOVERDUE y OVERDUE. Si no se dan un valor, este script no producirá notificaciones salientes.

--waiting-hold-day -w

OPCIONAL para --type=RESERVE. Establece los días de espera para llamar después que una reserva se haya hecho. Utilice la opción tantas veces como se desee. Por ejemplo, pasando "-w 0 -w 2 -w 6" dará lugar a llamadas que estén en el día que las reservas fueron establecidas en una espera, 2 días después de la fecha de espera, y 6 días después. Vea los ejemplos anteriores. Si esta opción no se usa con --type=RESERVE, se harán las llamadas todos los días hasta que la reserva en espera sea recogida o cancelada.

--library-code --code -c

OPCIONAL El código fuente de la librería de los mensajes. El código de la librería es utilizado para agrupar avisos juntos para propósitos de consorcio y aplicados a configuraciones específicas de la biblioteca, tales como indicaciones a esos avisos. Este campo puede estar en blanco si todos los mensajes son de una sola biblioteca.

17.1.4.5.2. Archivo de avisos recibidos

Ruta del script: misc/cronjobs/thirdparty/TalkingTech_itiva_inbound.pl

Qué hace: Script para procesar los archivos de resultados para el sistema de notificación Tech i-tiva phone.

Requerida por: TalkingTechItivaPhoneNotification

Frecuencia sugerida: todas las noches

17.1.4.5.2.1. Documentación Perl

USO

TalkingTech_itiva_inbound.pl

TalkingTech_itiva_inbound.pl -v --input=/tmp/talkingtech/results.csv

Script para procesar los archivos de resultados para el sistema de notificación Tech i-tiva phone.

--help -h

Imprime esta ayuda

-v Proporciona información prolija del registro de logs.

--input -i

REQUERIDO. Ruta al archivo de resultados entrante.

17.1.5. Cesta de libros/en proceso

Ruta del script: misc/cronjobs/cart_to_shelf.pl

Qué hace: Actualiza todos los ítems localizados en la CESTA a la ubicación permanente de los ítems.

Requerido por las preferencias del sistema: NewItemsDefaultLocation, InProcessingToShelvingCart, & ReturnToShelvingCart

Frecuencia sugerida: cada hora

17.1.5.1. Documentación Perl

NOMBRE

cart_to_shelf.pl script cron para establecer ítems con ubicaciones en CESTA a la ubicación original del estante después de X horas. Ejecute sin opciones para obtener ayuda.

17.1.6. Catálogo

17.1.6.1. Compruebar las URLs

Ruta del script: misc/cronjobs/check-url.pl

Qué hace: Verifica las URLs en el campo 856$u. La salida del script puede ser formateada en CSV o HTML. La version HTML se enlaza directamente al editor del registro MARC bibliográfico.

Frecuencia sugerida: mensual

Para saber más: http://wiki.koha-community.org/wiki/Check-url_enhancements

17.1.6.1.1. Documentación Perl

NOMBRE

C4::URL::Checker - objeto base para verificación de URLs almacenadas en la base de datos de Koha

SINOPSIS

use C4::URL::Checker;

        my $checker = C4::URL::Checker->new( );
        $checker->{ host_default } = 'http://mylib.kohalibrary.com';
        my $checked_urls = $checker->check_biblio( 123 );
        foreach my $url ( @$checked_urls ) {
            print "url:        ", $url->{ url       A }, "\n",
                  "is_success: ", $url->{ is_success }, "\n",
                  "status:     ", $url->{ status     }, "\n";
        } 

FUNCIONES

new

Crear un URL Checker. El objeto devuelto se puede utilizar para establecer la variable HOST por defecto:

my $checker = C4::URL::Checker->new( );
        $checker->{ host_default } = 'http://mylib.kohalibrary.com'; 

check_biblio

Verifica todas las URLs de un registro bibliográfico. Devuelve un puntero a una array que contiene todas las direcciones URL con la verificación de cada uno de ellas.

 my $checked_urls = $checker->check_biblio( 123 ); 

Con 2 URLs, la array devuelta se parecerá a:

     [
           {
             'url' => 'http://mylib.tamil.fr/img/62265_0055B.JPG',
             'is_success' => 1,
             'status' => 'ok'
           },
           {
             'url' => 'http://mylib.tamil.fr//img/62265_0055C.JPG',
             'is_success' => 0,
             'status' => '404 - Page not found'
           }
         ], 

NOMBRE

check-url.pl - Verifica las URLs de los campos 856$u.

USO

check-url.pl [--verbose|--help] [--host=http://default.tld]

Examina todas las URL encontradas en los 856$u de los registros bibliográfico y muestra si los recursos están disponibles o no.

PARÁMETROS

--host=http://default.tld

Servidor utilizado cuando la URL no dispone de uno, o sea cuando no comienza con 'http:'. Por ejemplo, si --host=http://www.mylib.com, entonces cuando 856$u contiene 'img/image.jpg', se verificará la URL: http://www.mylib.com/image.jpg'.

--verbose|-v

Produce como salida tanto las URLs correctas como las fallidas

--html

Formato de salida en HTML. El resultado puede ser redirigido a un archivo accesible por http. De esta manera, es posible enlazar directamente a los registros bibliográficos en el modo editar. Con este parámetro --host-pro es requerido.

--host-pro=http://koha-pro.tld

Servidor utilizado para enlazar la página de edición del registro bibliográfico.

--help|-h

Imprimir esta página de ayuda.

17.1.6.2. Fusionar autoridades

Ruta del script: misc/migration_tools/merge_authorities.pl

Qué hace: Actualiza los registros bibliográfico con los cambios en los registros de autoridades

Requerido por: la preferencia del sistema dontmerge

Frecuencia sugerida: todas las noches

17.1.6.3. Actualización de publicaciones periódicas

Ruta del script: misc/cronjobs/serialsUpdate.pl

Qué hace: comprueba si existe un ejemplar "retrasado" en las suscripciones activas, y si existe, el script lo pondrá como retrasado, y agregará el siguiente como "esperado".

Frecuencia sugerida: todas las noches

17.1.7. OPAC

17.1.7.1. Feeds RSS

Ruta del script: misc/cronjobs/rss/rss.pl

Qué hace: Produce un documento RSS XML para cualquier consulta SQL (no usado para los resultados de búsqueda feed RSS). Mas información.

Frecuencia sugerida: cada hora

17.1.7.2. Examinador de autoridades

Ruta del script: misc/cronjobs/build_browser_and_cloud.pl

Qué hace: Genera contenido para examinar las autoridades en el OPAC

Requerido por: la preferencia del sistema OpacBrowser

Importante

Esta preferencia y el cron job debería aplicarse solo en los sistemas franceses.

17.1.7.3. Nube de materias/autores

Ruta del script: misc/cronjobs/cloud-kw.pl

Qué hace: Genera nubes de palabras clave en HTML a partir de los índices de Zebra de Koha. misc/cronjobs/cloud-sample.conf tiene una muestra de cómo funciona este script.

Frecuencia: Este es el tipo de script que usted puede ejecutar una vez al mes o menos, el contenido generado no va a cambiar mucho con el tiempo.

17.1.7.3.1. Documentación Perl

NOMBRE

cloud-kw.pl - Crea nubes de palabras clave en HTML a partir de los índices de Zebra de Koha

USO

cloud-kw.pl [--verbose|--help] --conf=cloud.conf

Crea varios archivos HTML que contienen una nube de palabras clave ordenadas por su peso logarítmico. cloud.conf es un archivo de configuración YAML que maneja el proceso de generación de nubes.

PARÁMETROS

--conf=archivo de configuración

Especifique el nombre del archivo de configuración

--verbose|-v

Habilita el modo verbose del script.

--help|-h

Imprimir esta página de ayuda.

CONFIGURACIÓN

El archivo de configuración se parece a:

  ---
         # Koha configuration file for a specific installation
         # If not present, defaults to KOHA_CONF
         KohaConf: /home/koha/mylibray/etc/koha-conf.xml
         # Zebra index to scan
         ZebraIndex: Author
         # Koha index used to link found kewords with an opac search URL
         KohaIndex: au
         # Number of top keyword to use for the cloud
         Count: 50
         # Include CSS style directives with the cloud
         # This could be used as a model and then CSS directives are
         # put in the appropriate CSS file directly.
         Withcss: Yes
         # HTML file where to output the cloud
         Output: /home/koha/mylibrary/koharoot/koha-tmpl/cloud-author.html
        ---
         KohaConf: /home/koha/yourlibray/etc/koha-conf.xml
         ZebraIndex: Subject
         KohaIndex: su
         Count: 200
         Withcss: no
         Output: /home/koha/yourlibrary/koharoot/koha-tmpl/cloud-subject.html

MEJORAS

Los términos principales generados son los que tienen más informaciones de todos aquello que producidos hasta el momento. Algunos parámetros se pueden añadir fácilmente para mejorar este script:

WithCount

Para producir términos con un determinado número de ocurrencias que hayan sido encontrados en el catálogo Zebra de Koha.

CloudLevels

Número de niveles en la nube. En la actualidad hay definidos de modo predeterminado 24 niveles.

Weighting

Método de ponderación utilizado para distribuir los términos de la nube. Podemos tener dos valores: logarítmica y lineal. En la actualidad la forma predeterminada es la logarítmica.

Order

Ahora los términos se generan en el orden léxico. Se podrían ordenar por su ponderación.

17.1.8. Administración del sistema

17.1.8.1. Limpiar la base de datos

Ruta del script: misc/cronjobs/cleanup_database.pl

Qué hace: trunca la tabla de sesiones, limpia viejas entradas zebraqueue, logs de acciones y archivos preparados MARC.

17.1.9. Adquisiciones

17.1.9.1. Limpiar sugerencias antiguas

Ruta del script: misc/cronjobs/purge_suggestions.pl

Qué hace: Elimina sugerencias antiguas (definidas por usted) desde el área de gestión de sugerencias.

17.1.10. Scripts no aprobados

Éstos no se deberían ejecutar sin modificar:

Ruta del script: misc/cronjobs/update_items.pl

Ruta del script: misc/cronjobs/smsoverdues.pl

Ruta del script: misc/cronjobs/notifyMailsOp.pl

Ruta del script: misc/cronjobs/reservefix.pl

Ruta del script: misc/cronjobs/zebraqueue_start.pl