Files
odoo_source/addons/mail/models/mail_tracking_value.py
T
Thibault Delavallée a88381cc12 [IMP] mail: keep tracking when unlinking fields
RATIONALE

Currently when an ir.model.fields is removed all tracking linked to it is
lost. Indeed field is required and has an ondelete cascade attribute set
to it. However we should keep tracking values as those made sense when
used and one could want to have access to this information.

SPECIFICATIONS

When removing fields set the field to False instead. Add a new field to
store fields information allowing to keep name, type and groups information
to allow displaying removed tracking values. Use this field only when a
field is removed to avoid duplicating field information when not necessary
and polluting the table.

Task-3499067 (Mail: keep tracking when unlinking fields)

Part-of: odoo/odoo#124182
2023-10-06 06:13:55 +00:00

200 lines
8.9 KiB
Python

# -*- coding: utf-8 -*-
# Part of Odoo. See LICENSE file for full copyright and licensing details.
from datetime import datetime
from odoo import api, fields, models
class MailTracking(models.Model):
_name = 'mail.tracking.value'
_description = 'Mail Tracking Value'
_rec_name = 'field_id'
_order = 'id DESC'
field_id = fields.Many2one(
'ir.model.fields', required=False, readonly=True,
index=True, ondelete='set null')
field_info = fields.Json('Removed field information')
field_groups = fields.Char(compute='_compute_field_groups')
old_value_integer = fields.Integer('Old Value Integer', readonly=True)
old_value_float = fields.Float('Old Value Float', readonly=True)
old_value_char = fields.Char('Old Value Char', readonly=True)
old_value_text = fields.Text('Old Value Text', readonly=True)
old_value_datetime = fields.Datetime('Old Value DateTime', readonly=True)
new_value_integer = fields.Integer('New Value Integer', readonly=True)
new_value_float = fields.Float('New Value Float', readonly=True)
new_value_char = fields.Char('New Value Char', readonly=True)
new_value_text = fields.Text('New Value Text', readonly=True)
new_value_datetime = fields.Datetime('New Value Datetime', readonly=True)
currency_id = fields.Many2one('res.currency', 'Currency', readonly=True, ondelete='set null',
help="Used to display the currency when tracking monetary values")
mail_message_id = fields.Many2one('mail.message', 'Message ID', required=True, index=True, ondelete='cascade')
@api.depends('mail_message_id', 'field_id')
def _compute_field_groups(self):
for tracking in self:
model = self.env[tracking.mail_message_id.model]
field = model._fields.get(tracking.field_id.name)
tracking.field_groups = field.groups if field else 'base.group_system'
@api.model
def _create_tracking_values(self, initial_value, new_value, col_name, col_info, record):
""" Prepare values to create a mail.tracking.value. It prepares old and
new value according to the field type.
:param initial_value: field value before the change, could be text, int,
date, datetime, ...;
:param new_value: field value after the change, could be text, int,
date, datetime, ...;
:param str col_name: technical field name, column name (e.g. 'user_id);
:param dict col_info: result of fields_get(col_name);
:param <record> record: record on which tracking is performed, used for
related computation e.g. finding currency of monetary fields;
:return: a dict values valid for 'mail.tracking.value' creation;
"""
field = self.env['ir.model.fields']._get(record._name, col_name)
if not field:
raise ValueError(f'Unknown field {col_name} on model {record._name}')
values = {'field_id': field.id}
if col_info['type'] in {'integer', 'float', 'char', 'text', 'datetime'}:
values.update({
f'old_value_{col_info["type"]}': initial_value,
f'new_value_{col_info["type"]}': new_value
})
elif col_info['type'] == 'monetary':
values.update({
'currency_id': record[col_info['currency_field']].id,
'old_value_float': initial_value,
'new_value_float': new_value
})
elif col_info['type'] == 'date':
values.update({
'old_value_datetime': initial_value and fields.Datetime.to_string(datetime.combine(fields.Date.from_string(initial_value), datetime.min.time())) or False,
'new_value_datetime': new_value and fields.Datetime.to_string(datetime.combine(fields.Date.from_string(new_value), datetime.min.time())) or False,
})
elif col_info['type'] == 'boolean':
values.update({
'old_value_integer': initial_value,
'new_value_integer': new_value
})
elif col_info['type'] == 'selection':
values.update({
'old_value_char': initial_value and dict(col_info['selection']).get(initial_value, initial_value) or '',
'new_value_char': new_value and dict(col_info['selection'])[new_value] or ''
})
elif col_info['type'] == 'many2one':
values.update({
'old_value_integer': initial_value.id if initial_value else 0,
'new_value_integer': new_value.id if new_value else 0,
'old_value_char': initial_value.display_name if initial_value else '',
'new_value_char': new_value.display_name if new_value else ''
})
elif col_info['type'] in {'one2many', 'many2many'}:
values.update({
'old_value_char': ', '.join(initial_value.mapped('display_name')) if initial_value else '',
'new_value_char': ', '.join(new_value.mapped('display_name')) if new_value else '',
})
else:
raise NotImplementedError(f'Unsupported tracking on field {field.name} (type {col_info["type"]}')
return values
def _tracking_value_format(self):
""" Return structure and formatted data structure to be used by chatter
to display tracking values. Order it according to asked display, aka
ascending sequence (and field name).
:return list: for each tracking value in self, their formatted display
values given as a dict;
"""
if not self:
return []
field_models = self.field_id.mapped('model')
if len(set(field_models)) != 1:
raise ValueError('All tracking value should belong to the same model.')
TrackedModel = self.env[field_models[0]]
tracked_fields = TrackedModel.fields_get(self.field_id.mapped('name'), attributes={'string', 'type'})
fields_col_info = (
tracked_fields.get(tracking.field_id.name) or {
'string': tracking.field_info['desc'],
'type': tracking.field_info['type'],
}
for tracking in self
)
fields_sequence_map = dict(
{tracking.field_info['name']: tracking.field_info.get('sequence', 100)
for tracking in self.filtered('field_info')},
**dict(TrackedModel._mail_track_order_fields(tracked_fields))
)
formatted = [
{
'changedField': col_info['string'],
'id': tracking.id,
'fieldName': tracking.field_id.name or tracking.field_info['name'],
'fieldType': col_info['type'],
'newValue': {
'currencyId': tracking.currency_id.id,
'value': tracking._format_display_value(col_info['type'], new=True)[0],
},
'oldValue': {
'currencyId': tracking.currency_id.id,
'value': tracking._format_display_value(col_info['type'], new=False)[0],
},
}
for tracking, col_info in zip(self, fields_col_info)
]
formatted.sort(
key=lambda info: (fields_sequence_map[info['fieldName']], info['fieldName']),
reverse=False,
)
return formatted
def _format_display_value(self, field_type, new=True):
""" Format value of 'mail.tracking.value', according to the field type.
:param str field_type: Odoo field type;
:param bool new: if True, display the 'new' value. Otherwise display
the 'old' one.
"""
field_mapping = {
'boolean': ('old_value_integer', 'new_value_integer'),
'date': ('old_value_datetime', 'new_value_datetime'),
'datetime': ('old_value_datetime', 'new_value_datetime'),
'char': ('old_value_char', 'new_value_char'),
'float': ('old_value_float', 'new_value_float'),
'integer': ('old_value_integer', 'new_value_integer'),
'monetary': ('old_value_float', 'new_value_float'),
'text': ('old_value_text', 'new_value_text'),
}
result = []
for record in self:
value_fname = field_mapping.get(
field_type, ('old_value_char', 'new_value_char')
)[bool(new)]
value = record[value_fname]
if field_type in {'integer', 'float', 'char', 'text', 'monetary'}:
result.append(value)
elif field_type in {'date', 'datetime'}:
if not record[value_fname]:
result.append(value)
elif field_type == 'date':
result.append(fields.Date.to_string(value))
else:
result.append(f'{value}Z')
elif field_type == 'boolean':
result.append(bool(value))
else:
result.append(value)
return result