2 # ---------------------------------------------------------------
3 # Copyright (C) 2008 Georgia Public Library Service
4 # Bill Erickson <erickson@esilibrary.com>
6 # This program is free software; you can redistribute it and/or
7 # modify it under the terms of the GNU General Public License
8 # as published by the Free Software Foundation; either version 2
9 # of the License, or (at your option) any later version.
11 # This program is distributed in the hope that it will be useful,
12 # but WITHOUT ANY WARRANTY; without even the implied warranty of
13 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 # GNU General Public License for more details.
15 # ---------------------------------------------------------------
16 use strict; use warnings;
17 require 'oils_header.pl';
24 use Unicode::Normalize;
25 use DateTime::Format::ISO8601;
26 use OpenSRF::Utils qw/:datetime/;
27 use OpenSRF::Utils::JSON;
28 use OpenSRF::Utils::SettingsClient;
29 use OpenSRF::AppSession;
30 use OpenILS::Const qw/:const/;
31 use OpenILS::Application::AppUtils;
32 use OpenILS::Const qw/:const/;
33 my $U = 'OpenILS::Application::AppUtils';
36 my $e = OpenILS::Utils::CStoreEditor->new;
38 my @global_overdue_circs; # all circ collections stored here go into the final global XML file
40 # - set up default values
41 my $opt_osrf_config = '/openils/conf/opensrf_core.xml';
42 my $opt_send_email = 0;
43 my $opt_gen_day_intervals = 0;
44 my $opt_days_back = '';
45 my $opt_gen_global_templates = 0;
46 my $opt_show_help = 0;
47 my $opt_append_global_email_fail;
48 my $opt_notice_types = '';
51 'osrf_opt_osrf_config=s' => \$opt_osrf_config,
52 'send-email' => \$opt_send_email,
53 'generate-day-intervals' => \$opt_gen_day_intervals,
54 'generate-global-templates' => \$opt_gen_global_templates,
55 'days-back=s' => \$opt_days_back,
56 'append-global-email-fail' => \$opt_append_global_email_fail,
57 'notice-types=s' => \$opt_notice_types,
58 'help' => \$opt_show_help,
61 help() and exit if $opt_show_help;
66 Evergreen Circulation Notice Generator
68 --config <config_file>
71 If set, generate email notices
73 --generate-day-intervals
74 If set, notices which have a notify_interval of >= 1 day will be processed.
76 --generate-global-templates
77 Collect all non-emailed notices into a global set and generate templates based on that set.
79 --append-global-email-fail
80 If an attempt was made to send an email notice but it failed, the notice is appended
81 to the global notice file set. This will only have any bearing if --generate-global-templates
84 --days-back <days_back_comma_separted>
85 This is used to set the effective run date of the script.
86 This is useful if you don't want to generate notices on certain days. For example, if you don't
87 generate notices on the weekend, you would run this script on weekdays and set --days-back to
88 0,1,2 when it's run on Monday to capture any notices from Saturday and Sunday.
90 --notice-types <overdue,predue,...>
91 Comma-separated list of notice types to generate for this run of the script
94 Print this help message
100 osrf_connect($opt_osrf_config);
101 $settings = OpenSRF::Utils::SettingsClient->new;
103 die "Please specify at least 1 type of notice to generate with --notice-types\n"
104 unless $opt_notice_types;
106 my $sender_address = $settings->config_value(notifications => 'sender_address');
107 my $od_sender_addr = $settings->config_value(notifications => overdue => 'sender_address') || $sender_address;
108 my $pd_sender_addr = $settings->config_value(notifications => predue => 'sender_address') || $sender_address;
109 my $overdue_notices = $settings->config_value(notifications => overdue => 'notice');
110 my $predue_notices = $settings->config_value(notifications => predue => 'notice');
112 $overdue_notices = [$overdue_notices] unless ref $overdue_notices eq 'ARRAY';
113 $predue_notices = [$predue_notices] unless ref $predue_notices eq 'ARRAY';
115 my @overdues = sort {
116 OpenSRF::Utils->interval_to_seconds($a->{notify_interval}) <=>
117 OpenSRF::Utils->interval_to_seconds($b->{notify_interval}) } @$overdue_notices;
120 OpenSRF::Utils->interval_to_seconds($a->{notify_interval}) <=>
121 OpenSRF::Utils->interval_to_seconds($b->{notify_interval}) } @$predue_notices;
123 for my $db (($opt_days_back) ? split(',', $opt_days_back) : 0) {
124 if($opt_notice_types =~ /overdue/) {
125 generate_notice_set($_, 'overdue', $db) for @overdues;
127 if($opt_notice_types =~ /predue/) {
128 generate_notice_set($_, 'predue', $db) for @predues;
132 generate_global_overdue_file() if $opt_gen_global_templates;
135 sub generate_global_overdue_file {
136 $logger->info("notice: processing ".scalar(@global_overdue_circs)." for global template");
137 return unless @global_overdue_circs;
139 my $tt = Template->new({ABSOLUTE => 1});
142 $settings->config_value(notifications => overdue => 'combined_template'),
144 overdues => \@global_overdue_circs,
145 get_bib_attr => \&get_bib_attr,
146 parse_due_date => \&parse_due_date, # let the templates decide date format
147 escape_xml => \&escape_xml,
149 \&global_overdue_output
150 ) or $logger->error('notice: Template error '.$tt->error);
153 sub global_overdue_output {
158 sub generate_notice_set {
159 my($notice, $type, $days_back) = @_;
161 my $notify_interval = OpenSRF::Utils->interval_to_seconds($notice->{notify_interval});
162 $notify_interval = -$notify_interval if $type eq 'overdue';
164 my ($start_date, $end_date) = make_date_range($notify_interval - $days_back * 86400);
166 $logger->info("notice: retrieving circs with due date in range $start_date -> $end_date");
175 checkin_time => undef,
177 {stop_fines => ["LOST","LONGOVERDUE","CLAIMSRETURNED"]},
178 {stop_fines => undef}
180 due_date => {between => [$start_date, $end_date]},
185 # if a circ duration is defined for this type of notice
186 if(my $durs = $notice->{circ_duration_range}) {
187 $QUERY->{where}->{'+circ'}->{duration} = {between => [$durs->{from}, $durs->{to}]};
190 my $circs = $e->json_query($QUERY, {timeout => 18000, substream => 1});
191 process_circs($notice, $type, map {$_->{id}} @$circs);
200 return unless @circs;
202 $logger->info("notice: processing $type notices with notify interval ".
203 $notice->{notify_interval}." and ".scalar(@circs)." circs");
210 for my $circ (@circs) {
211 $circ = $e->retrieve_action_circulation($circ);
214 $circ->circ_lib != $org or $circ->usr ne $patron ) {
215 $org = $circ->circ_lib;
216 $patron = $circ->usr;
217 generate_notice($notice, $type, @current) if @current;
221 push(@current, $circ);
225 $logger->info("notice: processed $x circs");
226 generate_notice($notice, $type, @current);
231 sub generate_notice {
235 return unless @circs;
236 my $circ_list = fetch_circ_data(@circs);
237 my $tt = Template->new({ABSOLUTE => 1});
239 my $sender = $settings->config_value(
240 notifications => $type => 'sender_address') ||
241 $settings->config_value(notifications => 'sender_address');
244 circ_list => $circ_list,
245 get_bib_attr => \&get_bib_attr,
246 parse_due_date => \&parse_due_date, # let the templates decide date format
247 smtp_sender => $sender,
248 smtp_repley => $sender, # XXX
252 push(@global_overdue_circs, $context) if
253 $type eq 'overdue' and $notice->{file_append} =~ /always/i;
255 if($opt_send_email and $notice->{email_notify} and
256 my $email = $circ_list->[0]->usr->email) {
258 if(my $tmpl = $notice->{email_template}) {
259 $tt->process($tmpl, $context,
261 email_template_output($notice, $type, $context, $email, @_);
263 ) or $logger->error('notice: Template error '.$tt->error);
266 push(@global_overdue_circs, $context)
267 if $type eq 'overdue' and $notice->{file_append} =~ /noemail/i;
274 my $copy = $circ->target_copy;
275 if($copy->call_number->id == OILS_PRECAT_CALL_NUMBER) {
276 return $copy->dummy_title || '' if $attr eq 'title';
277 return $copy->dummy_author || '' if $attr eq 'author';
279 my $mvr = $U->record_to_mvr($copy->call_number->record);
280 return $mvr->title || '' if $attr eq 'title';
281 return $mvr->author || '' if $attr eq 'author';
285 # provides a date that Template::Plugin::Date can parse
288 my $due = DateTime::Format::ISO8601->new->parse_datetime(clense_ISO8601($circ->due_date));
290 "%0.2d:%0.2d:%0.2d %0.2d-%0.2d-%0.4d",
302 $str =~ s/&/&/sog;
303 $str =~ s/</</sog;
304 $str =~ s/>/>/sog;
309 sub email_template_output {
316 my $sender = Email::Send->new({mailer => 'SMTP'});
317 my $smtp_server = $settings->config_value(notifications => 'smtp_server');
318 $logger->debug("notice: smtp server is $smtp_server");
319 $sender->mailer_args([Host => $smtp_server]);
320 my $stat = $sender->send($msg);
322 if( $stat and $stat->type eq 'success' ) {
323 $logger->info("notice: successfully sent $type email to $email");
325 $logger->warn("notice: unable to send $type email to $email: ".Dumper($stat));
326 # if we were unable to send the email, add this notice set to the global notify set
327 push(@global_overdue_circs, $context)
328 if $opt_append_global_email_fail and
329 $type eq 'overdue' and $notice->{file_append} =~ /noemail/i;
333 sub fetch_circ_data {
336 my $circ_lib_id = $circs[0]->circ_lib;
337 my $usr_id = $circs[0]->usr;
338 $logger->debug("notice: printing user:$usr_id circ_lib:$circ_lib_id");
340 my $usr = $e->retrieve_actor_user([
344 au => [qw/card billing_address mailing_address/]
349 my $circ_lib = $ORG_CACHE{$circ_lib_id} ||
350 $e->retrieve_actor_org_unit([
354 aou => [qw/billing_address mailing_address/],
358 $ORG_CACHE{$circ_lib_id} = $circ_lib;
360 my $circ_objs = $e->search_action_circulation([
361 {id => [map {$_->id} @circs]},
364 circ => [q/target_copy/],
365 acp => ['call_number'],
371 $_->circ_lib($circ_lib) for @$circ_objs;
372 $_->usr($usr) for @$circ_objs;
378 sub make_date_range {
380 #my $is_day_precision = shift; # window?
382 my $epoch = CORE::time + $offset;
383 my $date = DateTime->from_epoch(epoch => $epoch, time_zone => 'local');
386 $date->set_minute(0);
387 $date->set_second(0);
391 $date->set_minute(59);
392 $date->set_second(59);
394 return ($start, "$date");