added check for staff to apply the staff max/recurring fines levels
[Evergreen.git] / Open-ILS / src / javascript / backend / circ / circ_lib.js
1 load_lib('catalog/record_type.js');
2 load_lib('circ/circ_groups.js');
3
4
5 try {
6         if( environment.copy ) {
7                 environment.copy.fetchBestHold = function() {
8                         var key = scratchKey();
9                         environment.copy.__OILS_FUNC_fetch_best_hold(scratchPad(key));
10                         var val = getScratch(key);
11                         return (val) ? val : null;
12                 }
13         }
14 } catch(e) {}
15
16
17 /* ----------------------------------------------------------------------------- 
18         Collect all of the global variables
19         ----------------------------------------------------------------------------- */
20
21 /* the global result object.  Any data returned to the 
22         caller must be put into this object.  */
23 var result                              = environment.result = {};
24 result.event                    = 'SUCCESS';
25 result.events                   = [];
26 result.fatalEvents      = [];
27 result.infoEvents               = [];
28
29
30 /* Pull in any variables passed in from the calling process */
31 var copy                                        = environment.copy;
32 var volume                              = environment.volume;
33 var title                               = environment.title;
34 var recDescriptor               = environment.titleDescriptor;
35 var patron                              = environment.patron;
36 var patronItemsOut      = environment.patronItemsOut;
37 var patronOverdueCount  = environment.patronOverdueCount;
38 var patronFines         = environment.patronFines;
39 var isRenewal                   = environment.isRenewal;
40 var isPrecat                    = environment.isPrecat;
41 var currentLocation     = environment.location;
42
43
44
45 /* create some new vars based on the data we have wherever possible */
46 var patronProfile;
47 var copyStatus;
48 var marcXMLDoc;
49
50 if( patron && patron.profile ) 
51         patronProfile = patron.profile.name;
52 if( copy && copy.status ) 
53         copyStatus = copy.status.name;
54 if( title && title.marc )
55         marcXMLDoc = new XML(title.marc);
56
57
58
59 /* copy the group tree into some other useful data structures */
60 var groupTree           = environment.groupTree;
61 var groupList           = {};
62 var groupIDList = {};
63 flattenGroupTree(groupTree);
64
65
66
67
68
69
70 /* ----------------------------------------------------------------------------- 
71         Define all of the utility functions
72         ----------------------------------------------------------------------------- */
73
74
75
76 /* useful functions for creating wrappers around system functions */
77 var __scratchKey = 0;
78 var __SCRATCH = {};
79 function scratchKey()           { return '_' + __scratchKey++; };
80 function scratchPad(key)        { return '__SCRATCH.'+ key; }
81 function getScratch(key)        { return __SCRATCH[ key ]; }
82 function scratchClear()         { for( var o in __SCRATCH ) __SCRATCH[o] = null; }
83
84
85 /* note: returns false if the value is 'f' or 'F' ... */
86 function isTrue(d) {
87         if(     d && 
88                         d != "0" && 
89                         d != "f" &&
90                         d != "F" )
91                         return true;
92         return false;
93 }
94
95 /* Utility function for iterating over array */
96 function iterate( arr, callback ) {
97         for( var i = 0; i < arr.length; i++ ) 
98                 callback(arr[i]);
99 }
100
101
102 /**
103   * returns a list of items that when passed to the callback 
104   * 'func' returned true returns null if none were found
105   */
106 function grep( arr, func ) {
107         var results = [];
108         iterate( arr, 
109                 function(d) {
110                         if( func(d) ) 
111                                 results.push(d);
112                 }
113         );
114         if(results.length > 0)  
115                 return results;
116         return null;
117 }
118
119
120
121 function flattenGroupTree(node) {
122         if(!node) return null;
123         groupList[node.name] = node;
124         groupIDList[node.id] = node;
125         iterate( node.children,
126                 function(n) {
127                         flattenGroupTree(n);
128                 }
129         );
130 }
131
132
133
134 /**
135   * Returns true if 'child' is equal or descends from 'parent'
136   * @param parent The name of the parent group
137   * @param child The name of the child group
138   */
139 function isGroupDescendant( parent, child ) {
140         log_debug("checking descendant p="+parent + " c=" + child);
141         return __isGroupDescendant(
142                 groupList[parent],
143                 groupList[child]);
144 }
145
146
147
148 /**
149   * Returns true if 'child' is equal or descends from 'parent'
150   * @param parent The node of the parent group
151   * @param child The node of the child group
152   */
153 function __isGroupDescendant( parent, child ) {
154         if (parent.id == child.id) return true;
155         var node = child;
156         while( (node = groupIDList[node.parent]) ) {
157                 if( node.id == parent.id ) 
158                         return true;
159         }
160         return false;
161 }
162
163
164 function getMARCItemType() {
165
166         if(     copy &&
167                         copy.circ_as_type &&
168                         copy.circ_as_type != 'undef' )
169                 return copy.circ_as_type;
170         
171         return (marcXMLDoc) ? extractFixedField(marcXMLDoc, 'Type') : "";
172 }
173
174
175 function isOrgDescendent( parentName, childId ) {
176         var key = scratchKey();
177         __OILS_FUNC_isOrgDescendent(scratchPad(key), parentName, childId);
178         var val = getScratch(key);
179         if( val == '1' ) return true;
180         return false;
181 }
182
183 /* useful for testing */
184 function die(msg) {
185         log_error("die(): "+msg);
186         log_stderr("die(): "+msg);
187         var foo = null;
188         var baz = foo.bar;
189 }
190
191
192
193 /*
194 - at some point we should add a library of objects that map 
195 codes to names (item_form, item_type, etc.)
196 load_lib('item_form_map.js');
197 var form_name = item_form_map[env.record_descriptor.item_form];
198 */
199
200
201
202 /* logs a load of info */
203 function log_vars( prefix ) {
204         var str = prefix + ' : ';
205
206         if(patron) {
207                 str += ' Patron=' + patron.id;
208                 str += ', Patron Username='+ patron.usrname;
209                 str += ', Patron Profile Group='+ patronProfile;
210                 str += ', Patron Fines='        + patronFines;
211                 str += ', Patron OverdueCount=' + patronOverdueCount;
212                 str += ', Patron Items Out=' + patronItemsOut;
213
214                 try {
215                         str += ', Patron Barcode='      + patron.card.barcode;
216                         str += ', Patron Library='      + patron.home_ou.name;
217                 } catch(e) {}
218         }
219
220         if(copy)        {
221                 str += ', Copy=' + copy.id;
222                 str += ', Copy Barcode=' + copy.barcode;
223                 str += ', Copy status=' + copyStatus;
224
225                 try {
226                         str += ', Circ Lib=' + copy.circ_lib.shortname;
227                         str += ', Copy location=' + copy.location.name;
228                 } catch(e) {}
229         }
230
231         if(volume)                      str += ', Volume='      + volume.id;
232         if(title)                       str += ', Record='      + title.id;
233
234         if(recDescriptor)       {
235                 str += ', Record Descriptor=' + recDescriptor.id;
236                 str += ', Item Type='                   + recDescriptor.item_type;
237                 str += ', Item Form='                   + recDescriptor.item_form;
238                 str += ', Item Lang='                   + recDescriptor.item_lang;
239                 str += ', Item Audience='               + recDescriptor.audience;
240         }
241
242         str += ' Is Renewal: '  + ( (isTrue(isRenewal)) ? "yes" : "no" );
243
244         log_debug(str);
245 }
246
247