知识卡片
创建更好流程模型的可读性技巧:标签命名规范与从左到右乐观路线布局
内容
流程模型是很多不同角色都需要理解、生命周期又很长的人工制品,因此值得在可读性上投入思考和时间,但要记住丘吉尔那句”完美是进步的大敌”——一个正在生产环境跑着的不完美模型,远比一个从未被执行过的完美模型更有价值。可读性的核心来自遵循建模惯例,本节给出两个典型实践。给元素打标签:好的标签选择直接决定了流程的清晰度——开始事件用被动语气描述结果性陈述(如”订单被下达”);所有任务都用”动词+宾语”模式明确写出要执行的工作(如”确认支付结果”);带标签的网关要清楚表明在什么条件下走向哪条顺序流,网关标签通常本身就是一个问题,答案则写在对应的顺序流上;结束事件的标签要从业务角度描述流程的最终结果,通常以事件形式表述(如”订单交付”)。从左到右建模、遵循乐观路线:应该按阅读方向从左到右排布图表(不同书写文化则相反),而不是从上到下——这既符合阅读习惯,也符合人类视野更适应宽屏而非竖屏的生理特点(可以想象电影院屏幕如果是竖着的会有多别扭);进一步地,应该按执行的时间顺序,把属于乐观路线的任务、事件、网关都排在图表正中央的一条直线上,虽然不总能做到,但只要尝试就能明显提升可读性。
参考来源
- 位置:《流程自动化实战:系统架构和软件开发视角》第10章《业务-IT协作》"10.5.3 提高可读性"(源文件:_epub-src/EPUB/xhtml/Section0001_0014.xhtml)
- 结论依据:原文分别给出开始事件被动语气、任务动词+宾语模式、网关标签作为问题及顺序流为答案、结束事件描述业务结果四条标签规范,并说明从左到右建模符合阅读方向和人类视野特点、乐观路线应居中排布,直接支撑本卡片结论。
- 原始内容:开始事件的标签用被动语气描述("订单被下达")……所有任务都有明确的标签,以告知读者需要执行哪项工作,通常使用动词+宾语的模式……为了遵循导向成功结果的"乐观路线",你可以将属于乐观路线的任务、事件以及网关放在图表中央的一条直线上。