Odoo：Odoo邮件与通知系统技术教程.Tex.header

Odoo：Odoo邮件与通知系统技术教程1Odoo邮件系统概述1.1Odoo邮件模块介绍Odoo邮件模块是Odoo框架中一个强大的工具，用于自动化和管理企业内部及外部的邮件通信。它不仅支持发送和接收电子邮件，还提供了邮件模板、邮件跟踪、邮件线程等功能，使得在Odoo应用中集成邮件通信变得简单而高效。1.1.1核心功能邮件线程：允许在任何模型上添加评论和消息，所有通信都与特定记录相关联。邮件模板：创建可重复使用的邮件模板，用于自动发送带有动态内容的邮件。邮件跟踪：记录所有邮件活动，包括发送、接收和打开邮件的状态。自动化邮件：基于特定事件或条件自动触发邮件发送。1.2邮件发送机制Odoo邮件模块使用SMTP（SimpleMailTransferProtocol）服务器来发送邮件。在Odoo中配置SMTP服务器后，可以使用mail.mail模型来创建和发送邮件。邮件发送可以通过编程方式触发，也可以通过用户界面手动发送。1.2.1示例代码：发送邮件#导入必要的模块

fromodooimportmodels,fields,api

classSendEmail(models.Model):

_name='send.email'

_description='SendEmailModel'

#定义发送邮件的方法

defsend_email(self):

#创建邮件记录

mail=self.env['mail.mail'].create({

'subject':'Odoo邮件测试',

'body_html':'<p>这是一封来自Odoo的测试邮件。</p>',

'email_from':'sender@',

'email_to':'receiver@',

})

#发送邮件

mail.send()在上述代码中，我们首先创建了一个mail.mail记录，定义了邮件的主题、HTML格式的正文、发件人和收件人。然后，调用send方法来发送邮件。1.3邮件模板创建与使用Odoo邮件模板允许用户创建包含动态字段的邮件，这些字段在发送邮件时会被替换为实际值。模板可以与特定的模型相关联，以便在创建或更新记录时自动发送邮件。1.3.1创建邮件模板在Odoo的用户界面中，可以通过以下步骤创建邮件模板：进入“设置”菜单。选择“技术”下的“邮件”选项。点击“邮件模板”并创建一个新的模板。配置模板的名称、模型、主题、正文等。1.3.2示例代码：使用邮件模板#导入必要的模块

fromodooimportmodels,fields,api

classEmailTemplateUsage(models.Model):

_name='email.template.usage'

_description='EmailTemplateUsageModel'

#定义使用邮件模板的方法

defsend_template_email(self):

#获取模板

template=self.env.ref('module_name.email_template_name')

#发送模板邮件

template.send_mail(self.id,force_send=True)在代码中，我们使用env.ref来获取预先定义的邮件模板。然后，调用send_mail方法，传入当前记录的ID和force_send参数，以确保邮件立即发送。1.3.3动态字段替换邮件模板中的动态字段以{{field_name}}的形式表示。例如，如果模板中包含{{}}，在发送邮件时，Odoo会将字段的值替换到邮件中。1.3.4示例：动态字段在邮件模板中的使用假设我们有一个客户模型res.partner，并且我们想要发送一封包含客户名称的欢迎邮件。邮件模板可以这样设置：<p>亲爱的{{}},</p>

<p>欢迎加入我们的社区！</p>当使用此模板发送邮件时，Odoo会自动将{{}}替换为实际的客户名称。通过以上介绍和示例，我们可以看到Odoo邮件模块的灵活性和强大功能，它极大地简化了企业通信的管理，提高了工作效率。2配置Odoo邮件服务器2.1设置邮件服务器参数在Odoo中，配置邮件服务器是实现自动化邮件发送和接收的基础。以下是配置邮件服务器参数的步骤：登录Odoo管理员账户：首先，确保你使用的是Odoo的管理员账户登录，因为邮件服务器的配置需要管理员权限。进入设置菜单：在Odoo的主菜单中，找到并点击“设置”（Settings）。选择邮件服务器：在设置菜单中，滚动找到“邮件”（Email）部分，点击“邮件服务器”（EmailServers）。添加邮件服务器：点击“创建”（Create）按钮，添加一个新的邮件服务器。在弹出的表单中，你需要填写以下信息：服务器类型：选择“发送”（Send）或“接收”（Receive）。服务器名称：给服务器起一个描述性的名字。服务器主机：输入邮件服务器的主机名或IP地址。服务器端口：输入邮件服务器的端口号。使用SSL：勾选此选项如果服务器使用SSL加密。使用TLS：勾选此选项如果服务器使用TLS加密。用户名和密码：输入用于连接邮件服务器的用户名和密码。保存设置：填写完所有必要信息后，点击“保存”（Save）按钮。2.1.1示例代码：设置邮件服务器参数#导入必要的模块

