简介

本文介绍了一些建议和技巧，帮助您使用 IBM® Rational® Software Architect Design Manager Server Extension 优化 IBM® Rational® Design Management Server 的创建过程。然后文中描述了使用服务器自动安装的网络客户端，或者高级客户端，也就是 IBM Rational Software Architect Design Manager Client Extension。高级客户端作为已存在的 IBM Rational Software Architect 安装文件安装到相同的包组中。

本文的第一小节，创建服务器，是为服务器管理员准备的，而本文的第二小节，使用网络客户端 以及 使用 Rational Software Architect 客户端，是为用户准备的。

回页首

创建服务器

1. 获得一个 SSL 许可证

在开始安装服务器之前，您要申请一个 SSL（安全插座层）许可证。程序可能会花费一些时间，在此之后，您需要将其安装到服务器上。如果您没有一个有效的权限，那么服务器的所有功能仍然可用。但是，使用网络浏览器与服务器相联系的用户将会看到权限错误，而数据的安全性下降了，如图 1 所示。

2. 使用创建向导

您可以手动进行创建，但是最容易操作以及快速运行的方法是切换至 https://servername:port/jts/setup 并使用创建向导。（一般来说，该端口是 9443）。如果这是您第一次操作服务器，那么笔者推荐您点击 Next 按钮来执行向导的所有操作。不要过早地点击 Finish ，因为强烈推荐您使用接近最后一步的步骤，Create Sample Project（见于图 2）。如果您跳过了这一步，那么您就需要使用 Design Management 服务器来自己创建项目了。

3. 取消 ADMIN 访问

默认条件下，管理员用户名与密码都是 ADMIN。如果您运行了推荐的创建向导，那么您就需要关闭该账户了。如果您选择在创建过程中不关闭账户，那么您可以稍后将其关闭，或者只是更改一下密码。

4. 理解管理员的任务是如何组织的

理解管理员的任务是如何组织的，这一点非常重要。其中有一些是 Jazz Team Server （JTS）界面，而另外一些是部分 Design Management 程序。设置它将会影响到整个的服务器，包括服务器已授权用户的列表，友好服务器（您的服务器可以相交流的其他服务器），而末端数据库的类型是 JTS 管理页面的所有部分，从 Jazz Team Server Administration 部分，也就是 https://servername:port/jts/admin 的 Jazz Team Server Administration 部分进行访问（见于图 3）。在执行特定程序的设置之前，还应该配置 JTS 设置。

只在 Design Management 程序中起作用的设置，例如一个用户在给定的程序中拥有的权限，链接类型（用于定义友好服务器的链接），以及存储在末端数据库之中的实际模型内容，可以从其他的位置进行访问。这些位置包括 JTS 管理页面的 程序管理 部分，以及项目区域之内的超链接网络页面（严格来说，您还可以从 Application Administration 页面中得到用户管理与许可证管理，但是恰当的分类要更加的方便）。

接下来的三条建议详细诠释了三个范例：

• 创建许可证
• 创建 CLM 链接
• 导入模型内容

5. 适当地调整许可证

1. 为了管理页面，您可以切换至 https://servername:port/jts/admin，并从 Jazz Team Server Administration 部分中，点击 Jazz Team Server - User Administration 超链接。确定您向用户分配了适当的储存库权限以及客户访问许可证。

在添加一个用户并分配 Rational Software Architect Design Manager – Design Manager 许可证或者 Rational Software Architect Design Manager – Design Reviewer 许可证之后，您会很容易忘掉向用户分配访问 Design Management 项目权限的其他步骤。

2. 为了向一个项目添加一个用户，您可以切换至 Jazz Team Server Administration Home 页面。
3. 在 Application Administration 部分中，选择 Design Management 之下的 Project Areas 超链接。
4. 然后选择页面 Active Project Areas 部分中您想要的项目。
5. 确定在 Members or Administrators 部分之下添加用户。

为什么您需要这一步呢？首先，不是每个用户都能访问所有的项目。同样，将来，相同的 JTS 服务器上可能有 Design Management 程序之外的程序。项目层次上的访问控制因此变得特别重要起来。

