Smart VTiger Duplicate Merging module is to monitor, find and merge multiple instances of duplicate...

14
SMART VTIGER DUPLICATE MERGING MODULE Version 1.2.0 Platform: VTiger 6 Smart Vtiger duplicate merge module is used to monitor and merge multiple instance. This document consist of description, feature, installation procedure and change log of our plugin.

Transcript of Smart VTiger Duplicate Merging module is to monitor, find and merge multiple instances of duplicate...

Page 1: Smart VTiger Duplicate Merging module is to monitor, find and merge multiple instances of duplicate records automatically via cron

[Product Name]

[Version X.X]

[Platform and Minimum Version Details]

I

Page 1

SMART VTIGER DUPLICATE MERGING MODULE

Version 1.2.0

Platform: VTiger 6

Smart Vtiger duplicate merge module is used to monitor and merge multiple instance. This document consist of description, feature, installation procedure and change log of our plugin.

Page 2: Smart VTiger Duplicate Merging module is to monitor, find and merge multiple instances of duplicate records automatically via cron

Description

Smart VTiger Duplicate Merge module is to monitor, find and merge multiple instances of duplicate records automatically via cron at regular interval of time based on the input fields and mapping saved by the user. This module will clean up your existing data, keeps it clean and intact records periodically.

More Information

Smart VTiger Duplicate Merge Module is to automatically find and merge thousands of multiple record duplicates to a selected primary record in your VTiger CRM. The smart VTiger duplicate module allows you to search even thousands of VTiger duplicates record. And also smart VTiger duplicate merging save so much of time and manual works in number of simple clicks. There is no need to search and merge for each and every duplicate record; instead it will automatically merge even the missing fields of every record using a very smart rule.

1. One time easy setup saved as profile for each enabled module

2. Choose the fields to matched at smart duplicate search

3. Options to edit profiles whenever required

4. Map the fields to be merged by smart merge module

5. Option to create different profile for each module

6. Can enable required and disable unwanted modules

7. Smart log features logs each and every action that takes place with view filters

8. Runs via cron in background at regular interval e.g. once a day

9. Enable, disable and change frequency of Cron

User has to ensure that Cron is configured inorder to successfully run the Smart Duplicate Merge Module. Smart Duplicate Merge Module mostly covers all the modules in VTiger CRM. This module highly recommended for those have many duplicate records and those who use third party connectors which lead to duplicate instances.

Page 2

DescriptionPlugin Details****************

Author : SmackcodersAuthor URL : Smackcoders Siteversion : 1.2.0

Product URL

Smart VT duplicate Merger

Wiki Page Link

Smart vt duplicate merger wiki page

CHANGE LOG

1.0.0

- Initial Stable release

- Tested with vtiger 5.4.0 for compatibility

1.1.0

- Add delete conflict option

- Not using vtiger cron. User need to add new cron

- Fixed some bugs.

UPGRADE NOTICE

1.0.0 Initial release of plugin.

Page 3: Smart VTiger Duplicate Merging module is to monitor, find and merge multiple instances of duplicate records automatically via cron

Features

• Enable or disable selected modules

• Inactive modules that not needed to Smart merged

• Select input fields to match the records for duplication

• Mapping option to control hoe the fields are merged

• Include or exclude fields that to merged in Mapping

• Fields that are not mapped are unaltered or monitored

• Log is recorded for each and every action

• Filters to short out the log result

• Enable, disable, change frequency and manage the cron task

Supported VTiger CRM Modules

1. Contacts

2. Leads

3. Organization

4. Opportunities

5. Products

6. Services

7. Trouble Tickets

8. Service Contracts

9. Vendors

10. Assets

11. Projects

12. Project Milestones

13. Project Tasks

Page 3

3 | P a g e

Our Premium Products***********************

WP Ultimate CSV Importer Pro

Vtigercrm 6 Quickbooks Integration

Xero vtigercrm 6 Integration

Vtigercrm 6 Magento Bidirectional Connector

Vtiger 6 Google Calendar Sync

HR Payroll Management System

Smart Vtiger Duplicate Merging Module

Our Free Products*******************

Free WP Ultimate Email Marketer

Free Magento Smart Multi Backup

Free WP Google SEO Author Snippet

Free Sugar Themes

Free Orange HRM Themes

Free Vtiger CRM Themes

For More Products click here

SUPPORT

Mail Us: [email protected]

Page 4: Smart VTiger Duplicate Merging module is to monitor, find and merge multiple instances of duplicate records automatically via cron

Installation