fromodooimportmodels,fields,api

classMailServerConfig(models.TransientModel):

_inherit='mail.server'

#重写create方法以添加自定义邮件服务器

@api.model

defcreate(self,vals):

#创建邮件服务器

server=super(MailServerConfig,self).create(vals)

#设置服务器参数

server.write({

'smtp_host':'',

'smtp_port':587,

'smtp_user':'user@',

'smtp_pass':'password',

'smtp_encryption':'starttls',

'smtp_authentication':True,

})

returnserver2.2测试邮件服务器连接配置完邮件服务器后，测试连接以确保一切正常是至关重要的。Odoo提供了一个内置的测试功能来检查邮件服务器的连接状态。在邮件服务器列表中：在“邮件服务器”（EmailServers）的列表视图中，找到你刚刚创建的邮件服务器。点击测试按钮：在邮件服务器的行中，你会看到一个“测试”（Test）按钮。点击它，Odoo将尝试连接到邮件服务器并发送一个测试邮件。检查测试邮件：如果邮件服务器配置正确，你将收到一封来自Odoo的测试邮件。检查你的收件箱以确认邮件是否成功送达。2.2.1示例代码：测试邮件服务器连接#导入必要的模块

fromodooimportmodels,fields,api

classTestMailServer(models.TransientModel):

_name='test.mail.server'

#定义测试邮件发送的方法

deftest_mail_server(self):

#获取第一个邮件服务器

mail_server=self.env['ir.mail_server'].search([],limit=1)

#使用邮件服务器发送测试邮件

mail_server.test_smtp()2.3配置邮件安全邮件安全是配置邮件服务器时不可忽视的一部分。Odoo允许你设置邮件安全选项，以确保邮件的发送和接收过程中的数据安全。选择加密类型：在邮件服务器的配置中，你可以选择使用SSL或TLS加密。SSL（SecureSocketsLayer）和TLS（TransportLayerSecurity）都是用于加密互联网通信的协议。设置身份验证：确保勾选“使用身份验证”（UseAuthentication）选项，并输入正确的用户名和密码。这将防止未经授权的访问。检查邮件服务器的安全设置：在配置邮件服务器时，检查服务器的安全设置，确保它们符合你的安全策略。2.3.1示例代码：配置邮件安全#导入必要的模块

fromodooimportmodels,fields,api

classMailServerSecurity(models.TransientModel):

_inherit='mail.server'

#重写write方法以更新邮件服务器的安全设置

defwrite(self,vals):

#更新邮件服务器的安全设置

super(MailServerSecurity,self).write({

'smtp_encryption':'ssl',#设置加密类型为SSL

'smtp_authentication':True,#启用身份验证

})

returnTrue通过以上步骤，你可以有效地配置Odoo的邮件服务器，确保邮件的发送和接收既高效又安全。3使用Odoo发送邮件3.1创建邮件活动在Odoo中，创建邮件活动是通过mail.mail模型来实现的。首先，我们需要定义邮件模板，然后基于模板创建邮件活动。下面是一个创建邮件模板和邮件活动的示例代码：#创建邮件模板

mail_template=env['mail.template'].create({

'name':'客户欢迎邮件',

'model_id':env['ir.model']._get('res.partner').id,

'subject':'欢迎加入我们的社区！',

'body_html':'<p>尊敬的{{}},欢迎您加入我们的社区！</p>',

})

#基于模板创建邮件活动

partner=env['res.partner'].search([],limit=1)

mail_activity=env['mail.mail'].create({

'email_from':'admin@',

'author_id':partner.id,

'email_to':partner.email,

'mail_template_id':mail_template.id,

})

#发送邮件

