# 上传附件支持存放在文档正文

来源快照：`result_data_new_260518.json`

- 来源 ID：`1182412373685116929`
- 模块：知识文档
- 目录：功能更新说明 - 2025年8月
- space ID：`1161759301968437263`
- 原文链接：未提供
- 产品基线：未提供

## 正文

# 1、背景

1、系统中大多数文档都是正文为空，且只有单个附件，用户希望打开文档能直接查看内容，所以迭代了主附件打开的功能，主附件打开的功能客户反馈容易混淆正文和附件 以及相关操作

2、客户反馈上传的文件就是正文，不是附件，不要存放在附件tab页下

3、因为系统中大多数都是html文档挂附件，所以在列表不能很直观看到文件的类型，图标都是显示html，并且文件大小都是0B

4、客户反馈上传的图片在文档列表也要能够看到预览小图，这样能直观辨识要找的文档

1.1.

## 功能描述

1、支持配置上传的文件是否存放在正文

2、正文支持预览图片、音频、视频、压缩包等类型的文件，若不支持预览可快捷下载到本地

3、支持快捷替换正文

4、文档列表支持更多类型的图标，其中图片和视频可以点击缩略图快捷预览，无需打开文档详情页

5、文档类型筛选新增支持图片、音频、视频、压缩包、工程文件等

# **2、功能说明**

##  2.1后台配置

![](https://weapp.eteams.cn/papi/file/preview?fileId=1182412584042184706&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

说明

1、文档模块后台设置-系统设置-应用设置-功能设置-附件设置新增设置项【上传附件存放在正文】

2、当前设置项，默认关闭

3、当前设置项操作日志记录：

【上传附件存放在正文】：开启/关闭

## 2.2附件存放在正文的效果

### 2.2.1未采购插件 或插件不支持预览，显示效果

Pc端

 

![](https://weapp.eteams.cn/papi/file/preview?fileId=1182412597007425540&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

移动端

![](https://weapp.eteams.cn/papi/file/preview?fileId=1182412592774725640&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

1、当正文存放的文件不支持预览时，页面显示效果如图

2、“点击下载”按钮，和顶部的下载正文按钮一致，判断是否有下载权限，无下载权限则隐藏按钮

3、不同文件类型正文的编辑和替换，请查看 正文的编辑与替换

### 2.2.2支持预览的文件，在正文的显示效果示例如下（示例）

1、图片

![](https://weapp.eteams.cn/papi/file/preview?fileId=1182412584047026194&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

2、视频

![](https://weapp.eteams.cn/papi/file/preview?fileId=1182412588315254793&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

3、音频

![](https://weapp.eteams.cn/papi/file/preview?fileId=1182412584047026191&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

4、Pdf

![](https://weapp.eteams.cn/papi/file/preview?fileId=1182412584047026200&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

5、Word

![](https://weapp.eteams.cn/papi/file/preview?fileId=1182412597007425542&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

6、压缩包

![](https://weapp.eteams.cn/papi/file/preview?fileId=1182412592741425152&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 2.2.3自动保存场景

####  _2.2.3.1【不支持】编辑的正文 的替换逻辑_

![](https://weapp.eteams.cn/papi/file/preview?fileId=1182412584047026194&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

1、不支持在线编辑的文件类型，例如图片、音频、视频、压缩包等，不展示“编辑”按钮

2、由于不支持在线编辑，所以需支持用户在本地编辑后，对系统内的文件进行替换，故新增“替换正文”按钮

3、替换正文按钮：有编辑权限展示，无编辑权限不展示

4、点击“替换正文”提示“替换正文后，已有正文内容将被清空，确定操作吗”，确定，则打开本地文件，允许选择相同格式的文件，在本地文件浏览框点击确定后开始上传，页面展示loading：文件上传中，完成后刷新正文区域

![](https://weapp.eteams.cn/papi/file/preview?fileId=1182412584243765249&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1182412597007425545&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

####  _2.2.3.2【支持】编辑的正文的编辑和替换逻辑_

![](https://weapp.eteams.cn/papi/file/preview?fileId=1182412597007425542&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

1、支持在线编辑的文件类型并且客户有相关插件，word、excel、ppt等，展示“编辑”按钮

2、替换正文按钮：有编辑权限展示，无编辑权限不展示

3、点击“替换正文”提示“替换正文后，已有正文内容将被清空，确定操作吗”，确定，则打开本地文件，允许选择相同格式的文件，在本地文件浏览框点击确定后开始上传，页面展示loading：文件上传中，完成后刷新正文区域

![](https://weapp.eteams.cn/papi/file/preview?fileId=1182412584243765249&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1182412592620183559&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

1.

协同文档暂不支持替换正文操作

#### 2.2.4手动保存场景

![](https://weapp.eteams.cn/papi/file/preview?fileId=1182412584047026194&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

1、手动保存场景下，只有进入文档的编辑状态，才可以替换正文，如果有可用的在线编辑插件，直接就可以编辑正文

2、点击替换正文按钮的交互，同上

## 2.3业务模块打开附件的效果

业务模块打开附件的效果：保持不变，不管附件是存放在正文tab  还是附件tab，业务模块打开附件仍然是打开附件单页，如果要查看文档相关信息可以通过打开所属文档操作

## 2.4文档列表改造

1、正文是图片的文档：直接在列表展示缩小的图片，用户点击图片直接就可以弹窗预览图片（组件），点击文档标题才会打开文档详情页

![](https://weapp.eteams.cn/papi/file/preview?fileId=1182412588446203905&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

2、正文是视频的文档：直接在列表展示视频的封面，用户点击封面直接就可以弹窗查看视频（组件），点击文档标题才会打开文档详情页

![](https://weapp.eteams.cn/papi/file/preview?fileId=1182412592741425157&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

3、新增常见文件类型的图标，音频、压缩包、工程文件、pdf、ofd...

![](https://weapp.eteams.cn/papi/file/preview?fileId=1182412597007425538&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

4、不常见的文件类型使用统一的图标显示

![](https://weapp.eteams.cn/papi/file/preview?fileId=1182412588315254787&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 2.5文档类型的筛选

 

![](https://weapp.eteams.cn/papi/file/preview?fileId=1182412592774725636&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)
