配置电子邮件通知

Created: 八月 10, 2022 | Updated: 八月 12, 2022 | Applies to version: 5.5

您正在阅读的是 5.5. 版本。关于最新版本，请前往配置电子邮件通知阅读 8.0 版本

Parent page: 配置

Altium NEXUS Server 提供配置电子邮件通知的能力，可将 NEXUS Server 中发生的各类事件标记并通知关键相关人员。

启用与配置该功能

从您的 NEXUS Server 实例发送通知邮件的功能，可在 NEXUS Server 浏览器界面的 Email Notifications 页面（Admin – Settings – Email Notifications）中启用并配置。该页面是界面中的一个元素，only 仅 NEXUS Server 的管理员用户可访问——即属于 Administrators 角色的用户。

Altium NEXUS Server 仅支持使用 SMTP（简单邮件传输协议）进行邮件通知，因为大多数通过互联网发送邮件的邮件系统都使用该协议。

Email Notifications 区域中的 Admin – Settings 页面提供了用于启用和配置 NEXUS Server 邮件通知功能的界面。

默认情况下，NEXUS Server 的邮件通知功能处于禁用状态。启用 Send Mail Enabled 选项即可开启。

配置页面中的各字段（详见下文），以便为您的组织设置该功能：

Email From – 邮件的发件账号，邮件中将显示为发件人（位于邮件的 From 字段），例如 notificationsbot@yourcompany.com。使用 Gmail 时，这里是用于发送通知邮件的源邮箱地址（例如 mycompanynotifications@gmail.com）。

当使用外部 Gmail、Hotmail 或 Office365 的 SMTP 服务器时，此字段的输入将被忽略。此时邮件的 From 字段将使用 Smtp User Name 字段的内容。Email From 字段仅在使用内部 SMTP 服务器时才会使用。
如果 Email From 字段指定的域与 Smtp User Name 字段的域不同，邮件可能会被拒收或被视为垃圾邮件。

Smtp User Name – 用于访问 SMTP 服务器的凭据中的用户名部分，例如 smtpserver@yourcompany.com。使用 Gmail 时，这里是用于发送通知邮件的源邮箱地址（例如 mycompanynotifications@gmail.com）。
Smtp User Password – 用于访问 SMTP 服务器的凭据中的密码部分。使用 Gmail 时，这里是访问用于发送通知的邮箱账号的密码。
Smtp Host – SMTP 服务器的主机名，例如 smtp.yourcompany.com。通过 Gmail 发送时，此项应为 smtp.gmail.com。
Smtp Port – SMTP 端口（通常为 25；通过 Gmail 发送时为 587）。
Smtp SSL Enabled – 用于启用 SMTP 通信。如果您的 SMTP 服务器使用 TLS/SSL，请勾选该复选框。
Interval to check notification (ms) – 服务器内分发新通知的时间间隔，以毫秒为单位。默认设置为 20000ms。

建议将该间隔设置为大于 10000 的值。

Send email notifications interval (ms) – 检查是否有新通知需要通过邮件发送的时间间隔，以毫秒为单位。默认设置为 35000ms。

建议将该间隔设置为大于 30000 的值。

示例邮件配置：使用 SMTP 从指定的 Gmail 账号发送邮件通知。

启用并按需配置完成后，点击按钮以测试从所选账号发送邮件。将出现 Check Email Settings 窗口，在其中输入目标邮箱地址并点击。对话框会显示 Checking... 的进度，并且如果发送账号配置正确，最终会显示 Sent Successful 的消息。

如果使用 Google 账号时遇到问题，可尝试允许访问安全性较低的应用。

通过向目标账号发送测试邮件来检查邮件通知设置。将鼠标悬停在图片上可查看检查成功的结果。

当然，查看目标邮箱会收到一封 Notifications Service Test Email，来自发送邮件的账号。

NEXUS Server 通知服务发送的测试邮件，已在用于检查的目标邮箱中收到。

通知邮件配置并测试成功后，请务必点击页面右上角的

按钮。

支持的通知

该功能支持多种邮件通知事件：

与受管项目相关的事件

Related Page: 工作区项目

通知包括：

Project Commit – 当项目已提交到 NEXUS Server 时的通知。
Project Update – 当项目属性发生变化时的通知（项目的 Name 和/或 Description）。
Project Release – 当项目已发布到 NEXUS Server 时的通知。
Project Revision State Change – 当项目的生命周期状态发生变化时的通知。
Project Activity Start – 当项目相关活动开始时的通知（Ad Hoc Review、Handoff Review 或 Milestone Review）。
Project Activity Complete – 当项目相关活动完成时的通知（Ad Hoc Review、Handoff Review 或 Milestone Review）。
Project Delete – 当项目被删除时的通知。

点击邮件主摘要区域中的超链接文本或主 Open 按钮，可在 NEXUS Server 的浏览器界面中打开该受管项目的详细页面。点击 Open in Altium NEXUS 链接可在 Altium NEXUS 实例中查看该项目或修订版。

通知邮件会发送给当前作为该项目协作者的所有用户，AND 且这些用户正在主动关注该项目。更多详情请参见 Watching a Managed Project 一节。对于与活动相关的事件（Project Activity Start、Project Activity Complete），邮件会发送给参与该活动的用户/角色。

与受管元器件相关的事件

Related Page: 连接工作区的元器件管理

通知包括：

Component Create – 当在 NEXUS Server 中创建了新元器件时的通知。
Component Release – 当元器件的新修订版已发布到 NEXUS Server 时的通知。
Component Revision State Change – 当元器件的生命周期状态发生变化时的通知。
Component Delete – 当元器件被删除时的通知。

点击邮件主摘要区域中的超链接文本或主 Open 按钮，可在 NEXUS Server 浏览器界面的 Explorer 页面中打开该元器件的详细页面。点击 Open in Altium NEXUS 链接可通过 Altium NEXUS 中的 Explorer panel 查看该元器件或修订版。

通知邮件会发送给所有正在主动关注该元器件所在父文件夹的用户。更多详情请参见 Following a Component Folder 一节。

通知包括：

New Approval Request – 当提交了对某个元器件条目修订版进行生命周期状态转换的审批请求时的通知。
Approval Request Reminder – 当原始请求人对待处理的审批请求使用“提醒（Reminder）”功能时的通知。
State Change Request Processed – 当相关审批组成员处理了待处理的审批请求时的通知。对该请求采取的操作类型可能是以下之一：
- Cancelled – 原始审批请求人决定取消该请求。
- Rejected – 相关审批组成员拒绝该请求。
- Approved – 若请求需要经过多个已定义的审批组流转，当中间审批组成员批准该请求时，将应用此操作。
- Completed – 审批组成员（或在定义了多个审批组时的最终审批组成员）批准该请求。

点击邮件主摘要区域中的超链接文本或主 Open 按钮，可在 NEXUS Server 基于浏览器的界面中 Explorer 页面打开该元器件条目的详细页面。点击 Open in Altium NEXUS 链接可通过 Altium NEXUS 中的 Explorer panel 查看该条目的修订版。

对于 New Approval Request 和 Approval Request Reminder，相关审批组成员会收到邮件通知。当状态变更请求被处理后，原始请求人以及下一审批组的所有成员（若定义了多个审批组）都会收到通知邮件。如果审批请求被审批组成员批准（或在定义了多个审批组时由最终审批组成员批准），状态转换将自动生效，所有相关方都会收到状态变更的邮件通知。