功能简介
远程地址簿是一个集中维护的话机簿,存储在远程服务器上。用户只需要远程地址簿的访问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。
文件定制
在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文件并将其放置在配置服务器上。
设置远程地址簿
网页配置
前往 联系人 > 远程地址簿。
image.png
参数配置
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
remote_phonebook.assignment.enable
handset.X.remote_phonebook_access
M7参数 取值范围 出厂默认值 功能说明
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,话机将不会刷新远程地址簿的本地缓存。
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。
错误和解决方案
错误 描述 解决方案
0x0009000001060000远程目录下载失败 远程地址簿下载失败。 1. 参考相应的错误代码找到解决方案。2. 如果上述方法未能解决问题,请提供工作场景中的诊断文件进行比较。
0x0009000001060001 下载文件格式错误 XML文件格式错误。 将XML文件格式更改为正确的格式。更多信息,请参见https://www.cnblogs.com/codingmengmeng/p/7245625.html。
0x0009000001060002 下载限制超出 话机性能限制。你下载的联系人文件超出了最大限制。 一般来说,彩屏话机允许下载的文件大小最多为1.5 M。然而,黑白LCD显示屏的话机允许下载的文件大小最多为768KB。因此,你需要控制要下载的文件大小,例如,用户上传的资源文件。
0x0009000001060003身份验证错误 话机配置错误。XML文件身份验证失败。 1. 选择以下方法之一为话机配置正确的身份验证信息:- 设置用户名和密码:remote_phonebook.data.x.username= 和 remote_phonebook.data.x.password=- 在URL中带上身份验证信息。例如,http://user:password@IP/RemotePhonebook.xml2. 如果上述方法未能解决问题,请提供工作场景中的诊断文件进行比较,以便Yealink FAE进行进一步分析。
0x0009000001060004 网络不可用 网络错误,导致下载失败。 使用话机Ping功能检查话机和服务器之间的网络是否可用。
0x0009000001060005 加载远程目录错误 话机错误。话机在加载联系人时出现问题。