归档文件到 Microsoft SharePoint

Yeastar P 系列 IPPBX 支持定期或随时将系统的通话录音和备份文件归档到 Microsoft SharePoint。本文介绍如何将 Microsoft SharePoint 添加为归档服务器，并创建任务来归档所需的文件。

使用要求

PBX 的固件为 37.21.0.117 或更高版本。

限制条件

  • 归档服务器：10 个
  • 归档任务：200 个

操作说明

要将 PBX 的通话录音和备份文件归档到 Microsoft SharePoint 的特定文件夹中，你需要完成以下操作：
  1. 在 Microsoft 上准备符合要求的账户和资源。
    • 准备具备全局管理员权限的 Microsoft 账户
    • 在 Azure 门户创建应用程序 API 凭证 (租户 ID、客户端 ID、客户端密钥) ，用于验证 PBX 发送的文件归档请求
    • 在 SharePoint 站点创建文件夹，用于存储 PBX 文件
  2. 在 PBX 上配置归档服务器和归档任务。

当到达归档任务的执行时间时，PBX 将使用配置的 API 凭证向 Microsoft SharePoint 发送文件归档请求。如果请求有效，指定的文件就会归档到 Microsoft SharePoint 的文件夹中。

步骤一、在 Microsoft Entra 租户中注册一个应用程序

  1. 使用 Microsoft 全局管理员账户登录 Azure 门户。
  2. 在搜索栏，搜索并选择 Microsoft Entra ID 服务，进入组织目录。

  3. 注册一个应用程序。
    1. 在组织目录的左侧导航栏，进入 管理 > 应用注册，接着点击 新注册。

    2. 在 注册应用程序 页，填写一个名称，帮助你识别该应用程序，接着点击 注册。

    3. 记录应用程序(客户端) ID 和目录(租户) ID。

  4. 创建客户端密码。
    1. 在 Microsoft Entra 应用程序的左侧导航栏，进入 证书和密码 > 客户端密码，接着点击 新客户端密码。

    2. 配置客户端密码，接着点击 添加。

    3. 记录客户端密码的 值。
      重要： 客户端密码只显示一次，必须在离开此页面前记录下客户端密码的值。否则你需要重新创建一个密码。

步骤二、为 Microsoft Entra 应用程序配置权限

  1. 在 Microsoft Entra 应用程序的左侧导航栏，进入 API 权限，接着点击 添加权限。

  2. 在 选择 API 页面，进入 Microsoft API > Microsoft Graph。

  3. 添加应用程序所需的权限，以允许应用程序读取和更改站点中的文件和信息。
    1. 点击 应用程序权限，搜索并选择 Sites.ReadWrite.All 权限，接着点击 添加权限。

    2. 点击 授予管理员同意，同意向应用程序授予所需的权限。

    3. 在弹出的对话框中，点击 是。

      权限的 状态 栏显示，说明已成功为应用程序授予权限。

步骤三、在 Microsoft SharePoint 创建文件夹

注： 归档的文件只能存储在 SharePoint 容器中的文件夹内。该示例演示如何在文档库中创建文件夹。若已有符合条件的文件夹，或希望在其他容器中创建文件夹，可按需创建和使用。
  1. 转到 SharePoint 网站，在要创建新文件夹的位置打开 SharePoint 文档库。
  2. 点击右上角的 创建或上传，接着从下拉列表中选择 文件夹。

  3. 在 名称 栏，填写一个名称帮助你识别该文件夹，接着点击 创建。

    文件夹已创建并显示在列表中。

步骤四、在 PBX 上添加 Microsoft SharePoint 为归档服务器

  1. 登录 PBX 管理网页，进入 系统 > 归档。
  2. 在 归档任务 页签下，点击 归档服务器。

  3. 设置 Microsoft SharePoint 为归档服务器。
    1. 点击 添加。
    2. 在弹出的窗口中，完成以下设置。

      设置 说明
      名称 填写一个名称，帮助你识别此服务器。
      服务器类型 选择 SharePoint。
      应用 (客户端) ID 填写你从 Microsoft Entra 租户获取到的应用程序(客户端) ID。
      租户 ID 填写你从 Microsoft Entra 租户获取到的目录(租户) ID。
      客户端密钥 填写你从 Microsoft Entra 租户获取到的客户端密钥。
    3. 点击 保存。

      Microsoft SharePoint 已添加为归档服务器，并显示在列表中。

  4. 点击 关闭窗口。

