简道云全应用开发详解-第二章 搭建规范
前言
本案文章是为了支持深入学习简道云全应用开发的学员们,系列教学帮助文档的第二章,更多内容详见《简道云全应用开发详解-第一章 以终为始》,对于未阅读过的伙伴们,建议从第一章开始阅读。
当然,每篇文章本质上都是一个独立的单元,其中我会引用各种理论和实际解决各种业务场景来帮助你理解和学习,不作为全应用开发学习,仅单独阅读也是完全没问题的。
一、 不以规矩,不能成方圆
作为已经使用简道云零代码开发超过 6 年的老道友,我非常认同孟子这句话“不以规矩,不能成方圆”。不仅仅是因为规范的命名和版式,更有助于后期索引,以提高整体系统的逻辑性和美观性,而且考虑到数据调用和内部测试等多方面的需求都会频繁使用。
在入门时就养成良好的搭建规范,对于真正成为一名优秀的简道云开发者,非常重要。在这个理念下,无论是制定工作流程、设计产品还是日常决策,遵循既定的规范和原则都是成功的关键。这与我们之前第一章讨论的SMART原则,和下一章的结构化思维的意义紧密相连,都是为了提升效率、保证质量、促进合作和确保一致性。下面,我将会从结构化思维、思维导图、推荐命名规范三个层面来帮助你实现。
二、 结构化思维
很多学员在拿到需求文档后,往往第一时间就开始搭建。除了担心时间不够之外,大多数人多是没有意识到甲方的真实用意,更没有和未来甲方实际的应用场景结合起来思考。
其实不管是为了完成开发,还是将来在与开发需求方对接时,拿出绝大部分时间和精力用于梳理和明确需求都是所有一切的开始,甚至是最重要的部分。因为如果连需求都没有梳理清楚,基于模糊理解去做开发,约等于空中楼阁。而在大部分需求文档中的标题和注释要求,就是已经初步结构化的甲方开发需求文档。你可以把其理解为“半业务语言+半技术语言”的过渡阶段,例如:在 3.合同管理中要求其他信息(回款记录、开票记录)支持关联查询(双向关联功能),等于不仅明确了表单归属,还定义了数据调用模式。
以上内容的具体细节,详见《简道云全应用开发详解-第三章 结构化思维》
三、 思维导图
有了相对清晰的目录和正文要点,我们就将对整张试卷进行答题思路的梳理和呈现了。得益于前期充分的准备和在线文档的技术支持,我们可以直接在模拟试卷的开始部分就使用语雀自带的思维导图工具,进行答题思路的完成。
提示:思维导图也是结构化思维的一部分,但相对于前期的结构化梳理要求更加的具体。因为思维导图需要使用到更具体和全面的结构化思维能力,我已专门另起一章来表述,具体过程详见《简道云全应用开发详解-第四章 思维导图》
四、 命名规范及推荐规则
思维导图就像一幅全景地图一样,帮助我们完成对需求文档的抽象化理解。在绘制思维导图的时候,我们就可以先行开始对未来简道云实际开发时,用到的各个表单分组、普通表单、流程表单、仪表盘组件等进行第一次命名定义了。不用担心命名是否完美,因为伴随着实际开发工作的展开,命名就像是黑板上的粉笔字一样,我们可以随身修改以便实现最佳适配效果。
以下我会把我在实践中探索出的基本逻辑和规则推荐给你,具体实现时可以进一步结合自己的搭建习惯进行优化或改良:
基本逻辑:遵循分级目录,顺序从上到下,序列按升序,中间使用符号分割,后缀为中英文字符释义。
1. 分组命名和规范
推荐规则:1 位序列数字+小数点+4 字以内中英文字符,例如:1.客户管理、2.商机管理……。通常情况分组不会超过 10 组,所以一位数字作为序号够用。若需要二级目录,则使用继承分组序列数字解决,例如: 1.1 (简道云仅支持两级分组)
排列规范:按命名序列升序,从上到下即可(注意下级分组设计)
2. 普通表单、流程表单命名和规范
推荐规则:2 位继承分组序列的数字+小数点+6 字以内中英文字符,例如:1.1 新建客户档案、1.2 客户跟进记录……。
若启用两级分组,则使用 3位继承分组序列的数字+小数点+6 字以内中英文字符,例如:1.1.1 新建客户档案、1.1.2 客户跟进记录……。
排列规范:按命名序列升序,从上到下即可(注意与分组的对应关系)
流程表单绘制规范:从上到下,从左到右,主干等于主流程,分支条件流程节点置于主干两侧(默认右侧优先,P 型设计),更多详情推荐在具体题目解析时阅读了解。
提示:流程表单的画布设计通常是初学者的短板,如何在一张白纸上快速画出既清晰又有效的流程图并不是件容易的事情,具体请在后续章节中涉及到流程表单搭建时进一步阅读和学习。
3. 聚合表、数据工厂和智能助手命名
推荐规则:因聚合表和数据工厂的表相对隐藏,不容易被理解和查询,推荐规则:聚合/工厂+1 位序列数字+小数点+6 字以内中英文字符,例如:聚合 1.库存表、工厂 2.输出表……
提示:智能助手生成的表单因不涉及调用,因此不需要特别考虑命名规则,推荐直接使用目的命名即可
4. 特殊字段命名
特殊字段 1 主要指的是,用于作为字典的表单中的字段,因数据调用需要显示,便于在被调用时进行区分识别
推荐规则:表单名称+字段名,例如:1.1 客户姓名、1.2 客户类别……
特殊字段 2 主要指的是,用于辅助计算的数字字段、用于辅助定义的文本字段等,便于在其他表单调用时与原始字段进行区分识别
推荐规则:字段名称+减号+数/文/其他,例如:F产品单价小计-数、F用户标签-文、F开始日期-日……
5. 仪表盘命名和规范
仪表盘通常隶属于报表中心分组,推荐规则:2 位继承分组序列的数字+小数点+6 字以内中英文字符,例如:4.1 当月新增客户、4.2 去年合同总额……。
排列规范:按命名序列升序,从上到下即可(注意与分组的对应关系)
仪表盘还涉及其中各种图表的设计及排布,具体详见《简道云全应用开发详解-第九章 报表中心》
6. 其他需要注意
冗余字段:之所以会出现冗余字段,大多与开发者的不良开发习惯有关,要么搭建时没有想好用何种字段实现目的,要么设置了太多的辅助字段,一旦到了后期进行检查时,有效字段和冗余字段混在一起就很难被发现。所以,这就要求我们首先要把更多时间花在前期深度思考上,而非一看题目就开始作答,想清楚了再动手。而且,也要养成主动寻找最优解的能力,能用一步解决,绝对不要花两步。
冗余公式:相对于冗余字段,冗余公式对于初学者更难克服和解决。初学者在未完全学会使用嵌套公式和函数时,就会频繁使用辅助字段来解决问题,除了担心嵌套公式不容易撰写和理解,更多是因为花更多时间去解题。因此,解决冗余公式的最优解是,使用简道云帮助中的 AI“小简助手”,ta 不仅可以帮助你把需求转换成公式,而且也会给出最优解。另外,在最终公式提交时,也多注意报错提醒,也能有效解决冗余公式问题。
五、 忠言逆耳
万事开头难,又要在这么难的开头时强调这么多规矩,其实并不是件容易被人理解的事情。但请相信我,这么多的规范都是我自己多年以来亲身体会得来。我曾在授课时不止一次地说过,如果希望使用简道云完全自行搭建一套定制化系统需要 100 分钟,那么应该拿出 60 分钟以上时间来沟通需求和深度思考。而之所以能快速实现系统搭建,良好的搭建习惯都是得益于前期日积月累遵循的规范。
最后,在你基本理解了关于简道云开发的相关规范后,就可以开始进入下一步了,千里之行,始于足下。欢迎从阅读我的第三篇文章开始,请点击《简道云全应用开发详解-第三章 结构化思维》,也欢迎对简道云全应用开发有兴趣的伙伴在我的系列文章后回帖留言,我们共同探讨学习成长。
■本章内容已告一段落,感谢您的阅读。
|