简介 远程地址簿是一个集中维护的话机簿，存储在远程服务器上。用户只需要远程地址簿的访问URL。话机可以建立与远程服务器的连接，下载话机簿，然后在话机上显示远程地址簿条目。 亿联话机支持最多5个远程地址簿。远程地址簿是可定制的。 我们建议你从远程服务器下载少于5000个远程联系人。 远程地址簿文件定制 亿联话机支持远程地址簿联系人定制。 你可以使用提供的模板文件（Menu.xml和Department.xml）一次添加多个联系人和/或在话机之间共享联系人。 你可以参考以下模板： html<YealinkIPPhoneDirectory> <DirectoryEntry><Name>Tom</Name><Telephone>66000</Telephone></DirectoryEntry> <DirectoryEntry><Name>Jensen</Name><Telephone>29000</Telephone><Telephone>42</Telephone></DirectoryEntry> <DirectoryEntry><Name>Phil</Name><Telephone>49880</Telephone></DirectoryEntry> <DirectoryEntry><Name>Boss</Name><Telephone>10.10.32.147</Telephone></DirectoryEntry> </YealinkIPPhoneDirectory> 远程地址簿文件元素 亿联话机支持两个模板文件：Menu.xml和Department.xml。 Menu.xml文件定义了远程地址簿的组/部门。Department.xml文件定义了部门/组的联系人列表，这些列表嵌套在Menu.xml文件中。 下表列出了你可以在远程地址簿文件中使用的元素来添加组或联系人。我们建议你不要编辑这些元素。 模板 元素 有效值 Department.xml <DirectoryEntry ><Name > 联系人姓名</Name ><Telephone > 联系人号码</Telephone ><DirectoryEntry > 在部门/组中添加联系人：在<Name >和</Name >之间指定联系人姓名；在<Telephone >和</Telephone>之间指定联系人号码。 Menu.xml <MenuItem><Name>部门</Name><URL>部门URI</URL></MenuItem> 添加联系人部门/组文件：在<Name>和</Name>之间指定部门/组名称；在<URL>和</URL>之间指定部门/组访问URL。 Menu.xml <SoftKeyItem><Name>#</Name><URL>http://10.2.9.1:99/Department.xml</URL></SoftKeyItem> 为按键指定部门/组文件：在<Name>和</Name>之间指定*键、#键或数字键；在<URL>和</URL>之间指定部门/组访问URL。 定制远程地址簿文件 在Department.xml文件中添加联系人。每个联系人从新行开始。 例如， <DirectoryEntry> <Name>Lily</Name> <Telephone>123456</Telephone> </DirectoryEntry> <DirectoryEntry> <Name>Jim</Name> <Telephone>654321</Telephone> </DirectoryEntry> 你可以创建多个 department.xml 文件，重命名这些文件并在这些文件中指定多个联系人。例如，Market.xml 包含联系人 Lily 和 Jim，Propaganda.xml 包含其他联系人，等等。 保存这些文件并将它们放置在配置服务器上。 复制部门文件的 URL 并在 Menu.xml 文件中指定它们。 例如， <MenuItem> <Name > Market</Name> <URL > http://192.168.0.1:99/Market.xml</URL> </MenuItem> <SoftKeyItem> <Name>1</Name> <URL>http://192.168.0.1:99/Propaganda.xml</URL> </SoftKeyItem> 保存Menu.xml文件并将其放置在配置服务器上。 远程地址簿配置 通过网页用户界面设置 在网页用户界面，选择：联系人 > 远程地址簿。 配置参数 remote_phonebook.data.X.url remote_phonebook.data.X.name remote_phonebook.data.X.username remote_phonebook.data.X.password remote_phonebook.display_name features.remote_phonebook.enable features.remote_phonebook.flash_time features.remote_phonebook.enter_update_enable remote_phonebook.assignment.enable handset.X.remote_phonebook_access 参数 允许值 默认值 描述 remote_phonebook.data.X.url[1] 最多511个字符的URL 空 它配置远程地址簿的访问URL。 远程地址簿文件的大小应小于1.5 M。 remote_phonebook.data.X.name[1] 最多99个字符的字符串 空 它配置远程地址簿项的显示名称。 remote_phonebook.data.X.username[1] 字符串 空 它配置用于访问远程地址簿X的用户名。 remote_phonebook.data.X.password[1] 字符串 空 它配置用于访问远程地址簿X的密码。 remote_phonebook.display_name 最多99个字符的字符串 空 它配置远程地址簿的显示名称。如果留空，“Remote Phone Book”将作为显示名称。 features.remote_phonebook.enable 0-禁用1-启用 0 它启用或禁用话机为来电或去电执行远程地址簿搜索并在话机屏幕上显示匹配结果。 features.remote_phonebook.flash_time 0, 从3600到1296000的整数 21600 它配置多长时间刷新一次远程地址簿的本地缓存。如果设置为3600，话机将每3600秒（1小时）刷新一次远程地址簿的本地缓存。如果设置为0，话机将不会刷新远程地址簿的本地缓存。 features.remote_phonebook.enter_update_enable 0-禁用1-启用 0 配置每次进⼊远程地址簿是否会进⾏更新操作, 即重新从服务器获取数据。 remote_phonebook.assignment.enable 0-禁用1-启用 0 它配置是否可以分配远程地址簿。 handset.X.remote_phonebook_access[2] 从1到10的整数 X 它设置话机可以访问的远程地址簿。多个值用逗号分隔。 仅当“remote_phonebook.assignment.enable”设置为1时有效。 [1] X是地址簿ID。 [2] X是话机ID。X=1-10。 示例：配置远程地址簿 以下示例显示了远程地址簿的配置。 定制“Department.xml”和“Menu.xml”文件，然后将这些文件放置在配置服务器“http://192.168.10.25”上。 示例 remote_phonebook.data.1.url = http://192.168.10.25/Menu.xml remote_phonebook.data.1.name = Yealink remote_phonebook.data.2.url = http://192.168.10.25/Market.xml remote_phonebook.data.2.name = Market Autop 自动部署完成后，你可以导航到菜单 > 通讯录 > 远程地址簿, 直接从其话机访问公司通讯录。 错误和解决方案 错误 描述 解决方案 0x0009000001060000远程目录下载失败 远程地址簿下载失败。 参考相应的错误代码找到解决方案。 如果上述方法未能解决问题，请提供工作场景中的诊断文件进行比较，以便亿联 FAE 进行进一步分析。 0x0009000001060001 下载文件格式错误 XML文件格式错误。 将XML文件格式更改为正确的格式。更多信息，请参见https://www.cnblogs.com/codingmengmeng/p/7245625.html。 0x0009000001060002 下载限制超出 话机性能限制。你下载的联系人文件超出了最大限制。 一般来说，彩屏话机允许下载的文件大小最多为1.5 M。然而，黑白LCD显示屏的话机允许下载的文件大小最多为768KB。因此，你需要控制要下载的文件大小，例如，用户上传的资源文件。 0x0009000001060003身份验证错误 话机配置错误。XML文件身份验证失败。 选择以下方法之一为话机配置正确的身份验证信息： 设置用户名和密码：remote_phonebook.data.x.username= 和 remote_phonebook.data.x.password= 在URL中带上身份验证信息。例如，http://user:password@IP/RemotePhonebook.xml 如果上述方法未能解决问题，请提供工作场景中的诊断文件进行比较，以便亿联 FAE 进行进一步分析。 0x0009000001060004 网络不可用 网络错误，导致下载失败。 使用话机 Ping 功能检查话机和服务器之间的网络是否可用。 0x0009000001060005 加载远程目录错误 话机错误。话机在加载联系人时出现问题。 亿联 FAE 将进一步分析并尽快给你一个解决方案。