6. 学习怎样创建 SLM 链接

为 Rational® Collaborative Lifecycle Management （CLM）创建链接的三个主要部分：

指定友好的服务器

1. 正如前面所讨论的那样，必须要指定友好服务器。您可以切换至 JTS 主页面，然后点击 Jazz Team Server – Server Administration 超链接以执行该操作。在左边的菜单之中点击 Friends (Outbound) ，并添加您想要创建链接的服务器。

图 5 的大图

2. 在您添加友好服务器之后，您就应该登录到其他的服务器上，然后认证您的请求。就算您不能执行该操作（可能您没有密码）也没有关系。通过切换至友好服务器的 Server Administration 页面，然后在左边的菜单中点击 Consumers （inbound），您或者能够访问该服务器的其他人稍后可以执行该操作。您（或者登录到服务器上的其他人）就有计划接收或者拒绝请求了。

图 6 的大图

第二步和第三步针对特定的程序，这样就不能从 Jazz Team Server Administration 部分中的超链接访问它了。

将您的项目与一个工件容器联系起来

第二步是创建特定服务器与项目之间的联系。

1. 从 Jazz Team Server Home 页面中的 Manage Applications 部分内，您可以点击 Project Areas 超链接。
2. 选择一个项目区域，然后找到 Associations 部分并点击 Add hyperlink 以添加联系选择工件容器的支持。您可以将工件容器当做包含特定类型工件的项目。
3. 使用弹出对话框窗口，来选择链接联系的类型，类型要么是 Uses 要么是 Provides。

图 7 的大图

创建 UI 中会出现的联系类型

第三步和最后一步涉及到了实际的联系类型，当末端用户添加联系时，实际的联系类型就会出现在 UI 之中了。

1. 首先您必须切换至项目区域，并创建 CLM 链接（快捷方式： https://servername:port/dm/web/projects/YourProjectArea#action=jazz.viewPage&id=rmps.app.settings）。

Project Linking 页面在特定项目的 Project Properties 中。您可以从网络页面顶部的菜单中访问 Project Properties。

当您创建一个链接时，您还可以创建“反向链接”。为什么要有一个双向的链接呢？假设您正在设计一个程序，您注意到注销过程的序列图存在严重的问题。然后您在 IBM® Rational Team Concert™ 中提交了一个工作项。如果您要创建一个从该操作到 Rational Team Concert 中工作项的链接，那么自动创建一个从工作项到序列图的链接也是非常方便的。

7. 将来自不同机器的模型导入到服务器上

在 IBM Installation Manager 中，您可能已经注意到导入的引擎单独安装在服务器上。可能有一个原因：不能安装导入引擎，不能在与服务器相同的机器上运行。这使得您可以导入不在服务器上的模型，甚至在不同的机器上运行多个导入引擎，当您拥有多个导入引擎时，这一点十分有用。因此，当您在 Import Definition 网络页面中输入工作区路径是，确定您向导入引擎所运行模型输入了路径。

服务器是怎样决定使用哪一个导入引擎呢？这是由引擎名定义的，您可以在 Rational Software Architect Import Engine Configuration 内容与 Import Definition 页面指定操作（图 9）。

图 9 的大图

8. 导入模型的建议

加快导入过程

是否急着导入您的模型？确定 Validate model contents 复选框在 Request Import 页面上取消选择了。

对于简单的模型，您可能会注意到导入器所花费的时间没有太大的差异，但是对于比较复杂的模型，时间差异就比较明显了。

记住破损引用的基本确认仍然在执行，不管 Validate model contents 复选框是否被选中了。

图 10 的大图

解决导入模型内破坏引用的问题

如果您拥有大量破坏的引用，那么您可能会丢失一些导入的项目，或者忘记指定一个路径图。来自 Rational Software Architect 的路径图如果稳定的话，将会帮助您在不同的环境中打开模型，而附属移动到不同的地方时，保护引用不受破坏。

1. 为了想好加入什么常数，您可以在 Rational Software Architect 中打开您的工作区。
2. 选择 Window > Preferences > Modeling > Path Maps。记一下 路径变量。