mail_activity.send()3.1.1解释mail.template模型用于创建邮件模板，模板可以包含动态字段，如{{}}，它将在发送邮件时被替换为收件人的名字。mail.mail模型用于创建具体的邮件活动，通过mail_template_id字段关联邮件模板。send()方法用于发送邮件活动。3.2自动化邮件发送Odoo支持自动化邮件发送，这通常通过mail.activity模型和mail.activity.type模型来实现。下面是一个设置自动化邮件发送的示例：#创建活动类型

activity_type=env['mail.activity.type'].create({

'name':'跟进',

'res_model_id':env['ir.model']._get('res.partner').id,

})

#创建自动化活动

activity=env['mail.activity'].create({

'summary':'新客户跟进',

'activity_type_id':activity_type.id,

'res_id':partner.id,

'res_model_id':env['ir.model']._get('res.partner').id,

'date_deadline':fields.Date.today()+timedelta(days=7),

'note':'请在一周内跟进新客户。',

})

#当活动状态改变时，触发邮件发送

activity.action_feedback(feedback='已处理')3.2.1解释mail.activity.type模型用于定义活动类型，如“跟进”。mail.activity模型用于创建自动化活动，活动可以设置截止日期和备注。action_feedback()方法用于标记活动为已完成，同时可以触发邮件通知。3.3邮件跟踪与分析Odoo提供了邮件跟踪和分析功能，这可以通过mail.tracking.value模型和mail.statistics模型来实现。下面是一个示例，展示如何在邮件发送后跟踪邮件状态：#发送邮件并获取邮件统计信息

mail_activity.send()

mail_stats=env['mail.statistics'].search([('mail_mail_id','=',mail_activity.id)])

#打印邮件统计信息

forstatinmail_stats:

print(f"邮件状态：{stat.state}")

print(f"打开次数：{stat.opened}")

print(f"点击次数：{stat.clicked}")3.3.1解释mail_activity.send()方法发送邮件后，会生成邮件统计信息。mail.statistics模型用于存储邮件的统计信息，如邮件状态、打开次数和点击次数。通过查询mail.statistics模型，可以获取并分析邮件的跟踪数据。通过以上示例，我们可以看到Odoo邮件与通知系统不仅支持创建和发送邮件，还提供了自动化邮件发送和邮件跟踪分析的高级功能。这些功能的实现依赖于Odoo的模型和方法，通过Python代码可以灵活地控制和扩展邮件系统的功能。4Odoo通知系统详解4.1通知类型与用途在Odoo中，通知系统是用于在系统内部或通过电子邮件向用户发送消息的关键组件。它支持多种通知类型，包括但不限于：即时通知：当用户在系统中执行特定操作时立即发送的通知。电子邮件通知：通过电子邮件发送给用户的通知，适用于系统外的通信。计划通知：根据预定义的时间表发送的通知，如定期报告或提醒。4.1.1即时通知示例即时通知通常用于提醒用户系统内的活动，例如，当一个新任务被分配给用户时。下面是一个创建即时通知的代码示例：fromodooimportmodels,fields,api

classTask(models.Model):

_name='project.task'

_inherit=['mail.thread','mail.activity.mixin']

name=fields.Char('TaskName',required=True)

user_id=fields.Many2one('res.users',string='Assignedto',track_visibility='onchange')

@api.model

defcreate(self,vals):

task=super(Task,self).create(vals)

iftask.user_id:

task.activity_schedule('mail.mail_activity_data_todo',user_id=task.user_id.id)

returntask在这个例子中，当一个新任务被创建并分配给一个用户时，activity_schedule方法被调用来创建一个待办活动，这将触发一个即时通知给被分配的用户。4.1.2电子邮件通知示例电子邮件通知用于向系统外部的用户发送消息，例如，当客户下单后，向客户发送确认邮件。下面是一个发送电子邮件通知的代码示例：fromodooimportmodels,fields,api

classSaleOrder(models.Model):

_inherit='sale.order'

@api.multi

defaction_confirm(self):

result=super(SaleOrder,self).action_confirm()

fororderinself:

template=self.env.ref('module_name.email_template_name')

template.send_mail(order.id,force_send=True)

