git.roojs.org Git - Pman.Core/blob - 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)
  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             $ev  =$this->factory('Events');
 160             $ev->setFrom(array(
 161                 'on_id' => $q['_related_on_id'],
 162                 'on_table' => $q['_related_on_table'],
 163                                ));
 164             $obj = $ev->object();
 165
 166             if ($obj && method_exists($obj,'relatedWhere')) {
 167                 $ar = $obj->relatedWhere();
 168                 $tn = $this->tableName();
 169
 170                 $w = array();
 171                 $w[] = "( {$tn}.on_table = '" .
 172                         $this->escape($q['_related_on_table']) .
 173                         "' AND {$tn}.on_id = ". ((int)  $q['_related_on_id']) .
 174                     ")";
 175
 176
 177                 foreach($ar as $k=>$v) {
 178                     if (empty($v)) {
 179                         continue;
 180                     }
 181                      $w[] = "( {$tn}.on_table = '$k' AND {$tn}.on_id IN (". implode(',', $v). "))";
 182
 183                 }
 184                 $this->whereAdd(implode(' OR ' , $w));
 185             }
 186
 187
 188
 189
 190
 191         }
 192         // since roo does not support autojoin yet..
 193         if (!isset($q['_distinct'])) {
 194             $this->autoJoinExtra();
 195         }
 196
 197
 198
 199
 200
 201     }
 202
 203     function autoJoinExtra()
 204     {
 205         //$ret = parent::autoJoin();
 206         // DB_DataObject::debugLevel(1);
 207
 208         // now try and magically join person_table to the right table..
 209         return;
 210         // this does not work on postgres..
 211         $tn = $this->tableName();
 212         $pt = DB_DataObject::Factory($this->tableName());
 213         $pt->selectAdD();
 214         $pt->selectAdD('distinct(person_table) as person_table');
 215         $pt->whereAdd('person_table IS NOT NULL AND LENGTH(person_table) > 0');
 216         $tbls = $pt->fetchAll('person_table');
 217         $pers = DB_DataObject::Factory('Person');
 218         $ptbl = $pers->tableName();
 219         if (!in_array($ptbl,$tbls)) {
 220             $tbls[] = $ptbl;
 221
 222         }
 223         foreach($tbls as $tbl) {
 224
 225             // find all the columns from the joined table..
 226             $st = DB_DataObject::Factory($tbl);
 227             $tcols = array_keys($st->table());
 228
 229             $cond = "{$tn}.person_table = '{$tbl}'";
 230             if ($tbl == $ptbl) {
 231                 $cond = "( $cond OR {$tn}.person_table  = '')";
 232             }
 233
 234             foreach($tcols as $col) {
 235                 if ($col == 'passwd') {
 236                     continue;
 237                 }
 238                 $cols[$col]  = isset($cols[$col] ) ? $cols[$col]  : array();
 239                 $cols[$col][] = "WHEN $cond  THEN join_person_table_{$tbl}.{$col}";
 240             }
 241             // id's are hard coded...
 242
 243             $this->_join .= "
 244                 LEFT JOIN {$tbl} AS  join_person_table_{$tbl}
 245                     ON {$tn}.person_id = join_person_table_{$tbl}.id
 246                         AND $cond
 247             ";
 248         }
 249         foreach($cols as $col=>$whens) {
 250
 251             $this->selectAdd("
 252                     CASE
 253                         ". implode("\n", $whens) ."
 254                         ELSE ''
 255                     END
 256                     as person_table_{$col}"
 257             );
 258         }
 259         //return $ret;
 260
 261     }
 262
 263
 264     /**
 265      * check who is trying to access this. false == access denied..
 266      * @return {boolean} true if access is allowed.
 267      */
 268     function checkPerm($lvl, $au)
 269     {
 270         if ($lvl == 'S') {
 271             return true;
 272         }
 273         // listing is controleed by applyfilters..
 274         return $au->hasPerm("Admin.Admin_Tab", 'S');
 275     }
 276     /**
 277      * object :
 278      * return the object that this relates to.
 279      *
 280      * @return {DB_DataObject} related object
 281      */
 282     function object()
 283     {
 284         $o = DB_DataObject::factory($this->on_table);
 285         $o->get($this->on_id);
 286         return $o;
 287
 288     }
 289
 290
 291     /**
 292      * init:
 293      * Initialize an event - ready to insert..
 294      *
 295      * @param {String} action  - group/name of event
 296      * @param {DataObject|false} obj - dataobject action occured on.
 297      * @param {String} any remarks
 298      */
 299
 300     function init($act, $obj, $remarks)
 301     {
 302         $ff = HTML_FlexyFramework::get();
 303         $pg = $ff->page;
 304         $au = $pg->getAuthUser();
 305
 306         if ($ff->cli) { // && empty($au) && isset($obj->person_id)) {
 307             $au = false;
 308            // $au = DB_DataObject::Factory('Person'); // not always a person..
 309            // $au->get($obj->person_id);
 310         }
 311
 312         $this->person_name = $au && !empty($au->name) ? $au->name : '';
 313         $this->person_id = $au ? $au->id : -1;
 314         $this->person_table = $au ? $au->tableName() : '';
 315         $this->ipaddr = isset($_SERVER["REMOTE_ADDR"]) ? $_SERVER["REMOTE_ADDR"] : 'cli';
 316         $this->action = $act;
 317         $this->on_table = $obj ? $obj->tableName() : '';
 318         $pk = $obj ? $obj->keys()  : false;
 319         $this->on_id  = $obj && $pk ? $obj->{$pk[0]}: 0;
 320         $rem  = array();
 321         // should this really go in remarks? -
 322         if ($obj && method_exists($obj,'toEventString')) {
 323             $rem[] = $obj->toEventString() ;
 324         }
 325         $rem[] = $remarks;
 326         $this->remarks = implode(' : ', $rem);
 327     }
 328
 329     /**
 330      * Generate an audit for this field.
 331      *
 332      * @param {DB_DataObject} new data
 333      * @param {DB_DataObject} old data
 334      *
 335      * @return {int} number of entries logged.
 336      */
 337
 338     function audit($new, $old = false)
 339     {
 340         if ($old == $new) {
 341             return 0; // they are the same...
 342         }
 343
 344         $ret = 0;
 345         foreach(array_keys($new->table()) as $k) {
 346             // should we JSON serialize this?
 347             $n = empty($new->$k) ? '' : $new->$k;
 348             $o = empty($old->$k) || empty($old->$k) ? '' : $old->$k;
 349             if ($n == $o) {
 350                 continue;
 351             }
 352             $this->auditField($k, $o, $n, $old);
 353             $ret++;
 354         }
 355         return $ret;
 356     }
 357     /**
 358      * Record an audited change, in theory so we can audit data that is not just
 359      * database Fields...
 360      *
 361      * @param {string} $name    table field anme
 362      * @param {mixed} $ov  old value
 363      * @param {mixed} $onv  new value
 364      * @param {mixed} $old  old object (false if we are creating..)
 365      */
 366     function auditField($name, $ov, $nv, $old=false )
 367     {
 368         $x = DB_DataObject::factory('core_event_audit');
 369         $x->setFrom(array(
 370             'event_id' => $this->id,
 371             'name' => $name,
 372             'old_audit_id' => $old ? $x->findLast($this, $name) : 0,
 373             'newvalue' => $nv
 374
 375         ));
 376         $x->insert();
 377
 378     }
 379 }