在图 11 之中，Preferences 页面中 Path Maps 部分的“Available path variables”显示了一个名为 SHARED_PROFILES 的通用路径映射，它指向 C:/shared/CustomProfiles.

建议：
回到 Import Definition 网络页面：如果您选择了 Import an entire workspace 选项，请确定相应的项目位于您的工作区捏。如果不在，那么您需要在 Rational Software Architect 中打开您的工作区，并向您的工作区添加引用的项目，或者点击 Delete Import Definition 并选择 Import individual projects 选项。确定这一次您加入了引用的项目。

3. 接下来，展开 Path Maps 部分并点击 Add hyperlink。
4. 在 Variable 列中，输入路径图的名字。它必须对应于 Rational Software Architect 内 Path Maps Preferences 页面中的名字。
5. 在 Value 列之中，输入导入服务器项目的名字。不要 输入目录名，例如 C:/shared/CustomProfiles，如 Rational Software Architect 的 Path Maps 偏好页面所示。

建议：
如果您选择了 Import individual projects 选项，那么请确定您按照 Project Name to Use After Import 列中所示的那样输入了项目名。

图 12 的大图

导入期间运行一个 Ant 脚本

您可能注意到在 Import Definition 页面上可能有一个运行 Ant 脚本的选项。该脚本是在将资源导入到服务器之前执行的。它的典型使用方法是在导入之前从储存库获得最新的代码，显示在工作区内。在与安排的导入相联系时，这一点十分有用。

					
<project name="Example" default="main">
  <target name="main">
    <record name="theExample.log" loglevel="verbose" append="false"/>
    <antcall target="theExample"/>
    …
  </target>
  
  <target name="theExample">
    <echo message="This message will be logged!"/>
  </target>
  …
  
</project>

9. 理解进程模板

当您在创建一个新项目时（而不是使用默认的 Sample Project），您需要设置一个进程模板。您可以自己定义进程模板（见于文献的“创建一个新的进程模板”部分，参考资料 中列出了），或者使用软件中所包含的两个标准进程模板。在 Windows 系统上，它会被默认安装：
drive:\installationdirectory\server\conf\dm\processtemplates
where
drive:\installationdirectory
is C:\Program Files\IBM\DesignManagement

使用不同模板时应该注意的关键点是 角色以及 默认的许可证。

• Basic Process Template，它默认安装在 Sample Project 中（或者选择在创建过程中创建），没有预定义的角色，所以所有人都是可以执行几乎所有操作的成员（导入角色，添加注释，等等）。
• 但是，对于一个真实的项目来说，您一般有定义角色的用户。Default Process Template 包含了 Architect，Commenter，Publisher 以及 Project Lead 角色，每种角色都有其自己的许可证，所以它更适合于一个真实的项目。

您可以从项目区域页面的 Permissions 项中看到并调整许可证。

1. 首先，在左边的 Team Configuration 表格中点击 Project Configuration 或者 Team Configuration。
2. 然后，点击 Roles 列表中的角色，以查看更新的 Permitted Actions 树形结构。

图 13 的大图

建议：
如果您按照与 Sample Project 相同的方式，除了进程模板之外，创建另一个项目，那么在作为拥有默认进程角色的用户登录时，执行相同的操作您就可能遇到一个许可证问题。除了 适当地调整许可证 部分中所提到的那样，您要确定在项目区域页面的 Overview 项中定义进程角色（当您将鼠标移到 Actions 列下面的行上时，按钮就会出现了）。

回页首

使用网络客户端

确定您读取了关于两个客户端的部分，因为一些建议只在一个部分中提到了，并解释了怎样在其他的客户端中完成相同的任务。

10. 尽快得到信息

您可以为每个项目添加自己的操作板和工具。添加工具的选项隐藏在下向箭头 这里，而 加号图标用于添加一个新的项目以包含其他的工具。这些工具属于 Design Management：最近的注释，最近的联系，评审，顶级资源，确认，以及一个“欢迎”工具。