returnresult在这个例子中，当销售订单被确认时，send_mail方法被调用来发送一个预定义的电子邮件模板给订单的客户。4.2创建自定义通知创建自定义通知涉及定义通知的触发条件、内容和接收者。Odoo提供了灵活的API来实现这一功能。4.2.1定义自定义通知首先，需要创建一个模型来承载通知的逻辑。例如，创建一个模型来发送项目更新通知：fromodooimportmodels,fields,api

classProjectUpdateNotification(models.Model):

_name='project.update.notification'

_inherit=['mail.thread']

project_id=fields.Many2one('ject',string='Project',required=True)

message=fields.Text('Message',required=True)

@api.model

defcreate(self,vals):

notification=super(ProjectUpdateNotification,self).create(vals)

followers=ject_id.message_follower_ids

forfollowerinfollowers:

follower.notify_info(body=notification.message,title='ProjectUpdate')

returnnotification在这个例子中，当ProjectUpdateNotification被创建时，所有项目关注者都将收到一个包含项目更新信息的通知。4.3通知规则与权限Odoo的通知系统允许管理员定义复杂的规则来控制何时、何地以及向谁发送通知。此外，权限管理确保只有授权用户才能接收或触发特定类型的通知。4.3.1定义通知规则通知规则可以通过Odoo的mail.activity.type和mail.activity模型来定义。例如，创建一个规则来自动为新创建的销售订单安排一个销售确认活动：fromodooimportmodels,fields,api

classSaleOrder(models.Model):

_inherit='sale.order'

@api.model

defcreate(self,vals):

order=super(SaleOrder,self).create(vals)

activity_type=self.env.ref('module_name.activity_type_sale_confirmation')

order.activity_schedule(activity_type.id,user_id=order.user_id.id)

returnorder在这个例子中，当销售订单被创建时，一个销售确认活动被自动安排给销售代表。4.3.2管理权限通知的权限管理是通过Odoo的ir.model.access和res.groups模型实现的。例如，限制只有销售经理才能接收销售确认通知：fromodooimportmodels,fields,api

classSaleOrder(models.Model):

_inherit='sale.order'

@api.model

defcreate(self,vals):

order=super(SaleOrder,self).create(vals)

activity_type=self.env.ref('module_name.activity_type_sale_confirmation')

sales_manager_group=self.env.ref('module_name.group_sales_manager')

sales_manager=self.env['res.users'].search([('groups_id','in',sales_manager_group.id)])

order.activity_schedule(activity_type.id,user_id=sales_manager.id)

returnorder在这个例子中，只有属于销售经理组的用户才能接收销售确认活动的通知。通过上述示例，我们可以看到Odoo的通知系统不仅强大而且高度可定制，能够满足各种业务场景下的通信需求。5集成邮件与通知功能5.1在模型中添加邮件字段在Odoo中，为了使模型能够支持邮件功能，我们需要在模型定义中添加特定的字段。这些字段通常包括email字段，用于存储联系人的电子邮件地址，以及message_follower_ids字段，用于跟踪关注该记录的用户。此外，message_ids字段用于存储与该记录相关的所有邮件消息。5.1.1示例代码fromodooimportmodels,fields

classMyModel(models.Model):

_name='my.model'

_inherit=['mail.thread','mail.activity.mixin']

_description='MyModelDescription'

name=fields.Char('Name',required=True)

email=fields.Char('Email',required=True)

message_follower_ids=fields.One2many('mail.followers','res_id',string='Followers',domain=[('res_model','=',_name)])

message_ids=fields.One2many('mail.message','model',string='Messages',domain=[('res_id','=','id')])在上述代码中，我们定义了一个名为MyModel的模型，它继承了mail.thread和mail.activity.mixin。这使得MyModel能够接收邮件和通知，并且可以有关注者和邮件消息。5.2触发邮件与通知的事件Odoo允许我们在特定事件发生时自动发送邮件或通知。这些事件可以是创建新记录、更新记录、删除记录等。我们可以通过在模型中定义_track属性来指定哪些字段的更改应该触发邮件通知。5.2.1示例代码classMyModel(models.Model):

_name='my.model'

_inherit=['mail.thread','mail.activity.mixin']

_description='MyModelDescription'

name=fields.Char('Name',required=True,tracking=True)

email=fields.Char('Email',required=True,tracking=True)

_sql_constraints=[

('email_unique','unique(email)','Theemailmustbeunique!'),

]

