在Odoo框架中,可以找到各种各样的通知类型。用于在用户进行系统操作时,即时反馈相关的异常信息。常用的通知选项有如下几种:
1. Sticky Notification2. Rainbow Man Effect
3. Alert
4. Raise Exception/Validation
第一种显示通知设计为非侵入式通知。它们显示为临时弹出消息,不会阻止用户与系统的交互。用户可以继续执行其任务,同时仍能了解该消息。如下图样式:
这类通知可以由后端python代码触发,也可以由前端的js代码触发。其中python代码示例为:
notification = { 'type': 'ir.actions.client', 'tag': 'display_notification', 'params': { 'title': _('Warning'), 'type': 'warning', 'message': 'You cannot do this action now', 'sticky': True, } } return notification
上面params中的参数有如下几个:
title:消息的标题 message:消息正文 type:消息类型(info,success, warning, danger)影响消息框左边的颜色显示 links:消息附带的超链接,如[{label:'ok',url:'#'}] sticky:消息是否自动关闭(True:手动关闭,False:自动关闭) next:下一个动作定义{'type': 'ir.actions.act_window_close'}
JS前端触发消息提醒的代码示例为:
this.displayNotification({ message: _.str.sprintf(_t("Could not save file <strong>%s</strong>"),_.escape(file.name)), type: 'warning', sticky: true, });
在js中参数对象就是上面py方法中的params对象内容。
第二种消息提醒是彩虹人特效。这个在odoo的内核中使用了一个特效服务,代码是在:
addons\web\static\src\core\effects\effect_service.js
这个代码里注册了一个'rainbow_man'类型的特效,主要效果就是在完成某个操作以后,在屏幕上显示出一个图像动画,比如CRM中的线索转换为商机以后会有类似的提示。在python方法中可以用如下语法触发这个物效:
return { 'effect': { 'fadeout': 'fast', 'message': '这里是提示的内容', 'img_url': '/web/image/%s/%s/image_1024' % (self.team_id.user_id._name, self.team_id.user_id.id) if self.team_id.user_id.image_1024 else '/web/static/img/smile.svg', 'type': 'rainbow_man', } }
这里的图片链接地址根据你自己的记录来进行调整。参数fadeout是指特效淡出的速度,是快、中、慢几个选项。
如果是在JS的controller对象中的话,可以用如下语法来执行;
async setup() { super.setup(); this.effect = useService("effect"); } async setRainbowMan(message) { this.effect.add({ message, type: "rainbow_man", }); }
第三种消息提醒是浏览器中自带的alert方法,如:
alert(_t('An error occurred when loading product prices. ' + 'Make sure all pricelists are available in the POS.' ));
第四种消息是我们见得最多的,就是在python中执行时如果抛出一个异常,则会在浏览器中提示一个弹窗,需要用户关闭弹窗后才能继续作业。这个js处理的主要代码是在:
addons\web\static\src\core\errors\error_dialogs.js
我们主要看最后一句的内容:
registry .category("error_dialogs") .add("odoo.exceptions.AccessDenied", WarningDialog) .add("odoo.exceptions.AccessError", WarningDialog) .add("odoo.exceptions.MissingError", WarningDialog) .add("odoo.exceptions.UserError", WarningDialog) .add("odoo.exceptions.ValidationError", WarningDialog) .add("odoo.exceptions.RedirectWarning", RedirectWarningDialog) .add("odoo.http.SessionExpiredException", SessionExpiredDialog) .add("werkzeug.exceptions.Forbidden", SessionExpiredDialog) .add("504", Error504Dialog);
这里我们可以看出,不管从python中抛出来的异常是AccessDenied、AccessError、MissingError、UserError、ValidationError,在前端都是响应WarningDialog对话框,只是根据不同的异常类型显示了不同的对话框标题栏文字(源码中odooExceptionTitleMap对像映射)。
上面有一种特殊的异常类型为RedirectWarning,这个在python中的定义为:
class RedirectWarning(Exception): """ Warning with a possibility to redirect the user instead of simply displaying the warning message. :param str message: exception message and frontend modal content :param int action_id: id of the action where to perform the redirection :param str button_text: text to put on the button that will trigger the redirection. :param dict additional_context: parameter passed to action_id. Can be used to limit a view to active_ids for example. """ def __init__(self, message, action, button_text, additional_context=None): super().__init__(message, action, button_text, additional_context)
说明这个异常在调用时可以传四个参数进去,提示的文字消息、要跳转的动作ID,跳转链接的文字,跳转动作的上下文。一个实际使用的例子如下:
action = self.env.ref('account.action_account_config') msg = _('Cannot find a chart of accounts for this company, You should configure it. \nPlease go to Account Configuration.') raise RedirectWarning(msg, action.id, _('Go to the configuration panel'))
最后还有一个比较特殊的消息提醒异常是SessionExpiredException,这个主要是当前操作的连线丢失或过期了,就会有提示,当你关闭这个对话框时,浏览器会重定向到login界面。
以上就是在Odoo中各类消息提醒的简要总结,大家可以根据业务需要选择不同的消息提醒方式来简化系统交互,增强用户的参与度。
标签:提示,通知,odoo,exceptions,add,Odoo,action,message,id From: https://www.cnblogs.com/pythonClub/p/17727831.html