有用的地图必然有所省略

图示只有保留任务所需的关系才有用。说清它扭曲了什么;如果另一项决策需要被省略的细节,就提供配套视图。

system diagram abstraction

简短的回答是什么?

有用的地图是有选择的。先确定读者要完成的任务,再保留任务依赖的关系,并说明图示扭曲或省略了哪些细节。示意线路图能讲清换乘,却可能掩盖步行距离;系统图能讲清数据流,却可能隐藏权限和故障时序。当省略会改变决策时,提供配套视图。

了解更多
在本页面

轨道交通图把线路拉直、把站点均匀排开,可以让换乘一目了然。它也可能让相距很近、步行几分钟就能到达的两站看起来很远。同一种抽象,既能帮助乘客选车,也可能误导乘客选步行路线。

一段关于交通图历史的讨论提出了一个问题:当示意图被用于选线之外的任务,会发生什么?纽约交通博物馆的介绍证实,1972 年的地图将线路拉直,并删去了大部分地形细节。这提醒我们,一幅图可以很好地服务一项任务,却仍需为另一项任务提供配套视图。这个道理并不依赖当年计划制作哪些辅助图的确切经过。

先定义读者要找的路线

每幅图都在删除信息。系统架构草图略去时间,工作流图略去数据值,同步方向图可能略去谁有权批准写入。删减往往正是图示易读的原因。只有当被删掉的属性影响读者的选择时,它才成为问题。

设想一张说明性的商店到邮件平台同步图,只有两个方框和一支箭头:商店 → 邮件平台。它能回答“客户记录由哪个系统发送?”却不能回答同意状态是否随记录传递、重复记录怎样处理,或者购买后是否取消已排队的消息。这张图并没有画错,只是无法支持这些决策。

动笔前,先用一句话写下读者的问题。

  1. A 站
    起点
    相连
  2. 换乘站
    换乘线路
    相连
  3. B 站
    终点
说明性示意路线 三个站点按连接顺序排列;间距有意采用示意比例,无法回答步行距离问题。

“这个字段来自哪里?”需要数据沿袭图。“源系统无法访问时会怎样?”需要时序和故障状态。“谁可以启动营销活动?”需要权限信息。一个页面可以承载多种视图,但单幅图不该假装能为每项任务提供最佳答案。

视图保留的关系常见的失真
示意线路图连接和换乘实际距离与方向
数据流图来源、使用方和方向时序与授权
时序图调用与响应的先后持续状态与人工工作
权限矩阵获准的主体和操作用户在系统中的完整路径

这些只是概念示例,并非对某个具体产品或地图的评价。

在使用处指出省略

“非按比例绘制”的脚注能帮助旅客正确理解示意图。对于同步图,说明文字可以写成:“仅展示正常的数据流向;写入权限和故障路径请见相应视图。”它比笼统的免责声明更有用,因为它点出了缺失的决策信息。

配套视图应按后果选择。用于安全审查时,权限不是可选背景;用于排查记录过期时,时间戳和重试状态比方框的位置更重要;用于规划新集成时,字段归属和纠错路径可能决定实现方式。

因此,视觉上的整洁也可能成为陷阱。一支不与其他箭头交叉的箭头很好看,却可能藏起反馈路径。大小一致的方框暗示职责相同,而实际上,一个系统可能拥有事实的权威,另一个只保存可丢弃的投影。当这种运营上的不对称影响决策,设计就应把它画出来。

在需要时提供下一张图

如果在决策点给出下一张视图,同一组图就能服务多种读者。先展示回答眼前问题的视图,再就近提供链接或切换入口。跨视图保持标签一致,读者才知道流程图中的“客户”与权限表中的“客户”是同一对象。

有效的评审可以请一个不熟悉系统的人做两个决定。先用图完成预期任务,再问一个依赖被省略属性的问题。如果读者很有把握地得出错误结论,就需要标出省略或补一张图。如果他们知道下一步该看哪里,这种抽象就发挥了作用。

数据归属指南讨论了集成背后的选择。展示这些选择的地图应帮助读者迈出正确的下一步,而不是只呈现一幅看似完整的架构。

一张图也可以附上自己的测试用例:放入一条正常记录和一条异常记录,请读者追踪两者。如果异常情况消失在一支没有说明的箭头上,图就藏起了一个决策。面向管理者的版本可以略去字段名,但仍要显示谁负责处理故障;面向实施者的版本可以展示模式和重试,而略去组织内部的协商。关键是每次省略是否仍能支持目标任务。当新读者只能靠猜测理解时,补上缺失的关系或指向配套视图,不必把每一寸空白都塞满方框。

地图的价值在于审慎地省略。若它省略的恰好是读者来此要判断的事,地图就失效了。

常见问题

怎样让简化的图示保持诚实?

说明图示服务的任务及保留的属性,并标明重要的省略。若布局、距离或覆盖范围并非写实,就不要让读者误以为它们是写实的。

图示何时需要配套视图?

当读者必须依据图示有意删去的信息作决定时,例如实际距离、访问控制、延迟或异常路径。

团队应怎样检查系统图?

先请读者用图完成预期任务,再用一个依赖省略细节的问题测试它。如果省略会误导,就修改图示或链接配套视图。

申请抢先体验

请输入您的名字和公司电子邮箱地址。我们会发送确认 Tajo 访问申请的链接。

获取Brevo