图 14 的大图

11. 草拟图表来添加可见的注释

您可以向模型元素添加文本注释，但是当您对图表执行该操作时，您还可以对图表做一个草图，以进一步演示您的想法。当图表背景变成浅蓝色，而配置板中的工具可以使用时，您就可以制作草图了。

该建议也适用于 Rational Software Architect 客户端。

图 15 的大图

12. 在 Explorer 中显示丢失的元素

您是否想要知道一次交流中都执行了什么操作？默认条件下，不是顶层元素的元素不会显示出来。为了将它们显示出来，您可以点击 Explorer 中的 下向箭头，并选择 Show Resource Contents。

而且，名为 Hide unnamed elements 的筛选器默认条件下处于激活状态。为了关闭该筛选器，您可以点击 Explorer 之中的 下向箭头并选择 Filters。（为了调整所有用户的筛选器设置，您可以从顶部的工具栏中选择 Project Properties ，接着在左边的菜单中选择 Explorer Filtering ）。

在Rational Software Architect 客户端内，您可以在 Design Explorer 视图的顶部找到下向箭头。

在网络客户端之中，您可以点击元素名字旁边的右向箭头 来查看其内容。

13. 使用关系图来显示一个元素的关系

您可以点击 Explorer 内元素旁边的下向箭头（ ），然后在菜单中选择 Relationship Diagram… 选项，来创建关系图。

当一个关系图打开时，关系不会显示在图表中，而是显示在图表右边的文本属性内。点击图表上的图形来选择背景元素，然后点击弹出气泡内的绿色加号（ ），以在图表内显示其关系。

图 17 的大图

14. 找到丢失的注释

网络客户端中是否有注释没有出现在 Rational Software Architect 客户端之中？这是因为当您选择更高层次的资源（例如一个包）时，网络客户端显示了资源内容的注释（例如对事件所作的注释）。但是，在 Eclipse 客户端上，这些元素之间的注释区别非常大：您需要选择包含的元素以查看其注释。

15. 使用搜索快捷方式

查找特定类型的图表？在搜索框中输入 序列图 （或者您所搜索图表的任意类型图表的名字）。

该建议也适用于 Rational Software Architect 客户端。

16. 创建快照

在创建一个评审之前创建一个快照。这很重要，因为创建一个快照的过程不是即时的。

回页首

使用 Rational Software Architect 客户端

确定在两个客户端上阅读段落，因为只有一部分提到了一些建议，它介绍了在其他的客户端上怎样完成相同的任务。

17. 创建一个服务器连接

使用 Design Explorer 视图来添加对服务器的连接。

为了创建对服务器的首个连接，您可以选择 Click here 超链接。对于随后的连接，右击 Server Connections 项目并选择 New Model Repository Connection。

建议：
如果连接不能正常发挥作用：

• 确定在 URL 的末端输入了 /dm （而不是 /dm/web）。
• 服务器默认使用端口 9443。
• 协议应该是 https，而不是 http。
• 试着使用一个网络浏览器来连接到网络客户端上。这可以帮助您识别连接的问题。

18. 为储存库资源调整缓存设置来优化性能

来自服务器的资源存储在缓存内，以降低网络拥堵并提高性能。如果您拥有大量的可用内存，那么您可以增加缓存的大小。

1. 为了执行该操作，您可以切换至安装文件夹（例如 C:\Program Files\IBM\SDP）并备份 eclipse.ini 文件。
2. 然后，在 eclipse.ini 文件制作，在文件的末尾添加以下的命令行：
   -Dcom.ibm.xtools.rmpc.ui.RepositoryResourceManager.REPOSITORY_UI_CACHE_SIZE=10

提醒：
确定将需要的缓存大小设置为 10。

19. 安装丢失的特性来更好地显示图和属性

您可以将 Rational Collaborative Architectural Management 客户端安装到 Rational Software Architect 中。但是如果特性尚未安装，而您尝试着打开一个需要特定特性（例如部署规划）的图表，那么您会看到一个对话框，让您在网络客户端中打开图表。为了处理其他的域，您可以使用 Installation Manager 来安装其他需要的特性。

