1、单行文本需要标记长度限制,255个字符,目前很多业务在配完字段导入数据时才发现他们要的不是单行文本,应该是多行文本,甚至是Markdown
2、Markdown和Markdown(vditor)经常有用户搞不清楚应该选哪个,这块要看你们后续规划是怎么样的,否则建议你们文档上给下建议字眼,统一使用Markdown(Vditor),我们内部现在就是这么建议的,省事一点,而且这个入口之前有提过最好能结合下AI员工的能力,Markdown(Vditor)会更适合些
3、建表时5个默认字段,声明下除非清楚效果否则不建议改动和删除,ID、创建人创建时间修改人修改时间,这里文档需要体现这5个字段的作用(默认的系统逻辑)比如会影响权限“自己的数据”这个数据范围,有很多人会手痒去删
4、公式字段建议慎重使用,要说明其执行的原理(是在应用内同步模式去执行的,会吃计算性能),要考虑表数据量,
有过大数据量导入行为的表,不建议使用公式字段,建议通过导入触发工作流去运算。这里你们还有一个导入大量数据涉及公式字段应用会崩溃的问题还待优化
5、下拉类字段,要声明表已存在数据后,禁止直接改动选项值,应该新建选项值后刷新表数据,再剔除旧选项值,否则数据展示会错乱(这个作为一个小场景说明即可)
6、勾选字段,单独说明,这是布尔值,存储的数据不是0就是1,不能为空,现在我们有一个场景就是配了勾选字段,导入的时候死活导不进去业务不知道为什么,原因就是这个,这样文档上要声明下导入时候的异常情况(我们内部一般都不建议使用勾选字段的,下拉单选可以平替,当然这个建议官方不用说明,不通用)
7、数字类型那个精确度,要给一个实际案例说明,配起来很懵的,都要做测试才好确认,尤其那个精确度还带了(UI)的字眼,百分比字段的精确度没带UI,数字的带了,这两个字段都需要给一个配了具体精确度,界面怎么展示数据库怎么存储的示意,数据库怎么存应该导出就是什么效果了对吧?这里要说明数据库存什么的原因就是要说明导出的数据是什么样的
8、关联关系字段,建议平铺出来说明,给具体的建议场景和最后页面上的示例截图(选择器、子表单、子表格这些场景),还有导入不能新增关联字段数据,只能做关联,这个导入父子表也建议给一个场景说明;这4个字段太关键了,影响业务建模的合理性也影响应用性能,那个ondelete的每个选项都要给出具体的场景说, 现在我们就遇到很多误删了“基础数据”他们应该要配置RESTRICT才对,这样关联了数据的就能避免误删,但是配置过程是没有提示的,建议界面上也加下提示说明就更好了