Apéndice L. Tareas progamadas

Tabla de contenidos

1. Tareas progamadas
1.1. Buscar
1.2. Circulación
1.3. Avisos
1.4. En Procesamiento / Libro de compra
1.5. Catálogo
1.6. OPAC
1.7. Administración del sistema
1.8. Dcripts obsoletos

1. Tareas progamadas

Los lugares siguientes se supone una instalación dev que pone el crons en misc /, si tiene una instalación estándar que usted puede desear mirar en bin / para estos archivos si no se les puede encontrar en misc /

1.1. Buscar

1.1.1. Volver a generar índice

Path del Script: misc / migration_tools / rebuild_zebra.pl

Hace: Actualizaciones índices de Zebra con los datos recientemente cambiado.

Requerido por: Zebra

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

1.2. Circulación

1.2.1. Cola de reservas

Path del Script: misc / Cronjobs / encuentre / build_holds_queue.pl

Hace: Actualizaciones sostiene el informe de colas

Requerido por: Sostiene cola Informe

sugerencia Frecuencia: cada 1-4 horas

1.2.1.1. Perl Documentación

GetBibsWithPendingHoldRequests

my $ biblionumber_aref GetBibsWithPendingHoldRequests = ();

Devolver un arrayref del biblionumbers de todos los baberos que tienen una o más solicitudes tienen vacantes.

GetPendingHoldRequestsForBib

mis peticiones = $ GetPendingHoldRequestsForBib ($ biblionumber);

Devuelve un arrayref de hashrefs a la espera, las solicitudes de vacantes parar

el babero identificados por $ biblionumber. Las siguientes teclas están presentes en cada hashref:

  • biblionumber

  • borrowernumber

  • itemnumber

  • prioridad:

  • branchcode

  • reservedate

  • reservenotes

  • borrowerbranch

El arrayref está ordenada por orden de prioridad cada vez mayor.

GetItemsAvailableToFillHoldRequestsForBib

my $ available_items =

GetItemsAvailableToFillHoldRequestsForBib ($ biblionumber);

Devuelve un arrayref de artículos disponibles para llenar las solicitudes de mantener el babero identificados por $ biblionumber. Un artículo está disponible para llenar una bodega

solicitud si y sólo si:

  • no está en préstamo

  • que no se retira

  • no está marcado notforloan

  • actualmente no está en tránsito

  • no se pierde

  • no está sentado en la plataforma celebrar

MapItemsToHoldRequests

MapItemsToHoldRequests ($ hold_requests, $ available_items);

CreatePickListFromItemMap

AddToHoldTargetMap

_get_branches_to_pull_from

preferencias de consultas del sistema para obtener lista ordenada de sucursales a utilizar para llenar las solicitudes espera.

1.2.2. Reservas expiradas

Path del Script: misc / Cronjobs / encuentre / cancel_expired_holds.pl

Hace: Cancela sostiene que han pasado su fecha de caducidad.

sugerencia Frecuencia: diaria

1.2.3. Multas

Path del Script: misc / Cronjobs / fines.pl

Requerido por: finesMode preferencia del sistema

sugerencia Frecuencia: todas las noches

1.2.4. Larga vencidas

Path del Script: misc / Cronjobs / longoverdue.pl

Hace: permite especificar los plazos para el cambio de producto para los diferentes estados de perdidas y, opcionalmente, cobrar por ellos.

Requerido por: sugerencia de Frecuencia: todas las noches

1.2.4.1. Perl Documentación

NOMBR

script cron longoverdue.pl para establecer estados perdidos en las materias pendientes. Ejecutar sin opciones para obtener ayuda.

1.3. Avisos

1.3.1. Cola de mensajes

Path del Script: misc / Cronjobs / process_message_queue.pl

Hace: los procesos de la cola de mensajes para enviar correos electrónicos y mensajes SMS a los usuarios. envía correos salientes a los clientes.

sugerencia Frecuencia: todas las noches

1.3.2. Aviso avanzada

Path del Script: misc / Cronjobs / advance_notices.pl

Hace: prepara "pre-due" avisos y 'punto por' avisos para los clientes que solicitan los prepara anuncios para los clientes por artículos o simplemente la consecuencia que vencen pronto. requiere EnhancedMessagingPreferences para estar en

sugerencia Frecuencia: todas las noches

Nota

Este script no envía realmente los anuncios. Les colas en la cola de mensajes para su posterior

1.3.2.1. Perl Documentación

NOMBR

script cron advance_notices.pl - para poner recordatorios tema debido a la cola de mensajes

SINOPSIS

./advance_notices.pl -c

o, en el crontab: 0 1 * * * advance_notices.pl-c

