Open-ILS/xul/staff_client/chrome/content/util/list.js

   1 dump('entering util.list.js\n');
   2
   3 if (typeof main == 'undefined') main = {};
   4 util.list = function (id) {
   5
   6     this.node = document.getElementById(id);
   7
   8     this.row_count = { 'total' : 0, 'fleshed' : 0 };
   9
  10     this.unique_row_counter = 0;
  11
  12     if (!this.node) throw('Could not find element ' + id);
  13     switch(this.node.nodeName) {
  14         case 'listbox' :
  15         case 'tree' : break;
  16         case 'richlistbox' :
  17             throw(this.node.nodeName + ' not yet supported'); break;
  18         default: throw(this.node.nodeName + ' not supported'); break;
  19     }
  20
  21     JSAN.use('util.error'); this.error = new util.error();
  22
  23     JSAN.use('OpenILS.data'); this.data = new OpenILS.data(); this.data.stash_retrieve();
  24
  25     return this;
  26 };
  27
  28 util.list.prototype = {
  29
  30     'init' : function (params) {
  31
  32         var obj = this;
  33         obj.scratch_data = {};
  34
  35         JSAN.use('util.widgets');
  36
  37         obj.printer_context = params.printer_context;
  38
  39         if (typeof params.map_row_to_column == 'function') obj.map_row_to_column = params.map_row_to_column;
  40         if (typeof params.map_row_to_columns == 'function') {
  41             obj.map_row_to_columns = params.map_row_to_columns;
  42         } else {
  43             obj.map_row_to_columns = obj.std_map_row_to_columns();
  44         }
  45         if (typeof params.retrieve_row == 'function') obj.retrieve_row = params.retrieve_row;
  46
  47         obj.prebuilt = false;
  48         if (typeof params.prebuilt != 'undefined') obj.prebuilt = params.prebuilt;
  49
  50         if (typeof params.columns == 'undefined') throw('util.list.init: No columns');
  51         obj.columns = [];
  52         for (var i = 0; i < params.columns.length; i++) {
  53             if (typeof params.columns[i] == 'object') {
  54                 obj.columns.push( params.columns[i] );
  55             } else {
  56                 var cols = obj.fm_columns( params.columns[i] );
  57                 for (var j = 0; j < cols.length; j++) {
  58                     obj.columns.push( cols[j] );
  59                 }
  60             }
  61         }
  62
  63         switch(obj.node.nodeName) {
  64             case 'tree' : obj._init_tree(params); break;
  65             case 'listbox' : obj._init_listbox(params); break;
  66             default: throw('NYI: Need ._init() for ' + obj.node.nodeName); break;
  67         }
  68     },
  69
  70     '_init_tree' : function (params) {
  71         var obj = this;
  72         if (this.prebuilt) {
  73
  74             this.treechildren = this.node.lastChild;
  75
  76         } else {
  77             var treecols = document.createElement('treecols');
  78             this.node.appendChild(treecols);
  79             this.treecols = treecols;
  80
  81             var check_for_id_collisions = {};
  82             for (var i = 0; i < this.columns.length; i++) {
  83                 var treecol = document.createElement('treecol');
  84                 for (var j in this.columns[i]) {
  85                     var value = this.columns[i][j];
  86                     if (j=='id') {
  87                         if (typeof check_for_id_collisions[value] == 'undefined') {
  88                             check_for_id_collisions[value] = true;
  89                         } else {
  90                             // Column id's are important for sorting and saving list configuration.  Collisions started happening because
  91                             // we were using field names as id's, and then later combining column definitions for multiple objects that
  92                             // shared field names.  The downside to this sort of automatic collision prevention is that these generated
  93                             // id's can change as we add and remove columns, possibly breaking saved list configurations.
  94                             dump('Column collision with id = ' + value + ', renaming to ');
  95                             value = value + '_collision_' + i;
  96                             dump(value + '\n');
  97                         }
  98                     }
  99                     treecol.setAttribute(j,value);
 100                 }
 101                 treecols.appendChild(treecol);
 102                 if (this.columns[i].type == 'checkbox') {
 103                     treecol.addEventListener(
 104                         'click',
 105                         function(ev) {
 106                             setTimeout(
 107                                 function() {
 108                                     var toggle = ev.target.getAttribute('toggleAll') || 'on';
 109                                     if (toggle == 'off') toggle = 'on'; else toggle = 'off';
 110                                     ev.target.setAttribute('toggleAll',toggle);
 111                                     obj._toggle_checkbox_column(ev.target,toggle);
 112                                 }, 0
 113                             );
 114                         },
 115                         false
 116                     );
 117                 } else {
 118                     treecol.addEventListener(
 119                         'click',
 120                         function(ev) {
 121                             function do_it() {
 122                                 var sortDir = ev.target.getAttribute('sortDir') || 'desc';
 123                                 if (sortDir == 'desc') sortDir = 'asc'; else sortDir = 'desc';
 124                                 ev.target.setAttribute('sortDir',sortDir);
 125                                 obj._sort_tree(ev.target,sortDir);
 126                             }
 127
 128                             if (obj.row_count.total != obj.row_count.fleshed && (obj.row_count.total - obj.row_count.fleshed) > 50) {
 129                                 var r = window.confirm(document.getElementById('offlineStrings').getFormattedString('list.row_fetch_warning',[obj.row_count.fleshed,obj.row_count.total]));
 130
 131                                 if (r) {
 132                                     setTimeout( do_it, 0 );
 133                                 }
 134                             } else {
 135                                     setTimeout( do_it, 0 );
 136                             }
 137                         },
 138                         false
 139                     );
 140                 }
 141                 var splitter = document.createElement('splitter');
 142                 splitter.setAttribute('class','tree-splitter');
 143                 treecols.appendChild(splitter);
 144             }
 145
 146             var treechildren = document.createElement('treechildren');
 147             this.node.appendChild(treechildren);
 148             this.treechildren = treechildren;
 149         }
 150         if (typeof params.on_sort == 'function') {
 151             this.on_sort = params.on_sort;
 152         }
 153         if (typeof params.on_checkbox_toggle == 'function') {
 154             this.on_checkbox_toggle = params.on_checkbox_toggle;
 155         }
 156         this.node.addEventListener(
 157             'select',
 158             function(ev) {
 159                 if (typeof params.on_select == 'function') {
 160                     params.on_select(ev);
 161                 }
 162                 var x = document.getElementById(obj.node.id + '_clipfield');
 163                 if (x) {
 164                     var sel = obj.retrieve_selection();
 165                     x.setAttribute('disabled', sel.length == 0);
 166                 }
 167             },
 168             false
 169         );
 170         if (typeof params.on_click == 'function') {
 171             this.node.addEventListener(
 172                 'click',
 173                 params.on_click,
 174                 false
 175             );
 176         }
 177         /*
 178         this.node.addEventListener(
 179             'mousemove',
 180             function(ev) { obj.detect_visible(); },
 181             false
 182         );
 183         */
 184         this.node.addEventListener(
 185             'keypress',
 186             function(ev) { obj.auto_retrieve(); },
 187             false
 188         );
 189         this.node.addEventListener(
 190             'click',
 191             function(ev) { obj.auto_retrieve(); },
 192             false
 193         );
 194         window.addEventListener(
 195             'resize',
 196             function(ev) { obj.auto_retrieve(); },
 197             false
 198         );
 199         /* FIXME -- find events on scrollbar to trigger this */
 200         obj.detect_visible_polling();
 201         /*
 202         var scrollbar = document.getAnonymousNodes( document.getAnonymousNodes(this.node)[1] )[1];
 203         var slider = document.getAnonymousNodes( scrollbar )[2];
 204         alert('scrollbar = ' + scrollbar.nodeName + ' grippy = ' + slider.nodeName);
 205         scrollbar.addEventListener('click',function(){alert('sb click');},false);
 206         scrollbar.addEventListener('command',function(){alert('sb command');},false);
 207         scrollbar.addEventListener('scroll',function(){alert('sb scroll');},false);
 208         slider.addEventListener('click',function(){alert('slider click');},false);
 209         slider.addEventListener('command',function(){alert('slider command');},false);
 210         slider.addEventListener('scroll',function(){alert('slider scroll');},false);
 211         */
 212         this.node.addEventListener('scroll',function(){ obj.auto_retrieve(); },false);
 213
 214         this.restores_columns(params);
 215     },
 216
 217     '_init_listbox' : function (params) {
 218         if (this.prebuilt) {
 219         } else {
 220             var listhead = document.createElement('listhead');
 221             this.node.appendChild(listhead);
 222
 223             var listcols = document.createElement('listcols');
 224             this.node.appendChild(listcols);
 225
 226             for (var i = 0; i < this.columns.length; i++) {
 227                 var listheader = document.createElement('listheader');
 228                 listhead.appendChild(listheader);
 229                 var listcol = document.createElement('listcol');
 230                 listcols.appendChild(listcol);
 231                 for (var j in this.columns[i]) {
 232                     listheader.setAttribute(j,this.columns[i][j]);
 233                     listcol.setAttribute(j,this.columns[i][j]);
 234                 };
 235             }
 236         }
 237     },
 238
 239     'save_columns' : function (params) {
 240         var obj = this;
 241         if (obj.data.hash.aous['gui.disable_local_save_columns']) {
 242             alert(document.getElementById('offlineStrings').getString('list.column_save_disabled'));
 243         } else {
 244             switch (this.node.nodeName) {
 245                 case 'tree' : this._save_columns_tree(params); break;
 246                 default: throw('NYI: Need .save_columns() for ' + this.node.nodeName); break;
 247             }
 248         }
 249     },
 250
 251     '_save_columns_tree' : function (params) {
 252         var obj = this;
 253         try {
 254             var id = obj.node.getAttribute('id'); if (!id) {
 255                 alert("FIXME: The columns for this list cannot be saved because the list has no id.");
 256                 return;
 257             }
 258             var my_cols = {};
 259             var nl = obj.node.getElementsByTagName('treecol');
 260             for (var i = 0; i < nl.length; i++) {
 261                 var col = nl[i];
 262                 var col_id = col.getAttribute('id');
 263                 if (!col_id) {
 264                     alert('FIXME: A column in this list does not have an id and cannot be saved');
 265                     continue;
 266                 }
 267                 var col_hidden = col.getAttribute('hidden');
 268                 var col_width = col.getAttribute('width');
 269                 var col_ordinal = col.getAttribute('ordinal');
 270                 my_cols[ col_id ] = { 'hidden' : col_hidden, 'width' : col_width, 'ordinal' : col_ordinal };
 271             }
 272             netscape.security.PrivilegeManager.enablePrivilege('UniversalXPConnect');
 273             JSAN.use('util.file'); var file = new util.file('tree_columns_for_'+window.escape(id));
 274             file.set_object(my_cols);
 275             file.close();
 276             alert(document.getElementById('offlineStrings').getString('list.columns_saved'));
 277         } catch(E) {
 278             obj.error.standard_unexpected_error_alert('_save_columns_tree',E);
 279         }
 280     },
 281
 282     'restores_columns' : function (params) {
 283         var obj = this;
 284         switch (this.node.nodeName) {
 285             case 'tree' : this._restores_columns_tree(params); break;
 286             default: throw('NYI: Need .restores_columns() for ' + this.node.nodeName); break;
 287         }
 288     },
 289
 290     '_restores_columns_tree' : function (params) {
 291         var obj = this;
 292         try {
 293             var id = obj.node.getAttribute('id'); if (!id) {
 294                 alert("FIXME: The columns for this list cannot be restored because the list has no id.");
 295                 return;
 296             }
 297
 298             var my_cols;
 299             if (! obj.data.hash.aous) { obj.data.hash.aous = {}; }
 300             if (! obj.data.hash.aous['gui.disable_local_save_columns']) {
 301                 netscape.security.PrivilegeManager.enablePrivilege('UniversalXPConnect');
 302                 JSAN.use('util.file'); var file = new util.file('tree_columns_for_'+window.escape(id));
 303                 if (file._file.exists()) {
 304                     my_cols = file.get_object(); file.close();
 305                 }
 306             }
 307             /* local file will trump remote file if allowed, so save ourselves an http request if this is the case */
 308             if (obj.data.hash.aous['url.remote_column_settings'] && ! my_cols ) {
 309                 try {
 310                     var x = new XMLHttpRequest();
 311                     var url = obj.data.hash.aous['url.remote_column_settings'] + '/tree_columns_for_' + window.escape(id);
 312                     x.open("GET", url, false);
 313                     x.send(null);
 314                     if (x.status == 200) {
 315                         my_cols = JSON2js( x.responseText );
 316                     }
 317                 } catch(E) {
 318                     // This can happen in the offline interface if you logged in previously and url.remote_column_settings is set.
 319                     // 1) You may be really "offline" now
 320                     // 2) the URL may just be a path component without a hostname (ie "/xul/column_settings/"), which won't work
 321                     // when appended to chrome://open_ils_staff_client/
 322                     dump('Error retrieving column settings from ' + url + ': ' + E + '\n');
 323                 }
 324             }
 325
 326             if (my_cols) {
 327                 var nl = obj.node.getElementsByTagName('treecol');
 328                 for (var i = 0; i < nl.length; i++) {
 329                     var col = nl[i];
 330                     var col_id = col.getAttribute('id');
 331                     if (!col_id) {
 332                         alert('FIXME: A column in this list does not have an id and cannot be saved');
 333                         continue;
 334                     }
 335                     if (typeof my_cols[col_id] != 'undefined') {
 336                         col.setAttribute('hidden',my_cols[col_id].hidden);
 337                         col.setAttribute('width',my_cols[col_id].width);
 338                         col.setAttribute('ordinal',my_cols[col_id].ordinal);
 339                     } else {
 340                         obj.error.sdump('D_ERROR','WARNING: Column ' + col_id + ' did not have a saved state.');
 341                     }
 342                 }
 343             }
 344         } catch(E) {
 345             obj.error.standard_unexpected_error_alert('_restore_columns_tree',E);
 346         }
 347     },
 348
 349     'clear' : function (params) {
 350         var obj = this;
 351         switch (this.node.nodeName) {
 352             case 'tree' : this._clear_tree(params); break;
 353             case 'listbox' : this._clear_listbox(params); break;
 354             default: throw('NYI: Need .clear() for ' + this.node.nodeName); break;
 355         }
 356         this.error.sdump('D_LIST','Clearing list ' + this.node.getAttribute('id') + '\n');
 357         this.row_count.total = 0;
 358         this.row_count.fleshed = 0;
 359         setTimeout( function() { obj.exec_on_all_fleshed(); }, 0 );
 360     },
 361
 362     '_clear_tree' : function(params) {
 363         var obj = this;
 364         if (obj.error.sdump_levels.D_LIST_DUMP_ON_CLEAR) {
 365             obj.error.sdump('D_LIST_DUMP_ON_CLEAR',obj.dump());
 366         }
 367         if (obj.error.sdump_levels.D_LIST_DUMP_WITH_KEYS_ON_CLEAR) {
 368             obj.error.sdump('D_LIST_DUMP_WITH_KEYS_ON_CLEAR',obj.dump_with_keys());
 369         }
 370         while (obj.treechildren.lastChild) obj.treechildren.removeChild( obj.treechildren.lastChild );
 371     },
 372
 373     '_clear_listbox' : function(params) {
 374         var obj = this;
 375         var items = [];
 376         var nl = this.node.getElementsByTagName('listitem');
 377         for (var i = 0; i < nl.length; i++) {
 378             items.push( nl[i] );
 379         }
 380         for (var i = 0; i < items.length; i++) {
 381             this.node.removeChild(items[i]);
 382         }
 383     },
 384
 385     'append' : function (params) {
 386         var rnode;
 387         var obj = this;
 388         switch (this.node.nodeName) {
 389             case 'tree' : rparams = this._append_to_tree(params); break;
 390             case 'listbox' : rparams = this._append_to_listbox(params); break;
 391             default: throw('NYI: Need .append() for ' + this.node.nodeName); break;
 392         }
 393         if (rparams && params.attributes) {
 394             for (var i in params.attributes) {
 395                 rparams.my_node.setAttribute(i,params.attributes[i]);
 396             }
 397         }
 398         this.row_count.total++;
 399         if (this.row_count.fleshed == this.row_count.total) {
 400             setTimeout( function() { obj.exec_on_all_fleshed(); }, 0 );
 401         }
 402         rparams.my_node.setAttribute('unique_row_counter',obj.unique_row_counter);
 403         rparams.unique_row_counter = obj.unique_row_counter++;
 404         if (typeof params.on_append == 'function') {
 405             params.on_append(rparams);
 406         }
 407         return rparams;
 408     },
 409
 410     'refresh_row' : function (params) {
 411         var rnode;
 412         var obj = this;
 413         switch (this.node.nodeName) {
 414             case 'tree' : rparams = this._refresh_row_in_tree(params); break;
 415             default: throw('NYI: Need .refresh_row() for ' + this.node.nodeName); break;
 416         }
 417         if (rparams && params.attributes) {
 418             for (var i in params.attributes) {
 419                 rparams.my_node.setAttribute(i,params.attributes[i]);
 420             }
 421         }
 422         this.row_count.fleshed--;
 423         return rparams;
 424     },
 425
 426
 427     '_append_to_tree' : function (params) {
 428
 429         var obj = this;
 430
 431         if (typeof params.row == 'undefined') throw('util.list.append: Object must contain a row');
 432
 433         var s = ('util.list.append: params = ' + (params) + '\n');
 434
 435         var treechildren_node = this.treechildren;
 436
 437         if (params.node && params.node.nodeName == 'treeitem') {
 438             params.node.setAttribute('container','true'); /* params.node.setAttribute('open','true'); */
 439             if (params.node.lastChild.nodeName == 'treechildren') {
 440                 treechildren_node = params.node.lastChild;
 441             } else {
 442                 treechildren_node = document.createElement('treechildren');
 443                 params.node.appendChild(treechildren_node);
 444             }
 445         }
 446
 447         var treeitem = document.createElement('treeitem');
 448         treeitem.setAttribute('retrieve_id',params.retrieve_id);
 449         if (typeof params.to_bottom != 'undefined') {
 450             treechildren_node.appendChild( treeitem );
 451             if (typeof params.no_auto_select == 'undefined') {
 452                 if (!obj.auto_select_pending) {
 453                     obj.auto_select_pending = true;
 454                     setTimeout(function() {
 455                         dump('auto-selecting\n');
 456                         var idx = Number(obj.node.view.rowCount)-1;
 457                         try { obj.node.view.selection.select(idx); } catch(E) { obj.error.sdump('D_WARN','tree auto select: ' + E + '\n'); }
 458                         try { if (typeof params.on_select == 'function') params.on_select(); } catch(E) { obj.error.sdump('D_WARN','tree auto select, on_select: ' + E + '\n'); }
 459                         obj.auto_select_pending = false;
 460                         try { util.widgets.dispatch('flesh',obj.node.contentView.getItemAtIndex(idx).firstChild); } catch(E) { obj.error.sdump('D_WARN','tree auto select, flesh: ' + E + '\n'); }
 461                     }, 1000);
 462                 }
 463             }
 464         } else {
 465             if (treechildren_node.firstChild) {
 466                 treechildren_node.insertBefore( treeitem, treechildren_node.firstChild );
 467             } else {
 468                 treechildren_node.appendChild( treeitem );
 469             }
 470             if (typeof params.no_auto_select == 'undefined') {
 471                 if (!obj.auto_select_pending) {
 472                     obj.auto_select_pending = true;
 473                     setTimeout(function() {
 474                         try { obj.node.view.selection.select(0); } catch(E) { obj.error.sdump('D_WARN','tree auto select: ' + E + '\n'); }
 475                         try { if (typeof params.on_select == 'function') params.on_select(); } catch(E) { obj.error.sdump('D_WARN','tree auto select, on_select: ' + E + '\n'); }
 476                         obj.auto_select_pending = false;
 477                         try { util.widgets.dispatch('flesh',obj.node.contentView.getItemAtIndex(0).firstChild); } catch(E) { obj.error.sdump('D_WARN','tree auto select, flesh: ' + E + '\n'); }
 478                     }, 1000);
 479                 }
 480             }
 481         }
 482         var treerow = document.createElement('treerow');
 483         treeitem.appendChild( treerow );
 484         treerow.setAttribute('retrieve_id',params.retrieve_id);
 485         if (params.row_properties) treerow.setAttribute('properties',params.row_properties);
 486
 487         s += ('tree = ' + this.node + '  treechildren = ' + treechildren_node + '\n');
 488         s += ('treeitem = ' + treeitem + '  treerow = ' + treerow + '\n');
 489
 490         obj.put_retrieving_label(treerow);
 491
 492         if (typeof params.retrieve_row == 'function' || typeof this.retrieve_row == 'function') {
 493             treerow.addEventListener(
 494                 'flesh',
 495                 function() {
 496
 497                     if (treerow.getAttribute('retrieved') == 'true') return; /* already running */
 498
 499                     treerow.setAttribute('retrieved','true');
 500
 501                     //dump('fleshing = ' + params.retrieve_id + '\n');
 502
 503                     function inc_fleshed() {
 504                         if (treerow.getAttribute('fleshed') == 'true') return; /* already fleshed */
 505                         treerow.setAttribute('fleshed','true');
 506                         obj.row_count.fleshed++;
 507                         if (obj.row_count.fleshed >= obj.row_count.total) {
 508                             setTimeout( function() { obj.exec_on_all_fleshed(); }, 0 );
 509                         }
 510                     }
 511
 512                     params.row_node = treeitem;
 513                     params.on_retrieve = function(p) {
 514                         try {
 515                             p.row = params.row;
 516                             obj._map_row_to_treecell(p,treerow);
 517                             inc_fleshed();
 518                             var idx = obj.node.contentView.getIndexOfItem( params.row_node );
 519                             dump('idx = ' + idx + '\n');
 520                             // if current row is selected, send another select event to re-sync data that the client code fetches on selects
 521                             if ( obj.node.view.selection.isSelected( idx ) ) {
 522                                 dump('dispatching select event for on_retrieve for idx = ' + idx + '\n');
 523                                 util.widgets.dispatch('select',obj.node);
 524                             }
 525                         } catch(E) {
 526                             // Let's not alert on this for now.  Getting contentView has no properties in record buckets under certain conditions
 527                             dump('fixme2: ' + E + '\n');
 528                         }
 529                     }
 530
 531                     if (typeof params.retrieve_row == 'function') {
 532
 533                         params.retrieve_row( params );
 534
 535                     } else if (typeof obj.retrieve_row == 'function') {
 536
 537                             obj.retrieve_row( params );
 538
 539                     } else {
 540
 541                             inc_fleshed();
 542                     }
 543                 },
 544                 false
 545             );
 546             if (typeof params.flesh_immediately != 'undefined') {
 547                 if (params.flesh_immediately) {
 548                     setTimeout(
 549                         function() {
 550                             util.widgets.dispatch('flesh',treerow);
 551                         }, 0
 552                     );
 553                 }
 554             }
 555         } else {
 556             treerow.addEventListener(
 557                 'flesh',
 558                 function() {
 559                     //dump('fleshing anon\n');
 560                     if (treerow.getAttribute('fleshed') == 'true') return; /* already fleshed */
 561                     obj._map_row_to_treecell(params,treerow);
 562                     treerow.setAttribute('retrieved','true');
 563                     treerow.setAttribute('fleshed','true');
 564                     obj.row_count.fleshed++;
 565                     if (obj.row_count.fleshed >= obj.row_count.total) {
 566                         setTimeout( function() { obj.exec_on_all_fleshed(); }, 0 );
 567                     }
 568                 },
 569                 false
 570             );
 571             if (typeof params.flesh_immediately != 'undefined') {
 572                 if (params.flesh_immediately) {
 573                     setTimeout(
 574                         function() {
 575                             util.widgets.dispatch('flesh',treerow);
 576                         }, 0
 577                     );
 578                 }
 579             }
 580         }
 581         this.error.sdump('D_LIST',s);
 582
 583             try {
 584
 585                 if (obj.trim_list && obj.row_count.total >= obj.trim_list) {
 586                     // Remove oldest row
 587                     //if (typeof params.to_bottom != 'undefined')
 588                     if (typeof params.to_top == 'undefined') {
 589                         if (typeof params.on_delete == 'function') { params.on_delete( treechildren_node.firstChild.getAttribute('unique_row_counter') ); }
 590                         treechildren_node.removeChild( treechildren_node.firstChild );
 591                     } else {
 592                         if (typeof params.on_delete == 'function') { params.on_delete( treechildren_node.lastChild.getAttribute('unique_row_counter') ); }
 593                         treechildren_node.removeChild( treechildren_node.lastChild );
 594                     }
 595                 }
 596             } catch(E) {
 597             }
 598
 599         setTimeout( function() { obj.auto_retrieve(); }, 0 );
 600
 601         params.my_node = treeitem;
 602         return params;
 603     },
 604
 605     '_refresh_row_in_tree' : function (params) {
 606
 607         var obj = this;
 608
 609         if (typeof params.row == 'undefined') throw('util.list.refresh_row: Object must contain a row');
 610         if (typeof params.my_node == 'undefined') throw('util.list.refresh_row: Object must contain a my_node');
 611         if (params.my_node.nodeName != 'treeitem') throw('util.list.refresh_rwo: my_node must be a treeitem');
 612
 613         var s = ('util.list.refresh_row: params = ' + (params) + '\n');
 614
 615         var treeitem = params.my_node;
 616         treeitem.setAttribute('retrieve_id',params.retrieve_id);
 617         if (typeof params.to_bottom != 'undefined') {
 618             if (typeof params.no_auto_select == 'undefined') {
 619                 if (!obj.auto_select_pending) {
 620                     obj.auto_select_pending = true;
 621                     setTimeout(function() {
 622                         dump('auto-selecting\n');
 623                         var idx = Number(obj.node.view.rowCount)-1;
 624                         try { obj.node.view.selection.select(idx); } catch(E) { obj.error.sdump('D_WARN','tree auto select: ' + E + '\n'); }
 625                         try { if (typeof params.on_select == 'function') params.on_select(); } catch(E) { obj.error.sdump('D_WARN','tree auto select, on_select: ' + E + '\n'); }
 626                         obj.auto_select_pending = false;
 627                         try { util.widgets.dispatch('flesh',obj.node.contentView.getItemAtIndex(idx).firstChild); } catch(E) { obj.error.sdump('D_WARN','tree auto select, flesh: ' + E + '\n'); }
 628                     }, 1000);
 629                 }
 630             }
 631         }
 632         //var delete_me = [];
 633         //for (var i in treeitem.childNodes) if (treeitem.childNodes[i].nodeName == 'treerow') delete_me.push(treeitem.childNodes[i]);
 634         //for (var i = 0; i < delete_me.length; i++) treeitem.removeChild(delete_me[i]);
 635         var prev_treerow = treeitem.firstChild; /* FIXME: worry about hierarchal lists like copy_browser? */
 636         var treerow = document.createElement('treerow');
 637         while (prev_treerow.firstChild) {
 638             treerow.appendChild( prev_treerow.removeChild( prev_treerow.firstChild ) );
 639         }
 640         treeitem.replaceChild( treerow, prev_treerow );
 641         treerow.setAttribute('retrieve_id',params.retrieve_id);
 642         if (params.row_properties) treerow.setAttribute('properties',params.row_properties);
 643
 644         s += ('tree = ' + this.node.nodeName + '\n');
 645         s += ('treeitem = ' + treeitem.nodeName + '  treerow = ' + treerow.nodeName + '\n');
 646
 647         obj.put_retrieving_label(treerow);
 648
 649         if (typeof params.retrieve_row == 'function' || typeof this.retrieve_row == 'function') {
 650
 651             s += 'found a retrieve_row function\n';
 652
 653             treerow.addEventListener(
 654                 'flesh',
 655                 function() {
 656
 657                     if (treerow.getAttribute('retrieved') == 'true') return; /* already running */
 658
 659                     treerow.setAttribute('retrieved','true');
 660
 661                     //dump('fleshing = ' + params.retrieve_id + '\n');
 662
 663                     function inc_fleshed() {
 664                         if (treerow.getAttribute('fleshed') == 'true') return; /* already fleshed */
 665                         treerow.setAttribute('fleshed','true');
 666                         obj.row_count.fleshed++;
 667                         if (obj.row_count.fleshed >= obj.row_count.total) {
 668                             setTimeout( function() { obj.exec_on_all_fleshed(); }, 0 );
 669                         }
 670                     }
 671
 672                     params.row_node = treeitem;
 673                     params.on_retrieve = function(p) {
 674                         try {
 675                             p.row = params.row;
 676                             obj._map_row_to_treecell(p,treerow);
 677                             inc_fleshed();
 678                             var idx = obj.node.contentView.getIndexOfItem( params.row_node );
 679                             dump('idx = ' + idx + '\n');
 680                             // if current row is selected, send another select event to re-sync data that the client code fetches on selects
 681                             if ( obj.node.view.selection.isSelected( idx ) ) {
 682                                 dump('dispatching select event for on_retrieve for idx = ' + idx + '\n');
 683                                 util.widgets.dispatch('select',obj.node);
 684                             }
 685                         } catch(E) {
 686                             // Let's not alert on this for now.  Getting contentView has no properties in record buckets under certain conditions
 687                             dump('fixme2: ' + E + '\n');
 688                         }
 689                     }
 690
 691                     if (typeof params.retrieve_row == 'function') {
 692
 693                         params.retrieve_row( params );
 694
 695                     } else if (typeof obj.retrieve_row == 'function') {
 696
 697                             obj.retrieve_row( params );
 698
 699                     } else {
 700
 701                             inc_fleshed();
 702                     }
 703                 },
 704                 false
 705             );
 706             if (typeof params.flesh_immediately != 'undefined') {
 707                 if (params.flesh_immediately) {
 708                     setTimeout(
 709                         function() {
 710                             util.widgets.dispatch('flesh',treerow);
 711                         }, 0
 712                     );
 713                 }
 714             }
 715
 716         } else {
 717
 718             s += 'did not find a retrieve_row function\n';
 719
 720             treerow.addEventListener(
 721                 'flesh',
 722                 function() {
 723                     //dump('fleshing anon\n');
 724                     if (treerow.getAttribute('fleshed') == 'true') return; /* already fleshed */
 725                     obj._map_row_to_treecell(params,treerow);
 726                     treerow.setAttribute('retrieved','true');
 727                     treerow.setAttribute('fleshed','true');
 728                     obj.row_count.fleshed++;
 729                     if (obj.row_count.fleshed >= obj.row_count.total) {
 730                         setTimeout( function() { obj.exec_on_all_fleshed(); }, 0 );
 731                     }
 732                 },
 733                 false
 734             );
 735             if (typeof params.flesh_immediately != 'undefined') {
 736                 if (params.flesh_immediately) {
 737                     setTimeout(
 738                         function() {
 739                             util.widgets.dispatch('flesh',treerow);
 740                         }, 0
 741                     );
 742                 }
 743             }
 744
 745         }
 746
 747             try {
 748
 749                 if (obj.trim_list && obj.row_count.total >= obj.trim_list) {
 750                     // Remove oldest row
 751                     //if (typeof params.to_bottom != 'undefined')
 752                     if (typeof params.to_top == 'undefined') {
 753                         treechildren_node.removeChild( treechildren_node.firstChild );
 754                     } else {
 755                         treechildren_node.removeChild( treechildren_node.lastChild );
 756                     }
 757                 }
 758             } catch(E) {
 759             }
 760
 761         setTimeout( function() { obj.auto_retrieve(); }, 0 );
 762
 763         JSAN.use('util.widgets'); util.widgets.dispatch('select',obj.node);
 764
 765         this.error.sdump('D_LIST',s);
 766
 767         return params;
 768     },
 769
 770     'put_retrieving_label' : function(treerow) {
 771         var obj = this;
 772         try {
 773             for (var i = 0; i < obj.columns.length; i++) {
 774                 var treecell;
 775                 if (typeof treerow.childNodes[i] == 'undefined') {
 776                     treecell = document.createElement('treecell');
 777                     treerow.appendChild(treecell);
 778                 } else {
 779                     treecell = treerow.childNodes[i];
 780                 }
 781                 treecell.setAttribute('label',document.getElementById('offlineStrings').getString('list.row_retrieving'));
 782             }
 783         } catch(E) {
 784             alert('Error in list.js, put_retrieving_label(): ' + E);
 785         }
 786     },
 787
 788     'detect_visible' : function() {
 789         var obj = this;
 790         try {
 791             //dump('detect_visible  obj.node = ' + obj.node + '\n');
 792             /* FIXME - this is a hack.. if the implementation of tree changes, this could break */
 793             try {
 794                 /*var s = ''; var A = document.getAnonymousNodes(obj.node);
 795                 for (var i in A) {
 796                     var B = A[i];
 797                     s += '\t' + (typeof B.nodeName != 'undefined' ? B.nodeName : B ) + '\n';
 798                     if (typeof B.childNodes != 'undefined') for (var j = 0; j < B.childNodes.length; j++) {
 799                         var C = B.childNodes[j];
 800                         s += '\t\t' + C.nodeName + '\n';
 801                     }
 802                 }
 803                 obj.error.sdump('D_XULRUNNER','document.getAnonymousNodes(' + obj.node.nodeName + ') = \n' + s + '\n');*/
 804                 var scrollbar = document.getAnonymousNodes(obj.node)[2].firstChild;
 805                 var curpos = scrollbar.getAttribute('curpos');
 806                 var maxpos = scrollbar.getAttribute('maxpos');
 807                 //alert('curpos = ' + curpos + ' maxpos = ' + maxpos + ' obj.curpos = ' + obj.curpos + ' obj.maxpos = ' + obj.maxpos + '\n');
 808                 if ((curpos != obj.curpos) || (maxpos != obj.maxpos)) {
 809                     if ( obj.auto_retrieve() > 0 ) {
 810                         obj.curpos = curpos; obj.maxpos = maxpos;
 811                     }
 812                 }
 813             } catch(E) {
 814                 obj.error.sdump('D_XULRUNNER', 'List implementation changed? ' + E);
 815             }
 816         } catch(E) { obj.error.sdump('D_ERROR',E); }
 817     },
 818
 819     'detect_visible_polling' : function() {
 820         try {
 821             //alert('detect_visible_polling');
 822             var obj = this;
 823             obj.detect_visible();
 824             setTimeout(function() { try { obj.detect_visible_polling(); } catch(E) { alert(E); } },2000);
 825         } catch(E) {
 826             alert(E);
 827         }
 828     },
 829
 830
 831     'auto_retrieve' : function(params) {
 832         var obj = this;
 833         switch (this.node.nodeName) {
 834             case 'tree' : obj._auto_retrieve_tree(params); break;
 835             default: throw('NYI: Need .auto_retrieve() for ' + obj.node.nodeName); break;
 836         }
 837     },
 838
 839     '_auto_retrieve_tree' : function (params) {
 840         var obj = this;
 841         if (!obj.auto_retrieve_in_progress) {
 842             obj.auto_retrieve_in_progress = true;
 843             setTimeout(
 844                 function() {
 845                     try {
 846                             //alert('auto_retrieve\n');
 847                             var count = 0;
 848                             var startpos = obj.node.treeBoxObject.getFirstVisibleRow();
 849                             var endpos = obj.node.treeBoxObject.getLastVisibleRow();
 850                             if (startpos > endpos) endpos = obj.node.treeBoxObject.getPageLength();
 851                             //dump('startpos = ' + startpos + ' endpos = ' + endpos + '\n');
 852                             for (var i = startpos; i < endpos + 4; i++) {
 853                                 try {
 854                                     //dump('trying index ' + i + '\n');
 855                                     var item = obj.node.contentView.getItemAtIndex(i).firstChild;
 856                                     if (item && item.getAttribute('retrieved') != 'true' ) {
 857                                         //dump('\tgot an unfleshed item = ' + item + ' = ' + item.nodeName + '\n');
 858                                         util.widgets.dispatch('flesh',item); count++;
 859                                     }
 860                                 } catch(E) {
 861                                     //dump(i + ' : ' + E + '\n');
 862                                 }
 863                             }
 864                             obj.auto_retrieve_in_progress = false;
 865                             return count;
 866                     } catch(E) { alert(E); }
 867                 }, 1
 868             );
 869         }
 870     },
 871
 872     'exec_on_all_fleshed' : function() {
 873         var obj = this;
 874         try {
 875             if (obj.on_all_fleshed) {
 876                 if (typeof obj.on_all_fleshed == 'function') {
 877                     dump('exec_on_all_fleshed == function\n');
 878                     setTimeout(
 879                         function() {
 880                             try { obj.on_all_fleshed(); } catch(E) { obj.error.standard_unexpected_error_alert('_full_retrieve_tree callback',obj.on_all_fleshed); }
 881                         }, 0
 882                     );
 883                 } else if (typeof obj.on_all_fleshed.length != 'undefined') {
 884                     dump('exec_on_all_fleshed == array\n');
 885                     setTimeout(
 886                         function() {
 887                             try {
 888                                 dump('exec_on_all_fleshed, processing on_all_fleshed array, length = ' + obj.on_all_fleshed.length + '\n');
 889                                 var f = obj.on_all_fleshed.pop();
 890                                 if (typeof f == 'function') {
 891                                     try { f(); } catch(E) { obj.error.standard_unexpected_error_alert('_full_retrieve_tree callback',f); }
 892                                 }
 893                                 if (obj.on_all_fleshed.length > 0) arguments.callee();
 894                             } catch(E) {
 895                                 obj.error.standard_unexpected_error_alert('exec_on_all_fleshed callback error',E);
 896                             }
 897                         }, 0
 898                     );
 899                 } else {
 900                     obj.error.standard_unexpected_error_alert('unexpected on_all_fleshed object: ', obj.on_all_fleshed);
 901                 }
 902             }
 903         } catch(E) {
 904             obj.error.standard_unexpected_error_alert('exec_on_all-fleshed error',E);
 905         }
 906     },
 907
 908     'full_retrieve' : function(params) {
 909         var obj = this;
 910         switch (this.node.nodeName) {
 911             case 'tree' : obj._full_retrieve_tree(params); break;
 912             default: throw('NYI: Need .full_retrieve() for ' + obj.node.nodeName); break;
 913         }
 914     },
 915
 916     '_full_retrieve_tree' : function(params) {
 917         var obj = this;
 918         try {
 919             if (obj.row_count.fleshed >= obj.row_count.total) {
 920                 dump('Full retrieve... tree seems to be in sync\n' + js2JSON(obj.row_count) + '\n');
 921                 obj.exec_on_all_fleshed();
 922             } else {
 923                 dump('Full retrieve... syncing tree' + js2JSON(obj.row_count) + '\n');
 924                 JSAN.use('util.widgets');
 925                 var nodes = obj.treechildren.childNodes;
 926                 for (var i = 0; i < nodes.length; i++) {
 927                     util.widgets.dispatch('flesh',nodes[i].firstChild);
 928                 }
 929             }
 930         } catch(E) {
 931             obj.error.standard_unexpected_error_alert('_full_retrieve_tree',E);
 932         }
 933     },
 934
 935     '_append_to_listbox' : function (params) {
 936
 937         var obj = this;
 938
 939         if (typeof params.row == 'undefined') throw('util.list.append: Object must contain a row');
 940
 941         var s = ('util.list.append: params = ' + (params) + '\n');
 942
 943         var listitem = document.createElement('listitem');
 944
 945         s += ('listbox = ' + this.node + '  listitem = ' + listitem + '\n');
 946
 947         if (typeof params.retrieve_row == 'function' || typeof this.retrieve_row == 'function') {
 948
 949             setTimeout(
 950                 function() {
 951                     listitem.setAttribute('retrieve_id',params.retrieve_id);
 952                     //FIXME//Make async and fire when row is visible in list
 953                     var row;
 954
 955                     params.row_node = listitem;
 956                     params.on_retrieve = function(row) {
 957                         params.row = row;
 958                         obj._map_row_to_listcell(params,listitem);
 959                         obj.node.appendChild( listitem );
 960                         util.widgets.dispatch('select',obj.node);
 961                     }
 962
 963                     if (typeof params.retrieve_row == 'function') {
 964
 965                         row = params.retrieve_row( params );
 966
 967                     } else {
 968
 969                         if (typeof obj.retrieve_row == 'function') {
 970
 971                             row = obj.retrieve_row( params );
 972
 973                         }
 974                     }
 975                 }, 0
 976             );
 977         } else {
 978             this._map_row_to_listcell(params,listitem);
 979             this.node.appendChild( listitem );
 980         }
 981
 982         this.error.sdump('D_LIST',s);
 983         params.my_node = listitem;
 984         return params;
 985
 986     },
 987
 988     '_map_row_to_treecell' : function(params,treerow) {
 989         var obj = this;
 990         var s = '';
 991
 992         if (typeof params.map_row_to_column == 'function' || typeof this.map_row_to_column == 'function') {
 993
 994             for (var i = 0; i < this.columns.length; i++) {
 995                 var treecell;
 996                 if (typeof treerow.childNodes[i] == 'undefined') {
 997                     treecell = document.createElement('treecell');
 998                     treerow.appendChild( treecell );
 999                 } else {
1000                     treecell = treerow.childNodes[i];
1001                 }
1002
1003                 if ( this.columns[i].editable == false ) { treecell.setAttribute('editable','false'); }
1004                 var label = '';
1005
1006                 // What skip columns is doing is rendering the treecells as blank/empty
1007                 if (params.skip_columns && (params.skip_columns.indexOf(i) != -1)) {
1008                     treecell.setAttribute('label',label);
1009                     s += ('treecell = ' + treecell + ' with label = ' + label + '\n');
1010                     continue;
1011                 }
1012                 if (params.skip_all_columns_except && (params.skip_all_columns_except.indexOf(i) == -1)) {
1013                     treecell.setAttribute('label',label);
1014                     s += ('treecell = ' + treecell + ' with label = ' + label + '\n');
1015                     continue;
1016                 }
1017
1018                 if (typeof params.map_row_to_column == 'function')  {
1019
1020                     label = params.map_row_to_column(params.row,this.columns[i],this.scratch_data);
1021
1022                 } else if (typeof this.map_row_to_column == 'function') {
1023
1024                     label = this.map_row_to_column(params.row,this.columns[i],this.scratch_data);
1025
1026                 }
1027                 if (this.columns[i].type == 'checkbox') { treecell.setAttribute('value',label); } else { treecell.setAttribute('label',label ? label : ''); }
1028                 s += ('treecell = ' + treecell + ' with label = ' + label + '\n');
1029             }
1030         } else if (typeof params.map_row_to_columns == 'function' || typeof this.map_row_to_columns == 'function') {
1031
1032             var labels = [];
1033
1034             if (typeof params.map_row_to_columns == 'function') {
1035
1036                 labels = params.map_row_to_columns(params.row,this.columns,this.scratch_data);
1037
1038             } else if (typeof this.map_row_to_columns == 'function') {
1039
1040                 labels = this.map_row_to_columns(params.row,this.columns,this.scratch_data);
1041
1042             }
1043             for (var i = 0; i < labels.length; i++) {
1044                 var treecell;
1045                 if (typeof treerow.childNodes[i] == 'undefined') {
1046                     treecell = document.createElement('treecell');
1047                     treerow.appendChild(treecell);
1048                 } else {
1049                     treecell = treerow.childNodes[i];
1050                 }
1051                 if ( this.columns[i].editable == false ) { treecell.setAttribute('editable','false'); }
1052                 if ( this.columns[i].type == 'checkbox') {
1053                     treecell.setAttribute('value', labels[i]);
1054                 } else {
1055                     treecell.setAttribute('label',typeof labels[i] == 'string' || typeof labels[i] == 'number' ? labels[i] : '');
1056                 }
1057                 s += ('treecell = ' + treecell + ' with label = ' + labels[i] + '\n');
1058             }
1059
1060         } else {
1061
1062             throw('No row to column mapping function.');
1063         }
1064         this.error.sdump('D_LIST',s);
1065     },
1066
1067     '_map_row_to_listcell' : function(params,listitem) {
1068         var obj = this;
1069         var s = '';
1070         for (var i = 0; i < this.columns.length; i++) {
1071             var value = '';
1072             if (typeof params.map_row_to_column == 'function')  {
1073
1074                 value = params.map_row_to_column(params.row,this.columns[i],this.scratch_data);
1075
1076             } else {
1077
1078                 if (typeof this.map_row_to_column == 'function') {
1079
1080                     value = this.map_row_to_column(params.row,this.columns[i],this.scratch_data);
1081                 }
1082             }
1083             if (typeof value == 'string' || typeof value == 'number') {
1084                 var listcell = document.createElement('listcell');
1085                 listcell.setAttribute('label',value);
1086                 listitem.appendChild(listcell);
1087                 s += ('listcell = ' + listcell + ' with label = ' + value + '\n');
1088             } else {
1089                 listitem.appendChild(value);
1090                 s += ('listcell = ' + value + ' is really a ' + value.nodeName + '\n');
1091             }
1092         }
1093         this.error.sdump('D_LIST',s);
1094     },
1095
1096     'select_all' : function(params) {
1097         var obj = this;
1098         switch(this.node.nodeName) {
1099             case 'tree' : return this._select_all_from_tree(params); break;
1100             default: throw('NYI: Need ._select_all_from_() for ' + this.node.nodeName); break;
1101         }
1102     },
1103
1104     '_select_all_from_tree' : function(params) {
1105         var obj = this;
1106         this.node.view.selection.selectAll();
1107     },
1108
1109     'retrieve_selection' : function(params) {
1110         var obj = this;
1111         switch(this.node.nodeName) {
1112             case 'tree' : return this._retrieve_selection_from_tree(params); break;
1113             default: throw('NYI: Need ._retrieve_selection_from_() for ' + this.node.nodeName); break;
1114         }
1115     },
1116
1117     '_retrieve_selection_from_tree' : function(params) {
1118         var obj = this;
1119         var list = [];
1120         var start = new Object();
1121         var end = new Object();
1122         var numRanges = this.node.view.selection.getRangeCount();
1123         for (var t=0; t<numRanges; t++){
1124             this.node.view.selection.getRangeAt(t,start,end);
1125             for (var v=start.value; v<=end.value; v++){
1126                 var i = this.node.contentView.getItemAtIndex(v);
1127                 list.push( i );
1128             }
1129         }
1130         return list;
1131     },
1132
1133     'dump' : function(params) {
1134         var obj = this;
1135         switch(this.node.nodeName) {
1136             case 'tree' : return this._dump_tree(params); break;
1137             default: throw('NYI: Need .dump() for ' + this.node.nodeName); break;
1138         }
1139     },
1140
1141     '_dump_tree' : function(params) {
1142         var obj = this;
1143         var dump = [];
1144         for (var i = 0; i < this.treechildren.childNodes.length; i++) {
1145             var row = [];
1146             var treeitem = this.treechildren.childNodes[i];
1147             var treerow = treeitem.firstChild;
1148             for (var j = 0; j < treerow.childNodes.length; j++) {
1149                 row.push( treerow.childNodes[j].getAttribute('label') );
1150             }
1151             dump.push( row );
1152         }
1153         return dump;
1154     },
1155
1156     'dump_with_keys' : function(params) {
1157         var obj = this;
1158         switch(this.node.nodeName) {
1159             case 'tree' : return this._dump_tree_with_keys(params); break;
1160             default: throw('NYI: Need .dump_with_keys() for ' + this.node.nodeName); break;
1161         }
1162
1163     },
1164
1165     '_dump_tree_with_keys' : function(params) {
1166         var obj = this;
1167         var dump = [];
1168         for (var i = 0; i < this.treechildren.childNodes.length; i++) {
1169             var row = {};
1170             var treeitem = this.treechildren.childNodes[i];
1171             var treerow = treeitem.firstChild;
1172             for (var j = 0; j < treerow.childNodes.length; j++) {
1173                 if (typeof obj.columns[j] == 'undefined') {
1174                     dump('=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n');
1175                     dump('_dump_tree_with_keys @ ' + location.href + '\n');
1176                     dump('\ttreerow.childNodes.length='+treerow.childNodes.length+' j='+j+' obj.columns.length='+obj.columns.length+'\n');
1177                     debugger;
1178                 } else {
1179                     row[ obj.columns[j].id ] = treerow.childNodes[j].getAttribute('label');
1180                 }
1181             }
1182             dump.push( row );
1183         }
1184         return dump;
1185     },
1186
1187     'dump_csv' : function(params) {
1188         var obj = this;
1189         switch(this.node.nodeName) {
1190             case 'tree' : return this._dump_tree_csv(params); break;
1191             default: throw('NYI: Need .dump_csv() for ' + this.node.nodeName); break;
1192         }
1193
1194     },
1195
1196     '_dump_tree_csv' : function(params) {
1197         var obj = this;
1198         var _dump = '';
1199         var ord_cols = [];
1200         for (var j = 0; j < obj.columns.length; j++) {
1201             if (obj.node.treeBoxObject.columns.getColumnAt(j).element.getAttribute('hidden') == 'true') {
1202                 /* skip */
1203             } else {
1204                 ord_cols.push( [ obj.node.treeBoxObject.columns.getColumnAt(j).element.getAttribute('ordinal'), j ] );
1205             }
1206         }
1207         ord_cols.sort( function(a,b) {
1208             if ( Number( a[0] ) < Number( b[0] ) ) return -1;
1209             if ( Number( a[0] ) > Number( b[0] ) ) return 1;
1210             return 0;
1211         } );
1212         for (var j = 0; j < ord_cols.length; j++) {
1213             if (_dump) _dump += ',';
1214             _dump += '"' + obj.columns[ ord_cols[j][1] ].label.replace(/"/g, '""') + '"';
1215         }
1216         _dump += '\r\n';
1217         for (var i = 0; i < this.treechildren.childNodes.length; i++) {
1218             var row = '';
1219             var treeitem = this.treechildren.childNodes[i];
1220             var treerow = treeitem.firstChild;
1221             for (var j = 0; j < ord_cols.length; j++) {
1222                 if (row) row += ',';
1223                 row += '"' + treerow.childNodes[ ord_cols[j][1] ].getAttribute('label').replace(/"/g, '""') + '"';
1224             }
1225             _dump +=  row + '\r\n';
1226         }
1227         return _dump;
1228     },
1229
1230     'dump_extended_format' : function(params) {
1231         var obj = this;
1232         switch(this.node.nodeName) {
1233             case 'tree' : return this._dump_tree_extended_format(params); break;
1234             default: throw('NYI: Need .dump_extended_format() for ' + this.node.nodeName); break;
1235         }
1236
1237     },
1238
1239     '_dump_tree_extended_format' : function(params) {
1240         var obj = this;
1241         var _dump = '';
1242         var ord_cols = [];
1243         for (var j = 0; j < obj.columns.length; j++) {
1244             if (obj.node.treeBoxObject.columns.getColumnAt(j).element.getAttribute('hidden') == 'true') {
1245                 /* skip */
1246             } else {
1247                 ord_cols.push( [ obj.node.treeBoxObject.columns.getColumnAt(j).element.getAttribute('ordinal'), j ] );
1248             }
1249         }
1250         ord_cols.sort( function(a,b) {
1251             if ( Number( a[0] ) < Number( b[0] ) ) return -1;
1252             if ( Number( a[0] ) > Number( b[0] ) ) return 1;
1253             return 0;
1254         } );
1255         for (var i = 0; i < this.treechildren.childNodes.length; i++) {
1256             var row = document.getElementById('offlineStrings').getString('list.dump_extended_format.record_separator') + '\r\n';
1257             var treeitem = this.treechildren.childNodes[i];
1258             var treerow = treeitem.firstChild;
1259             for (var j = 0; j < ord_cols.length; j++) {
1260                 row += obj.columns[ ord_cols[j][1] ].label + ': ' + treerow.childNodes[ ord_cols[j][1] ].getAttribute('label') + '\r\n';
1261             }
1262             _dump +=  row + '\r\n';
1263         }
1264         return _dump;
1265     },
1266
1267     'dump_csv_to_clipboard' : function(params) {
1268         var obj = this;
1269         if (typeof params == 'undefined') params = {};
1270         if (params.no_full_retrieve) {
1271             copy_to_clipboard( obj.dump_csv( params ) );
1272         } else {
1273             obj.wrap_in_full_retrieve( function() { copy_to_clipboard( obj.dump_csv( params ) ); } );
1274         }
1275     },
1276
1277     'dump_csv_to_printer' : function(params) {
1278         var obj = this;
1279         if (typeof params == 'undefined') params = {};
1280         JSAN.use('util.print'); var print = new util.print(params.printer_context || obj.printer_context);
1281         if (params.no_full_retrieve) {
1282             print.simple( obj.dump_csv( params ), {'content_type':'text/plain'} );
1283         } else {
1284             obj.wrap_in_full_retrieve(
1285                 function() {
1286                     print.simple( obj.dump_csv( params ), {'content_type':'text/plain'} );
1287                 }
1288             );
1289         }
1290     },
1291
1292     'dump_extended_format_to_printer' : function(params) {
1293         var obj = this;
1294         if (typeof params == 'undefined') params = {};
1295         JSAN.use('util.print'); var print = new util.print(params.printer_context || obj.printer_context);
1296         if (params.no_full_retrieve) {
1297             print.simple( obj.dump_extended_format( params ), {'content_type':'text/plain'} );
1298         } else {
1299             obj.wrap_in_full_retrieve(
1300                 function() {
1301                     print.simple( obj.dump_extended_format( params ), {'content_type':'text/plain'} );
1302                 }
1303             );
1304         }
1305     },
1306
1307     'dump_csv_to_file' : function(params) {
1308         var obj = this;
1309         JSAN.use('util.file'); var f = new util.file();
1310         if (typeof params == 'undefined') params = {};
1311         if (params.no_full_retrieve) {
1312             params.data = obj.dump_csv( params );
1313             params.not_json = true;
1314             if (!params.title) params.title = document.getElementById('offlineStrings').getString('list.save_csv_as');
1315             f.export_file( params );
1316         } else {
1317             obj.wrap_in_full_retrieve(
1318                 function() {
1319                     params.data = obj.dump_csv( params );
1320                     params.not_json = true;
1321                     if (!params.title) params.title = document.getElementById('offlineStrings').getString('list.save_csv_as');
1322                     f.export_file( params );
1323                 }
1324             );
1325         }
1326     },
1327
1328     'print' : function(params) {
1329         if (!params) params = {};
1330         switch(this.node.nodeName) {
1331             case 'tree' : return this._print_tree(params); break;
1332             default: throw('NYI: Need ._print() for ' + this.node.nodeName); break;
1333         }
1334     },
1335
1336     '_print_tree' : function(params) {
1337         var obj = this;
1338         try {
1339             var data = obj.data; data.stash_retrieve();
1340             if (!params.staff && data.list.au && data.list.au[0]) {
1341                 params.staff = data.list.au[0];
1342             }
1343             if (!params.lib && data.list.au && data.list.au[0] && data.list.au[0].ws_ou() && data.hash.aou && data.hash.aou[ data.list.au[0].ws_ou() ]) {
1344                 params.lib = data.hash.aou[ data.list.au[0].ws_ou() ];
1345                 params.lib.children(null);
1346             }
1347             if (params.template && data.print_list_templates[ params.template ]) {
1348                 var template = data.print_list_templates[ params.template ];
1349                 for (var i in template) params[i] = template[i];
1350             }
1351             obj.wrap_in_full_retrieve(
1352                 function() {
1353                     try {
1354                         if (!params.list) params.list = obj.dump_with_keys();
1355                         JSAN.use('util.print'); var print = new util.print(params.printer_context || obj.printer_context);
1356                         print.tree_list( params );
1357                         if (typeof params.callback == 'function') params.callback();
1358                     } catch(E) {
1359                         obj.error.standard_unexpected_error_alert('inner _print_tree',E);
1360                     }
1361                 }
1362             );
1363
1364         } catch(E) {
1365             obj.error.standard_unexpected_error_alert('_print_tree',E);
1366         }
1367     },
1368
1369     'dump_selected_with_keys' : function(params) {
1370         var obj = this;
1371         switch(this.node.nodeName) {
1372             case 'tree' : return this._dump_tree_selection_with_keys(params); break;
1373             default: throw('NYI: Need .dump_selection_with_keys() for ' + this.node.nodeName); break;
1374         }
1375
1376     },
1377
1378     '_dump_tree_selection_with_keys' : function(params) {
1379         var obj = this;
1380         var dump = [];
1381         var list = obj._retrieve_selection_from_tree();
1382         for (var i = 0; i < list.length; i++) {
1383             var row = {};
1384             var treeitem = list[i];
1385             var treerow = treeitem.firstChild;
1386             for (var j = 0; j < treerow.childNodes.length; j++) {
1387                 var value = treerow.childNodes[j].getAttribute('label');
1388                 if (params.skip_hidden_columns) if (obj.node.treeBoxObject.columns.getColumnAt(j).element.getAttribute('hidden') == 'true') continue;
1389                 if (typeof obj.columns[j] == 'undefined') {
1390                     dump('=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\n');
1391                     dump('_dump_tree_selection_with_keys @ ' + location.href + '\n');
1392                     dump('\ttreerow.childNodes.length='+treerow.childNodes.length+' j='+j+' obj.columns.length='+obj.columns.length+'\n');
1393                     debugger;
1394                 } else {
1395                     var id = obj.columns[j].id; if (params.labels_instead_of_ids) id = obj.columns[j].label;
1396                     row[ id ] = value;
1397                 }
1398             }
1399             dump.push( row );
1400         }
1401         return dump;
1402     },
1403
1404     'clipboard' : function(params) {
1405         try {
1406             var obj = this;
1407             var dump = obj.dump_selected_with_keys({'skip_hidden_columns':true,'labels_instead_of_ids':true});
1408             obj.data.stash_retrieve();
1409             obj.data.list_clipboard = dump; obj.data.stash('list_clipboard');
1410             JSAN.use('util.window'); var win = new util.window();
1411             win.open(urls.XUL_LIST_CLIPBOARD,'list_clipboard','chrome,resizable,modal');
1412             window.focus(); // sometimes the main window will lower after a clipboard action
1413         } catch(E) {
1414             this.error.standard_unexpected_error_alert('clipboard',E);
1415         }
1416     },
1417
1418     'dump_retrieve_ids' : function(params) {
1419         var obj = this;
1420         switch(this.node.nodeName) {
1421             case 'tree' : return this._dump_retrieve_ids_tree(params); break;
1422             default: throw('NYI: Need .dump_retrieve_ids() for ' + this.node.nodeName); break;
1423         }
1424     },
1425
1426     '_dump_retrieve_ids_tree' : function(params) {
1427         var obj = this;
1428         var dump = [];
1429         for (var i = 0; i < this.treechildren.childNodes.length; i++) {
1430             var treeitem = this.treechildren.childNodes[i];
1431             dump.push( treeitem.getAttribute('retrieve_id') );
1432         }
1433         return dump;
1434     },
1435
1436     'wrap_in_full_retrieve' : function(f) {
1437         var obj = this;
1438         if (typeof obj.on_all_fleshed == 'function') { // legacy
1439             obj.on_all_fleshed = [ obj.on_all_fleshed ];
1440         }
1441         if (! obj.on_all_fleshed) obj.on_all_fleshed = [];
1442         obj.on_all_fleshed.push(f);
1443         obj.full_retrieve();
1444     },
1445
1446     '_sort_tree' : function(col,sortDir) {
1447         var obj = this;
1448         try {
1449             if (obj.node.getAttribute('no_sort')) {
1450                 return;
1451             }
1452             var col_pos;
1453             for (var i = 0; i < obj.columns.length; i++) {
1454                 if (obj.columns[i].id == col.id) col_pos = function(a){return a;}(i);
1455             }
1456             obj.wrap_in_full_retrieve(
1457                 function() {
1458                     try {
1459                         JSAN.use('util.money');
1460                         var rows = [];
1461                         var treeitems = obj.treechildren.childNodes;
1462                         for (var i = 0; i < treeitems.length; i++) {
1463                             var treeitem = treeitems[i];
1464                             var treerow = treeitem.firstChild;
1465                             var treecell = treerow.childNodes[ col_pos ];
1466                             value = ( { 'value' : treecell ? treecell.getAttribute('label') : '', 'node' : treeitem } );
1467                             rows.push( value );
1468                         }
1469                         rows = rows.sort( function(a,b) {
1470                             a = a.value; b = b.value;
1471                             if (col.getAttribute('sort_type')) {
1472                                 switch(col.getAttribute('sort_type')) {
1473                                     case 'date' :
1474                                         JSAN.use('util.date'); // to pull in dojo.date.locale
1475                                         a = dojo.date.locale.parse(a,{});
1476                                         b = dojo.date.locale.parse(b,{});
1477                                     break;
1478                                     case 'number' :
1479                                         a = Number(a); b = Number(b);
1480                                     break;
1481                                     case 'money' :
1482                                         a = util.money.dollars_float_to_cents_integer(a);
1483                                         b = util.money.dollars_float_to_cents_integer(b);
1484                                     break;
1485                                     case 'title' : /* special case for "a" and "the".  doesn't use marc 245 indicator */
1486                                         a = String( a ).toUpperCase().replace( /^\s*(THE|A|AN)\s+/, '' );
1487                                         b = String( b ).toUpperCase().replace( /^\s*(THE|A|AN)\s+/, '' );
1488                                     break;
1489                                     default:
1490                                         a = String( a ).toUpperCase();
1491                                         b = String( b ).toUpperCase();
1492                                     break;
1493                                 }
1494                             } else {
1495                                 if (typeof a == 'string' || typeof b == 'string') {
1496                                     a = String( a ).toUpperCase();
1497                                     b = String( b ).toUpperCase();
1498                                 }
1499                             }
1500                             //dump('sorting: type = ' + col.getAttribute('sort_type') + ' a = ' + a + ' b = ' + b + ' a<b= ' + (a<b) + ' a>b= ' + (a>b) + '\n');
1501                             if (a < b) return -1;
1502                             if (a > b) return 1;
1503                             return 0;
1504                         } );
1505                         if (sortDir == 'asc') rows = rows.reverse();
1506                         while(obj.treechildren.lastChild) obj.treechildren.removeChild( obj.treechildren.lastChild );
1507                         for (var i = 0; i < rows.length; i++) {
1508                             obj.treechildren.appendChild( rows[i].node );
1509                         }
1510                         if (typeof obj.on_sort == 'function') obj.on_sort();
1511                     } catch(E) {
1512                         obj.error.standard_unexpected_error_alert('sorting',E);
1513                     }
1514                 }
1515             );
1516         } catch(E) {
1517             obj.error.standard_unexpected_error_alert('pre sorting', E);
1518         }
1519     },
1520
1521     '_toggle_checkbox_column' : function(col,toggle) {
1522         var obj = this;
1523         try {
1524             if (obj.node.getAttribute('no_toggle')) {
1525                 return;
1526             }
1527             var col_pos;
1528             for (var i = 0; i < obj.columns.length; i++) {
1529                 if (obj.columns[i].id == col.id) col_pos = function(a){return a;}(i);
1530             }
1531             var treeitems = obj.treechildren.childNodes;
1532             for (var i = 0; i < treeitems.length; i++) {
1533                 var treeitem = treeitems[i];
1534                 var treerow = treeitem.firstChild;
1535                 var treecell = treerow.childNodes[ col_pos ];
1536                 treecell.setAttribute('value',(toggle == 'on'));
1537             }
1538             if (typeof obj.on_checkbox_toggle == 'function') obj.on_checkbox_toggle(toggle);
1539         } catch(E) {
1540             obj.error.standard_unexpected_error_alert('pre toggle', E);
1541         }
1542     },
1543
1544     'render_list_actions' : function(params) {
1545         var obj = this;
1546         switch(this.node.nodeName) {
1547             case 'tree' : return this._render_list_actions_for_tree(params); break;
1548             default: throw('NYI: Need ._render_list_actions() for ' + this.node.nodeName); break;
1549         }
1550     },
1551
1552     '_render_list_actions_for_tree' : function(params) {
1553         var obj = this;
1554         try {
1555             var btn = document.createElement('button');
1556             btn.setAttribute('id',obj.node.id + '_list_actions');
1557             btn.setAttribute('type','menu');
1558             btn.setAttribute('allowevents','true');
1559             //btn.setAttribute('oncommand','this.firstChild.showPopup();');
1560             btn.setAttribute('label',document.getElementById('offlineStrings').getString('list.actions.menu.label'));
1561             btn.setAttribute('accesskey',document.getElementById('offlineStrings').getString('list.actions.menu.accesskey'));
1562             var mp = document.createElement('menupopup');
1563             btn.appendChild(mp);
1564             var mi = document.createElement('menuitem');
1565             mi.setAttribute('id',obj.node.id + '_clipfield');
1566             mi.setAttribute('disabled','true');
1567             mi.setAttribute('label',document.getElementById('offlineStrings').getString('list.actions.field_to_clipboard.label'));
1568             mi.setAttribute('accesskey',document.getElementById('offlineStrings').getString('list.actions.field_to_clipboard.accesskey'));
1569             mp.appendChild(mi);
1570             mi = document.createElement('menuitem');
1571             mi.setAttribute('id',obj.node.id + '_csv_to_clipboard');
1572             mi.setAttribute('label',document.getElementById('offlineStrings').getString('list.actions.csv_to_clipboard.label'));
1573             mi.setAttribute('accesskey',document.getElementById('offlineStrings').getString('list.actions.csv_to_clipboard.accesskey'));
1574             mp.appendChild(mi);
1575             mi = document.createElement('menuitem');
1576             mi.setAttribute('id',obj.node.id + '_csv_to_printer');
1577             mi.setAttribute('label',document.getElementById('offlineStrings').getString('list.actions.csv_to_printer.label'));
1578             mi.setAttribute('accesskey',document.getElementById('offlineStrings').getString('list.actions.csv_to_printer.accesskey'));
1579             mp.appendChild(mi);
1580             mi = document.createElement('menuitem');
1581             mi.setAttribute('id',obj.node.id + '_extended_to_printer');
1582             mi.setAttribute('label',document.getElementById('offlineStrings').getString('list.actions.extended_to_printer.label'));
1583             mi.setAttribute('accesskey',document.getElementById('offlineStrings').getString('list.actions.extended_to_printer.accesskey'));
1584             mp.appendChild(mi);
1585             mi = document.createElement('menuitem');
1586             mi.setAttribute('id',obj.node.id + '_csv_to_file');
1587             mi.setAttribute('label',document.getElementById('offlineStrings').getString('list.actions.csv_to_file.label'));
1588             mi.setAttribute('accesskey',document.getElementById('offlineStrings').getString('list.actions.csv_to_file.accesskey'));
1589             mp.appendChild(mi);
1590             mi = document.createElement('menuitem');
1591             mi.setAttribute('id',obj.node.id + '_save_columns');
1592             mi.setAttribute('label',document.getElementById('offlineStrings').getString('list.actions.save_column_configuration.label'));
1593             mi.setAttribute('accesskey',document.getElementById('offlineStrings').getString('list.actions.save_column_configuration.accesskey'));
1594             if (obj.data.hash.aous['gui.disable_local_save_columns']) {
1595                 mi.setAttribute('disabled','true');
1596             }
1597             mp.appendChild(mi);
1598             return btn;
1599         } catch(E) {
1600             obj.error.standard_unexpected_error_alert('rendering list actions',E);
1601         }
1602     },
1603
1604     'set_list_actions' : function(params) {
1605         var obj = this;
1606         switch(this.node.nodeName) {
1607             case 'tree' : return this._set_list_actions_for_tree(params); break;
1608             default: throw('NYI: Need ._set_list_actions() for ' + this.node.nodeName); break;
1609         }
1610     },
1611
1612     '_set_list_actions_for_tree' : function(params) {
1613         // This should be called after the button element from render_list_actions has been appended to the DOM
1614         var obj = this;
1615         try {
1616             var x = document.getElementById(obj.node.id + '_clipfield');
1617             if (x) {
1618                 x.addEventListener(
1619                     'command',
1620                     function() {
1621                         obj.clipboard(params);
1622                         if (params && typeof params.on_complete == 'function') {
1623                             params.on_complete(params);
1624                         }
1625                     },
1626                     false
1627                 );
1628             }
1629             x = document.getElementById(obj.node.id + '_csv_to_clipboard');
1630             if (x) {
1631                 x.addEventListener(
1632                     'command',
1633                     function() {
1634                         obj.dump_csv_to_clipboard(params);
1635                         if (params && typeof params.on_complete == 'function') {
1636                             params.on_complete(params);
1637                         }
1638                     },
1639                     false
1640                 );
1641             }
1642             x = document.getElementById(obj.node.id + '_csv_to_printer');
1643             if (x) {
1644                 x.addEventListener(
1645                     'command',
1646                     function() {
1647                         obj.dump_csv_to_printer(params);
1648                         if (params && typeof params.on_complete == 'function') {
1649                             params.on_complete(params);
1650                         }
1651                     },
1652                     false
1653                 );
1654             }
1655             x = document.getElementById(obj.node.id + '_extended_to_printer');
1656             if (x) {
1657                 x.addEventListener(
1658                     'command',
1659                     function() {
1660                         obj.dump_extended_format_to_printer(params);
1661                         if (params && typeof params.on_complete == 'function') {
1662                             params.on_complete(params);
1663                         }
1664                     },
1665                     false
1666                 );
1667             }
1668
1669             x = document.getElementById(obj.node.id + '_csv_to_file');
1670             if (x) {
1671                 x.addEventListener(
1672                     'command',
1673                     function() {
1674                         obj.dump_csv_to_file(params);
1675                         if (params && typeof params.on_complete == 'function') {
1676                             params.on_complete(params);
1677                         }
1678                     },
1679                     false
1680                 );
1681             }
1682             x = document.getElementById(obj.node.id + '_save_columns');
1683             if (x) {
1684                 x.addEventListener(
1685                     'command',
1686                     function() {
1687                         obj.save_columns(params);
1688                         if (params && typeof params.on_complete == 'function') {
1689                             params.on_complete(params);
1690                         }
1691                     },
1692                     false
1693                 );
1694             }
1695
1696         } catch(E) {
1697             obj.error.standard_unexpected_error_alert('setting list actions',E);
1698         }
1699     },
1700
1701     // Takes fieldmapper class name and attempts to spit out column definitions suitable for .init
1702     'fm_columns' : function(hint,column_extras,prefix) {
1703         var obj = this;
1704         var columns = [];
1705         if (!prefix) { prefix = ''; }
1706         try {
1707             // requires the dojo library fieldmapper.autoIDL
1708             if (typeof fieldmapper == 'undefined') { throw 'fieldmapper undefined'; }
1709             if (typeof fieldmapper.IDL == 'undefined') { throw 'fieldmapper.IDL undefined'; }
1710             if (typeof fieldmapper.IDL.fmclasses == 'undefined') { throw 'fieldmapper.IDL.fmclasses undefined'; }
1711             if (typeof fieldmapper.IDL.fmclasses[hint] == 'undefined') { throw 'fieldmapper.IDL.fmclasses.' + hint + ' undefined'; }
1712             var my_class = fieldmapper.IDL.fmclasses[hint];
1713             var data = obj.data; data.stash_retrieve();
1714
1715             function col_def(my_field) {
1716                 var col_id = prefix + hint + '_' + my_field.name;
1717                 var dataobj = hint;
1718                 var datafield = my_field.name;
1719                 if (column_extras) {
1720                     if (column_extras['*']) {
1721                         if (column_extras['*']['dataobj']) {
1722                             dataobj = column_extras['*']['dataobj'];
1723                         }
1724                     }
1725                     if (column_extras[col_id]) {
1726                         if (column_extras[col_id]['dataobj']) {
1727                             dataobj = column_extras[col_id]['dataobj'];
1728                         }
1729                         if (column_extras[col_id]['datafield']) {
1730                             datafield = column_extras[col_id]['datafield'];
1731                         }
1732                     }
1733                 }
1734                 var def = {
1735                     'id' : col_id,
1736                     'label' : my_field.label || my_field.name,
1737                     'sort_type' : [ 'int', 'float', 'id', 'number' ].indexOf(my_field.datatype) > -1 ? 'number' :
1738                         ( my_field.datatype == 'money' ? 'money' :
1739                         ( my_field.datatype == 'timestamp' ? 'date' : 'default')),
1740                     'hidden' : my_field.virtual || my_field.datatype == 'link',
1741                     'flex' : 1
1742                 };
1743                 // my_field.datatype => bool float id int interval link money number org_unit text timestamp
1744                 if (my_field.datatype == 'link') {
1745                     def.render = function(my) {
1746                         return typeof my[dataobj][datafield]() == 'object' ? my[dataobj][datafield]()[my_field.key]() : my[dataobj][datafield]();
1747                     }
1748                 } else {
1749                     def.render = function(my) { return my[dataobj][datafield](); }
1750                 }
1751                 if (my_field.datatype == 'timestamp') {
1752                     JSAN.use('util.date');
1753                     def.render = function(my) {
1754                         return util.date.formatted_date( my[dataobj][datafield](), '%{localized}' );
1755                     }
1756                 }
1757                 if (my_field.datatype == 'org_unit') {
1758                     def.render = function(my) {
1759                         return typeof my[dataobj][datafield]() == 'object' ? my[dataobj][datafield]().shortname() : data.hash.aou[ my[dataobj][datafield]() ].shortname();
1760                     }
1761                 }
1762                 if (my_field.datatype == 'money') {
1763                     JSAN.use('util.money');
1764                     def.render = function(my) {
1765                         return util.money.sanitize( my[dataobj][datafield]() );
1766                     }
1767                 }
1768                 if (column_extras) {
1769                     if (column_extras['*']) {
1770                         for (var attr in column_extras['*']) {
1771                             def[attr] = column_extras['*'][attr];
1772                         }
1773                         if (column_extras['*']['expanded_label']) {
1774                             def.label = my_class.label + ': ' + def.label;
1775                         }
1776                         if (column_extras['*']['label_prefix']) {
1777                             def.label = column_extras['*']['label_prefix'] + def.label;
1778                         }
1779                         if (column_extras['*']['remove_virtual']) {
1780                             if (my_field.virtual) {
1781                                 def.remove_me = true;
1782                             }
1783                         }
1784                     }
1785                     if (column_extras[col_id]) {
1786                         for (var attr in column_extras[col_id]) {
1787                             def[attr] = column_extras[col_id][attr];
1788                         }
1789                         if (column_extras[col_id]['keep_me']) {
1790                             def.remove_me = false;
1791                         }
1792                         if (column_extras[col_id]['label_prefix']) {
1793                             def.label = column_extras[col_id]['label_prefix'] + def.label;
1794                         }
1795                     }
1796                 }
1797                 if (def.remove_me) {
1798                     dump('Skipping ' + def.label + '\n');
1799                     return null;
1800                 } else {
1801                     dump('Defining ' + def.label + '\n');
1802                     return def;
1803                 }
1804             }
1805
1806             for (var i = 0; i < my_class.fields.length; i++) {
1807                 var my_field = my_class.fields[i];
1808                 var def = col_def(my_field);
1809                 if (def) {
1810                     columns.push( def );
1811                 }
1812             }
1813
1814         } catch(E) {
1815             obj.error.standard_unexpected_error_alert('fm_columns()',E);
1816         }
1817         return columns;
1818     },
1819     // Default for the map_row_to_columns function for .init
1820     'std_map_row_to_columns' : function(error_value) {
1821         return function(row,cols,scratch) {
1822             // row contains { 'my' : { 'acp' : {}, 'circ' : {}, 'mvr' : {} } }
1823             // cols contains all of the objects listed above in columns
1824             // scratch is a temporary space shared by all cells/rows (or just per row if not explicitly passed in)
1825             if (!scratch) { scratch = {}; }
1826
1827             var obj = {};
1828             JSAN.use('util.error'); obj.error = new util.error();
1829             JSAN.use('OpenILS.data'); obj.data = new OpenILS.data(); obj.data.init({'via':'stash'});
1830             JSAN.use('util.network'); obj.network = new util.network();
1831             JSAN.use('util.money');
1832
1833             var my = row.my;
1834             var values = [];
1835             var cmd = '';
1836             try {
1837                 for (var i = 0; i < cols.length; i++) {
1838                     switch (typeof cols[i].render) {
1839                         case 'function': try { values[i] = cols[i].render(my,scratch); } catch(E) { values[i] = error_value; obj.error.sdump('D_COLUMN_RENDER_ERROR',E); } break;
1840                         case 'string' : cmd += 'try { ' + cols[i].render + '; values['+i+'] = v; } catch(E) { values['+i+'] = error_value; }'; break;
1841                         default: cmd += 'values['+i+'] = "??? '+(typeof cols[i].render)+'"; ';
1842                     }
1843                 }
1844                 if (cmd) eval( cmd );
1845             } catch(E) {
1846                 obj.error.sdump('D_WARN','map_row_to_column: ' + E);
1847                 if (error_value) { value = error_value; } else { value = '   ' };
1848             }
1849             return values;
1850         }
1851     }
1852 }
1853 dump('exiting util.list.js\n');