Take necessary backup before proceed with installation.

1. Go to CRM Settings >> Studio >> Module Manager

2. Click Install from File to import.

Page 4

Page 5: Smart VTiger Duplicate Merging module is to monitor, find and merge multiple instances of duplicate records automatically via cron

3. Select Import.zip file and click Import button.

Page 5

Page 6: Smart VTiger Duplicate Merging module is to monitor, find and merge multiple instances of duplicate records automatically via cron

4. Click Finish.

5. Now the module is available under All >> Tools Menu.

6. Upload and extract Install.zip in your VTiger CRM Root directory.

7. Now goto All >> Tools >> Smart Duplicate Merge module.

Page 6

Page 7: Smart VTiger Duplicate Merging module is to monitor, find and merge multiple instances of duplicate records automatically via cron

8. For the first time click the Install link to complete the installation.

9. Now the module is installed successfully

Page 7

Page 8: Smart VTiger Duplicate Merging module is to monitor, find and merge multiple instances of duplicate records automatically via cron

10. You can create profile and do mapping for the required modules

There is a paid installation / configuration support. If not purchased along with product you can contact us for Installation Support.

Configure Smart Duplicate Merge Setup

• Go to All >> Tools >> Smart Duplicate Merger

• Module Home Page looks like below snap

Page 8

Page 9: Smart VTiger Duplicate Merging module is to monitor, find and merge multiple instances of duplicate records automatically via cron

Active/Inactive module

• In default all modules are enabled

• Disable the modules to be excluded by Smart Duplicate Merge

• If you want to delete conflicts while merging, enable “Delete Conflict” field.

• If you want to select “Assigned To” as match field (to delete duplicates) in contacts, leads etc, enable “Check Assigned To” field.

Step 1 : Edit Profile and input fields for duplicate search

• Click profile icon for a particular module to create input fields

• Profile options are shown in the right column

• Select the input fields and click the top double arrow button to move to the right box

• Use Ctrl and Shift for multi select

• Also you can select and remove using bottom arrow button from right box

Page 9

Page 10: Smart VTiger Duplicate Merging module is to monitor, find and merge multiple instances of duplicate records automatically via cron

• Smart duplicate search will find only based on these input search fields

• You can add, edit and alter at anytime to modify the smart search rule

• Once added click next button to map fields need to be merged

Step 2 : Field Mapping and Profile Saving

• Now you can see the field mapping options for step 2

• Select the required fields and move to the right box

• Only fields selected here are mapped by VTiger Smart Merge module

• Selected fields from duplicate instances are mapped and values are matched to a primary record by a simple smart rule

• First record is considered as primary and others are secondary records

• If any empty fields are found in selected primary record, it is replaced by the mapped field values from duplicated entries automatically

Page 10

Page 11: Smart VTiger Duplicate Merging module is to monitor, find and merge multiple instances of duplicate records automatically via cron

• You can select map all important and essential fields that are required

• Note that to many fields selected for mapping will slow down the entire process

• It depends on server performance, hosting and data size.

Step 3 : To Setup Cron

• For cron setup add the following entry in your crontab

* * * * wget -o /dev/null -q -O /dev/null http://localhost/vtigercrm-social/SmartDuplicateMergerCron.php 2>&1

• Ensure that localhost/vtigercrm is changed to your vitger crm URL

Page 11

Page 12: Smart VTiger Duplicate Merging module is to monitor, find and merge multiple instances of duplicate records automatically via cron

Important Note:

1. Ensure that VTiger Cron is configured properly to Smart Duplicate Merger and scheduler work as expected.

2. Module will consider only a record with same assigned user as duplicate

3. If two duplicates are find out, then first record acts as a primary record. Remaining records are considered as secondary. If the primary record has no values in a field and the secondary record has value in it, then secondary record value will be merged with the primary record field value. If there is no match found, then it is considered as conflict (User can find the conflicts in log) else record will be merged and deleted.

Smart Duplicate Merge Log

• Goto “Logs” menu

• This will show you the Smart Duplicate Merge logs based on match field and merge option of each modules

• Use search, custom view filters and pagination to short out the available log.

Page 12

Page 13: Smart VTiger Duplicate Merging module is to monitor, find and merge multiple instances of duplicate records automatically via cron

• After generated the logs, Goto your VTiger Modules such as contacts, products etc.

Page 13

Page 14: Smart VTiger Duplicate Merging module is to monitor, find and merge multiple instances of duplicate records automatically via cron

• It shows all records with merged content and without any conflicts.

Page 14