4 * Class CRM_Dedupe_DedupeMergerTest
7 class CRM_Dedupe_MergerTest
extends CiviUnitTestCase
{
10 protected $_contactIds = array();
12 public function tearDown() {
13 $this->quickCleanup(array('civicrm_contact', 'civicrm_group_contact', 'civicrm_group'));
17 public function createDupeContacts() {
18 // create a group to hold contacts, so that dupe checks don't consider any other contacts in the DB
20 'name' => 'Test Dupe Merger Group',
21 'title' => 'Test Dupe Merger Group',
24 'visibility' => 'Public Pages',
27 $result = $this->callAPISuccess('group', 'create', $params);
28 $this->_groupId
= $result['id'];
32 // make dupe checks based on based on following contact sets:
33 // FIRST - LAST - EMAIL
34 // ---------------------------------
35 // robin - hood - robin@example.com
36 // robin - hood - robin@example.com
37 // robin - hood - hood@example.com
38 // robin - dale - robin@example.com
39 // little - dale - dale@example.com
40 // little - dale - dale@example.com
41 // will - dale - dale@example.com
42 // will - dale - will@example.com
43 // will - dale - will@example.com
46 'first_name' => 'robin',
47 'last_name' => 'hood',
48 'email' => 'robin@example.com',
49 'contact_type' => 'Individual',
52 'first_name' => 'robin',
53 'last_name' => 'hood',
54 'email' => 'robin@example.com',
55 'contact_type' => 'Individual',
58 'first_name' => 'robin',
59 'last_name' => 'hood',
60 'email' => 'hood@example.com',
61 'contact_type' => 'Individual',
64 'first_name' => 'robin',
65 'last_name' => 'dale',
66 'email' => 'robin@example.com',
67 'contact_type' => 'Individual',
70 'first_name' => 'little',
71 'last_name' => 'dale',
72 'email' => 'dale@example.com',
73 'contact_type' => 'Individual',
76 'first_name' => 'little',
77 'last_name' => 'dale',
78 'email' => 'dale@example.com',
79 'contact_type' => 'Individual',
82 'first_name' => 'will',
83 'last_name' => 'dale',
84 'email' => 'dale@example.com',
85 'contact_type' => 'Individual',
88 'first_name' => 'will',
89 'last_name' => 'dale',
90 'email' => 'will@example.com',
91 'contact_type' => 'Individual',
94 'first_name' => 'will',
95 'last_name' => 'dale',
96 'email' => 'will@example.com',
97 'contact_type' => 'Individual',
102 foreach ($params as $param) {
103 $param['version'] = 3;
104 $contact = civicrm_api('contact', 'create', $param);
105 $this->_contactIds
[$count++
] = $contact['id'];
108 'contact_id' => $contact['id'],
109 'group_id' => $this->_groupId
,
112 $this->callAPISuccess('group_contact', 'create', $grpParams);
117 * Delete all created contacts.
119 public function deleteDupeContacts() {
120 foreach ($this->_contactIds
as $contactId) {
121 $this->contactDelete($contactId);
123 $this->groupDelete($this->_groupId
);
127 * Test the batch merge.
129 public function testBatchMergeSelectedDuplicates() {
130 $this->createDupeContacts();
132 // verify that all contacts have been created separately
133 $this->assertEquals(count($this->_contactIds
), 9, 'Check for number of contacts.');
135 $dao = new CRM_Dedupe_DAO_RuleGroup();
136 $dao->contact_type
= 'Individual';
137 $dao->name
= 'IndividualSupervised';
138 $dao->is_default
= 1;
141 $foundDupes = CRM_Dedupe_Finder
::dupesInGroup($dao->id
, $this->_groupId
);
143 // -------------------------------------------------------------------------
144 // Name and Email (reserved) Matches ( 3 pairs )
145 // --------------------------------------------------------------------------
146 // robin - hood - robin@example.com
147 // robin - hood - robin@example.com
148 // little - dale - dale@example.com
149 // little - dale - dale@example.com
150 // will - dale - will@example.com
151 // will - dale - will@example.com
152 // so 3 pairs for - first + last + mail
153 $this->assertEquals(count($foundDupes), 3, 'Check Individual-Supervised dupe rule for dupesInGroup().');
155 // Run dedupe finder as the browser would
156 $_SERVER['REQUEST_METHOD'] = 'GET'; //avoid invalid key error
157 $object = new CRM_Contact_Page_DedupeFind();
158 $object->set('gid', $this->_groupId
);
159 $object->set('rgid', $dao->id
);
160 $object->set('action', CRM_Core_Action
::UPDATE
);
161 $object->setEmbedded(TRUE);
164 // Retrieve pairs from prev next cache table
165 $select = array('pn.is_selected' => 'is_selected');
166 $cacheKeyString = "merge Individual_{$dao->id}_{$this->_groupId}_0";
167 $pnDupePairs = CRM_Core_BAO_PrevNextCache
::retrieve($cacheKeyString, NULL, NULL, 0, 0, $select);
169 $this->assertEquals(count($foundDupes), count($pnDupePairs), 'Check number of dupe pairs in prev next cache.');
171 // mark first two pairs as selected
172 CRM_Core_DAO
::singleValueQuery("UPDATE civicrm_prevnext_cache SET is_selected = 1 WHERE id IN ({$pnDupePairs[0]['prevnext_id']}, {$pnDupePairs[1]['prevnext_id']})");
174 $pnDupePairs = CRM_Core_BAO_PrevNextCache
::retrieve($cacheKeyString, NULL, NULL, 0, 0, $select);
175 $this->assertEquals($pnDupePairs[0]['is_selected'], 1, 'Check if first record in dupe pairs is marked as selected.');
176 $this->assertEquals($pnDupePairs[0]['is_selected'], 1, 'Check if second record in dupe pairs is marked as selected.');
178 // batch merge selected dupes
179 $result = CRM_Dedupe_Merger
::batchMerge($dao->id
, $this->_groupId
, 'safe', TRUE, 5, 1);
180 $this->assertEquals(count($result['merged']), 2, 'Check number of merged pairs.');
182 // retrieve pairs from prev next cache table
183 $pnDupePairs = CRM_Core_BAO_PrevNextCache
::retrieve($cacheKeyString, NULL, NULL, 0, 0, $select);
184 $this->assertEquals(count($pnDupePairs), 1, 'Check number of remaining dupe pairs in prev next cache.');
186 $this->deleteDupeContacts();
190 * Test the batch merge.
192 public function testBatchMergeAllDuplicates() {
193 $this->createDupeContacts();
195 // verify that all contacts have been created separately
196 $this->assertEquals(count($this->_contactIds
), 9, 'Check for number of contacts.');
198 $dao = new CRM_Dedupe_DAO_RuleGroup();
199 $dao->contact_type
= 'Individual';
200 $dao->name
= 'IndividualSupervised';
201 $dao->is_default
= 1;
204 $foundDupes = CRM_Dedupe_Finder
::dupesInGroup($dao->id
, $this->_groupId
);
206 // -------------------------------------------------------------------------
207 // Name and Email (reserved) Matches ( 3 pairs )
208 // --------------------------------------------------------------------------
209 // robin - hood - robin@example.com
210 // robin - hood - robin@example.com
211 // little - dale - dale@example.com
212 // little - dale - dale@example.com
213 // will - dale - will@example.com
214 // will - dale - will@example.com
215 // so 3 pairs for - first + last + mail
216 $this->assertEquals(count($foundDupes), 3, 'Check Individual-Supervised dupe rule for dupesInGroup().');
218 // Run dedupe finder as the browser would
219 $_SERVER['REQUEST_METHOD'] = 'GET'; //avoid invalid key error
220 $object = new CRM_Contact_Page_DedupeFind();
221 $object->set('gid', $this->_groupId
);
222 $object->set('rgid', $dao->id
);
223 $object->set('action', CRM_Core_Action
::UPDATE
);
224 $object->setEmbedded(TRUE);
227 // Retrieve pairs from prev next cache table
228 $select = array('pn.is_selected' => 'is_selected');
229 $cacheKeyString = "merge Individual_{$dao->id}_{$this->_groupId}_0";
230 $pnDupePairs = CRM_Core_BAO_PrevNextCache
::retrieve($cacheKeyString, NULL, NULL, 0, 0, $select);
232 $this->assertEquals(count($foundDupes), count($pnDupePairs), 'Check number of dupe pairs in prev next cache.');
234 // batch merge all dupes
235 $result = CRM_Dedupe_Merger
::batchMerge($dao->id
, $this->_groupId
, 'safe', TRUE, 5, 2);
236 $this->assertEquals(count($result['merged']), 3, 'Check number of merged pairs.');
238 // retrieve pairs from prev next cache table
239 $pnDupePairs = CRM_Core_BAO_PrevNextCache
::retrieve($cacheKeyString, NULL, NULL, 0, 0, $select);
240 $this->assertEquals(count($pnDupePairs), 0, 'Check number of remaining dupe pairs in prev next cache.');
242 $this->deleteDupeContacts();
246 * The goal of this function is to test that all required tables are returned.
248 public function testGetCidRefs() {
249 $this->entityCustomGroupWithSingleFieldCreate(__FUNCTION__
, 'Contacts');
250 $this->assertEquals(array_merge($this->getStaticCIDRefs(), $this->getHackedInCIDRef()), CRM_Dedupe_Merger
::cidRefs());
251 $this->assertEquals(array_merge($this->getCalculatedCIDRefs(), $this->getHackedInCIDRef()), CRM_Dedupe_Merger
::cidRefs());
255 * Get the list of not-really-cid-refs that are currently hacked in.
257 * This is hacked into getCIDs function.
261 public function getHackedInCIDRef() {
263 'civicrm_entity_tag' => array(
270 * Test function that gets duplicate pairs.
272 * It turns out there are 2 code paths retrieving this data so my initial focus is on ensuring
275 public function testGetMatches() {
276 $this->setupMatchData();
277 $pairs = CRM_Dedupe_Merger
::getDuplicatePairs(
285 $this->assertEquals(array(
287 'srcID' => $this->contacts
[0]['id'],
288 'srcName' => 'Mr. Mickey Mouse II',
289 'dstID' => $this->contacts
[1]['id'],
290 'dstName' => 'Mr. Mickey Mouse II',
295 'srcID' => $this->contacts
[2]['id'],
296 'srcName' => 'Mr. Minnie Mouse II',
297 'dstID' => $this->contacts
[3]['id'],
298 'dstName' => 'Mr. Minnie Mouse II',
306 * Test function that gets duplicate pairs.
308 * It turns out there are 2 code paths retrieving this data so my initial focus is on ensuring
311 public function testGetMatchesInGroup() {
312 $this->setupMatchData();
314 $groupID = $this->groupCreate(array('title' => 'she-mice'));
316 $this->callAPISuccess('GroupContact', 'create', array('group_id' => $groupID, 'contact_id' => $this->contacts
[3]['id']));
318 $pairs = CRM_Dedupe_Merger
::getDuplicatePairs(
326 $this->assertEquals(array(
328 'srcID' => $this->contacts
[3]['id'],
329 'srcName' => 'Mr. Minnie Mouse II',
330 'dstID' => $this->contacts
[2]['id'],
331 'dstName' => 'Mr. Minnie Mouse II',
339 * Set up some contacts for our matching.
341 public function setupMatchData() {
344 'first_name' => 'Mickey',
345 'last_name' => 'Mouse',
346 'email' => 'mickey@mouse.com',
349 'first_name' => 'Mickey',
350 'last_name' => 'Mouse',
351 'email' => 'mickey@mouse.com',
354 'first_name' => 'Minnie',
355 'last_name' => 'Mouse',
356 'email' => 'mickey@mouse.com',
359 'first_name' => 'Minnie',
360 'last_name' => 'Mouse',
361 'email' => 'mickey@mouse.com',
364 foreach ($fixtures as $fixture) {
365 $contactID = $this->individualCreate($fixture);
366 $this->contacts
[] = array_merge($fixture, array('id' => $contactID));
372 * Get the list of tables that refer to the CID.
374 * This is a statically maintained (in this test list).
376 * There is also a check against an automated list but having both seems to add extra stability to me. They do
379 public function getStaticCIDRefs() {
381 'civicrm_acl_cache' => array(
384 'civicrm_acl_contact_cache' => array(
388 'civicrm_action_log' => array(
391 'civicrm_activity_contact' => array(
394 'civicrm_address' => array(
397 'civicrm_batch' => array(
401 'civicrm_campaign' => array(
403 1 => 'last_modified_id',
405 'civicrm_case_contact' => array(
408 'civicrm_contact' => array(
409 0 => 'primary_contact_id',
412 'civicrm_contribution' => array(
415 'civicrm_contribution_page' => array(
418 'civicrm_contribution_recur' => array(
421 'civicrm_contribution_soft' => array(
424 'civicrm_custom_group' => array(
427 'civicrm_dashboard_contact' => array(
430 'civicrm_dedupe_exception' => array(
434 'civicrm_domain' => array(
437 'civicrm_email' => array(
440 'civicrm_event' => array(
443 'civicrm_event_carts' => array(
446 'civicrm_financial_account' => array(
449 'civicrm_financial_item' => array(
452 'civicrm_grant' => array(
455 'civicrm_group' => array(
459 'civicrm_group_contact' => array(
462 'civicrm_group_contact_cache' => array(
465 'civicrm_group_organization' => array(
466 0 => 'organization_id',
468 'civicrm_im' => array(
471 'civicrm_log' => array(
474 'civicrm_mailing' => array(
479 'civicrm_mailing_abtest' => array(
482 'civicrm_mailing_event_queue' => array(
485 'civicrm_mailing_event_subscribe' => array(
488 'civicrm_mailing_recipients' => array(
491 'civicrm_membership' => array(
494 'civicrm_membership_log' => array(
497 'civicrm_membership_type' => array(
498 0 => 'member_of_contact_id',
500 'civicrm_note' => array(
503 'civicrm_openid' => array(
506 'civicrm_participant' => array(
508 1 => 'transferred_to_contact_id', //CRM-16761
510 'civicrm_payment_token' => array(
514 'civicrm_pcp' => array(
517 'civicrm_phone' => array(
520 'civicrm_pledge' => array(
523 'civicrm_print_label' => array(
526 'civicrm_relationship' => array(
530 'civicrm_report_instance' => array(
534 'civicrm_setting' => array(
538 'civicrm_subscription_history' => array(
541 'civicrm_survey' => array(
543 1 => 'last_modified_id',
545 'civicrm_tag' => array(
548 'civicrm_uf_group' => array(
551 'civicrm_uf_match' => array(
554 'civicrm_value_testgetcidref_1' => array(
557 'civicrm_website' => array(
564 * Get a list of CIDs that is calculated off the schema.
566 * Note this is an expensive and table locking query. Should be safe in tests though.
568 public function getCalculatedCIDRefs() {
574 FROM information_schema.key_column_usage
576 referenced_table_schema = database() AND
577 referenced_table_name = 'civicrm_contact' AND
578 referenced_column_name = 'id';
580 $dao = CRM_Core_DAO
::executeQuery($sql);
581 while ($dao->fetch()) {
582 $cidRefs[$dao->table_name
][] = $dao->column_name
;
584 // Do specific re-ordering changes to make this the same as the ref validated one.
585 // The above query orders by FK alphabetically.
586 // There might be cleverer ways to do this but it shouldn't change much.
587 $cidRefs['civicrm_contact'][0] = 'primary_contact_id';
588 $cidRefs['civicrm_contact'][1] = 'employer_id';
589 $cidRefs['civicrm_acl_contact_cache'][0] = 'user_id';
590 $cidRefs['civicrm_acl_contact_cache'][1] = 'contact_id';
591 $cidRefs['civicrm_mailing'][0] = 'created_id';
592 $cidRefs['civicrm_mailing'][1] = 'scheduled_id';
593 $cidRefs['civicrm_mailing'][2] = 'approver_id';