使用clearcase管理工作文档.docx

使用clearcase管理工作文档.docx

《使用clearcase管理工作文档.docx》由会员分享，可在线阅读，更多相关《使用clearcase管理工作文档.docx（32页珍藏版）》请在冰豆网上搜索。

使用clearcase管理工作文档

使用ClearCase管理工作文档

1开始使用ClearCase

1开始使用ClearCase1

1.1进入ClearCaseExplorer1

1.2创建自己的view2

2把工作文档加入ClearCase管理7

2.1文档已经存在的情况7

2.2把新建的文档放入ClearCase下管理9

2.3把目录加入ClearCase配置管理9

3在ClearCaseExplorer下工作的基本操作10

3.1checkout/checkin操作10

3.2update操作13

3.3删除文件、重命名等基本操作15

4进一步使用ClearCase16

4.1修改LoadRules16

4.2对比文件的不同版本18

4.2.1对比当前版本和上一版本18

4.2.2对比文档的任意两个版本19

4.3选取文件的特定版本20

4.3.1修改配置规则（ConfigSpec）22

5实行不规范操作后的补救方法23

6clearfsimport命令的使用24

1.1进入ClearCaseExplorer

从开始菜单－>程序－>RationalClearCase－>ClearCaseExplorer，或从桌面的快捷方式进入ClearCaseExplorer。

如下图所示：

1.2创建自己的view

1）选择快捷图标栏中的“Toolbox”->“BaseClearCase”（在上图的左下角），如图所示

2）在左侧的快捷图标栏中选择“CreateView”

3）弹出View创建向导对话框，如下所示

不做任何改动，直接点击“下一步”

4）如果客户端安装了MVFS（支持动态视图DynamicView），则会出现如下界面，

选择“Snapshot”快照视图。

5）选择快照视图的位置

使用缺省目录名，或改变“Wherewouldyoulikeit”下的文本框中列出的目录，注意：

如要改变，必须保证最右侧目录的上级目录存在，即，如上图所示“D:

\ClearCase_Views”必须存在，该目录用于保存从Server端传来的数据；最右侧目录的命名遵循“姓名缩写_内容简写”的格式，如“hyc_worklog”。

不用设置其他选项，按“完成”，弹出确认对话框，如下

按“OK”。

6）选择文件加载规则

选择自己工作要用的目录

然后，按“Add>>”，如下图所示

按“OK”按钮，ClearCase报告，视图创建成功

按“OK”，在“View”->“General”中可以看到建好的view，如下图所示

注意：

view.dat文件无论何时，千万不可删除。

否则view无法正常工作。

2把工作文档加入ClearCase管理

2.1文档已经存在的情况

先在Windows的资源管理器拷贝要加入ClearCase管理的文件，然后在ClearCaseExplore的view的浏览器窗口点击右键，如下图所示

选择“Paste”粘贴，自己所拷贝的工作文档出现在列表框中，如下图

这时，可以看文件对应的“kind”一栏是“view-privatefile”，它还没有被ClearCase进行版本管理，也只在你自己的视图中才存在。

1）将文档加入ClearCase配置管理

在新文档上点击鼠标右键，选择“AddtoSourceControl…”，如下图

ClearCase弹出对话框，要求输入评语“Comment”，输入自己的评语如下

注：

其中的XXX为示意文字，具体信息根据实际情况填写，填写内容不限于示例内容。

不要选择下方的CheckBox。

按“OK”，ClearCase完成操作。

这时，文件的“kind”栏就应该是“FileElementVersion”，而且用鼠标右键点击该文件，确认弹出菜单内容发生变化，其中有“CheckOut…”，如下图所示

说明，该文档已经纳入ClearCase的配置管理之中。

2.2把新建的文档放入ClearCase下管理

只需在保存新建的文件时，保存路径选择你建立view时的路径，ClearCaseExplorer中就可以见到新建的文档了。

例如：

如果view建在E:

\xx_view，其下有一个放工作文档的文件夹workdoc，那么保存文件时的路径只要选用E:

\xx_view\workdoc，文件就可以在ClearCaseExplorer中的workdoc文件夹下看到。

同样，这样的文件还只是“viewprivate”属性，需要“addtosourcecontrol”。

2.3把目录加入ClearCase配置管理

方法和把文件加入ClearCase配置管理类似，先粘贴，然后在右键菜单中选择“addtosourcecontrol”。

需要注意的是，使用AddtoSourceControl命令添加目录不会将目录下的文件一起加入VOB。

如果目录下文件不太多，可以用Ctrl＋A把文件全选，然后一起“addtosourcecontrol”。

如果有大量的、目录结构复杂的文件要加入ClearCase配置管理，需要使用命令行方式下的命令clearfsimport，这个命令的使用在最后解释。

还会发生当你想“addtosourcecontrol…”却不能进行的情况，如图：

这表示有人checkout了该文件的上级目录，具体何人操作提示框里也注明了，可以去询问对方，也许目录是无意中被checkout了，就该立即checkin，不再影响别人需要的操作；如果对方确实需要对目录checkout，可以告诉他尽快完成修改，将目录checkin。

