对接 Yeastar P 系列软件版 与 Microsoft SQL

对接 Yeastar P 系列软件版 和 Microsoft SQL 后，PBX 收到来电时，会自动查询 Microsoft SQL 数据库中的联系人，并在匹配到联系人时显示来电者姓名。

使用要求

确保 PBX 满足以下要求：
  • 订阅服务：通讯录专业版
  • 固件版本：83.16.0.70 或更高版本
注： 对 Microsoft SQL 没有特定要求，所有版本的 Microsoft SQL Server 都可以与 Yeastar P 系列软件版 集成。

步骤一、启用 Microsoft SQL 集成

  1. 登录 PBX 管理网页，进入 通讯录 > 企业联系人。
  2. 在页面顶部，点击 同步联系人。

  3. 开启 启用 Microsoft SQL 集成，然后完成以下配置。

    项目 说明
    服务器地址 根据实际情况填写 Microsoft SQL Server 的地址。
    • 如果 Microsoft SQL Server 使用默认端口 1433，则填写服务器的 IP 地址或域名。

      例如，填写 192.168.26.19。

    • 如果 Microsoft SQL Server 使用的不是默认端口，则填写服务器的 IP 地址/域名和端口。

      例如，填写 192.168.26.19:2233。
    数据库名称 填写数据库的名称。
    超时时长 (秒) 设置连接 Microsoft SQL Server 的超时时间。
    用户 填写用于连接数据库的用户名。
    密码 填写用于连接数据库的密码。
    自动匹配联系人过滤条件

    填写用于匹配联系人来显的 SELECT 语句，格式为 select ${MAP} from {schema_name}.{table_name} where {condition_to filter_number}。

    示例：select ${MAP} from testpbx.contacts where businumber like CONCAT('%', ${NUMBER}, '%')
    • select ${MAP}：指定数据表列名，此设置决定了来显展示信息。
      注： ${MAP} 将被替换为 PBX 的 字段匹配 栏中相对应的字段值 (如名字、姓氏或两者)。
    • from testpbx.contacts：指定数据表，将从此表中查询联系人。

      必须包含两部分名称 (schema 名称和表名称)，格式为 {schema_name}.{table_name}。

    • where businumber like CONCAT('%', ${NUMBER}, '%')：查询 businumber 中的所有记录。

步骤二、映射 Yeastar P 系列软件版 和 Microsoft SQL 联系人字段

  1. 滚动到 字段匹配 栏。
  2. 映射来显字段。

    1. 在 联系人 ID、名字 和 办公号码 对应的字段中，填写 Microsoft SQL 联系人表中相对应的列名。
      注： 本例将办公号码作为 号码匹配条件，因此映射 办公号码 字段。你需要根据实际情况映射号码字段。

      当来电与数据库中的联系人相匹配时，将会显示联系人的名字。

    2. 可选： 如果要同时显示联系人姓氏，勾选 姓氏，然后在 Microsoft SQL 字段中填写相应的列名。
  3. 如果你想要将 Microsoft SQL 联系人同步到 PBX，勾选并映射你想要同步的字段。

  4. 点击 保存。

执行结果

  • Yeastar P 系列软件版 已连接 Microsoft SQL 数据库。

  • 当来电与数据库中的联系人相匹配时，将会显示联系人的名字。

后续操作

如果你要允许分机用户通过 Linkus 客户端呼叫 Microsoft SQL 联系人，你需要同步 Microsoft SQL 数据库的联系人到 PBX。

更多信息，请参见 设置同步 Microsoft SQL 联系人。