WDAP 修改附件大小阈值配置教程

适用版本：WDAP v1.2.7 所需角色：系统管理员 功能位置：管理控制台 → 文件预览 → 转换规则 配套视频：WCP修改附件大小阈值配置教程.mp4

---

一、适用场景

WDAP（WCP 文档应用平台）的"附件预览"功能会按照预设的转换规则，对用户上传的 Office、PDF、图片、音视频等附件进行格式转换，以便在浏览器中直接预览。

每条转换规则都包含一个文件大小阈值区间（最小文件 / 最大文件）。当附件大小超出"最大文件"阈值时，系统将不再为其生成预览，以避免大文件转换耗时过长、占用过多服务端资源。

当业务需要预览更大的附件（例如 95 MB 以上的 PPT）时，就需要由系统管理员调整对应规则的"最大文件"阈值。

---

二、操作步骤

步骤 1：进入管理控制台

1. 使用系统管理员账号登录 WDAP。
2. 在首页右上角，将鼠标移到 “系统管理员” 用户名上。
3. 在下拉菜单中点击 “管理控制台”。

步骤 2：打开"转换规则"列表

进入管理控制台后，在左侧"功能菜单"中依次展开：

文件预览  →  转换规则 Copy

点击 “转换规则”，右侧会列出当前系统所有的附件转换规则，包括 doc、docx、ppt、pptx、xls、xlsx、pdf、png、jpg、mp3、mp4、zip 等格式。

每条规则展示以下关键列：

步骤 3：定位需要修改的规则

• 可使用顶部的 “原文件扩展名” 下拉框筛选具体格式。
• 也可在 “规则名称” 输入框中按关键字搜索。
• 列表底部支持翻页，如果目标规则不在第一页，请翻到下一页查找。

例如要放开 PPT 文件的预览上限，找到名称类似 ppt:PDF预览文件-To-图片册 的规则，其"最大文件"默认为 95mb。

步骤 4：修改"最大文件"阈值

1. 勾选目标规则前面的复选框（一次只能选中一条进行修改）。
2. 点击列表上方工具栏的 “修改” 按钮，弹出"修改"对话框。
3. 在表单中找到 “最大文件” 输入框：
   • 单位为字节（b）。
   • 例如 95 MB 对应 100000000（约 95.37 MB），可按业务需要改大或改小。
4. 修改完成后点击对话框下方的 “保存”。

⚠️ 单位换算提醒 系统中 1 mb = 1000000 b（即按 10⁶ 计算，非 1024²）。 若希望把上限调整到 200 MB，请填入 200000000。 请勿随意设为超大值，否则单个转换任务可能长时间占用 OpenOffice / 转换器进程，影响其他附件预览。

步骤 5：确认保存

• 点击"保存"后，系统会弹出确认框： “操作已成功，是否关闭当前页面？”
• 点击 “确定” 关闭弹窗，返回转换规则列表。

步骤 6：验证新阈值已生效

回到转换规则列表，找到刚才修改的那条规则，确认其 “最大文件” 列已显示为新值。

此时新阈值即时生效，后续上传、转换附件时将按新阈值判断是否生成预览。无需重启服务。

---

三、常见问题

Q1：修改后已上传的旧附件会重新转换吗？ 不会。阈值只影响新触发的转换任务；如需让旧附件按新规则重新生成预览，请到"转换任务"中手动重新发起。

Q2：可以批量修改多条规则吗？ 工具栏提供"批量修改状态"按钮，仅用于批量启用/禁用规则；文件大小阈值需要逐条修改，避免误改。

Q3：设置完成后预览仍提示文件过大？ 请依次检查：

1. 修改的规则是否是该附件实际命中的那条（注意同一扩展名可能存在多条规则，如 doc:PDF预览 与 doc:OFFICE→HTML）；
2. "状态"列是否为 自动（备用 / 禁用 状态下不会被触发）；
3. 浏览器中重新上传或重新触发一次转换任务。

Q4：阈值最大能设到多少？ 界面未做硬上限，但建议结合服务器磁盘、内存和 OpenOffice 转换能力评估，单文件不建议超过 500 MB。

---

四、变更记录