功能简介 亿联话机本地联系人可以⽤来存储联系人。本地联系人最多可以存储1000个联系人和48个群组。 可以使⽤本地联系⼈⽂件⼀个接⼀个地或批量添加联系⼈和组。亿联话机⽀持* .xml和* .csv格式的联系⼈⽂件。 编辑本地联系人文件 模版下载 前往 联系人 > 本地联系人 > 导出，选择XML或者CSV方式。 根据导出的文件格式进行填充内容。 image.png XML转换表 XML提供了转义功能， 用于包含难以直接包含的字符。例如， 字符“<”和“＆”是关键语法标记， 可能永远不会出现在内容中。XML具有五个预定义的实体。 XML转换表如下所示： image.png contact.xml文件属性 下表列出了可⽤于在本地联系人⽂件中添加组或联系人的元素和属性。我们建议你不要编辑这些元素和属性。 元素 属性 说明 group display_name 指定组名。 ⽐如， All Contacts， Blacklist 或者 Friend ring 指定群组的铃声。 系统铃声： Auto Silent.wav Splash.wav RingN.wav（整数N的范围是1到8） 自定义铃声： Name.wav（自定义铃声应提前上传） Contact display_name 指定联系人姓名。比如 Jim⼀些字符（例如“”）是关键语法标记， 可能永远不会出现在内容中。非标准名称格式可能会导致XML解析失败。你可以改⽤转义序列。错误：display_name="Hurrell " & " Mclean"正确1: display_name="Hurrell & Mclean"正确2: display_name="Hurrell & Mclean"说明：联系人姓名不能为空。 office_number 指定办公室号码或 EDK宏字符串。 mobile_number 指定⼿机号码或 EDK宏字符串。 other_number 指定其他号码或 EDK宏字符串。 line 为该联系人指定⼀条注册线路以进行呼叫。取值范围-1到15;-1代表自动（第⼀条注册上的线路）；0到15代表线路1~线路16。 ring 指定此联系人的铃声。 系统铃声： Auto Silent.wav Splash.wav RingN.wav（整数N的范围是1到8） 自定义铃声： XX.wav（例如， Music.wav， 应提前上传自定义铃声） group_id_name 指定联系人添加到的组。 内置组： 所有联系人， ⿊名单 自定义组： XXX（例如，朋友） default_photo 内置头像： Resource：头像名称 自定义头像： Config：自定义头像名称 auto_divert 指定转移呼叫的⽬的地号码。 自定义contact.xml文件示例 打开本地联系人文件。 要添加组，请在⽂件中添加<group display_name="" ring=""/ >。每个规则都从新行开始。 要添加联系人，请在⽂件中添加<contact display_name="" office_number="" mobile_number=""other_number="" line="" ring="" group_id_name="" default_photo="" auto_divert = “”/ >。每个规则都从新行开始。 在双引号内指定值。例如: <?xml version="1.0" encoding="utf-8"?> <root_group> <group display_name="All Contacts" ring="" /> <group display_name="Blacklist" ring="" /> </root_group> <root_contact> <contact display_name="Test1" office_number="2510" mobile_number="2511" other_number="3610" line="1" ring="" group_id_name="All Contacts" default_photo="" auto_divert="" /> <contact display_name="Test2" office_number="3510" mobile_number="3511" other_number="3620" line="2" ring="" group_id_name="Blacklist" default_photo="" auto_divert="" /> </root_contact> 保存更改并将此文件放置到配置服务器。 本地联系人文件导入 功能简介 你可以上传本地联系人⽂件以⼀次添加多个联系人， 也可以上传联系人资源， 例如联系人头像和图标图⽚。 网页配置 前往 联系人 > 本地联系人 > 导入 > 导入联系人。 image.png 配置参数 local_contact.data.url local_contact.data.delete local_contact.photo.url local_contact.icon_image.url local_contact.image.url local_contact.data_photo_tar.url local_contact.icon.url features.local_directory_number.type features.local_directory.overwrite M7参数 取值范围 出厂默认值 功能说明 local_contact.data.url 511个字符 空 上传本地联系人xml文件。 举例： local_contact.data.url = http://192.168.10.25/contact.xml 如果将“static.auto_provision.local_contact.backup.enable”设置为1（启用），则从预配服务器下载的联系人文件“contact.xml”中的联系人无效。 local_contact.data.delete 字符串 空 配置清空本地联系人路径。 举例： local_contact.data.delete = http://localhost/all local_contact.photo.url 511个字符 空 上传联系人头像，单张图片。 联系人头像的格式必须为*.png， *.jpg， *.bmp， *.jpeg。 联系人头像文件应提前上传到配置服务器。 举例： local_contact.photo.url = tftp://192.168.10.25/Photo.jpg local_contact.icon_image.url 511个字符 空 配置上传单张联系人列表头像图片URL。 联系人列表头像的格式必须为*.png， .jpg， .bmp， *.jpeg。 联系人列表头像文件应提前上传到配置服务器。 举例： local_contact.icon_image.url = tftp://192.168.10.25/Photo.jpg local_contact.image.url 511个字符 空 上传联系人头像包，tar文件。 联系人头像的格式必须为*.png， *.jpg， *.bmp， *.jpeg。 应将联系人头像文件预先压缩为TAR文件，然后将其放置到配置服务器中。 举例： local_contact.image.url = tftp://192.168.10.25/photo.tar local_contact.data_photo_tar.url 511个字符 空 上传联系人xml文件和头像包，头像包要先压缩成photo.tar，再和xml文件一起压缩成tar文件。 联系人所需的所有头像均应预先压缩为TAR文件。 举例： local_contact.data_photo_tar.url = tftp://192.168.10.25/Contact.tar TAR文件的名称必须为photo.tar（区分大小写），而联系人XML文件的名称必须为ContactData.xml（区分大小写）。 local_contact.icon.url 511个字符 空 上传联系人列表头像包，tar文件。联系人图标的格式必须为*.png， *.jpg， *.bmp。 应将联系人图标文件预先压缩为TAR文件，然后将其放置到配置服务器中。 举例： local_contact.icon.url = tftp://192.168.10.25/photo2.tar features.local_directory_number.type 1-无限制，可以输入字符串类型。2-只能输入纯数字。 1 用于配置手动添加本地联系人时所需的输入内容。 features.local_directory.overwrite 1-覆盖0-不覆盖 1 用于配置在导入本地联系人地址簿时是否覆盖话机上现有的地址簿。 如果已配置将本地联系⼈备份到服务器，则话机将从服务器的备份路径下载联系⼈⽂件“<MAC>-contact.xml”，并在本地⽬录列表中显示下载的联系⼈。从部署服务器下载的本地联系⼈⽂件“contact.xml”中的联系人无效。 本地联系人备份 Yealink 话机支持将所有本地联系人存储到名为 <MAC>-contact.xml 的联系人文件中。你可以将此文件备份到服务器，以避免数据丢失。一旦联系人更新，话机将自动将此文件上传到配置服务器或特定服务器。如果服务器上存在联系人文件，此文件将被覆盖。话机将在自动配置期间根据其 MAC 地址请求从服务器下载 <MAC>-contact.xml 文件。联系人文件以 IP 话机的 MAC 地址命名。例如，如果 IP 话机的 MAC 地址是 00156574B150，则联系人文件的名称为 00156574B150-contact.xml（大写）。 MAC 地址是分配给每个话机的唯一12位序列号。你可以从话机背面的条形码上获取到。 配置参数 下表列出了你可以用来备份本地联系人的参数。 static.auto_provision.local_contact.backup.enable static.auto_provision.local_contact.backup.path static.auto_provision.custom.upload_method M7参数 取值范围 出厂默认值 功能说明 static.auto_provision.local_contact.backup.enable 0-禁用，话机不会将联系人文件 <MAC>-contact.xml 上传到服务器，因此 IP 话机在自动配置期间会从由参数“local_contact.data.url 或 local_contact.data_photo_tar.url”配置的访问 URL 下载 contact.xml 中的联系人。1-启用，话机在每次联系人更新时将联系人文件 <MAC>-contact.xml 上传到由参数“static.auto_provision.local_contact.backup.path”配置的特定路径；并在自动配置期间根据其 MAC 地址从特定路径下载 <MAC>-contact.xml 中的联系人。 0 启用或禁用话机在每次联系人更新时将 <MAC>-contact.xml 文件上传到服务器，并在自动配置期间从服务器下载 <MAC>-contact.xml 文件。 这不会影响联系人头像/图标文件的下载。 static.auto_provision.local_contact.backup.path 字符串 空 配置话机上传/下载 <MAC>-contact.xml 文件的路径或 URL。如果留空，话机会连接到配置服务器 URL，并上传/下载联系人文件 <MAC>-contact.xml。 例子： static.auto_provision.local_contact.backup.path = http://192.168.1.20/contact一旦联系人更新，话机将联系人文件上传到指定路径 “http://192.168.1.20/contact”。在自动配置期间，话机从指定路径 “http://192.168.1.20/contact” 下载联系人文件 <MAC>-contact.xml。 说明：仅当“static.auto_provision.local_contact.backup.enable”设置为 1（启用）时有效。 static.auto_provision.custom.upload_method 0-PUT1-POST 0 配置话机将 <MAC>-local.cfg 文件、<MAC>-calllog.xml 文件或 <MAC>-contact.xml 文件上传到配置服务器的方式（仅限 HTTP/HTTPS 服务器）。