如果您在神鲸办公中上传了PDF文件，但无法直接在系统内查看内容，则可能是由于附件预览功能未启用或所用预览服务不支持PDF格式。以下是实现PDF在线预览的具体操作路径与配置方法：
一、确认文档中台是否已集成PDF预览能力
神鲸办公的附件在线预览依赖底层文档中台服务，该服务需支持PDF格式解析与渲染。Filez文档中台明确支持超过200种文件格式在线预览，其中包括标准PDF文件，且无需下载安装任何本地软件即可在浏览器中直接打开。若当前环境未显示PDF预览按钮，请检查文档中台服务注册状态及版本兼容性。
1、登录神鲸办公管理后台，进入【系统设置】→【附件管理服务注册】模块。
2、核查已注册的文档中台服务实例是否为Filez或具备同等PDF解析能力的中台（如WPS开放平台、ONLY OFFICE文档服务）。
3、确认服务健康状态为“运行中”，且接口调用日志中无PDF MIME类型（application/pdf）拒绝记录。
二、验证附件字段是否启用在线预览配置
即使文档中台支持PDF，单个附件字段也需显式开启预览权限与方式。预览功能受字段级策略控制，未配置则默认禁用。
1、进入业务单据设计界面，定位至目标附件字段属性面板。
2、展开【附件预览方式配置】选项，勾选“启用在线预览”复选框。
3、在下拉菜单中选择“默认预览方式”为“文档中台预览”或“WPS在线预览”等已部署的支持PDF的服务。
4、保存字段配置并发布单据模板，重新上传PDF附件测试预览按钮是否出现。
三、检查PDF文件本身是否符合预览要求
部分PDF因加密、损坏或使用特殊字体嵌入方式，可能导致中台解析失败。预览引擎对文件结构有基础合规性要求。
1、使用Adobe Acrobat Reader打开该PDF，确认无“禁止复制/打印/编辑”等安全策略限制。
2、尝试用系统自带PDF阅读器（如Windows Edge、macOS 预览）打开，验证文件可正常渲染。
3、若文件含扫描图像型页面（非文本层），需确认文档中台是否开启OCR增强预览模式；否则可能仅显示空白页或提示“无法加载内容”。
四、切换备用PDF预览服务路径
当主用文档中台临时不可用或对某类PDF兼容不佳时，可通过配置降级策略启用替代方案，确保基本预览连续性。
1、在附件字段高级设置中，找到“备用预览方式”选项。
2、启用并指定一项备用服务，例如“云之家内置PDF查看器”或“浏览器原生PDF渲染”（需终端Chrome/Firefox/Safari支持）。
3、设置触发条件为“主服务超时（≥3s）或返回HTTP 500错误时自动切换”。
4、保存后上传同一PDF文件，观察是否由备用通道完成加载。
五、移动端PDF预览适配检查
在云之家APP等移动端环境中，PDF预览依赖客户端集成能力与服务端响应格式协商，需同步校验两端配置。
1、确认云之家APP版本不低于V8.5.0，该版本起全面支持PDF文件内嵌Webview渲染。
2、在移动端附件配置中，检查“允许视频拍摄上传”开关旁的“PDF强制在线预览”选项是否开启。
3、上传PDF后，在附件列表点击缩略图，若跳转至全屏PDF阅读界面且支持缩放、翻页、文字搜索，则表示移动端预览链路完整。