_track={

'name':{

'my_module.mt_name_changed':lambdaself,cr,uid,obj,ctx=None:True,

},

'email':{

'my_module.mt_email_changed':lambdaself,cr,uid,obj,ctx=None:True,

},

}在本例中，我们定义了name和email字段的更改应该触发邮件通知。_track属性中的mt_name_changed和mt_email_changed是邮件模板的名称，它们将在字段更改时被触发。5.3使用API进行邮件与通知的自定义Odoo提供了强大的API，允许我们自定义邮件和通知的发送方式。我们可以使用mail.mail和mail.message模型来创建和发送邮件，以及使用mail.activity模型来创建活动通知。5.3.1示例代码fromodooimportmodels,fields,api

classMyModel(models.Model):

_name='my.model'

_inherit=['mail.thread','mail.activity.mixin']

_description='MyModelDescription'

name=fields.Char('Name',required=True)

email=fields.Char('Email',required=True)

defsend_custom_email(self):

template_id=self.env.ref('my_module.email_template_id').id

self.env['mail.template'].browse(template_id).send_mail(self.id,force_send=True)

defcreate_custom_notification(self):

activity_type_id=self.env.ref('my_module.activity_type_id').id

summary='CustomNotification'

note='Thisisacustomnotificationfortherecord.'

self.env['mail.activity'].create({

'res_id':self.id,

'res_model_id':self.env['ir.model']._get('my.model').id,

'user_id':self.env.user.id,

'activity_type_id':activity_type_id,

'summary':summary,

'note':note,

})在上述代码中，我们定义了两个方法：send_custom_email和create_custom_notification。send_custom_email方法使用预定义的邮件模板发送邮件，而create_custom_notification方法创建一个自定义的活动通知。5.3.2邮件模板示例<!--email_template_id.xml-->

<templateid="email_template_id"name="CustomEmailTemplate"model="my.model">

<tt-call="mail.mail_notification_light">

<tt-set="title"t-value="Hello,{{}}!"/>

<tt-set="body">

<p>Dear{{}},</p>

<p>Youremailhasbeenupdatedto{{object.email}}.</p>

</t>

</t>

</template>在本例中，我们定义了一个邮件模板，它将发送给MyModel的实例，当调用send_custom_email方法时。模板使用了{{}}和{{object.email}}来动态填充邮件内容。5.3.3活动类型示例<!--activity_type_id.xml-->

<recordid="activity_type_id"model="mail.activity.type">

<fieldname="name">CustomNotification</field>

<fieldname="summary">CustomSummary</field>

<fieldname="res_model">my.model</field>

</record>在本例中，我们定义了一个活动类型，它将用于创建自定义的活动通知。当调用create_custom_notification方法时，将使用这个活动类型来创建通知。通过这些示例，我们可以看到如何在Odoo中集成邮件与通知功能，以及如何自定义这些功能以适应特定的业务需求。使用Odoo的邮件和通知系统，可以有效地与用户和合作伙伴进行沟通，提高业务流程的透明度和效率。6邮件与通知的高级应用6.1多语言邮件模板在Odoo中，多语言邮件模板允许您根据用户的语言偏好发送不同语言版本的邮件。这通过在模板中使用qweb标签和t-属性来实现，其中t-esc用于输出字段，t-if用于条件渲染，t-att-lang用于设置语言。6.1.1示例代码#定义多语言邮件模板

fromodooimportmodels

classMailTemplate(models.Model):

_inherit='mail.template'

def_render_template(self,template_xmlid,model,res_ids,post_process=False):

template=self.env.ref(template_xmlid)

#使用多语言环境渲染模板

lang=self.env.context.get('lang')

iflang:

self.env.context=self.env.context.copy()

self.env.context['lang']=lang

returnsuper(MailTemplate,self)._render_template(template,model,res_ids,post_process=post_process)6.1.2示例模板<odoo>

<templateid="mail_template_multi_lang"name="多语言邮件模板"model="res.partner">

<tt-call="mail.mail_notification_paynow">

<tt-set="lang"t-value="object.lang"/>

<tt-esc=""/>

<tt-if="lang=='zh_CN'">

<p>尊敬的客户，您的订单已确认。</p>

</t>

<tt-if="lang=='en_US'">

<p>Dearcustomer,yourorderhasbeen