Open-ILS/xul/staff_client/server/circ/util.js

   1 dump('entering circ/util.js\n');
   2
   3 if (typeof circ == 'undefined') var circ = {};
   4 circ.util = {};
   5
   6 circ.util.EXPORT_OK     = [
   7         'columns', 'hold_columns', 'CHECKIN_VIA_BARCODE', 'std_map_row_to_column', 'hold_capture_via_copy_barcode'
   8 ];
   9 circ.util.EXPORT_TAGS   = { ':all' : circ.util.EXPORT_OK };
  10
  11 circ.util.columns = function(modify) {
  12
  13         JSAN.use('OpenILS.data'); var data = new OpenILS.data(); data.init({'via':'stash'});
  14
  15         function getString(s) { return data.entities[s]; }
  16
  17         var c = [
  18                 {
  19                         'id' : 'acp_id', 'label' : getString('staff.acp_label_id'), 'flex' : 1,
  20                         'primary' : false, 'hidden' : true, 'render' : 'my.acp.id()'
  21                 },
  22                 {
  23                         'id' : 'circ_id', 'label' : getString('staff.circ_label_id'), 'flex' : 1,
  24                         'primary' : false, 'hidden' : true, 'render' : 'my.circ.id()'
  25                 },
  26                 {
  27                         'id' : 'mvr_doc_id', 'label' : getString('staff.mvr_label_doc_id'), 'flex' : 1,
  28                         'primary' : false, 'hidden' : true, 'render' : 'my.mvr.doc_id()'
  29                 },
  30                 {
  31                         'id' : 'barcode', 'label' : getString('staff.acp_label_barcode'), 'flex' : 1,
  32                         'primary' : false, 'hidden' : true, 'render' : 'my.acp.barcode()'
  33                 },
  34                 {
  35                         'id' : 'call_number', 'label' : getString('staff.acp_label_call_number'), 'flex' : 1,
  36                         'primary' : false, 'hidden' : true, 'render' : 'if (my.acp.call_number() == -1) { "Not Cataloged"; } else { var x = obj.network.simple_request("FM_ACN_RETRIEVE",[ my.acp.call_number() ]); if (x.ilsevent) { "Not Cataloged"; } else { x.label(); } }'
  37                 },
  38                 {
  39                         'id' : 'copy_number', 'label' : getString('staff.acp_label_copy_number'), 'flex' : 1,
  40                         'primary' : false, 'hidden' : true, 'render' : 'my.acp.copy_number()'
  41                 },
  42                 {
  43                         'id' : 'location', 'label' : getString('staff.acp_label_location'), 'flex' : 1,
  44                         'primary' : false, 'hidden' : true, 'render' : 'obj.data.hash.acpl[ my.acp.location() ].name()'
  45                 },
  46                 {
  47                         'id' : 'loan_duration', 'label' : getString('staff.acp_label_loan_duration'), 'flex' : 1,
  48                         'primary' : false, 'hidden' : true,
  49                         'render' : 'switch(my.acp.loan_duration()){ case 1: "Short"; break; case 2: "Normal"; break; case 3: "Long"; break; }'
  50                 },
  51                 {
  52                         'id' : 'circ_lib', 'label' : getString('staff.acp_label_circ_lib'), 'flex' : 1,
  53                         'primary' : false, 'hidden' : true, 'render' : 'obj.data.hash.aou[ my.acp.circ_lib() ].shortname()'
  54                 },
  55                 {
  56                         'id' : 'fine_level', 'label' : getString('staff.acp_label_fine_level'), 'flex' : 1,
  57                         'primary' : false, 'hidden' : true,
  58                         'render' : 'switch(my.acp.fine_level()){ case 1: "Low"; break; case 2: "Normal"; break; case 3: "High"; break; }'
  59                 },
  60                 {
  61                         'id' : 'deposit', 'label' : getString('staff.acp_label_deposit'), 'flex' : 1,
  62                         'primary' : false, 'hidden' : true, 'render' : 'my.acp.deposit()'
  63                 },
  64                 {
  65                         'id' : 'deposit_amount', 'label' : getString('staff.acp_label_deposit_amount'), 'flex' : 1,
  66                         'primary' : false, 'hidden' : true, 'render' : 'my.acp.deposit_amount()'
  67                 },
  68                 {
  69                         'id' : 'price', 'label' : getString('staff.acp_label_price'), 'flex' : 1,
  70                         'primary' : false, 'hidden' : true, 'render' : 'my.acp.price()'
  71                 },
  72                 {
  73                         'id' : 'circ_as_type', 'label' : getString('staff.acp_label_circ_as_type'), 'flex' : 1,
  74                         'primary' : false, 'hidden' : true, 'render' : 'my.acp.circ_as_type()'
  75                 },
  76                 {
  77                         'id' : 'circ_modifier', 'label' : getString('staff.acp_label_circ_modifier'), 'flex' : 1,
  78                         'primary' : false, 'hidden' : true, 'render' : 'my.acp.circ_modifier()'
  79                 },
  80                 {
  81                         'id' : 'xact_start', 'label' : getString('staff.circ_label_xact_start'), 'flex' : 1,
  82                         'primary' : false, 'hidden' : true, 'render' : 'my.circ.xact_start()'
  83                 },
  84                 {
  85                         'id' : 'xact_finish', 'label' : getString('staff.circ_label_xact_finish'), 'flex' : 1,
  86                         'primary' : false, 'hidden' : true, 'render' : 'my.circ.xact_finish()'
  87                 },
  88                 {
  89                         'id' : 'due_date', 'label' : getString('staff.circ_label_due_date'), 'flex' : 1,
  90                         'primary' : false, 'hidden' : true, 'render' : 'my.circ.due_date().substr(0,10)'
  91                 },
  92                 {
  93                         'id' : 'title', 'label' : getString('staff.mvr_label_title'), 'flex' : 2,
  94                         'primary' : false, 'hidden' : true, 'render' : 'try { my.mvr.title(); } catch(E) { my.acp.dummy_title(); }'
  95                 },
  96                 {
  97                         'id' : 'author', 'label' : getString('staff.mvr_label_author'), 'flex' : 1,
  98                         'primary' : false, 'hidden' : true, 'render' : 'try { my.mvr.author(); } catch(E) { my.acp.dummy_author(); }'
  99                 },
 100                 {
 101                         'id' : 'renewal_remaining', 'label' : getString('staff.circ_label_renewal_remaining'), 'flex' : 0,
 102                         'primary' : false, 'hidden' : true, 'render' : 'my.circ.renewal_remaining()'
 103                 },
 104                 {
 105                         'id' : 'status', 'label' : getString('staff.acp_label_status'), 'flex' : 1,
 106                         'primary' : false, 'hidden' : true, 'render' : 'obj.data.hash.ccs[ my.acp.status() ].name()'
 107                 },
 108                 {
 109                         'id' : 'route_to', 'label' : 'Route To', 'flex' : 1,
 110                         'primary' : false, 'hidden' : true, 'render' : 'my.route_to.toString()'
 111                 },
 112                 {
 113                         'id' : 'message', 'label' : 'Message', 'flex' : 1,
 114                         'primary' : false, 'hidden' : true, 'render' : 'my.message.toString()'
 115                 }
 116
 117         ];
 118         for (var i = 0; i < c.length; i++) {
 119                 if (modify[ c[i].id ]) {
 120                         for (var j in modify[ c[i].id ]) {
 121                                 c[i][j] = modify[ c[i].id ][j];
 122                         }
 123                 }
 124         }
 125         return c;
 126 }
 127
 128 circ.util.hold_columns = function(modify) {
 129
 130         JSAN.use('OpenILS.data'); var data = new OpenILS.data(); data.init({'via':'stash'});
 131
 132         function getString(s) { return data.entities[s]; }
 133
 134         var c = [
 135                 {
 136                         'id' : 'request_time', 'label' : getString('staff.ahr_request_time_label'), 'flex' : 0,
 137                         'primary' : false, 'hidden' : true,
 138                         'render' : 'my.ahr.request_time().toString().substr(0,10)'
 139                 },
 140                 {
 141                         'id' : 'capture_time', 'label' : getString('staff.ahr_capture_time_label'), 'flex' : 1,
 142                         'primary' : false, 'hidden' : true,  'render' : 'my.ahr.capture_time()'
 143                 },
 144                 {
 145                         'id' : 'status', 'label' : getString('staff.ahr_status_label'), 'flex' : 1,
 146                         'primary' : false, 'hidden' : true,  'render' : 'my.ahr.status()'
 147                 },
 148                 {
 149                         'id' : 'hold_type', 'label' : getString('staff.ahr_hold_type_label'), 'flex' : 0,
 150                         'primary' : false, 'hidden' : true,  'render' : 'my.ahr.hold_type()'
 151                 },
 152                 {
 153                         'id' : 'pickup_lib', 'label' : getString('staff.ahr_pickup_lib_label'), 'flex' : 1,
 154                         'primary' : false, 'hidden' : true,
 155                         'render' : 'obj.data.hash.aou[ my.ahr.pickup_lib() ].name()'
 156                 },
 157                 {
 158                         'id' : 'pickup_lib_shortname', 'label' : getString('staff.ahr_pickup_lib_label'), 'flex' : 0,
 159                         'primary' : false, 'hidden' : true,
 160                         'render' : 'obj.data.hash.aou[ my.ahr.pickup_lib() ].shortname()'
 161                 },
 162                 {
 163                         'id' : 'current_copy', 'label' : getString('staff.ahr_current_copy_label'), 'flex' : 1,
 164                         'primary' : false, 'hidden' : true,  'render' : 'my.acp.barcode()'
 165                 },
 166                 {
 167                         'id' : 'email_notify', 'label' : getString('staff.ahr_email_notify_label'), 'flex' : 1,
 168                         'primary' : false, 'hidden' : true,  'render' : 'my.ahr.email_notify()'
 169                 },
 170                 {
 171                         'id' : 'expire_time', 'label' : getString('staff.ahr_expire_time_label'), 'flex' : 1,
 172                         'primary' : false, 'hidden' : true,  'render' : 'my.ahr.expire_time()'
 173                 },
 174                 {
 175                         'id' : 'fulfillment_time', 'label' : getString('staff.ahr_fulfillment_time_label'), 'flex' : 1,
 176                         'primary' : false, 'hidden' : true,  'render' : 'my.ahr.fulfillment_time()'
 177                 },
 178                 {
 179                         'id' : 'holdable_formats', 'label' : getString('staff.ahr_holdable_formats_label'), 'flex' : 1,
 180                         'primary' : false, 'hidden' : true,  'render' : 'my.ahr.holdable_formats()'
 181                 },
 182                 {
 183                         'id' : 'id', 'label' : getString('staff.ahr_id_label'), 'flex' : 1,
 184                         'primary' : false, 'hidden' : true,  'render' : 'my.ahr.id()'
 185                 },
 186                 {
 187                         'id' : 'phone_notify', 'label' : getString('staff.ahr_phone_notify_label'), 'flex' : 1,
 188                         'primary' : false, 'hidden' : true,  'render' : 'my.ahr.phone_notify()'
 189                 },
 190                 {
 191                         'id' : 'prev_check_time', 'label' : getString('staff.ahr_prev_check_time_label'), 'flex' : 1,
 192                         'primary' : false, 'hidden' : true,  'render' : 'my.ahr.prev_check_time()'
 193                 },
 194                 {
 195                         'id' : 'requestor', 'label' : getString('staff.ahr_requestor_label'), 'flex' : 1,
 196                         'primary' : false, 'hidden' : true,  'render' : 'my.ahr.requestor()'
 197                 },
 198                 {
 199                         'id' : 'selection_depth', 'label' : getString('staff.ahr_selection_depth_label'), 'flex' : 1,
 200                         'primary' : false, 'hidden' : true,  'render' : 'my.ahr.selection_depth()'
 201                 },
 202                 {
 203                         'id' : 'target', 'label' : getString('staff.ahr_target_label'), 'flex' : 1,
 204                         'primary' : false, 'hidden' : true,  'render' : 'my.ahr.target()'
 205                 },
 206                 {
 207                         'id' : 'usr', 'label' : getString('staff.ahr_usr_label'), 'flex' : 1,
 208                         'primary' : false, 'hidden' : true,  'render' : 'my.ahr.usr()'
 209                 },
 210                 {
 211                         'id' : 'title', 'label' : getString('staff.mvr_label_title'), 'flex' : 1,
 212                         'primary' : false, 'hidden' : true, 'render' : 'my.mvr.title()'
 213                 },
 214                 {
 215                         'id' : 'author', 'label' : getString('staff.mvr_label_author'), 'flex' : 1,
 216                         'primary' : false, 'hidden' : true, 'render' : 'my.mvr.author()'
 217                 },
 218
 219         ];
 220         for (var i = 0; i < c.length; i++) {
 221                 if (modify[ c[i].id ]) {
 222                         for (var j in modify[ c[i].id ]) {
 223                                 c[i][j] = modify[ c[i].id ][j];
 224                         }
 225                 }
 226         }
 227         return c;
 228 }
 229
 230 circ.util.std_map_row_to_column = function() {
 231         return function(row,col) {
 232                 // row contains { 'my' : { 'acp' : {}, 'circ' : {}, 'mvr' : {} } }
 233                 // col contains one of the objects listed above in columns
 234
 235                 // mimicking some of the obj in circ.checkin and circ.checkout where map_row_to_column is usually defined
 236                 var obj = {};
 237                 JSAN.use('util.error'); obj.error = new util.error();
 238                 JSAN.use('OpenILS.data'); obj.data = new OpenILS.data(); obj.data.init({'via':'stash'});
 239                 JSAN.use('util.network'); obj.network = new util.network();
 240
 241                 var my = row.my;
 242                 var value;
 243                 try {
 244                         value = eval( col.render );
 245                 } catch(E) {
 246                         obj.error.sdump('D_WARN','map_row_to_column: ' + E);
 247                         value = '???';
 248                 }
 249                 return value;
 250         }
 251 }
 252
 253 circ.util.checkin_via_barcode = function(session,barcode,backdate) {
 254         try {
 255                 JSAN.use('util.error'); var error = new util.error();
 256                 JSAN.use('util.network'); var network = new util.network();
 257                 JSAN.use('OpenILS.data'); var data = new OpenILS.data(); data.init({'via':'stash'});
 258                 JSAN.use('util.date');
 259                 if (backdate && (backdate == util.date.formatted_date(new Date(),'%Y-%m-%d')) ) backdate = null;
 260
 261                 var params = { 'barcode' : barcode };
 262                 if (backdate) params.backdate = backdate;
 263
 264                 var check = network.request(
 265                         api.CHECKIN_VIA_BARCODE.app,
 266                         api.CHECKIN_VIA_BARCODE.method,
 267                         [ session, params ]
 268                 );
 269
 270                 check.message = check.textcode;
 271
 272                 if (check.payload && check.payload.copy) check.copy = check.payload.copy;
 273                 if (check.payload && check.payload.record) check.record = check.payload.record;
 274                 if (check.payload && check.payload.circ) check.circ = check.payload.circ;
 275
 276                 if (!check.route_to) check.route_to = '???';
 277
 278                 /* SUCCESS  /  NO_CHANGE  /  ITEM_NOT_CATALOGED */
 279                 if (check.ilsevent == 0 || check.ilsevent == 3 || check.ilsevent == 1202) {
 280                         check.route_to = data.hash.acpl[ check.copy.location() ].name();
 281                         var msg = '';
 282                         if (check.ilsevent == 3) msg = 'This item is already checked in.\n';
 283                         if (check.ilsevent == 1202 && check.copy.status() != 11) {
 284                                 msg = 'FIXME -- ITEM_NOT_CATALOGED event but copy status is '
 285                                         + data.hash.ccs[ check.copy.status() ].name() + '\n';
 286                         }
 287                         switch(check.copy.status()) {
 288                                 case 0: /* AVAILABLE */
 289                                 case 7: /* RESHELVING */
 290                                         if (msg) msg += 'This item needs to be routed to ' + check.route_to + '.';
 291                                 break;
 292                                 case 8: /* ON HOLDS SHELF */
 293                                         check.route_to = 'HOLDS SHELF';
 294                                         if (check.payload.hold) {
 295                                                 if (check.payload.hold.pickup_lib() != data.list.au[0].home_ou()) {
 296                                                         msg += 'FIXME:  We should have received a ROUTE_ITEM\n';
 297                                                 } else {
 298                                                         msg += 'This item needs to be routed to ' + check.route_to + '.\n';
 299                                                 }
 300                                         } else {
 301                                                 msg += 'FIXME: status of Holds Shelf, but no hold in payload';
 302                                         }
 303                                         if (check.payload.hold) {
 304                                                 JSAN.use('patron.util');
 305                                                 var au_obj = patron.util.retrieve_au_via_id( session, check.payload.hold.usr() );
 306                                                 msg += '\nHold for patron ' + au_obj.family_name() + ', ' + au_obj.first_given_name() + '\n';
 307                                                 msg += 'Barcode: ' + au_obj.card().barcode() + '\n';
 308                                                 if (check.payload.hold.phone_notify()) msg += 'Notify by phone: ' + check.payload.hold.phone_notify() + '\n';
 309                                                 if (check.payload.hold.email_notify()) msg += 'Notify by email: ' + check.payload.hold.email_notify() + '\n';
 310                                         }
 311                                         var rv = error.yns_alert(
 312                                                 msg,
 313                                                 'Hold Slip',
 314                                                 "Print",
 315                                                 "Don't Print",
 316                                                 null,
 317                                                 "Check here to confirm this message"
 318                                         );
 319                                         if (rv == 0) {
 320                                                 try {
 321                                                         JSAN.use('util.print'); var print = new util.print();
 322                                                         print.simple( msg, { 'no_prompt' : true } );
 323                                                 } catch(E) {
 324                                                         dump('FIXME: ' + E + '\n');
 325                                                         alert('FIXME: ' + E + '\n');
 326                                                 }
 327                                         }
 328                                         msg = '';
 329                                 break;
 330                                 case 6: /* IN TRANSIT */
 331                                         check.route_to = 'TRANSIT SHELF??';
 332                                         msg += ("FIXME -- I didn't think we could get here.\n");
 333                                 break;
 334                                 case 11: /* CATALOGING */
 335                                         check.route_to = 'CATALOGING';
 336                                         msg += 'This item needs to be routed to ' + check.route_to + '.';
 337                                 break;
 338                                 default:
 339                                         msg += ("FIXME -- this case is unhandled\n");
 340                                         msg += 'This item needs to be routed to ' + check.route_to + '.';
 341                                 break;
 342                         }
 343                         if (msg) error.yns_alert(msg,'Alert',null,'OK',null,"Check here to confirm this message");
 344                 }
 345
 346                 /* ROUTE_ITEM */
 347                 if (check.ilsevent == 7000) {
 348                         var lib = data.hash.aou[ check.org ];
 349                         check.route_to = lib.shortname();
 350                         var msg = 'This item is in transit to ' + check.route_to + '.\n';
 351                         msg += '\n' + lib.name() + '\n';
 352                         msg += 'HOLD ADDRESSS STREET 1\n';
 353                         msg += 'HOLD ADDRESSS STREET 2\n';
 354                         msg += 'HOLD ADDRESSS CITY, STATE, ZIP\n';
 355                         msg += '\nBarcode: ' + check.payload.copy.barcode() + '\n';
 356                         msg += 'Title: ' + check.payload.record.title() + '\n';
 357                         msg += 'Author: ' + check.payload.record.author() + '\n';
 358                         if (check.payload.hold) {
 359                                 JSAN.use('patron.util');
 360                                 var au_obj = patron.util.retrieve_au_via_id( session, check.payload.hold.usr() );
 361                                 msg += '\nHold for patron ' + au_obj.family_name() + ', ' + au_obj.first_given_name() + '\n';
 362                                 msg += 'Barcode: ' + au_obj.card().barcode() + '\n';
 363                                 if (check.payload.hold.phone_notify()) msg += 'Notify by phone: ' + check.payload.hold.phone_notify() + '\n';
 364                                 if (check.payload.hold.email_notify()) msg += 'Notify by email: ' + check.payload.hold.email_notify() + '\n';
 365                         }
 366                         var rv = error.yns_alert(
 367                                 msg,
 368                                 'Transit Slip',
 369                                 "Print",
 370                                 "Don't Print",
 371                                 null,
 372                                 "Check here to confirm this message"
 373                         );
 374                         if (rv == 0) {
 375                                 try {
 376                                         JSAN.use('util.print'); var print = new util.print();
 377                                         print.simple( msg, { 'no_prompt' : true } );
 378                                 } catch(E) {
 379                                         dump('FIXME: ' + E + '\n');
 380                                         alert('FIXME: ' + E + '\n');
 381                                 }
 382                         }
 383                 }
 384
 385                 /* COPY_NOT_FOUND */
 386                 if (check.ilsevent == 1502) {
 387                         check.copy = new acp();
 388                         check.copy.barcode( barcode );
 389                         check.copy.status( 11 );
 390                         check.route_to = 'CATALOGING';
 391                         error.yns_alert(
 392                                 'The barcode was either mis-scanned or this item needs to be routed to CATALOGING.',
 393                                 'Alert',
 394                                 null,
 395                                 'OK',
 396                                 null,
 397                                 "Check here to confirm this message"
 398                         );
 399                 }
 400
 401 //                              case '2': case 2: /* LOST??? */
 402 //                                      JSAN.use('patron.util');
 403 //                                      var au_obj = patron.util.retrieve_au_via_id( session, check.circ.usr() );
 404 //                                      var msg = check.text + '\r\n' + 'Barcode: ' + barcode + '  Title: ' +
 405 //                                                      check.record.title() + '  Author: ' + check.record.author() + '\r\n' +
 406 //                                                      'Patron: ' + au_obj.card().barcode() + ' ' + au_obj.family_name() + ', ' +
 407 //                                                      au_obj.first_given_name();
 408 //                                      var pcheck = error.yns_alert(
 409 //                                              msg,
 410 //                                              'Lost Item',
 411 //                                              'Edit Copy & Patron',
 412 //                                              "Just Continue",
 413 //                                              null,
 414 //                                              "Check here to confirm this message"
 415 //                                      );
 416 //                                      if (pcheck == 0) {
 417 //                                              //FIXME//Re-implement
 418 //                                              /*
 419 //                                              var w = mw.spawn_main();
 420 //                                              setTimeout(
 421 //                                                      function() {
 422 //                                                              mw.spawn_patron_display(w.document,'new_tab','main_tabbox',{'patron':au_obj});
 423 //                                                              mw.spawn_batch_copy_editor(w.document,'new_tab','main_tabbox',
 424 //                                                                      {'copy_ids':[ check.copy.id() ]});
 425 //                                                      }, 0
 426 //                                              );
 427 //                                              */
 428 //                                      }
 429 //                              break;
 430                 return check;
 431         } catch(E) {
 432                 JSAN.use('util.error'); var error = new util.error();
 433                 var msg = E + '\n---\n' + js2JSON(E);
 434                 error.sdump('D_ERROR',msg);
 435                 alert(msg);
 436                 return null;
 437         }
 438 }
 439
 440 circ.util.hold_capture_via_copy_barcode = function ( session, barcode, retrieve_flag ) {
 441         try {
 442                 JSAN.use('util.network'); var network = new util.network();
 443                 JSAN.use('OpenILS.data'); var data = new OpenILS.data(); data.init({'via':'stash'});
 444                 var params = { barcode: barcode }
 445                 if (retrieve_flag) { params.flesh_record = retrieve_flag; params.flesh_copy = retrieve_flag; }
 446                 var robj = network.request(
 447                         api.CAPTURE_COPY_FOR_HOLD_VIA_BARCODE.app,
 448                         api.CAPTURE_COPY_FOR_HOLD_VIA_BARCODE.method,
 449                         [ session, params ]
 450                 );
 451                 var check = robj.payload;
 452                 if (!check) {
 453                         check = {};
 454                         check.status = robj.ilsevent;
 455                         check.copy = new acp(); check.copy.barcode( barcode );
 456                 }
 457                 check.text = robj.textcode;
 458                 check.route_to = robj.route_to;
 459                 //check.text = 'Captured for Hold';
 460                 if (parseInt(check.route_to)) check.route_to = data.hash.aou[ check.route_to ].shortname();
 461                 return check;
 462         } catch(E) {
 463                 JSAN.use('util.error'); var error = new util.error();
 464                 var msg = E + '\n---\n' + js2JSON(E);
 465                 error.sdump('D_ERROR',msg);
 466                 alert(msg);
 467                 return null;
 468         }
 469 }
 470
 471
 472 dump('exiting circ/util.js\n');