【iSAQB软件架构】模板型视图描述

在描述软件架构，特别是架构视图时，使用标准结构或布局是有意义的。这为读者提供了很高的识别价值。将描述与相应的目标群体相匹配也很重要。询问您的利益相关者，对于他们自己的特定任务，需要描述哪些方面。

在描述架构视图时，经验法则是尽可能少地使用形式主义，但要使用必要的量。一个项目不应该仅仅因为只有在处理了每个小细节时架构图才被接受而大幅偏离计划。作为架构师，您应该抵制教条主义行事的诱惑。

对于文档范围的一个有用的初始框架是风险级别或要描述的构建块的复杂性。风险越高，构建块文档就必须越全面。如果风险级别可控，可以省略一些细节。
用于描述架构视图的示例部分可能如下:

1. 简要描述

视图的简要描述提供了一个基于短文本的“在这个特定情况下涉及的内容”的概述。

2. 图表

图表提供了视图的图形表示。

3. 元素目录

1. 元素及其属性
2. 关系及其属性
3. 元素的接口以及元素之间的接口
4. 元素行为
   如果涵盖所有图表的元素目录过于庞大，可以为视图的图表使用多个本地元素目录。

4. 可变性

此部分使用基于文本的描述来解决视图内可变元素或关系的问题。此处包括需求、架构、设计、涉及的外部系统或基础设施方面的所有可变性。
根据视图的类型，还可以在此处解释配置、安装和操作参数。还可以在此提供所有要遵守的技术标准的列表。
在可变性中，区分可更改性和灵活性可能很有用。可更改性解决了对当前系统进行修改的可预见能力（例如，更改 JDBC 数据库驱动程序），而灵活性解决了扩展系统的能力（例如，通过提供允许对同一底层应用程序进行不同类型 GUI 访问的扩展阶段）。

5. 背景信息

基于文本的背景信息在理解视图的特定结构方面很重要，可用于证明特定的设计决策是合理的。典型的背景信息包括:

1. 选择的结构或所选替代方案的理由
2. 特定内容相关系统方面的分析或初步评估的结果
3. 关于系统、使用的构建块或系统环境所做的假设
4. 对相关或连接的视图的引用
5. 各种源信息或示例代码

示例:一个构建块视图描述的摘录

为了说明，下面提供了CoCoME示例的构建块视图的摘录。

简要描述

此构建块视图的这一部分为超市收银操作的 CoCoME 提供了概述。图 4 - 8 使用 UML 组合结构图展示了 CoCoME 的最高构建块级别，其中软件构建块库存（Inventory）和收银台线（CashDeskLine）均由 UML 组件表示。

图

CoCoME的构建块视图，最顶层 ：

元素目录

CoCoME构建块视图(TradingSystem)的元素目录：

可变性

收银系统应能够针对不同的安装进行配置。届时将适用特定的合理性。

背景信息

• 分析
o 原型表明，CoCoME 中的条码扫描仪可能是一个错误源。因此，在开发过程中应进行适当的测试，并在最终系统中实施措施，以确保在这方面提高容错能力。
o 关于 CoCoME 软件是否真的应可配置到本地级别，仍需要与负责的利益相关者进行澄清。在适当的情况下，CoCoME 测试用户应实施评估原型的措施。
• 假设
o 预计其他 CoCoME 构建块不会出现特定的错误源、安全风险或性能瓶颈。
• 对相关视图的引用
o 细化的 CoCoME 构建块视图
o 运行时视图和部署/基础设施视图