Documentation Center

创建联系人导入文件

您可以将带分隔符的文件(如 CSV 文件)中包含的联系人导入到通讯簿中。该节介绍了用于导入联系人的导入文件的要求:

  • 必须使用支持的格式来分隔文件中的数据(请参阅下文)
  • 如果文件包含 unicode 字符,就必须使用 UTF-8 对文件进行编码
  • 文件中第一行数据必须包含各种数据列的名称:
    • 至少有一列必须包含用作识别联系人的唯一方式的标识符(请参阅下文的联系人身份识别
    • 您想要导入其值的其他列必须映射到正在使用的扩展详细信息字段
    • 要在系统管理级别将联系人导入到(所有联系人)节点,该文件必须包含可以映射到 GROUP_KEYVALUE 字段的列(行值必须指定现有通讯簿的值)
  • OutboundEmail.xml 配置文件中配置要导入的日志记录。

联系人身份识别

联系人附带一组默认的扩展详细信息字段,其中 IDENTIFICATION_KEYIMPORT_SOURCE 组合用作识别各个联系人的唯一方式。实施文档介绍了更改和配置联系人身份识别字段以及添加联系人扩展详细信息(由数据库管理员执行)的流程。

指定默认映射

在配置文件 OutboundEmail.xml<ContactDetails> 区块中,您必须为联系人指定扩展详细信息字段。这些字段反映了在 Audience Manager 数据库中定义的扩展详细信息。要提供默认映射,请在文件中指定列名称,这些列名称应与为扩展详细信息字段指定的列名称相同。有关配置的更多信息,请参阅 SDL Tridion Sites 产品文档中的安装主题。

除了扩展详细信息字段之外,联系人功能还为每个联系人提供一组固定字段,如果这些字段未映射,系统会为其分配默认值。您可以通过创建具有下表中名称的列来确保映射默认有效:

字段可能的值默认值
SUBSCRIBE_STATUS_ID
  • 1 = 已取消订阅
  • 2 = 已订阅
  • 3 = 选择加入
2
EMAIL_TYPE
  • 1 = Html
  • 2 = 文本
  • 3 = 多部分
1
BOUNCE_STATUS_ID
  • 1 = 没有问题
  • 2 = 暂时性问题
  • 3 = 持久性问题
1
ENABLEDTrueFalsetrue
GROUP_KEYVALUE现有通讯簿的

文件格式

下表介绍了如何设置联系人导入文件中数据的格式:

格式选项说明支持的值
字段分隔符指定如何分隔字段/列。
  • ,(逗号)
  • ;(分号)
  • :(冒号)
  • (Tab)(制表符)
  • |(竖线)
字符串分隔符指定如何分隔包含逗号、双引号或换行符的字段。
  • "(双引号)
  • '(单引号)
小数分隔符指定用于标记十进制数字的整数部分和小数部分之间边界的符号。
  • .(小数点)
  • ,(十进制逗号)
组分隔符指定在千位分隔符之前或之后使用的符号(方便阅读较大的数字)。
  • '(撇号)
  • ,(逗号)
  • .(句点)
  • (空格)(空白区)
日期格式指定日期格式。您必须根据 Audience Manager 数据库支持的数据格式来设置日期格式:
  • MS SQL - .NET Framework 支持的日期格式
  • Oracle - Oracle 支持的日期格式
行分隔符指定如何分隔行
  • 回车符
  • 换行符
  • 回车符/换行符对