1 package OpenILS::Application::Trigger::Reactor;
2 use strict; use warnings;
3 use Encode qw/ encode /;
6 use DateTime::Format::ISO8601;
7 use Unicode::Normalize;
9 use OpenSRF::Utils qw/:datetime/;
10 use OpenSRF::Utils::Logger qw(:logger);
11 use OpenSRF::Utils::JSON;
12 use OpenILS::Application::AppUtils;
13 use OpenILS::Utils::CStoreEditor qw/:funcs/;
14 my $U = 'OpenILS::Application::AppUtils';
16 sub fourty_two { return 42 }
17 sub NOOP_True { return 1 }
18 sub NOOP_False { return 0 }
21 # To be used in two places within $_TT_helpers. Without putting the code out
22 # here, we can't really reuse it within that structure.
24 my $name = shift or return; # the first arg is always the name
25 my ($type, $attr) = (scalar(@_) == 1) ? (undef, $_[0]) : @_;
26 # if the next is the last, it's the attributes, otherwise type
27 # use Data::Dumper; $logger->warn("get_li_attr: " . Dumper($attr));
28 ($name and @$attr) or return;
30 $name =~ s/^(\D+)_(\d+)$/$1/ and $length = $2;
32 $_->attr_name eq $name or next;
33 next if $length and $length != length($_->attr_value);
34 return $_->attr_value if (! $type) or $type eq $_->attr_type;
39 # helper functions inserted into the TT environment
40 my $_TT_helpers; # define first so one helper can use another
43 # turns a date into something TT can understand
46 $date = DateTime::Format::ISO8601->new->parse_datetime(cleanse_ISO8601($date));
48 "%0.2d:%0.2d:%0.2d %0.2d-%0.2d-%0.4d",
58 # escapes a string for inclusion in an XML document. escapes &, <, and > characters
61 $str =~ s/&/&/sog;
69 $str =~ s/([\x{0080}-\x{fffd}])/sprintf('\u%0.4x',ord($1))/sgoe;
73 # encode email headers in UTF-8, per RFC2231
74 escape_email_header => sub {
76 $str = encode("MIME-Header", $str);
80 # strip non-ASCII characters after splitting base characters and diacritics
81 # least common denominator for EDIFACT messages using the UNOB character set
82 force_jedi_unob => sub {
85 $str =~ s/[\x{0080}-\x{fffd}]//g;
89 # returns the calculated user locale
90 get_user_locale => sub {
92 return $U->get_user_locale($user_id);
95 # returns the calculated copy price
96 get_copy_price => sub {
98 return $U->get_copy_price(new_editor(xact=>1), $copy_id);
101 # given a copy, returns the title and author in a hash
102 get_copy_bib_basics => sub {
104 my $copy = new_editor(xact=>1)->retrieve_asset_copy([
109 acp => ['call_number'],
114 if($copy->call_number->id == -1) {
116 title => $copy->dummy_title,
117 author => $copy->dummy_author,
120 my $mvr = $U->record_to_mvr($copy->call_number->record);
122 title => $mvr->title,
123 author => $mvr->author
128 # returns the org unit setting value
129 get_org_setting => sub {
130 my($org_id, $setting) = @_;
131 return $U->ou_ancestor_setting_value($org_id, $setting);
134 # This basically greps/maps out ths isbn string values, but also promotes the first isbn-13 to the
135 # front of the line (so that the EDI translator takes it as primary) if there is one.
136 get_li_isbns => sub {
141 $_->attr_name eq 'isbn' or next;
142 my $val = $_->attr_value;
143 if (! $primary and length($val) == 13) {
149 $primary and unshift @isbns, $primary;
150 $logger->debug("get_li_isbns returning isbns: " . join(', ', @isbns));
154 # helpers.get_li_attr('isbn_13', li.attributes)
155 # returns matching line item attribute, or undef
156 get_li_attr => \&get_li_attr,
158 get_li_attr_jedi => sub {
159 # This helper has to mangle data in at least three interesting ways.
161 # 1) We'll be receiving data that may already have some \-escaped
164 # 2) We need our output to be valid JSON.
166 # 3) We need our output to yield valid and unproblematic EDI when
167 # passed through edi4r by the edi_pusher.pl script.
169 my $value = get_li_attr(@_);
171 # Here we can add any number of special case transformations to
172 # avoid problems with the EDI translator (or bad JSON).
174 # The ? character, if in the final position of a string, breaks
175 # the translator. + or ' or : could be problematic, too.
176 if ($value =~ /[\?\+':]$/) {
180 # Typical vendors dealing with EDIFACT would seem not to want
181 # any unicode characters, so trash them. Yes, they're already
182 # in the data escaped like this at this point even though we
183 # haven't JSON-escaped things yet.
184 $value =~ s/\\u[0-9a-f]{4}//g;
186 # What the heck, get rid of [ ] too (although I couldn't get them
187 # to cause any problems for me, problems have been reported. See
189 $value =~ s/[\[\]]//g;
192 $value = OpenSRF::Utils::JSON->perl2JSON($value);
194 # Existing action/trigger templates expect an unquoted string.
201 get_queued_bib_attr => sub {
202 my $name = shift or return; # the first arg is always the name
204 # use Data::Dumper; $logger->warn("get_queued_bib_attr: " . Dumper($attr));
205 ($name and @$attr) or return;
208 select => {'vqbrad' => ['id']},
210 where => {code => $name}
213 my $def_ids = new_editor()->json_query($query);
217 $name =~ s/^(\D+)_(\d+)$/$1/ and $length = $2;
219 $_->field eq @{$def_ids}[0]->{id} or next;
220 next if $length and $length != length($_->attr_value);
221 return $_->attr_value;
226 get_queued_auth_attr => sub {
227 my $name = shift or return; # the first arg is always the name
229 # use Data::Dumper; $logger->warn("get_queued_auth_attr: " . Dumper($attr));
230 ($name and @$attr) or return;
233 select => {'vqarad' => ['id']},
235 where => {code => $name}
238 my $def_ids = new_editor()->json_query($query);
242 $name =~ s/^(\D+)_(\d+)$/$1/ and $length = $2;
244 $_->field eq @{$def_ids}[0]->{id} or next;
245 next if $length and $length != length($_->attr_value);
246 return $_->attr_value;
254 if ($str =~ /\,/ || $str =~ /"/) {
256 $str = '"' . $str . '"';
263 bre_open_hold_count => sub {
265 return 0 unless $bre_id;
266 return $U->simplereq(
268 'open-ils.circ.bre.holds.count', $bre_id);
273 return $str ? (new XML::LibXML)->parse_string($str) : undef;
277 my ($bre_id, $unapi_args) = @_;
279 $unapi_args->{flesh} ||= '{}',
283 'unapi.bre', $bre_id, 'marcxml','record',
284 $unapi_args->{flesh},
286 $unapi_args->{depth},
287 $unapi_args->{flesh_depth},
291 my $unapi = new_editor()->json_query($query);
292 return undef unless @$unapi;
293 return $_TT_helpers->{xml_doc}->($unapi->[0]->{'unapi.bre'});
298 # processes templates. Returns template output on success, undef on error
303 return undef unless $env->{template};
307 my $tt = Template->new;
308 # my $tt = Template->new(ENCODING => 'utf8'); # ??
309 $env->{helpers} = $_TT_helpers;
311 unless( $tt->process(\$env->{template}, $env, \$output) ) {
313 ($error = $tt->error) =~ s/\n/ /og;
314 $logger->error("Error processing Trigger template: $error");
317 if ( $error or (!$nostore && $output) ) {
318 my $t_o = Fieldmapper::action_trigger::event_output->new;
319 $t_o->data( ($error) ? $error : $output );
320 $t_o->is_error( ($error) ? 't' : 'f' );
321 $logger->info("trigger: writing " . length($t_o->data) . " bytes to template output");
323 $env->{EventProcessor}->editor->xact_begin;
324 $t_o = $env->{EventProcessor}->editor->create_action_trigger_event_output( $t_o );
326 my $state = (ref $$env{event} eq 'ARRAY') ? $$env{event}->[0]->state : $env->{event}->state;
327 my $key = ($error) ? 'error_output' : 'template_output';
328 $env->{EventProcessor}->update_state( $state, { $key => $t_o->id } );