DESCRIPCIÓN

Este script se prepara antes de la debida y punto recordatorios por ser enviados a los clientes. Les colas en la cola de mensajes, que es procesado por el cronjob process_message_queue.pl. El tipo y el momento de los mensajes pueden ser configurados por los usuarios en su 'Mis Alertas' ficha en el OPAC.

MÉTODOS

parse_letter

1.3.3. Atrasado Aviso

Path del Script: misc / Cronjobs / overdue_notices.pl

Hace: prepara mensajes para alertar a los clientes de mensajes atrasados

sugerencia Frecuencia: todas las noches

Nota

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

1.3.3.1. Perl Documentación

NOMBR

overdue_notices.pl - los mensajes se preparan para ser enviados a los clientes para los artículos pendientes

SINOPSIS

overdue_notices.pl [n-biblioteca] [-<branchcode>] [Biblioteca <branchcode> ...] <número [-max de days>] [-csv [<<nombre]] [-itemscontent ; lista de campos>]

Opciones:

-help mensaje de ayuda breve

-man documentación completa

-n No se enviará correo electrónico

-Max días como máximo <días> atrasados para hacer frente a

<branchname> biblioteca-sólo se preocupan por vencidas de esta biblioteca (repetible: varias bibliotecas se puede dar)

<nombre-csv rellenar archivo CSV

<nombre-html de salida al archivo html

<list-itemscontent punto de información en las plantillas fields>

Código <categorycode> categoría borcat que deben ser incluidos

<categorycode>-borcatout categoría de código que deben ser excluidos

OPCIONES

-Help Muestra un mensaje de ayuda breve y salidas.

-El hombre imprime la página de manual y salidas.

-V verboso. Sin este indicador establecido, sólo los errores fatales son reportados.

-N No enviar ningún correo electrónico. avisos de vencimiento que se han enviado a los clientes o con el administrador se imprimen en la salida estándar. CSV (si la bandera de la CSV está establecido) se escribe en la salida estándar o cualquier nombre de archivo csv dado.

-Max ítems anteriores a día max se supone que son cabo en otro lugar, probablemente la secuencia de comandos longoverdues.pl. Por lo tanto ignorados por este programa. No se envían notificaciones para ellos, y que no se agregan a los archivos CSV. El valor predeterminado es 90 para que coincida con longoverdues.pl.

-library

vencidas seleccionar para una biblioteca específica. Utilice el valor de la tabla branches.branchcode. Esta opción se puede repetir el fin de seleccionar vencidas por un grupo de bibliotecas.

-Produce CSV csv datos. si-n (no electrónico) se establece el indicador, a continuación, estos datos CSV se envía a la salida estándar o un nombre de archivo si se proporciona. De lo contrario, vencidas que no se pudo mandar por correo electrónico se envían en formato CSV para el administrador.

-Itemscontent

lista separada por comas de los campos que recibe sustituido en las plantillas en los lugares del marcador de posición <<items.content>>. El valor predeterminado es issuedate, título, código de barras, autor

Otros valores posibles proceden de campos en el biblios, objetos y cuadros cuestiones.

campo Repetable-borcat, que permiten seleccionar sólo algunas de las categorías clientes.

-Borcatout

Repetable campo, permis excluir a algunas categorías clientes.

-t | --triggered

Esta opción hace que un aviso de que se generen si y sólo si un artículo está vencida por el número de días definido en un disparo previo aviso.

De forma predeterminada, un anuncio se envía cada momento en que el script se ejecuta, lo que es adecuado para menos frecuentes script cron, pero requiere sincronización aviso desencadena con el calendario de cron para garantizar un comportamiento adecuado. Añadir la opción - ha disparado de cron diaria, con el riesgo de no notificación que se generan si el cron no se ejecute a tiempo.

-list-all

items.content listas por defecto sólo aquellos artículos que están en el rango de la notificación actual de procesamiento. Elija la lista, todo a fin de incluir todos los artículos atrasadas en la lista (limitado por la configuración-máx).

DESCRIPCIÓN

Este guión está diseñado para alertar a los clientes y administradores de los temas pendientes.

Configuración

Este script presta atención a la configuración de aviso de vencimiento a cabo en el anuncio 'Atrasado / estado de los desencadenantes' de la 'Herramientas' de la interfaz de personal para Koha. Allí, usted puede elegir qué plantillas de cartas se envían después de un número configurable de días a los clientes de cada biblioteca. Más información sobre el uso de esta sección de Koha está disponible en el manual de Koha.

Las plantillas utilizadas para elaborar los correos electrónicos se definen en las herramientas ': Avisos' de la interfaz de personal para Koha.

Mensajes de correo electrónico saliente

