DataObjects/Events.php
[Pman.Core] / DataObjects / Events.php
1 <?php
2 /**
3  * Table Definition for Events
4  *
5  * objects can implement relatedWhere(), which should return
6  *    'tablename' => array of ids
7  *
8  * 
9  */
10 require_once 'DB/DataObject.php';
11
12 class Pman_Core_DataObjects_Events extends DB_DataObject 
13 {
14     ###START_AUTOCODE
15     /* the code below is auto generated do not remove the above tag */
16
17     public $__table = 'Events';                          // table name
18     public $id;                              // int(11)  not_null primary_key auto_increment
19     public $person_name;                     // string(128)  
20     public $event_when;                      // datetime(19)  binary
21     public $action;                          // string(32)  
22     public $ipaddr;                          // string(16)  
23     public $on_id;                           // int(11)  
24     public $on_table;                        // string(64)  
25     public $person_id;                       // int(11)  
26     public $remarks;                         // blob(65535)  blob
27
28     
29     /* the code above is auto generated do not remove the tag below */
30     ###END_AUTOCODE
31     
32     
33     
34     
35     //  ------------ROO HOOKS------------------------------------
36     function applyFilters($q, $au ,$roo)
37     {
38         $tn = $this->tableName();
39         if (!empty($q['query']['from'])) {
40             $dt = date('Y-m-d' , strtotime($q['query']['from']));
41             $this->whereAdd(" {$tn}.event_when >=  '$dt' ");
42         }
43         if (!empty($q['query']['to'])) {
44             $dt = date('Y-m-d' , strtotime($q['query']['to']));
45             $this->whereAdd(" {$tn}.event_when <=  '$dt' ");
46         }
47         /*
48         if (!empty($q['query']['grouped']) && $q['query']['grouped'] == 'gr') {
49             // grouped..
50             DB_DataObject::Debuglevel(1);
51             $this->groupBy('on_id');
52             $this->selectAdd('
53                 (SELECT count(id) FROM core_event_audit WHERE event_id = Events.id) as changed
54                 ');
55         }
56         */
57         
58         if (!$au->hasPerm("Admin.Admin_Tab", 'S')) {
59             //DB_DataObject::DebugLevel(1);
60             // they can only view their changes..
61             $this->person_id = $au->id;
62             
63         }
64         // _join = tablename,tablename...
65         
66         /// on_table=cohead
67         //   &_join=cohead
68         //   &_join_cols=cohead_number
69         //    &_columns=on_id_cohead_number,event_when << this is ignored at present.
70         // max(event_when) is not supported... by any query yet..
71         
72         if (isset($q['on_table']) && !strlen($q['on_table'])) {
73             // empty ontable queries.. these are valid..
74             $this->whereAdd("$tn.on_table = ''");
75         }
76         
77         
78         if (isset($q['query']['person_sum'])) {
79             //DB_DataObject::debugLevel(1);
80             $this->_extra_cols = array('qty' );
81             $this->selectAdd("count($tn.id) as qty");
82             $this->selectAdd("count( distinct $tn.on_id) as uqty");
83             $this->whereAdd('LENGTH(join_person_id_id.name) > 0 ');
84             $this->groupBy('person_id');
85         }
86          if (isset($q['query']['table_sum'])) {
87             //DB_DataObject::debugLevel(1);
88             $this->_extra_cols = array('qty' , 'uqty');
89             $this->selectAdd("count($tn.id) as qty");
90             $this->selectAdd("count( distinct $tn.on_table, $tn.on_id) as uqty");
91             
92             $this->groupBy('on_table');
93         }
94          if (isset($q['query']['day_sum'])) {
95             //DB_DataObject::debugLevel(1);
96             $this->_extra_cols = array('qty' , 'uqty');
97             $this->selectAdd("DATE_FORMAT(event_when, '%Y-%m-%d') as on_day");
98             $this->selectAdd("count($tn.id) as qty");
99             $this->selectAdd("count( distinct $tn.on_id) as uqty");
100             
101             $this->groupBy('on_day');
102         }
103         
104         if (isset($q['_join'])) {
105             //DB_DataObject::DebugLevel(1);
106             $joins = explode(',',$q['_join']);
107             
108             $this->selectAdd(); // ???
109             $distinct = false;
110             
111             foreach($joins as $t) {
112                 $t = preg_replace('/[^a-z_]+/', '', $t); // protection.
113                 $x = DB_DataObject::Factory($t);
114                 if (!is_a($x,'DB_DataObject')) {
115                     continue;
116                 }
117                 $jtn = $x->tableName();
118                 $jk = array_shift($x->keys());
119                 $this->_join .= "
120                 
121                     LEFT JOIN {$jtn} as join_on_id_{$jtn} ON {$tn}.on_id = join_on_id_{$jtn}.{$jk}
122                         AND on_table = '{$jtn}'
123                 ";
124                 $keys = array_keys($x->table());
125                 if (isset($q['_join_cols'])) {
126                     $jcs = explode(',',$q['_join_cols'] );
127                     //DB_DataObject::DebugLevel(1);
128                     
129                     foreach($jcs as $jc) { 
130                         if (! in_array($jc, $keys)) {
131                             continue;
132                         }
133                         if ($distinct) { 
134                         
135                        
136                             $this->selectAdd( " join_on_id_{$jtn}.{$jc}   as on_id_{$jc} ");
137                         } else {
138                             $this->selectAdd( " distinct(join_on_id_{$jtn}.{$jc}  ) as on_id_{$jc} ");
139                             $distinct = true;
140                         }
141                         $this->groupBy("on_id_{$jc} ");
142                         $this->whereAdd("join_on_id_{$jtn}.{$jc} IS NOT NULL");
143                     }
144                     $this->selectAdd( "MAX(events.event_when) as event_when");
145                     $this->orderBy('event_when DESC');
146                    // $this->selectAs(array($q['_join_cols']) , 'on_id_%s', "join_on_id_{$jtn}");
147                 } else { 
148                     $this->selectAs($x, 'on_id_%s', "join_on_id_{$jtn}");
149                 }
150             }
151                 
152                 
153             
154             
155         }
156         
157         if (isset($q['_related_on_id']) && isset($q['_related_on_table'])) {
158             // example: sales order - has invoices,
159             DB_DataObject::DebugLevel(1);
160             $ev  =$this->factory('Events');
161             $ev->setFrom(array(
162                 'on_id' => $q['_related_on_id'],
163                 'on_table' => $q['_related_on_table'],
164                                ));
165             $obj = $ev->object();
166             
167             if (!$obj) {
168                 $roo->jerr("ontable is invalid");
169             }
170             if (!method_exists($obj,'relatedWhere')) {
171                 $roo->jerr( $q['_related_on_table'] . " Does not have method relatedWhere");
172             }
173             if ($obj && method_exists($obj,'relatedWhere')) {
174                 $ar = $obj->relatedWhere();
175                 $tn = $this->tableName();
176                 
177                 $w = array();
178                 $w[] = "( {$tn}.on_table = '" .
179                         $this->escape($q['_related_on_table']) .
180                         "' AND {$tn}.on_id = ". ((int)  $q['_related_on_id']) .
181                     ")";
182                 
183                 
184                 foreach($ar as $k=>$v) {
185                     if (empty($v)) {
186                         continue;
187                     }                
188                      $w[] = "( {$tn}.on_table = '$k' AND {$tn}.on_id IN (". implode(',', $v). "))";
189                     
190                 }
191                 $this->whereAdd(implode(' OR ' , $w));
192             }
193             
194             
195             
196             
197             
198         }
199         // since roo does not support autojoin yet..
200         if (!isset($q['_distinct'])) {
201             $this->autoJoinExtra();
202         }
203         
204         
205         
206             
207     }
208      
209     function autoJoinExtra()
210     {
211         //$ret = parent::autoJoin();
212         // DB_DataObject::debugLevel(1);
213         
214         // now try and magically join person_table to the right table..
215         return;
216         // this does not work on postgres.. 
217         $tn = $this->tableName();
218         $pt = DB_DataObject::Factory($this->tableName());
219         $pt->selectAdD();
220         $pt->selectAdD('distinct(person_table) as person_table');
221         $pt->whereAdd('person_table IS NOT NULL AND LENGTH(person_table) > 0');
222         $tbls = $pt->fetchAll('person_table');
223         $pers = DB_DataObject::Factory('Person');
224         $ptbl = $pers->tableName();
225         if (!in_array($ptbl,$tbls)) {
226             $tbls[] = $ptbl;
227             
228         }
229         foreach($tbls as $tbl) {
230             
231             // find all the columns from the joined table..
232             $st = DB_DataObject::Factory($tbl);
233             $tcols = array_keys($st->table());
234             
235             $cond = "{$tn}.person_table = '{$tbl}'";
236             if ($tbl == $ptbl) {
237                 $cond = "( $cond OR {$tn}.person_table  = '')";
238             }
239             
240             foreach($tcols as $col) {
241                 if ($col == 'passwd') {
242                     continue;
243                 }
244                 $cols[$col]  = isset($cols[$col] ) ? $cols[$col]  : array();
245                 $cols[$col][] = "WHEN $cond  THEN join_person_table_{$tbl}.{$col}";
246             }
247             // id's are hard coded...
248             
249             $this->_join .= "
250                 LEFT JOIN {$tbl} AS  join_person_table_{$tbl}
251                     ON {$tn}.person_id = join_person_table_{$tbl}.id
252                         AND $cond
253             ";
254         }
255         foreach($cols as $col=>$whens) {
256             
257             $this->selectAdd("
258                     CASE
259                         ". implode("\n", $whens) ." 
260                         ELSE ''
261                     END
262                     as person_table_{$col}"
263             );
264         }
265         //return $ret;
266          
267     }
268     
269     
270     /**
271      * check who is trying to access this. false == access denied..
272      * @return {boolean} true if access is allowed.
273      */
274     function checkPerm($lvl, $au) 
275     {
276         if ($lvl == 'S') {
277             return true;
278         }
279         // listing is controleed by applyfilters..
280         return $au->hasPerm("Admin.Admin_Tab", 'S');
281     }
282     /**
283      * object :
284      * return the object that this relates to.
285      * 
286      * @return {DB_DataObject} related object
287      */
288     function object()
289     {
290         $o = DB_DataObject::factory($this->on_table);
291         $o->get($this->on_id);
292         return $o;
293         
294     }
295     
296     
297     /**
298      * init:
299      * Initialize an event - ready to insert..
300      * 
301      * @param {String} action  - group/name of event
302      * @param {DataObject|false} obj - dataobject action occured on.
303      * @param {String} any remarks 
304      */
305     
306     function init($act, $obj, $remarks)
307     {
308         $ff = HTML_FlexyFramework::get();
309         $pg = $ff->page;
310         $au = $pg->getAuthUser();
311         
312         if ($ff->cli) { // && empty($au) && isset($obj->person_id)) {
313             $au = false;
314            // $au = DB_DataObject::Factory('Person'); // not always a person..
315            // $au->get($obj->person_id);
316         } 
317           
318         $this->person_name = $au && !empty($au->name) ? $au->name : '';
319         $this->person_id = $au ? $au->id : -1;
320         $this->person_table = $au ? $au->tableName() : '';
321         $this->ipaddr = isset($_SERVER["REMOTE_ADDR"]) ? $_SERVER["REMOTE_ADDR"] : 'cli';
322         $this->action = $act;
323         $this->on_table = $obj ? $obj->tableName() : '';
324         $pk = $obj ? $obj->keys()  : false;
325         $this->on_id  = $obj && $pk ? $obj->{$pk[0]}: 0;
326         $rem  = array();
327         // should this really go in remarks? - 
328         if ($obj && method_exists($obj,'toEventString')) {
329             $rem[] = $obj->toEventString() ;
330         }
331         $rem[] = $remarks;
332         $this->remarks = implode(' : ', $rem);
333     }
334     
335     /**
336      * Generate an audit for this field.
337      *
338      * @param {DB_DataObject} new data
339      * @param {DB_DataObject} old data
340      * 
341      * @return {int} number of entries logged.
342      */
343     
344     function audit($new, $old = false)
345     {
346         if ($old == $new) {
347             return 0; // they are the same...
348         }
349          
350         $ret = 0;
351         foreach(array_keys($new->table()) as $k) {
352             // should we JSON serialize this?
353             $n = empty($new->$k) ? '' : $new->$k;
354             $o = empty($old->$k) || empty($old->$k) ? '' : $old->$k;
355             if ($n == $o) {
356                 continue;
357             }
358             $this->auditField($k, $o, $n, $old);
359             $ret++;
360         }
361         return $ret;
362     }
363     /**
364      * Record an audited change, in theory so we can audit data that is not just
365      * database Fields...
366      *
367      * @param {string} $name    table field anme
368      * @param {mixed} $ov  old value
369      * @param {mixed} $onv  new value
370      * @param {mixed} $old  old object (false if we are creating..)
371      */
372     function auditField($name, $ov, $nv, $old=false )
373     {
374         $x = DB_DataObject::factory('core_event_audit');
375         $x->setFrom(array(
376             'event_id' => $this->id,
377             'name' => $name,
378             'old_audit_id' => $old ? $x->findLast($this, $name) : 0,
379             'newvalue' => $nv
380
381         ));
382         $x->insert();
383     
384     }
385 }