_logTables) as $table) { $type = $this->getLogType($table); $logTypes[$type] = $type; } asort($logTypes); $this->_columns = [ 'log_civicrm_entity' => [ 'dao' => 'CRM_Contact_DAO_Contact', 'alias' => 'entity_log', 'fields' => [ 'id' => [ 'no_display' => TRUE, 'required' => TRUE, ], 'log_grouping' => [ 'required' => TRUE, 'title' => ts('Extra information to control grouping'), 'no_display' => TRUE, ], 'log_action' => [ 'default' => TRUE, 'title' => ts('Action'), ], 'log_type' => [ 'required' => TRUE, 'title' => ts('Log Type'), ], 'log_user_id' => [ 'no_display' => TRUE, 'required' => TRUE, ], 'log_date' => [ 'default' => TRUE, 'required' => TRUE, 'type' => CRM_Utils_Type::T_TIME, 'title' => ts('When'), ], 'altered_contact' => [ 'default' => TRUE, 'name' => 'display_name', 'title' => ts('Altered Contact'), 'alias' => 'modified_contact_civireport', ], 'altered_contact_id' => [ 'name' => 'id', 'no_display' => TRUE, 'required' => TRUE, 'alias' => 'modified_contact_civireport', ], 'log_conn_id' => [ 'no_display' => TRUE, 'required' => TRUE, ], 'is_deleted' => [ 'no_display' => TRUE, 'required' => TRUE, 'alias' => 'modified_contact_civireport', ], ], 'filters' => [ 'log_date' => [ 'title' => ts('When'), 'operatorType' => CRM_Report_Form::OP_DATE, 'type' => CRM_Utils_Type::T_DATE, ], 'altered_contact' => [ 'name' => 'display_name', 'title' => ts('Altered Contact'), 'type' => CRM_Utils_Type::T_STRING, 'alias' => 'modified_contact_civireport', ], 'altered_contact_id' => [ 'name' => 'id', 'type' => CRM_Utils_Type::T_INT, 'alias' => 'modified_contact_civireport', 'no_display' => TRUE, ], 'log_type' => [ 'operatorType' => CRM_Report_Form::OP_MULTISELECT, 'options' => $logTypes, 'title' => ts('Log Type'), 'type' => CRM_Utils_Type::T_STRING, ], 'log_type_table' => [ 'name' => 'log_type', 'title' => ts('Log Type Table'), 'type' => CRM_Utils_Type::T_STRING, ], 'log_action' => [ 'operatorType' => CRM_Report_Form::OP_MULTISELECT, 'options' => [ 'Insert' => ts('Insert'), 'Update' => ts('Update'), 'Delete' => ts('Delete'), ], 'title' => ts('Action'), 'type' => CRM_Utils_Type::T_STRING, ], 'id' => [ 'no_display' => TRUE, 'type' => CRM_Utils_Type::T_INT, ], ], 'order_bys' => [ 'log_date' => [ 'title' => ts('Log Date (When)'), 'default' => TRUE, 'default_weight' => '0', 'default_order' => 'DESC', ], 'altered_contact' => [ 'name' => 'display_name', 'title' => ts('Altered Contact'), 'alias' => 'modified_contact_civireport', ], ], ], 'altered_by_contact' => [ 'dao' => 'CRM_Contact_DAO_Contact', 'alias' => 'altered_by_contact', 'fields' => [ 'display_name' => [ 'default' => TRUE, 'name' => 'display_name', 'title' => ts('Altered By'), ], ], 'filters' => [ 'display_name' => [ 'name' => 'display_name', 'title' => ts('Altered By'), 'type' => CRM_Utils_Type::T_STRING, ], ], 'order_bys' => [ 'altered_by_contact' => [ 'name' => 'display_name', 'title' => ts('Altered by'), ], ], ], ]; } /** * Alter display of rows. * * Iterate through the rows retrieved via SQL and make changes for display purposes, * such as rendering contacts as links. * * @param array $rows * Rows generated by SQL, with an array for each row. * * @throws \CRM_Core_Exception * @throws \CiviCRM_API3_Exception */ public function alterDisplay(&$rows) { // cache for id → is_deleted mapping $isDeleted = []; $newRows = []; foreach ($rows as $key => &$row) { $isMerge = 0; $baseQueryCriteria = "reset=1&log_conn_id={$row['log_civicrm_entity_log_conn_id']}"; if (!CRM_Logging_Differ::checkLogCanBeUsedWithNoLogDate($row['log_civicrm_entity_log_date'])) { $baseQueryCriteria .= '&log_date=' . CRM_Utils_Date::isoToMysql($row['log_civicrm_entity_log_date']); } if ($this->cid) { $baseQueryCriteria .= '&cid=' . $this->cid; } if (!isset($isDeleted[$row['log_civicrm_entity_altered_contact_id']])) { $isDeleted[$row['log_civicrm_entity_altered_contact_id']] = CRM_Core_DAO::getFieldValue('CRM_Contact_DAO_Contact', $row['log_civicrm_entity_altered_contact_id'], 'is_deleted') !== '0'; } if (!empty($row['log_civicrm_entity_altered_contact']) && !$isDeleted[$row['log_civicrm_entity_altered_contact_id']] ) { $row['log_civicrm_entity_altered_contact_link'] = CRM_Utils_System::url('civicrm/contact/view', 'reset=1&cid=' . $row['log_civicrm_entity_altered_contact_id']); $row['log_civicrm_entity_altered_contact_hover'] = ts("Go to contact summary"); $entity = $this->getEntityValue($row['log_civicrm_entity_id'], $row['log_civicrm_entity_log_type'], $row['log_civicrm_entity_log_date']); if ($entity) { $row['log_civicrm_entity_altered_contact'] .= " [{$entity}]"; } if ($entity === 'Contact Merged') { // We're looking at a merge activity created against the surviving // contact record. There should be a single activity created against // the deleted contact record, with this activity as parent. $deletedID = CRM_Core_DAO::singleValueQuery(' SELECT GROUP_CONCAT(contact_id) FROM civicrm_activity_contact ac INNER JOIN civicrm_activity a ON a.id = ac.activity_id AND a.parent_id = ' . $row['log_civicrm_entity_id'] . ' AND ac.record_type_id = ' . CRM_Core_PseudoConstant::getKey('CRM_Activity_BAO_ActivityContact', 'record_type_id', 'Activity Targets') ); if ($deletedID && !stristr($deletedID, ',')) { $baseQueryCriteria .= '&oid=' . $deletedID; } $row['log_civicrm_entity_log_action'] = ts('Contact Merge'); $row = $this->addDetailReportLinksToRow($baseQueryCriteria, $row); $isMerge = 1; } } $row['altered_by_contact_display_name_link'] = CRM_Utils_System::url('civicrm/contact/view', 'reset=1&cid=' . $row['log_civicrm_entity_log_user_id']); $row['altered_by_contact_display_name_hover'] = ts('Go to contact summary'); if ($row['log_civicrm_entity_is_deleted'] && 'Update' === $row['log_civicrm_entity_log_action']) { $row['log_civicrm_entity_log_action'] = ts('Delete (to trash)'); } if ('Contact' === ($this->_logTables[$row['log_civicrm_entity_log_type']]['log_type'] ?? NULL) && $row['log_civicrm_entity_log_action'] === ts('Insert') ) { $row['log_civicrm_entity_log_action'] = ts('Update'); } // For certain tables, we may want to look at an alternate column to // determine which action to display, determined by the 'action_column' // key of the entry in $this->_logTables. if ($newAction = $this->getEntityAction($row['log_civicrm_entity_id'], $row['log_civicrm_entity_log_conn_id'], $row['log_civicrm_entity_log_type'], ($row['log_civicrm_entity_log_action'] ?? NULL)) ) { $row['log_civicrm_entity_log_action'] = $newAction; } $row['log_civicrm_entity_log_type'] = $this->getLogType($row['log_civicrm_entity_log_type']); $date = CRM_Utils_Date::isoToMysql($row['log_civicrm_entity_log_date']); if (in_array(($row['log_civicrm_entity_log_action'] ?? NULL), ['Update', 'Delete'])) { $row = $this->addDetailReportLinksToRow($baseQueryCriteria, $row); } // In the summary, we only want to show one row per entity type, // connection ID, contact ID, and user ID, rolling up multiple // related actions against the same entity. $key = $date . '_' . $row['log_civicrm_entity_log_type'] . '_' . // This ensures merge activities are not 'lost' by aggregation. // I would prefer not to lose other entities either but it's a balancing act as // described in https://issues.civicrm.org/jira/browse/CRM-12867 so adding this criteria // while hackish saves us from figuring out if the original decision is still good. $isMerge . '_' . $row['log_civicrm_entity_log_conn_id'] . '_' . $row['log_civicrm_entity_log_user_id'] . '_' . $row['log_civicrm_entity_altered_contact_id']; $newRows[$key] = $row; unset($row['log_civicrm_entity_log_user_id']); unset($row['log_civicrm_entity_log_conn_id']); } krsort($newRows); $rows = $newRows; } /** * Generate From Clause. */ public function from() { if (!$this->currentLogTable) { // From has already been built in this case. return; } $entity = $this->currentLogTable; $detail = $this->_logTables[$entity]; $tableName = $detail['table_name'] ?? $entity; $clause = $detail['entity_table'] ?? NULL; $clause = $clause ? "AND entity_log_civireport.entity_table = 'civicrm_contact'" : NULL; $joinClause = " INNER JOIN civicrm_contact modified_contact_civireport ON (entity_log_civireport.{$detail['fk']} = modified_contact_civireport.id {$clause})"; if (!empty($detail['joins'])) { $clause = $detail['entity_table'] ?? NULL; $clause = $clause ? "AND fk_table.entity_table = 'civicrm_contact'" : NULL; $joinClause = " INNER JOIN `{$this->loggingDB}`.{$detail['joins']['table']} fk_table ON {$detail['joins']['join']} INNER JOIN civicrm_contact modified_contact_civireport ON (fk_table.{$detail['fk']} = modified_contact_civireport.id {$clause})"; } if (!empty($detail['extra_joins'])) { $joinClause .= " INNER JOIN `{$this->loggingDB}`.{$detail['extra_joins']['table']} extra_table ON {$detail['extra_joins']['join']}"; } $this->_from = " FROM `{$this->loggingDB}`.$tableName entity_log_civireport {$joinClause} LEFT JOIN civicrm_contact altered_by_contact_civireport ON (entity_log_civireport.log_user_id = altered_by_contact_civireport.id)"; } /** * Add links & hovers to the detailed report. * * @param $baseQueryCriteria * @param $row * * @return mixed */ protected function addDetailReportLinksToRow($baseQueryCriteria, $row) { $q = $baseQueryCriteria; $q .= (!empty($row['log_civicrm_entity_altered_contact'])) ? '&alteredName=' . $row['log_civicrm_entity_altered_contact'] : ''; $q .= (!empty($row['log_civicrm_entity_altered_contact_id'])) ? '&cid=' . $row['log_civicrm_entity_altered_contact_id'] : ''; $q .= (!empty($row['altered_by_contact_display_name'])) ? '&alteredBy=' . $row['altered_by_contact_display_name'] : ''; $q .= (!empty($row['log_civicrm_entity_log_user_id'])) ? '&alteredById=' . $row['log_civicrm_entity_log_user_id'] : ''; $url1 = CRM_Report_Utils_Report::getNextUrl('logging/contact/detail', "{$q}&snippet=4§ion=2&layout=overlay", FALSE, TRUE); $url2 = CRM_Report_Utils_Report::getNextUrl('logging/contact/detail', "{$q}§ion=2", FALSE, TRUE); $hoverTitle = ts('View details for this update'); $row['log_civicrm_entity_log_action'] = " " . $row['log_civicrm_entity_log_action'] . ''; return $row; } /** * Calculate section totals. * * Override to do nothing as this does not work / make sense on this report. */ public function sectionTotals() {} }