推荐阅读

type=info

在日常工作中，技术支持团队积累了一些应用开发的实用技巧。列表不定期更新，欢迎关注。

一、数据模型

为了加速应用开发，活字格在数据库的基础上增加自动编号、表关联、统计字段、公式字段等功能，形成面向开发的数据模型。这些功能的帮助文档清晰，应用场景广泛，建议开发者在启动项目开发前务必通过帮助文档了解这些功能的使用方法和应用场景。

在实际项目中，数据模型的开发过程需要注意以下几点：

• 不要跨数据源创建视图（如查询中包含主数据的字段时），如果需要读取主数据，推荐采用 系统集成的推荐模式 中的本地缓存（使用内置库时）或中间库（使用外联库时，将外联的业务数据库设置为中间库）方案，将数据同步到同一个数据源中后，再创建视图

• 设置关联字段时，要关联同一个数据库的表，否则会影响性能，而且在数据表上设置查询条件时，无法选择关联的字段，推荐的处理方法同上

• 如果无法确保数据库随时可以连接，不推荐在外联库中创建【用户信息视图】，因为在连接不到外联库时会导致服务无法启动

• 除非必要，不允许匿名访问数据库，不允许用JS API访问数据库

• 使用Oracle数据库时，因为Oracle与MySQL和MS SQL的差异，有如下事项需要额外关注：

  • 使用活字格创建的表中ID是字符串类型，且没有索引，需要手动创建索引，并且在关联字段中使用字符串类型

  • 推荐使用大写字母作为表名，否则需要在调用【执行SQL】命令时，为表名加引号

  • 在调用【执行SQL】命令时，推荐使用双击右侧关键字的方法追加参数；如果手动编写SQL语句，注意在参数前面用:，不要用@

二、页面、命令与函数

• 不要在同一个单元格内使用公式和绑定字段，公式的计算值不会被显示和使用；如需要将公式自动计算的数据提交到数据库时，用【数据表操作】或【表格操作命令】中的“添加非绑定字段”功能实现，如果只是简单的计算，推荐优先考虑使用数据表的“公式字段”代替

• 页面中有多个数据源表格时，推荐使用【表格操作】命令做“重新加载数据”，不要用【查询】命令

• 在数组或表格中循环命令，如果变量为字符串（如服务端命令返回的值），需要先通过【JSON反序列化】命令转换为对象后再循环

• 使用IF函数做判断时，要确保比较双方的类型相同，避免用数字1和字符1做比较

三、导出、导入与打印

• 使用【导入Excel数据到表格】时，推荐选择“替换”或“合并”模式，将数据导入到中间的表格（隐藏表格），导入后再使用【表格数据传递命令】追加到目标表格。

• 【导入Excel数据到表格】的目标表格需要确保目标表格没有启用“按需加载”，也没有设置“分页”。

• 需要导入的excel文件尺寸比较大时，推荐使用【获取数据库附件中的文件路径】和【服务端导入导出CSV】服务端命令在后端导入，不要在前端导入

• 推荐单独设计打印页面，打印区域内只放必须展示的数据，不要和数据展示页面共用

四、发布与部署

• 发布前，推荐提前检查好服务器环境，开放对应端口，包含发布应用所需的端口，如配置了邮件服务，还需要确保开启相应的端口，详见：如何设计生产环境的部署方案？

• 测试阶段，如果没有上传证书，发布时不要选择HTTPS

• 修改内置库的表结构后，在发布时需勾选“覆盖数据库”（半覆盖），避免数据无法加载

• 创建或修改角色后，在发布时需确认已勾选“发布角色”

• 创建或修改流程后，在发布时需确认已勾选“发布流程”

五、其他

• 建议将大于200个页面的解决方案分成多个小模块应用来开发，减少一个工程内的数据表和页面数量可以提升活字格设计器的响应速度

• 升级活字格设计器时，要点击【插件管理】页面，升级所有用到的插件，避免出现兼容性问题

• 插件升级后，再次打开之前的活字格工程时，需要注意插件升级提示。如果需要升级插件，请勿选择覆盖。

六、扩展阅读

• 如何设计企业级系统架构？

• 系统集成的推荐模式有哪些？

• 如何利用缓存提升应用性能？

• 与性能优化有关的实用技巧

type=info

温馨提示

企业级低代码开发最佳实践是活字格官方面向进阶开发者推出的产品技术资源，旨在帮助对活字格基本功能有一定了解的开发者快速提升应用开发能力，保质保量做好企业级项目交付。如果您是初次接触活字格，这些内容可能会有些艰深难懂，这也是正常的。如果您有软件开发经验，推荐您学习《面向程序员的活字格入门课程》；否则，您也可以免费报名参加新手训练营直播课程或购买阅读《低代码开发实战：基于低代码平台构建企业级应用》（机械工业出版社），快速上手低代码开发。