Open-ILS/src/perlmods/lib/OpenILS/Application/Storage/Publisher/actor.pm

   1 package OpenILS::Application::Storage::Publisher::actor;
   2 use base qw/OpenILS::Application::Storage/;
   3 use OpenILS::Application::Storage::CDBI::actor;
   4 use OpenSRF::Utils::Logger qw/:level/;
   5 use OpenSRF::Utils qw/:datetime/;
   6 use OpenILS::Utils::Fieldmapper;
   7 use OpenSRF::Utils::SettingsClient;
   8 use OpenILS::Application::AppUtils;
   9 use OpenSRF::Utils::JSON;
  10 use DateTime;
  11 use DateTime::Format::ISO8601;
  12 use DateTime::Set;
  13 use DateTime::SpanSet;
  14
  15 my $U = "OpenILS::Application::AppUtils";
  16 my $JSON = "OpenSRF::Utils::JSON";
  17
  18 my $_dt_parser = DateTime::Format::ISO8601->new;
  19
  20 my $log = 'OpenSRF::Utils::Logger';
  21
  22 sub new_usergroup_id {
  23     return actor::user->db_Main->selectrow_array("select nextval('actor.usr_usrgroup_seq'::regclass)");
  24 }
  25 __PACKAGE__->register_method(
  26     api_name    => 'open-ils.storage.actor.user.group_id.new',
  27     api_level   => 1,
  28     method      => 'new_usergroup_id',
  29 );
  30
  31 sub juv_to_adult {
  32     my $self = shift;
  33     my $client = shift;
  34     my $adult_age = shift;
  35
  36     my $sql = <<"    SQL";
  37         UPDATE actor.usr
  38             SET juvenile = FALSE
  39             WHERE juvenile IS TRUE
  40             AND deleted IS FALSE
  41             AND AGE(dob) > COALESCE( BTRIM( (
  42                     SELECT value FROM actor.org_unit_ancestor_setting(
  43                     'global.juvenile_age_threshold', home_ou)),'"' ), ?)::INTERVAL
  44     SQL
  45
  46     my $sth = actor::user->db_Main->prepare_cached($sql);
  47     $sth->execute($adult_age);
  48
  49     return $sth->rows;
  50 }
  51 __PACKAGE__->register_method(
  52     api_name    => 'open-ils.storage.actor.user.juvenile_to_adult',
  53     api_level   => 1,
  54     method      => 'juv_to_adult',
  55 );
  56
  57 sub usr_total_owed {
  58     my $self = shift;
  59     my $client = shift;
  60     my $usr = shift;
  61
  62     my $sql = <<"    SQL";
  63             SELECT  x.usr,
  64                     SUM(COALESCE((SELECT SUM(b.amount) FROM money.billing b WHERE b.voided IS FALSE AND b.xact = x.id),0.0)) -
  65                         SUM(COALESCE((SELECT SUM(p.amount) FROM money.payment p WHERE p.voided IS FALSE AND p.xact = x.id),0.0))
  66               FROM  money.billable_xact x
  67               WHERE x.usr = ? AND x.xact_finish IS NULL
  68               GROUP BY 1
  69     SQL
  70
  71     my (undef,$val) = actor::user->db_Main->selectrow_array($sql, {}, $usr);
  72
  73     return $val;
  74 }
  75 __PACKAGE__->register_method(
  76     api_name    => 'open-ils.storage.actor.user.total_owed',
  77     api_level   => 1,
  78     method      => 'usr_total_owed',
  79 );
  80
  81 sub usr_breakdown_out {
  82     my $self = shift;
  83     my $client = shift;
  84     my $usr = shift;
  85
  86     $self->method_lookup('open-ils.storage.transaction.begin')->run();
  87
  88     my $out_sql = <<"    SQL";
  89             SELECT  id
  90               FROM  action.circulation
  91               WHERE usr = ?
  92                     AND checkin_time IS NULL
  93                     AND (  (fine_interval >= '1 day' AND due_date >= 'today')
  94                         OR (fine_interval < '1 day'  AND due_date > 'now'   ))
  95                     AND (stop_fines IS NULL
  96                         OR stop_fines NOT IN ('LOST','CLAIMSRETURNED','LONGOVERDUE'))
  97     SQL
  98
  99     my $out = actor::user->db_Main->selectcol_arrayref($out_sql, {}, $usr);
 100
 101     my $od_sql = <<"    SQL";
 102             SELECT  id
 103               FROM  action.circulation
 104               WHERE usr = ?
 105                     AND checkin_time IS NULL
 106                     AND (  (fine_interval >= '1 day' AND due_date < 'today')
 107                         OR (fine_interval < '1 day'  AND due_date < 'now'  ))
 108                     AND (stop_fines IS NULL
 109                         OR stop_fines NOT IN ('LOST','CLAIMSRETURNED','LONGOVERDUE'))
 110     SQL
 111
 112     my $od = actor::user->db_Main->selectcol_arrayref($od_sql, {}, $usr);
 113
 114     my $lost_sql = <<"    SQL";
 115             SELECT  id
 116               FROM  action.circulation
 117               WHERE usr = ? AND checkin_time IS NULL AND xact_finish IS NULL AND stop_fines = 'LOST'
 118     SQL
 119
 120     my $lost = actor::user->db_Main->selectcol_arrayref($lost_sql, {}, $usr);
 121
 122     my $cl_sql = <<"    SQL";
 123             SELECT  id
 124               FROM  action.circulation
 125               WHERE usr = ? AND checkin_time IS NULL AND stop_fines = 'CLAIMSRETURNED'
 126     SQL
 127
 128     my $cl = actor::user->db_Main->selectcol_arrayref($cl_sql, {}, $usr);
 129
 130     my $lo_sql = <<"    SQL";
 131             SELECT  id
 132               FROM  action.circulation
 133               WHERE usr = ? AND checkin_time IS NULL AND stop_fines = 'LONGOVERDUE'
 134     SQL
 135
 136     my $lo = actor::user->db_Main->selectcol_arrayref($lo_sql, {}, $usr);
 137
 138     $self->method_lookup('open-ils.storage.transaction.rollback')->run();
 139
 140     if ($self->api_name =~/count$/o) {
 141         return {    total   => scalar(@$out) + scalar(@$od) + scalar(@$lost) + scalar(@$cl) + scalar(@$lo),
 142                     out     => scalar(@$out),
 143                     overdue => scalar(@$od),
 144                     lost    => scalar(@$lost),
 145                     claims_returned => scalar(@$cl),
 146                     long_overdue        => scalar(@$lo),
 147         };
 148     }
 149
 150     return {    out     => $out,
 151                 overdue => $od,
 152                 lost    => $lost,
 153                 claims_returned => $cl,
 154                 long_overdue        => $lo,
 155     };
 156 }
 157 __PACKAGE__->register_method(
 158     api_name    => 'open-ils.storage.actor.user.checked_out',
 159     api_level   => 1,
 160     method      => 'usr_breakdown_out',
 161 );
 162 __PACKAGE__->register_method(
 163     api_name    => 'open-ils.storage.actor.user.checked_out.count',
 164     api_level   => 1,
 165     method      => 'usr_breakdown_out',
 166 );
 167
 168 sub usr_total_out {
 169     my $self = shift;
 170     my $client = shift;
 171     my $usr = shift;
 172
 173     my $sql = <<"    SQL";
 174             SELECT  count(*)
 175               FROM  action.circulation
 176               WHERE usr = ? AND checkin_time IS NULL
 177     SQL
 178
 179     my ($val) = actor::user->db_Main->selectrow_array($sql, {}, $usr);
 180
 181     return $val;
 182 }
 183 __PACKAGE__->register_method(
 184     api_name    => 'open-ils.storage.actor.user.total_out',
 185     api_level   => 1,
 186     method      => 'usr_total_out',
 187 );
 188
 189 sub calc_proximity {
 190     my $self = shift;
 191     my $client = shift;
 192
 193     local $OpenILS::Application::Storage::WRITE = 1;
 194
 195     my $delete_sql = <<"    SQL";
 196         DELETE FROM actor.org_unit_proximity;
 197     SQL
 198
 199     my $insert_sql = <<"    SQL";
 200         INSERT INTO actor.org_unit_proximity (from_org, to_org, prox)
 201             SELECT  l.id,
 202                 r.id,
 203                 actor.org_unit_proximity(l.id,r.id)
 204               FROM  actor.org_unit l,
 205                 actor.org_unit r;
 206     SQL
 207
 208     actor::org_unit_proximity->db_Main->do($delete_sql);
 209     actor::org_unit_proximity->db_Main->do($insert_sql);
 210
 211     return 1;
 212 }
 213 __PACKAGE__->register_method(
 214     api_name    => 'open-ils.storage.actor.org_unit.refresh_proximity',
 215     api_level   => 1,
 216     method      => 'calc_proximity',
 217 );
 218
 219 sub make_hoo_spanset {
 220     my $hoo = shift;
 221     return undef unless $hoo;
 222
 223     my $today = shift || DateTime->now;
 224
 225     my $tz = OpenSRF::AppSession->create('open-ils.actor')->request(
 226         'open-ils.actor.ou_setting.ancestor_default' => $hoo->id.'' => 'org_unit.timezone'
 227     )->gather(1) || DateTime::TimeZone->new( name => 'local' )->name;
 228
 229     my $current_dow = $today->day_of_week_0;
 230
 231     my $spanset = DateTime::SpanSet->empty_set;
 232     for my $d ( 0 .. 6 ) {
 233
 234         my $omethod = 'dow_'.$d.'_open';
 235         my $cmethod = 'dow_'.$d.'_close';
 236
 237         my $open = interval_to_seconds($hoo->$omethod());
 238         my $close = interval_to_seconds($hoo->$cmethod());
 239
 240         next if ($open == $close && $open == 0);
 241
 242         my $dow_offset = ($d - $current_dow) * $one_day;
 243         $close += $one_day if ($close <= $open);
 244
 245         $spanset = $spanset->union(
 246             DateTime::Span->new(
 247                 start => $today->clone->add( seconds => $dow_offset + $open  ),
 248                 end   => $today->clone->add( seconds => $dow_offset + $close )
 249             )
 250         );
 251     }
 252
 253     return $spanset->complement;
 254 }
 255
 256 sub make_closure_spanset {
 257     my $closures = shift;
 258     return undef unless $closures;
 259
 260     my $spanset = DateTime::SpanSet->empty_set;
 261     for my $k ( keys %$closures ) {
 262         my $c = $$closures{$k};
 263
 264         $spanset = $spanset->union(
 265             DateTime::Span->new(
 266                 start => $_dt_parser->parse_datetime(cleanse_ISO8601($c->{close_start})),
 267                 end   => $_dt_parser->parse_datetime(cleanse_ISO8601($c->{close_end}))
 268             )
 269         );
 270     }
 271
 272     return $spanset;
 273 }
 274
 275 sub new_org_closed_overlap {
 276     my $self = shift;
 277     my $client = shift;
 278     my $ou = shift;
 279     my $date = shift;
 280     my $direction = shift || 0;
 281     my $no_hoo = shift || 0;
 282
 283     return undef unless ($date && $ou);
 284
 285     # we're given a date and a direction, find any closures that contain the date
 286     my $t = actor::org_unit::closed_date->table;
 287     my $sql = <<"    SQL";
 288         SELECT  *
 289           FROM  $t
 290           WHERE close_end > ?
 291             AND org_unit = ?
 292           ORDER BY close_start ASC, close_end DESC
 293           LIMIT 1
 294     SQL
 295
 296     $date = cleanse_ISO8601($date);
 297
 298     my $target_date = $_dt_parser->parse_datetime( $date );
 299     my ($begin, $end) = ($target_date, $target_date);
 300
 301     # create a spanset from the closures that contain the $date
 302     my $closure_spanset = make_closure_spanset(
 303         actor::org_unit::closed_date->db_Main->selectall_hashref( $sql, 'id', {}, $date, $ou )
 304     );
 305
 306     if ($closure_spanset && $closure_spanset->intersects( $target_date )) {
 307         my $closure_intersection = $closure_spanset->intersection( $target_date );
 308         $begin = $closure_intersection->min;
 309         $end = $closure_intersection->max;
 310
 311         if ( $direction <= 0 ) {
 312             $begin->subtract( minutes => 1 );
 313
 314             while ( my $_b = new_org_closed_overlap($self, $client, $ou, $begin->strftime('%FT%T%z'), -1, 1 ) ) {
 315                 $begin = $_dt_parser->parse_datetime( cleanse_ISO8601($_b->{start}) );
 316             }
 317         }
 318
 319         if ( $direction >= 0 ) {
 320             $end->add( minutes => 1 );
 321
 322             while ( my $_a = new_org_closed_overlap($self, $client, $ou, $end->strftime('%FT%T%z'), 1, 1 ) ) {
 323                 $end = $_dt_parser->parse_datetime( cleanse_ISO8601($_a->{end}) );
 324             }
 325         }
 326     }
 327
 328     if ( !$no_hoo ) {
 329
 330         my $begin_hoo = make_hoo_spanset(actor::org_unit::hours_of_operation->retrieve($ou), $begin);
 331         my $end_hoo   = make_hoo_spanset(actor::org_unit::hours_of_operation->retrieve($ou), $end  );
 332
 333
 334         if ( $begin_hoo && $direction <= 0 && $begin_hoo->intersects($begin) ) {
 335             my $hoo_intersection = $begin_hoo->intersection( $begin );
 336             $begin = $hoo_intersection->min;
 337             $begin->subtract( minutes => 1 );
 338
 339             while ( my $_b = new_org_closed_overlap($self, $client, $ou, $begin->strftime('%FT%T%z'), -1 ) ) {
 340                 $begin = $_dt_parser->parse_datetime( cleanse_ISO8601($_b->{start}) );
 341             }
 342         }
 343
 344         if ( $end_hoo && $direction >= 0 && $end_hoo->intersects($end) ) {
 345             my $hoo_intersection = $end_hoo->intersection( $end );
 346             $end = $hoo_intersection->max;
 347             $end->add( minutes => 1 );
 348
 349
 350             while ( my $_b = new_org_closed_overlap($self, $client, $ou, $end->strftime('%FT%T%z'), -1 ) ) {
 351                 $end = $_dt_parser->parse_datetime( cleanse_ISO8601($_b->{end}) );
 352             }
 353         }
 354     }
 355
 356     my $start = $begin->strftime('%FT%T%z');
 357     my $stop = $end->strftime('%FT%T%z');
 358
 359     return undef if ($start eq $stop);
 360     return { start => $start, end => $stop };
 361 }
 362 __PACKAGE__->register_method(
 363     api_name    => 'open-ils.storage.actor.org_unit.closed_date.overlap',
 364     api_level   => 0,
 365     method      => 'new_org_closed_overlap',
 366 );
 367
 368 sub org_closed_overlap {
 369     my $self = shift;
 370     my $client = shift;
 371     my $ou = shift;
 372     my $date = shift;
 373     my $direction = shift || 0;
 374     my $no_hoo = shift || 0;
 375
 376     return undef unless ($date && $ou);
 377
 378     my $t = actor::org_unit::closed_date->table;
 379     my $sql = <<"    SQL";
 380         SELECT  *
 381           FROM  $t
 382           WHERE ? between close_start and close_end
 383             AND org_unit = ?
 384           ORDER BY close_start ASC, close_end DESC
 385           LIMIT 1
 386     SQL
 387
 388     $date = cleanse_ISO8601($date);
 389     my ($begin, $end) = ($date,$date);
 390
 391     my $hoo = actor::org_unit::hours_of_operation->retrieve($ou);
 392
 393     if (my $closure = actor::org_unit::closed_date->db_Main->selectrow_hashref( $sql, {}, $date, $ou )) {
 394         $begin = cleanse_ISO8601($closure->{close_start});
 395         $end = cleanse_ISO8601($closure->{close_end});
 396
 397         if ( $direction <= 0 ) {
 398             $before = $_dt_parser->parse_datetime( $begin );
 399             $before->subtract( minutes => 1 );
 400
 401             while ( my $_b = org_closed_overlap($self, $client, $ou, $before->strftime('%FT%T%z'), -1, 1 ) ) {
 402                 $before = $_dt_parser->parse_datetime( cleanse_ISO8601($_b->{start}) );
 403             }
 404             $begin = cleanse_ISO8601($before->strftime('%FT%T%z'));
 405         }
 406
 407         if ( $direction >= 0 ) {
 408             $after = $_dt_parser->parse_datetime( $end );
 409             $after->add( minutes => 1 );
 410
 411             while ( my $_a = org_closed_overlap($self, $client, $ou, $after->strftime('%FT%T%z'), 1, 1 ) ) {
 412                 $after = $_dt_parser->parse_datetime( cleanse_ISO8601($_a->{end}) );
 413             }
 414             $end = cleanse_ISO8601($after->strftime('%FT%T%z'));
 415         }
 416     }
 417
 418     if ( !$no_hoo ) {
 419         if ( $hoo ) {
 420
 421             if ( $direction <= 0 ) {
 422                 my $begin_dow = $_dt_parser->parse_datetime( $begin )->day_of_week_0;
 423                 my $begin_open_meth = "dow_".$begin_dow."_open";
 424                 my $begin_close_meth = "dow_".$begin_dow."_close";
 425
 426                 my $count = 1;
 427                 while ($hoo->$begin_open_meth eq '00:00:00' and $hoo->$begin_close_meth eq '00:00:00') {
 428                     $begin = cleanse_ISO8601($_dt_parser->parse_datetime( $begin )->subtract( days => 1)->strftime('%FT%T%z'));
 429                     $begin_dow++;
 430                     $begin_dow %= 7;
 431                     $count++;
 432                     last if ($count > 6);
 433                     $begin_open_meth = "dow_".$begin_dow."_open";
 434                     $begin_close_meth = "dow_".$begin_dow."_close";
 435                 }
 436
 437                 if (my $closure = actor::org_unit::closed_date->db_Main->selectrow_hashref( $sql, {}, $begin, $ou )) {
 438                     $before = $_dt_parser->parse_datetime( $begin );
 439                     $before->subtract( minutes => 1 );
 440                     while ( my $_b = org_closed_overlap($self, $client, $ou, $before->strftime('%FT%T%z'), -1 ) ) {
 441                         $before = $_dt_parser->parse_datetime( cleanse_ISO8601($_b->{start}) );
 442                     }
 443                 }
 444             }
 445
 446             if ( $direction >= 0 ) {
 447                 my $end_dow = $_dt_parser->parse_datetime( $end )->day_of_week_0;
 448                 my $end_open_meth = "dow_".$end_dow."_open";
 449                 my $end_close_meth = "dow_".$end_dow."_close";
 450
 451                 $count = 1;
 452                 while ($hoo->$end_open_meth eq '00:00:00' and $hoo->$end_close_meth eq '00:00:00') {
 453                     $end = cleanse_ISO8601($_dt_parser->parse_datetime( $end )->add( days => 1)->strftime('%FT%T%z'));
 454                     $end_dow++;
 455                     $end_dow %= 7;
 456                     $count++;
 457                     last if ($count > 6);
 458                     $end_open_meth = "dow_".$end_dow."_open";
 459                     $end_close_meth = "dow_".$end_dow."_close";
 460                 }
 461
 462                 if (my $closure = actor::org_unit::closed_date->db_Main->selectrow_hashref( $sql, {}, $end, $ou )) {
 463                     $after = $_dt_parser->parse_datetime( $end );
 464                     $after->add( minutes => 1 );
 465
 466                     while ( my $_a = org_closed_overlap($self, $client, $ou, $after->strftime('%FT%T%z'), 1 ) ) {
 467                         $after = $_dt_parser->parse_datetime( cleanse_ISO8601($_a->{end}) );
 468                     }
 469                     $end = cleanse_ISO8601($after->strftime('%FT%T%z'));
 470                 }
 471             }
 472
 473         }
 474     }
 475
 476     if ($begin eq $date && $end eq $date) {
 477         return undef;
 478     }
 479
 480     return { start => $begin, end => $end };
 481 }
 482 __PACKAGE__->register_method(
 483     api_name    => 'open-ils.storage.actor.org_unit.closed_date.overlap',
 484     api_level   => 1,
 485     method      => 'org_closed_overlap',
 486 );
 487
 488 sub user_by_barcode {
 489     my $self = shift;
 490     my $client = shift;
 491     my @barcodes = shift;
 492
 493     return undef unless @barcodes;
 494
 495     for my $card ( actor::card->search( { barcode => @barcodes } ) ) {
 496         next unless $card;
 497         if (@barcodes == 1) {
 498             return $card->usr->to_fieldmapper;
 499         }
 500         $client->respond( $card->usr->to_fieldmapper);
 501     }
 502     return undef;
 503 }
 504 __PACKAGE__->register_method(
 505     api_name    => 'open-ils.storage.direct.actor.user.search.barcode',
 506     api_level   => 1,
 507     method      => 'user_by_barcode',
 508     stream      => 1,
 509     cachable    => 1,
 510 );
 511
 512 sub lost_barcodes {
 513     my $self = shift;
 514     my $client = shift;
 515
 516     my $c = actor::card->table;
 517     my $p = actor::user->table;
 518
 519     my $sql = "SELECT c.barcode FROM $c c JOIN $p p ON (c.usr = p.id) WHERE p.card <> c.id";
 520
 521     my $list = actor::user->db_Main->selectcol_arrayref($sql);
 522     for my $bc ( @$list ) {
 523         $client->respond($bc);
 524     }
 525     return undef;
 526 }
 527 __PACKAGE__->register_method(
 528     api_name    => 'open-ils.storage.actor.user.lost_barcodes',
 529     api_level   => 1,
 530     stream      => 1,
 531     method      => 'lost_barcodes',
 532     signature    => <<'    NOTE',
 533         Returns an array of barcodes that belong to lost cards.
 534         @return array of barcodes
 535     NOTE
 536 );
 537
 538 sub expired_barcodes {
 539     my $self = shift;
 540     my $client = shift;
 541
 542     my $c = actor::card->table;
 543     my $p = actor::user->table;
 544
 545     my $sql = "SELECT c.barcode FROM $c c JOIN $p p ON (c.usr = p.id) WHERE p.expire_date < CURRENT_DATE";
 546
 547     my $list = actor::user->db_Main->selectcol_arrayref($sql);
 548     for my $bc ( @$list ) {
 549         $client->respond($bc);
 550     }
 551     return undef;
 552 }
 553 __PACKAGE__->register_method(
 554     api_name    => 'open-ils.storage.actor.user.expired_barcodes',
 555     api_level   => 1,
 556     stream      => 1,
 557     method      => 'expired_barcodes',
 558     signature    => <<'    NOTE',
 559         Returns an array of barcodes that are currently expired.
 560         @return array of barcodes
 561     NOTE
 562 );
 563
 564 sub barred_barcodes {
 565     my $self = shift;
 566     my $client = shift;
 567
 568     my $c = actor::card->table;
 569     my $p = actor::user->table;
 570
 571     my $sql = "SELECT c.barcode FROM $c c JOIN $p p ON (c.usr = p.id) WHERE p.barred IS TRUE";
 572
 573     my $list = actor::user->db_Main->selectcol_arrayref($sql);
 574     for my $bc ( @$list ) {
 575         $client->respond($bc);
 576     }
 577     return undef;
 578 }
 579 __PACKAGE__->register_method(
 580     api_name    => 'open-ils.storage.actor.user.barred_barcodes',
 581     api_level   => 1,
 582     stream      => 1,
 583     method      => 'barred_barcodes',
 584     signature    => <<'    NOTE',
 585         Returns an array of barcodes that are currently barred.
 586         @return array of barcodes
 587     NOTE
 588 );
 589
 590 sub penalized_barcodes {
 591     my $self = shift;
 592     my $client = shift;
 593
 594     my $c = actor::card->table;
 595     my $p = actor::user_standing_penalty->table;
 596
 597     my $sql = <<"    SQL";
 598         SELECT  DISTINCT c.barcode
 599           FROM  $c c
 600             JOIN $p p USING (usr)
 601             JOIN config.standing_penalty csp ON (csp.id = p.standing_penalty)
 602           WHERE csp.block_list IS NOT NULL
 603             AND p.set_date < CURRENT_DATE
 604             AND (p.stop_date IS NULL OR p.stop_date > CURRENT_DATE);
 605     SQL
 606
 607     my $list = actor::user->db_Main->selectcol_arrayref($sql);
 608     for my $bc ( @$list ) {
 609         $client->respond($bc);
 610     }
 611     return undef;
 612 }
 613 __PACKAGE__->register_method(
 614     api_name    => 'open-ils.storage.actor.user.penalized_barcodes',
 615     api_level   => 1,
 616     stream      => 1,
 617     method      => 'penalized_barcodes',
 618     signature    => <<'    NOTE',
 619         Returns an array of barcodes that have blocking penalties.
 620         @return array of barcodes
 621     NOTE
 622 );
 623
 624 sub _prepare_name_argument {
 625     # Get rid of extra spaces, accents, and regex characters
 626     my ($search) = _clean_regex_chars(@_);
 627     my $sth = actor::user->db_Main->prepare_cached("SELECT evergreen.unaccent_and_squash(?)");
 628     $sth->execute($search);
 629     my $r = $sth->fetch;
 630     return ($r && @$r) ? $r->[0] : $search;
 631 };
 632
 633 sub _clean_regex_chars {
 634     my ($search) = @_;
 635
 636     # Escape metacharacters for SIMILAR TO
 637     # (http://www.postgresql.org/docs/8.4/interactive/functions-matching.html)
 638     $search =~ s/\_/\\_/g;
 639     $search =~ s/\%/\\%/g;
 640     $search =~ s/\|/\\|/g;
 641     $search =~ s/\*/\\*/g;
 642     $search =~ s/\+/\\+/g;
 643     $search =~ s/\[/\\[/g;
 644     $search =~ s/\]/\\]/g;
 645     $search =~ s/\(/\\(/g;
 646     $search =~ s/\)/\\)/g;
 647
 648     return $search;
 649 }
 650
 651 sub patron_search {
 652     my $self = shift;
 653     my $client = shift;
 654     my $search = shift;
 655     my $limit = shift || 1000;
 656     my $sort = shift;
 657     my $inactive = shift;
 658     my $ws_ou = shift;
 659     my $search_org = shift || $ws_ou;
 660     my $opt_boundary = shift || 0;
 661     my $offset = shift || 0;
 662
 663     my $penalty_sort = 0;
 664
 665     my $strict_opt_in = OpenSRF::Utils::SettingsClient->new->config_value( share => user => 'opt_in' );
 666
 667     $sort = ['family_name','first_given_name'] unless ($$sort[0]);
 668     push @$sort,'id';
 669
 670     if ($$sort[0] eq 'penalties') {
 671         shift @$sort;
 672         $penalty_sort = 1;
 673     }
 674
 675     # group 0 = user
 676     # group 1 = address
 677     # group 2 = phone, ident
 678     # group 3 = barcode
 679
 680     # Treatment of name fields depends on whether the org has
 681     # diacritic_insensitivity turned on or off.
 682
 683     my $diacritic_insensitive =  $U->ou_ancestor_setting_value($ws_ou, 'circ.patron_search.diacritic_insensitive');
 684     # Parse from JSON to Perl boolean (1|0):
 685     $diacritic_insensitive = ($diacritic_insensitive) ? $JSON->JSON2perl($diacritic_insensitive) : 0;
 686     my $usr;
 687     my @usrv;
 688
 689     if ($diacritic_insensitive) {
 690        $usr = join ' AND ', map { "evergreen.unaccent_and_squash(CAST($_ AS text)) ~ ?" } grep { ''.$$search{$_}{group} eq '0' } keys %$search;
 691        @usrv = map { "^" . _prepare_name_argument($$search{$_}{value}) } grep { ''.$$search{$_}{group} eq '0' } keys %$search;
 692
 693     } else {
 694        $usr = join ' AND ', map { "evergreen.lowercase(CAST($_ AS text)) ~ ?" } grep { ''.$$search{$_}{group} eq '0' } keys %$search;
 695        @usrv = map { "^" . _clean_regex_chars($$search{$_}{value}) } grep { ''.$$search{$_}{group} eq '0' } keys %$search;
 696     }
 697
 698     my $addr = join ' AND ', map { "evergreen.lowercase(CAST($_ AS text)) ~ ?" } grep { ''.$$search{$_}{group} eq '1' } keys %$search;
 699     my @addrv = map { "^" . _clean_regex_chars($$search{$_}{value}) } grep { ''.$$search{$_}{group} eq '1' } keys %$search;
 700
 701     my $pv = _clean_regex_chars($$search{phone}{value});
 702     my $iv = _clean_regex_chars($$search{ident}{value});
 703     my $nv = _clean_regex_chars($$search{name}{value});
 704     my $cv = _clean_regex_chars($$search{card}{value});
 705
 706     my $card = '';
 707     if ($cv) {
 708         $card = 'JOIN (SELECT DISTINCT usr FROM actor.card WHERE evergreen.lowercase(barcode) LIKE ?||\'%\') AS card ON (card.usr = users.id)';
 709         unshift(@usrv, $cv);
 710     }
 711
 712     my $phone = '';
 713     my @ps;
 714     my @phonev;
 715     if ($pv) {
 716         for my $p ( qw/day_phone evening_phone other_phone/ ) {
 717             if ($pv =~ /^\d+$/) {
 718                 push @ps, "evergreen.lowercase(REGEXP_REPLACE($p, '[^0-9]', '', 'g')) ~ ?";
 719             } else {
 720                 push @ps, "evergreen.lowercase($p) ~ ?";
 721             }
 722             push @phonev, "^$pv";
 723         }
 724         $phone = '(' . join(' OR ', @ps) . ')';
 725     }
 726
 727     my $ident = '';
 728     my @is;
 729     my @identv;
 730     if ($iv) {
 731         for my $i ( qw/ident_value ident_value2/ ) {
 732             push @is, "evergreen.lowercase($i) ~ ?";
 733             push @identv, "^$iv";
 734         }
 735         $ident = '(' . join(' OR ', @is) . ')';
 736     }
 737
 738     my $name = '';
 739     my @ns;
 740     my @namev;
 741     if (0 && $nv) {
 742         for my $n ( qw/first_given_name second_given_name family_name/ ) {
 743             if ($diacritic_insensitive) {
 744                 push @ns, "evergreen.unaccent_and_squash($n) ~ ?";
 745             } else {
 746                 push @ns, "evergreen.lowercase($n) ~ ?";
 747             }
 748             push @namev, "^$nv";
 749         }
 750         $name = '(' . join(' OR ', @ns) . ')';
 751     }
 752
 753     my $usr_where = join ' AND ', grep { $_ } ($usr,$phone,$ident,$name);
 754     my $addr_where = $addr;
 755
 756
 757     my $u_table = actor::user->table;
 758     my $a_table = actor::user_address->table;
 759     my $opt_in_table = actor::usr_org_unit_opt_in->table;
 760     my $ou_table = actor::org_unit->table;
 761
 762     my $u_select = "SELECT id as id FROM $u_table u WHERE $usr_where";
 763     my $a_select = "SELECT u.id as id FROM $a_table a JOIN $u_table u ON (u.mailing_address = a.id OR u.billing_address = a.id) WHERE $addr_where";
 764
 765     my $clone_select = '';
 766
 767     #$clone_select = "JOIN (SELECT cu.id as id FROM $a_table ca ".
 768     #          "JOIN $u_table cu ON (cu.mailing_address = ca.id OR cu.billing_address = ca.id) ".
 769     #          "WHERE $addr_where) AS clone ON (clone.id = users.id)" if ($addr_where);
 770
 771     my $select = '';
 772     if ($usr_where) {
 773         if ($addr_where) {
 774             $select = "$u_select INTERSECT $a_select";
 775         } else {
 776             $select = $u_select;
 777         }
 778     } elsif ($addr_where) {
 779         $select = "$a_select";
 780     }
 781
 782     return undef if (!$select && !$card);
 783
 784     my $order_by = join ', ', map { 'evergreen.lowercase(CAST(users.'. (split / /,$_)[0] . ' AS text)) ' . (split / /,$_)[1] } @$sort;
 785     my $distinct_list = join ', ', map { 'evergreen.lowercase(CAST(users.'. (split / /,$_)[0] . ' AS text))' } @$sort;
 786     my $group_list = $distinct_list;
 787
 788     if ($inactive) {
 789         $inactive = '';
 790     } else {
 791         $inactive = 'AND users.active = TRUE';
 792     }
 793
 794     if (!$ws_ou) {  # XXX This should be required!!
 795         $ws_ou = actor::org_unit->search( { parent_ou => undef } )->next->id;
 796     }
 797
 798     my $descendants = "actor.org_unit_descendants($search_org)";
 799
 800     my $opt_in_where = '';
 801     if (lc($strict_opt_in) eq 'true') {
 802         $opt_in_where = "AND (";
 803         $opt_in_where .= "EXISTS (select id FROM $opt_in_table ";
 804         $opt_in_where .= " WHERE org_unit in (select (actor.org_unit_ancestors($ws_ou)).id)";
 805         $opt_in_where .= " AND usr = users.id) ";
 806         $opt_in_where .= "OR";
 807         $opt_in_where .= " users.home_ou IN (select (actor.org_unit_descendants($ws_ou,$opt_boundary)).id))";
 808     }
 809
 810     my $penalty_join = '';
 811     if ($penalty_sort) {
 812         $distinct_list = 'COUNT(penalties.id), ' . $distinct_list;
 813         $order_by = 'COUNT(penalties.id) DESC, ' . $order_by;
 814         unshift @$sort, 'COUNT(penalties.id)';
 815         $penalty_join = <<"        SQL";
 816             LEFT JOIN actor.usr_standing_penalty penalties
 817                 ON (users.id = penalties.usr AND (penalties.stop_date IS NULL OR penalties.stop_date > NOW()))
 818         SQL
 819     }
 820
 821     $select = "JOIN ($select) AS search ON (search.id = users.id)" if ($select);
 822     $select = <<"    SQL";
 823         SELECT  $distinct_list
 824           FROM  $u_table AS users $card
 825             JOIN $descendants d ON (d.id = users.home_ou)
 826             $select
 827             $clone_select
 828             $penalty_join
 829           WHERE users.deleted = FALSE
 830             $inactive
 831             $opt_in_where
 832           GROUP BY $group_list
 833           ORDER BY $order_by
 834           LIMIT $limit
 835           OFFSET $offset
 836     SQL
 837
 838     return actor::user->db_Main->selectcol_arrayref($select, {Columns=>[scalar(@$sort)]}, map {lc($_)} (@usrv,@phonev,@identv,@namev,@addrv));
 839 }
 840 __PACKAGE__->register_method(
 841     api_name    => 'open-ils.storage.actor.user.crazy_search',
 842     api_level   => 1,
 843     method      => 'patron_search',
 844 );
 845
 846 sub org_unit_list {
 847     my $self = shift;
 848     my $client = shift;
 849
 850     my $select =<<"    SQL";
 851     SELECT  *
 852       FROM  actor.org_unit
 853       ORDER BY CASE WHEN parent_ou IS NULL THEN 0 ELSE 1 END, name;
 854     SQL
 855
 856     my $sth = actor::org_unit->db_Main->prepare_cached($select);
 857     $sth->execute;
 858
 859     $client->respond( $_->to_fieldmapper ) for ( map { actor::org_unit->construct($_) } $sth->fetchall_hash );
 860
 861     return undef;
 862 }
 863 __PACKAGE__->register_method(
 864     api_name    => 'open-ils.storage.direct.actor.org_unit.retrieve.all',
 865     api_level   => 1,
 866     stream      => 1,
 867     method      => 'org_unit_list',
 868 );
 869
 870 sub org_unit_type_list {
 871     my $self = shift;
 872     my $client = shift;
 873
 874     my $select =<<"    SQL";
 875     SELECT  *
 876       FROM  actor.org_unit_type
 877       ORDER BY depth, name;
 878     SQL
 879
 880     my $sth = actor::org_unit_type->db_Main->prepare_cached($select);
 881     $sth->execute;
 882
 883     $client->respond( $_->to_fieldmapper ) for ( map { actor::org_unit_type->construct($_) } $sth->fetchall_hash );
 884
 885     return undef;
 886 }
 887 __PACKAGE__->register_method(
 888     api_name    => 'open-ils.storage.direct.actor.org_unit_type.retrieve.all',
 889     api_level   => 1,
 890     stream      => 1,
 891     method      => 'org_unit_type_list',
 892 );
 893
 894 sub org_unit_full_path {
 895     my $self = shift;
 896     my $client = shift;
 897     my @binds = @_;
 898
 899     return undef unless (@binds);
 900
 901     my $func = 'actor.org_unit_full_path(?)';
 902     $func = 'actor.org_unit_full_path(?,?)' if (@binds > 1);
 903
 904     my $sth = actor::org_unit->db_Main->prepare_cached("SELECT * FROM $func");
 905     $sth->execute(@binds);
 906
 907     $client->respond( $_->to_fieldmapper ) for ( map { actor::org_unit->construct($_) } $sth->fetchall_hash );
 908
 909     return undef;
 910 }
 911 __PACKAGE__->register_method(
 912     api_name    => 'open-ils.storage.actor.org_unit.full_path',
 913     api_level   => 1,
 914     stream      => 1,
 915     method      => 'org_unit_full_path',
 916 );
 917
 918 sub org_unit_ancestors {
 919     my $self = shift;
 920     my $client = shift;
 921     my $id = shift;
 922
 923     return undef unless ($id);
 924
 925     my $func = 'actor.org_unit_ancestors(?)';
 926
 927     my $sth = actor::org_unit->db_Main->prepare_cached(<<"    SQL");
 928         SELECT  f.*
 929           FROM  $func f
 930             JOIN actor.org_unit_type t ON (f.ou_type = t.id)
 931           ORDER BY t.depth, f.name;
 932     SQL
 933     $sth->execute(''.$id);
 934
 935     $client->respond( $_->to_fieldmapper ) for ( map { actor::org_unit->construct($_) } $sth->fetchall_hash );
 936
 937     return undef;
 938 }
 939 __PACKAGE__->register_method(
 940     api_name    => 'open-ils.storage.actor.org_unit.ancestors',
 941     api_level   => 1,
 942     stream      => 1,
 943     method      => 'org_unit_ancestors',
 944 );
 945
 946 sub org_unit_descendants {
 947     my $self = shift;
 948     my $client = shift;
 949     my $id = shift;
 950     my $depth = shift;
 951
 952     return undef unless ($id);
 953
 954     my $func = 'actor.org_unit_descendants(?)';
 955     if (defined $depth) {
 956         $func = 'actor.org_unit_descendants(?,?)';
 957     }
 958
 959     my $sth = actor::org_unit->db_Main->prepare_cached("SELECT * FROM $func");
 960     $sth->execute(''.$id, ''.$depth) if (defined $depth);
 961     $sth->execute(''.$id) unless (defined $depth);
 962
 963     $client->respond( $_->to_fieldmapper ) for ( map { actor::org_unit->construct($_) } $sth->fetchall_hash );
 964
 965     return undef;
 966 }
 967 __PACKAGE__->register_method(
 968     api_name    => 'open-ils.storage.actor.org_unit.descendants',
 969     api_level   => 1,
 970     stream      => 1,
 971     method      => 'org_unit_descendants',
 972 );
 973
 974 sub fleshed_actor_stat_cat {
 975         my $self = shift;
 976         my $client = shift;
 977         my @list = @_;
 978
 979     @list = ($list[0]) unless ($self->api_name =~ /batch/o);
 980
 981     for my $sc (@list) {
 982         my $cat = actor::stat_cat->retrieve($sc);
 983         next unless ($cat);
 984
 985         my $sc_fm = $cat->to_fieldmapper;
 986         $sc_fm->entries( [ map { $_->to_fieldmapper } $cat->entries ] );
 987         $sc_fm->default_entries( [ map { $_->to_fieldmapper } $cat->default_entries ] );
 988
 989         $client->respond( $sc_fm );
 990
 991     }
 992
 993     return undef;
 994 }
 995 __PACKAGE__->register_method(
 996         api_name        => 'open-ils.storage.fleshed.actor.stat_cat.retrieve',
 997         api_level       => 1,
 998     argc        => 1,
 999         method          => 'fleshed_actor_stat_cat',
1000 );
1001
1002 __PACKAGE__->register_method(
1003         api_name        => 'open-ils.storage.fleshed.actor.stat_cat.retrieve.batch',
1004         api_level       => 1,
1005     argc        => 1,
1006         stream          => 1,
1007         method          => 'fleshed_actor_stat_cat',
1008 );
1009
1010 #XXX Fix stored proc calls
1011 sub ranged_actor_stat_cat_all {
1012         my $self = shift;
1013         my $client = shift;
1014         my $ou = ''.shift();
1015
1016         return undef unless ($ou);
1017         my $s_table = actor::stat_cat->table;
1018
1019         my $select = <<"        SQL";
1020                 SELECT  s.*
1021                   FROM  $s_table s
1022                         JOIN actor.org_unit_full_path(?) p ON (p.id = s.owner)
1023           ORDER BY name
1024         SQL
1025
1026     $fleshed = 0;
1027     $fleshed = 1 if ($self->api_name =~ /fleshed/o);
1028
1029         my $sth = actor::stat_cat->db_Main->prepare_cached($select);
1030         $sth->execute($ou);
1031
1032         for my $sc ( map { actor::stat_cat->construct($_) } $sth->fetchall_hash ) {
1033         my $sc_fm = $sc->to_fieldmapper;
1034         $sc_fm->entries(
1035             [ $self->method_lookup( 'open-ils.storage.ranged.actor.stat_cat_entry.search.stat_cat' )->run($ou,$sc->id) ]
1036         ) if ($fleshed);
1037         $sc_fm->default_entries(
1038             [ $self->method_lookup( 'open-ils.storage.actor.stat_cat_entry_default.ancestor.retrieve' )->run($ou,$sc->id) ]
1039         ) if ($fleshed);
1040         $client->respond( $sc_fm );
1041     }
1042
1043         return undef;
1044 }
1045 __PACKAGE__->register_method(
1046         api_name        => 'open-ils.storage.ranged.fleshed.actor.stat_cat.all',
1047         api_level       => 1,
1048     argc        => 1,
1049         stream          => 1,
1050         method          => 'ranged_actor_stat_cat_all',
1051 );
1052
1053 __PACKAGE__->register_method(
1054         api_name        => 'open-ils.storage.ranged.actor.stat_cat.all',
1055         api_level       => 1,
1056     argc        => 1,
1057         stream          => 1,
1058         method          => 'ranged_actor_stat_cat_all',
1059 );
1060
1061 #XXX Fix stored proc calls
1062 sub ranged_actor_stat_cat_entry {
1063         my $self = shift;
1064         my $client = shift;
1065         my $ou = ''.shift();
1066         my $sc = ''.shift();
1067
1068         return undef unless ($ou);
1069         my $s_table = actor::stat_cat_entry->table;
1070
1071         my $select = <<"        SQL";
1072                 SELECT  s.*
1073                   FROM  $s_table s
1074                         JOIN actor.org_unit_full_path(?) p ON (p.id = s.owner)
1075           WHERE stat_cat = ?
1076           ORDER BY name
1077         SQL
1078
1079         my $sth = actor::stat_cat->db_Main->prepare_cached($select);
1080         $sth->execute($ou,$sc);
1081
1082         for my $sce ( map { actor::stat_cat_entry->construct($_) } $sth->fetchall_hash ) {
1083         my $sce_fm = $sce->to_fieldmapper;
1084         $client->respond( $sce_fm );
1085     }
1086
1087         return undef;
1088 }
1089 __PACKAGE__->register_method(
1090         api_name        => 'open-ils.storage.ranged.actor.stat_cat_entry.search.stat_cat',
1091         api_level       => 1,
1092         stream          => 1,
1093         method          => 'ranged_actor_stat_cat_entry',
1094 );
1095
1096 sub actor_stat_cat_entry_default {
1097     my $self = shift;
1098     my $client = shift;
1099     my $ou = ''.shift();
1100     my $sc = ''.shift();
1101
1102     return undef unless ($ou);
1103     my $s_table = actor::stat_cat_entry_default->table;
1104
1105     my $select = <<"    SQL";
1106          SELECT  s.*
1107          FROM  $s_table s
1108          WHERE owner = ? AND stat_cat = ?
1109     SQL
1110
1111     my $sth = actor::stat_cat->db_Main->prepare_cached($select);
1112     $sth->execute($ou,$sc);
1113
1114     for my $sced ( map { actor::stat_cat_entry_default->construct($_) } $sth->fetchall_hash ) {
1115         $client->respond( $sced->to_fieldmapper );
1116     }
1117
1118     return undef;
1119 }
1120 __PACKAGE__->register_method(
1121     api_name        => 'open-ils.storage.actor.stat_cat_entry_default.retrieve',
1122     api_level       => 1,
1123     stream          => 1,
1124     method          => 'actor_stat_cat_entry_default',
1125 );
1126
1127 sub actor_stat_cat_entry_default_ancestor {
1128     my $self = shift;
1129     my $client = shift;
1130     my $ou = ''.shift();
1131     my $sc = ''.shift();
1132
1133     return undef unless ($ou);
1134     my $s_table = actor::stat_cat_entry_default->table;
1135
1136     my $select = <<"    SQL";
1137         SELECT  s.*
1138         FROM  $s_table s
1139         JOIN actor.org_unit_ancestors(?) p ON (p.id = s.owner)
1140         WHERE stat_cat = ?
1141     SQL
1142
1143     my $sth = actor::stat_cat->db_Main->prepare_cached($select);
1144     $sth->execute($ou,$sc);
1145
1146     my @sced =  map { actor::stat_cat_entry_default->construct($_) } $sth->fetchall_hash;
1147
1148     my $ancestor_sced = pop @sced;
1149
1150     $client->respond( $ancestor_sced->to_fieldmapper ) if $ancestor_sced;
1151
1152     return undef;
1153 }
1154 __PACKAGE__->register_method(
1155     api_name        => 'open-ils.storage.actor.stat_cat_entry_default.ancestor.retrieve',
1156     api_level       => 1,
1157     stream          => 1,
1158     method          => 'actor_stat_cat_entry_default_ancestor',
1159 );
1160
1161 1;