3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.6 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2015 |
7 +--------------------------------------------------------------------+
8 | This file is a part of CiviCRM. |
10 | CiviCRM is free software; you can copy, modify, and distribute it |
11 | under the terms of the GNU Affero General Public License |
12 | Version 3, 19 November 2007 and the CiviCRM Licensing Exception. |
14 | CiviCRM is distributed in the hope that it will be useful, but |
15 | WITHOUT ANY WARRANTY; without even the implied warranty of |
16 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
17 | See the GNU Affero General Public License for more details. |
19 | You should have received a copy of the GNU Affero General Public |
20 | License and the CiviCRM Licensing Exception along |
21 | with this program; if not, contact CiviCRM LLC |
22 | at info[AT]civicrm[DOT]org. If you have questions about the |
23 | GNU Affero General Public License or the licensing of CiviCRM, |
24 | see the CiviCRM license FAQ at http://civicrm.org/licensing |
25 +--------------------------------------------------------------------+
31 * @copyright CiviCRM LLC (c) 2004-2015
35 class CRM_Logging_Differ
{
42 * @param int $log_conn_id
44 * @param string $interval
46 public function __construct($log_conn_id, $log_date, $interval = '10 SECOND') {
47 $dsn = defined('CIVICRM_LOGGING_DSN') ? DB
::parseDSN(CIVICRM_LOGGING_DSN
) : DB
::parseDSN(CIVICRM_DSN
);
48 $this->db
= $dsn['database'];
49 $this->log_conn_id
= $log_conn_id;
50 $this->log_date
= $log_date;
51 $this->interval
= $interval;
59 public function diffsInTables($tables) {
61 foreach ($tables as $table) {
62 $diff = $this->diffsInTable($table);
64 $diffs[$table] = $diff;
72 * @param int $contactID
76 public function diffsInTable($table, $contactID = NULL) {
80 1 => array($this->log_conn_id
, 'Integer'),
81 2 => array($this->log_date
, 'String'),
84 $logging = new CRM_Logging_Schema();
85 $addressCustomTables = $logging->entityCustomDataLogTables('Address');
87 $contactIdClause = $join = '';
89 $params[3] = array($contactID, 'Integer');
91 case 'civicrm_contact':
92 $contactIdClause = "AND id = %3";
96 $contactIdClause = "AND (( entity_id = %3 AND entity_table = 'civicrm_contact' ) OR (entity_id IN (SELECT note.id FROM `{$this->db}`.log_civicrm_note note WHERE note.entity_id = %3 AND note.entity_table = 'civicrm_contact') AND entity_table = 'civicrm_note'))";
99 case 'civicrm_entity_tag':
100 $contactIdClause = "AND entity_id = %3 AND entity_table = 'civicrm_contact'";
103 case 'civicrm_relationship':
104 $contactIdClause = "AND (contact_id_a = %3 OR contact_id_b = %3)";
107 case 'civicrm_activity':
108 $activityContacts = CRM_Core_OptionGroup
::values('activity_contacts', FALSE, FALSE, FALSE, NULL, 'name');
109 $sourceID = CRM_Utils_Array
::key('Activity Source', $activityContacts);
110 $assigneeID = CRM_Utils_Array
::key('Activity Assignees', $activityContacts);
111 $targetID = CRM_Utils_Array
::key('Activity Targets', $activityContacts);
114 LEFT JOIN civicrm_activity_contact at ON at.activity_id = lt.id AND at.contact_id = %3 AND at.record_type_id = {$targetID}
115 LEFT JOIN civicrm_activity_contact aa ON aa.activity_id = lt.id AND aa.contact_id = %3 AND aa.record_type_id = {$assigneeID}
116 LEFT JOIN civicrm_activity_contact source ON source.activity_id = lt.id AND source.contact_id = %3 AND source.record_type_id = {$sourceID} ";
117 $contactIdClause = "AND (at.id IS NOT NULL OR aa.id IS NOT NULL OR source.id IS NOT NULL)";
121 $contactIdClause = "AND id = (select case_id FROM civicrm_case_contact WHERE contact_id = %3 LIMIT 1)";
125 if (array_key_exists($table, $addressCustomTables)) {
126 $join = "INNER JOIN `{$this->db}`.`log_civicrm_address` et ON et.id = lt.entity_id";
127 $contactIdClause = "AND contact_id = %3";
131 // allow tables to be extended by report hook query objects
132 list($contactIdClause, $join) = CRM_Report_BAO_Hook
::singleton()->logDiffClause($this, $table);
134 if (empty($contactIdClause)) {
135 $contactIdClause = "AND contact_id = %3";
137 if (strpos($table, 'civicrm_value') !== FALSE) {
138 $contactIdClause = "AND entity_id = %3";
143 // find ids in this table that were affected in the given connection (based on connection id and a ±10 s time period around the date)
145 SELECT DISTINCT lt.id FROM `{$this->db}`.`log_$table` lt
147 WHERE lt.log_conn_id = %1 AND
148 lt.log_date BETWEEN DATE_SUB(%2, INTERVAL {$this->interval}) AND DATE_ADD(%2, INTERVAL {$this->interval})
151 $dao = CRM_Core_DAO
::executeQuery($sql, $params);
152 while ($dao->fetch()) {
153 $diffs = array_merge($diffs, $this->diffsInTableForId($table, $dao->id
));
165 private function diffsInTableForId($table, $id) {
169 1 => array($this->log_conn_id
, 'Integer'),
170 2 => array($this->log_date
, 'String'),
171 3 => array($id, 'Integer'),
174 // look for all the changes in the given connection that happended less than {$this->interval} s later than log_date to the given id to catch multi-query changes
175 $changedSQL = "SELECT * FROM `{$this->db}`.`log_$table` WHERE log_conn_id = %1 AND log_date >= %2 AND log_date < DATE_ADD(%2, INTERVAL {$this->interval}) AND id = %3 ORDER BY log_date DESC LIMIT 1";
177 $changedDAO = CRM_Core_DAO
::executeQuery($changedSQL, $params);
178 while ($changedDAO->fetch()) {
179 $changed = $changedDAO->toArray();
181 // return early if nothing found
182 if (empty($changed)) {
186 switch ($changed['log_action']) {
188 // the previous state is kept in the current state, current should keep the keys and clear the values
189 $original = $changed;
190 foreach ($changed as & $val) {
193 $changed['log_action'] = 'Delete';
197 // the previous state does not exist
202 // look for the previous state (different log_conn_id) of the given id
203 $originalSQL = "SELECT * FROM `{$this->db}`.`log_$table` WHERE log_conn_id != %1 AND log_date < %2 AND id = %3 ORDER BY log_date DESC LIMIT 1";
204 $original = $this->sqlToArray($originalSQL, $params);
205 if (empty($original)) {
206 // A blank original array is not possible for Update action, otherwise we 'll end up displaying all information
207 // in $changed variable as updated-info
208 $original = $changed;
214 // populate $diffs with only the differences between $changed and $original
215 $skipped = array('log_action', 'log_conn_id', 'log_date', 'log_user_id');
216 foreach (array_keys(array_diff_assoc($changed, $original)) as $diff) {
217 if (in_array($diff, $skipped)) {
221 if (CRM_Utils_Array
::value($diff, $original) === CRM_Utils_Array
::value($diff, $changed)) {
225 // hack: case_type_id column is a varchar with separator. For proper mapping to type labels,
226 // we need to make sure separators are trimmed
227 if ($diff == 'case_type_id') {
228 foreach (array('original', 'changed') as $var) {
229 if (!empty($
$var[$diff])) {
231 $val = explode(CRM_Case_BAO_Case
::VALUE_SEPARATOR
, $holder[$diff]);
232 $holder[$diff] = CRM_Utils_Array
::value(1, $val);
238 'action' => $changed['log_action'],
241 'from' => CRM_Utils_Array
::value($diff, $original),
242 'to' => CRM_Utils_Array
::value($diff, $changed),
255 public function titlesAndValuesForTable($table) {
256 // static caches for subsequent calls with the same $table
257 static $titles = array();
258 static $values = array();
260 // FIXME: split off the table → DAO mapping to a GenCode-generated class
261 static $daos = array(
262 'civicrm_address' => 'CRM_Core_DAO_Address',
263 'civicrm_contact' => 'CRM_Contact_DAO_Contact',
264 'civicrm_email' => 'CRM_Core_DAO_Email',
265 'civicrm_im' => 'CRM_Core_DAO_IM',
266 'civicrm_openid' => 'CRM_Core_DAO_OpenID',
267 'civicrm_phone' => 'CRM_Core_DAO_Phone',
268 'civicrm_website' => 'CRM_Core_DAO_Website',
269 'civicrm_contribution' => 'CRM_Contribute_DAO_Contribution',
270 'civicrm_note' => 'CRM_Core_DAO_Note',
271 'civicrm_relationship' => 'CRM_Contact_DAO_Relationship',
272 'civicrm_activity' => 'CRM_Activity_DAO_Activity',
273 'civicrm_case' => 'CRM_Case_DAO_Case',
276 if (!isset($titles[$table]) or !isset($values[$table])) {
278 if (in_array($table, array_keys($daos))) {
279 // FIXME: these should be populated with pseudo constants as they
280 // were at the time of logging rather than their current values
281 // FIXME: Use *_BAO:buildOptions() method rather than pseudoconstants & fetch programmatically
282 $values[$table] = array(
283 'contribution_page_id' => CRM_Contribute_PseudoConstant
::contributionPage(),
284 'contribution_status_id' => CRM_Contribute_PseudoConstant
::contributionStatus(),
285 'financial_type_id' => CRM_Contribute_PseudoConstant
::financialType(),
286 'country_id' => CRM_Core_PseudoConstant
::country(),
287 'gender_id' => CRM_Core_PseudoConstant
::get('CRM_Contact_DAO_Contact', 'gender_id'),
288 'location_type_id' => CRM_Core_PseudoConstant
::get('CRM_Core_DAO_Address', 'location_type_id'),
289 'payment_instrument_id' => CRM_Contribute_PseudoConstant
::paymentInstrument(),
290 'phone_type_id' => CRM_Core_PseudoConstant
::get('CRM_Core_DAO_Phone', 'phone_type_id'),
291 'preferred_communication_method' => CRM_Contact_BAO_Contact
::buildOptions('preferred_communication_method'),
292 'preferred_language' => CRM_Contact_BAO_Contact
::buildOptions('preferred_language'),
293 'prefix_id' => CRM_Contact_BAO_Contact
::buildOptions('prefix_id'),
294 'provider_id' => CRM_Core_PseudoConstant
::get('CRM_Core_DAO_IM', 'provider_id'),
295 'state_province_id' => CRM_Core_PseudoConstant
::stateProvince(),
296 'suffix_id' => CRM_Contact_BAO_Contact
::buildOptions('suffix_id'),
297 'website_type_id' => CRM_Core_PseudoConstant
::get('CRM_Core_DAO_Website', 'website_type_id'),
298 'activity_type_id' => CRM_Core_PseudoConstant
::activityType(TRUE, TRUE, FALSE, 'label', TRUE),
299 'case_type_id' => CRM_Case_PseudoConstant
::caseType('title', FALSE),
300 'priority_id' => CRM_Core_PseudoConstant
::get('CRM_Activity_DAO_Activity', 'priority_id'),
303 // for columns that appear in more than 1 table
306 $values[$table]['status_id'] = CRM_Case_PseudoConstant
::caseStatus('label', FALSE);
309 case 'civicrm_activity':
310 $values[$table]['status_id'] = CRM_Core_PseudoConstant
::activityStatus();
314 $dao = new $daos[$table]();
315 foreach ($dao->fields() as $field) {
316 $titles[$table][$field['name']] = CRM_Utils_Array
::value('title', $field);
318 if ($field['type'] == CRM_Utils_Type
::T_BOOLEAN
) {
319 $values[$table][$field['name']] = array('0' => ts('false'), '1' => ts('true'));
323 elseif (substr($table, 0, 14) == 'civicrm_value_') {
324 list($titles[$table], $values[$table]) = $this->titlesAndValuesForCustomDataTable($table);
327 $titles[$table] = $values[$table] = array();
331 return array($titles[$table], $values[$table]);
336 * @param array $params
340 private function sqlToArray($sql, $params) {
341 $dao = CRM_Core_DAO
::executeQuery($sql, $params);
343 return $dao->toArray();
351 private function titlesAndValuesForCustomDataTable($table) {
356 1 => array($this->log_conn_id
, 'Integer'),
357 2 => array($this->log_date
, 'String'),
358 3 => array($table, 'String'),
361 $sql = "SELECT id, title FROM `{$this->db}`.log_civicrm_custom_group WHERE log_date <= %2 AND table_name = %3 ORDER BY log_date DESC LIMIT 1";
362 $cgDao = CRM_Core_DAO
::executeQuery($sql, $params);
365 $params[3] = array($cgDao->id
, 'Integer');
367 SELECT column_name, data_type, label, name, option_group_id
368 FROM `{$this->db}`.log_civicrm_custom_field
370 AND custom_group_id = %3
373 $cfDao = CRM_Core_DAO
::executeQuery($sql, $params);
375 while ($cfDao->fetch()) {
376 $titles[$cfDao->column_name
] = "{$cgDao->title}: {$cfDao->label}";
378 switch ($cfDao->data_type
) {
380 $values[$cfDao->column_name
] = array('0' => ts('false'), '1' => ts('true'));
384 $values[$cfDao->column_name
] = array();
385 if (!empty($cfDao->option_group_id
)) {
386 $params[3] = array($cfDao->option_group_id
, 'Integer');
389 FROM `{$this->db}`.log_civicrm_option_value
391 AND option_group_id = %3
394 $ovDao = CRM_Core_DAO
::executeQuery($sql, $params);
395 while ($ovDao->fetch()) {
396 $values[$cfDao->column_name
][$ovDao->value
] = $ovDao->label
;
403 return array($titles, $values);