20. 快速浏览元素

Comments 视图与 Design Explorer 树形视图和搜索结果之中的元素联系在一起。为了快速找到模型元素的注释，当您在从 Design Explorer 视图或者 Search （结果）视图中选择元素时，保持该视图为打开状态。而且，Properties 视图将会与 Design Explorer 树形视图之中的元素联系起来。

21. 理解工作区链接

工作区链接（不要与协作性生命周期管理链接相混淆）用于创建储存库资源与工作区内相应资源之间的虚拟联系。工作区会搜索与储存库资源相关的资源，在联系至一个项目时，工作区链接会得到自动的添加。您可以手动添加这些链接，但是这通常都是不需要的。如果您正在处理资源的本地版本，并想要对储存库相关资源添加注释或者协作性生命周期管理链接，那么您就需要这些链接了。

如果您想要手动删除一个工作区链接，然后重启程序，那么相同的链接将会得到自动创建。您必须手动添加删除的工作区链接。

通过搜索链接指示器，您可以弄清一个工作区元素是否得到了链接，链接指示器如 Project Explorer 中左上角的图标 所示（见于图 20）。

22. 找到相关的网络客户端特性

在网络客户端中您是否能够生成一个关系图呢？
您只需在 Design Explorer 视图或者图表中右击元素，并选择 Relationship Diagram 操作。

在 Rational Software Architect 客户端中也可以得到它。

如果您发现网络客户端中的 Comment Dashboard 工具很有用，那么从网络客户端中也可以找到该功能。右击一个项目并选择 Search for elements with comments 或者 Search for comments。在 Search 视图以及结果中，您可以使用下拉菜单来筛选结果。

从 Rational Software Architect 客户端也可以得到它。

23. 在储存库上搜索相关的工作区元素

假设您有一个工作区元素，并想要查看它是否在储存库中。更糟糕的是，与许多其他元素一样，它叫做“Main”，所以执行一次文本搜索是不可能的。但是您可以通过 Properties 视图选择 General 项来在储存库中的工作区内快速找到一个元素。储存库部分包含了资源号码以及一个超链接，以在浏览器中打开资源。（如果 Properties 视图在工作区中显示了资源的属性，而资源创建了一个工作区链接，那么 Repository 部分将包含了一个超链接，来在 Design Explorer 中显示元素）。

同样，如果您在 Project Explorer 中右击元素并选择 Modeling References，References on Repository，那么引用工作区中选择资源的储存库上的资源将会出现在 Search 视图中。

注意：
图表中元素也可以得到背景菜单项。

24. 查看 CLM 联系

在网络客户端中有工作项的链接，但是 Rational Software Architect 客户端内这些链接在什么地方呢？您可以从 Properties 视图或者弹出窗口管理这些链接。

而且，创建来自 Rational Software Architect 客户端的链接是不可能的。为了执行该操作，您需要使用服务器，如 学习怎样创建 CLM 链接 部分所述。

25. 为储存库的模型生成报告

为了支持储存库模型上的报告，您需要 Rational Software Architect 8.0.2 版本或者后续版本。特别需要指出的是，尽管在 Rational Software Architect 8.0 和 Rational Software Architect 8.0.1 中您可能看到一些额外的报告选项，但是您仍然不能选择储存库模型。为了得到完整的功能，您必须从 Installation Manager 安装报告特性。对于 UML 与 BPMN，它们是：

• 结构报告 – 结构报告（UML）与 BIRT
• 结构报告 – 结构报告（BPMN）与 BIRT

结构报告 – 业务智能与报告工具（BIRT）将会与以上的构件一起自动安装。

3.0 版本并不支持为储存库上的部署-规划模型生成报告。为了得到更好的结果，在为储存库上的 BPMN 模型生成报告时，推荐您使用 Rational Software Architect 8.0.3 或者后续的版本。

有三种新的报告模板，包含了关于生成报告中注释与链接的细节信息：

• UML 储存库报告
• UML 储存库图报告
• BPMN 储存库图报告

回页首

总结

