logo Visual Paradigm使用技巧 我也要发布文档

如何从域类模型构建术语表


在典型的模型中,像user、account和customer这样的词经常作为模型元素的名称或模型元素描述的一部分出现。实际上,它们到底是什么意思?它们都是指同样的东西或概念吗?这是一个只有系统的最终用户,系统分析员或者开发人员可以为你提供答案的问题。我们知道,在模型中使用的词的含义可能因系统域、上下文和用户而异。 因此,定义关键字对于在项目内部、团队成员和最终用户之间构建对词汇的共同理解是至关重要的帮助。术语表在Visual Paradigm中是你可以添加和定义术语和短语的地方。清晰的定义不仅可以避免歧义,而且是开发人员可以从中获益并减少开发“错误行为”功能的概率。

虽然拥有一个术语表是一件很美好的事情,但是构建一个术语表是很有挑战性的。为了建立一个术语表,你必须问自己一个问题:“哪些重要的单词和短语需要定义?”你可能会很容易地想到一个或两个单词,但随着时间的推移,你会发现收集到真正重要或与系统相关的单词和短语越来越难,一个推荐的方法是从域类模型开始。

域类模型是在系统开发的早期阶段开发的。它的目标是捕捉和表示领域中的概念和关系。由于这个原因,最终用户和项目团队都可以理解它。域类模型中使用的词汇表应该是有意义的、重要的,并且从用户的角度来看与系统相关。因此,域类模型始终是识别术语表术语的可靠起点。

案例研究:为查询管理系统开发术语表

True Aqua Distilled Water Company是城市里的一个蒸馏水供应商。公司每天都会收到大量的用户查询,管理层希望采用查询管理系统来提高用户的满意度。你是系统分析员,你的开发团队负责开发查询管理系统。现在,按照下面的步骤开发域模型并从模型派生术语表。

1. 使用Visual Paradigm创建一个新的项目。从工具栏中选择Project > New

2. 在New Project窗口,输入Enquiry Management System作为项目的名称。点击Create Blank Project按钮。

3. 选择工具栏中的Diagram > New创建类图。选择Class Diagram,然后点击Next

4. 输入Domain Model作为类图名称,然后点击OK进行确认。

5. 考虑系统的概念并以类的形式列出它们。以下是列出的类:Customer, Enquiry, Enquiry Type, Customer Service Assistant

6. 使用合适的关系链接类(概念)。

7. 域类模型已经创建完成。现在,通过添加类的名称作为术语表术语,从模型派生术语表。双击Enquiry类。右键点击Enquiry,并从弹出菜单中选择Add "Enquiry" to Glossary到术语表。

8. 你应该会在状态栏上看到一条消息,告诉你术语查询已经添加到词汇表表格中。单击词汇表表格的链接跳转到那里。如果你错过了,不要担心。你可以通过从工具栏中选择Modeling > Glossary > Glossary Grid 来打开术语表表格。

9. 术语表表格是列出术语表术语的地方。你可以在表格中检查术语及其定义,还可以通过术语表表格顶部工具栏上的相关函数按钮创建和管理术语。现在,描述一下Enquiry这个词。右键单击术语并从弹出菜单中选择Open Term Editor

10. 在Definition框输入术语的定义:A request of support issued by customer, with question or problem described。

11. 我们可以用不同的词来指代同一个词。这有助于避免在创建具有相同含义的多个术语时产生冗余。让我们假设一些最终用户可能把查询称为“support request”。让我们添加一个名为“support request”的别名。点击Aliases部分(位于术语编辑器顶部)右边的Add。

12. 在输入窗口输入Support Request并确认。现在Support Request将作为Enquiry的别名。

13. 从工具栏中选择Modeling > Glossary > Glossary Grid回到术语表表格。你可以在这里找到别名和描述(也就是定义)。

14. 现在按照这种方式添加其它类的名称。

15. 不同的读者可能对从不同的角度阅读一个项目感兴趣。为了帮助分类这些角度,可以定义标签。然后,可以用标签标记术语表术语,并根据列表目的进行过滤。

现在,让我们定义一个带有标签的术语。在网格中单击“Customer”一词的标签单元格。点击右上角的加号按钮。

16. 在Add Label窗口,点击底部左边的New Label...在弹出窗口,输入标签Human,选择你所喜欢的颜色,然后点击OK进行确认。

17. 在Add Label窗口点击OK,标签被添加到术语中。

18. 标签可以在表格中显示的过滤术语中使用。点击Configure Grid按钮。

19. 在Scope中选择With Label... 

20. 在Scope窗口勾选Human,然后点击OK。现在,表格中只列出了Customer

21. 从scope退回到Project中。

22. 回到类图。你可以看到,类的名称都高亮显示。当读者想知道类名的含义时,他可以从类中打开定义。将鼠标指针移动到图中显示的任何带下划线的文本。按住<Ctrl>键并点击单词,将打开包含突出显示术语的术语表表格。 

将术语表导出到Excel

术语定义可以帮助同一团队中的建模者在建模和相互通信时建立和维护一组通用的词汇表。你还可以使用Excel导出功能生成术语表的软副本,并与其他团队成员共享。

1. 打开术语表表格。

2. 点击表格工具栏中的Export to Excel按钮。

3. 在Export Excel窗口,指定要保存Excel文件的输出路径。

4. 保持其它设置不变,点击底部右端的Export按钮。

作为补充说明,可以将Excel中所做的更改导入到Visual Paradigm中的术语表中。如果需要,术语表的读者可以在Excel中进行更改。然后,点击glossary网格中的import按钮(在Visual Paradigm中),将Excel文件导入到Visual Paradigm中。导入按钮位于导出按钮的旁边。