开源基础框架，如何通过配置化实现文件管理（文档下载、预览等）

在数字化业务场景中，文件管理与动态文档生成是企业高效运营的关键环节。传统文件处理方式往往依赖人工操作或复杂编码，难以满足灵活多变的业务需求。JVS开源框架通过低代码配置化能力就可以实现。接下来我结合模板化文档生成和文件预览/下载两大核心场景，来看看如何通过可视化配置实现。
JVS开源框架中，系统提供对后台上传的相关的文件进行管理，操作如下图所示

点击【上传文件】按钮选择桶名和标签然后拖取文件点击提交就可以上传文件

然后可以选择文件点击【删除文件】按钮删除文件

同时每个上传的文件都会生成一个地址，我们直接点击行内按钮【复制链接】复制文件地址

复制的文件地址用于逻辑引擎中需要填写文件地址的地方，如下图

场景一：文档模板替换下载配置

通过上传统一模板，根据不同业务数据填充替换下载文档。
业务应用中通常需要把行数据某字段赋值到一个文件模板上，用户下载该文件模板用于盖章或签字等线下操作。这样的场景在我们平台上可以通过行内按钮配置逻辑引擎实现。

配置步骤

步骤一：
设置模板文档
文档类的模板，参数名必须同逻辑引擎文档模板替换节点的参数名一致。直接设置标签变量格式：${}

xlsx格式的文档模板设置规则：
在单元格处设置转换标签变量使用${}

读取整个表格数据使用${对象名称.字段名}
注意：传值的时候是数组对象结构 XXX:[{aa:aa,bb:bb}]，这样excel里面的xxx.aa才取得到

步骤二：
将做好的模板文件上传到后台文件管理中（支持xlsx、docx和pdf格式）
管理员登录系统进入管理后台-文件管理点击【上传文件】，输入桶名和标签，并将设置好的文档模板上传并点击【提交】。

步骤三：
将列表页中每行数据填充至模板，在列表页设计中添加行内按钮触发逻辑，也可以直接在逻辑中直接查询出数据填充赋值到模板

步骤四：进入逻辑设计器中，拖取文档模板替换组件。

①：模板文件链接地址，粘贴文件管理中复制的链接地址。
②：参数名，参数名必须与文件模板中的参数名一致。
③：参数值，文件模板上参数名对应的参数值，可以取字段、具体值、公式等赋值。
当赋值表格字段时，需要先获取表格对象，如下图

然后对表格对象赋值

④：文件名，不包含后缀，指下载显示的文件名称。
⑤：输出文件格式，指将模板内容转换后输出对应格式的文档，支持xlsx和docx和pdf。
最后执行结果输出替换后的文件的地址、文件名、文件大小等数据，如下图

场景二：行内按钮文件预览/下载

在业务场景中直接预览或下载文件，这个文件就是上传在文件管理中的固定文件。
软件通常在列表页行内按钮上有文件预览或下载的功能，这样的场景我们可以直接在平台上通过配置实现。

配置方法说明如下：

进入列表页设计页面，【添加按钮】按钮位置设置行内，按钮类型选择逻辑引擎。
①：下载按钮，通过逻辑引擎配置触发。
②：预览文件按钮，通过逻辑引擎触发直接预览。
点击【设计】进入逻辑引擎配置页面。