本文包含了最大程度利用 IBM Rational Design Management 服务器与客户端的建议与技巧。通过使用这些技巧，服务器管理员就能够创建设计管理服务器，同时更好地理解相应的操作方式，而末端用户也将会熟悉更有效设计的技术。

回页首

致谢

作者感谢 Anthony Hunter，Cherie Revells 以及 Dusko Misic 对本文所作的评审性工作，以及 Judith Broadhurst 对本文所作的编辑。

参考资料

学习

• 获得与本文相关的有用信息：
  • 有关 Rational Team Concert Ant 任务的详细内容，特别是 teamAccept 和 teamFetch 任务，参见 Jazz.net 库中的 Multiple Stream Development 文章。
  • 有关更全面的参考，参见 Jazz.net 上的 Jazz 构建 Ant 任务参考手册。
  • 有关更多信息，参见“Getting Started with Jazz Project Areas and Process documentation”中的 Creating a New Process Template 章节。
  • 阅读 Jazz 技术文档的 Installing the Design Management Server and Server Extensions 部分。
  
  
• 要了解更多有关 Rational Software Architect 的内容，可以从 developerWorks Rational Software Architect 产品专题 开始。也可以仔细查看 Rational Software Architect 产品概述 和 Rational Software Architect 信息中心，您将找到安装和使用指南。
  
  
• 了解更多有关协作式架构设计和分析的 Rational Design Management 项目。
  
  
• 访问 developerWorks 上的 Rational 软件区域，了解有关 Rational 软件交付平台产品的技术资源和最佳实践。
  
  
• 时刻关注 developerWorks 技术事件和 Web 广播，包括各种 IBM 产品和 IT 行业主题。
  • 参见 developerWorksLive! 技术讲座，快速了解 IBM 产品和工具，以及 IT 行业趋势。
  • 观看 developerWorks 演示中心，从初学者的产品安装和配置演示，到面向有经验开发人员的高级功能。
  
  
• 改善您的技能。查看 Rational 培训和认证 目录，其包含了许多广泛议题的课程类型。您可以在任何地方，任何时间学习它们，许多“启动”课程是免费的。
  
  

获得产品和技术

• 下载 Rational Software Architect Design Manager 试用版 进行评估，（并确保 检查更新）。
  
  
• 下载一个或两个版本的 Rational Software Architect 试用版：
  • Rational Software Architect 标准版
  • Rational Software Architect for WebSphere Software
  
  
• 按照最适合您的方式IBM 产品评估试用版软件： 下载进行试用，可以在线进行，在云环境中使用，或者在 SOA 沙箱 中花一些时间了解如何有效实施面向服务架构。
  
  

讨论

• 加入 Jazz.net 上的 使用 Design Management 讨论区。
  
  
• 通过 撰写一篇 developerWorks 文章 共享您的知识，并帮助那些使用 Rational 软件的人员。您将获得全球范围展示，RSS 企业联合组织，署名和建立，以及 developerWorks Rational web 网站专业编辑和出版的益处。查找 如何编写一篇好的 developerWorks ，以及如何进行。
  
  
• 跟随 Facebook 和 Twitter (@ibmrational) 上的 Rational 软件，并添加您的评论和请求。
  
  
• 您可以加入 Rational 讨论区，cafés 和 wikis，询问并回答问题，增加您的专业技能。
  
  
• 通过加入 developerWorks 中文社区，与其他人员联系，分享您的兴趣爱好，并响应 开发人员驱动的博客。
  
  

关于作者

Wayne Diu 是一名 IBM Rational 高级软件开发人员。他曾经为 Rational 建模平台设计和实现过 UML 建模特性，并且他是负责创建元模型集成框架的开发人员之一。他开发了许多其它工具特性，例如打印、验证标记器改进，以及重构支持。Wayne 也是 Design Management 的开发人员之一，即本文所要谈到的。

为本文评分

评论

回页首

内容

• 简介
• 创建服务器
• 使用网络客户端
• 使用 Rational Software Architect 客户端
• 总结
• 致谢
• 参考资料
• 关于作者
• 评论