步骤五、在 PBX 上添加任务以将文件归档到 Microsoft SharePoint

  1. 在 归档任务 页签下，点击 添加。
  2. 在 任务配置 栏，配置归档任务的基础设置。

    设置 说明
    名称 填写一个名称，帮助你识别此任务。
    文件类型 选择 录音文件 或 备份文件。
    数据范围 指定要归档的文件的时间范围。
    注： 支持一次性归档最多 31 天内的数据。
    同步频率 设置文件归档到 Microsoft SharePoint 的频率。
    注： 数据量过大会消耗 PBX 的 CPU，因此建议在空闲时间执行归档任务。
    • 一次性：保存归档任务后，系统立即归档文件。
    • 每天：从下拉列表中选择一个时间。系统每天在指定的时间归档文件。
    • 每周：从下拉列表中选择一周的某一天，并指定时间。系统每周在指定的时间归档文件。

    • 每月：从下拉列表中选择一个日期，并指定时间。系统每月在指定的时间归档文件。
    录音文件格式 选择录音文件的下载格式。
    注：
    • 仅当该任务用于归档录音文件时，才会出现此项。
    • 系统中的所有录音文件将以所选格式进行下载归档。
  3. 在 存储配置 栏，选择归档服务器并完成相关配置。
    设置 说明
    归档服务器 选择 已添加的 Microsoft SharePoint。
    选择文件夹/路径 选择你要归档文件的文件夹。
    跳过已归档文件 可选。设置是否跳过已归档的文件。
    注： 仅当你设置归档录音文件时，才会出现此项。
    • 若启用，系统不会再次归档已归档的文件。
    • 若禁用，系统会再次归档已归档的文件。重复归档后，文件的存储位置会更新，但已归档到第三方服务器的文件不会被删除。
    归档后删除本地文件 可选。设置归档后是否删除本地文件。
    注： 仅当你设置归档录音文件时，才会出现此项。
    • 若启用，归档后删除本地文件。PBX 管理端和 Linkus 客户端仍可播放和下载，但第三方平台及 Dynamics 365 将无法继续播放或下载。
    • 若禁用，归档后保留本地文件。
  4. 可选： 设置归档文件的保留规则。
    注：
    • 仅当设置定期归档任务时，才会显示此项。
    • 确保 Microsoft 账号 具备删除归档服务器资源的权限。

    设置 说明
    保留方式

    设置归档文件的保留方式。

    • 按数量保留：设置归档服务器存储路径下最多保留的文件/文件夹数量。

      如果选择此项，在 保留上限 (个) 栏填写数量。

      当文件/文件夹数量超过上限时，系统会自动删除最早的文件/文件夹。

    • 按天保留：设置归档服务器存储路径下数据的最长保留天数。

      如果选择此项，在 保留上限 (天) 栏填写天数。

      系统会自动删除超过设定天数的文件/文件夹。

      注：
      • 保留时间从文件归档到归档服务器时开始计算，而非从文件在 PBX 上生成的时间起算。
      • 保留时间按精确 24 小时周期计算，而非按日历日计算。
    保留上限 根据选择的保留方式，设置最大文件/文件夹数量或最大保留天数。
    保留单位 选择保留方式的计算单位。
    • 文件夹：按归档服务器上创建的归档文件夹进行保留计算。
    • 文件：按归档服务器上的单个归档文件进行保留计算。
  5. 点击 保存。

执行结果

指定的文件将立即/在预约的时间被归档到 Microsoft SharePoint 的指定文件夹中。
注： 为避免影响系统性能，系统一次只执行一个任务。如果有多个任务，这些任务会排队执行。
你可以通过以下方式查看归档结果。
在 PBX 上查看归档结果
登录 PBX 管理网页，进入 系统 > 归档 > 同步记录。如果此任务的 结果 栏显示 成功，表明指定文件已成功归档到 Microsoft SharePoint。

注： 任务执行失败会触发 文件归档失败 事件；你可以点击 重试任务。

在 Microsoft SharePoint 上查看归档结果
在 Microsoft SharePoint，进入创建的文件夹。如果指定文件出现在列表中，表明归档成功。