介绍库

一般信息

库概述

利用 EmailHandling 库提供的电子邮件客户端功能，您的控制器可以将电子邮件发送至一个或多个收件人，并且可以定制内容。电子邮件传输标配的协议类型为 SMTP。也可以使用 Post Office Protocol 3 (POP3) 协议来接收或删除来自服务器的电子邮件。

此库支持使用 TLS 经由安全连接实现的 SMTP 和 POP3。

是否支持使用 TLS 建立连接取决于使用 FB_TcpClient2 的控制器。请参阅控制器的相应手册，确认是否支持使用 TLS 开展 TCP 通讯。

您可以将控制器连接到电子邮件服务器以发送电子邮件，告知有关机器状态的信息或报告关健性能指标。

1 控制器

2 电子邮件服务器

3 收件人/发件人

库的特性

下表说明库的特性：

特性	值
库标题	EmailHandling
公司	Schneider Electric
类别	通讯
组件	互联网协议族
缺省命名空间	SE_EMail
语言模型属性	（仅限符合条件时访问）
向上兼容库	是 (FCL)

注意：对于此库，设置“仅限定访问”。这意味着 POU、数据结构、枚举和常量必须通过使用库的命名空间进行访问。此库的缺省命名空间是 SE_EMail。

项目示例

结合此库，提供了示例项目 EMailHandlingExample.project。示例项目显示了如何实施 EmailHandling 库的组件。

步骤	操作	注释
1	在 EcoStruxure Machine Expert Logic Builder中，执行命令新建项目。	–
2	在新建项目对话框中，从项目类型列表中选择来自示例。	–
3	在新建项目对话框的右侧，从控制器列表中选择控制器 ⁽¹⁾。	结果：可用的示例在匹配示例文本框中列出。
4	从匹配示例列表中选择您的示例。	–
5	为新项目输入名称，然后选择文件位置。	–
6	单击确定按钮。	结果：基于所选择的示例选择了新项目。

⁽¹⁾ PacDrive LMC Pro/Pro2、TM251MESE、TM262M25MESS8T

一般注意事项

考虑以下电子邮件传输限制：

o仅支持 ASCII 符号。

o仅支持 IPv4 IP 地址。

oEmailHandling 包含地址的指针。

o不支持接收确认。

o电子邮件方式的文件收发会导致文件属性丢失。

o如果收件人地址不存在，则依赖于服务器配置，即，是否已创建反馈邮件，或者 FB_SendEMail 是否能够创建诊断消息。

o必须在应用程序中执行电子邮件存档（发送和接收的项目）。不会自动将电子邮件存储在控制器文件系统上，因为电子邮件主要在控制器 RAM（随机存取存储器）中处理。

执行在线更改命令可能更改地址内容。

小心

无效指针

对地址使用指针并执行在线更改命令时，请检查指针的有效性。

不遵循上述说明可能导致人身伤害或设备损坏。

本文档所用的库在内部使用 TcpUdpCommunication库。

TcpUdpCommunication(Schneider Electric) 和 CAA Net Base Services 库（CAA 技术工作组）在控制器上使用相同的相同资源。若在同一应用程序中同时使用这两个库，则可能导致控制器工作受到干扰。

警告

意外的设备操作

不要在同一应用程序中同时使用库 TcpUdpCommunication(Schneider Electric) 和库 CAA Net Base Services（CAA 技术工作组）。

不遵循上述说明可能导致人员伤亡或设备损坏。

注意： Schneider Electric 在控制系统的开发和实施过程中严格遵循行业最佳实践。这其中包括一种“深度防御”方法，旨在保护工业控制系统的安全。此方法将控制器置于一个或多个防火墙之后，将访问范围限制为仅经过授权的人员和协议。

警告

未经授权访问及其导致的未经授权的机器操作

o评估环境或机器是否已连接到关键基础结构，如果已连接，请在将自动化系统连接到任何网络之前，基于深度防护采取适当的预防措施。

o将连接到网络的设备数限制为所需的最小数量。

o将工业网络与公司内部的其他网络隔离。

o使用防火墙、VPN 或其他经证实的安全措施，防止意外访问任何网络。

o监控系统内的活动。

o防止未经授权方或未经身份验证的操作直接访问或直接链接主体设备。

o准备恢复计划，包括系统和过程信息的备份。

不遵循上述说明可能导致人员伤亡或设备损坏。

在用输入 i_pbyWhiteListSender 配置白名单后，会将此名单的条目与已接收电子邮件的标头中指定的发件人电子邮件进行比较。此功能无法保护已接收电子邮件中标头字段 From: 不受蓄意篡改。

控制器上没有防病毒程序。建议在服务器侧配置一个这样的程序。