3 * Table Definition for Events
5 * objects can implement relatedWhere(), which should return
6 * 'tablename' => array of ids
10 require_once 'DB/DataObject.php';
12 class Pman_Core_DataObjects_Events extends DB_DataObject
15 /* the code below is auto generated do not remove the above tag */
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
29 /* the code above is auto generated do not remove the tag below */
35 // ------------ROO HOOKS------------------------------------
36 function applyFilters($q, $au)
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' ");
43 if (!empty($q['query']['to'])) {
44 $dt = date('Y-m-d' , strtotime($q['query']['to']));
45 $this->whereAdd(" {$tn}.event_when <= '$dt' ");
48 if (!empty($q['query']['grouped']) && $q['query']['grouped'] == 'gr') {
50 DB_DataObject::Debuglevel(1);
51 $this->groupBy('on_id');
53 (SELECT count(id) FROM core_event_audit WHERE event_id = Events.id) as changed
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;
64 // _join = tablename,tablename...
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..
72 if (isset($q['on_table']) && !strlen($q['on_table'])) {
73 // empty ontable queries.. these are valid..
74 $this->whereAdd("$tn.on_table = ''");
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');
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");
92 $this->groupBy('on_table');
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");
101 $this->groupBy('on_day');
104 if (isset($q['_join'])) {
105 //DB_DataObject::DebugLevel(1);
106 $joins = explode(',',$q['_join']);
108 $this->selectAdd(); // ???
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')) {
117 $jtn = $x->tableName();
118 $jk = array_shift($x->keys());
121 LEFT JOIN {$jtn} as join_on_id_{$jtn} ON {$tn}.on_id = join_on_id_{$jtn}.{$jk}
122 AND on_table = '{$jtn}'
124 $keys = array_keys($x->table());
125 if (isset($q['_join_cols'])) {
126 $jcs = explode(',',$q['_join_cols'] );
127 //DB_DataObject::DebugLevel(1);
129 foreach($jcs as $jc) {
130 if (! in_array($jc, $keys)) {
136 $this->selectAdd( " join_on_id_{$jtn}.{$jc} as on_id_{$jc} ");
138 $this->selectAdd( " distinct(join_on_id_{$jtn}.{$jc} ) as on_id_{$jc} ");
141 $this->groupBy("on_id_{$jc} ");
142 $this->whereAdd("join_on_id_{$jtn}.{$jc} IS NOT NULL");
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}");
148 $this->selectAs($x, 'on_id_%s', "join_on_id_{$jtn}");
157 if (isset($q['_related_on_id']) && isset($q['_related_on_table'])) {
158 // example: sales order - has invoices,
159 $ev =$this->factory('Events');
161 'on_id' => $q['_related_on_id'],
162 'on_table' => $q['_related_on_table'],
164 $obj = $ev->object();
166 if ($obj && method_exists($obj,'relatedWhere')) {
167 $ar = $obj->relatedWhere();
168 $tn = $this->tableName();
171 $w[] = "( {$tn}.on_table = '" .
172 $this->escape($q['_related_on_table']) .
173 "' AND {$tn}.on_id = ". ((int) $q['_related_on_id']) .
177 foreach($ar as $k=>$v) {
181 $w[] = "( {$tn}.on_table = '$k' AND {$tn}.on_id IN (". implode(',', $v). "))";
184 $this->whereAdd(implode(' OR ' , $w));
192 // since roo does not support autojoin yet..
193 if (!isset($q['_distinct'])) {
194 $this->autoJoinExtra();
203 function autoJoinExtra()
205 //$ret = parent::autoJoin();
206 // DB_DataObject::debugLevel(1);
208 // now try and magically join person_table to the right table..
209 $tn = $this->tableName();
210 $pt = DB_DataObject::Factory($this->tableName());
212 $pt->selectAdD('distinct(person_table) as person_table');
213 $pt->whereAdd('person_table IS NOT NULL AND LENGTH(person_table) > 0');
214 $tbls = $pt->fetchAll('person_table');
215 $pers = DB_DataObject::Factory('Person');
216 $ptbl = $pers->tableName();
217 if (!in_array($ptbl,$tbls)) {
221 foreach($tbls as $tbl) {
223 // find all the columns from the joined table..
224 $st = DB_DataObject::Factory($tbl);
225 $tcols = array_keys($st->table());
227 $cond = "{$tn}.person_table = '{$tbl}'";
229 $cond = "( $cond OR {$tn}.person_table = '')";
232 foreach($tcols as $col) {
233 if ($col == 'passwd') {
236 $cols[$col] = isset($cols[$col] ) ? $cols[$col] : array();
237 $cols[$col][] = "WHEN $cond THEN join_person_table_{$tbl}.{$col}";
239 // id's are hard coded...
242 LEFT JOIN {$tbl} AS join_person_table_{$tbl}
243 ON {$tn}.person_id = join_person_table_{$tbl}.id
247 foreach($cols as $col=>$whens) {
251 ". implode("\n", $whens) ."
254 as person_table_{$col}"
263 * check who is trying to access this. false == access denied..
264 * @return {boolean} true if access is allowed.
266 function checkPerm($lvl, $au)
271 // listing is controleed by applyfilters..
272 return $au->hasPerm("Admin.Admin_Tab", 'S');
276 * return the object that this relates to.
278 * @return {DB_DataObject} related object
282 $o = DB_DataObject::factory($this->on_table);
283 $o->get($this->on_id);
291 * Initialize an event - ready to insert..
293 * @param {String} action - group/name of event
294 * @param {DataObject|false} obj - dataobject action occured on.
295 * @param {String} any remarks
298 function init($act, $obj, $remarks)
300 $ff = HTML_FlexyFramework::get();
302 $au = $pg->getAuthUser();
304 if ($ff->cli) { // && empty($au) && isset($obj->person_id)) {
306 // $au = DB_DataObject::Factory('Person'); // not always a person..
307 // $au->get($obj->person_id);
310 $this->person_name = $au && !empty($au->name) ? $au->name : '';
311 $this->person_id = $au ? $au->id : -1;
312 $this->person_table = $au ? $au->tableName() : '';
313 $this->ipaddr = isset($_SERVER["REMOTE_ADDR"]) ? $_SERVER["REMOTE_ADDR"] : 'cli';
314 $this->action = $act;
315 $this->on_table = $obj ? $obj->tableName() : '';
316 $pk = $obj ? $obj->keys() : false;
317 $this->on_id = $obj && $pk ? $obj->{$pk[0]}: 0;
319 // should this really go in remarks? -
320 if ($obj && method_exists($obj,'toEventString')) {
321 $rem[] = $obj->toEventString() ;
324 $this->remarks = implode(' : ', $rem);
328 * Generate an audit for this field.
330 * @param {DB_DataObject} new data
331 * @param {DB_DataObject} old data
333 * @return {int} number of entries logged.
336 function audit($new, $old = false)
339 return 0; // they are the same...
343 foreach(array_keys($new->table()) as $k) {
344 // should we JSON serialize this?
345 $n = empty($new->$k) ? '' : $new->$k;
346 $o = empty($old->$k) || empty($old->$k) ? '' : $old->$k;
350 $this->auditField($k, $o, $n, $old);
356 * Record an audited change, in theory so we can audit data that is not just
359 * @param {string} $name table field anme
360 * @param {mixed} $ov old value
361 * @param {mixed} $onv new value
362 * @param {mixed} $old old object (false if we are creating..)
364 function auditField($name, $ov, $nv, $old=false )
366 $x = DB_DataObject::factory('core_event_audit');
368 'event_id' => $this->id,
370 'old_audit_id' => $old ? $x->findLast($this, $name) : 0,