邮件自动创建工单

名称：邮件自动创建工单

描述：扫描多个邮箱以创建或更新票证。

版本:3.1.1

发布:2019-11-22

itop-version-min：2.3.0

码：组合邮件到工单的自动化

州：稳定

备用名称：工单通过电子邮件创建

github-module1 1：[  /Combodo/combodo-email-synchro]https: mCombodoocombodo-email-synchro[/url]

github-module12：[  /Combodo/itop-standard-email-synchro]https: mCombodooitop-standard-email-synchro[/url]

扩散：iTop集线器

该组件的其他版本： [ ttps://www.itophub.io/wiki/page?id=extensions:ticket-from-email_2_2]2.2[/url], [ ttps://www.itophub.io/wiki/page?id=extensions:ticket-from-email_2_6]2.6.12[/url]

总结

该扩展程序在后台中运行，以扫描定义的邮件收件箱，并根据传入电子邮件的内容创建或更新票证。

在创建工单时，它会用发送邮件的内容填充工单的说明，设置呼叫人，客户，复制附件，添加联系人和许多其他字段…

在更新工单时，它将尽可能最佳地提取发送邮件的``最后答复''部分以更新工单的外部留言，复制附件，变更，工单的状况并添加联系人

特征

确定发件人是否是现有的Person（由其发送邮件找到），然后可以基于配置拒绝发送邮件中的发送邮件或创建新的Person。

确定是否必须根据iTop在发送邮件中添加的自定义标头（如果有回复）或标题中的可配置模式来创建或更新工单

使用POP3或IMAP协议连接到任何邮箱

邮件收件箱的交互式配置

流程以HTML或纯文本格式接收的电子邮件

支持事件和用户请求票证

工单的附件会自动转换为工单的附件（可以排除“危险”类型的附件）

自动检测重复的附件（例如签名图像）

已关闭，直到相应的工单被删除或被删除为止

如果处理发送邮件时发生错误，则手册重试

嵌入在HTML邮件中的图像也会在iTop中内嵌显示。

图像``太小''（低于可配置的尺寸）不会作为附件导入（以排除签名）

大于可配置尺寸的图像可以在上载到iTop之前自动调整大小

“内嵌图像”以缩小（可配置）的大小显示，并且可以通过单击它们来“放大”。

根据要针对发送邮件的主题进行测试的一组可配置模式，自动拒绝“自动答复”电子邮件

将发送邮件的其他收件人（收件人：和CC ：）添加为工单上的其他联系人（可配置）。联系人必须已经与确切的发送邮件存在，将不会创建它，而只是链接到发送邮件。

收到工单时，对变更和工单的状态施加激励（在工单的状态上可配置，依赖）。

添加新的触发器类型：触发器（通过邮件更新时），允许通过接收到的发送邮件通知工单更新的时间。

如果要限制通知'创建对象'（在对象上），限制为由发送邮件创建的工单，请在OQL中使用触发器='发送邮件'。

修订记录

发布日期	版本	注释
2019-11-22	3.1.1	*与iTop 2.7的兼容性 *通过Outlook修复错误的编码非中断空间 *更新DE翻译 *从引用检查传入的发送邮件的ID
2019-05-21	3.1.0	* Toocc中与当前邮箱相同的发送邮件中的联系人不再添加到工单中 *以“信封格式”处理签名的电子邮件 *存储所有消息的eml
2019-03-19	3.0.17	字典内部更新
2019-03-13	3.0.16	*在错误中存储eml以获取消息 *错误日志附有相应的消息
2018-12-19	3.0.15	*更新西班牙语翻译（感谢Miguel Turrubiates） * JQuery兼容性（自iTop 2.6起的JQuery 3） *修复用于设置呼叫人_id的OQL（感谢Jeffrey！SF＃1628） *修复无效的ES词典（“ U-8字符格式错误”错误） *当未配置任何刺激时，修复不必要的轨迹“刺激”配置中的无效行
2018-06-27	3.0.14	添加DE翻译
2018-03-01	3.0.13	修复某些电子邮件上的损坏（二进制）附件（无UTF8电子邮件和错误的内容传输编码格式）。
2018-02-21	3.0.12	启用2.5.0菜单覆盖功能。
2018-02-06	3.0.11	修复未正确指定内容处置时存储为嵌入式图像的附件。
2018-02-05	3.0.10	修复版本3.0.8中损坏的PHP 5.3兼容性
2018-01-29	3.0.9	使用OQL允许触发器到过滤器
2018-01-25	3.0.8	垃圾邮件标记为“不需要”，并在延迟后删除。在“未知呼叫人”的情况下，可以发送通用发送邮件答复。更新俄语翻译
2017-08-28	3.0.7	CSV导入期间重复的字典条目发生冲突（归因于MailInboxStandard类的行为和error_behavior）。
2017-03-31	3.0.6	如果无法将EmailReplica错误消息持久保存到DB中（例如，带有4个字节的Unicode字符），则该消息将引发致命的错误。现在，当无法保留默认错误消息时，我们将其保存，并将原始消息转储到IssueLog中。
2016-11-10	3.0.5	现在支持几个MailInbox扫描一个发送邮件地址邮箱，只要它们具有不同的文件夹（Mailbox（用于IMAP）属性）。另外，修复了3.0.x中引入的回归问题，use_message_id_as_uid配置参数不再起作用。
2016-10-05	3.0.4	在Lotus Notes发出的消息中支持嵌入式图像。
2016-08-26	3.0.3	修复了3.0.x中引入的回归：应用刺激无效。当发件人未知时（如果是工单更新），CRON被致命的错误中断。如果目标字段为纯文本，则为空描述。如果发送邮件是纯文本格式（使用雷鸟创建的发送邮件，并且没有富文本格式），则在案例日志中丢失CR
2016-08-09	3.0.2	如果未安装某些先决条件（PEAR或IMAP），请确保安装程序不会崩溃。
2016-07-26	3.0.1	支持向工单添加更多联系人（收件人：和抄送：）。当收到工单的更新时，能够施加激励（对变更的状态为工单的状态）。
2016-06-07	2.6.12	安全:只有管​​理员才能看到邮件收件箱的密码。回归：正确导入所有附件（如果不是图像，则不只是最后一个附件）。增强功能：从HTML转换为纯文本时保留超链接。
2016-02-02	2.6.11	仅限开发人员：修复了模块itop-standard-email-synchro.的替代品的兼容性问题。回归已在2.6.6中引入，除非您已开发出itop-标准-发送邮件-同步的替代产品，否则影响度的行为并不影响度的。
2015-10-28	2.6.10	自动拒绝“自动回复”电子邮件（请参见下面的不需要的主题模式）。支持无主题的电子邮件。
2015-09-29	2.6.9	正确初始化ENUM值（＃1102），防止更新与邮件收件箱中配置的票证不同类的票证。
2015-03-09	2.6.8	修复了images_maximum_size参数的处理，以防止在不调整图像大小时发生错误。修复了检测HTML回复中的blockquote标签的模式。
2015-03-05	2.6.7	忽略小图像时禁止显示警告。变更是“ body_parts_order”的默认价值。
2015-01-21	2.6.6	支持内联图像，“太小”图像的过滤和“大”图像的大小调整。
2014-08-01	2.6.5	新的配置参数至变通方案以及带有GmaillIMAP的问题。
2014-07-21	2.6.4	增强功能：允许在处理电子邮件后立即从服务器删除电子邮件。 “ TriggerOnMailUpdate”的法语翻译，并使触发器可导入。
2014-06-04	2.6.3	增强功能：支持创建变更和问题票证。
2014-04-09	2.6.2	错误修复，以支持名称中包含反斜杠的邮箱（可能使用IMAP发生）。
2014-04-08	2.6.1	增加德语本地化（尽管不是100％翻译）。
2014-03-05	2.6.0	改进了错误的处理（例如，保留邮箱中的错误，重试手册），并在回复消息时更好地解码了消息的“新部分”。增强HTML到文本的转换，修复了“ Outlook的转发邮件”作为附件的处理。
n/a	2.5	支持多个邮件收件箱。通过iTop用户界面的邮件收件箱的交互式配置。电子邮件的解析解码的各种改进
2013-07-22	2.2	“原有”版本仅支持一个邮箱（从iTop配置文件配置）。该版本的文档可在这里找到：通过电子邮件创建工单（原有）

要求

PHP 5.2.1+和[  /manual/en/book.imap.php]IMAP扩展[/url]如果要连接到IMAP服务器，则启用此功能，或者梨：：网络插座（iTop随附其自己的PEAR :: POP3副本）如果要连接到POP3服务器。

使用有效邮箱到POP3或IMAP服务器的连接。

[ ttps://www.itophub.io/wiki/page?id=latest:admin:cron]cron.php文件[/url]必须正在运行才能启用传入电子邮件的处理。

对于调试跟踪，[  /manual/en/book.mbstring.php]PHP的MBString[/url]必须安装。

要调整大图的大小，[  /manual/en/book.image.php]菲律宾盾[/url]必须安装。

在 Ubuntu 16.04 上，可以使用 php-pear、php-net-socket 和 php-imap 包安装先决条件：

sudo apt-get install php-pear php-net-soc


安装和升级

在iTop的“扩展”文件夹中展开zip文件的内容。

兼容性问题：对于低于2.4.0的iTop版本，有一个[  :8082/bin/view/2/2.6/2.6%C2%B727/#itop_before_240]特殊安装/升级流程[/url].

确保Web服务器具有足够的权利来读取“扩展”文件夹中的所有文件。

启动安装程序，并在提示您输入要安装的扩展的列表时，从列表中选中“邮件自动创建工单”

在Ubuntu（16.04之前的版本）上使用IMAP：软件包php5-imap不启用IMAP模块。要在Ubuntu上使用IMAP模块，必须先安装它，然后显式启用它：

sudo apt-get install php5-imapsudo php5enmod imap

无论如何，您可能需要重新启动Web服务器才能将新安装的软件包放入账号：

sudo service apache2 restar


用法
数据映射

从传入的发送邮件消息创建新的工单时，应用自动填充工单的以下字段：

标题=邮件主题

说明=邮件正文

呼叫人（caller_id）=邮件的发件人（由发送邮件地址标识）

组织（（org_id）=呼叫人的组织

来源（如果工单上存在此字段）='mail'

必须通过“工单默认值”设置为工单的任何其他必填字段提供默认（即常量）值，否则工单的创建将失败。

更新现有的工单时，应用会将条目的“新部分”添加到公众_log字段（可配置，请参见下文）中。有关如何从消息中提取“新零件”的更多说明，请参见下文。

指定默认值

用于指定默认值的语法如下：

语法每行一个字段：

field_code：default_value

如果要初始化的字段是另一个对象的键（对于org_id，服务_id等字段），则可以指定目标对象的数字标识符（e.g. service_id:153）或其名称（e.g. org_id:Demo），只要名称是唯一的。

默认值在上述标准数据映射之后应用。因此，可以使用一些常量值覆盖默认的数据映射。

如果传入的发送邮件没有主题，则可以通过“默认标题（如果主题为空）”字段指定要为工单设置的默认标题。这与上面列出的默认值不同，因为仅当发送邮件没有主题时才使用此价值。如果“默认标题（如果主题为空）”，那么发送邮件将为系统一个默认的价值（“无主题”），因为标题是创建工单所必需的。

配置

可通过“管理工具”部分中的“传入发送邮件收件箱”菜单来管理每个邮箱的行为（向流程发送消息以及是否创建或更新工单）：

单击“创建新的邮件收件箱”以为邮件收件箱创建新的配置。这将显示以下表单：

邮箱配置

“邮箱配置”定义了应用如何连接到邮件收件箱：

领域	含义	样品价值
邮件服务器	邮件服务器的IP地址或标准主机名	10.153.20.142或pop3.mycompany.com
登录名	用于连接到邮箱的邮件账号的名称	test@mycompany.com
密码	上述账号的密码
协议	连接到邮件服务器的协议：POP3或IMAP。 如果需要将IMAP与SSL或TLS一起使用，请参阅下面的imap_options配置参数。	POP3
港口	连接到服务器的TCP端口。对于POP3，标准值为110（安全：995），对于IMAP，标准值为143（安全：993）	110
邮箱（用于IMAP）	IMAP邮箱（文件夹）用于扫描传入的邮件。如果省略，将扫描默认（根）邮箱。使用POP3协议时，将忽略此选项。	收 件 箱。文件夹.子文件夹
活性	如果设置为“是”，将对收件箱进行轮询。否则没有。	是
调试跟踪	使用此设置可跟踪与此收件箱相关的所有后台操作，以进行调试和故障排除。不建议长时间在生产中激活此选项，因为它会生成大量的输出，从而减慢服务器的速度。	没有

错误中的电子邮件

本部分定义了无法正确处理传入的发送邮件时的行为。发送邮件可以保存在邮箱中（并记住为“错误”，并且不再进行处理），也可以立即从邮箱中删除。此外，原始消息可以与有关发送邮件的原因的某些说明一起转发到管理员（作为附件）。

领域	含义	样品价值
行为	用错误处理的电子邮件是否应保留在邮箱中。如果是这样，该邮件将被标记为“错误”，不再处理，但仍可从邮箱中读取。	将邮件保留在邮箱中
转发电子邮件至	当发生发送邮件时，将发送邮件转发到的发送邮件地址。转发的消息包含有关发送邮件和原始发送邮件作为附件的一些说明。如果将此地址留空，则无法处理的传入电子邮件将直接从收件箱中删除，而无需另行通知。	itopadmin@mycompany.com
（从）	用作错误通知的“发送者”的IP地址。由于安全的原因，如果发件人地址不是已知地址，则许多邮件服务器不会中继邮件。	itopadmin@mycompany.com

传入电子邮件的行为

本部分定义了应用在处理传入电子邮件时的行为。

领域	含义	样品价值
行为	当新邮件到达收件箱时的行为。可能的值为： 创建或更新：如果找到匹配的工单，则创建一个新的工单或更新现有的工单 创建新的工单：每个新消息都会创建一个新的工单 更新现有票证：与现有工单不匹配的所有传入消息均被视为错误。	建立或更新
处理完发送邮件	成功处理传入的发送邮件之后要采用的性能或绩效：将发送邮件保留在邮件服务器上（直到关联的工单为已关闭或删除），或者立即删除发送邮件。	将发送邮件保留在邮件服务器上
工单类别	收到发送邮件时要创建或更新的票证类别。确保为iTop配置选择有效的类。	用户请求
工单默认值	“工单默认值”和“新人的默认值”的语法是： -每行初始化一个字段 --<field_code>:<constant_value>	service_id：联网
默认标题（如果主题为空）	如果传入的发送邮件的主题为空，则用作工单的标题的价值。如果将此字段保留为空，则系统将为供应默认价值（“无主题”）	空主题
标题模式	应用发送的每个通知在发送邮件的MessageID字段中都包含一个引用到“源”工单。发送邮件客户应用程序通常将此标识符存储在答复发送邮件的“ in-reply-to”或“ references”标头中。这是识别发送邮件消息与发送邮件相关的主要方法。如果传入消息中不存在此标头，则应用可以解析“主题”字段以查找给定的匹配项。此模式确定如何解析主题。此处指定的模式必须遵循[  /manual/en/reference.pcre.pattern.syntax.php]聚四氟乙烯[/url] 语法。	/R-([0-9]{6})/
刺激申请	state_code：stimulus_code的列表（每行一个），用于定义针对工单的给定状态要应用的激励（在更新工单之后）。例如，这对于自动重新分配处于“挂起”状态的工单很有用。	待处理：ev_assign

未知来电者

当发送邮件的发送者（发件人：）与应用中的已知发送邮件地址不对应时，本部分确定应用的行为。有两种可能性：

拒绝发送邮件：传入的发送邮件被视为错误，因此被转发到管理员或被删除。

创建一个新人：将基于发件人的发送邮件和下面定义的常数创建一个新的Person。

领域	含义	样品价值
呼叫人未知的情况下的行为	当传入发送邮件消息的发件人与应用中记录的任何人都不对应时该怎么办	创建一个新人
未知呼叫人拒绝回复	当未知的呼叫人行为设置为“拒绝发送邮件”时，对发件人的可选回复（留空时不发送消息）	空的
新人的默认值	用于初始化新Person的默认值。应用会自动使用邮件发送者的发送邮件地址填充发送邮件字段。所有其他必填字段必须使用此处提供的常量值进行初始化，否则新Person的创建将失败。	first_name:Unknown name:Caller org_id:Demo

其他联系人的行为

本部分确定应用与传入发送邮件的其他收件人（邮件的“收件人”和“抄送”中的人）的行为。可以指定何时将与iTop中有效的联系人对应的发送邮件地址添加到工单中（通过``联系人''选项卡）。始终忽略与iTop中的有效联系人不对应的发送邮件地址。

领域	含义	样品价值
添加更多联系人（收件人，抄送）	是否添加到：和抄送：发送邮件作为工单的附加联系人。可能的值为： *永远不会：不会添加其他联系人 *始终：创建和更新工单时将添加其他联系人 *当创建工单时：仅在创建新的工单时才添加其他联系人 *当更新工单时：仅当更新现有工单时才会添加其他联系人	决不

其他参数配置

除了通过使用应用的用户界面创建邮件收件箱对象来执行配置之外，配置文件中还提供了一些参数来完善调优的行为。

下列参数适用于所有邮件收件箱

对于配置参数body_parts_order推荐的价值istextthtml，texttplain。实际上，为了正确地对嵌入HTML email中的图像进行导入处理，必须处理发送邮件的HTML版本而不是纯文本版本。

      'recommended_max_allowed_packet' => 10485760,
      'introductory-patterns' =>  (
            0 => '/^le .+ a écrit :$/i',
            1 => '/^on .+ wrote:$/i',
            2 => '|^[0-9]{4}/[0-9]{1,2}/[0-9]{1,2} .+:$|',
      ),
      'multiline-delimiter-patterns' =>  (
            0 => '/\\RFrom: .+\\RSent: .+\\R/m',
            1 => '/\\R_+\\R/m',
            2 => '/\\RDe : .+\\R\\R?Envoyé : /m',
            3 => '/\\RDe : .+\\RDate d\'envoi : .+\\R/m',
            4 => '/\\R-----Message d\'origine-----\\R/m',
            5 => '/\\RExpéditeur: .+\\RDate:/m',
            6 => '/\\RDe : .+\\RDate : /m',
            7 => '/\\TO:.+\\RCC:/m',
      ),
      'delimiter-patterns' =>  (
            '/^>.*$/' => false,  // "false" remove only the line, "true" remove the rest of the message
      ),
      'big_files_dir' => '',
      'use_message_id_as_uid' => false, // Don't change this unless you know what you are doing!
      'images_minimum_size' => '100x20',
      'images_maximum_size' => '',
      'undesired-subject-patterns' =>  (
            0 => '/^Out Of Office/i',
            1 => '/^Automatic answer$/i',
            2 => '/^Réponse automatique:/',
      ),
      'undesired-purge-delay' => 7,
      'html-tags-to-remove' => (
           'blockquote' => (),
           // No class specified, remove any blockquote tag
           'div' => ('gmail_quote', 'moz-cite-prefix'),
           'pre' => ('moz-signature'),
      );

   ),

参数	含义	默认价值
调试	设置为true以打开调试输出	false
周期性	检查传入消息的时间间隔（以秒为单位）	30
body_parts_order	以逗号分隔的，有序的MIME类型列表，确定要填充的消息的首选部分，以填充工单的描述或public_log。为了将嵌入在HTML中的图像作为导入的嵌入式图像，必须在优先级的文本部分上处理发送邮件的HTML部分。因此，推荐的配置是text/html，text/plain。	text/html,text/plain
pop3_auth_options	POP3身份验证选项。可能的值为：'CRAM-MD5'，'APOP'，'PLAIN'，'登录名'，'用户'	USER
imap_options	其他IMAP选项。可能的值在这里列出：[  /manual/en/function.imap-open.php]IMAP标志[/url]. 例如，要使用SSL，您可以指定：数组（0⇒'imap'，2⇒'ssl'） 警告：请勿使用PHP3扩展名使用pop3标志连接到POP3邮箱。由于IMAP扩展程序的限制，因此无法使用！如果要连接到POP3服务器，请改用POP3协议。	array('imap')
exclude_attachment_types	检索附件时要排除的MIME类型数组	array('application/attachment')
html-tags-to-remove	3.0.0中的新功能。用于通过删除指定的标签来计算HTML消息的``新部分''。语法是tags_name => CSS类名数组。	see above
maximum_email_size	如果传入的发送邮件大于指定的大小，则该消息将被保存到big_files_dir中（如果已配置并从收件箱中删除）。与处理邮件收件箱时发生的其他“错误”一样，通知消息将发送到管理员。大小可以使用“短”符号指定：100K，3M，2G ...如果设置为零，则没有限制……如果没有足够的内存来解码传入的发送邮件，则PHP崩溃的风险。	10M
introductory-patterns	仅适用于纯文本电子邮件。在计算邮件的``新部分''时，将删除与该模式匹配且在邮件的``旧部分''之前的行。将此列表调整为适合您的本地化…和常用发送邮件客户方言。此处指定的模式必须遵循[  /manual/en/reference.pcre.pattern.syntax.php]聚四氟乙烯[/url] 语法。	see above
multiline-delimiter-patterns	仅用于纯文本电子邮件，仅用于工单更新的邮件。多行常规表达式模式用于计算消息的“新部分”。当一条消息是对另一条消息的“答复”时，这些模式中的每一个都确定消息的“旧部分”的开始。与此模式匹配的所有内容（以及此匹配之后的所有文本）都将被删除，成为“新零件”。所有模式都将连续测试。将使用提供更接近文本开头的匹配项的模式。根据您的本地化和常用发送邮件客户端的方言调整此列表。模式必须遵循[  /manual/en/reference.pcre.pattern.syntax.php]聚四氟乙烯[/url] 语法。	see above
delimiter-patterns	仅适用于纯文本电子邮件，并且仅适用于工单更新的邮件。如果没有multiline-delimiter-patterns匹配的情况，此常规表达式模式用于检测消息的“旧部分”开头的行。模式必须遵循[  /manual/en/reference.pcre.pattern.syntax.php]聚四氟乙烯[/url] 语法。	see above
big_files_dir	存放大于maximum_email_size的电子邮件的目录路径。如果未配置此目录，则仅在通知管理员之前删除电子邮件。
use_message_id_as_uid	布尔值。仅适用于IMAP连接。是否使用消息中的标识符（MessageID）而不是邮箱的唯一标识符（UID）来唯一标识已处理的消息。当服务器上的邮件的UID在会话之间更改时（例如使用Gmail），这对于变通方案问题很有用。如果切换此价值，请确保首先清空邮箱（并停止cron作业），因为更改设置后邮箱中存在的所有邮件将被视为新邮件并再次处理。	false
images_minimum_size	导入图像的最小尺寸。小于给定尺寸的图像将被忽略，并且不会作为附件导入。尺寸表示为string width x height（其中width和height是整数，以像素为单位）。	100×20
images_maximum_size	大于这些尺寸（例如1000×1000）的图像将被调整大小以适合给定尺寸。尺寸以字符串width x height表示（其中width和height是整数，以像素为单位）。注意仅当安装了PHP GD时此特性才可用。如果没有给出尺寸，则图像永远不会调整大小。
undesired-subject-patterns	一组常规表达式模式（作为PHP文本字符串），这些模式将用于测试传入发送邮件的主题。如果这些模式中的任何一个匹配，则发送邮件将被视为“不合需要的”并被拒绝（然后将采用与任何其他发送邮件情况相同的处理）。此处指定的模式必须遵循[  /manual/en/reference.pcre.pattern.syntax.php]聚四氟乙烯[/url] 语法。	array()
undesired-purge-delay	延迟天数以自动删除不需要的消息（0表示立即删除消息）	7
Recommendation_max_allowed_pa​​cket	如果数据库参数'max_allowed_pa​​cket'小于配置的值，则在“邮箱内容”屏幕上显示警告。	10*1024*1024

在配置文件中指定PCRE模式时，请确保将反斜杠字符加倍，因为必须在PHP乱码文本字符串中对反斜杠进行转义。

'itop-standard-email-synchro' =>  (

                'ticket_log' =>  (

                          'UserRequest' => 'public_log',

                          'Incident' => 'public_log',

                        ),

        ),

参数	含义	默认价值
ticket_log	一个关联数组（哈希），用于为工单的每个类定义在从传入消息更新工单时要设置的属性的代码。除非您修改了数据模型，否则不需要变更或价值。	see above

故障排除局限性

配置的每个邮件收件箱都对应一种类型的工单（即用户请求或突发事件，但不能同时兼有）。

通过php IMAP扩展名连接到POP3邮箱不起作用。在这种情况下，您必须通过PEAR :: NetSocket使用POP3配置。

没有验证邮件收件箱的目标类是iTop中的现有类。 （即，如果未安装事件管理模块，请不要尝试创建事件）。

仅当发送邮件零件的首选顺序配置为“ text/html，text/plain”（即HTML优先）时才支持嵌入式图像，这是所有新安装的默认设置。

在处理被视为对工单的更新的发送邮件时，扩展尝试提取消息的“新部分”（不包括先前消息中的内容）。但是，关于答复格式的依赖（其本身取决于所使用的发送邮件发送邮件软件）可能无法以可靠的方式提取此信息。在这种情况下，将使用发送邮件的全文。不幸的是，广泛使用的MS Outlook是此类发送邮件软件的示例，在该软件中，无法可靠地识别答复。有关如何调整此行为的说明，请参阅配置参数。

检查连接

一旦创建了邮件收件箱对象，就可以使用对象详细信息中的“邮箱内容”选项卡来检查应用是否可以正确连接到邮件对象并从中检索消息。

要深入检查邮箱的内容，最好使用真实邮件客户应用。此选项卡中提供的视图仅用于帮助解决连接问题。

该视图还允许对一组消息执行两种不同类型的操作活动：

• “重置状况”：对于标记为“错误”或“已处理”的消息，此状况将被重置，而发送邮件将再次被视为“新”，因此是下次cron.php运行时的候选处理。
• “删除发送邮件”：从邮箱中删除邮件。没有确认将被要求！
• “忽略发送邮件”：将新消息标记为“已忽略”以避免处理它们。
  

调试

3.0.15中的新增功能：无需激活每个已处理消息的调试模式，即可访问所使用的eml和消息特定的日志。

由于在后台中处理传入的电子邮件，因此并不总是很容易理解当未按预期处理工单时会发生什么。为了跟踪此后台任务的执行，可以使用几种级别的跟踪：

通过将“调试跟踪”字段设置为“是”，在处理邮箱时将生成更多跟踪。此跟踪将转到cron作业的输出，并且还将在数据库中捕获（限制为256 KB）。捕获的跟踪在邮件收件箱对象的“调试跟踪”选项卡中可见。

可以在配置文件中将模块compbodo-发送邮件-同步的配置设置调试设置为true。这将激活所有已配置邮件收件箱的更多跟踪。此附加跟踪仅出现在cron作业的配置中。

可以将cron作业传递给可选的参数--verbose = 1来为所有后台任务激活一些调试跟踪。此附加跟踪也进入了cron作业的输出中。

如果CTC作业尚未在后台中运行，则可以方便地从命令行手动运行它，以查看发生了什么情况：

php cron.php --auth_user=<user> --auth_pwd=<pwd> --verbose=1

包括3.0.17之前的已知问题：激活调试跟踪时，日志记录跟踪可能会截断UTF8字符，这会破坏MySQL的插入并停止当前的发送邮件处理。因此，请勿将此模式用作永久模式，而只能用于临时调试。

问题和答案

题：邮件不再处理了吗？

回答：可能是由于发送邮件消息的附件太大，最终可能导致数据库崩溃。在这种情况下，要快速流程以下电子邮件，请在iTop选项卡中打开“邮件收件箱”：找出有问题的发送邮件，可能是最早的``新''消息并进行检查，然后按``忽略''按钮。

为了限制上述情况，请检查allowed_max_packet，recommended_max_allowed_pa&#8203;&#8203;cket和maximum_email件_size参数之间的一致性。

可能是由于cron.php没有运行

题：错误中有特定的邮件，为什么？

回答：可能有多种原因，这导致在错误中标记邮件。浏览``传入的发送邮件收件箱''上的``邮箱内容''选项卡时，错误消息应向您说明原因。附件太大，邮件格式未知（例如已加密），…

邮件自动创建工单

名称：邮件自动创建工单

描述：扫描多个邮箱以创建或更新票证。

版本:3.1.1

发布:2019-11-22

itop-version-min：2.3.0

码：组合邮件到工单的自动化

州：稳定

备用名称：工单通过电子邮件创建

github-module1 1：[  /Combodo/combodo-email-synchro]https: mCombodoocombodo-email-synchro[/url]

github-module12：[  /Combodo/itop-standard-email-synchro]https: mCombodooitop-standard-email-synchro[/url]

扩散：iTop集线器

该组件的其他版本： [ ttps://www.itophub.io/wiki/page?id=extensions:ticket-from-email_2_2]2.2[/url], [ ttps://www.itophub.io/wiki/page?id=extensions:ticket-from-email_2_6]2.6.12[/url]

总结

该扩展程序在后台中运行，以扫描定义的邮件收件箱，并根据传入电子邮件的内容创建或更新票证。

在创建工单时，它会用发送邮件的内容填充工单的说明，设置呼叫人，客户，复制附件，添加联系人和许多其他字段…

在更新工单时，它将尽可能最佳地提取发送邮件的``最后答复''部分以更新工单的外部留言，复制附件，变更，工单的状况并添加联系人

特征

确定发件人是否是现有的Person（由其发送邮件找到），然后可以基于配置拒绝发送邮件中的发送邮件或创建新的Person。

确定是否必须根据iTop在发送邮件中添加的自定义标头（如果有回复）或标题中的可配置模式来创建或更新工单

使用POP3或IMAP协议连接到任何邮箱

邮件收件箱的交互式配置

流程以HTML或纯文本格式接收的电子邮件

支持事件和用户请求票证

工单的附件会自动转换为工单的附件（可以排除“危险”类型的附件）

自动检测重复的附件（例如签名图像）

已关闭，直到相应的工单被删除或被删除为止

如果处理发送邮件时发生错误，则手册重试

嵌入在HTML邮件中的图像也会在iTop中内嵌显示。

图像``太小''（低于可配置的尺寸）不会作为附件导入（以排除签名）

大于可配置尺寸的图像可以在上载到iTop之前自动调整大小

“内嵌图像”以缩小（可配置）的大小显示，并且可以通过单击它们来“放大”。

根据要针对发送邮件的主题进行测试的一组可配置模式，自动拒绝“自动答复”电子邮件

将发送邮件的其他收件人（收件人：和CC ：）添加为工单上的其他联系人（可配置）。联系人必须已经与确切的发送邮件存在，将不会创建它，而只是链接到发送邮件。

收到工单时，对变更和工单的状态施加激励（在工单的状态上可配置，依赖）。

添加新的触发器类型：触发器（通过邮件更新时），允许通过接收到的发送邮件通知工单更新的时间。

如果要限制通知'创建对象'（在对象上），限制为由发送邮件创建的工单，请在OQL中使用触发器='发送邮件'。

修订记录

发布日期	版本	注释
2019-11-22	3.1.1	*与iTop 2.7的兼容性 *通过Outlook修复错误的编码非中断空间 *更新DE翻译 *从引用检查传入的发送邮件的ID
2019-05-21	3.1.0	* Toocc中与当前邮箱相同的发送邮件中的联系人不再添加到工单中 *以“信封格式”处理签名的电子邮件 *存储所有消息的eml
2019-03-19	3.0.17	字典内部更新
2019-03-13	3.0.16	*在错误中存储eml以获取消息 *错误日志附有相应的消息
2018-12-19	3.0.15	*更新西班牙语翻译（感谢Miguel Turrubiates） * JQuery兼容性（自iTop 2.6起的JQuery 3） *修复用于设置呼叫人_id的OQL（感谢Jeffrey！SF＃1628） *修复无效的ES词典（“ U-8字符格式错误”错误） *当未配置任何刺激时，修复不必要的轨迹“刺激”配置中的无效行
2018-06-27	3.0.14	添加DE翻译
2018-03-01	3.0.13	修复某些电子邮件上的损坏（二进制）附件（无UTF8电子邮件和错误的内容传输编码格式）。
2018-02-21	3.0.12	启用2.5.0菜单覆盖功能。
2018-02-06	3.0.11	修复未正确指定内容处置时存储为嵌入式图像的附件。
2018-02-05	3.0.10	修复版本3.0.8中损坏的PHP 5.3兼容性
2018-01-29	3.0.9	使用OQL允许触发器到过滤器
2018-01-25	3.0.8	垃圾邮件标记为“不需要”，并在延迟后删除。在“未知呼叫人”的情况下，可以发送通用发送邮件答复。更新俄语翻译
2017-08-28	3.0.7	CSV导入期间重复的字典条目发生冲突（归因于MailInboxStandard类的行为和error_behavior）。
2017-03-31	3.0.6	如果无法将EmailReplica错误消息持久保存到DB中（例如，带有4个字节的Unicode字符），则该消息将引发致命的错误。现在，当无法保留默认错误消息时，我们将其保存，并将原始消息转储到IssueLog中。
2016-11-10	3.0.5	现在支持几个MailInbox扫描一个发送邮件地址邮箱，只要它们具有不同的文件夹（Mailbox（用于IMAP）属性）。另外，修复了3.0.x中引入的回归问题，use_message_id_as_uid配置参数不再起作用。
2016-10-05	3.0.4	在Lotus Notes发出的消息中支持嵌入式图像。
2016-08-26	3.0.3	修复了3.0.x中引入的回归：应用刺激无效。当发件人未知时（如果是工单更新），CRON被致命的错误中断。如果目标字段为纯文本，则为空描述。如果发送邮件是纯文本格式（使用雷鸟创建的发送邮件，并且没有富文本格式），则在案例日志中丢失CR
2016-08-09	3.0.2	如果未安装某些先决条件（PEAR或IMAP），请确保安装程序不会崩溃。
2016-07-26	3.0.1	支持向工单添加更多联系人（收件人：和抄送：）。当收到工单的更新时，能够施加激励（对变更的状态为工单的状态）。
2016-06-07	2.6.12	安全:只有管​​理员才能看到邮件收件箱的密码。回归：正确导入所有附件（如果不是图像，则不只是最后一个附件）。增强功能：从HTML转换为纯文本时保留超链接。
2016-02-02	2.6.11	仅限开发人员：修复了模块itop-standard-email-synchro.的替代品的兼容性问题。回归已在2.6.6中引入，除非您已开发出itop-标准-发送邮件-同步的替代产品，否则影响度的行为并不影响度的。
2015-10-28	2.6.10	自动拒绝“自动回复”电子邮件（请参见下面的不需要的主题模式）。支持无主题的电子邮件。
2015-09-29	2.6.9	正确初始化ENUM值（＃1102），防止更新与邮件收件箱中配置的票证不同类的票证。
2015-03-09	2.6.8	修复了images_maximum_size参数的处理，以防止在不调整图像大小时发生错误。修复了检测HTML回复中的blockquote标签的模式。
2015-03-05	2.6.7	忽略小图像时禁止显示警告。变更是“ body_parts_order”的默认价值。
2015-01-21	2.6.6	支持内联图像，“太小”图像的过滤和“大”图像的大小调整。
2014-08-01	2.6.5	新的配置参数至变通方案以及带有GmaillIMAP的问题。
2014-07-21	2.6.4	增强功能：允许在处理电子邮件后立即从服务器删除电子邮件。 “ TriggerOnMailUpdate”的法语翻译，并使触发器可导入。
2014-06-04	2.6.3	增强功能：支持创建变更和问题票证。
2014-04-09	2.6.2	错误修复，以支持名称中包含反斜杠的邮箱（可能使用IMAP发生）。
2014-04-08	2.6.1	增加德语本地化（尽管不是100％翻译）。
2014-03-05	2.6.0	改进了错误的处理（例如，保留邮箱中的错误，重试手册），并在回复消息时更好地解码了消息的“新部分”。增强HTML到文本的转换，修复了“ Outlook的转发邮件”作为附件的处理。
n/a	2.5	支持多个邮件收件箱。通过iTop用户界面的邮件收件箱的交互式配置。电子邮件的解析解码的各种改进
2013-07-22	2.2	“原有”版本仅支持一个邮箱（从iTop配置文件配置）。该版本的文档可在这里找到：通过电子邮件创建工单（原有）

要求

PHP 5.2.1+和[  /manual/en/book.imap.php]IMAP扩展[/url]如果要连接到IMAP服务器，则启用此功能，或者梨：：网络插座（iTop随附其自己的PEAR :: POP3副本）如果要连接到POP3服务器。

使用有效邮箱到POP3或IMAP服务器的连接。

[ ttps://www.itophub.io/wiki/page?id=latest:admin:cron]cron.php文件[/url]必须正在运行才能启用传入电子邮件的处理。

对于调试跟踪，[  /manual/en/book.mbstring.php]PHP的MBString[/url]必须安装。

要调整大图的大小，[  /manual/en/book.image.php]菲律宾盾[/url]必须安装。

在 Ubuntu 16.04 上，可以使用 php-pear、php-net-socket 和 php-imap 包安装先决条件：

sudo apt-get install php-pear php-net-soc


安装和升级

在iTop的“扩展”文件夹中展开zip文件的内容。

兼容性问题：对于低于2.4.0的iTop版本，有一个[  :8082/bin/view/2/2.6/2.6%C2%B727/#itop_before_240]特殊安装/升级流程[/url].

确保Web服务器具有足够的权利来读取“扩展”文件夹中的所有文件。

启动安装程序，并在提示您输入要安装的扩展的列表时，从列表中选中“邮件自动创建工单”

在Ubuntu（16.04之前的版本）上使用IMAP：软件包php5-imap不启用IMAP模块。要在Ubuntu上使用IMAP模块，必须先安装它，然后显式启用它：

sudo apt-get install php5-imapsudo php5enmod imap

无论如何，您可能需要重新启动Web服务器才能将新安装的软件包放入账号：

sudo service apache2 restar


用法
数据映射

从传入的发送邮件消息创建新的工单时，应用自动填充工单的以下字段：

标题=邮件主题

说明=邮件正文

呼叫人（caller_id）=邮件的发件人（由发送邮件地址标识）

组织（（org_id）=呼叫人的组织

来源（如果工单上存在此字段）='mail'

必须通过“工单默认值”设置为工单的任何其他必填字段提供默认（即常量）值，否则工单的创建将失败。

更新现有的工单时，应用会将条目的“新部分”添加到公众_log字段（可配置，请参见下文）中。有关如何从消息中提取“新零件”的更多说明，请参见下文。

指定默认值

用于指定默认值的语法如下：

语法每行一个字段：

field_code：default_value

如果要初始化的字段是另一个对象的键（对于org_id，服务_id等字段），则可以指定目标对象的数字标识符（e.g. service_id:153）或其名称（e.g. org_id:Demo），只要名称是唯一的。

默认值在上述标准数据映射之后应用。因此，可以使用一些常量值覆盖默认的数据映射。

如果传入的发送邮件没有主题，则可以通过“默认标题（如果主题为空）”字段指定要为工单设置的默认标题。这与上面列出的默认值不同，因为仅当发送邮件没有主题时才使用此价值。如果“默认标题（如果主题为空）”，那么发送邮件将为系统一个默认的价值（“无主题”），因为标题是创建工单所必需的。

配置

可通过“管理工具”部分中的“传入发送邮件收件箱”菜单来管理每个邮箱的行为（向流程发送消息以及是否创建或更新工单）：

单击“创建新的邮件收件箱”以为邮件收件箱创建新的配置。这将显示以下表单：

邮箱配置

“邮箱配置”定义了应用如何连接到邮件收件箱：

领域	含义	样品价值
邮件服务器	邮件服务器的IP地址或标准主机名	10.153.20.142或pop3.mycompany.com
登录名	用于连接到邮箱的邮件账号的名称	test@mycompany.com
密码	上述账号的密码
协议	连接到邮件服务器的协议：POP3或IMAP。 如果需要将IMAP与SSL或TLS一起使用，请参阅下面的imap_options配置参数。	POP3
港口	连接到服务器的TCP端口。对于POP3，标准值为110（安全：995），对于IMAP，标准值为143（安全：993）	110
邮箱（用于IMAP）	IMAP邮箱（文件夹）用于扫描传入的邮件。如果省略，将扫描默认（根）邮箱。使用POP3协议时，将忽略此选项。	收 件 箱。文件夹.子文件夹
活性	如果设置为“是”，将对收件箱进行轮询。否则没有。	是
调试跟踪	使用此设置可跟踪与此收件箱相关的所有后台操作，以进行调试和故障排除。不建议长时间在生产中激活此选项，因为它会生成大量的输出，从而减慢服务器的速度。	没有

错误中的电子邮件

本部分定义了无法正确处理传入的发送邮件时的行为。发送邮件可以保存在邮箱中（并记住为“错误”，并且不再进行处理），也可以立即从邮箱中删除。此外，原始消息可以与有关发送邮件的原因的某些说明一起转发到管理员（作为附件）。

领域	含义	样品价值
行为	用错误处理的电子邮件是否应保留在邮箱中。如果是这样，该邮件将被标记为“错误”，不再处理，但仍可从邮箱中读取。	将邮件保留在邮箱中
转发电子邮件至	当发生发送邮件时，将发送邮件转发到的发送邮件地址。转发的消息包含有关发送邮件和原始发送邮件作为附件的一些说明。如果将此地址留空，则无法处理的传入电子邮件将直接从收件箱中删除，而无需另行通知。	itopadmin@mycompany.com
（从）	用作错误通知的“发送者”的IP地址。由于安全的原因，如果发件人地址不是已知地址，则许多邮件服务器不会中继邮件。	itopadmin@mycompany.com

传入电子邮件的行为

本部分定义了应用在处理传入电子邮件时的行为。

领域	含义	样品价值
行为	当新邮件到达收件箱时的行为。可能的值为： 创建或更新：如果找到匹配的工单，则创建一个新的工单或更新现有的工单 创建新的工单：每个新消息都会创建一个新的工单 更新现有票证：与现有工单不匹配的所有传入消息均被视为错误。	建立或更新
处理完发送邮件	成功处理传入的发送邮件之后要采用的性能或绩效：将发送邮件保留在邮件服务器上（直到关联的工单为已关闭或删除），或者立即删除发送邮件。	将发送邮件保留在邮件服务器上
工单类别	收到发送邮件时要创建或更新的票证类别。确保为iTop配置选择有效的类。	用户请求
工单默认值	“工单默认值”和“新人的默认值”的语法是： -每行初始化一个字段 --<field_code>:<constant_value>	service_id：联网
默认标题（如果主题为空）	如果传入的发送邮件的主题为空，则用作工单的标题的价值。如果将此字段保留为空，则系统将为供应默认价值（“无主题”）	空主题
标题模式	应用发送的每个通知在发送邮件的MessageID字段中都包含一个引用到“源”工单。发送邮件客户应用程序通常将此标识符存储在答复发送邮件的“ in-reply-to”或“ references”标头中。这是识别发送邮件消息与发送邮件相关的主要方法。如果传入消息中不存在此标头，则应用可以解析“主题”字段以查找给定的匹配项。此模式确定如何解析主题。此处指定的模式必须遵循[  /manual/en/reference.pcre.pattern.syntax.php]聚四氟乙烯[/url] 语法。	/R-([0-9]{6})/
刺激申请	state_code：stimulus_code的列表（每行一个），用于定义针对工单的给定状态要应用的激励（在更新工单之后）。例如，这对于自动重新分配处于“挂起”状态的工单很有用。	待处理：ev_assign

未知来电者

当发送邮件的发送者（发件人：）与应用中的已知发送邮件地址不对应时，本部分确定应用的行为。有两种可能性：

拒绝发送邮件：传入的发送邮件被视为错误，因此被转发到管理员或被删除。

创建一个新人：将基于发件人的发送邮件和下面定义的常数创建一个新的Person。

领域	含义	样品价值
呼叫人未知的情况下的行为	当传入发送邮件消息的发件人与应用中记录的任何人都不对应时该怎么办	创建一个新人
未知呼叫人拒绝回复	当未知的呼叫人行为设置为“拒绝发送邮件”时，对发件人的可选回复（留空时不发送消息）	空的
新人的默认值	用于初始化新Person的默认值。应用会自动使用邮件发送者的发送邮件地址填充发送邮件字段。所有其他必填字段必须使用此处提供的常量值进行初始化，否则新Person的创建将失败。	first_name:Unknown name:Caller org_id:Demo

其他联系人的行为

本部分确定应用与传入发送邮件的其他收件人（邮件的“收件人”和“抄送”中的人）的行为。可以指定何时将与iTop中有效的联系人对应的发送邮件地址添加到工单中（通过``联系人''选项卡）。始终忽略与iTop中的有效联系人不对应的发送邮件地址。

领域	含义	样品价值
添加更多联系人（收件人，抄送）	是否添加到：和抄送：发送邮件作为工单的附加联系人。可能的值为： *永远不会：不会添加其他联系人 *始终：创建和更新工单时将添加其他联系人 *当创建工单时：仅在创建新的工单时才添加其他联系人 *当更新工单时：仅当更新现有工单时才会添加其他联系人	决不

其他参数配置

除了通过使用应用的用户界面创建邮件收件箱对象来执行配置之外，配置文件中还提供了一些参数来完善调优的行为。

下列参数适用于所有邮件收件箱

对于配置参数body_parts_order推荐的价值istextthtml，texttplain。实际上，为了正确地对嵌入HTML email中的图像进行导入处理，必须处理发送邮件的HTML版本而不是纯文本版本。

      'recommended_max_allowed_packet' => 10485760,
      'introductory-patterns' =>  (
            0 => '/^le .+ a écrit :$/i',
            1 => '/^on .+ wrote:$/i',
            2 => '|^[0-9]{4}/[0-9]{1,2}/[0-9]{1,2} .+:$|',
      ),
      'multiline-delimiter-patterns' =>  (
            0 => '/\\RFrom: .+\\RSent: .+\\R/m',
            1 => '/\\R_+\\R/m',
            2 => '/\\RDe : .+\\R\\R?Envoyé : /m',
            3 => '/\\RDe : .+\\RDate d\'envoi : .+\\R/m',
            4 => '/\\R-----Message d\'origine-----\\R/m',
            5 => '/\\RExpéditeur: .+\\RDate:/m',
            6 => '/\\RDe : .+\\RDate : /m',
            7 => '/\\TO:.+\\RCC:/m',
      ),
      'delimiter-patterns' =>  (
            '/^>.*$/' => false,  // "false" remove only the line, "true" remove the rest of the message
      ),
      'big_files_dir' => '',
      'use_message_id_as_uid' => false, // Don't change this unless you know what you are doing!
      'images_minimum_size' => '100x20',
      'images_maximum_size' => '',
      'undesired-subject-patterns' =>  (
            0 => '/^Out Of Office/i',
            1 => '/^Automatic answer$/i',
            2 => '/^Réponse automatique:/',
      ),
      'undesired-purge-delay' => 7,
      'html-tags-to-remove' => (
           'blockquote' => (),
           // No class specified, remove any blockquote tag
           'div' => ('gmail_quote', 'moz-cite-prefix'),
           'pre' => ('moz-signature'),
      );

   ),

参数	含义	默认价值
调试	设置为true以打开调试输出	false
周期性	检查传入消息的时间间隔（以秒为单位）	30
body_parts_order	以逗号分隔的，有序的MIME类型列表，确定要填充的消息的首选部分，以填充工单的描述或public_log。为了将嵌入在HTML中的图像作为导入的嵌入式图像，必须在优先级的文本部分上处理发送邮件的HTML部分。因此，推荐的配置是text/html，text/plain。	text/html,text/plain
pop3_auth_options	POP3身份验证选项。可能的值为：'CRAM-MD5'，'APOP'，'PLAIN'，'登录名'，'用户'	USER
imap_options	其他IMAP选项。可能的值在这里列出：[  /manual/en/function.imap-open.php]IMAP标志[/url]. 例如，要使用SSL，您可以指定：数组（0⇒'imap'，2⇒'ssl'） 警告：请勿使用PHP3扩展名使用pop3标志连接到POP3邮箱。由于IMAP扩展程序的限制，因此无法使用！如果要连接到POP3服务器，请改用POP3协议。	array('imap')
exclude_attachment_types	检索附件时要排除的MIME类型数组	array('application/attachment')
html-tags-to-remove	3.0.0中的新功能。用于通过删除指定的标签来计算HTML消息的``新部分''。语法是tags_name => CSS类名数组。	see above
maximum_email_size	如果传入的发送邮件大于指定的大小，则该消息将被保存到big_files_dir中（如果已配置并从收件箱中删除）。与处理邮件收件箱时发生的其他“错误”一样，通知消息将发送到管理员。大小可以使用“短”符号指定：100K，3M，2G ...如果设置为零，则没有限制……如果没有足够的内存来解码传入的发送邮件，则PHP崩溃的风险。	10M
introductory-patterns	仅适用于纯文本电子邮件。在计算邮件的``新部分''时，将删除与该模式匹配且在邮件的``旧部分''之前的行。将此列表调整为适合您的本地化…和常用发送邮件客户方言。此处指定的模式必须遵循[  /manual/en/reference.pcre.pattern.syntax.php]聚四氟乙烯[/url] 语法。	see above
multiline-delimiter-patterns	仅用于纯文本电子邮件，仅用于工单更新的邮件。多行常规表达式模式用于计算消息的“新部分”。当一条消息是对另一条消息的“答复”时，这些模式中的每一个都确定消息的“旧部分”的开始。与此模式匹配的所有内容（以及此匹配之后的所有文本）都将被删除，成为“新零件”。所有模式都将连续测试。将使用提供更接近文本开头的匹配项的模式。根据您的本地化和常用发送邮件客户端的方言调整此列表。模式必须遵循[  /manual/en/reference.pcre.pattern.syntax.php]聚四氟乙烯[/url] 语法。	see above
delimiter-patterns	仅适用于纯文本电子邮件，并且仅适用于工单更新的邮件。如果没有multiline-delimiter-patterns匹配的情况，此常规表达式模式用于检测消息的“旧部分”开头的行。模式必须遵循[  /manual/en/reference.pcre.pattern.syntax.php]聚四氟乙烯[/url] 语法。	see above
big_files_dir	存放大于maximum_email_size的电子邮件的目录路径。如果未配置此目录，则仅在通知管理员之前删除电子邮件。
use_message_id_as_uid	布尔值。仅适用于IMAP连接。是否使用消息中的标识符（MessageID）而不是邮箱的唯一标识符（UID）来唯一标识已处理的消息。当服务器上的邮件的UID在会话之间更改时（例如使用Gmail），这对于变通方案问题很有用。如果切换此价值，请确保首先清空邮箱（并停止cron作业），因为更改设置后邮箱中存在的所有邮件将被视为新邮件并再次处理。	false
images_minimum_size	导入图像的最小尺寸。小于给定尺寸的图像将被忽略，并且不会作为附件导入。尺寸表示为string width x height（其中width和height是整数，以像素为单位）。	100×20
images_maximum_size	大于这些尺寸（例如1000×1000）的图像将被调整大小以适合给定尺寸。尺寸以字符串width x height表示（其中width和height是整数，以像素为单位）。注意仅当安装了PHP GD时此特性才可用。如果没有给出尺寸，则图像永远不会调整大小。
undesired-subject-patterns	一组常规表达式模式（作为PHP文本字符串），这些模式将用于测试传入发送邮件的主题。如果这些模式中的任何一个匹配，则发送邮件将被视为“不合需要的”并被拒绝（然后将采用与任何其他发送邮件情况相同的处理）。此处指定的模式必须遵循[  /manual/en/reference.pcre.pattern.syntax.php]聚四氟乙烯[/url] 语法。	array()
undesired-purge-delay	延迟天数以自动删除不需要的消息（0表示立即删除消息）	7
Recommendation_max_allowed_pa​​cket	如果数据库参数'max_allowed_pa​​cket'小于配置的值，则在“邮箱内容”屏幕上显示警告。	10*1024*1024

在配置文件中指定PCRE模式时，请确保将反斜杠字符加倍，因为必须在PHP乱码文本字符串中对反斜杠进行转义。

'itop-standard-email-synchro' =>  (

                'ticket_log' =>  (

                          'UserRequest' => 'public_log',

                          'Incident' => 'public_log',

                        ),

        ),

参数	含义	默认价值
ticket_log	一个关联数组（哈希），用于为工单的每个类定义在从传入消息更新工单时要设置的属性的代码。除非您修改了数据模型，否则不需要变更或价值。	see above

故障排除局限性

配置的每个邮件收件箱都对应一种类型的工单（即用户请求或突发事件，但不能同时兼有）。

通过php IMAP扩展名连接到POP3邮箱不起作用。在这种情况下，您必须通过PEAR :: NetSocket使用POP3配置。

没有验证邮件收件箱的目标类是iTop中的现有类。 （即，如果未安装事件管理模块，请不要尝试创建事件）。

仅当发送邮件零件的首选顺序配置为“ text/html，text/plain”（即HTML优先）时才支持嵌入式图像，这是所有新安装的默认设置。

在处理被视为对工单的更新的发送邮件时，扩展尝试提取消息的“新部分”（不包括先前消息中的内容）。但是，关于答复格式的依赖（其本身取决于所使用的发送邮件发送邮件软件）可能无法以可靠的方式提取此信息。在这种情况下，将使用发送邮件的全文。不幸的是，广泛使用的MS Outlook是此类发送邮件软件的示例，在该软件中，无法可靠地识别答复。有关如何调整此行为的说明，请参阅配置参数。

检查连接

一旦创建了邮件收件箱对象，就可以使用对象详细信息中的“邮箱内容”选项卡来检查应用是否可以正确连接到邮件对象并从中检索消息。

要深入检查邮箱的内容，最好使用真实邮件客户应用。此选项卡中提供的视图仅用于帮助解决连接问题。

该视图还允许对一组消息执行两种不同类型的操作活动：

• “重置状况”：对于标记为“错误”或“已处理”的消息，此状况将被重置，而发送邮件将再次被视为“新”，因此是下次cron.php运行时的候选处理。
• “删除发送邮件”：从邮箱中删除邮件。没有确认将被要求！
• “忽略发送邮件”：将新消息标记为“已忽略”以避免处理它们。
  

调试

3.0.15中的新增功能：无需激活每个已处理消息的调试模式，即可访问所使用的eml和消息特定的日志。

由于在后台中处理传入的电子邮件，因此并不总是很容易理解当未按预期处理工单时会发生什么。为了跟踪此后台任务的执行，可以使用几种级别的跟踪：

通过将“调试跟踪”字段设置为“是”，在处理邮箱时将生成更多跟踪。此跟踪将转到cron作业的输出，并且还将在数据库中捕获（限制为256 KB）。捕获的跟踪在邮件收件箱对象的“调试跟踪”选项卡中可见。

可以在配置文件中将模块compbodo-发送邮件-同步的配置设置调试设置为true。这将激活所有已配置邮件收件箱的更多跟踪。此附加跟踪仅出现在cron作业的配置中。

可以将cron作业传递给可选的参数--verbose = 1来为所有后台任务激活一些调试跟踪。此附加跟踪也进入了cron作业的输出中。

如果CTC作业尚未在后台中运行，则可以方便地从命令行手动运行它，以查看发生了什么情况：

php cron.php --auth_user=<user> --auth_pwd=<pwd> --verbose=1

包括3.0.17之前的已知问题：激活调试跟踪时，日志记录跟踪可能会截断UTF8字符，这会破坏MySQL的插入并停止当前的发送邮件处理。因此，请勿将此模式用作永久模式，而只能用于临时调试。

问题和答案

题：邮件不再处理了吗？

回答：可能是由于发送邮件消息的附件太大，最终可能导致数据库崩溃。在这种情况下，要快速流程以下电子邮件，请在iTop选项卡中打开“邮件收件箱”：找出有问题的发送邮件，可能是最早的``新''消息并进行检查，然后按``忽略''按钮。

为了限制上述情况，请检查allowed_max_packet，recommended_max_allowed_pa&#8203;&#8203;cket和maximum_email件_size参数之间的一致性。

可能是由于cron.php没有运行

题：错误中有特定的邮件，为什么？

回答：可能有多种原因，这导致在错误中标记邮件。浏览``传入的发送邮件收件箱''上的``邮箱内容''选项卡时，错误消息应向您说明原因。附件太大，邮件格式未知（例如已加密），…