3在ClearCaseExplorer下工作的基本操作

ClearCase的基本操作都可以在右键菜单中找到，（鼠标要点中准备操作的文件或目录）

3.1checkout/checkin操作

ClearCase管理下的文件属性都是只读的，只是要看某个文件，直接打开即可。

如下图：

如果要修改文件，必须先对该文件进行“checkout”，如下图：

随后，出现“checkout”对话框，要求填写注释，一般要简单记录修改的目的，可以包括：

who，when，what等信息。

然后该文件前出现被checkout的标记，为绿色小勾，如图：

表示该文件此时不是只读属性，再打开时时可以编辑保存的。

编辑修改文件，改好保存后，再进行“checkin”操作，

出现“checkin”对话框，还是需要填写注释，如图：

点“OK”后，完成checkin，绿色小勾消失，文件的版本升一级，且又是只读的了。

如果对修改的结果还不满意，希望文件仍然是checkout前的版本，就不要进行“checkin”，取而代之为“undocheckout…”，这样相当把前面的操作都取消了。

系统会询问是否取消checkout，并默认会把改后的内容保存为一个view_private属性的.keep的副本文件，如果不想保留目前修改的成果，就把前面的勾去掉。

如下图：

点“Yes”后，之前的checkout操作被取消。

3.2update操作

由于snapshot是种静态视图，要经过“update”操作在可看到你工作所在的目录的最新变化（那些别人造成的变化，添加的新文件，文件的新版本）。

根据需要，如果只想看到一个目录下的变化，“update”该目录即可，如图：

想知道最全面的变化，可update整个view。

右击view，选择“updateview…”如图：

点“updateview…”后，先出一个对话框让你确认要更新的view，如图：

更新后会出更新结果的报告，列出通过更新view发生了什么变化。

下图右侧信息显示：

update后，view中原有的7个文件有改变，并多了20个新文件。

关闭该窗口后，会弹出对话框询问是否保存更新结果，选NO，如图：

update完成了，最好再刷新

一下，保证显示最新的内容。

当多人使用同一个目录，需要了解彼此的工作状况时，一定要养成及时update的习惯。

可能需要每天早晨工作前update，也可能每天需要update多次。

3.3删除文件、重命名等基本操作

这些操作方法和在WindowsExplorer下没有区别，在右键菜单中都可以找到。

如图：

需要注意的是：

进行完这些操作后，被操作对象所在的目录应该被自动checkout/checkin，并提升版本，可时常会发生目录只被checkout，却没有checkin的情况。

这就需要在进行完这种操作后，养成人为检查的习惯。

譬如：

在test\gengyanyu下删除、移动、重命名了一些东西，然后要点中test，看看出现在右上方窗口的gengyanyu文件夹前是否有被checkout的绿勾标记，有的话就需要动手把这个文件夹checkin。

如下图，检查是否需要进行最后的收尾工作——把目录checkin。

4进一步使用ClearCase

4.1修改LoadRules

随着工作的进行，可能会需要在view中从服务器load新的目录，这时不用新建view，而只要修改原有view的LoadRules即可，方法如下：

1）右击view，选“PropertyofView”

2）在弹出的属性对话框中选“LoadRules”项，点“Editloadrules”键

3）出现新建view时出现过的“ChooseElementstoLoad”对话框，添加文件夹的方法也和那时相同，就不再写了，而且确定新的loadrules后，会自动updateview，过程也和前面描写的一样。

为了看到全部文件夹，需要选中“ShowAllVOBs”项。

4.2对比文件的不同版本

在ClearCase中可以直观的对比文本文件（.txt,.doc文件）的不同版本，方法如下：

注意：

进行此操作不需要checkout文件。

4.2.1对比当前版本和上一版本

右击要对比的文件，右键菜单中就有“ComparewithPreviousVersion”选项，点中此项，就可以看到当前版本（一般就是最新版本）和前一个版本的不同。

如果是.txt文件，对比的方式如下：

它把两次文本的区别一行一行的呈现出来。

如果对比的是Word文档，点击“ComparewithPreviousVersion”后，会把文档两个版本的内容在一个Word文档中显示，效果如下：

其中：

红色并在行中划线的，表示是最新版本删除的语句；红色并在字下划线的，表示是最新版本新增的语句；正常黑色的就是没有改变的部分。

4.2.2对比文档的任意两个版本

这样的操作要在ClearCaseTreeVersionBrowser下进行，方法如下：

1）右击要比较的文件，选“VersionTree”，如下图：

2）ClearCaseTreeVersionBrowser的界面如下：

该图就是文件test1.txt的版本树，眼睛盯着的就是load到客户端的版本——version3，也就是最新版本。

3）通过例子来说明如何比较任意版本。

比如想比较version2和version1，就要先单击代表version2的圆圈，该圈变红。

然后点击工具栏的

，就是“ComparewithAnotherVersion”的按钮。

再点version1的圆圈，这时鼠标是一个准星的样子，点中后，出现两个版本对比的界面，形式和上小节讲述的相同。

4.3选取文件的特定版本

基本上不推荐使用此操作。