Normalmente, los mensajes se preparan para cada cliente con materiales vencidos. Mensajes para el cual no hay dirección de correo electrónico en archivo se recogen y se envían como archivos adjuntos en un solo correo electrónico a cada administrador de la biblioteca, o si no se establece, a continuación, a la dirección de correo electrónico en la preferencia 'KohaAdminEmailAddress sistema'.

Estos correos electrónicos se celebran en la cola de mensajes salientes, así como los mensajes producidos por otras características de Koha. Esta cola de mensajes deben ser procesados regularmente por el misc / Cronjobs / programa process_message_queue.pl.

En el caso de que la opción '-n' del pabellón se pasa a este programa, no se envían mensajes de correo electrónico. En cambio, los mensajes se envían en la salida estándar de este programa. Se puede redirigir a un archivo si lo desea.

Plantillas

Las plantillas pueden contener variables entre corchetes angulares dobles como <<this>>. Estas variables se sustituyen con los valores específicos a los ítems atrasados o socio de referencia. Las variables disponibles son:

<<bib>>

el nombre de la biblioteca

<<items.content>>

una línea para cada punto, cada línea que contiene una lista separada por ficha de título, autor, código de barras, issuedate

<<borrowers.*>>

cualquier campo de la tabla de los prestatarios

<<branches.*>>

cualquier campo de la tabla de ramas

salida CSV

El '-csv' opción de línea de comandos le permite especificar un archivo en el que los datos deben ser vencidas de salida en formato CSV.

Con el conjunto '-n' bandera, datos sobre todas las vencidas se escribe en el archivo. Sin esa bandera, la información sólo vencidas que no pudieron ser enviados directamente a los clientes será por escrito. En otras palabras, este archivo CSV sustituye a los datos que se suelen enviar a la dirección de correo del administrador.

Ejemplos de uso

'Overdue_notices.pl' - En este uso más básico, sin ningún argumento de línea de comandos, todas las bibliotecas son procesed individual, y las comunicaciones están preparados para todos los clientes con los temas pendientes para los cuales tenemos direcciones de correo electrónico. Mensajes a los clientes para los que no tenemos dirección de correo electrónico se envían en un único archivo adjunto al email del administrador de la biblioteca, oa la dirección en el sistema de preferencia KohaAdminEmailAddress.

'Overdue_notices.pl-n-csv / tmp / overdues.csv' - no envía correo electrónico y rellena / tmp / overdues.csv con información sobre todos los temas pendientes.

'Overdue_notices.pl biblioteca-PRINCIPALES máximo 14' - Tramitar las vencidas en los últimos 2 semanas para que la biblioteca principal.

VER TAMBIÉN

El misc / Cronjobs / advance_notices.pl programa te permite enviar mensajes a los clientes antes de convertirse en sus artículos de vencimiento, o para alertar de los artículos que han pasado a ser su debido tiempo.

MÉTODOS INTERNOS

Estos métodos son internos a la operación de overdue_notices.pl.

parse_letter

analiza la plantilla de carta, en sustitución de los marcadores de posición con datos específicos a este socio, biblio, o ítem

parámetros con nombre:

carta - requiere referencia hash

borrowernumber - entero requerido

sustituto - hashref opcional de otra clave / valor que debe ser sustituido en la carta de contenido

devuelve la 'carta' hashref, con el contenido actualizado para reflejar las teclas sustituidos y valores.

prepare_letter_for_printing

devuelve una cadena de texto apropiado para la impresión en caso de que un aviso de vencimiento no se enviará a la dirección de correo electrónico del socio. Dependiendo del formato de salida deseado, esto puede ser una cadena CSV, o una representación legible por humanos del anuncio.

parámetros necesarios:

carta

borrowernumber

parámetros opcionales:

outputformat

1.3.4. Imprimir avisos de reservas

Path del Script: misc / Cronjobs / gather_print_notices.pl

Hace: mira a través de la cola de mensajes de avisos sostienen que no pasaron por el socio, porque no tenía una dirección de correo electrónico y genera un aviso de impresión

sugerencia Frecuencia: todas las noches

1.4. En Procesamiento / Libro de compra

Path del Script: misc / Cronjobs / cart_to_shelf.pl

Hace: Actualiza todos los ítems con una ubicación CART a la ubicación permanente de dicho ítem.

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

Sugerencia de frecuencia: cada hora

1.4.1. Perl Documentación

NOMBR

cart_to_shelf.pl script cron para configurar los items con la ubicación de la terapia antirretroviral a su ubicación original después de dejar de lado X horas. Ejecutar sin opciones para obtener ayuda.

1.5. Catálogo

1.5.1. Compruebe las URL

