# -*- coding: utf-8 -*- # Part of Odoo. See LICENSE file for full copyright and licensing details. from ast import literal_eval from collections import defaultdict import functools import itertools import logging import psycopg2 import datetime from odoo import api, fields, models, Command from odoo import SUPERUSER_ID, _ from odoo.exceptions import ValidationError, UserError from odoo.tools import mute_logger _logger = logging.getLogger('odoo.addons.base.partner.merge') class MergePartnerLine(models.TransientModel): _name = 'base.partner.merge.line' _description = 'Merge Partner Line' _order = 'min_id asc' wizard_id = fields.Many2one('base.partner.merge.automatic.wizard', 'Wizard') min_id = fields.Integer('MinID') aggr_ids = fields.Char('Ids', required=True) class MergePartnerAutomatic(models.TransientModel): """ The idea behind this wizard is to create a list of potential partners to merge. We use two objects, the first one is the wizard for the end-user. And the second will contain the partner list to merge. """ _name = 'base.partner.merge.automatic.wizard' _description = 'Merge Partner Wizard' @api.model def default_get(self, fields): res = super(MergePartnerAutomatic, self).default_get(fields) active_ids = self.env.context.get('active_ids') if self.env.context.get('active_model') == 'res.partner' and active_ids: if 'state' in fields: res['state'] = 'selection' if 'partner_ids' in fields: res['partner_ids'] = [Command.set(active_ids)] if 'dst_partner_id' in fields: res['dst_partner_id'] = self._get_ordered_partner(active_ids)[-1].id return res # Group by group_by_email = fields.Boolean('Email') group_by_name = fields.Boolean('Name') group_by_is_company = fields.Boolean('Is Company') group_by_vat = fields.Boolean('VAT') group_by_parent_id = fields.Boolean('Parent Company') state = fields.Selection([ ('option', 'Option'), ('selection', 'Selection'), ('finished', 'Finished') ], readonly=True, required=True, string='State', default='option') number_group = fields.Integer('Group of Contacts', readonly=True) current_line_id = fields.Many2one('base.partner.merge.line', string='Current Line') line_ids = fields.One2many('base.partner.merge.line', 'wizard_id', string='Lines') partner_ids = fields.Many2many('res.partner', string='Contacts', context={'active_test': False}) dst_partner_id = fields.Many2one('res.partner', string='Destination Contact') exclude_contact = fields.Boolean('A user associated to the contact') exclude_journal_item = fields.Boolean('Journal Items associated to the contact') maximum_group = fields.Integer('Maximum of Group of Contacts') # ---------------------------------------- # Update method. Core methods to merge steps # ---------------------------------------- def _get_fk_on(self, table): """ return a list of many2one relation with the given table. :param table : the name of the sql table to return relations :returns a list of tuple 'table name', 'column name'. """ query = """ SELECT cl1.relname as table, att1.attname as column FROM pg_constraint as con, pg_class as cl1, pg_class as cl2, pg_attribute as att1, pg_attribute as att2 WHERE con.conrelid = cl1.oid AND con.confrelid = cl2.oid AND array_lower(con.conkey, 1) = 1 AND con.conkey[1] = att1.attnum AND att1.attrelid = cl1.oid AND cl2.relname = %s AND att2.attname = 'id' AND array_lower(con.confkey, 1) = 1 AND con.confkey[1] = att2.attnum AND att2.attrelid = cl2.oid AND con.contype = 'f' """ self._cr.execute(query, (table,)) return self._cr.fetchall() @api.model def _update_foreign_keys(self, src_partners, dst_partner): """ Update all foreign key from the src_partner to dst_partner. All many2one fields will be updated. :param src_partners : merge source res.partner recordset (does not include destination one) :param dst_partner : record of destination res.partner """ _logger.debug('_update_foreign_keys for dst_partner: %s for src_partners: %s', dst_partner.id, str(src_partners.ids)) # find the many2one relation to a partner Partner = self.env['res.partner'] relations = self._get_fk_on('res_partner') # this guarantees cache consistency self.env.invalidate_all() for table, column in relations: if 'base_partner_merge_' in table: # ignore two tables continue # get list of columns of current table (exept the current fk column) query = "SELECT column_name FROM information_schema.columns WHERE table_name LIKE '%s'" % (table) self._cr.execute(query, ()) columns = [] for data in self._cr.fetchall(): if data[0] != column: columns.append(data[0]) # do the update for the current table/column in SQL query_dic = { 'table': table, 'column': column, 'value': columns[0], } if len(columns) <= 1: # unique key treated query = """ UPDATE "%(table)s" as ___tu SET "%(column)s" = %%s WHERE "%(column)s" = %%s AND NOT EXISTS ( SELECT 1 FROM "%(table)s" as ___tw WHERE "%(column)s" = %%s AND ___tu.%(value)s = ___tw.%(value)s )""" % query_dic for partner in src_partners: self._cr.execute(query, (dst_partner.id, partner.id, dst_partner.id)) else: try: with mute_logger('odoo.sql_db'), self._cr.savepoint(): query = 'UPDATE "%(table)s" SET "%(column)s" = %%s WHERE "%(column)s" IN %%s' % query_dic self._cr.execute(query, (dst_partner.id, tuple(src_partners.ids),)) except psycopg2.Error: # updating fails, most likely due to a violated unique constraint # keeping record with nonexistent partner_id is useless, better delete it query = 'DELETE FROM "%(table)s" WHERE "%(column)s" IN %%s' % query_dic self._cr.execute(query, (tuple(src_partners.ids),)) @api.model def _update_reference_fields(self, src_partners, dst_partner): """ Update all reference fields from the src_partner to dst_partner. :param src_partners : merge source res.partner recordset (does not include destination one) :param dst_partner : record of destination res.partner """ _logger.debug('_update_reference_fields for dst_partner: %s for src_partners: %r', dst_partner.id, src_partners.ids) def update_records(model, src, field_model='model', field_id='res_id'): Model = self.env[model] if model in self.env else None if Model is None: return records = Model.sudo().search([(field_model, '=', 'res.partner'), (field_id, '=', src.id)]) try: with mute_logger('odoo.sql_db'), self._cr.savepoint(): records.sudo().write({field_id: dst_partner.id}) records.env.flush_all() except psycopg2.Error: # updating fails, most likely due to a violated unique constraint # keeping record with nonexistent partner_id is useless, better delete it records.sudo().unlink() update_records = functools.partial(update_records) for partner in src_partners: update_records('calendar', src=partner, field_model='model_id.model') update_records('ir.attachment', src=partner, field_model='res_model') update_records('mail.followers', src=partner, field_model='res_model') update_records('mail.activity', src=partner, field_model='res_model') update_records('mail.message', src=partner) update_records('ir.model.data', src=partner) records = self.env['ir.model.fields'].sudo().search([('ttype', '=', 'reference')]) for record in records: try: Model = self.env[record.model] field = Model._fields[record.name] except KeyError: # unknown model or field => skip continue if Model._abstract or field.compute is not None: continue for partner in src_partners: records_ref = Model.sudo().search([(record.name, '=', 'res.partner,%d' % partner.id)]) values = { record.name: 'res.partner,%d' % dst_partner.id, } records_ref.sudo().write(values) self.env.flush_all() # Company-dependent fields with self._cr.savepoint(): params = { 'destination_id': f'res.partner,{dst_partner.id}', 'source_ids': tuple(f'res.partner,{src}' for src in src_partners.ids), } self._cr.execute(""" UPDATE ir_property AS _ip1 SET res_id = %(destination_id)s WHERE res_id IN %(source_ids)s AND NOT EXISTS ( SELECT FROM ir_property AS _ip2 WHERE _ip2.res_id = %(destination_id)s AND _ip2.fields_id = _ip1.fields_id AND _ip2.company_id = _ip1.company_id )""", params) def _get_summable_fields(self): """ Returns the list of fields that should be summed when merging partners """ return [] @api.model def _update_values(self, src_partners, dst_partner): """ Update values of dst_partner with the ones from the src_partners. :param src_partners : recordset of source res.partner :param dst_partner : record of destination res.partner """ _logger.debug('_update_values for dst_partner: %s for src_partners: %r', dst_partner.id, src_partners.ids) model_fields = dst_partner.fields_get().keys() summable_fields = self._get_summable_fields() def write_serializer(item): if isinstance(item, models.BaseModel): return item.id else: return item # get all fields that are not computed or x2many values = dict() values_by_company = defaultdict(dict) # {company: vals} for column in model_fields: field = dst_partner._fields[column] if field.type not in ('many2many', 'one2many') and field.compute is None: for item in itertools.chain(src_partners, [dst_partner]): if item[column]: if column in summable_fields and values.get(column): values[column] += write_serializer(item[column]) else: values[column] = write_serializer(item[column]) elif field.company_dependent and column in summable_fields: # sum the values of partners for each company; use sudo() to # compute the sum on all companies, including forbidden ones partners = (src_partners + dst_partner).sudo() for company in self.env['res.company'].sudo().search([]): values_by_company[company][column] = sum( partners.with_company(company).mapped(column) ) # remove fields that can not be updated (id and parent_id) values.pop('id', None) parent_id = values.pop('parent_id', None) dst_partner.write(values) for company, vals in values_by_company.items(): dst_partner.with_company(company).sudo().write(vals) # try to update the parent_id if parent_id and parent_id != dst_partner.id: try: dst_partner.write({'parent_id': parent_id}) except ValidationError: _logger.info('Skip recursive partner hierarchies for parent_id %s of partner: %s', parent_id, dst_partner.id) def _merge(self, partner_ids, dst_partner=None, extra_checks=True): """ private implementation of merge partner :param partner_ids : ids of partner to merge :param dst_partner : record of destination res.partner :param extra_checks: pass False to bypass extra sanity check (e.g. email address) """ # super-admin can be used to bypass extra checks if self.env.is_admin(): extra_checks = False Partner = self.env['res.partner'] partner_ids = Partner.browse(partner_ids).exists() if len(partner_ids) < 2: return if len(partner_ids) > 3: raise UserError(_("For safety reasons, you cannot merge more than 3 contacts together. You can re-open the wizard several times if needed.")) # check if the list of partners to merge contains child/parent relation child_ids = self.env['res.partner'] for partner_id in partner_ids: child_ids |= Partner.search([('id', 'child_of', [partner_id.id])]) - partner_id if partner_ids & child_ids: raise UserError(_("You cannot merge a contact with one of his parent.")) # check if the list of partners to merge are linked to more than one user if len(partner_ids.with_context(active_test=False).user_ids) > 1: raise UserError(_("You cannot merge contacts linked to more than one user even if only one is active.")) if extra_checks and len(set(partner.email for partner in partner_ids)) > 1: raise UserError(_("All contacts must have the same email. Only the Administrator can merge contacts with different emails.")) # remove dst_partner from partners to merge if dst_partner and dst_partner in partner_ids: src_partners = partner_ids - dst_partner else: ordered_partners = self._get_ordered_partner(partner_ids.ids) dst_partner = ordered_partners[-1] src_partners = ordered_partners[:-1] _logger.info("dst_partner: %s", dst_partner.id) # Make the company of all related users consistent with destination partner company if dst_partner.company_id: partner_ids.mapped('user_ids').sudo().write({ 'company_ids': [Command.link(dst_partner.company_id.id)], 'company_id': dst_partner.company_id.id }) # call sub methods to do the merge self._update_foreign_keys(src_partners, dst_partner) self._update_reference_fields(src_partners, dst_partner) self._update_values(src_partners, dst_partner) self._log_merge_operation(src_partners, dst_partner) # delete source partner, since they are merged src_partners.unlink() def _log_merge_operation(self, src_partners, dst_partner): _logger.info('(uid = %s) merged the partners %r with %s', self._uid, src_partners.ids, dst_partner.id) # ---------------------------------------- # Helpers # ---------------------------------------- @api.model def _generate_query(self, fields, maximum_group=100): """ Build the SQL query on res.partner table to group them according to given criteria :param fields : list of column names to group by the partners :param maximum_group : limit of the query """ # make the list of column to group by in sql query sql_fields = [] for field in fields: if field in ['email', 'name']: sql_fields.append('lower(%s)' % field) elif field in ['vat']: sql_fields.append("replace(%s, ' ', '')" % field) else: sql_fields.append(field) group_fields = ', '.join(sql_fields) # where clause : for given group by columns, only keep the 'not null' record filters = [] for field in fields: if field in ['email', 'name', 'vat']: filters.append((field, 'IS NOT', 'NULL')) criteria = ' AND '.join('%s %s %s' % (field, operator, value) for field, operator, value in filters) # build the query text = [ "SELECT min(id), array_agg(id)", "FROM res_partner", ] if criteria: text.append('WHERE %s' % criteria) text.extend([ "GROUP BY %s" % group_fields, "HAVING COUNT(*) >= 2", "ORDER BY min(id)", ]) if maximum_group: text.append("LIMIT %s" % maximum_group,) return ' '.join(text) @api.model def _compute_selected_groupby(self): """ Returns the list of field names the partner can be grouped (as merge criteria) according to the option checked on the wizard """ groups = [] group_by_prefix = 'group_by_' for field_name in self._fields: if field_name.startswith(group_by_prefix): if field_name in self and self[field_name]: groups.append(field_name[len(group_by_prefix):]) if not groups: raise UserError(_("You have to specify a filter for your selection.")) return groups @api.model def _partner_use_in(self, aggr_ids, models): """ Check if there is no occurence of this group of partner in the selected model :param aggr_ids : stringified list of partner ids separated with a comma (sql array_agg) :param models : dict mapping a model name with its foreign key with res_partner table """ return any( self.env[model].search_count([(field, 'in', aggr_ids)]) for model, field in models.items() ) @api.model def _get_ordered_partner(self, partner_ids): """ Helper : returns a `res.partner` recordset ordered by create_date/active fields :param partner_ids : list of partner ids to sort """ return self.env['res.partner'].browse(partner_ids).sorted( key=lambda p: (not p.active, (p.create_date or datetime.datetime(1970, 1, 1))), reverse=True, ) def _compute_models(self): """ Compute the different models needed by the system if you want to exclude some partners. """ model_mapping = {} if self.exclude_contact: model_mapping['res.users'] = 'partner_id' if 'account.move.line' in self.env and self.exclude_journal_item: model_mapping['account.move.line'] = 'partner_id' return model_mapping # ---------------------------------------- # Actions # ---------------------------------------- def action_skip(self): """ Skip this wizard line. Don't compute any thing, and simply redirect to the new step.""" if self.current_line_id: self.current_line_id.unlink() return self._action_next_screen() def _action_next_screen(self): """ return the action of the next screen ; this means the wizard is set to treat the next wizard line. Each line is a subset of partner that can be merged together. If no line left, the end screen will be displayed (but an action is still returned). """ self.env.invalidate_all() # FIXME: is this still necessary? values = {} if self.line_ids: # in this case, we try to find the next record. current_line = self.line_ids[0] current_partner_ids = literal_eval(current_line.aggr_ids) values.update({ 'current_line_id': current_line.id, 'partner_ids': [Command.set(current_partner_ids)], 'dst_partner_id': self._get_ordered_partner(current_partner_ids)[-1].id, 'state': 'selection', }) else: values.update({ 'current_line_id': False, 'partner_ids': [], 'state': 'finished', }) self.write(values) return { 'type': 'ir.actions.act_window', 'res_model': self._name, 'res_id': self.id, 'view_mode': 'form', 'target': 'new', } def _process_query(self, query): """ Execute the select request and write the result in this wizard :param query : the SQL query used to fill the wizard line """ self.ensure_one() model_mapping = self._compute_models() # group partner query self._cr.execute(query) # pylint: disable=sql-injection counter = 0 for min_id, aggr_ids in self._cr.fetchall(): # To ensure that the used partners are accessible by the user partners = self.env['res.partner'].search([('id', 'in', aggr_ids)]) if len(partners) < 2: continue # exclude partner according to options if model_mapping and self._partner_use_in(partners.ids, model_mapping): continue self.env['base.partner.merge.line'].create({ 'wizard_id': self.id, 'min_id': min_id, 'aggr_ids': partners.ids, }) counter += 1 self.write({ 'state': 'selection', 'number_group': counter, }) _logger.info("counter: %s", counter) def action_start_manual_process(self): """ Start the process 'Merge with Manual Check'. Fill the wizard according to the group_by and exclude options, and redirect to the first step (treatment of first wizard line). After, for each subset of partner to merge, the wizard will be actualized. - Compute the selected groups (with duplication) - If the user has selected the 'exclude_xxx' fields, avoid the partners """ self.ensure_one() groups = self._compute_selected_groupby() query = self._generate_query(groups, self.maximum_group) self._process_query(query) return self._action_next_screen() def action_start_automatic_process(self): """ Start the process 'Merge Automatically'. This will fill the wizard with the same mechanism as 'Merge with Manual Check', but instead of refreshing wizard with the current line, it will automatically process all lines by merging partner grouped according to the checked options. """ self.ensure_one() self.action_start_manual_process() # here we don't redirect to the next screen, since it is automatic process self.env.invalidate_all() # FIXME: is this still necessary? for line in self.line_ids: partner_ids = literal_eval(line.aggr_ids) self._merge(partner_ids) line.unlink() self._cr.commit() # TODO JEM : explain why self.write({'state': 'finished'}) return { 'type': 'ir.actions.act_window', 'res_model': self._name, 'res_id': self.id, 'view_mode': 'form', 'target': 'new', } def parent_migration_process_cb(self): self.ensure_one() query = """ SELECT min(p1.id), array_agg(DISTINCT p1.id) FROM res_partner as p1 INNER join res_partner as p2 ON p1.email = p2.email AND p1.name = p2.name AND (p1.parent_id = p2.id OR p1.id = p2.parent_id) WHERE p2.id IS NOT NULL GROUP BY p1.email, p1.name, CASE WHEN p1.parent_id = p2.id THEN p2.id ELSE p1.id END HAVING COUNT(*) >= 2 ORDER BY min(p1.id) """ self._process_query(query) for line in self.line_ids: partner_ids = literal_eval(line.aggr_ids) self._merge(partner_ids) line.unlink() self._cr.commit() self.write({'state': 'finished'}) self._cr.execute(""" UPDATE res_partner SET is_company = NULL, parent_id = NULL WHERE parent_id = id """) return { 'type': 'ir.actions.act_window', 'res_model': self._name, 'res_id': self.id, 'view_mode': 'form', 'target': 'new', } def action_update_all_process(self): self.ensure_one() self.parent_migration_process_cb() # NOTE JEM : seems louche to create a new wizard instead of reuse the current one with updated options. # since it is like this from the initial commit of this wizard, I don't change it. yet ... wizard = self.create({'group_by_vat': True, 'group_by_email': True, 'group_by_name': True}) wizard.action_start_automatic_process() # NOTE JEM : no idea if this query is usefull self._cr.execute(""" UPDATE res_partner SET is_company = NULL WHERE parent_id IS NOT NULL AND is_company IS NOT NULL """) return self._action_next_screen() def action_merge(self): """ Merge Contact button. Merge the selected partners, and redirect to the end screen (since there is no other wizard line to process. """ if not self.partner_ids: self.write({'state': 'finished'}) return { 'type': 'ir.actions.act_window', 'res_model': self._name, 'res_id': self.id, 'view_mode': 'form', 'target': 'new', } self._merge(self.partner_ids.ids, self.dst_partner_id) if self.current_line_id: self.current_line_id.unlink() return self._action_next_screen()