一般情况下，我们选取文件版本的规则都是选取最新版本，对应的配置规则（ConfigRule）是：

element*\main\LATEST。

每个文件对应的配置规则可以在ClearCaseExplorer窗口中被看到，只要选ClearCaseExplorer的Tools菜单的Options项，选Element的“OtherOptions”，如图：

出现的“ElementOptions”对话框中，选“Display”页，加勾“Rule”一条。

确定上述操作后，在ClearCaseExplorer中也可以看出的选择文件版本的配置规则，如图：

Version栏下是view选中的版本，而Rule栏下则是选择的规则，element*\main\LATEST这条规则选择的就是文件的最新版本，可能是\main\3，也可能是\main\1，视文件有多少版本而定。

4.3.1修改配置规则（ConfigSpec）

基本上不推荐使用此操作。

修改ConfigSpec的方法和修改LoadRules相似，在“ViewProperty”中，选“ConfigSpec”页，点“Edit”，文本框就成为可修改的白色。

最初的ConfigSpec应该只有：

element*CHECKEDOUT,element*/main/LATEST两条，其后的都是LoadRules。

而选择特定文件的特定版本的方式就是在那两条配置规则间加入格式为：

element<文件名><版本号>的规则，表示对某文件选取特定的版本，上面的

elementtest1.txt/main/1就表示选文件test.txt的version1。

注意：

ConfigSpec中各条规则的顺序是有意义的，选择特定版本的规则必须放在element*CHECKEDOUT之后，element*/main/LATEST之前。

更改了ConfigSpec后，会view自动update，然后load文件时，test1.txt就会选取version1，其它文件依然选取最新版本。

如图：

如果选中test1.txt，点“VersionTree”，可以更清楚的看到，这时选中的版本（眼睛所在）在版本树中的位置。

5实行不规范操作后的补救方法

如果在资源管理器中强行去掉文件的“只读”属性，并修改并保存了一个文件，这时再到ClearCaseExplorer中可以看到文件前的标记有异常：

补救的方法如下：

对此文件进行“checkout”，出现对话框时，勾选“preservefilemodification”项，

点“OK”后，出现对话框：

点“Yes”，然后文件前的标记就是正常的绿色小勾了，打开文件也可以看出之前的修改没有丢失，然后可以继续修改保存，再“checkin”文件，就相当做了符合常规的checkout/checkin操作。

6clearfsimport命令的使用

该命令用于将大量文件导入VOB，将文件系统中的对象转化为受ClearCase管理的元素版本。

如果源文件或目录在VOB中不存在，就创建新的元素；否则，将增加新的版本。

如果不是VOBowner，必须使用-nsetevent参数此命令才能生效。

举例：

要将d:

\src下的所有文件（包括子目录）导入testVOB中。

1）首先，在开始菜单选择“运行”，键入cmd，打开Windows命令窗口。

2）使用clearfsimport命令，-recurse和–nsetevent参数是不可少的。

然后是你要导入的目录的路径，此例中为d:

\src，空格后是目标目录的路径，比如你的view建立在e:

\clearcase_view\test_view，希望把d:

\src其下的全部文件导入到view中test目录中，目标目录路径就为e:

\clearcase_view\test_view\test。

注意：

此时test下要有一个名为src的文件夹，不用有内容，也不用addtosourcecontrol，具体如下图

c:

\>clearfsimport-recurse-nseteventd:

\srce:

\clearcase_view\test_view\test

3）开始自动导入文件

如果按照前面操作还不能顺利导入，可以先进入目标目录下，使用命令形式为：

E:

\ClearCase_View\test_view\test>clearfsimport–recurse–nseteventd:

\src.

最后的点表示目标目录是当前路径，这样绝对可以顺利导入。

再回到ClearCaseExplorer下，可以看到test_view的test目录下的src已经有全部想导入的内容了，而且属性都已经是“ElementFileVersion”和“DirectoryVersion”，表示都被版本控制了。

4）clearfsimport命令的详细使用介绍

clearfsimport[-preview][-recurse][-rmname][-commentcomment]

[-mklabellabel][-nsetevent][-identical][-master][-unco][-downcase]source-name[...]target-VOB-directory

-preview

预览数据导入，但不真正导入数据。

-recurse

导入所有子目录下的文件。

-commentcomment

指定注释，缺省注释：

createdbyclearfsimport。

-nsetevent

指定事件记录和历史信息显示执行操作的用户和执行时间，而不是数据源的原始数据。

-identical

即使与前一版本相同，也创建一个新的元素版本。

-unco

如果一个源文件在VOB中已经存在，并且被checkedout，使用此选项将使用该元素执行uncheckout操作，并将文件保留为.keep文件。

source-name[...]

要导入VOB中的源数据（文件或目录）。

target-VOB-directory

源数据将要被导入的VOB目录。

注：

1请在编辑完成工作文档之后，将文档纳入配置库。

建议不要对入库文档进行checkout/checkin操作。

2凡入库文档不得通过Windows的资源管理器等更改权限，或进行增删操作，所有跟ClearCase有关的操作，应该在ClearCaseExplorer下进行。

如有问题，请与耿延煜联系，

email：

gengyanyu@