BEA WebLogic WorkShop与IBM Rational ClearCase集成

设置源代码管理与 ClearCase 的集成

WebLogic Workshop 支持 Workshop 应用程序及其所有项目或单个项目与 ClearCase 的集成。在这两种情况下， Workshop 应用程序或项目的所有文件都必须与单个 ClearCase Version Object Base (VOB) 相关。此限制也意味着：

· 必须以单一快照视图的方式定义 Workshop 应用程序或项目中的文件与 ClearCase VOB 之间的映射。

· 应用程序或项目的根目录必须位于 ClearCase VOB 的根目录下。如果应用程序或项目的根目录位于 VOB 根目录的子目录中，则所有父目录也必须位于 VOB 中。

一个 Workshop 应用程序有可能包含多个被映射到不同 VOB 中并具有不同的关联视图的项目。

注意： 建议您在 ClearCase 中创建一个快照视图，以便将您的 Workshop 项目文件映射到 ClearCase VOB 中。如果使用的是动态视图，则您有可能遇到 Workshop 出现意外行为。

将 Workshop 应用程序或项目添加到 ClearCase 中

1. 对于应用程序或项目文件所位于的 VOB ，请确保有可以访问其的快照视图。如果需要创建此视图，请参阅 ClearCase 文档或询问系统管理员。

2. 在 VOB 的根目录下的一个目录中，新建 Workshop 应用程序或项目。如果要复制或移动现有应用程序或项目，应先清理它，才能将其添加到源代码管理中，这样，生成工件才不会随源文件一起添加。要清理应用程序，请在 “ 应用程序 ” 窗格中选择此应用程序名称，单击鼠标右键，然后选择 “ 清理应用程序 ” 。要清理项目，请在 “ 应用程序 ” 窗格中选择此项目名称，单击鼠标右键，然后选择 “ 清理 <projectname>” 。

3. 如果要将应用程序添加到源代码管理中，请选择 “ 工具 ”-->“ 应用程序属性 ” ，然后选择 “ 源代码管理 ” 选项卡。如果要添加项目，请选择 “ 工具 ”-->“ 项目属性 ”-->“<projectname>” ，然后选择 “ 源代码管理 ” 选项卡，并清除 “ 使用应用程序的源代码管理设置 ” 选项。

4. 将 “ 源代码管理模块 ” 选项设置为 “ClearCase” 。

5. 设置 “"cleartool" 目录 ” 选项，使其指向 ClearCase cleartool 实用工具的位置。如果在安装时接受默认值，则包含 cleartool 实用工具的目录应类似于 C:/Program Files/Rational/ClearCase/bin 。请注意，应仅包括路径，而不包括文件名。 Cleartool 实用工具是 WebLogic Workshop 用来与 ClearCase 集成的命令行实用工具。

6. 将 “ClearCase 版本 ” 选项设置为您的服务器的版本。请务必验证是否已指定正确版本，因为如果版本不正确，可能会遇到 ClearCase 集成问题。

7. 如果您正在使用快照视图，则请将 “ClearCase 视图类型 ” 设置为 “ 快照 ” 。

8. 根据需要设置属性对话框中的其他选项。

9. 单击 “ 确定 ” 时， WebLogic Workshop 将验证 cleartool 实用工具的位置，并验证应用程序或项目的根目录是否位于 ClearCase VOB 下。如果您的视图是快照视图， WebLogic Workshop 还会提示您对应用程序或项目根目录的父目录执行更新操作。

将文件添加到 ClearCase 中

将 WebLogic Workshop 配置为与 ClearCase 集成之后，您可以将应用程序或项目中的文件通过 IDE 添加到 ClearCase 中。要添加文件，请在 “ 应用程序 ” 窗格中选择文件，单击鼠标右键，然后选择 “ClearCase”-->“ 添加 ” 或 “ 添加和签入 ” 。

有关如何将文件和目录添加到源代码管理中， ClearCase 的各个版本存在一些差异。这些差异在下列部分中进行了概述：

ClearCase V2003

如果使用 ClearCase V2003 版本，则在将文件添加到源代码管理中时，其父目录会自动作为元素添加并签出。如果添加应用程序或项目根目录，则此目录的父目录（它在 Workshop IDE 中不显示）会自动签出。您必须使用外部 ClearCase 工具来将此目录签入。

如果对文件执行 “ 添加和签入 ” 命令，则此文件的父目录会自动签入。

如果对目录执行 “ 添加和签入 ” 命令，您必须手工签入此目录的父目录，才能提交添加操作。

使用外部 ClearCase 工具

在某些情况下，您需要使用外部 ClearCase 工具（如 ClearCase Explorer 或 cleartool 实用工具）来对应用程序或项目中的文件执行某些操作。这些操作包括：

· 将 .work 文件添加到 ClearCase 中或将其签入。但是，将 .work 文件添加到源代码管理中之后，如果进行的更改会影响 .work 文件， WebLogic Workshop 就会提示您将其签出。

· 添加、签出或签入应用程序或项目根目录的父目录。仅在 V2003 版本中，将根目录添加到 ClearCase 中后，此目录将自动签出，但是，需要使用外部工具才能将其签入。

· 签入此分支上非最新版本的文件。

ClearCase Find Checkouts 实用工具可能能够与 WebLogic Workshop 一起使用。此实用工具在视图中显示所有签出，包括在 WebLogic Workshop 中不可见的签出，如应用程序或项目根目录的父目录。

签出文件

要从 WebLogic Workshop 内签出文件，请在 “ 应用程序 ” 窗格中用鼠标右键单击该文件，然后选择 “ClearCase”-->“ 签出 ” 。

如果要签出的文件不是 VOB 中的最新版本，则 “ 签出 ” 对话框中将显示警告。此时，建议在继续之前关闭对话框并更新文件。您也可以选择签出文件，并在提交文件时将所做更改与 VOB 中的最新版本合并。

请注意，不能签出可写入的文件。

停止 ClearCase 命令

有时 ClearCase 命令可能无法完成执行。如果出现这种情况，可以在 “ClearCase” 窗口中单击鼠标右键并选择 “ 停止 ” 来停止该命令。在启用 ClearCase 集成后，选择 “ 视图 ”-->“ 窗口 ”-->“ClearCase” 即可打开 “ClearCase” 窗口。

警告： 停止执行 ClearCase 命令时请务必谨慎，因为这样做会导致不可预测的或不希望的结果。