Enterprise Vault™ 设置 SMTP 归档
关于 X-Kvs X-HEADER
此部分介绍特殊的 Enterprise Vault X-HEADER,第三方应用程序或 MTA 可以在邮件中添加 X-HEADER 来覆盖策略和目标设置。这些 X-HEADER 以 X-Kvs 开头。Enterprise Vault 会识别和处理 X-Kvs 标题,因此无需将其添加到策略属性的 X-HEADER 列表中。
如果邮件中包含同一 X-HEADER 的多个实例,Enterprise Vault 将只使用第一个,而忽略其他实例。
使用添加到策略的 X-HEADER 列表中的 X-HEADER 时,Enterprise Vault 对这些特殊 X-HEADER 的名称和值区分大小写。
X-Kvs-ArchiveId 提供了用于存储邮件的归档的 ID。 示例:X-Kvs-ArchiveId:160EEB78D4253BE40AA8EBEBA09C7DFEE1210000evserver1。
此标题可用来标识一个与为邮件目标地址配置的归档所不同的归档。
例如,向目标地址 journal1@example.com 发送了一封邮件,为该目标地址配置的归档为 journal1。 如果将 X-Kvs-ArchiveId 添加到邮件中,Enterprise Vault 会将邮件存储到 X-HEADER 中标识的归档,而不是 journal1。
您可以使用 Enterprise Vault X-HEADER、X-Kvs-IndexData 执行以下操作:
为 X-HEADER 添加多个值。使用标准 X-HEADER 时,每个 X-HEADER 只能添加一个值。
在一个 X-HEADER 中添加多个自定义索引属性和属性值。
使用 XML 指定标题值。XML 元素以及属性名称和值区分大小写。
以下 X-Kvs-IndexData 示例添加了具有多个值的 X-HEADER、X-ExampleCorp-Dept:
X-Kvs-IndexData: <ARCHIVED_ITEM version="1.0"><PROPSET NAME="EVXHDR"> <PROP NAME=" X-ExampleCorp-Dept RESULTS="true" SEARCH="true"> <VALUE>Sales</VALUE><VALUE>Marketing</VALUE></PROP></PROPSET> </ARCHIVED_ITEM>
Enterprise Vault 将 X_Header 添加到保留的索引属性集 EVXHDR。如果添加其他自定义索引属性,则应为这些属性指定其他属性集。适用于自定义索引属性的属性集名称将成为公司名称或应用程序名称。下列属性集名称将保留:
保管库
EnterpriseVault
任何以 EV 开头的属性集名称;例如,EVXHDR。
KVS
Veritas
在以下示例中,使用 X-Kvs-IndexData 向邮件添加两个自定义索引属性 Dept 和 Region:
X-Kvs-IndexData: <ARCHIVED_ITEM version="1.0"><PROPSET NAME="ChatApp"> <PROP NAME="Dept" type="string" RESULTS="true" SEARCH="true">Sales</PROP> <PROP NAME="Region" type="string" RESULTS="true" SEARCH="true">EMEA</PROP> </PROPSET></ARCHIVED_ITEM>
在此示例中,将应用程序名称 ChatApp 作为这两个自定义索引属性的属性集名称。
第一个属性是 ChatApp.Dept,值为“Sales”。此属性是可搜索且可检索的。
第二个属性是 ChatApp.Region,值为“EMEA”。此属性也是可搜索且可检索的。
在以下示例中,使用 X-Kvs-IndexData 添加具有多个值的自定义索引属性 ChatApp.Region:
X-Kvs-IndexData: <ARCHIVED_ITEM version="1.0"><PROPSET NAME="ChatApp"> <PROP NAME="Region" type="string" RESULTS="true" SEARCH="true"> <VALUE>USA</VALUE><VALUE>EMEA</VALUE><VALUE>ASIA</VALUE></PROP> </PROPSET></ARCHIVED_ITEM>
在此示例中,ChatApp.Region 属性的值有 “USA”、“EMEA”和“ASIA”。此属性是可搜索且可检索的。
建议尽可能减小标题大小。如果要求使用属性的默认值,则可省略标题的属性。表:XML 属性的默认值 列出了 XML 属性的默认值。
表:XML 属性的默认值
属性 |
默认值 |
---|---|
RESULTS |
"False" |
SEARCH |
"true" |
type |
"string" |
在上述示例中,要求使用 SEARCH 和 type 属性的默认值,因此可以省略以下属性:
X-Kvs-IndexData: <ARCHIVED_ITEM version="1.0"><PROPSET NAME="ChatApp"> <PROP NAME="Region" RESULTS="true"><VALUE>USA</VALUE><VALUE>EMEA</VALUE> <VALUE>ASIA</VALUE></PROP></PROPSET></ARCHIVED_ITEM>
在搜索已使用 X-Kvs-IndexData 添加的自定义索引属性时,以 property_set_name 格式指定属性。property_name,例如 ChatApp.Region。
在搜索已使用 X-Kvs-IndexData 添加的 X-HEADER 时,以 EVXHDR 格式指定 X-HEADER。X-Header_name,例如 EVXHDR.X-ExampleCorp-Dept。
请注意以下有关在 X-Kvs-IndexData 标题中指定的值的注意事项:
根据 RFC 822 中的语法规则,XML 值可以折叠。
为支持在 XML 中使用国际字符,必须按 RFC 2047 中指定的方式编码整个标题值。
以下示例显示了使用 UTF-8 字符集和 BASE64 编码时标题值可能的形式:
X-Kvs-IndexData: =?UTF-8"?B?PEFSQ0hJVkVEX0lURU0+PFBST1BTRVQgTkFNRT0i Q2hhdEFwcCI+PFBST1AgTkFNRT0iRGVwdCI+PFZBTFVFPlNhbGVzPC9WQUxVRT48L1BS T1A+PC9QUk9QU0VUPjwvQVJDSElWRURfSVRFTT4=?=
不支持在 XML 中仅对某些词语进行编码。同样,指定 XML prolog 中的编码还不足以指定标题值。例如,
X-Kvs-IndexData: <ARCHIVED_ITEM version="1.0" encoding="UTF-8"> ... </ARCHIVED_ITEM>
X-Kvs-MessageType 可标识邮件的类型。 示例:X-Kvs-MessageType:Bloomberg。
此标题用于在归档邮件时覆盖 Enterprise Vault 分配给该邮件的 Vault.MsgType 属性值。默认情况下,如果使用 SMTP 归档来归档邮件,Enterprise Vault 会将值 SMTP.Mail 分配给 Vault.MsgType 属性。
Vault.MsgType 属性的值可以用于搜索应用程序(例如 Discovery Accelerator),以筛选要搜索的邮件。例如,如果使用 SMTP 归档来归档 Bloomberg 邮件,那么需要将邮件类型标识为 Bloomberg。如果邮件类型没有设置为 Bloomberg,则这些邮件将不会列入 Discovery Accelerator 对 Bloomberg 邮件的搜索范围。
X-Kvs-OriginalLocation 标识内容来源中的位置来设置邮件。 原始位置是指内容来源中邮件所在的文件夹, 可将其设置为顶级文件夹或文件夹路径的名称。 示例:X-Kvs-OriginalLocation:CompanyA\ProductB\CustomerC。
您可以将此 X-HEADER 添加到一个邮件,从而为该邮件指定其他归档文件夹。如果邮件包含以上显示的 X-HEADER 示例且目标归档类型可以包含文件夹,则任务会将邮件存储在以下位置中:
顶级文件夹:CompanyA
子文件夹:ProductB
子文件夹:CustomerC
如果不存在这种文件夹结构,任务会在存储邮件时创建文件夹。
仅在目标归档类型可以包含文件夹时,此 X-HEADER 才有效。
在 SMTP 日记记录和 SMTP 组日记记录中,如果归档类型可以包含文件夹,则 SMTP 归档任务会将邮件归档到“收件箱”中。如果邮件包含 X-Kvs-OriginalLocation 标头且归档可以包含文件夹,则此任务会将邮件存储在 X-Header 指示的位置中而非“收件箱”中。
通常情况下,用于 SMTP 邮箱日记记录的归档类型可以包含文件夹,例如 Exchange 邮箱或互联网邮件归档。此任务会将邮件存储在“收件箱”或“已发送项目”文件夹或者两者中,具体取决于目标地址是发件人、收件人还是两者。如果邮件包含 X-Kvs-OriginalLocation 标头,则此任务会将邮件存储在 X-HEADER 指示的位置中而非“收件箱”或“已发送项目”文件夹中。
X-Kvs-RetentionCategory 提供了保留类别 ID,以分配给邮件。 示例:X-Kvs-RetentionCategory:1505EB2CDB9C6AA44B30335E4A785F98C1b10000evserver1。
此标题可用来标识一个与为邮件目标地址配置的保留类别所不同的保留类别。
例如,将邮件发送到目标地址 journal1@example.com,为该目标地址配置的保留类别为 7years。 如果将 X-Kvs-RetentionCategory 添加到邮件中,Enterprise Vault 会应用 X-HEADER 中标识的保留类别,而不是 7years。