Path del Script: misc/cronjobs/check-url.pl

Hace: URL controles en 856 $ de campo u. Script de salida ahora se puede formatear en formato CSV o HTML. Los enlaces versión HTML directamente al editor de registros MARC bibliográficos.

Sugerencia de frecuencia: mensual

Más información: http://wiki.koha-community.org/wiki/Check-url_enhancements

1.5.1.1. Perl Documentación

NOMBR

C4::URL::Checker - objeto base para el control de URL almacenadas en Koha DB

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 }, "", "is_success: ", $url->{ is_success }, "", "status: ", $url->{ status }, ""; }
                                    

FUNCIONES

nuevo

Crear una URL Checker. El objeto devuelto se puede utilizar para ajustar la variable por defecto de acogida:

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

check_biblio

Revise todas las URL de un registro bibliográfico. Devuelve un puntero a una matriz que contiene todas las URL con la comprobación de cada uno de ellos.

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

Con dos URLs, la matriz devuelta se verá así:

                                          [ { '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' } ],
                                    

NOMBR

check-url.pl - Compruebe las URL de 856 u $ campo.

USO

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

Escanear todas las URL encontradas en 856 $ u de los registros de babero y mostrar si los recursos están disponibles o no.

PARÁMETROS

--host=http://default.tld

Servidor de alojamiento utilizado cuando URL no tiene uno, es decir, no comienza con 'http:'. Por ejemplo, si - host = http://www.mylib.com, luego, cuando 856 $ u contiene 'img / imagen.jpg ', comprueba la URL es: http://www.mylib.com/image.jpg ».

--verbose|-v

URL salidas tanto de éxito y fracaso.

--html

Formatos de salida en HTML. El resultado se puede redirigir a un archivo accesible por http. De esta manera, es posible vincular directamente a biblio grabar en modo de edición. Con este parámetro - host-pro es necesario.

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

Servidor de alojamiento utilizado para conectar a la biblio página de edición de registro.

--help|-h

Imprimir esta página de ayuda.

1.5.2. Combinar las autoridades

Path del Script: misc/migration_tools/merge_authorities.pl

Hace: Actualiza datos de registros con los cambios de los registros de autoridades

Requerido por: dontmerge preferencia del sistema

sugerencia Frecuencia: todas las noches

1.5.3. Actualización de publicaciones periódicas

Ruta del script: misc/cronjobs/serialsUpdate.pl

Hace: comprueba si existe un ejemplar "tarde" en las suscripciones activas, y si existe, el script lo pondrá como tarde, y agregará el siguiente como se esperado.

sugerencia Frecuencia: todas las noches

1.6. OPAC

1.6.1. RSS Feeds

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

Hace: Produce un documento XML RSS para cualquier consulta SQL (no se utiliza para los resultados de búsqueda RSS). Más información .

Sugerencia de frecuencia: cada hora

1.6.2. Navegador de autoridades

Ruta del script: misc/cronjobs/build_browser_and_cloud.pl

Hace: Genera contenido para navegar autoridades en el OPAC

Requerido por: OpacBrowser preferencia del sistema

1.6.3. Nube de Temas/Autores

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

Hace: Genera una nube de palabras clave HTML de los índices 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 e puede ejecutar una vez al mes o menos, el contenido generado no va a cambiar mucho con el tiempo.

1.6.3.1. Perl Documentación

NOMBR

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

USO

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

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

PARÁMETROS

--conf=archivo de configuración

Especifique el nombre del archivo de configuración

--verbose|-v

Habilita el modo verboso del script.

--help|-h

Imprimir esta página de ayuda.

CONFIGURACIÓN

El archivo de configuración se parece a lo siguiente:

                                                --- # 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 generados contienen más información que aquellos producidor previamente. Se pueden añadir fácilmente parámetros para mejorr este script:

WithCount

De forma de producir términos con un determinado número de ocurrencias en el ctálogo Zebra de Koha.

CloudLevels

Número de niveles en la nube. Ahora son 24 niveles codificados.

Weighting

El método de ponderación (Weighting) utilizado para distribuir los términos de la nube. Podemos tener dos valores: logarítmica y lineal. Ahora es logarítmica de forma predeterminada.

Pedido

Ahora los términos se generan en el orden léxico. Podrían ser ordenados por su peso.

1.7. Administración del sistema

1.7.1. Limpia la base de datos

Ruta del script: misc/cronjobs/cleanup_database.pl

Hace: trunca la tabla de sesiones y limpia viejas entradas zebraqueue.

1.8. Dcripts obsoletos

Estos no se deben ejecutar sin modificaciones:

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

Ruta del script: misc/cronjobs/j2a.pl