【JIT/ 极态云】技术文档 --Excel 模板
一、简介
Excel 模板是文件模板的其中一种应用,其核心功能在于预设格式、结构及特定变量,并能够根据实际需求动态地填充和更新数据。
具体来说,Excel 模板是一种预先定义好的电子表格结构,其中巧妙地嵌入了可变元素或者占位符,这些元素可以是单元格、公式、图表等任何可能需要用户自定义或定期更新的数据区域。使用者在应用模板时,只需将变量替换为实时数据,即可一键生成符合预期格式的报告、统计表或是数据分析结果。
二、交互流程
创建一个 Excel 模板,配置其模板名称及存储路径。
添加需要在模板中插入的变量,支持现有所有数据类型。
将生成好的文件数据复制其变量代码。
在自己的 Excel 中对数据变量需要展示的位置进行排版,确认后上传即可。
三、模板变量代码
模板变量代码本质上是在变量的基础上提供模板样式方法,不同的样式方法可以将相同的变量数据展示出不同的渲染效果。
即在最终转换出的变量代码中格式一般为{{name.value.ToString}}三段式。代码以两个花括号(“{}”)包含。
变量名,第一段,为取值变量的名称,若为复杂类型则为 a.b.c 的连续取值;
属性值,第二段,为变量最终需要输出的值,可以调用只读函数或者读取属性;
样式方法,第三段,为对应输出值的展示样式,不同的值类型有不同的样式方法;
(一)文本类样式
(二)数值类样式
(三)日期时间类样式
(四)多值类样式(复杂类型)
在 Excel 模板中可以对变量代码进行布局调整,在此基础上开发者也可以通过手写变量代码直接构建模板,不一定要依赖从系统中复制。
四、使用效果
文件模板一般在打印文件模板/生成附件函数中配合使用,这俩者都是将已有的模板变量进行赋值,然后将文件模板输出。
此时的打印逻辑就是将实际传入的变量赋值替换掉模板中的变量代码占位,从而生成最终的模板成果。
且每一次打印都可以赋予不同的实际值。
五、使用场景示例
例如,在企业财务部门,可以通过设置包含固定表头、计算公式以及图形展示的 Excel 财务报表模板,每个季度末只需导入最新的财务数据,就能自动汇总生成当季的财务分析报告,大大减轻了人工整理和计算的工作量,同时也避免了潜在的人为错误。
六、注意事项
针对部分特定样式,如展示图片/超链接/多行数据,要注意检查对应的变量输出能否满足数据要求。
在进行模板代码布局排版时,要结合预计输出的数据预留足够的单元格大小,如多行文本/图片。
进一步了解极态云,体验产品?
请访问 极态云官网 https://jit.pro/?utm_source=info&utm_campaign=kai_fa_zhi_nan&utm_medium=article&utm_content=241153
评论