StarTeam

StarTeam 用户指南 

StarTeam ®

Borland Software Corporation 

100 Enterprise Way 

Scotts Valley, California 95066-3249 

www.borland.com 

Borland Software Corporation 可能拥有涵盖本文档主旨的专利和 / 或待批专利申请。要获得适用专利列 

表 , 请参阅产品光盘或 About ( 关于 ) 对话框。提供本文档并不表示向您发放这些专利的任何许可证。 

版权所有 © 1995–2005 Borland Software Corporation。保留所有权利。所有 Borland 品牌名和产品 

名均为 Borland Software Corporation 在美国和其它国家 / 地区的商标或注册商标。其它所有标记均为 

其各自所有者的财产。 

有关第三方条件和免责声明 , 请参阅产品光盘上的 “ 发行说明 ”。 

美国印制。

目录 

第 1 章 

前言 1 

联系 Borland 支持 . . . . . . . . . . . . . . . . . . . 1 

文档约定 . . . . . . . . . . . . . . . . . . . . . . . 2 

第 2 章 

StarTeam 简介 3 

StarTeam 有何新功能 ?. . . . . . . . . . . . . . . . 3 

StarTeam 的变体 . . . . . . . . . . . . . . . . . . . 4 

使用本手册 . . . . . . . . . . . . . . . . . . . . . . 4 

了解 StarTeam . . . . . . . . . . . . . . . . . . . . 5 

使用项目视图窗口 . . . . . . . . . . . . . . . . . . . 7 

使用文件夹层次 . . . . . . . . . . . . . . . . . . . . 8 

使用上部窗格 . . . . . . . . . . . . . . . . . . . . . 8 

使用下部窗格 . . . . . . . . . . . . . . . . . . . . . 10 

选择 Detail 选项卡 . . . . . . . . . . . . . . . . . 10 

选择 History 选项卡 . . . . . . . . . . . . . . . . 11 

选择 Label 选项卡 . . . . . . . . . . . . . . . . . 11 

选择 Link 选项卡 . . . . . . . . . . . . . . . . . . 11 

选择 Reference 选项卡 . . . . . . . . . . . . . . 12 

使用标题栏 . . . . . . . . . . . . . . . . . . . . . . 12 

使用状态栏 . . . . . . . . . . . . . . . . . . . . . . 13 

使用版本控制 . . . . . . . . . . . . . . . . . . . . . 14 

使用缺陷跟踪 . . . . . . . . . . . . . . . . . . . . . 15 

使用需求 . . . . . . . . . . . . . . . . . . . . . . . 17 

使用任务 . . . . . . . . . . . . . . . . . . . . . . . 17 

使用主题 . . . . . . . . . . . . . . . . . . . . . . . 18 

第 3 章 

使用项目和视图 21 

添加对服务器的访问 . . . . . . . . . . . . . . . . . 21 

打开现有项目 . . . . . . . . . . . . . . . . . . . . . 23 

在工作站和服务器之间传输数据 . . . . . . . . . . . 25 

使用视图快捷方式 . . . . . . . . . . . . . . . . . . . 25 

切换视图 . . . . . . . . . . . . . . . . . . . . . . . 26 

将视图配置到过去的某个时间点 . . . . . . . . . . . 26 

控制文件状态信息 . . . . . . . . . . . . . . . . . . . 27 

使用备选工作文件夹 . . . . . . . . . . . . . . . . . 28 

使用视图配置文件 . . . . . . . . . . . . . . . . . . . 28 

控制配置文件中的文件夹 . . . . . . . . . . . . . 29 

控制配置文件中的 EOL 字符和路径区分大小写 . . 29 

查看视图属性 . . . . . . . . . . . . . . . . . . . . . 30 

刷新视图 . . . . . . . . . . . . . . . . . . . . . . . 30 

查看连接属性 . . . . . . . . . . . . . . . . . . . . . 30 

从 StarTeam 注销 . . . . . . . . . . . . . . . . . . . 31 

第 4 章 

使用 StarTeam Toolbar 33 

启动工具栏 . . . . . . . . . . . . . . . . . . . . . . 34 

打开工具栏窗口 . . . . . . . . . . . . . . . . . . . . 34 

指定工具栏户界面 . . . . . . . . . . . . . . . . . . . 35 

启动时显示工具栏窗口 . . . . . . . . . . . . . . . 36 

工具栏窗口最小化时隐藏任务栏按钮 . . . . . . . 37 

隐藏工具栏系统托盘图标 . . . . . . . . . . . . . 37 

隐藏工具栏用户界面 . . . . . . . . . . . . . . . . 38 

登录 StarTeam 服务器 . . . . . . . . . . . . . . . . 38 

查看高速缓存的服务器 / 用户关联 . . . . . . . . 38 

以不同的用户身份登录 . . . . . . . . . . . . . . 39 

使用相同的用户名和密码 . . . . . . . . . . . . . 40 

启动工具 . . . . . . . . . . . . . . . . . . . . . . . 41 

自定义工具栏 . . . . . . . . . . . . . . . . . . . . 41 

添加工具 . . . . . . . . . . . . . . . . . . . . . 42 

修改工具属性 . . . . . . . . . . . . . . . . . . . 43 

删除工具 . . . . . . . . . . . . . . . . . . . . . 45 

刷新工具栏 . . . . . . . . . . . . . . . . . . . . 45 

管理工具栏窗口 . . . . . . . . . . . . . . . . . . . 45 

折叠和展开工具栏窗口 . . . . . . . . . . . . . . 45 

调整工具栏窗口大小 . . . . . . . . . . . . . . . 46 

最小化工具栏窗口 . . . . . . . . . . . . . . . . 46 

关闭工具栏窗口 . . . . . . . . . . . . . . . . . . 46 

显示工具栏帮助信息 . . . . . . . . . . . . . . . . . 46 

显示工具栏的 About 对话框 . . . . . . . . . . . . . 46 

退出工具栏 . . . . . . . . . . . . . . . . . . . . . . 47 

第 5 章 

管理文件夹 49 

了解 StarTeam 文件夹层次 . . . . . . . . . . . . . 49 

添加新 StarTeam 文件夹 . . . . . . . . . . . . . 52 

添加现有 StarTeam 文件夹 . . . . . . . . . . . . 54 

查找工作文件夹 . . . . . . . . . . . . . . . . . . . 56 

使用视图的备选工作文件夹 . . . . . . . . . . . . . 57 

向视图添加 StarTeam 文件夹 . . . . . . . . . . . . 59 

更改 StarTeam 文件夹名或说明 . . . . . . . . . . . 62 

从 StarTeam 文件夹中排除文件 . . . . . . . . . . . 62 

为其它操作系统文件创建 StarTeam 文件夹 . . . . . 63 

使用备选工作文件夹 . . . . . . . . . . . . . . . . . 64 

更改工作文件夹 . . . . . . . . . . . . . . . . . . . 65 

使用视图配置文件中的文件夹属性 . . . . . . . . . . 66 

第 6 章 

在上部窗格中管理数据 67 

筛选器性能 . . . . . . . . . . . . . . . . . . . . . . 67 

控制列 . . . . . . . . . . . . . . . . . . . . . . . . 67 

对数据排序和分组 . . . . . . . . . . . . . . . . . . 68 

使用查询 . . . . . . . . . . . . . . . . . . . . . . . 70 

应用现有查询 . . . . . . . . . . . . . . . . . . . 70 

创建查询 . . . . . . . . . . . . . . . . . . . . . 71 

创建简单查询 . . . . . . . . . . . . . . . . . . . 72 

创建较复杂的查询 . . . . . . . . . . . . . . . . 74 

排除查询故障 . . . . . . . . . . . . . . . . . . . 76 

编辑查询 . . . . . . . . . . . . . . . . . . . . . 77 

复制查询 . . . . . . . . . . . . . . . . . . . . . 77 

删除查询 . . . . . . . . . . . . . . . . . . . . . 78 

使用筛选器 . . . . . . . . . . . . . . . . . . . . . . 78 

应用现有筛选器 . . . . . . . . . . . . . . . . . . 79 

创建筛选器 . . . . . . . . . . . . . . . . . . . . 79 

编辑筛选器 . . . . . . . . . . . . . . . . . . . . 81 

复制筛选器 . . . . . . . . . . . . . . . . . . . . 81 

重置筛选器 . . . . . . . . . . . . . . . . . . . . 82 

删除筛选器 . . . . . . . . . . . . . . . . . . . . 82 

为查询和筛选器设置访问权限 . . . . . . . . . . . . 82 

i

了解字段 . . . . . . . . . . . . . . . . . . . . . . . 83 

关系运算符 . . . . . . . . . . . . . . . . . . . . 83 

文件字段 . . . . . . . . . . . . . . . . . . . . . . 84 

更改请求字段 . . . . . . . . . . . . . . . . . . . 93 

需求字段 . . . . . . . . . . . . . . . . . . . . . 100 

任务字段 . . . . . . . . . . . . . . . . . . . . . 107 

主题字段 . . . . . . . . . . . . . . . . . . . . . 114 

审核日志字段 . . . . . . . . . . . . . . . . . . 119 

第 7 章 

使用 Visual Merge 和 Visual Diff 125 

Visual Merge 和 Visual Diff 实用程序比较 . . . . . 125 

使用 Visual Merge . . . . . . . . . . . . . . . . . 127 

使用独立实用程序 . . . . . . . . . . . . . . . . 127 

在 StarTeam 中使用 Visual Merge. . . . . . . . 129 

使用主窗口合并文本文件 . . . . . . . . . . . . 130 

更改文件编码 . . . . . . . . . . . . . . . . . . 131 

搜索文本文件 . . . . . . . . . . . . . . . . . . 132 

退出 Visual Merge . . . . . . . . . . . . . . . . 133 

自定义 Visual Merge . . . . . . . . . . . . . . 134 

对二进制文件使用 Visual Merge . . . . . . . . 135 

使用 Visual Diff . . . . . . . . . . . . . . . . . . . 135 

使用 View Diff 主窗口 . . . . . . . . . . . . . . 136 

使用菜单命令和工具栏按钮 . . . . . . . . . . . 137 

更改文件编码 . . . . . . . . . . . . . . . . . . 138 

用鼠标操控窗口拆分条 . . . . . . . . . . . . . 139 

比较文件和查看差异 . . . . . . . . . . . . . . . 140 

搜索文本文件 . . . . . . . . . . . . . . . . . . 140 

合并或打印比较文件 . . . . . . . . . . . . . . . 141 

自定义 Visual Diff . . . . . . . . . . . . . . . . 142 

第 8 章 

管理文件 145 

使用处于版本控制之下的文件 . . . . . . . . . . . 145 

使用上部窗格中的文件列表 . . . . . . . . . . . . . 146 

使用文件筛选器 . . . . . . . . . . . . . . . . . 147 

确定文件状态 . . . . . . . . . . . . . . . . . . . . 148 

将文件添加到视图 . . . . . . . . . . . . . . . . . 149 

查看或设置可执行位 . . . . . . . . . . . . . . . . 151 

从 StarTeam 打开文件 . . . . . . . . . . . . . . . 151 

从 StarTeam 编辑文件 . . . . . . . . . . . . . . . 152 

更新文件状态 . . . . . . . . . . . . . . . . . . . . 153 

签入文件 . . . . . . . . . . . . . . . . . . . . . . 153 

签出修订 . . . . . . . . . . . . . . . . . . . . . . 156 

了解状态对签入和签出的影响 . . . . . . . . . . . 159 

查看修订内容 . . . . . . . . . . . . . . . . . . . . 160 

比较文件内容 . . . . . . . . . . . . . . . . . . . . 160 

合并文件 . . . . . . . . . . . . . . . . . . . . . . 161 

在 StarTeam Windows 客户机中 . . . . . . . . 161 

在 StarTeam Cross-Platform 客户机中 . . . . . 163 

在文件中使用关键字 . . . . . . . . . . . . . . . . 164 

修改文件属性 . . . . . . . . . . . . . . . . . . . . 166 

设置文件选项 . . . . . . . . . . . . . . . . . . . . 168 

第 9 章 

使用需求 169 

在上部窗格中显示现有需求 . . . . . . . . . . . . . 169 

使用树格式的益处 . . . . . . . . . . . . . . . . 171 

使用列表格式的益处 . . . . . . . . . . . . . . . 172 

使用需求筛选器 . . . . . . . . . . . . . . . . . . . 172 

使用下部窗格 . . . . . . . . . . . . . . . . . . . . 173 

创建需求或子需求 . . . . . . . . . . . . . . . . . . 173 

从 CaliberRM 导出需求 . . . . . . . . . . . . . . . 176 

从 CaliberRM 导入需求 . . . . . . . . . . . . . . . 176 

在 StarTeam 中显示 CaliberRM 需求 . . . . . . . . 177 

第 10 章 

跟踪更改请求 179 

更改请求跟踪系统模型 . . . . . . . . . . . . . . . 180 

内置工作流 . . . . . . . . . . . . . . . . . . . . . 181 

在上部窗格显示现有更改请求 . . . . . . . . . . . . 182 

使用更改请求筛选器 . . . . . . . . . . . . . . . . . 184 

使用现有更改请求 . . . . . . . . . . . . . . . . . . 185 

使用下部窗格 . . . . . . . . . . . . . . . . . . . . 185 

提交更改请求 . . . . . . . . . . . . . . . . . . . . 186 

分配更改请求 . . . . . . . . . . . . . . . . . . . . 188 

解决未决的更改请求 . . . . . . . . . . . . . . . . . 189 

核实已解决的更改请求 . . . . . . . . . . . . . . . 190 

结束已核实的更改请求 . . . . . . . . . . . . . . . 191 

摘要 . . . . . . . . . . . . . . . . . . . . . . . . . 192 

使用报告和图表 . . . . . . . . . . . . . . . . . . . 193 

第 11 章 

管理任务 197 

在上部窗格中使用任务 . . . . . . . . . . . . . . . 197 

使用树格式的益处 . . . . . . . . . . . . . . . . 198 

使用列表格式的益处 . . . . . . . . . . . . . . . 199 

使用任务筛选器 . . . . . . . . . . . . . . . . . . . 200 

创建任务或子任务 . . . . . . . . . . . . . . . . . . 200 

分配任务资源 . . . . . . . . . . . . . . . . . . . . 203 

估计完成任务需要的时间 . . . . . . . . . . . . . . 204 

将工作添加到任务或子任务 . . . . . . . . . . . . . 205 

向任务添加说明 . . . . . . . . . . . . . . . . . . . 206 

为任务设置自定义属性字段 . . . . . . . . . . . . . 207 

包含附件 . . . . . . . . . . . . . . . . . . . . . . . 208 

为任务修订加入注释 . . . . . . . . . . . . . . . . . 209 

修改任务属性 . . . . . . . . . . . . . . . . . . . . 209 

第 12 章 

管理主题 211 

在上部窗格中使用主题 . . . . . . . . . . . . . . . 212 

使用树格式的益处 . . . . . . . . . . . . . . . . 213 

使用列表格式的益处 . . . . . . . . . . . . . . . 214 

使用主题筛选器 . . . . . . . . . . . . . . . . . . . 214 

创建主题 . . . . . . . . . . . . . . . . . . . . . . . 215 

回复主题或响应 . . . . . . . . . . . . . . . . . . . 217 

修改主题和响应属性 . . . . . . . . . . . . . . . . . 217 

第 13 章 

使用审核日志 219 

使用审核日志筛选器 . . . . . . . . . . . . . . . . . 220 

审核日志事件 . . . . . . . . . . . . . . . . . . . . 221 

第 14 章 

执行一般性操作 223 

在项目视图之间移动文件夹和项 . . . . . . . . . . . 225 

创建项的快捷方式 . . . . . . . . . . . . . . . . . . 225 

与其它视图共享文件夹和项 . . . . . . . . . . . . . 226 

ii

了解分支 . . . . . . . . . . . . . . . . . . . . . . 227 

禁用分支 . . . . . . . . . . . . . . . . . . . . . 227 

分支行为设置为更改时分支 . . . . . . . . . . . 228 

分支行为未设置为更改时分支 . . . . . . . . . . 228 

文件夹、文件或更改请求分支 . . . . . . . . . . . . 228 

重新配置文件夹和项 . . . . . . . . . . . . . . . . 229 

锁定和解锁项 . . . . . . . . . . . . . . . . . . . . 232 

比较属性 . . . . . . . . . . . . . . . . . . . . . . 233 

使用历史列表 . . . . . . . . . . . . . . . . . . . . 234 

查看修订属性 . . . . . . . . . . . . . . . . . . 234 

编辑修订注释 . . . . . . . . . . . . . . . . . . 235 

合并修订 . . . . . . . . . . . . . . . . . . . . . . 235 

按字段内容查找项 . . . . . . . . . . . . . . . . . . 235 

打印项 . . . . . . . . . . . . . . . . . . . . . . . . 236 

通过电子邮件发送项 . . . . . . . . . . . . . . . . 237 

控制系统托盘通知 . . . . . . . . . . . . . . . . . . 239 

将项标记为已读或未读 . . . . . . . . . . . . . . . 239 

管理已读 / 未读项 . . . . . . . . . . . . . . . . . . 240 

为项加标志 . . . . . . . . . . . . . . . . . . . . . 240 

删除文件夹或项 . . . . . . . . . . . . . . . . . . . 240 

第 15 章 

使用过程规则 243 

使用过程项 . . . . . . . . . . . . . . . . . . . . . 243 

了解过程项限制 . . . . . . . . . . . . . . . . . . . 244 

预先选择活动过程项 . . . . . . . . . . . . . . . . 244 

将文件链接到过程项 . . . . . . . . . . . . . . . . 245 

使用到过程项的链接 . . . . . . . . . . . . . . . . 245 

第 16 章 

使用标签 247 

创建视图标签 . . . . . . . . . . . . . . . . . . . . 248 

复制视图标签 . . . . . . . . . . . . . . . . . . . . 250 

创建修订标签 . . . . . . . . . . . . . . . . . . . . 251 

复制修订标签 . . . . . . . . . . . . . . . . . . . . 252 

冻结标签 . . . . . . . . . . . . . . . . . . . . . . 253 

删除标签 . . . . . . . . . . . . . . . . . . . . . . 254 

查看标签属性 . . . . . . . . . . . . . . . . . . . . 254 

为文件夹加标签 . . . . . . . . . . . . . . . . . . . 254 

为项加标签 . . . . . . . . . . . . . . . . . . . . . 257 

应用于标签的访问权限 . . . . . . . . . . . . . . . 260 

第 17 章 

使用链接 261 

链接文件夹和项 . . . . . . . . . . . . . . . . . . . 261 

了解链接列表中的列 . . . . . . . . . . . . . . . . 263 

选择链接的特定修订 . . . . . . . . . . . . . . . . 264 

查看属性 . . . . . . . . . . . . . . . . . . . . . . 267 

删除链接 . . . . . . . . . . . . . . . . . . . . . . 267 

第 18 章 

使用引用 269 

查看引用 . . . . . . . . . . . . . . . . . . . . . . 270 

了解初始引用 . . . . . . . . . . . . . . . . . . . . 272 

了解通过分支视图创建的引用 . . . . . . . . . . . . 273 

了解通过向视图添加项创建的引用 . . . . . . . . . 275 

向下浮动 . . . . . . . . . . . . . . . . . . . . . 276 

向上浮动 . . . . . . . . . . . . . . . . . . . . . 276 

向上和向下浮动 . . . . . . . . . . . . . . . . . 277 

了解通过手动共享对象创建的引用 . . . . . . . . . . 277 

向上和向下浮动 . . . . . . . . . . . . . . . . . . 278 

了解通过移动对象创建的引用 . . . . . . . . . . . . 278 

向上和向下浮动 . . . . . . . . . . . . . . . . . . 279 

第 19 章 

报告和导出数据 281 

生成报告的样例情形 . . . . . . . . . . . . . . . . . 281 

创建报告 . . . . . . . . . . . . . . . . . . . . . . . 282 

导出数据 . . . . . . . . . . . . . . . . . . . . . . . 283 

可用编码 . . . . . . . . . . . . . . . . . . . . . 285 

可用报告 . . . . . . . . . . . . . . . . . . . . . . . 285 

使用报告模板 . . . . . . . . . . . . . . . . . . . . 287 

更改在模板中指定的字段 . . . . . . . . . . . . . 290 

第 20 章 

使用图表 293 

可用图表 . . . . . . . . . . . . . . . . . . . . . . . 293 

创建简单图表 . . . . . . . . . . . . . . . . . . . . 297 

创建分布图表 . . . . . . . . . . . . . . . . . . . . 298 

创建相关性图表 . . . . . . . . . . . . . . . . . . . 299 

创建时间序列图表 . . . . . . . . . . . . . . . . . . 300 

使用图表窗口 . . . . . . . . . . . . . . . . . . . . 301 

编辑图表 . . . . . . . . . . . . . . . . . . . . . . . 303 

更改图表类型 . . . . . . . . . . . . . . . . . . . 303 

更改图表数据 . . . . . . . . . . . . . . . . . . . 303 

更改图表颜色或图案 . . . . . . . . . . . . . . . 303 

更改图表文本 . . . . . . . . . . . . . . . . . . . 304 

为 3D 图表更改查看选项 . . . . . . . . . . . . . 305 

分离饼图 . . . . . . . . . . . . . . . . . . . . . 306 

第 21 章 

设置个人选项 307 

自定义 StarTeam. . . . . . . . . . . . . . . . . . . 307 

设置文件选项 . . . . . . . . . . . . . . . . . . . . 310 

管理已读 / 未读项 . . . . . . . . . . . . . . . . . . 315 

控制系统托盘通知 . . . . . . . . . . . . . . . . . . 316 

自动锁定非文件项 . . . . . . . . . . . . . . . . . . 317 

使用 StarTeamMPX Server . . . . . . . . . . . . . 318 

更改个人信息 . . . . . . . . . . . . . . . . . . . . 319 

第 22 章 

使用 stcmd 命令行界面 321 

语法 . . . . . . . . . . . . . . . . . . . . . . . . . 322 

常见选项 . . . . . . . . . . . . . . . . . . . . . . . 322 

退出代码 . . . . . . . . . . . . . . . . . . . . . . . 327 

添加文件 :stcmd add . . . . . . . . . . . . . . . . 327 

添加文件夹 :stcmd add-folder. . . . . . . . . . . . 328 

添加项目 :stcmd add-project . . . . . . . . . . . . 330 

添加视图 :stcmd add-view . . . . . . . . . . . . . 331 

应用标签 :stcmd apply-label . . . . . . . . . . . . 333 

签入文件 :stcmd ci . . . . . . . . . . . . . . . . . 334 

签出文件 :stcmd co . . . . . . . . . . . . . . . . . 335 

删除本地文件 :stcmd delete-local. . . . . . . . . . 338 

比较文件修订 :stcmd diff . . . . . . . . . . . . . . 339 

更改说明 :stcmd dsc . . . . . . . . . . . . . . . . 341 

显示文件历史 :stcmd hist . . . . . . . . . . . . . . 341 

创建标签 :stcmd label. . . . . . . . . . . . . . . . 342 

锁定和解除锁定文件 :stcmd lck. . . . . . . . . . . 343 

iii

列出文件 :stcmd list . . . . . . . . . . . . . . . . 344 

创建工作文件夹 :stcmd local-mkdir . . . . . . . . 345 

合并文件 . . . . . . . . . . . . . . . . . . . . . . 345 

移动状态 :stcmd move-status . . . . . . . . . . . 345 

删除文件 :stcmd remove. . . . . . . . . . . . . . 347 

锁定 / 解除锁定服务器 :stcmd server-mode . . . . 347 

设置个人选项 : stcmd set-personal-options . . . . 348 

更新文件状态 :stcmd update-status . . . . . . . . 349 

第 23 章 

使用 bco 命令行界面 351 

语法 . . . . . . . . . . . . . . . . . . . . . . . . . 352 

附录 A 

比较 Windows 和 Cross-Platform 

客户机 357 

附录 B 

术语表 365 

索引 373 

iv

章 

前言 

第 1 章 

联系 Borland 支持 

本手册就使用 StarTeam 跟踪和管理文件更改、在团队成员间共享文件、访问文件的先 

前版本以及其它功能做了详细介绍。此外 ,“StarTeam 用户指南 ” 还说明了如何使用更 

改请求、需求、主题和任务。但是 , 根据您的 StarTeam 许可 , 并不是本手册中介绍的 

所有功能您都可以使用。 

Borland Software Corporation 致力于在咨询和技术支持领域提供世界级服务。我们在向 

开发者和企业客户提供支持方面拥有 15 年以上的经验。我们合格的技术支持工程师们已 

做好准备 , 根据具体个案或是通过建立长期合作关系 , 处理您的支持需求。Borland 在世 

界范围内提供支持 , 通过交付及时、可靠的服务来确保每个客户的业务均能获得成功。 

有关 Borland 支持服务的详细信息 , 请访问我们的网站 , 网址为 

http://support.borland.com。 

您还可以通过网站访问许多新闻组 , 它们是用户交换信息、意见和技巧的场所。要获得 

免费产品新闻组的最新列表 , 请访问 http://info.borland.com/newsgroups/。还可以通过 

Internet 访问 Borland Developer Network (Borland 开发者网络 ) 站点 , 网址为 

http://community.borland.com。在此 Borland 社区可以访问到产品特定的信息、文章、 

代码示例和新闻。 

寻求支持时 , 请准备好提供有关以下方面的完整信息 : 具体环境、所用产品的版本以及 

问题的详细说明。 

要获得第三方工具或文档方面的支持 , 请与工具的供应商联系。 

第 1 章 : 前言 1

文档约定 

文档约定 

StarTeam 文档使用以下约定。 

选择 File ( 文件 ) 

> Exit ( 退出 ) 

注标识补充信息。 

提示标识关于备选步骤的信息或其它有用但不重要的信息。 

重要说明标识对于完成任务非常重要的信息。 

表示在选择菜单后紧接着选择子菜单。大于号 (>) 用于分隔要从后续菜单 

中选择的命令。例如 ,“ 选择 File ( 文件 ) > Exit ( 退出 ) 命令 ” 表示从 

菜单栏选择 File ( 文件 ), 然后从下拉菜单中选择 Exit ( 退出 )。 

固定间距字体以 Courier 字体显示的文本代表需要输入的信息和系统消息。 

斜体以斜体显示的语法代表需要用您的文件名、子文件夹等替换的信息。 

斜体也可用于对话框名、书名和表示强调。 

粗体以粗体显示的语法代表必须完全按所示那样使用的信息 ( 如果使用 )。 

[ ] 方括号内为可选的语法。 

| 竖线在语法中分隔互斥的选项。 

页边空白处出现此图标时 , 表示此部分内容或步骤只适用于 StarTeam 

Windows 客户机。( 如果某部分内容或步骤适用于两种客户机 , 则页边空 

白处不出现图标。) 

页边空白处出现此图标时 , 表示此部分内容或步骤只适用于 StarTeam 

Cross-Platform 客户机。( 如果某部分内容或步骤适用于两种客户机 , 则 

页边空白处不出现图标。) 

注意标识可能导致数据丢失的操作或为确保数据不丢失而必须遵循的过程。 

2 StarTeam 用户指南

章 

第 2 章 

StarTeam 简介 

通过使用产品开发过程中常用的紧密集成的组件 , StarTeam 可以使本地团队协作和远 

程团队协作更加容易。利用 StarTeam, 您可以 : 

■ 

将与项目相关的任何内容存储在相同的位置。例如 , 可以存储文本文件和二进制文 

件、更改请求 , 以及有关项目的讨论。 

■ 

通过 LAN、 WAN 或 Internet 访问信息和进行协作。 

■ 

改进项目协作。 

StarTeam 有何新功能 ? 

■ 

更加轻松地进行测试并节省维护时间 , 因为更改请求与代码和内容文件之间的集成非 

常紧密。 

■ 

更加轻松地跟踪需求 , 因为需求与代码和内容文件之间的集成非常紧密。 

■ 

更加轻松地管理项目 , 因为任务与代码和内容文件之间的集成非常紧密。 

■ 

记录谁做了什么、在什么时间做的。 

■ 

利用客户机 / 服务器对数据的真实访问。 

StarTeam 具有 Windows 和 Cross-Platform 两个客户机。StarTeam 服务器在 Windows 

和 Unix 平台上运行。 

有关 StarTeam 的最新信息 , 请查看 StarTeam 安装光盘上的自述文件。如果使用的是 

先前版本 , 则可阅读 StarTeam New Features Guide (StarTeam New 新功能指南 ), 

该指南描述了 StarTeam 产品线的此发行版中的新功能。 

第 2 章 :StarTeam 简介 3

StarTeam 的变体 

StarTeam 的变体 

要使用 StarTeam, 需要同时具有 StarTeam Server 和一台客户机才能访问该服务器。 

多数用户都拥有多台客户机。下表说明了最常用的客户机。 

表 2.1 

StarTeam Server 客户机 

客户机 

StarTeam Windows 

客户机 

StarTeam Cross- 

Platform 客户机 

StarDisk 

StarTeam Web Edition 

集成 

说明 

为 Windows 平台创建的原始客户机 , 它具有完整的功能集。 

此客户机随供了 stcmd 命令行的 COM 版本和 stcmd 命令行的 

Java 版本。 

是利用 Java 语言为 Solaris、 Linux 和 Macintosh System X 平台创 

建的 , 可在任何支持 Java 语言的平台上工作 ; 具有一个可用于 

Windows 客户机的功能子集。 

此客户机随供了 stcmd 命令行的 Java 版本。 

Windows 平台的另一个客户机。此客户机可从 Windows 资源管理 

器进行使用 , 它仅支持文件组件。 

可从任何平台进行使用的、基于浏览器的客户机 , 它具有可用于 

Windows 客户机的功能子集以及一些只能由 Web Edition 使用的附 

加功能。 

StarTeam 具有多种与 “ 集成开发环境 ” (IDE) 及其它产品 ( 如 

Microsoft Project) 的集成。 

本书介绍了用于 Windows 的客户机和 StarTeam Cross-Platform 客户机。关于对 

Windows 客户机和 Cross-Platform 客户机的功能所进行的逐一比较 , 请参阅第 357 页 

的 “ 比较 Windows 和 Cross-Platform 客户机 ”。 

其它客户机都有其自已的文档。例如 , StarDisk User's Guide (StarDisk 用户指南 ) 说 

明了 StarDisk 的使用方法。 

StarTeam 服务器和客户机被授权使用特定的功能集。由于您的客户机或服务器许可的 

原因 , 您可能不能使用本指南中所说明的某些功能。 

使用本手册 

本书介绍了团队成员最常使用的功能。而管理员最常使用的功能则在 StarTeam 管理 

员指南中加以说明。根据您身为 StarTeam 用户所扮演的角色 , 您可能还需要 

StarTeam 管理员指南中的部分或全部信息。例如 , 尽管您可能不是 StarTeam 管理 

员 , 但是仍然可能需要创建新项目、新视图 , 和 / 或设置访问权限。有关这些操作的详 

细信息位于 StarTeam 管理员指南中。 

本书介绍了 StarTeam Windows 客户机和 Cross-Platform 客户机。然后介绍了项目、视 

图和文件夹 ( 尽管不如 StarTeam 管理员指南介绍得那么深入 )。 

接下来 , 本书又介绍了 StarTeam 储存库中所存储的项的每一种类型 : 文件、更改请求、 

需求、任务、主题和审核事件。根据您的 StarTeam 许可 , 贵公司可能无权访问所有这 

些项类型。 

与项相关的每一章都说明了所包含的项的独特之处 , 并说明了如何使用该项的标准属性 

对话框。 

如果您使用的是备选属性编辑器 (APE) 而不是标准属性对话框 , 则其中的某些信息将会 

不适用。贵公司可为您提供说明 APE 使用方法的附加信息。由于 APE 是自定义表格 , 

所以每一个位置的 APE 都会有所不同。 

在与项相关的章节之后 , 本手册中有一个有关执行与多个项类型相关的常用操作的章 

节。如果该操作仅需几个段落来说明 , 则本章将会对其进行介绍。如果该操作需要几页 

来说明 , 则在其各自的章节中予以介绍。例如 , 标签和引用都有其自已的章节。 


了解 StarTeam 


下图概述了项目结构 , 该结构由运行特定服务器配置的 StarTeam Server 实例所控制。 

服务器 / 服务器配置可管理任意数量的 StarTeam 项目。项目是根据文件用途将文件进行 

分组的一种方法。例如 , 一个项目可能包括所有由贵公司创建的、与某个软件应用程序相 

关的文件 , 或者所有与该软件应用程序的某个组件相关的文件。 

每个项目都有一个根视图和任意数量的子视图。 

StarTeam 管理员将使用视图 : 

■ 

■ 

提供仅对项目中的文件子集的访问。例如 , 开发人员可以不必知道该项目中所存储的 

用于营销目的的文件 , 而市场调查人员可以不必知道源代码文件。他们都可从事同一 

个项目 , 只是处于不同的视图中 , 而每一个视图都是根视图的一个子集。此类视图称 

为 “ 参考视图 ”。 

为项目提供分支。这可通过为项目创建新视图 ( 分支视图 ) 来完成。例如 , 项目的 

一个视图可存储某个软件应用程序的 1.0 版本的源代码。而另一个视图则可用于 2.0 

版本。 

StarTeam 还可使您能够合并这两个视图的文件。例如 , 假设贵公司需要为 1.0 版本 

创建一个 Service Pack 或修补程序。如果所需的代码更改已被添加到 2.0 视图内的源 

代码中 , 则可将该文件的内容与 1.0 视图中对应文件的内容进行合并。然后 , 这两个 

文件便都具有所需的更改。 



一个 StarTeam 文件夹将充当根视图和每个子视图的根文件夹。 

根文件夹可具有任意层次的子文件夹。该层次称为 “StarTeam 文件夹层次 ”。 

在创建一个 StarTeam 项目时 , 该项目的根视图及根视图的根文件夹将被自动创建 , 并 

被提供与该项目相同的名称。例如 , 如果该项目的名称为 Great App, 则根视图的名称 

及根文件夹的名称最初都为 Great App。可使用 StarTeam 更改其中的任何一个名称 ( 如 

果您拥有执行此项操作的访问权限 )。 

每个 StarTeam 文件夹都有一个与之对应的工作文件夹。工作文件夹是用于存储从工作 

站中签出的文件的位置。工作文件夹的路径可以与 StarTeam 文件夹的路径有很少的相 

关性或者根本没有相关性。 

例如 , 假定某个视图的根文件夹是 Great App, 且 Great App 有一个名为 Source Code 

的子文件夹。Great App 可以具有工作文件夹 C:\Great App, 而 Source Code 可以具有 

工作文件夹 C:\Great App\Source Code 乃至 E:\VBstuff\sc。 StarTeam 文件夹 Source 

Code 可以是名为 Great App 的 StarTeam 文件夹的子文件夹 , 但是 Source Code 的工 

作文件夹却不一定是 Great App 工作文件夹的子文件夹。 


使用项目视图窗口 

在下图中 , 工作文件夹所形成的层次与 StarTeam 文件夹层次非常相似。 

但是 , 如下图所示 , 工作文件夹的路径也不必与 StarTeam 文件夹的路径相似。 

使用项目视图窗口 

项目视图窗口一次只显示一个项目视图的相关信息。但是 , 一次可以打开多个项目视图 

窗口。 

每个窗口都有三个窗格 : 

■ 

左窗格显示当前项目当前视图的文件夹层次。 

■ 

在上图中 , 项目视图窗口显示 StarDraw 项目的 StarDraw 视图。 

StarDraw 是根文件夹。在本例中 , 该文件夹的名称与项目和视图相同 - 但您以后可以 

根据需要更改其名称。 Beta Materials 是选定的子文件夹。 

位于窗口右侧的上部窗格显示与选定文件夹关联的数据。数据的类型取决于从上部窗 

格中选择的选项卡。StarTeam 的每个组件都有一个选项卡 : 文件、更改请求、任务、 

主题和审核组件。 

因为图中选择了 Beta Materials 文件夹和 File ( 文件 ) 选项卡 , 所以 StarTeam 将与 

Beta Materials 文件夹关联的文件列在上部窗格中。上部窗格中的每一行都提供有关 

文件的信息。如果选择了 Change Request ( 更改请求 ) 选项卡 , 则每一行都会提供 

有关更改请求的信息。每行表示一个项 ; 项可以是文件、更改请求、任务、主题或审 

核条目。 


使用文件夹层次 

注 

■ 

下部窗格 ( 也在窗口右侧 ) 显示有关从上部窗格中选择的项的详细信息。信息类型取 

决于从下部窗格中选择的选项卡。 

由于图中选择了 Beta Test Plan.doc 和 History ( 历史 ) 选项卡 , 所以下部窗格中显 

示该文件的修订历史。 

可以采用树或列表格式在上部窗格中显示需求、任务和主题。文件、更改请求和审 

核条目始终以列表形式显示。 

使用文件夹层次 

注 

StarTeam 管理员通常负责创建 StarTeam 项目、这些项目的不同视图和文件夹层次。但 

是 , 您有时候可以自己向层次中添加文件夹以及将文件签入和签出。因此 , 您需要了解 

文件夹层次及其工作文件夹的底层结构。有关详细信息 , 请参阅第 49 页的 “ 管理文件 

夹 ”。 

通常 , 一次仅使用几个文件夹 , 这些文件夹显示在一个由系统管理员创建的视图中。 

选择其中的一个文件夹如同在 Windows 资源管理器中选择文件夹一样。但是 , 尽管 

Windows 资源管理器文件夹层次表示的是工作站 ( 或其它位置 ) 上的文件夹的准确路 

径 , 但 StarTeam 文件夹层次却不必如此。每个 StarTeam 文件夹都与工作站上的一个 

具有准确路径的工作文件夹相关联。文件可被进行处理 , 可被签出到工作文件夹 , 也可 

被从工作文件夹签入。 StarTeam 文件夹层次的根文件夹可被命名为 ProjectX, 其工作 

文件夹可位于 C:\companyName\ProjectX。 

每个文件夹名称前面都有一个文件夹图标。单击文件夹名或图标可将与该文件夹关联的 

信息显示在上部窗格中。所显示的信息取决于从文件夹层次中选择的文件夹及从上部窗 

格中选择的选项卡。 

可以展开或折叠文件夹层次的分支 : 

加号指示折叠的分支。单击它可以展开该分支。 

减号指示展开的分支。单击它可以折叠该分支。 

双击文件夹层次中的项目文件夹名可展开或折叠分支。 

在从文件夹层次中选择一个文件夹后 , 请使用 Folder ( 文件夹 ) 菜单来执行对文件夹的 

操作 , 或者右键单击以显示一个上下文菜单。 

可通过拖动子文件夹的方式将其从一个父文件夹移动到另一个父文件夹中。也可将项从 

上部窗格拖动到该文件夹层次 ( 左窗格 ) 或另一个文件夹层次 ( 另一个视图窗口的左窗 

格 ) 的一个文件夹中。这样 , 便可将其从一个文件夹移动到另一个文件夹 , 或者从一个 

视图或项目移动到另一个视图或项目。 

仅当两个视图均属于同一个项目或者属于将数据存储在同一个储存库中的不同项 

目 ( 即 , 它们使用相同的服务器配置 ) 时 , 才可将项从一个视图或项目移动到另 

一个视图或项目。 

要将一个文件夹或视图中的项与另一个文件夹或视图共享 , 请按住 Ctrl, 然后进行拖动。 

使用上部窗格 

左窗格中的每一个文件夹均与上部窗格的内容形成一对多的关系 , 这意味着左窗格中的 

每一个文件夹都可包含数据项 , 如文件和更改请求。上部窗格将显示该数据。上部窗格 

下面的选项卡将决定所显示的数据类型。例如 , 上部窗格可显示与从文件夹层次中选择 

的文件夹关联的文件。 

可使用这些选项卡来操作这些项。某些示例包括 : 

■ 

文件组件提供在 StarTeam 中存储的文件的版本控制。 


使用上部窗格 

All 

Descendants 

通常 , 在 StarTeam 中所有与项目或产品相关的文件都会存储在一起 ( 可从 StarTeam 

中已有文件进行编译的那些文件除外 )。例如 , 某公司可能存储除了所有可执行文件以 

外的产品源代码。有些公司可能将这二者都存储起来。但有些公司可能仅存储可执行 

文件。有关详细信息 , 请参阅第 14 页的 “ 使用版本控制 ” 和第 145 页的 “ 管理文件 ”。 

■ 

更改请求组件提供缺陷跟踪系统。 

公司需要知道产品的哪个部分出现故障并跟踪每个问题的解决方式。有关详细信息 , 

请参阅第 15 页的 “ 使用缺陷跟踪 ” 和第 179 页的 “ 跟踪更改请求 ”。 

■ 

任务组件使团队成员能够跟踪谁被分配了什么任务以及此人的完成任务的进度如何。 

有关详细信息 , 请参阅第 17 页的 “ 使用需求 ” 和第 197 页的 “ 管理任务 ”。 

■ 

主题组件使团队成员能够存储有关项目或产品的线索化对话。有关详细信息 , 请参阅 

第 18 页的 “ 使用主题 ” 和第 211 页的 “ 管理主题 ”。 

■ 

审核组件记录指示何时、何人执行了哪些操作的条目。有关详细信息 , 请参阅第 219 

页的 “ 使用审核日志 ”。 

在上部窗格中显示的信息取决于以下所有方面 : 

■ 

从文件夹层次中选择的文件夹。 

■ 

所选的组件选项卡 :File( 文件 )、Change Request( 更改请求 )、Topic( 主题 )、 

Task ( 任务 ) 或 Audit ( 审核 )。 

单击某个选项卡时 , 与所选的选项卡对应的菜单将成为菜单栏的第四个菜单。例如 , 

如果选择 Change Request( 更改请求 ) 选项卡 , 则菜单栏上将出现 Change Request 

( 更改请求 ) 菜单。 

■ 

■ 

从右上部窗格上方的 Filter ( 筛选器 ) 下拉列表中选择的筛选器。筛选器按字母数字 

顺序列出 , 其名称不区分大小写。 

All Descendants( 所有后代 ) 按钮位于右上部窗格的上方 , 指示 StarTeam 在右上部 

窗格中显示的信息的深度。也可打开或关闭 All Descendants( 所有后代 ), 方法 : 从 

File ( 文件 )、 Change Request ( 更改请求 )、 Task ( 任务 )、 Topic ( 主题 ) 或 

Audit ( 审核 ) 菜单中进行选择。可在 All Descendants ( 所有后代 ) 操作过程中最小 

化 StarTeam 主窗口 , 而不必停止该操作。 

如果未选择此按钮 , 则 StarTeam 将仅显示选定文件夹的信息。 

如果选择此按钮 , 则 StarTeam 将显示选定文件夹、其子文件夹、其子文件夹的子文 

件夹等的信息。 

虽然上部窗格中的数据类型将根据所选的选项卡的变化而有所不同 , 但是其操作方法是 

类似的。 

StarTeam 可为储存库中该种类型的每一个项显示一行 , 或者您可仅为一个或多个列中 

的值与指定条件相匹配的项创建一个查询和显示行。 

最多可显示 60 列。这些列表示每个项的属性 ( 也称为属性字段 )。例如 , 文件属性包括 

文件的名称、状态和大小。这些列可被重新排列、排序、分组、显示或隐藏。 

筛选器是复制 ( 在需要时 ) 可在上部窗格中创建的任何有用的数据排列的一种方法。各 

筛选器可以是公用的 ( 可用于所有 StarTeam 项目用户 ), 也可以是私有的 ( 只能用于 

创建它的工作站 )。筛选器由以下几部分组成 : 

■ 

■ 

按显示顺序排列的列的列表 

要应用一到四级排序的列 

■ 

应用于数据的查询 ( 查询可为 AND 和 OR 条件 ) 

■ 

查询的上下文。例如 , 查询可应用于视图中的所有文件 , 仅应用于不在视图中的文 

件 , 或者用于这两种类型的文件 , 只要尚未将其从项目或视图中排除。 

有关筛选器的详细信息 , 请参阅第 67 页的 “ 在上部窗格中管理数据 ”。 

要选择或创建筛选器、查询和排序顺序 , 请单击列标题以显示一个上下文菜单 , 利用该 

菜单您便可执行这些操作。 


使用下部窗格 

要根据该列中的值对所显示的文件进行排序 , 请单击列标题。可按数字、字母数字或内 

部关键字顺序的升序进行排序 , 具体排序方式将视数据而定。要将排序顺序从升序更改 

为降序 , 请再次单击标题 , 反之亦然。StarTeam 在列标题中显示一个三角形。三角形的 

尖端将朝上 ( 升序 ) 或朝下 ( 降序 )。 

有几种刷新项目视图窗口或上部窗格的方法。 

■ 

按 F5 为当前项刷新右上部窗格 

■ 

按 Ctrl+F5 刷新上部窗格 , 同时折叠所有打开的组 

■ 

按 Shift + F5 刷新整个视图 ( 所有选项卡和文件夹层次中的所有项列表 ) 

■ 

按 F6 从外部存档 ( 如 Visual SourceSafe 或 PVCS) 刷新文件。在按 F6 之前 , 务必 

启用 All Descendants( 所有后代 ) 按钮 ( 或从 File( 文件 ) 菜单选择 All Descendants 

( 所有后代 )), 这样刷新便可在所有子文件夹中递归。 


下部窗格显示从上部窗格中选择的项的信息。出现的信息将取决于所选的选项卡。 

选择 Detail 选项卡 

选择 Detail ( 详细信息 ) 选项卡可垂直列出所选项在上部窗格中水平显示的信息。 

项目视图窗口的以下部分显示了 Stardoc.ico 文件的一些属性。上部窗格中的列为 Name 

( 名称 )、 Status ( 状态 )、 Locked By ( 锁定者 )、 Vault Branch ( 储存仓分支 ) 等。 

这些相同的属性出现在下部窗格的 Property ( 属性 ) 列中。每个属性的值都位于其名称 

旁边。 

即使任务和主题以树的形式显示在上部窗格中 ,Display( 显示 ) 窗格也会列出以列表形 

式显示在上窗格中的字段。 

Display ( 显示 ) 窗格没有上下文菜单。 



选择 History 选项卡 

选择 History ( 历史 ) 选项卡将列出所选项的过去修订 ( 如果该项不是一个审核条目或 

者一个状态为 Not In View( 不在视图中 ) 或 Unknown( 未知 ) 的文件 , 在这种情况下 , 

该选项卡将不显示任何内容 )。 

下图显示了从上部窗格中选择的一个文件的 History ( 历史 ) 窗格。 

图中列出的修订从最新修订到初始修订不等。红色箭头指示在磁盘上进行的修订 ( 储存 

库中最新添加、签入或签出的修订 )。红色箭头仅适用于文件。 

双击修订可显示其属性。 

右键单击可显示上下文菜单 , 利用该菜单您可查看修订属性、比较修订、更改与该修订 

关联的注释、查看其引用。对于文件 , 也可在默认编辑器 ( 通常为记事本 ) 中查看文件 , 

或在相应的应用程序中打开文件。 

选择 Label 选项卡 

选择 Label ( 标签 ) 选项卡可显示附加到所选项的每个修订的标签树。可使用拖放操作 

将标签从一个修订移动到另一个修订。 

标签的类型 ( 视图或修订 ) 位于树中其名称之前。 

右键单击修订可显示上下文菜单 , 您可从该菜单附加和分离标签等。 

下图显示了从上部窗格中选择的项的标签树。它还显示该窗格的上下文菜单。 

选择 Link 选项卡 

选择 Link ( 链接 ) 选项卡可列出已与所选项相链接的项。例如 , 一个文件可链接到文件 

夹、另一个文件、更改请求、任务或主题。( 无法链接 Audit ( 审核 ) 条目 , 因此如果选 

择审核条目 , 则下部窗格将为空。) 

右键单击一个链接可显示上下文菜单 , 从该菜单您可查看链接或链接列表中所列项的属 

性。也可删除链接。 


使用标题栏 

下图显示了项目视图窗口的链接列表。在此种情况下 , 从上部窗格中选择的项具有两个 

链接 , 每个都链接至链接列表中所列的项。 

选择 Reference 选项卡 

选择 Reference ( 引用 ) 选项卡可显示所选项的引用。出于共享以及视图是其它视图的 

子项的原因 , 文件夹或项可与多个项目、视图或父文件夹关联 ( 只要它们全都使用相同 

的服务器配置 )。文件夹或项的每个实例都有引用。 

对于文件夹引用 , 可选择 Folder ( 文件夹 ) > Advanced ( 高级 ) > References ( 引 

用 ), 使用项目视图窗口和下部窗格上的 Reference ( 引用 ) 选项卡。 

下图显示了 Reference ( 引用 ) 窗格。 

Current 

Current ( 当前 ) 图标指示当前所选的引用。否则 , 此窗格将包含相同信息 , 而不管在其 

中选择该项的视图如何。 

每个引用都由几个部分组成 , 其中包括项目名、视图路径、StarTeam 文件夹路径和分支 

修订。 

以粗体显示的引用将指示文件夹或项的哪些修订是其后代。换言之 , 所选的文件夹或项 

是以粗体显示的历史和修订的一部分。 

Reference ( 引用 ) 窗格没有上下文菜单。 

使用标题栏 

标题栏提供有关项目和视图的信息。下图显示了 StarTeam Cross-Platform 和 Windows 

客户机的标题栏。 


使用状态栏 

标题栏可显示 : 

■ 

产品名 (StarTeam、 StarTeam Enterprise 或 StarTeam Enterprise Advantage)。 

■ 

版本号 ( 仅在 StarTeam Windows 客户机中跟在产品名之后 )。 

图中显示的 “x.x” 即为版本号所在之处。 

■ 

服务器说明 ( 为包含当前显示的项目视图的服务器配置提供的名称 )。 

注 

■ 

■ 

■ 

■ 

如果使用的是 StarTeam Windows 客户机 , 则可能显示安装了 StarTeam Server 

的计算机名 , 而不是服务器说明。例如 , 在上图中显示的是 “machineX”, 而不 

是 “orion” 。如果利用快捷方式打开了服务器配置的第一个视图窗口 , 则会发生 

此种情况 , 这是因为快捷方式存储的是计算机名 , 而不是服务器说明。 

您可能已利用快捷方式手动打开了第一个窗口 , 或者 StarTeam 可能自动打开了带 

有快捷方式的窗口。如果选择 Restore Workspace On Startup ( 启动时还原工作 

区 ) 选项 , 且在您上次退出 StarTeam 会话时该窗口已打开 , 则 StarTeam 将自动 

打开该窗口。 

项目名 (StarDraw) 

视图名 (StarDraw) 

视图的工作文件夹 (C:\StarDraw) 

当前配置文件 ( 默认 )。 StarTeam Cross-Platform 客户机没有配置文件。因此 , 标 

题栏始终显示 Default ( 默认值 ) 一词。 

使用状态栏 

项目视图窗口底部的状态栏可显示以下信息 : 

■ 

视图的配置。例如 , 它可以是 : 

■ 

Current ( 当前 )( 默认的视图配置 ) 

■ 

回滚至标签 ( 例如 View ( 视图 ) - Label ( 标签 ):Build 6 ( 内部版本 6)) 

■ 

回滚至提升状态 ( 例如 View ( 视图 ) - Promo ( 提升 ):Development ( 开发 )) 

■ 

回滚至特定时间 ( 例如 View ( 视图 ) - As of ( 截止时间 ):3/11/03 18:55:02) 

■ 

如果视图为只读 ( 即 , 无法更改 ), 则在配置信息前会出现 R/O。由于您无法改变 

过去 , 所以所有回滚视图都是只读的。 

活动过程项或没有活动过程项这一事实 

■ 

上部窗格中的项数以及从该窗格中选择的项数 

■ 

查询 ( 不属于筛选器的查询除外 ) 是否已应用于上部窗格 

■ 

登录用户的名称 


使用版本控制 

■ 

StarTeamMPX Server 信息 

■ 

■ 

可通过更改闪电的颜色或将闪电删去 , 告诉您 StarTeamMPX Server 是可用、可用但 

已禁用 , 还是可用但已断开连接。Instant( 即时 )、Auto( 自动 ) 和 Manual( 手动 ) 

这些词可提供刷新信息。有关详细信息 , 请参阅第 318 页的 “ 使用 StarTeamMPX 

Server”。 

Cross-Platform 客户机将显示您使用 Windows 客户机时在 Windows 系统托盘中显 

示的通知图标。有关此类通知的详细信息 , 请参阅第 316 页的 “ 控制系统托盘通知 ”。 

Cross-Platform 客户机显示操作系统所在的地区以及该地区的标志。例如 , 对于美国 

英语 , 将会显示 EN 和美国国旗。 

■ 

Cross-Platform 客户机显示 StarTeam Server 的内部版本号。例如 , 可显示以下项目 : 

使用版本控制 

版本控制应用程序存储文件的过去修订 ( 主要是 ( 或仅为 ) 源代码文本文件 )。例如 , 

可返回至文件的早期版本以回收本不该删除的源代码。 StarTeam 可包含任何类型的产 

品相关文件 , 其中包括源代码文件、营销文档、帮助文件、用户文档、测试套件、功能 

说明和图表。 

文件的版本控制只是 StarTeam 版本控制的一个方面。 StarTeam 也存储其它类型的项 

的所有修订 ( 例如更改请求 ), 而且还可提供有用的历史信息。尽管 StarTeam 可为文 

件提供大量的版本控制功能 , 但是它也可为其它组件提供有用的历史信息。 

然而 ,StarTeam 为文件提供的版本控制功能数量最多。在您使用文件时 ,StarTeam 可 

执行以下功能 : 

■ 

跟踪需要签入或签出的文件 , 并使您能够在单一操作中将文件从多个文件夹中签入或 

签出。 

■ 

允许您轻松地查看文件历史并比较其过去的修订。 

■ 

自动合并由两个用户对同一文件所做的更改。此合并是使用 Visual Merge 实用程序 

实现的。 

■ 

支持通过视图支持的分支。 

■ 

■ 

■ 

允许您通过视图标签建立提升状态 , 从而使文件组在生产过程中从一个阶段传递到另 

一个阶段。例如 , 提升状态可包括 Development( 开发 )、Test( 测试 ) 和 Release 

( 发布 ) 状态。 

允许关键字扩展 , 关键字扩展可将版本控制信息嵌入到文本文件中以进行快速而方便 

的引用。 

提供可配置的版本控制。例如 , 在签出未锁定的文件时 , 可要求将工作副本置于只读 

状态。 

History ( 历史 ) 选项卡在版本控制中起着非常重要的作用。在从上部窗格选择相应的文 

件之后 , 选择 History ( 历史 ) 选项卡以显示该文件的所有过去修订列表。使用 History 


使用缺陷跟踪 

( 历史 ) 窗格的上下文菜单 , 可签出并比较修订。下面的项目视图窗口图显示了一个选 

定文件及其历史。它也显示了 History ( 历史 ) 窗格的上下文菜单。 


有关文件的详细信息 , 请参阅第 145 页的 “ 管理文件 ”。有关更改请求、任务和主题修 

订的详细信息 , 请参阅第 233 页的 “ 比较属性 ”。 

缺陷跟踪系统使用户能够跟踪项目或产品的问题以及有关项目或产品的建议。和其它此 

类系统一样 ,StarTeam 允许您输入此类缺陷并将其分配给负责修复缺陷的团队成员。然 

后 , 缺陷便会被修复或以其它方法解决。例如 , 缺陷可能无法修复 , 因为 : 

■ 

它是其它缺陷的副本。 

■ 

尝试解决该缺陷的团队成员无法将其再现。 

■ 

它将被一直延迟到更新版本。 

■ 

它便是这样被设计的。 

有关 StarTeam 的缺陷跟踪系统的详细信息 , 请参阅第 179 页的 “ 跟踪更改请求 ”。 

此外 , 像其它缺陷跟踪系统一样 ,StarTeam 也具有搜索和 / 或报告机制 , 这样您便可检 

查已分配给您的缺陷。 

但是 , StarTeam 的更改请求组件还提供了下列附加功能 : 

■ 

测试者可将更改请求置于指定的文件夹中。 

■ 

开发者和测试者可将更改请求链接到其它项 ( 例如文件或其它更改请求 )。 

■ 

■ 

■ 

团队成员可在签入文件的同时将缺陷标记为 “ 已修复 ”。因此 , 他们可在一个应用程 

序中执行一项操作而不是通常的两项操作 ( 每项操作都在一个单独的应用程序中进 

行 )。 

已修复的缺陷将自动与下一个内部版本标签关联。此功能可使测试人员准确了解所要 

测试的、用于修复的内部版本 , 从而避免了在产品中进行的修复混乱不清。 

团队成员可在运行 StarTeam 时启用系统托盘通知 , 以便检查已发送给他们的更改请 

求 ; 请参阅第 239 页的 “ 控制系统托盘通知 ”。 



■ 

如果 StarTeam 管理员启用了电子邮件通知 , 则在下列条件下团队成员可自动接收电 

子邮件 : 

■ 

团队成员被指定负责某个更改请求。 

■ 

团队成员负责某项需求或任务 , 并且该需求或任务的一个字段有所变化。 

■ 

团队成员被列为主题的收件人 , 且该主题的所有字段都有变化。 

下图显示了一个缺陷的更改请求。 

有关更改请求的详细信息 , 请参阅第 179 页的 “ 跟踪更改请求 ”。 


使用需求 

使用需求 

需求组件使团队成员能够在 StarTeam 中创建需求。也可从 CaliberRM 导入需求。 

使用 StarTeam 的组织可执行由需求驱动的开发过程。用户可将完成需求的文件手动链 

接至这些需求 , 或将需求用作过程项以使链接自动完成。 

使用任务 

任务组件使团队成员能够在 StarTeam 中创建任务列表和工作分配。可将 MS Project 的 

项目导出到 StarTeam, 也可将任务组件独立使用。 

“ 任务 ” 使用户能够定义其工作并报告其工作量。结合链接 , 开发者可将任务与更改请 

求、文件和主题相关联。“ 任务 ” 以树或列表的形式进行显示。树格式使团队成员能够 

查看任务及其子任务之间的关系。此任务及其子任务的树称为任务层次。列表格式允许 

团队成员对显示的特定字段进行排序、查询和选择。提供了 Task( 任务 ) 图标 , 用来标 

识任务的状态、优先级、里程碑和需要注意的事项。 


使用主题 

下图显示了记录一个特定任务所需的小时数。有关任务的详细信息 , 请参阅第 197 页的 

“ 管理任务 ”。 

使用主题 

通过使用 StarTeam 主题组件 , 团队成员可讨论有关项目总体、特定文件、特定缺陷等 

的问题。这些注释的历史值对于项目来说非常重要 , 因为未来的团队成员可以 : 

■ 

通过阅读对其非常重要的、与项目各部分相关联的主题 , 来快速了解最新信息。 

■ 

避免再次尝试先前发现有缺陷的解决方法。 

■ 

了解某个问题的特定的解决办法变成必要的解决办法的原因 , 并重新评估该决定。 

各公司通常使用线索化对话应用程序来组织有关产品开发和类似主题的讨论。这些应用 

程序将为由电子消息所组成的讨论提供层次结构。 

每个主题都变为树的根。其分支是对主题的响应。响应与响应之间又形成附加分支。使 

用主题可将一个主题的所有相关消息聚在一起 , 并提供用于查看响应的顺序以及响应之 

间的关系的直观方法。 

StarTeam 的主题组件不仅可以提高产品开发的协作水平 , 而且还能将文件的版本控制 

与它的其它组件紧密集成在一起。例如 , 使用 StarTeam, 可以 : 

■ 

将主题分配给项目视图或文件夹并将其直接链接到其它项目。 

■ 

使团队成员易于合并他人输入的内容 , 或在处理文件时提出问题。 

■ 

注释用于说明使用或未使用某个特定方法的原因 , 可将其作为链接的主题包括在内。 

■ 

主题可指出在以后的发行版本中可能必须更改的产品的几个方面。 


使用主题 

下图显示了一个样例主题。有关主题的详细信息 , 请参阅第 211 页的 “ 管理主题 ”。 


使用主题 


章 

使用项目和视图 

第 3 章 

添加对服务器的访问 

Open 

Project 

项目是按层次将相关项 ( 如文件和更改请求 ) 分组的一种方式。利用视图和文件夹可更 

有效地组织这些相关项。例如 , 如果针对某种软件产品创建了一个项目 , 则该产品的功 

能说明、营销需求文档、源代码和测试套件等文件都可以存储在单独的文件夹中。 

可用不同的方式来使用视图。例如 , 可以使用不同的视图 , 使开发人员只看到项目的源 

代码文件夹及其子文件夹 , 营销人员只看到项目的营销文件夹及其子文件夹 , 依此类 

推。在此种情况下 , 每个视图都有一个不同的文件夹作为其根文件夹。视图还支持分支 

和并行开发 ( 有关详细信息 , 请参阅第 227 页的 “ 了解分支 ”)。可以在视图级或逐项 

对数据 ( 如文件和更改请求 ) 进行分支。通过分支 , 您可以创建产品的特殊变体。例如 , 

可在不妨碍创建您的产品的 1.0 版本服务包的情况下 , 启动该产品的 2.0 版本。 

可从 StarTeam 访问一个或多个 StarTeam Server。必须用该服务器的位置或 IP 地址来 

标识它 , 并选择适当的协议和端点。下列步骤将对此进行说明。添加该服务器后 , 

StarTeam 用户可以访问任何可用于该服务器的当前服务器配置的项目。 

管理员在创建项目时添加服务器访问。团队成员可在打开现有项目的过程中添加服务器 

访问。 

添加服务器访问 : 

1 执行以下一项操作 : 

■ 

在工具栏中单击 Open Project ( 打开项目 )。出现 Open Project Wizard ( 打开 

项目向导 ) 对话框。 

■ 

从菜单栏中选择 Tools ( 工具 ) > Server Administration ( 服务器管理 ) 。出现 

Server Administration ( 服务器管理 ) 对话框。 

2 单击 Add Server ( 添加服务器 ) 以添加一个新服务器。 

第 3 章 : 使用项目和视图 21

添加对服务器的访问 

出现 Add Server ( 添加服务器 ) 对话框。 

重要说明 

有关服务器地址、协议和端点的信息 , 请咨询您的管理员。您的管理员还可告诉 

您 , 在您的服务器使用 StarTeamMPX Server 时 , 需要使用哪个 MPX 配置文件。 

3 在 Server Description ( 服务器说明 ) 文本框中输入一个易于记忆的说明。它是该 

服务器唯一的描述性名称。该名称不区分大小写 , 也不能含有冒号 (:)。 

4 在 Server Address ( 服务器地址 ) 文本框中输入或浏览地址。此地址为计算机名或 

IP 地址。 

5 在 TCP/IP Endpoint ( 端点 ) 文本框中输入端点。端点是端口号。 

6 如果要使用压缩 , 选中 Compress Transferred Data ( 压缩传输数据 ) 复选框。 

7 选中加密类型复选框 , 以加密在工作站与服务器之间传输的数据。加密可防止未授权 

方通过不安全的网络线路读取文件和其它项目信息。 

加密类型 ( 从上到下 ) 按速度排序。每种加密类型都比其前面的类型更慢 , 但也更 

安全。 

有关加密和压缩传输数据的详细信息 , 请参阅第 25 页的 “ 在工作站和服务器之间传 

输数据 ”。 

8 ( 可选 ) 如果使用的是 StarTeamMPX Server, 且不想使用默认的配置文件 ( 通常为 

Unicast On-site ( 现场单播 )), 则单击 MPX Profiles (MPX 配置文件 )。 

此操作可显示 MPX Message Broker Profiles (MPX Message Broker 配置文件 ) 对 

话框。 

a 选择一个配置文件。 

b ( 可选 ) 单击 Properties ( 属性 ) 以查看所选配置文件的属性。 

c 单击 Set ( 设置 ) 以将所选配置文件用作 StarTeamMPX 配置文件。 

d 单击 Set ( 设置 )。 


打开现有项目 


e 单击 Close ( 关闭 ) 返回到 Server ( 服务器 ) 对话框。 

提示要查看某个配置文件的属性 , 请选择该配置文件 , 然后单击 Properties( 属性 )。 

返回由管理员设置的默认配置文件 : 

1 单击 Restore Default ( 还原默认值 )。 

2 单击 OK ( 确定 )。 

如果打开了一个项目 , 则将重新打开 Open Project Wizard( 打开项目向导 ) 对话框。 

从此处开始 , 按照打开项目过程中的步骤进行操作。 

注 

Open 

Project 

如果打开一个项目 , 则便会在 StarTeam 中打开一个窗口 , 并显示所选的项目视图。 

打开项目前 , 必须拥有该项目所在服务器的访问权限。请参阅第 21 页的 “ 添加对 

服务器的访问 ”。 

根据工作职责的不同 , 有些用户可能需要同时打开多个项目或同一项目的多个视图。 

有时 , 用户会打开同一项目视图的两个窗口。例如 , 通过使用同一项目视图的两个窗口 , 

可同时查看文件和更改请求而不必切换选项卡。或者 , 可以查看两个相距较远的文件夹 

中的文件 , 而不必使用 All Descendants ( 所有后代 ) 按钮以及在每个文件夹的文件间 

滚动。 

打开项目窗口 : 


■ 

在工具栏中单击 Open Project ( 打开项目 )。 

■ 

从菜单栏中选择 Project ( 项目 ) > Open ( 打开 )。出现 Open Project Wizard 

( 打开项目向导 ) 对话框。 

2 单击服务器名前面的加号 , 或双击项目所在服务器的名称。 

如果已登录到此服务器配置 , 请跳到步骤 4。 

如果尚未登录 , 则将出现 Log On To ( 登录到 ) 对话框。 



提示 

3 在相应的文本框中输入用户名和密码。 

通常 , 人们使用其网络登录名作为用户名。但是 , 该名称和密码必须对服务器是已知 

的 , 并且您必须拥有必要的访问权限才能继续进行操作。密码区分大小写 , 并且可能 

有长度限制。有关您的服务器登录名及其它详细信息 , 请咨询您的 StarTeam 管理员。 

如果已登录到服务器或 StarTeam Toolbar, 但希望以不同的用户身份登录 , 则单 

击 Log On As( 登录身份 )。如果双击服务器名 , 则您最新的登录名将出现在服务 

器名称后面的括号中。如果在此 StarTeam 实例中您是初次登录到该服务器 , 而 

StarTeam Toolbar 也在运行 , 则括号中的用户名将是被 StarTeam Toolbar 识别为 

默认凭证集的用户名。Log On( 登录 ) 对话框中的 “Save as default credentials 

for this server”( 保存为此服务器的默认凭证 ) 复选框会将此服务器的默认凭证重 

置为刚刚在 Log On ( 登录 ) 对话框的文本框中输入的用户名和密码。 

输入用户名和密码将使您返回 Open Project Wizard ( 打开项目向导 ) 对话框 , 该 

对话框显示该服务器的项目列表。 


■ 

选择项目名称 , 然后单击 Finish ( 完成 ) 打开您的项目。 

■ 

双击项目名称以选择该项目的一个特定视图。 

■ 

选择项目名称 , 然后单击 Next ( 下一步 ) 以选择该项目的一个特定视图。 

5 如果出现 Open Project Wizard: Select View ( 打开项目向导 : 选择视图 ) 对话 

框 , 则从 View ( 视图 ) 列表中选择视图名称 , 然后单击 Finish ( 完成 ) 以在该视图 

中打开您的项目。 

注如果视图图标上出现红色 X , 则表示您无权访问该视图。 


在工作站和服务器之间传输数据 

在工作站和服务器之间传输数据 

可加密和压缩在工作站与服务器之间传输的数据。加密可防止未授权方通过不安全的网 

络线路读取文件和其它项目信息。压缩能减少网络上的通信量。但是 , 压缩和解压缩数 

据所需的时间将增加传输时间。 

在您登录到一个服务器时 , 在工作站和服务器之间传输的数据的加密和压缩属性将被设 

置和锁定。在从服务器断开连接后 , 锁定便会被释放。例如 , 服务器可能被关闭 , 或者 

您可能关闭访问服务器的最后一个项目或视图。下次您登录到该服务器时 , 加密和压缩 

属性将会被重置。 

例如 , 假定您打开 StarTeam。然后 , 您便可通过创建 Project 25 ( 项目 25) 在此 

StarTeam 会话期间首次访问服务器 x。在此创建过程中 , 您选择了加密和压缩属性。这 

些属性将成为在工作站和服务器 x 之间传输的数据的属性。 

在同一 StarTeam 会话期间 , 如果打开驻留在服务器 x 上的另一个项目或视图 , 则 

StarTeam 将忽略在打开项目过程中所做的任何加密和压缩更改。此外 , 如果从菜单栏选 

择 Tools( 工具 )> Server Administration( 服务器管理 ), 然后单击 Server Properties 

( 服务器属性 ), 则只能更改当前未登录的服务器的加密和压缩属性。 

可通过从菜单栏选择 Tools ( 工具 ) > Server Administration ( 服务器管理 ), 然后单击 

Server Properties ( 服务器属性 ), 随时查看加密和压缩属性。 

使用视图快捷方式 

有关在打开项目时设置这些属性的详细信息 , 请参阅第 23 页的 “ 打开现有项目 ”。 

Save 

Shortcut 

如果您要经常访问某个 StarTeam 项目视图 , 则您可能希望将该视图保存为桌面上的快 

捷方式。双击该快捷方式可启动 StarTeam 并打开与该快捷方式关联的视图。 

保存项目视图 ( 和某个特定配置 ) 的快捷方式 : 


■ 

从菜单栏选择 Project ( 项目 ) > Save Shortcut As ( 将快捷方式另存为 )。 

■ 

在工具栏上单击 Save Shortcut ( 保存快捷方式 )。 

出现 Save As ( 另存为 ) 对话框。 

2 在 File Name( 文件名 ) 文本框中为此快捷方式输入名称或使用默认名称。保持 .stx 

扩展名。 

3 选择存储此视图快捷方式的位置 , 通常是桌面。 

4 单击 Save ( 保存 )。 


切换视图 

使用快捷方式打开 ( 某个特定配置的 ) 项目视图 : 

1 从菜单栏选择 Project ( 项目 ) > Open Shortcut ( 打开快捷方式 )。 

出现 Open ( 打开 ) 对话框。 

2 选择快捷方式名称 , 然后单击 Open ( 打开 )。 

切换视图 

重要说明 

通常在打开项目窗口时选择一个视图。但是 , 可随时更改在窗口中显示的该项目的视 

图。新选择的视图将始终用当前配置打开 , 而不管其上次退出时所用的配置如何。 

要直接转到某个特定的视图和配置 , 请创建一个快捷方式。请参阅第 25 页的 “ 使用视 

图快捷方式 ”。 

选择一个不同的视图 : 

1 从菜单栏选择 View ( 视图 ) > Select View ( 选择视图 )。 

将出现 Select a View ( 选择视图 ) 对话框 , 并且视图按层次显示。 

2 选择要打开的视图。 

如果想要同时打开两个 StarTeam 视图窗口 , 请选择 Project( 项目 )> Open( 打 

开 ) 以显示另一个视图。 

将视图配置到过去的某个时间点 

可基于标签、提升状态或时间点将视图回滚到过去的某个状态。例如 , 您可能希望 : 

■ 

快速查看应用 Beta3 标签时的情况 

■ 

通过将视图回滚到删除项被删除前的日期来恢复该删除项。 

但是 , 这样做会将视图一直 “ 冻结 ” 到将其配置重新更改为当前状态或者关闭项目 ( 这 

可自动将配置重新更改为当前状态 ) 时为止。您不能签入文件、更新更改请求等 , 因为 

您无法改变过去。 

您可能需要打开两个 StarTeam 实例。例如 , 假定您需要检查处于 White Box Test ( 白 

盒测试 ) 提升状态的文件 , 并输入有关您在这些文件中发现的问题的更改请求。在将视 

图配置为该提升状态后 , 视图将变为只读。您需要另一个使用当前配置的该视图的实 

例 , 以便能够输入更改请求。 

状态栏显示该视图的配置。它可以是 : 

■ 

Current ( 当前 ) 

■ 

回滚至标签 ( 例如 View ( 视图 ) - Label ( 标签 ):Build 6 ( 内部版本 6)) 

■ 

回滚至提升状态 ( 例如 View ( 视图 ) - Promo ( 提升 ):Development ( 开发 )) 

■ 

回滚至特定时间 ( 例如 View ( 视图 ) - As of ( 截止时间 ):3/11/99 18:55:02) 

回滚当前视图 : 

1 从菜单栏选择 View( 视图 )> Select Configuration( 选择配置 )。出现 Select a View 

Configuration ( 选择视图配置 ) 对话框。 

2 选择一个视图配置选项 : 

■ 

Labeled Configuration ( 加标签的配置 ) 

此选项将视图限制为带有指定视图标签的项。 

如果该视图是分支视图 , 则标签必须是在此视图中创建的。参考视图可以从其父视 

图继承标签。 

现有标签将根据其创建时间按相反的时间顺序列出。 


控制文件状态信息 

如果该视图没有已定义的标签 , 则此选项将被禁用。 

■ 

Promotion State Configuration ( 提升状态配置 ) 

在配置视图时 , 可选择一个提升状态。 

如果分配的提升状态是而不是一个视图标签 , 则此配置仍将为 

只读。 

■ 

Configuration As Of ( 配置截止日期 ) 

注意 

此选项将视图回滚到特定的时间点。它包括恰好在指定日期和时间之前的视图中 

的所有项。 

此选项默认为当前日期和时间 , 但可以选择一个过去的日期和时间。根据视图类 

型 , 此时间可能必须晚于视图创建时间。 

返回当前配置 : 

1 从菜单栏选择 View ( 视图 ) > Select Configuration ( 选择配置 )。 

出现 Select a View Configuration ( 选择视图配置 ) 对话框。 

2 选择 Current Configuration ( 当前配置 ) 选项按钮。 

假定您将一个视图回滚到某个标签或提升状态。要清楚 , 如果以下所有条件为真 , 则带 

有该标签 ( 或与该提升状态相关联的标签 ) 的任何项均会变为特例 : 

■ 

■ 

该项存在于创建标签时 

即使该项现在附加到一个不同的修订 , 它仍然带有该标签 

■ 

该项已被移动到一个不同的文件夹 

回滚视图将该项显示在其原始文件夹中 , 而不管该项的新位置如何。 

在标签创建后所创建的项将在其在回滚视图中的最新位置出现。不再带有该标签的项 , 

不管其是在什么时间创建的 , 都不会出现在回滚视图中。 

控制文件状态信息 

有关您正在处理的文件的文件状态信息将被存储在工作站上的一个中心位置或者每个工 

作文件夹的子文件夹 ( 名为 .sbas ) 中。 

可通过以下方式控制该信息的存储方式和存储位置 : 

■ 

设置控制所有文件的文件状态信息的个人选项 - 除非这些文件位于已设置了文件状态 

的视图属性的视图中。有关详细信息 , 请参阅第 310 页的 “ 设置文件选项 ”。 

■ 

设置特定视图的文件状态属性。该视图属性默认为被选作个人选项的存储方法。如果 

从该默认值进行更改 , 则该视图属性优先于视图的个人选项。 

设置视图的文件状态属性 : 

1 从菜单栏中选择 View ( 视图 ) > Properties ( 属性 )。出现 View Properties ( 视图 

属性 ) 对话框。 

2 选择 Info ( 信息 ) 选项卡。 

3 在 File Status Repository ( 文件状态储存库 ) 组框中 , 选择 Central or Per Folder 

( 中心或按文件夹 ) 选项按钮。 

4 单击 OK ( 确定 )。 

提示可通过选择 Default ( 默认 ) 选项按钮来恢复使用个人选项。 


使用备选工作文件夹 


使用视图配置文件 

视图的工作文件夹可能并不是所有用户的最佳选择。您或任何其他具有此访问权限的用 

户 , 可通过指定备选工作文件夹的方式 , 在自己的工作站上为视图的工作文件夹选择一 

个更有用的位置。例如 , 您可能想要使用一个较短的路径或一个不同的驱动器盘符。请 

记住 , 工作文件夹必须指向一个在物理上离散的位置 , 如工作站上的驱动器或共享文件 

服务器上的个人目录。 Borland 不建议将设置放在映射的网络驱动器上。 

视图的备选工作文件夹路径是工作站和用户所特有的。例如 , 如果您以另外一位用户的 

身份登录项目或使用另一个工作站 , 则您的备选工作文件夹设置将是未知的。 

在为视图指定一个备选工作文件夹时 , 可用类似方式为工作站修改该视图中每个子文件 

夹的工作文件夹路径。对于其工作文件夹与视图的工作文件夹路径相对 ( 与具有绝对路 

径或其自己的备选工作文件夹路径相对 ) 的层次中的每一个文件夹 , 视图工作文件夹的 

备选路径将成为其子文件夹工作路径的一部分。 

使用视图的备选工作文件夹 : 

1 从菜单栏中选择 View ( 视图 ) > Properties ( 属性 )。 View Properties ( 视图属 

性 ) 对话框随即出现。 

2 选择 Info ( 信息 ) 选项卡。 

3 在 Working Folder ( 工作文件夹 ) 组框中 , 选择 Alternate ( 备选 ) 选项按钮。 

4 输入或浏览备选工作文件夹。 

5 单击 OK ( 确定 )。 

View Properties ( 视图属性 ) 对话框关闭 , 使用指定的工作文件夹生效。受到对此工 

作文件夹所做的更改影响的文件将具有 Missing ( 缺失 ) 状态 , 必须将其签出才能生成 

新的工作文件集。 

签出所有 Missing ( 缺失 ) 的文件 : 

1 选择视图的根文件夹。 

2 选择 File ( 文件 ) > Check Out All ( 全部签出 ) 命令。 

3 在随即出现的 Check Out All Descendants ( 签出所有后代 ) 对话框中 , 进行任何 

所需的修改 , 然后单击 OK ( 确定 )。 

4 在随即出现的确认对话框中 , 单击 OK ( 确定 )。 

在文件从储存库复制到工作文件夹期间 , 将显示一个进度对话框。( 项目中不含文件的 

空文件夹不是在工作文件夹中创建的。) 

视图配置文件是一组依工作站而定、应用于视图的限制。可在工作站上创建所需的任何 

数量的配置文件。 

配置文件指定哪些文件夹是可以看到的、对于这些文件夹应用哪些 EOL 及路径区分大 

小写设置。例如 , 如果要从同一视图构建某产品的 UNIX 版本和 Windows 版本 , 则每个 

版本都可能需要一个配置文件。 UNIX 要求路径区分大小写并使用换行作为文本文件中 

的 EOL ( 行尾 ) 字符 , 而 Windows 路径则不区分大小写 , 且 Windows 文本文件使用 

回车 / 换行组合来表示行尾。 

每个视图都至少有一个配置文件。该配置文件被命名为 Default ( 默认值 ), 但可用默认 

设置或基于先前的配置文件创建新的配置文件。 

对某个文件夹的可见性、EOL 和路径大小写区分设置所做的任何更改都将自动成为当前 

所选配置文件的一部分。 

当前配置文件的名称显示在标题栏的末尾附近。例如 : 


使用视图配置文件 

控制配置文件中的文件夹 

可通过使 StarTeam 文件夹可见或不可见 , 将其添加到配置文件或从中删除。 

当一个文件夹在指定的配置文件中不可见时 , 该文件夹的名称仍然保留在文件夹层次 

中 , 但其图标的颜色将从黄色变为白色 , 并且其内容也不再显示。 

更改文件夹的可见性 : 

1 确保要更改的配置文件是当前配置文件 : 

a 从菜单栏选择 View ( 视图 ) > Profiles ( 配置文件 )。 

出现 View Profiles ( 视图配置文件 ) 对话框。 

b 选择正确的配置文件 , 然后单击 Select ( 选择 )。 

c 单击 Close ( 关闭 )。 

2 选择要使其不可见或恢复可见性的文件夹。 

3 从菜单栏选择 Folder ( 文件夹 ) > Properties ( 属性 )。 

出现 Folder Properties ( 文件夹属性 ) 对话框。 

4 选中或清除 Visible ( 可见 ) 复选框。 

5 单击 OK ( 确定 )。 

控制配置文件中的 EOL 字符和路径区分大小写 

两个配置文件间的区别以哪些文件夹可见 , 以及这些文件夹的哪些 EOL 和路径区分大 

小写设置处于活动状态为基础。 

1 确保要更改的配置文件是当前配置文件 : 

a 

从菜单栏选择 View ( 视图 ) > Profiles ( 配置文件 )。出现 View Profiles ( 视图 

配置文件 ) 对话框。 

b 选择正确的配置文件 , 然后单击 Select ( 选择 )。 

c 单击 Close ( 关闭 )。 

2 选择要求更改 EOL 和 / 或路径区分大小写设置的文件夹。 

3 从菜单栏选择 Folder ( 文件夹 ) > Properties ( 属性 )。 


4 选择 File ( 文件 ) 选项卡。 

5 ( 可选 ) 在 EOL Conversion(EOL 转换 ) 组框中 , 选中 Override For This Folder And 

All Its Child Folders ( 覆盖此文件夹及其所有子文件夹 ) 复选框 , 以对该文件夹的子 

文件夹的此种设置也进行更改。 

6 ( 可选 ) 选择适当的 EOL 字符的选项按钮。例如 , 上图针对 UNIX 文件显示了 LF。 

7 ( 可选 ) 在 File Path Conventions ( 文件路径约定 ) 组框中 , 选中 Override For 

This Folder And All Its Child Folders ( 覆盖此文件夹及其所有子文件夹 ) 复选框 , 以 

对该文件夹的子文件夹的此种设置也进行更改。 

8 ( 可选 ) 选中 Case Sensitive File Paths ( 区分大小写的文件路径 ) 复选框。 

9 单击 OK ( 确定 )。 


查看视图属性 

查看视图属性 

刷新视图 

有时 , 您可能想要查看创建某个视图时最初使用的值和属性。查看此信息可帮助您了解 

从其中派生的一个或多个视图的变化情况。 

查看当前视图属性 : 

1 从菜单栏中选择 View ( 视图 ) > Properties ( 属性 )。 View Properties ( 视图属 

性 ) 对话框随即出现。 

2 选择 Info ( 信息 ) 选项卡以查看 : 

■ 

■ 

■ 

■ 

视图的名称和说明 

视图的创建者和创建时间 

项是否被设置为更改时分支 

是否使用中心或按文件夹储存库 

■ 

工作文件夹路径 

注 : 根据您的访问权限 , 您也许能够更改上述的某些项。 

3 选择 Hierarchy ( 层次 ) 选项卡以查看此项目视图的层次。 

4 选择 Type ( 类型 ) 选项卡以查看 : 

■ 

■ 

■ 

■ 

■ 

视图类型 

视图是分支视图还是根视图 

( 对于分支视图 ) 原始默认值是 Branch All ( 全部分支 ) 还是 Branch None ( 无 

分支 ) 

此视图基于的父视图 

用于创建此视图的父配置 

5 要退出 , 请单击 Cancel ( 取消 )。 

可通过以下方式刷新 StarTeam 数据 : 

■ 

按 F5 为当前项刷新右上部窗格 

■ 

按 Ctrl+F5 刷新上部窗格 , 同时折叠所有打开的组。 

■ 

按 Shift + F5 刷新整个视图 ( 所有选项卡和文件夹层次中的所有项列表 )。 

■ 

按 F6 从外部存档 ( 如 Visual SourceSafe 或 PVCS) 刷新文件。在按 F6 之前 , 务必 

启用 All Descendants( 所有后代 ) 按钮 ( 或从 File( 文件 ) 菜单选择 All Descendants 

( 所有后代 )), 这样刷新便可在所有子文件夹中递归。 

查看连接属性 

在 StarTeam 中 , 可从一个或多个项目打开多个视图。可从一个或多个服务器配置访问 

项目。有时 , 贵公司会在不同的服务器上使用相同的项目名 , 或在不同的项目中使用相 

同的视图名。 

查看连接属性可使您验证服务器、地址、端点 ( 端口 )、登录用户和登录时间。 


从 StarTeam 注销 

检查连接属性 : 

1 从菜单栏选择 Project ( 项目 ) > Connection Properties ( 连接属性 )。出现 

Connection Properties ( 连接属性 ) 对话框。 


2 单击 OK ( 确定 )。 

关闭 StarTeam 或显示使用给定用户名和密码的给定服务器的项目视图的最后一个窗口 

后 , 将从服务器注销。 Cross-Platform 客户机提供了一个特殊的 Log Off 命令 , 利用该 

命令可同时关闭上述的所有窗口。此操作还执行只有 Cross-Platform 客户机才需要的一 

些清除操作。 

关闭使用给定用户名的给定服务器的所有窗口 : 

1 从菜单栏选择 Project ( 项目 ) > Log Off ( 注销 )。 

2 在随即出现的对话框中 , 单击 Yes ( 是 ) 以确认。 




章 

使用 StarTeam Toolbar 

第 4 章 

StarTeam Toolbar( 以后简称为工具栏 ) 是 StarTeam 和 CaliberRM 产品的组件 , 是为 

方便登录多台服务器和启动不同程序而设计的。 

工具栏自动高速缓存用于登录到每个 StarTeam 或 CaliberRM 服务器的用户名和密码 , 

从而减少了为执行某些操作而必须登录同一台服务器的次数。( 必要时可以忽略自动登 

录功能。有关详细信息 , 请参阅第 39 页的 “ 以不同的用户身份登录 ”。) 

最初 , 工作站上安装的 StarTeam 及 CaliberRM 产品各种工具的快捷方式填入工具栏 

中。由于工具栏使用标准的 Windows 程序快捷方式功能 , 因此您可以轻松地将其它任何 

程序添加为工具。 

工具栏只在 Windows 系列操作系统中运行 , 并且在安装 StarTeam Windows 客户机 

( 以及在 Windows 上安装 StarTeam Cross-Platform 客户机 ) 过程中默认安装。 

注本章介绍 StarTeam Toolbar 在 4.0 版本的 Windows NT Workstation 上运行时的行为。 

由于 Windows 不同版本之间存在区别 , 您会发现您的计算机上会有某些差别。 

第 4 章 : 使用 StarTeam Toolbar 33

启动工具栏 

使用工具栏可以 : 

■ 

指定用户界面的哪一部分可见 ( 无、仅系统托盘、仅窗口或系统托盘和窗口 )。默认 

情况下 , 只显示工具栏系统托盘图标。 

■ 

查看高速缓存的服务器 / 用户关联。 

■ 

■ 

为每台服务器使用相同的用户名和密码 , 这样只要该用户名和密码对其它服务器有 

效 , 您就不必再登录那些服务器。 

在工具栏上添加程序快捷工具 , 从而可以轻松启动这些工具。( 也可修改或删除现有 

工具。) 

■ 

显示工具栏帮助信息或 About ( 关于 ) 对话框。 

启动工具栏 

StarTeam 和 CaliberRM 客户机自动启动 StarTeam Toolbar。要手动启动工具栏 , 请选 

择 “ 开始 ” > “ 程序 ” > StarTeam > StarTeam Toolbar。 

第一次启动工具栏时 , 只显示其系统托盘图标。 

StarTeam Toolbar 

最初 , 工作站上安装的 StarTeam 及 CaliberRM 产品各种工具的快捷方式填入工具栏 

中。这些工具显示在系统托盘图标的弹出菜单和窗口的工具栏区域上。 

要使工具栏更有用 , 可以执行以下操作 : 

■ 

更改选项值。( 请参阅第 35 页的 “ 指定工具栏户界面 ” 和第 38 页的 “ 登录 StarTeam 

服务器 ”。) 

■ 

添加、修改或删除工具。( 请参阅第 41 页的 “ 自定义工具栏 ”。) 

打开工具栏窗口 

从工具栏系统托盘图标的上下文菜单中选择 Open( 打开 ) 命令 , 可以打开工具栏窗口。 

如果工具栏用户界面的任何部分都不可见 , 可以通过启动工具栏的另一个实例显示其展 

开的窗口。( 为此 , 请选择 “ 开始 ” > “ 程序 ” > StarTeam > StarTeam Toolbar。) 


指定工具栏户界面 


工具栏提供下列选项 , 用来指定其用户界面的哪个部分是可见的 : 

■ 

■ 

无 

仅系统托盘 

■ 

仅窗口 ( 折叠或展开 ) 


■ 

系统托盘和窗口 

工具栏的功能因其用户界面的可见程度而异。 

■ 

即使任何用户界面都不可见 , 工具栏仍然可以高速缓存用于登录各 StarTeam 或 

CaliberRM 服务器的用户名和密码。( 如果在 Log On ( 登录 ) 对话框中选中 “Save 

as default credentials for this server ( 保存为此服务器的默认凭证 )” 选项 , 则发生 

此类情况。) 

选择 “Use same user name/ password for each server ( 对每个服务器都使用相同 

用户名 / 密码 )” 选项时 , 每台附加的服务器都自动使用第一个保存的用户名和密码 , 

因而不需要登录其它用户名和密码有效的服务器。 

■ 

系统托盘界面可见时 , 还可以执行以下操作 : 

■ 

打开工具栏窗口。 

■ 

启动现有工具。 

■ 

显示工具栏帮助信息或 About ( 关于 ) 对话框。 

■ 

退出工具栏。 

■ 

窗口可见并且是折叠状态时 , 还可以执行以下操作 : 

■ 

在工具栏上添加其它程序快捷工具 , 从而可以轻松找到并启动这些工具。( 也可修 

改或删除现有工具。) 

■ 

展开窗口 , 访问附加功能。 



■ 

窗口可见并且是展开状态时 , 还可以执行以下操作 : 

■ 

设置工具栏选项。 

■ 

查看高速缓存的服务器 / 用户关联。 

启动时显示工具栏窗口 

工具栏提供一个可折叠或展开的窗口 , 该窗口有一个上下文菜单。 

此部分用户界面的可见性由 “Display expanded Toolbar at startup( 启动时显示展开的 

工具栏 )” 选项的值决定 : 

■ 

如果选择此选项 , 则启动工具栏时将自动打开展开的工具栏窗口。 

注 

■ 

如果清除此选项 , 则启动工具栏时不显示该窗口。但是可以从系统托盘图标的上下文 

菜单中选择 Open ( 打开 ) 命令打开该窗口。 

如果工具栏用户界面的任何部分都不可见 , 可以通过启动工具栏的另一个实例显 

示其展开的窗口。为此 , 请选择 “ 开始 ” > “ 程序 ” > StarTeam > StarTeam 

Toolbar。 

工具栏窗口的工具栏区域的上下文菜单提供下列命令 : 

■ 

Add Tool( 添加工具 ), 可打开一个向导 , 用来在工具栏的 Tools 文件夹中创建一个 

标准 Windows 快捷方式。( 有关详细信息 , 请参阅第 42 页的 “ 添加工具 ”。) 

添加或修改工具后 , 必须选择 Refresh Tools ( 刷新工具 ) 命令 , 以使更改在窗口的 

工具栏区域中和系统托盘图标的上下文菜单中反映出来。 

■ 

Modify Tool ( 修改工具 ) , 可为选定工具的程序快捷方式打开 Properties ( 属性 ) 

对话框。( 有关详细信息 , 请参阅第 43 页的 “ 修改工具属性 ”。) 

■ 

■ 

■ 

■ 

■ 

Delete Tool( 删除工具 ), 可从 Tools 文件夹中删除选定工具的程序快捷方式 , 从系 

统托盘图标的上下文菜单中删除该工具的条目 , 刷新窗口的工具栏区域以删除该工具 

的图标。( 有关详细信息 , 请参阅第 45 页的 “ 删除工具 ”。) 

Refresh Tools ( 刷新工具 ), 通过处理 Tools 文件夹中的所有程序快捷方式来刷新 

窗口的工具栏区域和系统托盘图标的上下文菜单。( 有关详细信息 , 请参阅第 45 页的 

“ 刷新工具栏 ”。) 

Open Tools Folder ( 打开 Tools 文件夹 ), 可打开该文件夹的资源管理器窗口 , 其 

中包含工具栏使用的程序快捷方式。 

Help ( 帮助 ), 可显示工具栏帮助信息。( 有关详细信息 , 请参阅第 46 页的 “ 显示 

工具栏帮助信息 ”。) 

About ( 关于 ) , 可显示工具栏 About ( 关于 ) 对话框。( 有关详细信息 , 请参阅 

第 46 页的 “ 显示工具栏的 About 对话框 ”。) 

■ 

Exit( 退出 ), 可退出工具栏。( 有关详细信息 , 请参阅第 47 页的 “ 退出工具栏 ”。) 



工具栏窗口最小化时隐藏任务栏按钮 

如果选中 “Hide taskbar button when Toolbar is minimized ( 工具栏最小化时隐藏任务 

栏按钮 )” 选项 , 则当工具栏窗口最小化时 , 在 Windows 任务栏上不显示该按钮。 

如果清除此选项 , 则工具栏窗口最小化时在 Windows 任务栏上包含该按钮。 

隐藏工具栏系统托盘图标 

工具栏提供一个系统托盘图标 , 该图标有一个上下文菜单。 

此部分用户界面的可见性由 “Display system tray icon”( 显示系统托盘图标 ) 选项的 

值决定 : 

■ 

如果选择 “Display system tray icon”( 显示系统托盘图标 ) 选项 , 则在 Windows 系 

统托盘中将显示工具栏的图标。 

■ 

如果清除此选项 , 则在 Windows 系统托盘中将不显示工具栏的图标。 

工具栏系统托盘图标的上下文菜单提供下列命令 : 

■ 

Open( 打开 ), 可打开工具栏窗口。( 有关详细信息 , 请参阅第 34 页的 “ 打开工具 

栏窗口 ”。) 

■ 

, 可启动相应工具。( 有关详细信息 , 请参阅第 41 页的 “ 启动工具 ”。) 

■ 

■ 


Help ( 帮助 ), 可显示工具栏帮助信息。( 有关详细信息 , 请参阅第 46 页的 “ 显示 

工具栏帮助信息 ”。) 

About ( 关于 ) , 可显示工具栏 About ( 关于 ) 对话框。( 有关详细信息 , 请参阅 

第 46 页的 “ 显示工具栏的 About 对话框 ”。) 

■ 

Exit( 退出 ), 可退出工具栏。( 有关详细信息 , 请参阅第 47 页的 “ 退出工具栏 ”。) 


登录 StarTeam 服务器 


隐藏工具栏用户界面 

如果要使用工具栏自动高速缓存登录到各 StarTeam 或 CaliberRM 服务器时使用的用户 

名和密码 ( 或者对所有服务器使用相同的用户名和密码 ), 但不想从工具栏启动各工具 , 

可以隐藏工具栏用户界面。为此 , 应清除 “Display system tray icon ( 显示系统托盘图 

标 )” 和 “Display expanded Toolbar at startup ( 启动时显示展开的工具栏 )” 选项。 


开的窗口。为此 , 请选择 “ 开始 ” > “ 程序 ” > StarTeam > StarTeam Toolbar。 

在客户机会话期间 ,StarTeam 客户机将维护特定项目视图的服务器连接。在 5.3 发行版 

本之前 , 如果要从不同客户机访问同一个项目视图 , 需要再次登录。 

现在 , StarTeam Toolbar 为您登录的每个服务器高速缓存默认凭证 ( 除非在 Log On 

( 登录 ) 对话框中清除 “Save as default credentials for this server ( 保存为此服务器 

的默认凭证 )” 选项 ), 所以在当前工具栏会话期间您从任何客户机都不需要再次登录该 

服务器。 

如果稍后需要以不同用户身份登录该服务器 , 可以通过在 Open Project Wizard( 打开 

项目向导 ) 中单击 Log On As ( 登录身份 ) 按钮覆盖自动登录功能。有关详细信息 , 请 

参阅第 39 页的 “ 以不同的用户身份登录 ”。 

如果选择 “Use same user name/ password for each server ( 对每个服务器都使用相 

同用户名 / 密码 )” 选项 , 则只要该用户名和密码对其它服务器有效 , 您就不必再登录那 

些服务器。( 如果在某服务器上该用户名和密码无效 , 则可以不同用户身份登录。) 

查看高速缓存的服务器 / 用户关联 

如果登录 StarTeam 或 CaliberRM 服务器 , 并且在 Log On ( 登录 ) 对话框中选择 

“Save as default credentials for this server ( 保存为此服务器的默认凭证 )” 选项 , 则 

工具栏会高速缓存登录该服务器时使用的用户名和密码。( 必要时可以忽略自动登录功 

能。有关详细信息 , 请参阅第 39 页的 “ 以不同的用户身份登录 ”。) 

如果清除 “Use same user name/ password for each server ( 对每个服务器都使用相 

同用户名 / 密码 )” 选项 , 则各服务器可以保存不同的用户名和密码。展开的工具栏窗口 

的下部包含一个表格 , 其中显示当前高速缓存的服务器 / 用户关联的相关信息。 



■ 

Server Type ( 服务器类型 ) 列显示服务器的类型 (StarTeam 或 CaliberRM)。 

■ 

Host Name( 主机名 ) 列显示 StarTeam 或 CaliberRM 服务器所在计算机的网络名。 

■ 

Port ( 端口 ) 列显示特定 StarTeam 服务器配置的端口号 , 从而可以区分在同一台计 

算机上运行的多个服务器。 

■ 

User Name ( 用户名 ) 列显示为该服务器保存的默认凭证中的用户名部分。 

注 

如果需要 , 可以调整表格中列的大小或者调整整个窗口的大小 , 以便更好显示当前信息。 

如果选择 “Use same user name/ password for each server ( 对每个服务器都使用相 

同用户名 / 密码 )” 选项 , 则您尝试访问的每台附加的服务器都自动使用第一个保存的用 

户名和密码 , 因而不需要登录其它用户名和密码有效的服务器。 

只有在工具栏的当前会话期间才高速缓存服务器 / 用户关联。退出工具栏时将清除该高 

速缓存。 

以不同的用户身份登录 

如果登录服务器时在 Log On ( 登录 ) 对话框中选择 “Save as default credentials for 

this server ( 保存为此服务器的默认凭证 )” 选项 , 则 StarTeam Toolbar 会高速缓存用 

户名和密码 , 从而使您在工具栏当前会话期间不需要再次登录此服务器。高速缓存的服 

务器 / 用户关联显示在展开的工具栏窗口下部的表格中。 

为特定服务器保存默认用户凭证后 , 用户名显示在 Open Project Wizard ( 打开项目 

向导 ) 的服务器 / 项目树中该服务器名称后面的括号中。 

如果稍后需要以不同用户身份登录该服务器 , 可以通过单击 LogOnAs( 登录身份 ) 按 

钮覆盖自动登录功能。在随即显示的 Log On ( 登录 ) 对话框中 , 可以输入不同的用户 

名和密码。 

请注意 , 默认情况下 “Save as default credentials for this server ( 保存为此服务器的 

默认凭证 ” 选项是清除的。( 如果选择此选项 , 则新用户凭证将替换先前保存的凭证。) 



如果选择了 “Use same user name/ password for each server”( 对每个服务器都使用 

相同用户名 / 密码 ) 选项 , 则在尝试访问某个默认凭证无效的其它服务器时 , 自动登录尝 

试将失败并显示 Log On ( 登录 ) 对话框 , 您可以不同用户身份 ( 或使用不同密码 ) 登 

录该服务器。 

如果在 Log On( 登录 ) 对话框中选择了 “Save as default credentials for this server” 

( 保存为此服务器的默认凭证 ) 选项 , 则 “Use same user name/ password for each 

server”( 对每个服务器都使用相同用户名 / 密码 ) 选项被清除 , 并为该服务器高速缓存 

新用户凭证。 

使用相同的用户名和密码 

注 

如果在 Log On( 登录 ) 对话框中选择 “Save as default credentials for this server( 保 

存为此服务器的默认凭证 )” 选项 , 则工具栏高速缓存登录 StarTeam 或 CaliberRM 服 

务器时使用的用户名和密码。这样减少了为执行某些操作而必须登录同一台服务器的次 

数。( 必要时可以忽略自动登录功能。有关详细信息 , 请参阅第 39 页的 “ 以不同的用户 

身份登录 ”。) 

如果清除 “Use same user name/ password for each server( 对每个服务器都使用相同 

用户名 / 密码 )” 选项 , 则各服务器可以保存不同的用户名和密码。( 如第 38 页的 “ 查 

看高速缓存的服务器 / 用户关联 ” 中所述 , 可以在展开的工具栏窗口中查看当前高速缓存 

的服务器 / 用户关联。) 

如果选择 “Use same user name/ password for each server”( 对每个服务器都使用相 

同用户名 / 密码 ) 选项 , 则您尝试访问的每台附加的服务器都自动使用第一个保存的用户 

名和密码 , 因而不需要登录其它用户名和密码有效的服务器。 

如果自动登录尝试失败 , 将显示 Log On ( 登录 ) 对话框 , 从而可以不同用户身份登 

录该服务器。如果在 Log On ( 登录 ) 对话框中选择了 “Save as default credentials 

for this server”( 保存为此服务器的默认凭证 ) 选项 , 则 “Use same user name/ 

password for each server”( 对每个服务器都使用相同用户名 / 密码 ) 选项被清除 , 并 

为该服务器高速缓存新用户凭证。 


启动工具 

启动工具 

可通过以下方法启动 StarTeam Toolbar 上的工具 : 

■ 

从工具栏系统托盘图标的上下文菜单中选择该工具的条目 

■ 

单击工具栏窗口中该工具的图标 

自定义工具栏 

最初 , 工作站上安装的 StarTeam 及 CaliberRM 产品的各种工具的快捷方式填入工具栏 

中。如果要从工具栏启动其它程序 , 必须将程序快捷方式添加到其中。工具按其程序快 

捷方式的名称的字母顺序显示在工具栏上。 

可以通过以下方法自定义工具栏 : 

■ 

使用工具栏窗口的上下文菜单中的命令 ( 通过右键单击工具栏区域访问上下文菜单 )。 



■ 

通过资源管理器窗口 , 直接在工具栏的 Tools 文件夹中使用程序快捷方式。 

添加、修改或删除工具后 , 必须使用 Refresh Tools ( 刷新工具 ) 命令 , 以使这些更改 

在窗口的工具栏区域中和系统托盘图标的上下文菜单上反映出来。 

自定义工具栏的详细操作步骤在以下主题中介绍 : 

■ 

添加工具 

■ 

修改工具属性 

■ 

删除工具 

■ 

刷新工具栏 

添加工具 

可通过以下方法向 StarTeam Toolbar 添加工具 : 

■ 

新建程序快捷方式 ( 使用选择 Add Tool ( 添加工具 ) 命令后显示的向导 ) 

■ 

将现有程序快捷方式复制到工具栏的 “Tools” 文件夹 ( 使用 Windows 资源管理器 ) 

注 

向工具栏添加工具后 , 必须选择 Refresh Tools ( 刷新工具 ) 命令 , 以便刷新窗口的工 

具栏区域和系统托盘图标的上下文菜单。( 可能还要修改工具的属性。有关详细信息 , 请 

参阅第 43 页的 “ 修改工具属性 ”。) 

如果向工具栏添加的工具超过窗口的当前大小 , 无法全部显示 , 则应扩大窗口 , 使 

所有工具图标都可见。 

通过新建快捷方式添加工具 : 

1 右键单击工具栏窗口的工具栏区域 , 然后选择 Add Tool ( 添加工具 ) 命令。 

2 在随即显示的向导的 Create Shortcut ( 创建快捷方式 ) 页中 , 指定启动工具的命令 

行 , 然后单击 Next ( 下一步 ) 按钮。 

如果不知道程序可执行文件的确切位置 , 则单击 Browse ( 浏览 ) 按钮打开一个对话 

框 , 使用该对话框查找和选择必要的文件。 



3 在向导的 Select a Title for the Program ( 选择程序标题 ) 页中 , 指定工具快捷方式 

的名称 , 然后单击 Finish ( 完成 ) 按钮。 

指定的程序快捷方式创建在工具栏的 Tools 文件夹中。 

4 右键单击工具栏窗口的工具栏区域 , 然后选择 Refresh Tools ( 刷新工具 ) 命令。 

工具的图标添加到窗口的工具栏区域 , 快捷方式名称添加到系统托盘图标的上下文 

菜单。 

通过复制现有快捷方式添加工具 : 

1 右键单击工具栏窗口的工具栏区域 , 然后选择 Open Tools Folder ( 打开 Tools 文件 

夹 ) 命令。随即出现的资源管理器窗口显示该文件夹的内容 , 其中应包含 StarTeam 

Toolbar 上的各工具的程序快捷方式。 

2 在 Windows 资源管理器中 , 找到现有程序快捷方式。 

( 在 Windows NT 中 , 搜索 “ 快捷方式 ” 文件类型。在更新版本的 Windows 中 , 搜 

索名为 “*.lnk” 的文件。) 

3 将现有程序快捷方式复制到工具栏的 “Tools” 文件夹。 


工具的图标添加到窗口的工具栏区域 , 快捷方式名称添加到系统托盘图标的上下文 

菜单。 

修改工具属性 

可以修改 StarTeam Toolbar 上工具的属性。例如 , 可重命名工具 , 包括程序版本号。或 

者 , 在创建快捷方式时接受默认名称 , 然后将可执行文件的名称更改为更具说明意义的 

名称。 

工具栏上工具的程序快捷方式带有属性 , 可使用 Properties( 属性 ) 对话框修改这些属 

性。可以两种方式打开该对话框 : 

■ 

■ 

右键单击某工具的图标 ( 在工具栏窗口的工具栏区域中 ), 然后选择 Modify Tool( 修 

改工具 ) 命令。 

右键单击工具栏窗口的工具栏区域 , 然后选择 Open Tools Folder ( 打开 Tools 文件 

夹 ) 命令。在随即出现的资源管理器窗口中 , 右键单击工具的程序快捷方式 , 然后选 

择 “ 属性 ” 命令。 



可以使用 Windows 的 “ 这是什么 ” 帮助功能获得特定属性的简短说明 : 

1 单击带有问号图标的按钮 ( 在对话框的右上角 )。光标变为包含问号。 

2 单击需要帮助的属性。此操作将显示一个小的帮助窗口。 

注 

修改工具属性后 , 记住右键单击工具栏窗口的工具栏区域 , 然后选择 Refresh Tools( 刷 

新工具 ) 命令 , 以使工具栏处理其 Tools 文件夹中的所有程序快捷方式。 

Windows NT 中的属性对话框不允许更改快捷方式名称。但可以在资源管理器窗口中 

重命名快捷方式 ( 通过编辑快捷方式名称 ), 如以下操作步骤所述。 

重命名工具 ( 在 Windows NT 中 ): 


夹 ) 命令。 

2 在随即显示的资源管理器窗口中 , 执行以下一项操作 : 

■ 

右键单击工具的程序快捷方式 , 然后选择 “ 重命名 ” 命令。 

■ 

单击工具的程序快捷方式 , 然后再次单击图标下方的文本。 

3 编辑名称 , 然后按 Enter 键。 



管理工具栏窗口 

管理工具栏窗口 

删除工具 

如果需要删除 StarTeam Toolbar 上的工具 , 可以在工具栏窗口 ( 使用 Delete Tool ( 删 

除工具 ) 命令 ) 或资源管理器窗口中删除。 

在工具栏窗口中删除工具 : 

1 右键单击某工具的图标 ( 在工具栏窗口的工具栏区域中 ), 然后选择 Delete Tool( 删 

除工具 ) 命令。 

2 在随即出现的确认对话框中 , 单击 Yes ( 是 )。工具栏自动刷新。 

在资源管理器窗口中删除工具 : 


夹 ) 命令。 

2 在随即显示的资源管理器窗口中 , 执行以下一项操作 : 

■ 

右键单击快捷方式 , 然后选择 “ 删除 ” 命令。 

■ 

单击快捷方式 , 然后按 Delete 键。 

3 在随即出现的确认对话框中 , 单击 Yes ( 是 )。 


刷新工具栏 

添加、修改或删除 StarTeam Toolbar 工具的快捷方式后 , 必须刷新工具栏来反映所做更 

改。不管是使用工具栏窗口上下文菜单上的命令 , 还是直接在 Tools 文件夹中处理快捷 

方式 , 刷新操作都是必要的。( 唯一的例外是使用 Delete Tool ( 删除工具 ) 命令删除工 

具 , 该操作自动刷新 “ 工具栏 ”。) 

要刷新工具栏 , 右键单击工具栏窗口的工具栏区域 , 然后选择 Refresh Tools ( 刷新工 

具 ) 命令。此命令通过处理 Tools 文件夹中的所有程序快捷方式来刷新窗口的工具栏区 

域和系统托盘图标的上下文菜单。 

这组主题介绍可以对工具栏窗口执行的下列操作 : 

■ 

■ 

■ 

折叠或展开 

调整大小 

最小化 

■ 

关闭 

从工具栏系统托盘图标的上下文菜单中选择 Open( 打开 ) 命令 , 可以打开工具栏窗口。 


开的窗口。( 为此 , 请选择 “ 开始 ” > “ 程序 ” > StarTeam > StarTeam Toolbar。) 

折叠和展开工具栏窗口 

工具栏窗口可以展开或折叠状态显示。要在这两种状态之间切换 , 单击工具栏上最左侧 

的按钮 ( 其图标为黑色三角形 )。 

请注意 , 要设置工具栏选项或者查看高速缓存的服务器 / 用户关联 , 该窗口必须是展开的。 


显示工具栏帮助信息 

调整工具栏窗口大小 

工具栏窗口展开时可以调整二维尺寸 , 但它折叠时只能调整水平尺寸。( 工具栏的展开 

和折叠状态都有最小尺寸。) 关闭工具栏窗口时保存窗口的尺寸和位置。 

也可以调整用于显示高速缓存服务器 / 用户关联的表格的列大小 , 以便更好显示当前内 

容。但是关闭工具栏窗口时不保存这些调整。 

最小化工具栏窗口 

不使用工具栏窗口时可以将其最小化 , 以减少 Windows 桌面的混乱。 

“Hide taskbar button when Toolbar is minimized”( 工具栏最小化时隐藏任务栏按钮 ) 

选项决定在工具栏窗口最小化时 Windows 任务栏中是否包含某个按钮。( 有关详细信 

息 , 请参阅第 37 页的 “ 工具栏窗口最小化时隐藏任务栏按钮 ”。) 

关闭工具栏窗口 

显示工具栏帮助信息 

关闭工具栏窗口相当于退出程序。有关详细信息 , 请参阅第 47 页的 “ 退出工具栏 ”。 

可通过以下一种方法显示工具栏帮助信息 : 

■ 

■ 

■ 

从系统托盘图标的上下文菜单中选择 Help ( 帮助 ) 命令 

从窗口的上下文菜单中选择 Help ( 帮助 ) 命令 

在展开的窗口中单击 Help ( 帮助 ) 按钮 

显示工具栏的 About 对话框 

可通过以下一种方法显示工具栏的 About ( 关于 ) 对话框 : 

■ 

■ 

■ 

从系统托盘图标的上下文菜单中选择 About ( 关于 ) 命令 

从窗口的上下文菜单中选择 About ( 关于 ) 命令 

在展开的窗口中单击 About ( 关于 ) 按钮 


退出工具栏 

此 About ( 关于 ) 对话框显示工具栏版本信息 , 并有以下按钮 : 

■ 

OK ( 确定 ), 可关闭此对话框。 

■ 

System Info ( 系统信息 ), 可运行 Microsoft 系统信息实用程序。 


退出 StarTeam Toolbar 时 : 

■ 

清除服务器 / 用户关联的缓存。 

■ 

将某些工具栏状态信息保存到 Windows 注册表中 , 其中包括窗口的大小和位置以及 

选项的当前值。 

■ 

程序停止运行。 

根据工具栏用户界面的哪个部分可见 , 可以各种方式退出工具栏 : 

■ 

工具栏窗口可见且处于展开状态时 , 可以右键单击工具栏区域并选择 Exit ( 退出 ) 命 

令、单击窗口右上角的 Close ( 关闭 ) 按钮 , 或单击 Exit ( 退出 ) 按钮。 

Close 按钮 

Exit 按钮 

Exit 命令 



还可以按住 Alt 键的同时按 F4 键 , 或单击窗口左上角的图标并选择 Close( 关闭 ) 命令。 

■ 

工具栏窗口可见且处于折叠状态时 , 可以右键单击工具栏区域并选择 Exit ( 退出 ) 命 

令、或单击窗口右上角的 Close ( 关闭 ) 按钮。 

■ 

工具栏系统托盘图标可见时 , 可以右键单击该图标 , 然后选择 Exit ( 退出 ) 命令。 

■ 

工具栏用户界面的任何部分都不可见时 , 可以使用 Windows 任务管理器结束任务 , 

或者启动工具栏的另一个实例 , 该操作将显示展开的窗口。 

StarTeam Toolbar 用户界面的任何部分都不可见时 , 退出工具栏 ( 使用 Windows 任务 

管理器 ): 

1 右键单击 Windows 任务栏中的空白处 , 然后选择 “ 任务管理器 ” 命令。 

2 在随即显示的 Windows 任务管理器对话框中 : 

a 选择 “ 进程 ” 选项卡。 

b 选择 SBToolbar.exe 条目。 

c 单击 “ 结束进程 ” 按钮。 


章 

管理文件夹 

第 5 章 

StarTeam 管理员通常创建项目和项目视图。如果您是典型用户 , 可例行打开特定项目视 

图并管理 “ 您的 ” StarTeam 文件夹及其内容 ( 如文件和更改请求 )。 

管理 StarTeam 文件夹与管理项目非常相似。您可以创建文件夹、删除文件夹以及修改 

其属性 - 只要有正确的访问权限。关于 StarTeam 文件夹 , 需要注意的最重要属性之一 

是其工作文件夹。原因是您需要知道 StarTeam 将在您工作站的什么地方复制签出的文 

件修订以及新修订必须位于何处才能将其签入。 

可以对文件夹执行许多其它操作 , 如移动文件夹或更改其分支行为。有关详细信息 , 请 

参阅第 223 页的 “ 执行一般性操作 ”。 

了解 StarTeam 文件夹层次 

StarTeam 文件夹是一个容器。通过将各项放入文件夹 , 可在项目视图中对其进行分组。 

例如 , 一个名为 Source Code 的文件夹可包含源代码文件以及这些文件的更改请求。文 

件夹可在创建项目时自动创建。也可在之后由您或他人添加。通常 , 项目由管理员或团 

队领导者创建 , 但只要有正确的访问权限 , 任何人都能创建。如果对于分配给您的访问 

权限还有任何其它问题 , 请咨询 StarTeam 管理员。 

项目的父或根文件夹总是在创建项目的同时创建。它实际上是项目的根 ( 或初始 ) 视图 

的根文件夹。项目、视图以及此根文件夹的名称最初都相同 ( 虽然可更改这些名称 )。 

用户创建项目时 , 他们会在各自工作站选择位置 , 作为这些项目的工作文件夹。指定给 

项目的工作文件夹也会成为该项目根视图以及该视图 StarTeam 文件夹层次中根文件夹 

的工作文件夹。 

工作文件夹是使用文件时 , 工作站上存储这些文件的实际位置。工作文件夹是 StarTeam 

文件夹的一个属性。尽管工作文件夹和 StarTeam 文件夹都被称为文件夹 , 但它们是不 

同的。以下是可将其区分开来的特征 : 

■ 

工作文件夹路径可与 StarTeam 中 StarTeam 文件夹路径完全不同。 

■ 

StarTeam 文件夹是从 StarTeam 内部控制的对象。 

与此文件夹相关的数据存储在用于存储所有项目数据的数据库中。 

■ 

工作文件夹是由操作系统控制的对象。它存储从 StarTeam 签出的文件。 

通常 , 创建项目的用户会在创建项目前 , 在工作站上设置一个文件夹层次。用户将该层 

次的根文件夹指定为项目的工作文件夹。随后 ,StarTeam 便会自动为层次中的每个子文 

件夹创建 StarTeam 文件夹。该子文件夹成为 StarTeam 文件夹的工作文件夹。 

第 5 章 : 管理文件夹 49


例如 , 下图显示 Windows 资源管理器中的一个文件夹层次和所产生的 StarTeam 文件夹 

层次。在本例中 , 每个 StarTeam 文件夹都有对应的文件夹 ( 显示在资源管理器中 ) 作 

为其工作文件夹。 

资源管理器窗口 

StarTeam 视图窗口 

如果 StarTeam 子文件夹是在创建项目时创建的 , 则 : 

■ 

StarTeam 文件夹的工作文件夹是项目创建者的工作站上现有层次的一部分。 

■ 

■ 

它们的名称与各自工作文件夹的名称相同 , 但可在以后更改。例如 , 上图显示某些大 

写更改。 

它们的工作文件夹保留与根文件夹的工作文件夹的分层连接。即 , 如果更改根文件夹 

的工作文件夹的路径 , 便也会更改此文件夹的路径 ( 除非为这些工作文件夹手动设置 

绝对路径 )。换言之 , StarTeam 存储每个子文件夹的相对路径。 



项目、其根视图以及根视图的根文件夹的工作文件夹都相同。对于其它视图 , 每个视图 

及其根文件夹的工作文件夹相同。下图显示某个视图的属性 , 但工作文件夹属性应用于 

项目 StarDraw、视图 StarDraw 以及根文件夹 StarDraw。 

视图 / 根文件夹的工作文件夹始终有一个绝对路径 ( 从驱动器盘符开始 , 逐个命名下一 

级文件夹 , 直到到达工作文件夹本身 )。在本例中 , 该绝对路径为 C:\StarDraw。 

如果查看根文件夹的属性 , 您会发现工作文件夹相同。但是 , 它显示在 Complete 

Working Folder Path ( 完整工作文件夹路径 ) 显示框中 , 而不是 Default ( 默认 ) 文本 

框中。根文件夹的工作文件夹的所有文本框始终被禁用。这是因为只能在视图级别更改 

此工作文件夹。 

对于与项目同时创建的 StarTeam 子文件夹 , StarTeam 会将每个工作文件夹的路径存 

储为相对路径。例如 , 下图显示根文件夹 StarDraw 的一个子文件夹 SourceCode 的工 

作文件夹属性。 

此文件夹的工作文件夹的当前绝对路径 (C:\StarDraw\SourceCode) 显示在 Complete 

Working Folder Path( 完整工作文件夹路径 ) 显示框中。实质上 , 是将 Default( 默认 ) 



文本框中的路径信息附加到此 StarTeam 文件夹的父项的工作文件夹上。因为父项的工 

作文件夹是 C:\StarDraw, 所以此文件夹的工作文件夹为 C:\StarDraw\sourcecode。 

添加新 StarTeam 文件夹 

向项目视图添加 StarTeam 文件夹的方法是 : 使用 Folder ( 文件夹 ) > New ( 新建 ) 或 

将文件夹从 Windows 资源管理器拖动到 StarTeam 中。添加新文件夹时 : 

■ 

新 StarTeam 文件夹的工作文件夹不必与其它 StarTeam 文件夹的工作文件夹属于同 

一个层次。但是 , 如果它与根文件夹的工作文件夹使用相同的驱动器盘符 , 则其路径 

将基于 StarTeam 层次中其父文件夹的工作文件夹的路径存储为相对路径。 

■ 

其名称可以不同于其工作文件夹的名称。 

■ 

如果新工作文件夹有子文件夹 , 则可以为每个子文件夹创建一个 StarTeam 文件夹。 

实质上 , 新添加的文件夹将成为 StarTeam 文件夹新分支的根。 

■ 

为子文件夹创建的 StarTeam 文件夹采用其工作文件夹的名称 - 至少最初如此。 

注 

■ 

这些工作文件夹保留其与作为其层次的根的工作文件夹 ( 即新添加的文件夹的工 

作文件夹 ) 之间的关系。如果更改新添加的文件夹的工作文件夹的路径 , 便也会更 

改这些工作文件夹的路径 ( 除非为这些工作文件夹手动设置一个绝对路径 )。 

第 59 页的 “ 向视图添加 StarTeam 文件夹 ” 详细介绍了添加文件夹的过程。本节就 

新文件夹与其它 StarTeam 文件夹的关系 , 尤其是其工作文件夹与其它 StarTeam 文 

件夹的工作文件夹的关系进行说明。 

假设将一个新 StarTeam 文件夹作为根文件夹的子项添加到 StarDraw 视图中。您为其 

指定的名称与其工作文件夹的名称 - Attachments - 相同 , 并将其工作文件夹指定为 

D:\Attachments。因为此工作文件夹所在驱动器与其父项的工作文件夹不同 (D:\ 而不是 

C:\) , 所以其路径是绝对路径。绝对路径 ( 以驱动器盘符开始的完整路径 ) 出现在 



Default ( 默认 ) 文本框 ( 以及 Complete Working Folder Path ( 完整工作文件夹路径 ) 

显示框 ) 中。这就是判断绝对路径的方法。 

假设 Attachments 文件夹有与其同时添加到视图中的子文件夹。这些子文件夹的工作文 

件夹有相对路径 , 但这些路径是相对于 D:\Attachments, 即其父项的工作文件夹。 

例如 , 假设 Binary 是其中一个子文件夹的名称。并假设其工作文件夹的名称也是 

Binary。下图显示名为 Binary 的文件夹的属性。 

假设将另外一个新 StarTeam 文件夹作为根文件夹的子项添加到 StarDraw 视图中。您 

为其指定的名称与其工作文件夹的名称 - access_stuff - 相同 , 并将其工作文件夹指定为 

C:\access_stuff。因为此工作文件夹与其父项的工作文件夹位于同一驱动器上 , 所以其 

路径是相对路径。 



请注意 ..\, 它表示从父项的工作文件夹开始 , 向上一级 ( 本例中是从 C:\StarDraw 到 

C:\), 然后追加 access_stuff。 

假设 access_stuff 有与其同时添加到视图中的子文件夹。这些子文件夹的工作文件夹也 

有相对路径 , 但它们是相对于 access_stuff 的工作文件夹 , 正如 Binary 的工作文件夹是 

相对于 Attachments 的工作文件夹一样。 

添加现有 StarTeam 文件夹 

注 

通过移动或从其它视图中共享的方式还可向视图添加更多 StarTeam 文件夹。移动或共 

享文件夹时 , 该文件夹会保留其绝对路径或相对路径 , 并应用于新的父文件夹。如果所 

移动的文件夹的路径是相对路径 , 则它通常以不同于其先前拥有的工作文件夹结束。如 

果所共享的文件夹的路径是相对路径 , 则该共享文件夹在每个位置都有一个不同的工作 

文件夹。 

如果所共享或移动的文件夹的新工作文件夹路径超过操作系统的最大工作文件夹路 

径长度 , 即 254 个字符 ( 包括 (\) 反斜杠 ), 则 StarTeam 不允许创建工作文件夹。 

有关移动和共享文件夹的详细信息 , 请参阅第 225 页的 “ 在项目视图之间移动文件 

夹和项 ”。本节仅说明被移动或共享的文件夹与其新的或其它 StarTeam 父文件夹以 

及与其工作文件夹的关系。 



假设将 Test Cases 文件夹从 “ 测试 ” 项目视图移动到 StarDraw 项目视图中。此外 , 假 

设它在 “ 测试 ” 视图中的父项为 Test、工作文件夹为 C:\Test\Test Cases。下图显示其 

原始文件夹属性。 

同样 , 如果已与 StarDraw 项目视图共享 Test Cases, 则 Test Cases 会有两个工作文件 

夹 , 一个视图一个。通常您希望这样 , 因为您可以针对每个视图对 test cases 进行适当 

更改。如果确实希望两个视图使用同一工作文件夹 , 则可以使用上图中的 Browse ( 浏 

览 ) 按钮选择 C:\Test\Test Cases。 

如果将 Test Cases 移动到 StarDraw 项目视图中 , 并将根文件夹 (StarDraw) 作为其父 

项 , 则它会采用以下属性 : 

将 C:\Test\Test Cases 放入 Default ( 默认 ) 文本框中 , 赋予此工作文件夹一个绝对路 

径。例如 , 您可能要同时在两个视图中冻结该文件夹的内容 , 并想通过只使用一个工作 

文件夹的方式来节省空间。 


查找工作文件夹 

查找工作文件夹 

当前视图和从中移动或共享文件夹的视图必须使用相同的 StarTeam Server 配置 , 因 

此 , 必须使用相同的数据库和储存库。 

了解 StarTeam 文件夹与其工作文件夹之间的关系非常重要 , 因为工作文件夹存储签入 

和签出的文件。 

每个文件夹都有一个默认工作文件夹 , 在该工作文件夹中修改工作文件。对于使用相同 

StarTeam 文件夹的团队成员而言 , 各成员工作站上的工作文件夹结构通常是相同的。 

签出文件时 ,StarTeam 将请求的文件修订复制到相应工作文件夹中。如果您的工作站目 

前没有工作文件夹 , 则 StarTeam 会在您签出要放入其中的文件时自动创建一个工作文 

件夹。 

StarTeam 期望您向这些工作文件夹添加和签入新文件修订。如果您的工作站还没有工 

作文件夹 , 可通过 Windows 资源管理器手动创建它 , 或使用 Create Working Folders 

( 创建工作文件夹 ) 命令自动创建。有了工作文件夹后 , 便可向其中添加文件了。 

工作文件夹的准确位置显示为 StarTeam 文件夹的属性之一。 

要确定 StarTeam 文件夹的工作文件夹 , 请从 Folder ( 文件夹 ) 或上下文菜单中选择 

Properties ( 属性 )。产生的 Folder Properties ( 文件夹属性 ) 对话框在 Complete 

Working Folder Path ( 完整工作文件夹路径 ) 显示框中显示路径。 

在工作站上创建特定工作文件夹 : 

1 从 StarTeam 文件夹层次中选择适当的文件夹。 


■ 

从该文件夹签出一个文件。 

注 

■ 

从 Folder( 文件夹 ) 或上下文菜单中选择 Create Working Folders( 创建工作文 

件夹 )。 

有了工作文件夹后 , 可向其复制文件或在其中创建文件 , 然后添加到 StarTeam。 

如果已共享或移动一个工作文件夹路径 , 且新路径长度超过操作系统的最大工作 

文件夹路径长度 , 即 254 个字符 ( 包括 (\) 反斜杠 ), 则 StarTeam 不允许创建工 

作文件夹。 


使用视图的备选工作文件夹 


注 

本节说明如何在视图级别选择备选工作文件夹。您的备选选择可影响工作站上其工作文 

件夹的路径是相对于 StarTeam 根文件夹的所有文件夹。 

在许多情况下 , 团队成员更喜欢所有工作站上的工作文件夹结构都相同。但并不是总能 

做到这一点。例如 , 一个工作站可能有驱动器 C:\, 而另一个工作站可能有驱动器 D:\。 

还可为单个 StarTeam 文件夹创建备选工作文件夹。此更改会影响选定 StarTeam 文 

件夹和它的许多 ( 如果不是全部 ) 子文件夹。有关详细信息 , 请参阅第 64 页的 “ 使 

用备选工作文件夹 ”。 

为视图创建备选工作文件夹 : 

1 打开视图。 

2 从菜单栏中选择 View( 视图 )> Properties( 属性 )。出现 View Properties( 视图 

属性 ) 对话框。 


4 输入工作文件夹的绝对路径或单击 Browse ( 浏览 ) 查找工作文件夹。 

5 单击 OK ( 确定 )。 

例如 , 假设将 StarDraw 项目、视图和根文件夹的工作文件夹从 C:\StarDraw 更改为 

C:\bigcity。 

这会将 SourceCode 的工作文件夹从 C:\StarDraw\sourcecode 更改为 C:\bigcity\ 

sourcecode。但请注意 , 这不会将此文件夹更改为使用备选工作文件夹。该工作文件夹 

有一个基于其默认工作文件夹的相对路径的新位置。 



将 C:\StarDraw 更改为 C:\bigcity 不会更改本章中提到的 Attachments 及其子文件夹的 

工作文件夹。这是因为 Attachments 有一个绝对路径 (D:\Attachments), 且其子文件夹 

的工作文件夹是相对于 D:\Attachments 而不是 C:\StarDraw ( 现在是 C:\bigcity)。 

这不会更改 access_stuff 的工作文件夹 , 因为从 C:\StarDraw 向上移动一级到 C:\ 与从 

C:\bigcity 向上移动一级到 C:\ 的效果相同。 

但是 , 如果将 StarDraw 的备选工作文件夹更改为 C:\bigcity\NewYork, 则 access_stuff 

的位置一定会发生如下图所示的变化。它会从 C:\access_stuff 更改为 C:\bigcity\ 

access_stuff。这是因为从 C:\bigcity\NewYork 向上移动一级会到达 C:\bigcity 而不是 

C:\。 

如果想再次更改路径 , 可编辑 access_stuff 的工作文件夹的相对路径。通常 , 绝对路径 

( 如 C:\access_stuff) 不是最佳解决方案 , 因为其他团队成员可能有其它驱动器。不过 , 

通过单击 Default ( 默认 ) 文本框的 Browse ( 浏览 ) 按钮可创建绝对路径。 


向视图添加 StarTeam 文件夹 


如果向视图添加文件夹 , 其工作文件夹可以是以下任何一项 : 

■ 

工作站上由您指定的任何文件夹。 

■ 

■ 

工作站上由您指定并由 StarTeam 创建的非现有工作文件夹。如果现有文件夹有子文 

件夹 , 还可将一个或多个子文件夹添加到视图中。 

父 StarTeam 文件夹的工作文件夹的一个子文件夹。如果不指定工作文件夹 , 则 

StarTeam 会将新 StarTeam 文件夹的名称附加到其父项的完整工作文件夹路径上。 

注如果父文件夹的工作文件夹路径长度超过操作系统的最大工作文件夹路径长度 , 

即 254 个字符 ( 包括 (\) 反斜杠 ), 则 StarTeam 不允许创建新工作文件夹。 

新添加的文件夹继承父文件夹的行为 ( 只有少数例外 ) 。例如 , 子文件夹可能禁用了 

Branch On Change ( 更改时分支 ) 复选框 , 因为使此文件夹分支无意义。 

如果一个文件夹的父文件夹为只读 , 则不能将该文件夹添加到视图中。父文件夹可能为 

只读状态的原因包括 : 

■ 

父文件夹是只读参考视图的一部分。 

■ 

父文件夹是当前已配置为特定标签、提升状态或日期和时间的视图的一部分 ( 因此 , 

一切都已过去且不可更改 )。 

■ 

父文件夹本身被配置为特定标签、提升状态或日期和时间 ( 因此 , 一切都已过去且不 

可更改 )。 

■ 

父文件夹的行为曾启用 Branch On Change ( 更改时分支 ) 复选框 , 但被清除 , 且父 

视图中的对应文件夹为只读。在新分支视图中 , 选中 Branch On Change ( 更改时分 

支 ) 框前 , 文件夹、文件等不分支。直到那时 , 对文件夹的更改才真正应用到父视图 

中的对应文件夹。如果父视图中的对应文件夹为只读 , 则不应用更改。 

向视图添加新 StarTeam 文件夹 : 

1 从 Folder ( 文件夹 ) 或上下文菜单中选择 New ( 新建 )。出现 New Folder Wizard 

( 新建文件夹向导 ) 对话框。 

2 从文件夹树中选择一个文件夹 , 然后单击 Next( 下一步 )。新文件夹将被创建为选定 

文件夹的子项。 



出现 New Folder Wizard: Folder Name( 新建文件夹向导 : 文件夹名 ) 对话框。 

重要说明 

3 在 Folder Name( 文件夹名 ) 文本框中输入子文件夹的名称。最多使用 254 个字符。 


■ 

■ 

将 Working Folder( 工作文件夹 ) 文本框留空。StarTeam 将创建一个工作文件 

夹 , 该工作文件夹使用新文件夹的名称和其父项的工作文件夹的路径。 

在 Working Folder ( 工作文件夹 ) 文本框中 , 输入或浏览查找一个现有工作文 

件夹的路径。 

浏览路径时 , 将创建此文件夹的工作文件夹的绝对路径。 

如果希望此文件夹的工作文件夹是相对于其父文件夹的工作文件夹 , 请在此文 

本框中输入该路径。请勿浏览。 

5 在 StarTeam Folder Description (StarTeam 文件夹说明 ) 文本框中 , 输入对新文件 

夹的说明 ( 最多 254 个字符 )。 

6 单击 Next ( 下一步 ) 继续。 



New Folder Wizard: Child Folders ( 新建文件夹向导 : 子文件夹 ) 对话框会将 

新文件夹显示在 New Folder's Child Folders ( 新建文件夹的子文件夹 ) 框中。 

如果工作文件夹有子文件夹 , StarTeam 会分别为每个子文件夹添加一个 StarTeam 

文件夹。( 上图显示没有子文件夹的 StarTeam 文件夹。) 


■ 

要从项目中排除某个子文件夹 , 选择该文件夹 , 然后单击 Exclude ( 排除 )。 

■ 

要排除所有子文件夹 , 单击 Exclude All ( 全部排除 ) 。要重新显示已排除的文件 

夹 , 单击 Reset Folders ( 重置文件夹 )。 

8 单击 Next ( 下一步 )。 New Folder Wizard: StarTeam Folders ( 新建文件夹向 

导 :StarTeam 文件夹 ) 对话框显示视图的文件夹层次 , 其中含有新的子文件夹。 

9 单击 Finish ( 完成 )。 


更改 StarTeam 文件夹名或说明 

提示 

向 StarTeam 项目视图添加文件夹的另一种方法是将文件夹从 “ 资源管理器 ” 或 “ 网上 

邻居 ” 拖到 StarTeam 项目视图中的一个现有文件夹。另外 , 在从 “ 资源管理器 ” 或 

“ 网上邻居 ” 拖动文件夹前要在 StarTeam 项目视图中选择一个文件夹 , 以确保选定文件 

夹成为新文件夹的父项。新文件夹的工作文件夹是向其中拖动文件夹的位置。 

更改 StarTeam 文件夹名或说明 

使用 Folder Properties ( 文件夹属性 ) 对话框可更改文件夹名和说明。 

更改文件夹名或说明 : 

1 从文件夹层次中选择文件夹。 

2 从 Folder ( 文件夹 ) 或上下文菜单中选择 Properties ( 属性 )。出现 Folder 

Properties ( 文件夹属性 ) 对话框。 

3 选择 Name ( 名称 ) 选项卡。 

4 更改名称或说明 , 或同时更改两者。 

5 单击 OK ( 确定 )。 

从 StarTeam 文件夹中排除文件 

使用 Folder Properties ( 文件夹属性 ) 对话框可排除特定文件或特定类型的文件 , 使 

其不可见。如果 StarTeam 文件夹的工作文件夹中的某个工作文件具有 Not In View( 不 

在视图中 ) 状态 , 且它符合某个排除列表中的文件规范 , 则 StarTeam 不显示该文件。 

就好像该文件不存在一样。 

例如 , 假设正在某个应用程序中创建文件 , 此应用程序在您每次保存文件时都对每个文 

件进行自动备份 ( 使用扩展名 .bak)。您的工作文件夹可能包含若干 .bak 文件 , 但却没 

有理由将这些文件添加到 StarTeam 项目视图中。从 StarTeam 中看到这些 .bak 文件作 

为可能的候选文件将会使人受到干扰 , 因此将它们排除。排除文件是逐个文件夹进行 

的。但可从父文件夹继承排除列表。 


为其它操作系统文件创建 StarTeam 文件夹 

从文件夹中排除文件 : 


2 从 Folder ( 文件夹 ) 或上下文菜单中选择 Properties ( 属性 )。 


3 选择 Exclude ( 排除 ) 选项卡。 


■ 

选择 Inherit And Use Local Exclude Lists( 继承并使用本地排除列表 ) 选项按钮 , 

排除与此文件夹的排除列表以及可用于其父文件夹的排除列表相匹配的文件。 

■ 

选择 Local Exclude List ( 本地排除列表 ) 选项按钮 , 排除仅与此文件夹的排除列 

表相匹配的文件。 

■ 

选择 No Exclude List ( 无排除列表 ) 选项按钮 , 确保包括所有文件。 

注 

5 单击 OK ( 确定 )。 

Exclude( 排除 ) 选项卡对于已成为项目的一部分的文件没有影响 , 只影响状态为 Not In 

View ( 不在视图中 ) 的文件。 

为其它操作系统文件创建 StarTeam 文件夹 

注 

利用 StarTeam, 使得将版本控制应用于由其它操作系统管理的文件变得很容易。您只需 

在运行 UNIX 或其它操作系统的计算机上映射一个位置作为运行 Windows NT 或 2000 

的计算机的驱动器。可使用以下任何一种方法进行映射 : 

■ 

■ 

Microsoft 的 UNIX 服务包 

另一第三方 NFS (Sun 网络文件系统 ) 服务包 , 它允许 Windows 系统与通过 NFS 

服务共享文件的计算机相连 

■ 

UNIX 或其它操作系统上的 Samba, 它从所在的系统提供 Windows SMB ( 系统消息 

块 ) 文件共享服务 

映射驱动器之后 , 可为该驱动器创建一个 StarTeam 文件夹 , 并将该位置的文件置于版 

本控制之下。 

但是 , 这将对文件名和文本文件中使用的行尾 (EOL) 标记都会产生影响 , 因为 : 

■ 

Windows 平台使用回车 / 换行 (CR/LF) 组合作为 EOL 字符 , 而 UNIX 使用换行 (LF), 

其它一些操作系统则只使用回车 (CR)。 

■ 

UNIX 文件名 ( 和其它一些操作系统的文件名 ) 区分大小写 , 而 Windows 文件名则 

不区分大小写。例如 , foo.txt 和 Foo.txt 在 UNIX 和其它平台上是不同的文件 , 但在 

Windows 中则是相同文件。 

所以 , 除创建文件夹外 , 还要必须设置文件夹属性 , 以指示适当的 EOL 字符和区分大小 

写。所选的 EOL 字符和区分大小写设置会成为选定文件夹及其所有子文件夹的设置。但 

是 , 如果需要 , 可逐个文件夹地更改这些设置。 

也可以使用命令行签入和签出 UNIX 文件 ( 在安装 StarTeam Cross-Platform 客户机 

随附的命令行之后 )。有关详细信息 , 请参阅第 321 页的 “ 使用 stcmd 命令行界面 ”。 

Cross-Platform 客户机支持使用个人选项的 EOL 转换。有关详细信息 , 请参阅第 310 页 

的 “ 设置文件选项 ”。 

有关使用视图配置文件中的文件夹属性的信息 , 请参阅第 28 页的 “ 使用视图配置文 

件 ”。 

创建与 UNIX 或其它操作系统的文件一起使用的 StarTeam 文件夹 ( 或文件夹分支 ): 

1 借助于 NFS 或 Samba 服务 , 连接一台运行 UNIX 或其它操作系统的计算机 , 使其作 

为您的工作站的一个驱动器。 



2 使用第 59 页的 “ 向视图添加 StarTeam 文件夹 ” 中的步骤为该驱动器创建一个 

StarTeam 文件夹 ( 或其子文件夹之一 )。 




5 选择 Files ( 文件 ) 选项卡。 

6 在 EOL Conversion (EOL 转换 ) 组框中 , 选中 Override For This Folder And All Its 

Child Folders ( 覆盖此文件夹及其所有子文件夹 ) 复选框。 

7 选择适当的 EOL 字符选项按钮。例如 , 上图针对 UNIX 文件显示 LF。 

8 在 File Path Conventions( 文件路径约定 ) 组框中 , 选中 Override For This Folder 

And All Its Child Folders ( 覆盖此文件夹及其所有子文件夹 ) 复选框。 

9 选中 Case Sensitive File Paths ( 区分大小写的文件路径 ) 复选框。 

10 单击 OK ( 确定 )。 


注 

StarTeam 管理员将为视图设置初始工作文件夹 , 从而也为该视图中的大部分子文件 

夹设置初始工作文件夹。当团队成员添加 StarTeam 文件夹时 , 他们也会为这些 

StarTeam 文件夹选择工作文件夹。然而 , 您可以使用自己工作站上的备选工作文件 

夹。例如 , 假设您是技术编著者 , 且名为 User Manuals 的 StarTeam 文件夹的工作文 

件夹为 C:\orion\documentation\manuals。如果更喜欢使用较短的路径或以前用于手 

册的路径 , 如 C:\manuals, 则可在 StarTeam 中为自已设置一个备选工作文件夹。 

如果您已经在使用某个特定 StarTeam 文件夹的工作文件夹 , 另请参阅第 65 页的 

“ 更改工作文件夹 ”。 

使用备选工作文件夹 : 



更改工作文件夹 



注 



5 在工作站的硬盘驱动器上为 StarTeam 文件夹及其子文件夹的工作文件夹指定一个更 

方便的位置。例如 , 您可能想使用一个较短的路径或其它驱动器盘符。 

6 单击 OK ( 确定 )。 

备选工作文件夹路径是特定于工作站的。例如 , 如果您以另外一位用户的身份登录到 

此工作站的项目 , StarTeam 将使用备选文件夹。如果您以自己的身份登录到另一个 

工作站 , 则您的备选工作文件夹设置为未知。 

更改工作文件夹 

如果一直在使用一个工作文件夹 , 则更改为同一 StarTeam 文件夹的另外一个工作文件 

夹可能会导致文件状态信息丢失 - 除非遵循以下过程。更改工作文件夹的方法包括 : 

■ 

更改默认工作文件夹。 

■ 

使用备选工作文件夹。请参阅第 64 页的 “ 使用备选工作文件夹 ”。 

■ 

更改备选工作文件夹。 

执行此更改前 , 最好签入已修改的文件和新文件。这样 , 将文件签出到新位置就不会丢 

失任何状态信息了。 

如果 StarTeam 管理员更改工作文件夹 , 则从新工作文件夹签出文件。然后 , 使用 

Windows 资源管理器 ( 例如 ) 将任何已修改的或新工作文件复制到新位置。 

注意如果您将自己硬盘驱动器上某个位置中的一个或多个工作文件夹移动到另一个位置 , 

然后 , 在 StarTeam 中更改该工作文件夹 , 则该工作文件夹中大部分文件的状态会变 

成 Unknown ( 未知 ), 且不能使用 File ( 文件 ) > Update Status ( 更新状态 ) 来更 

正。但是 , 可以执行强制签出以获得最新修订 , 或执行强制签入使工作文件成为最新 

修订。 


使用视图配置文件中的文件夹属性 

更改默认或备选工作文件夹 : 


■ 

如果要更改工作文件夹 , 请在执行更改前签入需要签入的文件 ( 例如 , 状态为 

Modified ( 已修改 )、 Merge ( 合并 ) 或 Not In View ( 不在视图中 ) 的文件 )。 

■ 

如果更改已完成 ( 例如由 StarTeam 管理员 ), 则记录需要签入的文件。 






■ 

选择 Default ( 默认 ) 选项按钮 , 更改默认工作文件夹路径。 

■ 

选择 Alternate ( 备选 ) 选项按钮 , 更改备选工作文件夹路径。 


■ 

输入一个相对路径。 

■ 

输入或浏览查找一个绝对路径。 

7 单击 OK ( 确定 )。 

8 将文件签出到新工作文件夹。 

9 ( 如有必要 ) 将应在此更改前签入的文件复制到新工作文件夹并将其签入。 

使用视图配置文件中的文件夹属性 

视图配置文件是应用于视图中各文件夹的一组限制。配置文件指定可以看到哪些文件 

夹 , 并指定哪些 EOL 及路径区分大小写设置适用于这些文件夹。例如 , 如果要从同一视 

图构建某产品的 UNIX 版本和 Windows 版本 , 则每个版本都需要一个配置文件。 UNIX 

认为路径区分大小写并使用换行作为文本文件中的 EOL ( 行尾 ) 字符 , 而 Windows 路 

径则不区分大小写 , 且 Windows 文本文件使用回车 / 换行组合来表示行尾。 

有关详细信息 , 请参阅第 28 页的 “ 使用视图配置文件 ”。 


章 

在上部窗格中管理数据 

第 6 章 

在上部窗格中显示最有用的数据是通过共同执行以下操作来实现的 : 

■ 

■ 

■ 

■ 

选择正确的字段 ( 或属性 ) 作为列标题 

对项行进行适当排序和分组 

应用有意义的查询 , 以便只查看关注的行 

创建筛选器以使上述三个标有圆点的项可反复执行 

筛选器性能 

建议针对一个组件 , 在大多数筛选器中都显示相同的字段。用户从一个筛选器切换到另 

一个筛选器时 , 如果新筛选器中显示的字段不同 , 则整个客户机高速缓存将重新加载。 

如果组件中有许多项且服务器上有大量富余内存 , 则应考虑在服务器端为组件开启高速 

缓存功能。服务器端高速缓存是一项高级设置 , 只能在 starteam-server-configs.xml 中设 

置。有关 FilesCaching( 默认情况下打开 )、ChangeRequestCaching、Tasks Caching 

和 TopicsCaching 选项的详细信息 , 请参阅 StarTeam 管理员指南。 

控制列 

可更改出现在上部窗格中的列标题。这将影响在上部窗格中可以看到的内容以及使用 

Find ( 查找 ) 命令可以找到的内容。 

要更改列标题 , 请执行以下一项操作 : 

■ 

在上部窗格中 , 右键单击一个列标题 , 然后从上下文菜单中选择 Show Fields( 显 

示字段 )。 

■ 

从相应项菜单或上下文菜单中选择 Filters( 筛选器 )> Show Fields( 显示字段 )。 

例如 , 如果上部窗格中显示的是文件 , 则可以使用 File ( 文件 ) 菜单。 

Show Fields ( 显示字段 ) 对话框显示两个列表。 Available Fields ( 可用字段 ) 

列表框中包含可显示为列标题但当前未显示的所有字段。 Show These Fields In 

This Order ( 按此顺序显示这些字段 ) 列表框显示当前显示的所有字段。 

第 6 章 : 在上部窗格中管理数据 67

对数据排序和分组 

下图显示文件可用的字段。其它项具有不同的字段。 

注 

有关各项的可用字段列表 , 请参阅第 83 页的 “ 了解字段 ”。 

在 Available Fields ( 可用字段 ) 列表中有可能看到具有同一名称的多个字段。如 

果您有 StarTeam Enterprise 或 Enterprise Advantage, 则大多数字段的显示名称 

都可自定义 , 且 StarTeam Server 不强制它们唯一。因为这能引起混淆 , 所以应该 

避免重复显示名称。 

在上部窗格中显示其它字段。 

1 从 Available Fields ( 可用字段 ) 列表中选择要显示为列标题的字段。 

2 单击 Add ( 添加 )。 

在上部窗格中停止显示字段。 

1 从 Show These Fields In This Order( 按此顺序显示这些字段 ) 列表框选择要删 

除的字段。 

2 单击 Remove ( 删除 )。 

更改要在上部窗格中显示的字段的顺序。 

在 Show These Fields In This Order ( 按此顺序显示这些字段 ) 列表框中将每个字段 

名拖动到所需位置。 

提示双击某个字段名可将其从一个列表框移动到另一个列表框。 

Show Fields( 显示字段 ) 对话框最初显示最常用的字段。选中 Show Advanced Fields 

( 显示高级字段 ) 复选框可从可用字段的完整列表中选取。 


在上部窗格中 , 单击某一列标题 , 将根据该列中的值对数据排序。可按数字、字母、内 

部顺序或内部关键字进行升序排序 , 具体取决于数据。选中 Link ( 链接 ) 选项卡时 , 还 

可以对下部窗格中的数据排序。 

要将排序顺序从升序颠倒为降序 , 请再次单击该标题。排序列的列标题上出现一个三角 

形。对于升序排序尖端朝上 , 对于降序排序尖端朝下。 



下图显示按状态分组的文件 : 

对 File ( 文件 )、 Change Request ( 更改请求 )、 Topic ( 主题 )、 Task ( 任务 ) 或 

Audit ( 审核 ) 菜单使用 Expand All ( 全部展开 ) 或 Collapse All ( 全部折叠 ) 以展开或 

折叠所有组。上图中 , 只有 Status: Modified ( 状态 : 已修改 ) 组已展开。 

要不仅仅执行一个主要排序 ( 基于一列 ) 和 / 或对列中具有相同值的项进行分组 , 请使 

用以下过程。 

执行最多四级的排序 : 


■ 

在上部窗格中右键单击一个列标题 , 然后从上下文菜单中选择 Sort and Group( 排 

序和分组 )。 

■ 

从相应菜单或上下文菜单中选择 Filters( 筛选器 )> Sort and Group( 排序和分组 )。 

Sort and Group ( 排序和分组 ) 对话框显示四个组框 , 每个组框都比上一个略微向 

右缩进一些。第一个组框指定主要排序顺序 , 第二个组框指定次要排序顺序 , 依此类推。 

下图显示 Sort and Group ( 排序和分组 ) 对话框 , 其中含有文件的数据。 

2 ( 可选 ) 要在 First By( 首先按 ) 和 Then By( 然后按 ) 下拉列表框中列出所有字段 , 

请选择对话框底部的 Show Advanced Fields ( 显示高级字段 ) 复选框。有些字段很 

少使用 , 视为高级字段。 

3 从 First By ( 首先按 ) 下拉列表框中选择一个字段。 


使用查询 

重要说明 

有关各项的可用字段列表 , 请参阅第 83 页的 “ 了解字段 ”。如果是在对项进行分组 , 

字段不必显示在上部窗格中。如果不是在对项进行分组 , 可以基于未显示的字段对它 

们排序 , 但是您无法确知一个组在何处结束、下一个组在何处开始。 

4 选择 Ascending ( 升序 ) 或 Descending ( 降序 ) 选项按钮。默认设置为升序。 

5 选择 Group By ( 分组依据 ) 对在本字段中具有相同值的项进行分组。 

如果未选择任何附加排序选项 , 文本字段按 ASCII 顺序排序。枚举型字段和用户 

ID 字段按其内部顺序或内部关键字排序。即 , 枚举型字段按字段创建者指定的顺 

序排序 , 用户 ID 字段按自身的创建顺序排序。对于数值型和日期 / 时间型字段 , 

StarTeam 禁用 Sort Options ( 排序选项 ) 按钮。 

6 ( 可选 ) 选择 Sort Options( 排序选项 ) 获得附加排序选项。出现 Sort Options( 排 

序选项 ) 对话框。 

■ 

■ 

选中 As Text( 以文本 ), 按枚举型字段和用户 ID 字段可能值的名称对其排序。对 

于文本字段 , As Text ( 以文本 ) 是唯一的选择。 

清除 Case-sensitive( 区分大小写 ) 复选框按字母顺序排序 , 或者选中该复选框按 

ASCII 顺序 ( 其中大写字母位于小写字母之前 ) 排序。 

7 使用 Then By ( 然后按 ) 组框重复步骤 3 到 5 以添加次要和更低的排序。 

使用查询 

可以使用查询将在上部窗格中显示的项限制为与该查询匹配的项。对于所选 StarTeam 

文件夹层次部分中的所有项都要执行每个查询。查询所含字段不必显示在上部窗格中。 

StarTeam 查询具有以下特征 : 

■ 

容易识别该查询的名称 

■ 

公用或私有状态 

注 

公用查询可由对其具有使用访问权限的任何人使用。私有查询只显示在您的工作站上。 

■ 

适用于特殊类型 ( 如文件或更改请求 ) 的项的逻辑表达式 

查询显示在同一服务器配置内的每一个项目视图中。例如 , 如果项目 A 和项目 B 在同一 

服务器配置中 , 则可以在这两个项目中使用相同的查询。 

在 Queries ( 查询 ) 对话框中 , 查询按它们的创建顺序列出。此列表不区分大小写。例 

如 , 如果具有名为 “recent CRs” 的查询 , 就不能创建名为 “Recent CRs” 或 “recent 

crs” 的查询。 StarTeam 会认为它们是同一查询。可以拥有具有同一名称的公用查询和 

私有查询 , 它们通过图标来区分。 

查询按公用或私有状态保存后 , 其状态无法更改。不过 , 可以复制一个查询然后更改 

该新查询的状态。由于在私有筛选器中只能使用私有查询、在公用筛选器中只能使用 

公用查询 , 所以如果复制一个筛选器然后更改该新筛选器的状态 , 则 StarTeam 将显 

示一条错误消息 - 除非该筛选器不与任何查询相关联。 

应用现有查询 

您或您的 StarTeam 管理员可以创建您将经常使用的查询。例如 , 您可能会创建一个用 

于查找由您负责的所有更改请求的查询。创建查询后 , 可以用它执行以下操作 : 

■ 

在上部窗格中只列出与此查询相匹配的项。 


使用查询 

■ 

从上部窗格选择与此查询匹配的项 - 尽管仍然显示所有其它选项。 

通常 , 选择这些项的原因是要将它们用作一个组。例如 , 可以打印一个关于这些项的 

报告、为其加标志、附加一个标签或者将其签出 ( 如果它们为文件 )。 

状态栏指示某查询 ( 非筛选器组成部分的查询 ) 是否已应用于上部窗格。 

对上部窗格应用现有查询 : 


■ 

在上部窗格中右键单击一个列标题 , 然后从上下文菜单中选择 Queries ( 查询 )。 

■ 

从相应菜单或上下文菜单中选择 Filters ( 筛选器 ) > Queries ( 查询 )。 

出现 Queries ( 查询 ) 对话框。 

2 选择一个查询。 

3 单击 Select ( 选择 ) 将选定查询应用于上部窗格的内容。 

4 如果对查询效果不满意 , 请重新打开 Queries( 查询 ) 对话框 , 然后单击 Clear Query 

( 清除查询 ) 返回到先前显示的项列表。 

在上部窗格中选择与现有查询相匹配的项 : 

1 从相应菜单或上下文菜单中选择 Select ( 选择 ) > By Query ( 按查询 )。 

Select Query ( 选择查询 ) 对话框将列出所有的现有查询。 

2 选择关注的查询 , 然后单击 OK( 确定 )。与此查询匹配的项将在上部窗格中变为选中。 

状态栏将指示上部窗格中的项数以及该窗格中的选中项数 ( 例如 ,8 files, 1 selected 

(8 个文件 , 1 个选中 ))。 

创建查询 

创建查询之前 , 需要熟练掌握查询的编写并熟悉 Query ( 查询 ) 对话框中树的用法。 

StarTeam 查询是一个逻辑表达式 , 由以下部分组成 : 

■ 

一个或多个条件 

条件由一个字段 ( 不必是当前列标题 )、一个关系运算符和一个要与该字段的值进行 

比较的值组成。 


使用查询 

■ 

例如 , 一个用于查找更改请求的条件可能为 : 

Responsibility Equals Rhonda Thurman 

Responsibility 是字段名 , Equals 是关系运算符 , Rhonda Thurman 是要在 

Responsibility 字段中查找的值。 

将多个条件绑定到一起的逻辑运算符 :AND、 OR 和 NOT。 

例如 , 可查找由 Rhonda Thurman 负责且具有高严重性的所有更改请求。需要使用逻 

辑运算符 AND 将下列两个条件绑定在一起 : 


Severity Equals High 

下图显示含有此查询的 Query ( 查询 ) 对话框。请注意 StarTeam 用于查询的树格 

式。习惯此格式后 , 便能轻松确定查询执行的任务。还请注意 View As Text( 以文本 

查看 ) 按钮允许您以文本格式查看查询。 

上图所示查询的文本格式为 : 

提示 

可以编写只含有一个条件的简单查询 , 也可以编写使用多个条件和一个或多个逻辑运 

算符的较复杂查询。 

创建简单查询 

最简单的查询只有一个条件。例如 , 下面的简单查询用于查找名为 Rhonda Thurman 的 

人员所负责的更改请求 : 



使用查询 

创建简单查询 : 

1 选择相应项选项卡。 


■ 


■ 



3 单击 New ( 新建 )。出现 New Query ( 新建查询 ) 对话框。 

4 在 Name ( 名称 ) 文本框中输入查询的名称。 


■ 

选择 Public ( 公用 ) 复选框将此查询添加到项目中 , 以便任何人都能使用它。 

■ 

清除该复选框使查询变为私有 , 使其只在您的工作站上可用。 

6 创建条件 : 

a 从 Field ( 字段 ) 下拉列表框中选择一个字段。 

Field ( 字段 ) 列表框列出最常用的字段。要在该列表框中包括所有可能的字段 , 

请选中 Show Advanced Fields ( 显示高级字段 ) 复选框。 


b 从 Operator ( 运算符 ) 下拉列表中选择一个运算符。( 有关运算符的详细信息 , 

请参阅第 83 页的 “ 关系运算符 ”。) 

c 

在 Value( 值 ) 文本框或列表框中输入或选择一个值。此值将与每个可用项的选定 

字段的值进行比较。 

7 单击 Add ( 添加 ) 将此条件放到 Query Tree ( 查询树 ) 框中。 

Query Tree ( 查询树 ) 框的默认设置使用 AND 运算符。此运算符为该树的根。对于 

简单查询 , 其中只有一个条件 ( 如默认查询 ), StarTeam 将忽略逻辑运算符。 

下图显示 Rhonda Thurman 的一个私有查询 , 该查询查找由她负责的更改请求。此查 

询只能从她的工作站使用。 


使用查询 

8 ( 可选 ) 单击 View As Text ( 以文本查看 ) 以文本格式查看查询。此视图还向您显 

示 : 您的查询中不包括默认的逻辑运算符 AND。 

9 单击 Save ( 保存 )。 Queries ( 查询 ) 对话框显示您的查询。 

10 如果此为公用查询 , 可以为其设置访问权限。有关详细信息 , 请参阅 StarTeam 管理 

员指南。 


■ 

从 Queries ( 查询 ) 列表选择查询 , 然后单击 Select ( 选择 ) 将该查询应用于上 

部窗格中的项。 

■ 

单击 Close ( 关闭 ) 退出而不应用您的查询。 

可以使用 Queries ( 查询 ) 对话框编辑和复制现有查询。例如 , 如果创建查询时想要改 

变条件 , 可在 Query ( 查询 ) 对话框中选择条件 , 然后单击 Edit ( 编辑 ) 加以修改或 

者单击 Delete ( 删除 ) 进行删除。 

选择 Copy ( 复制 ) 可创建使用现有查询中的条件的另一个查询。之后 , 可以编辑新查 

询的条件 , 也可向其中添加条件。 

注意不要对互相排斥的条件使用 AND 运算符。例如 , 在下面的查询中 , Jack Winter 与 

Lin Hu 两人不能输入了相同的更改请求 , 因此该查询找不到匹配项。 

Created By Equals Jack Winter AND Created By Equals Lin Hu. 

创建较复杂的查询 

StarTeam 允许构造具有多个逻辑运算符的查询。 

在代数学 ( 或文本格式 ) 中 , 对成对条件使用 AND 或 OR, 但是 StarTeam 允许对每个 

逻辑运算符使用任意数量的条件。例如 , 如果您的查询是查找满足下列条件的更改请求 : 


AND 

Severity Equals High 

AND 

CR Number Same or Greater 3000 

文本格式将显示为 : 


使用查询 

View as Text ( 以文本查看 ) 对话框显示两个逻辑运算符 , 而查询树将只需要显示一 

个逻辑运算符 , 如下所示 : 

NOT 运算符可置于任何条件或由 AND 和 OR 连接的条件组合之前。例如 , 如果您的查 

询是查找满足下列条件的更改请求 : 


AND 

NOT either of the following: 

Severity Equals Low 

OR 

Priority Less Than 4 

文本格式将显示为 : 

View as Text ( 以文本查看 ) 对话框显示三个逻辑运算符 , 查询树中的运算符与文本 

中的数量相同 , 但是排列方式略有不同。 

重要说明首先判断距离根最远的节点 , 最后判断根节点。 

创建较复杂的查询 : 

1 按照第 72 页的 “ 创建简单查询 ” 中的步骤 1 到 4 进行操作。默认情况下 , 第一个逻 

辑运算符为 AND。 

2 ( 可选 ) 如果查询中的第一个逻辑运算符应为 OR, 请在查询树中选择 AND 逻辑运算 

符 ; 然后单击 AND->OR->NOT 按钮。此操作将 AND 更改为 OR。同样 , 再单击一 

次会将 OR 更改为 NOT。单击此按钮 , 直到运算变为想要使用的运算为止。 

3 为此逻辑运算符创建条件 : 

a 从 Field ( 字段 ) 下拉列表框中选择一个字段。 

Field ( 字段 ) 列表框列出最常用的字段。要在该列表框中包括所有可能的字段 , 

请选中 Show Advanced Fields ( 显示高级字段 ) 复选框。 


b 从 Operator ( 运算符 ) 下拉列表中选择一个运算符。( 有关运算符的详细信息 , 

请参阅第 83 页的 “ 关系运算符 ”。) 


使用查询 

c 

在 Value( 值 ) 文本框或列表框中输入或选择一个值。此值将与每个可用项的选定 

字段的值进行比较。 

4 单击 Add ( 添加 ) 将此条件放到 Query Tree ( 查询树 ) 框中。 

5 要为此运算符添加更多条件 , 请针对每个附加条件重复步骤 3 和 4。然后继续执行步 

骤 6。 

6 ( 可选 ) 添加另一逻辑运算符 : 

a 

选择一个现有逻辑运算符 ( 应在查询中位于新运算符之前 , 因此在树中为该新运 

算符的父项的那个运算符 )。 

b 单击 AND、 OR 或 NOT 按钮。 

c 如果运算符是 AND 或 OR, 重复步骤 3 到 5。 

如果运算符是 NOT, 重复步骤 6。 

7 ( 可选 ) 对其它逻辑运算符重复步骤 6。 

下图显示一个与本节中其它查询十分相似的查询。该查询查找具有高严重性、 CR 号 

大于 3000 且责任与 Rhonda Thurman 或 Won Park 相关的更改请求。 

查询文本为 : 

查询树为 : 

可以使用拖放操作重新排列查询树中的节点。 

提示 

■ 

最好使用将产生最少匹配项的条件或逻辑运算作为第一个条件或逻辑运算。 

排除查询故障 

为避免创建不正确的查询 , 事先计划好并画出查询树是非常重要的。例如 , 假设要查找 

由 Rhonda Thurman 或 Won Park 负责且具有高严重性的所有更改请求。 

如果您的树如下所示 , StarTeam 会拒绝 : 


使用查询 

在纸上绘制此查询的树时 , 您会注意到 ,AND 是树的根 , 不是 OR。重要线索说明 AND 

在应该至少有两个操作数 ( 在此情况下为条件 ) 时却只有一个。下面是可能绘制在纸上 

的树 : 

因此 , 此查询应该为 : 

此处 AND 有两个操作数 ( 一个是有关严重性的条件 , 另一个是另外两个条件 OR 操作 

的结果 )。 

尽管一般情况下可将逻辑运算符拖动到一个新位置 , 但不能将逻辑运算符拖动到查询树 

的根。要修复早期查询 , 可将 AND 更改为 OR、将 OR 更改为 AND 以及将条件拖动到 

适当位置。 

编辑查询 

为显示一组更有用的数据 , 可能必须要编辑或添加查询。 

编辑查询 : 


■ 


■ 



2 从列表中选择要编辑的查询 , 然后单击 Edit ( 编辑 )。出现 Edit Query ( 编辑查询 ) 

对话框。 

3 编辑树的相应节点 , 然后单击 Save ( 保存 )。 

复制查询 

复制查询功能使您能够在现有查询的基础上创建新查询。不是重新创建现有条件 , 而是 

复制这些条件。 

复制查询 : 


■ 


■ 



2 从列表中选择要复制的查询 , 然后单击 Copy ( 复制 )。 

出现 Copy Query ( 复制查询 ) 对话框。 

3 在 Query Name ( 查询名 ) 文本框中输入新查询的名称。 


■ 

选择 Public ( 公用 ) 复选框将此查询添加到项目中 , 以便任何人都能使用它。 

■ 

清除该复选框使查询变为私有 , 使其只在您的工作站上可用。 


使用筛选器 

5 单击 OK ( 确定 )。此操作将在 Query ( 查询 ) 列表中显示该查询。 

6 如果此为公用查询 , 则能够为其设置访问权限。有关详细信息 , 请参阅 StarTeam 管 

理员指南。 

7 从列表中选择该查询 , 然后单击 Edit ( 编辑 ) 更改该查询中的条件。 

删除查询 

可以删除不再使用的查询。 

删除现有查询 : 


■ 


■ 



2 选择要删除的查询。 

3 单击 Delete ( 删除 )。 

显示一个消息框 , 请求您确认删除操作。 

4 单击 Close ( 关闭 )。 


筛选器是指定的数据排列。它由一组字段 ( 用于列标题 )、排序和分组信息以及一个查 

询组成。 

筛选器以字母数字顺序列出。此列表不区分大小写。因此 , 如果具有一个名为 “recent 

CRs” 的筛选器 , 就不能创建名为 “Recent CRs” 或 “recent crs” 的筛选器。 

要筛选上部窗格中的数据 , 可以 : 

■ 

应用现有筛选器。 

■ 

自己排列数据 , 方法是 : 更改显示的字段、对文件进行排序和分组以及应用查询 ( 如 

上一节所述 )。 

排列数据后 , 可根据该排列创建一个筛选器。这样做使得再次创建相同排列时变得更 

加容易。 

■ 

从头开始创建一个新的筛选器。 

注 

筛选器被创建后 , 它将出现在同一服务器配置内的所有项目视图中。例如 , 如果项目 A 

和项目 B 在同一服务器配置中 , 则可以在这两个项目的视图中使用相同的筛选器。 

可通过对筛选器命名或重命名来更改它们在 Filters ( 筛选器 ) 列表框中的显示顺序。例 

如 , 选择 Files ( 文件 ) 选项卡后 , 文件的筛选器将以字母数字顺序出现在 Filters ( 筛 

选器 ) 下拉列表框中。假设名为的筛选器是文件的 Filters ( 筛选 

器 ) 列表框中的第一个筛选器。如果希望另一个筛选器作为列表框中的第一个筛选器 , 

请给它命名 ( 或使用新名称保存 ) 使其位于列表的顶部。例如 , 使用空格作为筛选器名 

称的第一个字符。 

筛选器按公用或私有状态保存后 , 其状态无法更改。由于在私有筛选器中只能使用私 

有查询、在公用筛选器中只能使用公用查询 , 所以不能复制一个筛选器然后更改该新 

筛选器的状态 , 除非该筛选器不与任何查询相关联。 



应用现有筛选器 

现有筛选器可以为私有 ( 仅供您使用 ) 或者公用 ( 可供具有相应访问权限的所有团队成 

员使用 )。 

StarTeam 允许您以两种方式应用现有筛选器 : 

■ 

从工具栏上的 Filters ( 筛选器 ) 下拉列表框中选择它 

■ 

从 Filters ( 筛选器 ) 对话框选择它 

从 Filters ( 筛选器 ) 对话框应用筛选器 : 


■ 

在上部窗格中右键单击一个列标题 , 然后从上下文菜单中选择 Filters ( 筛选器 )。 

■ 

从相应菜单或上下文菜单中选择 Filters ( 筛选器 ) > Filters ( 筛选器 )。 

出现 Filters ( 筛选器 ) 对话框。 

2 从该对话框中选择一个筛选器。 

3 单击 Select ( 选择 ) 将该筛选器应用于数据。 

创建筛选器 

为使您的工作变得更加轻松 , 可以创建一些筛选器。例如 , 如果您是 QA 主管 , 可能需 

要检查在特定时间范围内找到的更改请求的数量。 

将数据的当前排列保存为筛选器 : 


■ 

在上部窗格中右键单击一个列标题 , 然后从上下文菜单中选择 Save Current 

Settings ( 保存当前设置 )。 

■ 

从相应菜单或上下文菜单中选择 Filters( 筛选器 )> Save Current Settings( 保存 

当前设置 )。 

出现 Save Current Settings ( 保存当前设置 ) 对话框。 

2 在 Filter Name ( 筛选器名 ) 文本框中 , 输入此筛选器的名称。 


■ 

选择 Public ( 公用 ) 复选框将此筛选器添加到项目中 , 以便任何具有相应访问权 

限的人都能使用它。 

■ 

清除该复选框使筛选器变为私有 , 使其仅可供您使用。 

从头开始创建一个新的筛选器 : 


■ 


■ 




出现 Filters ( 筛选器 ) 对话框。下图显示文件的 Filters ( 筛选器 ) 对话框 , 其中含 

有默认筛选器。 

2 单击 New ( 新建 )。出现 New Filter ( 新建筛选器 ) 对话框。 

3 在 Filter Name ( 筛选器名 ) 文本框中 , 输入此筛选器的名称。 


■ 

选择 Public ( 公用 ) 复选框将此筛选器添加到项目中 , 以便任何具有相应访问权 

限的人都能使用它。 

■ 

清除该复选框使筛选器变为私有 , 使其仅可供您使用。 

5 单击 OK ( 确定 ) 返回到 Filters ( 筛选器 ) 对话框。 

6 选择以下部分或全部选项 : 

■ 

Fields( 字段 ), 以选择列标题字段。为此 , 请遵循第 67 页的 “ 控制列 ” 中的步骤。 

■ 

■ 

Sort, Group( 排序、分组 ), 最多按四个类别以升序或降序顺序对各项进行排序和 

分组。为此 , 请遵循第 68 页的 “ 对数据排序和分组 ” 中的步骤。 

Query ( 查询 ) , 将显示在上部窗格中的项限制为与该查询相匹配的项。请遵循 

第 71 页的 “ 创建查询 ” 中的步骤。 

7 如果要创建文件的筛选器 : 

a 

单击 Context( 上下文 ) 将受该筛选器影响的文件限制为在视图中、不在视图中或 

所有未排除的文件。 

出现 Set Filter Type ( 设置筛选器类型 ) 对话框。 

b 通过选择一个选项按钮将筛选器应用为下列筛选器之一 : 

■ 

Items In The View ( 视图中的项 ) 

这相当于同时应用您的筛选器和 Files In View 筛选器。 

■ 

Items Not In The View ( 不在视图中的项 ) 

这相当于同时应用您的筛选器和 Files Not In View 筛选器。 

■ 

All Items Not Excluded From The View ( 所有未从视图中排除的项 ) 

这相当于同时应用您的筛选器和筛选器。 


9 如果此为公用筛选器 , 则能够为其设置访问权限。有关详细信息 , 请参阅 StarTeam 

管理员指南。 




■ 

单击 Select ( 选择 ) 将筛选器应用于上部窗格。 

■ 

单击 Close ( 关闭 ) 退出而不应用您的筛选器。 

提示 

可以基于现有筛选器创建新的筛选器 , 方法是从 Filter ( 筛选器 ) 对话框中选择一 

个筛选器 , 单击 Save As ( 另存为 ) 将其重命名 , 然后根据需要编辑该筛选器的组成 

部分。 

编辑筛选器 

可通过更改筛选器的字段、排序顺序或查询来编辑筛选器。 

编辑筛选器 : 


■ 


■ 



2 从列表框中选择一个筛选器。 

3 按照第 79 页的 “ 创建筛选器 ” 中的步骤 4 到 9 进行操作。 

4 单击 Save As ( 另存为 )。出现 Save Filter As ( 筛选器另存为 ) 对话框。请勿更改 

筛选器名。 



■ 

单击 Select ( 选择 ) 将编辑过的筛选器应用于上部窗格。 

■ 

单击 Close ( 关闭 ) 退出而不应用编辑过的筛选器。 

复制筛选器 

可使用 Filters ( 筛选器 ) 对话框中的 Save As ( 另存为 ) 按钮复制筛选器。如果复制与 

某个查询关联的筛选器 , 则新筛选器必须与原始筛选器具有相同的状态 ( 公用或私有 )。 

这是因为只有公用查询才能与公用筛选器一起使用 , 只有私有查询才能与私有筛选器一 

起使用。 

复制筛选器 : 


■ 


■ 



2 从列表框中选择一个筛选器。 

3 单击 Save As ( 另存为 )。出现 Save Filter As ( 筛选器另存为 ) 对话框。 

4 为该筛选器指定一个新名称。 

5 选中或清除 Public ( 公用 ) 复选框。 

如果有查询与此筛选器关联 , 则新筛选器的状态必须与原始筛选器的状态相同。 



■ 

单击 Select ( 选择 ) 将编辑过的筛选器应用于上部窗格。 


为查询和筛选器设置访问权限 

■ 

单击 Close ( 关闭 ) 退出而不应用编辑过的筛选器。 

复制具有关联查询的筛选器并更改其公用 / 私有状态 : 

1 首先复制该查询 , 为新查询指定相应状态。 

2 将原始查询与该筛选器分离。 

3 复制筛选器。 

4 将原始查询重新附加到原始筛选器。 

5 将新查询附加到新筛选器。 

重置筛选器 

可以应用一个筛选器 , 然后重新排列数据 , 最后按照服务器上的定义返回到当前筛选器。 

例如 , 假定从 Filter ( 筛选器 ) 下拉列表框中选择筛选器。接着 , 您决定对 

数据执行其它功能 , 例如以新的方式对数据排序、显示其它列数据或应用新查询。筛选 

器名称的前面将出现一个星号 (*), 指示原始筛选器选项已被更改。弄清楚想 

要了解的有关重新排列数据的情况之后 , 可以使用 Reset Current Filter ( 重置当前筛选 

器 ) 命令将当前筛选器还原为其原始定义。 

要重置筛选器 , 请执行以下一项操作 : 

■ 

在上部窗格中右键单击一个列标题 , 然后从上下文菜单中选择 Reset Current Settings 

( 重置当前设置 )。 

■ 

从相应菜单或上下文菜单中选择 Filters ( 筛选器 ) > Reset Current Settings ( 重置 

当前设置 )。 

删除筛选器 

可以删除不再使用的筛选器。 

删除筛选器 : 


■ 


■ 



2 在 Filters ( 筛选器 ) 列表中选择要删除的筛选器。 


显示一个消息框 , 请求您确认删除操作。 


5 单击 Close ( 关闭 )。 

为查询和筛选器设置访问权限 

可以为公用查询和筛选器设置访问权限。有关详细信息 , 请参阅 StarTeam 管理员指南。 


了解字段 

了解字段 

以下各节介绍可以在上部窗格中显示为列或在查询中使用的常用字段和高级字段 , 还介 

绍可与这些字段一起使用以定义条件的关系运算符。要在 Show Fields ( 显示字段 ) 、 

Sort and Group ( 排序和分组 ) 或 Query ( 查询 ) 对话框中查看高级字段 , 必须选中 

Show Advanced Fields ( 显示高级字段 ) 复选框。 

以下各节介绍的字段说明包括字段的内部标识符。在报告模板中 , 必须使用内部标识 

符 , 而不是 StarTeam 字段名。大多数内部标识符不包含空格。但是 , 有的确实包含空 

格。内部标识符是区分大小写的。 

关系运算符 

可用于在查询中定义条件的关系运算符因字段类型而异。 

在文本字段中使用的文本运算符有 : 

■ 

Equals 

■ 

Is Not 

■ 

Contains ( 忽略大小写 ) 

■ 

Contains ( 区分大小写 ) 

■ 

Starts with ( 忽略大小写 ) 

■ 

Starts with ( 区分大小写 ) 

■ 

Ends with ( 忽略大小写 ) 

■ 

Ends with ( 区分大小写 ) 

在布尔型、枚举型和数值型字段中使用的关系运算符有 : 

■ 

Less Than 

■ 

Same or Less 

■ 

Equals 

■ 

Same or Greater 

■ 

Greater Than 

■ 

Is Not 

在日期 / 时间型字段中使用的日期 / 时间运算符有 : 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

Before 

On or Before 

On 

On or After 

After 

Not On 

Before Date 

On or Before Date 

On Date 

On or After Date 

After Date 

Last (?) Days 

Last (?) Weeks 


了解字段 

■ 

■ 

Older Than (?) Days 

Older Than (?) Weeks 

Before、On or Before、On、On or After、After 和 Not On 运算符与日期 / 时间型字段 

的日期和时间部分都进行比较。Before Date、On or Before Date、On Date、On or After 

Date 和 After Date 运算符只比较日期 / 时间型字段的日期部分。 

Last (?) Days 和 Last (?) Weeks 运算符匹配从指定天数或周数之前那一日期开始的所 

有日期。 Older Than (?) Days/Weeks 运算符匹配指定天数或周数之前那一日期及更早 

的所有日期。 

注在日期型字段中 , StarTeam 将空白视为零。这意味着 “ 无日期 ” 早于任一具体日期。 

例如 , 如果编写一个用于搜索在某一具体日期之前结束的更改请求的查询 , 则 Closed 

On( 完结时间 ) 字段中无日期的所有更改请求都将包括在结果中 - 即使它们尚未结束。 

很容易去除此类查询中 Closed On( 完结时间 ) 字段含有空白的更改请求。您只需将 

用于搜索在具体日期当日或之前完结的更改请求的条件与用于搜索在零日期之后完 

结的更改请求的另一条件执行 AND 操作。 

以下各节列出与特殊类型的项关联的字段。使用这些字段可 : 

■ 

■ 

将任意数量的这些字段显示为上部窗格中的列标题。有关详细信息 , 请参阅第 67 页 

的 “ 控制列 ”。 

对上部窗格中的行进行排序和分组。有关详细信息 , 请参阅第 68 页的 “ 对数据排序 

和分组 ”。 

■ 

创建查询。有关详细信息 , 请参阅第 70 页的 “ 使用查询 ”。 

■ 

修改默认报告以满足自身需要。有关详细信息 , 请参阅第 286 页。 

请记住 , 不同类型的项的字段 ( 例如 , 字段与更改请求 ) 可具有相同的名称 , 但用法可 

能不同。 

文件字段 

本节将按字母顺序列出所有文件字段。 

■ 

Archive Format ( 存档格式 )( 高级 ) 

值 :Native-I、 Native-II 

内部标识符 :ArchiveFormat 

指示文件修订以 Native-I 格式还是 Native-II 格式存储。 

■ 

Archive Path ( 存档路径 ) 

值 : 文本 

内部标识符 :ArchivePath 

含有文件的 PVCS 存档或 VSS 项目的路径。 

■ 

Archive Name ( 存档名 )( 高级 ) 

值 : 用于代表文件的 MD5 值的 32 位十六进制字符串 

内部标识符 :StArchiveName 

对于以 Native-II 储存仓存储的文件 , 表示用于存储最新修订的文件的名称。此名称为 

该文件修订的内容的 MD5 值 , 已转换为 32 位的十六进制字符串。 

■ 

Archive Type ( 存档类型 ) 

值 :Native、 PVCS、 VSS 

内部标识符 :Type 

指示文件存储为 StarTeam (Native)、 PVCS 还是 VSS 文件。 


了解字段 

■ 

Branch On Change ( 更改时分支 )( 高级 ) 

值 :No ( 否 )、 Yes ( 是 ) 

内部标识符 :BranchOnChange 

指示文件在更改时是否分支。 

如果文件的行为未设置为 “Branch On Change”( 更改时分支 ), 则值为 No( 否 )。 

其原因可能是 : 

■ 

文件位于根或参考视图中 , 且 “Branch On Change”( 更改时分支 ) 功能已禁用。 

■ 

文件位于分支视图中 , 但是本身即是更改产生的分支 , 从而导致 “Branch On 

Change”( 更改时分支 ) 功能变为禁用。 

■ 

文件位于分支视图中 , 但是其行为当前不允许其在更改时进行分支。这意味着修改 

被签入到父视图中。 

注如果该值为 No ( 否 ), Branch State ( 分支状态 ) 的值将对其加以说明。 

值 Yes( 是 ) 表示文件位于分支视图中且其行为已设置为 “Branch On Change”( 更 

改时分支 ), 但是尚未发生更改。 

■ 

Branch State ( 分支状态 )( 高级 ) 

值 :Branched ( 已分支 )、 Not Branched ( 未分支 )、 Root ( 根 ) 

内部标识符 :BranchState 

指示文件是已在子视图中分支、尚未分支 ( 因此是父视图的组成部分 ) 还是创建于其 

所在视图内。 

值 Branched ( 已分支 ) 和 Not Branched ( 未分支 ) 适用于分支视图中的文件。值 

Root ( 根 ) 则适用于在该文件当前所在的视图中创建的文件。 

如果视图为参考视图 , 它将在该参考视图的父项中反映文件的状态。 

■ 

Comment ( 注释 ) 

值 : 文本 

内部标识符 :Comment 

作为更改文件属性或内容的原因提供的初始 2000 个字符存储在 Short Comment( 简 

短注释 ) 字段中。本字段 (Comment ( 注释 ) 字段 ) 存储这 2000 个字符及任何附 

加的文本。更改文件的属性将导致 StarTeam 创建新修订。 

■ 

CommentID ( 注释 ID)( 高级 ) 

值 : 数字 

内部标识符 :CommentID 

分配给修订注释的 ID 号。如果未提供修订注释则显示 -1。 

■ 

Compression Level ( 压缩级别 ) 

值 :Default ( 默认 )、 Maximize Compression ( 使压缩达到最大程度 )、 Maximize 

Speed ( 使速度达到最大 )、 None ( 无 ) 

内部标识符 :Compression 

指示文件的压缩级别。 

■ 

Default ( 默认 ):Maximize Compression ( 使压缩达到最大程度 ) 和 Maximize 

Speed ( 使速度达到最大 ) 之间的折衷设置 

■ 

■ 

■ 

Maximize Compression ( 使压缩达到最大程度 ): 为节省服务器空间对文件修订 

进行的最紧密的压缩 

Maximize Speed ( 使速度达到最大 ): 为改善服务器性能对文件修订进行的最快 

的压缩 

None ( 无 ): 不进行压缩 


了解字段 

■ 

Configuration Time ( 配置时间 ) 

值 : 日期 / 时间 

内部标识符 :ConfigurationTime 

指示将文件配置为什么时间。如果将文件配置为某个具体时间 , 则此字段包含该时 

间。如果将文件配置为标签或提升状态 , 则此字段显示该标签的创建时间或者与该提 

升状态关联的标签的创建时间。 

■ 

Content Revision ( 内容修订 ) 

值 : 数字 

内部标识符 :ContentVersion 

文件已被签入的次数。如果文件在子视图中 , 此编号中包括父视图的所有内容修订。 

每个修订都出现在文件的历史中。 

■ 

Created By ( 创建者 ) 

值 : 用户列表、 (< 无 >) 

内部标识符 :CreatedUserID 

创建视图中第一个修订的用户的名称。该用户是将文件添加到项目中的用户或签入分 

支修订的用户。 

■ 

Created Time ( 创建时间 ) 


内部标识符 :CreatedTime 

创建视图中第一个修订的时间。 

■ 

Deleted By ( 删除者 ) 

值 : 用户列表、 (< 无 >) 

内部标识符 :DeletedUserID 

删除文件的用户的名称。因为删除的文件不出现在列表中 , 此信息对用户不可用。 

■ 

Deleted Time ( 删除时间 ) 


内部标识符 :DeletedTime 

删除文件的时间。因为删除的文件不出现在列表中 , 此信息对用户不可用。 

■ 

Description ( 说明 ) 

值 : 文本 

内部标识符 :Description 

将文件添加到视图时为文件提供的说明 , 包括之后对其进行的所有编辑。 

■ 

Dot Notation ( 点标记 ) 

值 : 文本 

内部标识符 :DotNotation 

分支修订号 , 例如 , 1.2.1.0。 


了解字段 

■ 

Dot Notation ID ( 点标记 ID)( 高级 ) 

值 : 数字 

内部标识符 :DotNotationID 

分配给特定分支修订号的 ID。例如 , 如果文件是被添加到当前视图 ( 与由当前视图 

继承相反 ), 其分支修订号为 1.x 且其分支修订 ID 为 0。如果文件是从当前视图分支 

得来 , 其分支修订 ID 取决于父视图中的修订号和已经在当前视图中分配的 ID 数。例 

如 , 如果某文件分支时它在父视图中的修订号为 1.7, 且具有同一父修订号的另一文 

件的 “ 分支修订 ID” 被指定为 6, 则此文件的 “ 分支修订 ID” 也将被指定为 6。 

■ 

End Modified Time ( 最终修改时间 )( 高级 ) 


内部标识符 :EndModifiedTime 

某修订不再是最新修订的日期和时间。尽管此字段可显示在上部窗格中 , 其值却始终 

为空白。这是因为 , 在任何指定的配置时间 , 该项仍然是最新修订。 

■ 

EOL Character (EOL 字符 ) 

值 :ANSI 字符的数值表示 

内部标识符 :EOL 

仅供内部使用。此字段主要用于确定在使用 Native-1 储存仓进行增量存储时文件内 

断行要使用的 ANSI 字符。 

■ 

Executable ( 可执行 ) 

值 :No ( 否 )、 Yes ( 是 ) 

内部标识符 :Executable 

指示是否应该设置 UNIX 文件的可执行位。 

■ 

Extension ( 扩展名 ) 

值 : 文本 

内部标识符 :Extension 

显示文件的扩展名。 

■ 

File Time Stamp at Check-In ( 文件签入时的时间戳 ) 


内部标识符 :Modified 

文件上次签入时的时间戳。 

■ 

File Type ( 文件类型 ) 

值 :ASCII、 Binary ( 二进制 )、 Unicode 

内部标识符 :Charset 

指示文件是 ASCII ( 文本 )、二进制还是 Unicode。 

■ 

Flag ( 标志 ) 

值 :No ( 否 )、 Yes ( 是 ) 

内部标识符 :Flag 

专门为工作站上部窗格中的文件加标记 / 书签的一个标志。 


了解字段 

■ 

Flag User List ( 标志用户列表 )( 高级 ) 

值 : 字节数组 ; 显示为外加括号的一系列十六进制格式的数字。例如 , [14 00 00 00] 

表示一个特定用户。 

内部标识符 :FlagUserList 

不能在查询中使用。标识已在给定项上设置标志的用户。 

■ 

Folder ( 文件夹 ) 

值 : 文本 

内部标识符 :Folder 

某一文件所关联的 StarTeam 文件夹的名称。此字段不是工作文件夹的名称。 

■ 

Folder Path ( 文件夹路径 ) 

值 : 文本 

内部标识符 :Folder Path ( 包括空格 ) 

某一文件所关联的 StarTeam 文件夹的路径。此字段不是工作文件夹的路径。 

■ 

Hive ID ( 配置单元 ID)( 高级 ) 

值 :StarTeam Server 分配的编号 

内部标识符 :HiveID 

对于以 Native-I 储存仓存储的文件 , 表示用于存储最新修订的配置单元的 ID 号。 

■ 

Locked By ( 锁定者 ) 

值 : 用户列表、 (< 无 >) 

内部标识符 :ExclusiveLocker 

独占锁定某一文件的用户的名称。 

■ 

MD5 Checksum (MD5 校验和 ) 

值 : 字节数组 ; 显示为外加括号的一系列十六进制格式的数字。例如 ,Windows 客户 

机可能会显示 [7B 05 71 BF 98 FA 40 0A D9 D7 6D 7A 25 89 12 67]。Cross-Platform 

客户机只显示有效的零 , 因此 05 和 0A 将变为只有 5 和 A。Cross-Platform 客户机将 

A–F 显示为 a–f。 

内部标识符 :MD5 

不能在查询中使用。最新修订的 MD5 校验和。 

■ 

Modified By ( 修改者 ) 

值 : 用户列表、 (< 无 >) 

内部标识符 :ModifiedUserID 

上次修改文件的用户的名称。 

■ 

Modified Time ( 修改时间 ) 


内部标识符 :ModifiedTime 

上次修改文件的时间。文件可能已被签入或其属性已被更改。此字段与工作文件无 

关。对于上次修改工作文件的时间 , 请使用 “ 本地时间戳 ”。 

■ 

My Lock ( 我的锁定 ) 

值 :Exclusively Locked By Me ( 由我独占锁定 ) 、 Non-exclusively Locked By Me 

( 由我非独占锁定 )、 Not Locked By Me ( 我不锁定 ) 

内部标识符 :My Lock ( 包括空格 ) 

指示当前用户是否锁定了文件 , 如果锁定 , 该锁定是否为独占锁定。 


了解字段 

■ 

Name ( 名称 ) 

值 : 文本 

内部标识符 :Name 

显示文件名。 

■ 

New Revision Comment ( 新修订注释 )( 高级 ) 

值 : 文本 

内部标识符 :New Revision Comment ( 包括空格 ) 

仅供内部使用。 StarTeam 客户机在项更新过程中使用此值。如果将该字段添加到上 

部窗格中 , 则其始终显示为空。 

■ 

Non-Exclusive Lockers ( 非独占锁定者 ) 

值 : 文本 

内部标识符 :NonExclusiveLockers 

已经非独占锁定文件的用户的名称。 

■ 

Object ID ( 对象 ID) 

值 : 数字 

内部标识符 :ID 

每个文件在添加到视图时都被分配一个对象 ID。它在子视图中分支时 , 将被分配另一 

个对象 ID。原始 ID 属于父视图中的文件。 

■ 

Parent Branch Revision ( 父分支修订 )( 高级 ) 

值 : 数字 

内部标识符 :ParentRevision 

文件分支之前分支修订号的最后一位数字。例如 , 如果此编号为 7, 则在文件分支时 

分支修订曾经是 1.7( 在文件历史中将显示为 1.7.1.0)。如果文件不是从父视图继承 , 

此编号为 -1。 

■ 

Parent ID ( 父 ID)( 高级 ) 

值 : 数字 

内部标识符 :ParentID 

某文件在父视图中的对象 ID。如果此视图没有父视图 , 则 Parent ID ( 父 ID) 为 -1。 

■ 

Parent Revision ( 父修订 )( 高级 ) 

值 : 数字 

内部标识符 :PathRevision 

文件分支时的修订号。例如 , 如果此编号为 8, 则此文件分支时它在父视图中的修订 

号为 8。历史应该在当前视图的第一个修订中显示修订 9。如果此文件不是从父视图 

继承 , 此编号为 0。 

■ 

Path ( 路径 ) 

值 : 文本 

内部标识符 :Path 

文件的工作文件夹的路径。 


了解字段 

■ 

Project ID ( 项目 ID)( 高级 ) 

值 : 数字 

内部标识符 :ProjectID 

分配给项目的 ID 号。在服务器配置内 , 按项目的创建顺序为它们分配 ID 号。第一个 

项目的 ID 为 0。 

■ 

PVCS Revision (PVCS 修订 ) 

值 : 文本 

内部标识符 :PVCSRev 

以 PVCS 点标记表示的文件修订号。 

■ 

Read Only ( 只读 )( 高级 ) 

值 :No ( 否 )、 Yes ( 是 ) 

内部标识符 :ReadOnly 

指示文件的配置是否为只读 ( 如同在视图的回滚配置中 ) 和 / 或其行为是否不允许其 

在修改时分支。切勿将只读配置 (StarTeam 问题 ) 与只读文件 ( 操作系统问题 ) 相 

混淆。只读文件无法编辑 , 也不能保存到磁盘。其配置为只读的文件则可以编辑和保 

存到磁盘 ; 它只是不能被签入。 

■ 

Revision ( 修订 ) 

值 : 数字 

内部标识符 :ViewVersion 

文件已被签入或者更改其属性的次数。如果文件在子视图中 , 此编号中包括父视图的 

所有修订。 

■ 

Revision Flags ( 修订标志 )( 高级 ) 

值 :0 

内部标识符 :RevisionFlags 

仅供内部使用。 

■ 

Revision on Disk ( 磁盘上的修订 ) 

值 : 数字 

内部标识符 :SyncPathVersion 

当前位于工作站上的工作文件夹中的修订的编号。如果文件的状态为 Missing ( 缺 

失 ), 则 StarTeam 不显示编号。 

■ 

Root Object ID ( 根对象 ID)( 高级 ) 

值 : 数字 

内部标识符 :RootObjectID 

文件的最早祖先的对象 ID。例如 , 如果文件不是从父视图继承得来 , 则根对象 ID 与 

其自身对象 ID 相同。如果文件继承自父视图 , 则根对象 ID 为 Parent ID ( 父 ID) 或 

者其父项的 Parent ID ( 父 ID)。 

■ 

Share State ( 共享状态 ) 

值 :DerivedShare ( 派生共享 )、 Not Shared ( 未共享 )、 Root Share ( 根共享 ) 

内部标识符 :ShareState 

指示此项是否共享。Not Shared( 未共享 ) 表示该项不共享。Root Share( 根共享 ) 

表示该项共享且为原始 ( 或根 ) 引用。 DerivedShare ( 派生共享 ) 表示该项共享 , 

但不是原始 ( 或根 ) 引用。 


了解字段 

■ 

Short Comment ( 简短注释 ) 

值 : 文本 

内部标识符 :ShortComment 

用于存储作为更改文件属性或内容的原因而提供的初始 2000 个字符。附加文本存储 

在 Comment ( 注释 ) 字段中。 

■ 

Size ( 大小 ) 

值 : 数字 

内部标识符 :FileSize 

最新修订的大小 ( 以字节为单位 )。 

■ 

Status ( 状态 ) 

值 :Current ( 当前 )、 Merge ( 合并 )、 Missing ( 缺失 )、 Modified ( 已修改 )、 

Not In View ( 不在视图中 )、 Out Of Date ( 过期 )、 Unknown ( 未知 ) 

内部标识符 :Status 

指示工作文件夹中的文件副本与储存库中的最新修订之间的关系。 

■ 

Storage Type ( 存储类型 )( 高级 ) 

值 :Delta ( 增量 )、 Full Versions ( 完整版 ) 

内部标识符 :StorageType 

对于仍然使用 Native-I 储存仓存储的文件 , 指示修订是以正向增量 (Delta( 增量 )) 

存储还是完整 (Full Versions ( 完整版 )) 存储。 

■ 

Sync Branch Version ( 同步分支版本 ) 

值 : 数字 

内部标识符 :SyncObjectVersion 

用于确定状态的一个字段。最新签出到工作文件夹的分支修订的最后一个编号。 

■ 

Sync Content Version ( 同步内容版本 ) 

值 : 数字 

内部标识符 :SyncContentVersion 

用于确定状态的一个字段。作为工作文件签出的修订或者高于该修订的一个编号 ( 如 

果文件需要合并 )。 

■ 

Sync Known ( 同步已知 ) 

值 :No ( 否 )、 Yes ( 是 ) 

内部标识符 :SyncKnown 

用于确定状态的一个字段。指示服务器是否知道工作文件与最新修订的关系。 

■ 

Sync Local Size ( 同步本地大小 ) 

值 : 数字 

内部标识符 :SyncSize 

用于确定状态的一个字段。工作文件的大小 ( 以字节为单位 )。 

■ 

Sync Local Time Stamp ( 同步本地时间戳 ) 


内部标识符 :SyncTime 

用于确定状态的一个字段。工作文件的时间戳。 


了解字段 

■ 

Sync MD5 ( 同步 MD5) 

值 : 字节数组 ; 显示为外加括号的一系列十六进制格式的数字。例如 ,Windows 客户 

机上显示的 [ED FA 08 46 78 15 A1 4E 90 35 1B 46 33 0B 06 9D]。 Cross-Platform 

客户机只显示有效的零 , 因此 08、0B 和 06 将变为只有 8、B 和 6。Cross-Platform 

客户机将 A–F 显示为 a–f。 

内部标识符 :SyncMD5 

不能在查询中使用。用于确定状态的一个字段。工作文件的 MD5 校验和。 

■ 

Sync On Path To Root ( 在根路径上同步 ) 

值 :No ( 否 )、 Yes ( 是 ) 

内部标识符 :SyncOnPathToRoot 

用于确定状态的一个字段。当工作文件不是基于最新修订时 , 此字段用于指示服务器 

是否知道二者之间的关系。此字段中的值为 Yes( 是 ) 表示工作文件需要合并或者已 

过期。值 No ( 否 ) 表示关系无法确定。 

■ 

Vault Branch Version ( 储存仓分支版本 )( 高级 ) 

值 : 数字 

内部标识符 :VaultVersion 

文件从当前视图已被签入的次数。 

■ 

Version ( 版本 )( 高级 ) 

值 : 数字 

内部标识符 :RevisionNumber 

分支修订号的最后一位数字。例如 , 如果分支修订号为 1.3.1.2, 则版本为 2。 

■ 

View ( 视图 ) 

值 : 视图列表、 (< 无 >) 

内部标识符 :ViewID 

项在其中最后分支的视图的名称。例如 , 如果文件继承自父视图 , 但是在子视图中分 

支 , 则对于在子视图中分支的修订和后续修订 , 子视图中此字段的值将从父视图名更 

改为子视图名。 

■ 

Working File Exists ( 工作文件存在 ) 

值 :No ( 否 )、 Yes ( 是 ) 

内部标识符 :LocalFileExists 

指示某文件的一个副本是否位于其工作文件夹中。 

■ 

Working File Size ( 工作文件大小 ) 

值 : 数字 

内部标识符 :LocalSize 

工作文件的大小。 

■ 

Working File Time Stamp ( 工作文件时间戳 ) 


内部标识符 :LocalTimestamp 

工作文件的时间戳。 


了解字段 

更改请求字段 

本节将按字母顺序列出所有更改请求字段。 

■ 

Addressed By ( 解决者 ) 

值 : 用户列表、 (< 无 >) 

内部标识符 :AddressedBy 

表示解决更改请求的用户 ( 解决状态包括 Cannot Reproduce ( 无法再现 ) 、 As 

Designed( 按设计 )、Fixed( 已修复 )、Documented( 已制作文档 ) 和 Is Duplicate 

( 重复 ))。 

■ 

Addressed In ( 解决请求的内部版本 ) 

值 : 视图标签列表、 (< 无 >) 

内部标识符 :AddressedIn 

表示出现某更改请求的解决方案后 , 创建并应用于视图的下一个内部版本标签。 

■ 

Addressed In View ( 解决请求的视图 ) 

值 : 视图列表、 (< 无 >) 

内部标识符 :AddressedInView 

表示在其中解决更改请求的视图。此字段对于已共享且可能已移动的更改请求非常 

重要。 

■ 

Attachment Count ( 附件计数 ) 

值 : 数字 

内部标识符 :AttachmentCount 

附加到更改请求的文件数。 

■ 

Attachment IDs ( 附件 ID)( 高级 ) 

值 : 字节数组 ; 显示为外加括号的一系列十六进制格式的数字。例如 , [00 00 00 00 

02 00 00 00] 表示两个特定附件。 

内部标识符 :AttachmentIDs 

不能在查询中使用。分配给附件的 ID 号。例如 , 项目中的第一个附件为 00 00 00 00。 

■ 

Attachment Names ( 附件名 ) 

值 : 含有由空格分隔的一系列文件名的文本 

内部标识符 :AttachmentNames 

附加到更改请求的文件的名称。 

■ 

Branch On Change ( 更改时分支 )( 高级 ) 

值 :No ( 否 )、 Yes ( 是 ) 

内部标识符 :BranchOnChange 

指示更改请求在更改时是否分支。 

如果更改请求的行为未设置为 “Branch On Change”( 更改时分支 ) , 则值为 No 

( 否 )。其原因可能是 : 

■ 

■ 

■ 

更改请求位于根或参考视图中 , 且 “Branch On Change”( 更改时分支 ) 功能已 

禁用。 

更改请求位于分支视图中 , 但是本身即更改产生的分支 , 从而导致 “Branch On 

Change”( 更改时分支 ) 功能变为禁用。 

更改请求位于分支视图中 , 但是其行为当前不允许其在更改时进行分支。这意味着 

修改被签入到父视图中。 


了解字段 

注如果该值为 No ( 否 ), Branch State ( 分支状态 ) 的值将对其加以说明。 

值 Yes( 是 ) 表示更改请求位于分支视图中且其行为已设置为 “Branch On Change” 

( 更改时分支 ), 但是尚未发生更改。 

■ 

Branch State ( 分支状态 )( 高级 ) 

值 :Branched ( 已分支 )、 Not Branched ( 未分支 )、 Root ( 根 ) 

内部标识符 :BranchState 

指示更改请求是已在子视图中分支、尚未分支 ( 因此是父视图的组成部分 ) 还是创建 

于其所在视图内。 

值 Branched ( 已分支 ) 和 Not Branched ( 未分支 ) 适用于分支视图中的更改请求。 

值 Root ( 根 ) 则适用于在该更改请求当前所在的视图中创建的文件。 

如果视图为参考视图 , 它将在该参考视图的父项中反映更改请求的状态。 

■ 

Category ( 类别 ) 

值 : 文本 

内部标识符 :Category 

用于确定出现缺陷的子组件的文本。它通常与 Component ( 组件 ) 字段一起使用。 

■ 

Closed On ( 完结时间 ) 


内部标识符 :ClosedOn 

更改请求完结的日期和时间。 

■ 


值 : 文本 


作为更改某更改请求属性的原因提供的初始 2000 个字符存储在 Short Comment( 简 

短注释 ) 字段中。Comment( 注释 ) 字段存储这 2000 个字符及任何附加的文本。更 

改更改请求的属性将导致 StarTeam 创建新修订。 

■ 


值 : 数字 



■ 

Component ( 组件 ) 

值 : 文本 

内部标识符 :Component 

用于确定出现缺陷的组件的文本。它通常与 Category ( 类别 ) 字段一同使用以将标 

识缩小到子组件范围。 

■ 




指示将更改请求配置为的时间。如果将更改请求配置为某个具体时间 , 则此字段包含 

该时间。如果将更改请求配置为标签或提升状态 , 则此字段显示该标签的创建时间或 

者与该提升状态关联的标签的创建时间。 


了解字段 

■ 

CR Number (CR 号 ) 

值 : 数字 

内部标识符 :ChangeNumber 

分配给某更改请求的编号。例如 , 如果 Object ID ( 对象 ID) 为 0, 则该更改请求号 

为 1。 

■ 

Created By ( 创建者 )( 高级 ) 

值 : 用户列表、 (< 无 >) 


创建视图中第一个修订的用户的名称。这是发起更改请求的用户或修改分支修订的 

用户。 

■ 

Created Time ( 创建时间 )( 高级 ) 




■ 


值 : 用户列表、 (< 无 >) 


删除更改请求的用户的名称。因为删除的更改请求不出现在列表中 , 此信息对用户不 

可用。 

■ 




删除更改请求的时间。因为删除的更改请求不出现在列表中 , 此信息对用户不可用。 

■ 


值 : 文本 


Description ( 说明 ) 字段中的文本。 

■ 


值 : 文本 


分支修订号 , 例如 , 1.2.1.0。 

■ 

Dot Notation ID ( 点标记 ID)( 高级 ) 

值 : 数字 

内部标识符 :DotNotationID 

分配给特定分支修订号的 ID。例如 , 如果更改请求是被添加到当前视图 ( 与由当前 

视图继承相反 ), 其分支修订号为 1.x 且其分支修订 ID 为 0。如果更改请求是从当前 

视图分支得来 , 其分支修订 ID 取决于父视图中的修订号和已经在当前视图中分配的 

ID 数。例如 , 如果某更改请求分支时它在父视图中的修订号为 1.7, 且具有同一父修 

订号的另一更改请求的 “ 分支修订 ID” 被指定为 6, 则此更改请求的 “ 分支修订 ID” 

也将被指定为 6。 


了解字段 

■ 






■ 

Entered By ( 输入者 ) 

值 : 用户列表、 (< 无 >) 

内部标识符 :EnteredBy 

创建此更改请求的用户的名称。 

■ 

Entered On ( 输入时间 ) 


内部标识符 :EnteredOn 

创建此更改请求的时间。 

■ 

External Reference ( 外部引用 ) 

值 : 文本 

内部标识符 :ExternalReference 

文本 , 通常用于表示为此更改请求提供数据的客户或其它外部源。 

■ 

Fix ( 修复 ) 

值 : 文本 

内部标识符 :Fix 

Fix ( 修复 ) 字段中的文本。 

■ 


值 :No ( 否 )、 Yes ( 是 ) 


专门为工作站上部窗格中的更改请求加标记 / 书签的一个标志。 

■ 






■ 


值 : 文本 


存储更改请求的 StarTeam 文件夹的名称。 

■ 


值 : 文本 


存储更改请求的 StarTeam 文件夹的路径。 


了解字段 

■ 

Last Build Tested ( 最后测试的内部版本 ) 

值 : 视图标签列表、 (< 无 >) 

内部标识符 :LastBuildTested 

用户选择的内部版本标签 , 代表在其中测试更改请求的最后一个内部版本。 

■ 


值 : 用户列表、 (< 无 >) 


独占锁定某一更改请求的用户的名称。 

■ 


值 : 用户列表、 (< 无 >) 


上次修改更改请求的用户的名称。 

■ 




上次修改更改请求的时间。 

■ 





指示当前用户是否锁定了更改请求 , 如果锁定 , 该锁定是否为独占锁定。 

■ 


值 : 文本 




■ 


值 : 文本 


已经非独占锁定更改请求的用户的名称。 

■ 


值 : 数字 


每个更改请求在添加到视图时都被分配一个对象 ID。它在子视图中分支时 , 将被分配 

另一个对象 ID。原始 ID 属于父视图中的更改请求。 

■ 

Parent Branch Revision ( 父分支修订 )( 高级 ) 

值 : 数字 

内部标识符 :ParentRevision 

更改请求分支之前分支修订号的最后一位数字。例如 , 如果此编号为 7, 则在更改请 

求分支时分支修订曾经是 1.7 ( 在更改请求的历史中将显示为 1.7.1.0)。如果更改请 

求不是从父视图继承 , 此编号为 -1。 


了解字段 

■ 

Parent ID ( 父 ID)( 高级 ) 

值 : 数字 

内部标识符 :ParentObjectID 

某更改请求在父视图中的对象 ID。如果此视图没有父视图 , 则 Parent ID( 父 ID) 为 -1。 

■ 

Parent Revision ( 父修订 )( 高级 ) 

值 : 数字 

内部标识符 :PathRevision 

更改请求分支时的修订号。例如 , 如果此编号为 8, 则此更改请求分支时它在父视图 

中的修订号为 8。历史应该在当前视图的第一个修订中显示修订 9。如果此更改请求 

不是从父视图继承 , 此编号为 0。 

■ 

Platform ( 平台 ) 

值 :All( 所有 )、 MacOS、 Other ( 其它 )、Unix、 Windows 2000、 Windows 95、 

Windows 98、 Windows NT、 Windows XP 

内部标识符 :Platform 

Platform ( 平台 ) 字段的值。 

■ 

Priority ( 优先级 ) 

值 :No ( 否 )、 Yes ( 是 ) 

内部标识符 :Priority 

Priority ( 优先级 ) 字段的值。许多人使用储存库自定义来扩展此字段以加入其它值 , 

因为 “ 布尔型 ” 的值在 StarTeam 中被视为枚举型。例如 ,No( 否 ) 为 0,Yes( 是 ) 

为 1。管理员可以将 No ( 否 ) 更改为 Not A Priority ( 无优先级 )、 Yes ( 是 ) 更改 

为 Priority 1 ( 优先级 1), 并添加优先级 2 到优先级 10。 

■ 


值 :No ( 否 )、 Yes ( 是 ) 


指示更改请求的配置是否为只读 ( 如同在视图的回滚配置中 ) 和 / 或其行为是否不允 

许其在修改时分支。 

■ 

Read Status ( 读状态 ) 

值 :Read ( 已读 )、 Unread ( 未读 ) 

内部标识符 :Read Status ( 包括空格 ) 

指示将更改请求视为已读还是未读。 

■ 

Read Status User List ( 读状态用户列表 ) 



内部标识符 :ReadStatusUserList 

不能在查询中使用。标识对于他而言给定项的状态为 “unread”( 未读 ) 的用户。 

■ 

Resolved On ( 解决时间 ) 


内部标识符 :ResolvedOn 

解决更改请求的时间。解决方案可以是 :Cannot Reproduce ( 无法再现 ) 、 As 

Designed( 按设计 )、Fixed( 已修复 )、Documented( 已制作文档 ) 或 Is Duplicate 

( 重复 )。 


了解字段 

■ 

Responsibility ( 责任 ) 

值 : 用户列表、 (< 无 >) 

内部标识符 :Responsibility 

当前负责某一更改请求的用户的名称。 

■ 


值 :0 



■ 

Root Object ID ( 根对象 ID)( 高级 ) 

值 : 数字 

内部标识符 :RootObjectID 

某更改请求的最早祖先的对象 ID。例如 , 如果更改请求不是从父视图继承得来 , 则根 

对象 ID 与其自身对象 ID 相同。如果更改请求继承自父视图 , 则根对象 ID 为 Parent 

ID ( 父 ID) 或者其父项的 Parent ID ( 父 ID)。 

■ 

Severity ( 严重性 ) 

值 :High ( 高 )、 Low ( 低 )、 Medium ( 中 ) 

内部标识符 :Severity 

Severity ( 严重性 ) 字段的值。 

■ 







■ 


值 : 文本 


用于存储作为更改更改请求属性的原因而提供的初始 2000 个字符。附加文本存储在 

Comment ( 注释 ) 字段中。 

■ 


值 :New ( 新建 )、 Open ( 未决 )、 In Progress ( 进行中 )、 Deferred ( 延期 )、 

Cannot Reproduce ( 无法再现 ) 、 As Designed ( 按设计 ) 、 Fixed ( 已修复 ) 、 

Documented ( 已制作文档 )、 Is Duplicate ( 重复 )、 Verified Deferred ( 已核实延 

期 )、Verified Cannot Reproduce( 已核实无法再现 )、Verified As Designed( 已核 

实按设计 )、Verified Fixed( 已核实已修复 )、Verified Documented( 已核实已制作 

文档 )、 Verified Is Duplicate ( 已核实重复 )、 Closed Deferred ( 已完结延期 )、 

Closed Cannot Reproduce( 已完结无法再现 )、 Closed As Designed( 已完结按设 

计 )、Closed Fixed( 已完结已修复 )、Closed Documented( 已完结已制作文档 )、 

Closed Is Duplicate ( 已完结重复 ) 


Status ( 状态 ) 字段的值。 


了解字段 

■ 

Synopsis ( 概要 ) 

值 : 文本 

内部标识符 :Synopsis 

Synopsis ( 概要 ) 字段中的文本。 

■ 

Test Command ( 测试命令 ) 

值 : 文本 

内部标识符 :TestCommand 

Test Command ( 测试命令 ) 字段中的文本。 

■ 

Type ( 类型 ) 

值 :Defect ( 缺陷 )、 Suggestion ( 建议 ) 


Type ( 类型 ) 字段的值。 

■ 

Verified On ( 验证时间 ) 


内部标识符 :VerifiedOn 

核实更改请求的时间。解决方案可以是 Verified Cannot Reproduce ( 已核实无法再 

现 )、 Verified As Designed ( 已核实按设计 )、 Verified Fixed ( 已核实已修复 )、 

Verified Documented( 已核实已制作文档 ) 或 Verified Is Duplicate( 已核实重复 )。 

■ 


值 : 数字 


分支修订号的最后一位数字。例如 , 如果分支修订号为 1.3.1.2, 则版本为 2。 

■ 


值 : 视图列表、 (< 无 >) 


项在其中最后分支的视图的名称。例如 , 如果更改请求继承自父视图 , 但是在子视图 

中分支 , 则对于在子视图中分支的修订和后续修订 , 子视图中此字段的值将从父视图 

名更改为子视图名。 

■ 

Work Around ( 解决方法 ) 

值 : 文本 

内部标识符 :WorkAround 

Work Around ( 解决方法 ) 字段中的文本。 

需求字段 

本节将按字母顺序列出所有需求字段。 

■ 

Am I Responsible? ( 是否由我负责 ?) 

值 :No ( 否 )、 Yes ( 是 ) 

内部标识符 :AmIResponsible 

指示登录的用户是否负责某个需求。 


了解字段 

■ 

Ambiguities Found ( 发现歧义 ) 

值 : 数字 

内部标识符 :AmbiguitiesFound 

表示在该需求中发现的歧义数。 

■ 


值 : 数字 


附加到需求的文件数。 

■ 



02 00 00 00] 表示两个特定附件。 



■ 




附加到需求的文件的名称。 

■ 

Children Count ( 子项计数 ) 

值 : 数字 

内部标识符 :Children Count ( 包括空格 ) 

作为此需求子项的响应的数量。 

■ 

ChildType ( 子类型 ) 

值 :Child Requirement ( 子需求 )、 Requirement ( 需求 ) 

内部标识符 :ChildType 

指示该需求是某需求树的根还是另一需求的子项。 

■ 


值 : 文本 


作为更改某需求属性的原因提供的初始 2000 个字符存储在 Short Comment( 简短注 

释 ) 字段中。本字段 (Comment ( 注释 ) 字段 ) 存储这 2000 个字符及任何附加的 

文本。更改需求的属性将导致 StarTeam 创建新修订。 

■ 


值 : 数字 



■ 

Comments ( 注解 ) 

值 : 文本 

内部标识符 :Comments 

对由于在原始说明中发现歧义或其它原因而创建的修订说明提供注释。 


了解字段 

■ 




指示将需求配置为的时间。如果将需求配置为某个具体时间 , 则此字段包含该时间。 

如果将需求配置为标签或提升状态 , 则此字段显示该标签的创建时间或者与该提升状 

态关联的标签的创建时间。 

■ 


值 : 用户列表、 (< 无 >) 


创建视图中第一个修订的用户的名称。这是发起该需求的用户。 

■ 





■ 


值 : 用户列表、 (< 无 >) 


删除需求的用户的名称。因为删除的项不出现在列表中 , 此信息对用户不可用。 

■ 




删除需求的时间。因为删除的项不出现在列表中 , 此信息对用户不可用。 

■ 


值 : 文本 


Description ( 说明 ) 字段中的文本。 

■ 

Disabled ( 已禁用 ) 

值 :No ( 否 )、 Yes ( 是 ) 

内部标识符 :Disabled 

指示需求是否已禁用。 

■ 


值 : 文本 


分支修订号 , 例如 , 1.2。 

■ 







了解字段 

■ 

Expected Effort ( 预期工作量 ) 

值 : 数字 

内部标识符 :ExpectedEffort 

表示对于完全实现该需求所需时间的预期估计。如果是从 CaliberRM 导入需求 , 事先 

将会用基于特定单位 ( 如小时或天 ) 的数据填充这些字段。否则可任意设置单位 , 但 

应与 Low Effort ( 低工作量 ) 和 High Effort ( 高工作量 ) 字段中的单位相同 , 且对于 

所有需求应该保持一致。 

■ 

External Reference ( 外部引用 ) 

值 : 文本 

内部标识符 :ExternalReference 

通常提供请求此需求的外部客户的名称。 

■ 


值 :No ( 否 )、 Yes ( 是 ) 


专门为工作站上部窗格中的需求加标记 / 书签的一个标志。 

■ 






■ 


值 : 文本 


存储需求的 StarTeam 文件夹的路径。 

■ 

High Effort ( 高工作量 ) 

值 : 数字 

内部标识符 :HighEffort 

表示对于完全实现该需求所需时间的最差估计。如果是从 CaliberRM 导入需求 , 事先 


应与 Low Effort ( 低工作量 ) 和 Expected Effort ( 预期工作量 ) 字段中的单位相同 , 

且对于所有需求应该保持一致。 

■ 


值 : 用户列表、 (< 无 >) 


独占锁定某一需求的用户的名称。 

■ 

Low Effort ( 低工作量 ) 

值 : 数字 

内部标识符 :LowEffort 

表示对于完全实现该需求所需时间的最佳估计。如果是从 CaliberRM 导入需求 , 事先 


应与 Expected Effort( 预期工作量 ) 和 High Effort( 高工作量 ) 字段中的单位相同 , 

且对于所有需求应该保持一致。 


了解字段 

■ 


值 : 用户列表、 (< 无 >) 


上次修改需求的用户的名称。 

■ 




上次修改需求的时间。 

■ 





指示当前用户是否锁定了需求 , 如果锁定 , 该锁定是否为独占锁定。 

■ 

Name ( 名称 ) 

值 : 文本 

内部标识符 :Name 

需求的名称。 

■ 


值 : 文本 




■ 


值 : 文本 


已经非独占锁定需求的用户的名称。 

■ 

Notes ( 说明 ) 

值 : 文本 

内部标识符 :Notes 

有关此需求的工作量级别的文本注释。 

■ 

Number ( 编号 ) 

■ 

值 : 数字 

内部标识符 :RequirementNumber 

用于标识需求的编号。例如 , 如果 Object ID ( 对象 ID) 为 0, 则需求号为 1。 


值 : 数字 


每个需求在添加到视图时都被分配一个对象 ID。 


了解字段 

■ 

Owner ( 所有者 ) 

值 : 用户列表、 (< 无 >) 

内部标识符 :Owner 

指示最终负责此需求的人员。 StarTeam 在内部确定所有权时并不使用此字段 , 而是 

使用 Created By ( 创建者 ) 字段。 

■ 

Parent Requirement ID ( 父需求 ID)( 高级 ) 

值 : 数字 

内部标识符 :ParentRequirementID 

某需求在父视图中的对象 ID。如果此视图没有父视图 , 则 Parent ID ( 父 ID) 为 -1。 

■ 


值 :Desirable( 期望 )、Essential( 必要 )、Unassigned( 取消分配 )、Useful( 有用 ) 


Priority( 优先级 ) 字段的值。可以使用储存库自定义更改这些值的名称或加入其它值。 

■ 


值 :No ( 否 )、 Yes ( 是 ) 


指示需求的配置是否为只读 ( 如同在视图的回滚配置中 )。 

■ 




指示将需求视为已读还是未读。 

■ 






■ 

Responsible Count ( 负责人计数 ) 

值 : 数字 

内部标识符 :ResponsibleCount 

负责某需求的用户数。 

■ 

Responsible IDs ( 负责人 ID) 



内部标识符 :ResponsibleIDs 

不能在查询中使用。分配给负责该需求的用户的 ID 号。 

■ 

Responsible Names ( 负责人名 ) 

值 : 含有由空格分隔的一系列用户名的文本 

内部标识符 :ResponsibleNames 

负责此需求的用户的名称。 


了解字段 

■ 

Reviewed By ( 审查者 ) 

值 : 字节数组 

内部标识符 :ReviewedByIDs 

不能在查询中使用。根本就不应该使用。 

■ 

Revised Description ( 修订说明 ) 

值 : 文本 

内部标识符 :RevisedDescription 

由于在原始说明中发现歧义或其它原因而提供一个新的修订说明。 

■ 


值 :0 



■ 







■ 


值 : 文本 


用于存储作为更改需求属性的原因而提供的初始 2000 个字符。附加文本存储在 


■ 


值 :Accepted( 已接受 )、Approved( 已批准 )、Complete( 完成 )、Deferred( 延 

期 )、 Draft ( 草稿 )、 Pending ( 待决 )、 ReadyForCCB (CCB 就绪 )、 Rejected 

( 已拒绝 )、 Review ( 审查 )、 Submitted ( 已提交 ) 


指示此需求的状态。 

■ 


值 :Business Requirement ( 业务需求 ) 、 Business Specification ( 业务规范 ) 、 

Hardware Requirement( 硬件需求 )、Hardware Specification( 硬件规范 )、Human 

Resources ( 人力资源 ) 、 Information Technology ( 信息技术 ) 、 Software 

Requirement ( 软件需求 )、 Software Specification ( 软件规范 ) 


指示需求类型。 

■ 


值 : 数字 


分支修订号的最后一位数字。例如 , 如果分支修订号为 1.2, 则版本为 2。 


了解字段 

任务字段 

本节将按字母顺序列出所有任务字段。 

■ 

Actual Finish ( 实际完成 ) 


内部标识符 :StTaskActualFinish 

任务的实际完成日期。 

■ 

Actual Hours ( 实际小时数 ) 

值 : 数字 

内部标识符 :StTaskActualHours 

完成任务所花费的小时数。 

■ 

Actual Start ( 实际开始 ) 


内部标识符 :StTaskActualStart 

任务的实际开始日期。 

■ 


值 : 数字 


附加到任务的文件数。 

■ 



02 00 00 00] 表示两个特定附件。 



■ 




附加到任务的文件的名称。 

■ 

Attention Notes ( 注意说明 ) 

值 : 文本 

内部标识符 :StTaskAttentionNotes 

“Needs Attention”( 需要注意 ) 说明中的文本。 

■ 


值 : 数字 


作为此任务子任务的响应的数量。 


了解字段 

■ 


值 : 文本 


作为更改某更改请求属性的原因提供的初始 2000 个字符存储在 Short Comment( 简 

短注释 ) 字段中。本字段 (Comment ( 注释 ) 字段 ) 存储这 2000 个字符及任何附 

加的文本。更改任务的属性将导致 StarTeam 创建新修订。 

■ 


值 : 数字 



■ 




指示将任务配置为的时间。如果将任务配置为某个具体时间 , 则此字段包含该时间。 

如果将任务配置为标签或提升状态 , 则此字段显示该标签的创建时间或者与该提升状 


■ 

Constraint Date ( 限制日期 ) 


内部标识符 :StTaskConstraintDate 

MS Project 中的任务限制日期。 

■ 

Constraint Type ( 限制类型 ) 

值 :As Late As Possible ( 尽可能晚 )、 As Soon As Possible ( 尽快 )、 Finish No 

Earlier Than ( 完成时间不得早于 )、 Finish No Later Than ( 完成时间不得晚于 )、 

Must Finish On( 必须完成时间 )、Must Start On( 必须开始时间 )、Start No Earlier 

Than ( 开始时间不得早于 )、 Start No Later Than ( 开始时间不得晚于 ) 

内部标识符 :StTaskConstraintType 

MS Project 中的任务限制类型。 

■ 


值 : 用户列表、 (< 无 >) 


创建视图中第一个修订的用户的名称。这是发起该任务的用户。 

■ 





■ 


值 : 用户列表、 (< 无 >) 


删除任务的用户的名称。因为删除的任务不出现在列表中 , 此信息对用户不可用。 


了解字段 

■ 




删除任务的时间。因为删除的任务不出现在列表中 , 此信息对用户不可用。 

■ 


值 : 文本 


分支修订号 , 例如 , 1.2。 

■ 






■ 

Estimated Finish ( 估计完成时间 ) 


内部标识符 :StTaskEstimatedFinish 

任务的估计完成日期。 

■ 

Estimated Finish Variance ( 估计完成时间差异 ) 


内部标识符 :StTaskEstimatedFinishVariance 

任务的估计完成日期与实际完成日期之间的差值。 

■ 

Estimated Hours ( 估计小时数 ) 

值 : 数字 

内部标识符 :StTaskEstimatedHours 

完成任务所花费的小时数。 

■ 

Estimated Hours Variance ( 估计小时数差异 ) 

值 : 数字 

内部标识符 :StTaskEstimatedHoursVariance 

完成任务所花费的估计小时数与实际小时数之间的差值。 

■ 

Estimated Start ( 估计开始 ) 


内部标识符 :StTaskEstimatedStart 

任务的估计开始日期。 

■ 

Estimated Start Variance ( 估计开始时间差异 ) 


内部标识符 :StTaskEstimatedStartVariance 

任务的估计开始日期与实际开始日期之间的差值。 


了解字段 

■ 


值 :No ( 否 )、 Yes ( 是 ) 


专门为工作站上部窗格中的任务加标记 / 书签的一个标志。 

■ 






■ 


值 : 文本 


存储任务的 StarTeam 文件夹的路径。 

■ 

Is My Task? ( 是我的任务吗 ?) 

值 :No ( 否 )、 Yes ( 是 ) 

内部标识符 :Is My Task? ( 包括空格 ) 

指示登录的用户是否负责某个任务。 

■ 

Is Replicated ( 是复制的 ) 

值 :No ( 否 )、 Yes ( 是 ) 

内部标识符 :Is Replicated ( 包括空格 ) 

指示该任务是否来自 MS Project 任务。 

■ 

Last MS Project Update ( 上次从 MS Project 更新 ) 


内部标识符 :StTaskMSProjectLastUpdate 

某任务上次从 MS Project 更新的日期。 

■ 

Last Work/Dependency Update ( 上次工作 / 依存关系更新 ) 


内部标识符 :StWorkDependencyLastUpdate 

上次添加、编辑或删除工作记录或依存关系 ( 后续任务或前置任务 ) 的时间。此字段 

与 MS Project 一同使用。 

■ 


值 : 用户列表、 (< 无 >) 


独占锁定某一任务的用户的名称。 

■ 

Milestone ( 里程碑 ) 

值 :No ( 否 )、 Yes ( 是 ) 

内部标识符 :StTaskMilestone 

指示某个任务是否代表里程碑。在 MS Project 中 , 将里程碑定义为时间长度为零的任 

务。它相当于已指定时间长度的一个或多个任务的首部。 

在 StarTeam 中 , 任务有里程碑复选框。为任务分配工作后 , 该任务即不再是里程碑。 


了解字段 

■ 


值 : 用户列表、 (< 无 >) 


上次修改任务的用户的名称。 

■ 




上次修改任务的时间。 

■ 

MS Project File Name (MS Project 文件名 )( 高级 ) 

值 : 文本 

内部标识符 :StTaskMSProjectFileName 

从其中导出任务的 MS Project 文件的名称。 

■ 

MS Task GUID (MS 任务 GUID)( 高级 ) 

值 : 文本 

内部标识符 :StTaskGUID 

MS Project 中某任务的 GUID。 

■ 

MS Task Unique ID (MS 任务的唯一 ID)( 高级 ) 

值 : 数字 

内部标识符 :StTaskUniqueID 

MS Project 中某任务的唯一 ID。 

■ 

MS WBS Code (MS WBS 代码 )( 高级 ) 

值 : 文本 

内部标识符 :StTaskWBSCode 

MS Project 中某任务的 WBS 代码 

■ 





指示当前用户是否锁定了任务 , 如果锁定 , 该锁定是否为独占锁定。 

■ 

Needs Attention ( 需要注意 ) 

值 :No ( 否 )、 Yes ( 是 ) 

内部标识符 :StTaskNeedsAttention 

指示 Needs Attention ( 需要注意 ) 复选框是否已选中。 

■ 


值 : 文本 





了解字段 

■ 


值 : 文本 


已经非独占锁定任务的用户的名称。 

■ 

Notes ( 说明 ) 

值 : 文本 

内部标识符 :StTaskNotes 

Needs Attention ( 需要注意 ) 字段附带的说明文本。 

■ 


值 : 数字 


每个任务在添加到视图时都被分配一个对象 ID。 

■ 

Parent Task ID ( 父任务 ID)( 高级 ) 

值 : 数字 

内部标识符 :StTaskParentID 

某任务在父视图中的对象 ID。如果此视图没有父视图 , 则 Parent ID ( 父 ID) 为 -1。 

■ 

Percentage Complete ( 完成百分比 ) 

值 : 数字 

内部标识符 :StTaskPercentComplete 

指示任务完成程度的百分比。 

■ 


值 :Do Not Level ( 不分级 )、 High ( 高 )、 Higher ( 较高 )、 Highest ( 最高 )、 

Low ( 低 )、 Lower ( 较低 )、 Lowest ( 最低 )、 Medium ( 中 )、 Very High ( 很 

高 )、 Very Low ( 很低 ) 

内部标识符 :StTaskPriority 

指示为任务指定的优先级。这些优先级与 MS Project 中的优先级相同。 

■ 


值 :No ( 否 )、 Yes ( 是 ) 


指示任务的配置是否为只读 ( 如同在视图的回滚配置中 )。 

■ 




指示将任务视为已读还是未读。 

■ 







了解字段 

■ 

Resource Count ( 资源计数 ) 

值 : 数字 

内部标识符 :StTaskResourceCount 

作为某任务的资源列出的用户的数量。 

■ 

Resource IDs ( 资源 ID)( 高级 ) 



内部标识符 :StTaskResourceIDs 

不能在查询中使用。分配给作为此任务的资源的用户的 ID 号。 

■ 

Resource Names ( 资源名 ) 


内部标识符 :StTaskResourceNames 

作为此任务的资源的用户的名称。 

■ 

Responsibility ( 责任 ) 

值 : 用户列表、 (< 无 >) 

内部标识符 :StTaskResponsibility 

当前负责该任务的用户的名称。 

■ 


值 :0 



■ 







■ 


值 : 文本 


用于存储作为更改任务属性的原因而提供的初始 2000 个字符。附加字符存储在 


■ 


值 :Closed ( 已完结 )、 Finish ( 完成 )、 Hold ( 保持 )、 In Progress ( 进行中 )、 

Pending ( 待决 )、 Ready To Start ( 准备启动 ) 

内部标识符 :StTaskStatus 

指示任务的状态。 


了解字段 

■ 

Task Duration ( 任务持续时间 ) 

值 : 数字 

内部标识符 :StTaskDuration 

所有用户参与处理某一任务共用的小时数。例如 , 将有两个人参与处理某一任务 , 各 

需 8 小时 , 如果同时工作则持续时间为 8 小时 , 如果选择不在同一天工作则持续时间 

最多为 16 小时。 

■ 

Task Name ( 任务名 ) 

值 : 文本 

内部标识符 :StTaskName 

任务的名称。 

■ 

Task Number ( 任务号 ) 

值 : 数字 

内部标识符 :StTaskNumber 

分配给任务的编号。例如 , 如果 Object ID ( 对象 ID) 为 0, 则任务号为 1。 

■ 

Task Origin ( 任务来源 ) 

值 :MSProject、 StarTeam 

内部标识符 :StTaskOrigin 

指示任务是在 StarTeam 中创建的还是从 Microsoft Project 导出到 StarTeam。 

■ 

Task Type ( 任务类型 ) 

值 :Fixed Duration ( 固定持续时间 )、 Fixed Units ( 固定单位 )、 Fixed Work ( 固 

定工作量 ) 

内部标识符 :StTaskType 

MS Project 中任务的类型。 

■ 


值 : 数字 



■ 

Work Record Count ( 工作记录计数 ) 

值 : 数字 

内部标识符 :WorkRecCount 

当前添加到某任务的工作记录数。 

主题字段 

本节将按字母顺序列出所有主题字段。 

■ 

Am I Recipient? ( 我是收件人吗 ?) 

值 :No ( 否 )、 Yes ( 是 ) 

内部标识符 :Am I Recipient? ( 包括空格 ) 

指示登录的用户是否为某个主题的收件人。 


了解字段 

■ 


值 : 数字 


附加到主题的文件数。 

■ 



02 00 00 00] 表示两个特定附件。 



■ 




附加到主题的文件的名称。 

■ 


值 : 数字 


作为此主题子项的响应的数量。 

■ 


值 : 文本 


作为更改主题属性的原因提供的初始 2000 个字符存储在 Short Comment ( 简短注 

释 ) 字段中。本字段 (Comment ( 注释 ) 字段 ) 存储这 2000 个字符及任何附加的 

文本。更改主题的属性将导致 StarTeam 创建新修订。 

■ 


值 : 数字 



■ 




指示将主题配置为的时间。如果将主题配置为某个具体时间 , 则此字段包含该时间。 

如果将主题配置为标签或提升状态 , 则此字段显示该标签的创建时间或者与该提升状 


■ 

Content ( 内容 ) 

值 : 文本 


主题的文本。 

■ 


值 : 用户列表、 (< 无 >) 


创建视图中第一个修订的用户的名称。这是发起该主题的用户。 


了解字段 

■ 





■ 


值 : 用户列表、 (< 无 >) 


删除主题的用户的名称。因为删除的项不出现在列表中 , 此信息对用户不可用。 

■ 




删除主题的时间。因为删除的项不出现在列表中 , 此信息对用户不可用。 

■ 


值 : 文本 


分支修订号 , 例如 , 1.2。 

■ 






■ 


值 :No ( 否 )、 Yes ( 是 ) 


专门为工作站上部窗格中的主题和 / 或响应加标记 / 书签的一个标志。 

■ 






■ 


值 : 文本 


存储主题的 StarTeam 文件夹的路径。 

■ 


值 : 用户列表、 (< 无 >) 


独占锁定某一主题的用户的名称。 


了解字段 

■ 


值 : 用户列表、 (< 无 >) 


上次修改主题的用户的名称。 

■ 




上次修改主题的时间。 

■ 





指示当前用户是否锁定了主题 , 如果锁定 , 该锁定是否为独占锁定。 

■ 


值 : 文本 




■ 


值 : 文本 


已经非独占锁定主题的用户的名称。 

■ 


值 : 数字 


每个主题在添加到视图时都被分配一个对象 ID。 

■ 

Parent Topic ID ( 父主题 ID)( 高级 ) 

值 : 数字 

内部标识符 :ParentTopicID 

某主题在父视图中的对象 ID。如果此视图没有父视图 , 则 Parent ID ( 父 ID) 为 -1。 

■ 


值 :High ( 高 )、 Low ( 低 )、 Normal ( 正常 ) 


Priority( 优先级 ) 字段的值。可以使用储存库自定义更改这些值的名称或加入其它值。 

■ 


值 :No ( 否 )、 Yes ( 是 ) 


指示主题的配置是否为只读 ( 如同在视图的回滚配置中 )。 


了解字段 

■ 




指示将主题视为已读还是未读。 

■ 






■ 

Recipient Count ( 收件人计数 ) 

值 : 数字 

内部标识符 :RecipientCount 

接收主题的收件人数量。 

■ 

Recipient IDs ( 收件人 ID) 



内部标识符 :RecipientIDs 

不能在查询中使用。分配给作为收件人 ( 要向此人通知此主题 ) 的用户的 ID 号。 

■ 

Recipient Names ( 收件人名 ) 


内部标识符 :RecipientNames 

被指定通知此主题的收件人的名称。 

■ 


值 :0 



■ 







■ 


值 : 文本 


用于存储作为更改主题属性的原因而提供的初始 2000 个字符。附加文本存储在 


■ 


值 :Active ( 活动 )、 Inactive ( 非活动 ) 


指示此主题的状态。 


了解字段 

■ 

Title ( 标题 ) 

值 : 文本 

内部标识符 :Title 

Title ( 标题 ) 字段中的文本。 

■ 

Topic Number ( 主题号 ) 

值 : 数字 

内部标识符 :TopicNumber 

分配给主题的编号。例如 , 如果 Object ID ( 对象 ID) 为 0, 则主题号为 1。 

■ 


值 :Response ( 响应 )、 Topic ( 主题 ) 


指示该项是主题 ( 主题树的根 ) 还是响应 ( 主题树的分支 )。 

■ 


值 : 数字 



审核日志字段 

本节将按字母顺序列出所有审核条目字段。 

■ 

Class Name 1 ( 类名称 1) 

值 : 文本 

内部标识符 :Class Name 1 ( 包括空格 ) 

项的类名 , 如 Label ( 标签 )、 Promotion State ( 提升状态 )、 Folder ( 文件夹 )、 

File ( 文件 )、 Change Request ( 更改请求 )、 Topic ( 主题 ) 或 Task ( 任务 )。 

■ 


值 : 文本 


项的类名 , 如 Folder ( 文件夹 )、 File ( 文件 )、 Change Request ( 更改请求 )、 

Label ( 标签 )、 Topic ( 主题 ) 或 Task ( 任务 )。 

■ 


值 : 文本 


项的类名 , 如 Folder ( 文件夹 )、 File ( 文件 )、 Change Request ( 更改请求 )、 

Label ( 标签 )、 Topic ( 主题 ) 或 Task ( 任务 )。 

■ 


值 : 用户列表、 (< 无 >) 


始终为空 , 因为由系统创建审核条目。 


了解字段 

■ 




创建此条目的时间。 

■ 


值 : 用户列表、 (< 无 >) 


删除审核条目的用户的名称。因为删除的条目不出现在列表中 , 此信息对用户不可用。 

■ 




删除审核条目的时间。因为删除的条目不出现在列表中 , 此信息对用户不可用。 

■ 

Event ( 事件 ) 

值 :Added( 添加 )、Branched( 分支 )、Checked In( 签入 )、Checked Out( 签 

出 )、Comment Edited( 编辑注释 )、Created( 创建 )、Deleted( 删除 )、Edited 

( 编辑 )、Item Overwritten( 改写项 )、Label Attached( 附加标签 )、Label Created 

( 创建标签 )、 Label Deleted ( 删除标签 )、 Label Detached ( 分离标签 )、 Label 

Frozen ( 冻结标签 )、 Label Modified ( 修改标签 )、 Label Moved ( 移动标签 )、 

Label Unfrozen( 解冻标签 )、Lock Broken( 断开锁 )、Locked( 锁定 )、Modified 

( 修改 )、Moved From( 移动自 )、Moved To( 移动至 )、Promotion Model Modified 

( 修改提升模型 )、 Promotion State Modified ( 修改提升状态 )、 Shared ( 共享 )、 

Unlocked ( 解锁 )、 Vault Converted ( 转换储存仓 ) 

内部标识符 :EventID 

要记录的操作的名称。 

■ 


值 : 文本 


存储审核条目的 StarTeam 文件夹的名称。 

■ 


值 : 文本 


存储审核条目的 StarTeam 文件夹的路径。 

■ 

Folder VMID ( 文件夹 VMID)( 高级 ) 

值 : 数字 

内部标识符 :FolderVMID 

为存储项的文件夹分配的 ID。 

■ 

Item 1 ( 项 1) 

值 : 文本 

内部标识符 :Item 1 ( 包括空格 ) 

指示哪个 1 类项接收审核操作。此字段可以是文件或任务的名称、更改请求或需求的 

编号或者主题的标题。 


了解字段 

■ 

Item 1 Info ( 项 1 信息 ) 

值 : 文本 

内部标识符 :Info 

如果该 1 类项是可修订的 , 则以点标记形式为其提供修订号。例如 , 标签可以是 1 类 

项且没有修订。 

■ 

Item 2 ( 项 2) 

值 : 文本 


指示哪个 2 类项接收审核操作。例如 , 如果将标签附加到文件 , 则 1 类项为标签 , 2 

类项为文件。 

■ 


值 : 文本 

内部标识符 :Info2 



■ 

Item 3 ( 项 3) 

值 : 文本 


指示哪个 3 类项接收审核操作。例如 , 如果将标签从文件的一个修订移动到另一个修 

订 , 则 1 类项为标签 , 2 类项为文件的初始修订 , 3 类项为文件的最终修订。 

■ 


值 : 文本 

内部标识符 :Info3 



■ 


值 : 用户列表、 (< 无 >) 


不适用于审核条目。 

■ 




不适用于审核条目。 

■ 


值 : 数字 


每个审核条目在添加到视图时都被分配一个对象 ID。 

■ 

Project ( 项目 ) 

值 : 此服务器配置中的项目列表、 (< 无 >) 

内部标识符 :ProjectID 

在其中记录审核条目的项目的名称。 


了解字段 

■ 

Target 1 Class ID ( 目标 1 类 ID)( 高级 ) 

值 : 数字 

内部标识符 :Target 1 Class ID ( 包括空格 ) 

分配给 1 类项的 ID 号 , 如果没有 ID 则为 -1。 

■ 

Target 1 Object ID ( 目标 1 对象 ID)( 高级 ) 

值 : 数字 

内部标识符 :Target 1 Object ID ( 包括空格 ) 

接收审核操作的 1 类项的对象 ID, 如果没有 ID 则为 -1。 

■ 

Target 1 Revision Time ( 目标 1 修订时间 ) 


内部标识符 :Target 1 Revision Time ( 包括空格 ) 

对接收审核操作的 1 类项进行最后修订的时间。 

■ 


值 : 数字 



■ 


值 : 数字 



■ 





■ 


值 : 数字 



■ 


值 : 数字 



■ 





■ 

User ( 用户 ) 

值 : 用户列表、 (< 无 >) 

内部标识符 :UserID 

执行记录操作的用户的名称。 


了解字段 

■ 


值 : 视图列表、 (< 无 >) 


在其中记录审核条目的视图的名称。 


了解字段 


章 

使用 Visual Merge 和 Visual Diff 

第 7 章 

Visual Merge 和 Visual Diff 实用程序可帮助您查找和管理文件和文件修订间的变化。这 

两个实用程序均可通过以下方式运行 : 

■ 

■ 

Windows 开始菜单 

命令行 

■ 

在 StarTeam 内部 

Visual Diff 是一个双向文本比较实用程序 , 它可以比较文本文件、文本文件的两个不同 

修订、二进制文件和文件夹内容。它可并排比较两个文件。比较文件修订时 , 会自动启 

动 Visual Diff ( 请参阅第 160 页的 “ 比较文件内容 ” 获得更多信息 )。 

Visual Merge 是一个三向合并实用程序 , 它可以合并文本文件或二进制文件。与 Visual 

Diff 一样 , 在签入或签出状态为 Merge ( 合并 ) 的文件时 , 会自动启动 Visual Merge。 

它只能用在 StarTeam Windows 客户机中。 

作为说明 Visual Merge 如何工作的一个示例 , 假设两个用户从服务器签出同一个文本文 

件。然后他们都在各自工作站修改该文件。现在有三个类似的文件 : 

■ 

■ 

最初签出至这两个工作站的修订 

由 1 号用户修改的文件 

■ 

由 2 号用户修改的文件 

1 号用户签入新修订时 ,2 号用户的文件状态变为 Merge( 合并 ), 以便就此问题提醒 2 

号用户。2 号用户签入其文件时 ,Visual Merge 会将 1 号用户的工作与一个窗格中的原 

始文件进行比较 , 将 2 号用户的工件与第二个窗格中的原始文件进行比较 , 并在第三个 

窗格中提供一个建议的合并文件。通过提供此建议的合并文件 , 就不会丢失工作。 

Visual Merge 和 Visual Diff 实用程序比较 

下面的详细示例说明了这两个实用程序间的差异。 

autoexec.bat 文件的 Revision 1 ( 修订 1) 中包含以下行 : 

set temp=c:\windows\temp 

path=c:\;c:\windows\command;c:\windows; 

c:\dos\doskey 

c:\mouse\mouse 

第 7 章 : 使用 Visual Merge 和 Visual Diff 125

Visual Merge 和 Visual Diff 实用程序比较 

C:\TOOLKIT\GUARD 

set pvxfid0=T111 

两个用户将其签出并进行修改。Revision 2( 修订 2) 为第一个用户创建的 autoexec.bat 

文件 , 用于将文件重新签入。其中有一个关于 qbackup 的附加行 : 


path=c:\;c:\windows\command;c:\windows;c:\dos 

c:\dos\doskey 




set qbackup=c:\qbackup\data 

第二个用户试图签入文件时 , 其工作文件夹中文件的状态从 Current( 当前 ) 变为 Merge 

( 合并 )。 StarTeam 指出该文件自第二个用户签出文件副本后已发生变化。 

此 autoexec.bat 文件的副本 ( 即第二个用户的工作文件 ) 中包含以下内容 : 


path=c:\;c:\”my documents”; 

c:\windows\command;c:\windows;c:\dos 




doskey 行被删除 , path 和 set pvxfid0 行均已更改。 

第二个用户签入文件后 , StarTeam 即开始执行合并 , Visual Merge 在其窗口中显示以 

下三个窗格 : 

左上部窗格显示 Revision 2( 修订 2)( 第一个用户的工作 ) 与 Revision 1( 修订 1) 的 

比较。第 7 行为绿色 , 指示已添加该行。 

右上部窗格将第二个用户的工作文件 ( 尚未签入的文件 ) 与 Revision 1( 修订 1) 比较。 

doskey 行为红色并带有删除线 , 因为它已被删除。 path 和 set pvxfid0 行为蓝色 , 因为 

已对其进行了更改。 

底部窗格 Merged Results( 合并结果 ) 显示解决这些更改所做的一个尝试。由于 Visual 

Merge 无法解决下部窗格的第 5 行 , 该行将 set pvxfid0 设置为 111 或 112, 必须由您 

来解决。 


使用 Visual Merge 

Revision 2 

与 Revision 1 

的比较 

工作文件 

与 Revision 1 

的比较 

Revision 3 的 

建议合并 

如果使用 Visual Diff 比较 Revision 2 ( 修订 2) 和其余的工作副本 , Visual Diff 会确定 

它们间的差异。由于 Revision 2( 修订 2) 既没有 doskey 行 , 也没有 qbackup 行 , 因而 

Visual Diff 假设已在第二个工作副本中删除了这两行。 Visual Diff 同 Visual Merge 一 

样 , 将 path 和 set pvxfid0 行标识为已更改。但是 ,Visual Diff 不对任何添加的行进行标 

识 , 因为其余工作副本中的所有行都在 Revision 2 ( 修订 2) 中。 


可采用以下方式访问 Visual Merge : 

■ 

■ 

可将其作为带图形用户界面的独立实用程序 

可将其作为命令行上的独立实用程序 

■ 

可在签入或签出状态为 Merge ( 合并 ) 的文件时访问 

可与文本文件或二进制文件一起使用 Visual Merge。 

如果强制签入状态为 Merge ( 合并 ) 的文件 , 则自签出文件后对此文件的所有修订进行 

的更改都将被覆盖。 

使用独立实用程序 

Visual 

Merge 

将 Visual Merge 作为带有图形用户界面的独立实用程序访问 : 


■ 

双击 StarTeam 程序组中的 Visual Merge 图标。 

■ 

选择 “ 开始 ” > “ 程序 ” > StarTeam > StarTeam Clientx.x > Visual Merge。 



出现 Visual Merge Info (Visual Merge 信息 ) 对话框。 

2 Visual Merge 是一个三向比较实用程序 , 它可以合并没有冲突的所有行。冲突可定义 

为在两个文件 ( 或文件修订 ) 中都进行了更改的行 , 因此 ,Visual Merge 无法自动确 

定要在合并的文件中保留的更改。 

必须提供所有这三个文件的路径 : 

a 在 Common Ancestor File ( 共同祖先文件 ) 文本框中 , 输入或浏览至其它两个要 

进行比较的文件的共同祖先。 

b 在 First File ( 第一个文件 ) 文本框中 , 输入或浏览至两个文件中的一个。 

c 在 Second File ( 第二个文件 ) 文本框中 , 输入或浏览至另一个文件。 

3 在 Results File ( 结果文件 ) 文本框中 , 输入或浏览至要存储经过三向比较和编辑后 

产生的合并文件。 

4 单击 OK ( 确定 ), 开始合并过程。 



从命令行将 Visual Merge 作为独立实用程序访问 : 

■ 

在命令行使用以下语法 :l 

vismerge [-am |-amt |-at] [-iw] ancestor_file_path first_file_path 

second_file_path [result_file_path] [ancestor_caption] 

[first_file_caption] [second_file_caption] 

如果不使用 -am、 -amt 或 -at, 则 Visual Merge 窗口将打开 , 并且您必 

须执行所有合并。一切都不能自动完成。 

-am 

使 Visual Merge 自动合并所有无冲突的行 , 然后 Visual Merge 窗口会打 

开 , 这样便可以检查结果文件。 

-amt 使 Visual Merge 自动合并所有无冲突的行 , 然后在没有冲突时终止。 

Visual Merge 窗口仅在结果文件中有冲突时才打开。 

-at 

使 Visual Merge 只自动合并无冲突的更改。 Visual Merge 窗口永远不打 

开。如果无冲突 , 则合并结果保存在结果文件中。否则 , 命令终止。 

-iw 

使 Visual Merge 忽略空白字符。例如 , 如果一个文件有两个制表符 , 而 

另一个文件有八个空格 , 则可将制表符与空格视为等同。 

ancestor_ 

作为两个要合并的文件的基础的公用文件的路径。 

file_path 

first_ 

合并过程中要使用的两个文件中的第一个文件。 

file_path 

second_ 

合并过程中要使用的两个文件中的第二个文件。 

file_path 

result_ 

file_path 

( 可选 ) 存储合并结果的文件的路径。若未使用 , 则如果创建了合并的文 

本文件 , 它将成为标准输出。也就是说 , 您可在 DOS 窗口中看到合并后 

的文本 , 或将该文本重定向到另一文件 , 例如 : 

ancestor_ 

caption 

first_file_ 

caption 

second_file_ 

caption 

vismerge -am common.txt file1.txt file2.txt > result.txt 

Visual Merge 中下部窗口的标题 ( 前接 “Derived from ( 派生自 )”)。 

建议使用祖先文件的名称作为标题。 

Visual Merge 中左上部窗口的标题。建议使用 first_file_path 选项指定的 

文件的名称。 

Visual Merge 中右上部窗口的标题。建议使用 second_file_path 选项指 

定的文件的名称。 

在 StarTeam 中使用 Visual Merge 

任何时候签入或签出状态为 Merge ( 合并 ) 的文本文件时 , StarTeam 都会询问是否要 

合并此文件。如果选择 Yes( 是 ),StarTeam 会启动 Visual Merge。选择 No( 否 ) 或 

Cancel ( 取消 ) 则停止签入或签出操作。 

个人选项控制您是否 : 

■ 

总能看到 Visual Merge 主窗口 , 以便在有冲突时编辑合并后的文件。 



■ 

除非需要解决冲突 , 否则将自动签入或签出合并后的文件 ( 由 Visual Merge 创建 )。 

然后就可看到 Visual Merge 主窗口。 

此选项只适用于文本文件。对于二进制文件 , Visual Merge 会对冲突进行标识。 

设置 Visual Merge 个人选项 : 

1 从菜单栏选择 Tools ( 工具 ) > Personal Options ( 个人选项 )。 

2 在随后显示的 Personal Options ( 个人选项 ) 对话框中 , 选择 File ( 文件 ) 选项卡。 

3 选择上下文 Visual Merge In Case Of Conflicts ( 冲突时启动 Visual Merge) 选项按 

钮 , 可在合并文件中有冲突时收到相关通知。 

4 单击 OK ( 确定 )。 

使用主窗口合并文本文件 

Visual Merge 主窗口由一个菜单栏、一个工具栏和三个窗格组成。三个窗格中分别显示 

要合并的两个文件和建议的合并文件。要合并的两个文件分别显示在左上部窗格和右上 

部窗格中。每个窗格都显示其中的文件与该文件所基于的修订之间的差异。 

显示差异时带有颜色。默认颜色如下 : 

■ 

黑色。匹配的文本块呈黑色。 

■ 

红色。删除的文本块呈红色且带有删除线。 

■ 

绿色。插入的文本块呈绿色。 



■ 

蓝色。更改的文本块呈蓝色。相似但不完全相同的文本被视为已更改。 

注 

如果在 Visual Merge 中更改颜色 , Visual Merge 会检查系统的背景颜色 , 以确保没 

有颜色冲突。如果背景颜色与设置的一个颜色相同 ,Visual Merge 会使用系统的文本 

颜色。 

建议的合并文件显示在下部窗格中 , 且不使用颜色标识。这是唯一可编辑的窗格。在上 

面的两个窗格中 , 只能复制文本。 

如果在一个上部窗格中右建单击已更改、新建或删除的文本块 , 则 Visual Merge 会显示 

以下上下文菜单 : 

单击菜单选项可更改下部窗格中的文本。例如 , 假设有更改的文本块 ( 默认为蓝色 ) 。 

该文本块在上面的两个窗格中都以蓝色显示 , 但却是不相同的块。其中的一个文本块还 

会显示在下部窗格中 (Visual Merge 会判断哪个更改是所需更改 )。 

如果右键单击一个更改的块 , 并在上下文菜单中选择了 Apply Both Changes( 应用两种 

更改 ) , 则该文本块和上面的另一个窗格中的对应文本都会显示在下部窗格中。该窗格 

中原来已经存在一个更改 , 现在存在两个更改。如果右键单击了更改的块 , 并在上下文 

菜单中选择了 Apply Change( 应用更改 ), 则该文本块将被添加到下部窗格中 , 代替下 

部窗格中已有的文本。单击不同的窗格 , 文本块可代替其自身或上面的另一窗格中的对 

应文本。如果选择了 Remove Change ( 删除更改 ) , 则选择的文本块将从下部窗格中 

消失。 

添加和删除文本块的行为略有不同 , 但 Visual Merge 仍可判断出最符合逻辑的选择。例 

如 , 如果右键单击删除的文本块 ( 默认为红色 ), 然后单击 Remove Change ( 删除更 

改 ), 则删除的块被插入下部窗格中。即正在移除要删除的内容。 

更改文件编码 

默认情况下 ,Visual Merge 会认为在此三向合并实用程序中使用的文本文件和结果文件 

都使用与操作系统默认代码页完全相同的编码。除非为每个文件指定正确的编码 , 否则 

当文件存在不同编码时 , 即便可以比较 , 比较过程也非常困难。 



更改 Visual Merge 所使用或创建的文件的编码 : 

1 从菜单栏选择 Edit ( 编辑 ) > Encoding ( 编码 )。出现 File Encoding ( 文件编码 ) 

对话框。 

2 为需要更改编码的文件选择选项按钮。 

3 在 Encoding For Selected File ( 选定文件的编码 ) 列表框中选择正确的编码。 

4 对于其它带有错误编码的文件 , 重复步骤 2 和 3。 

5 单击 OK ( 确定 ) 以返回到 Visual Merge。 

搜索文本文件 

Visual Merge 的 Find ( 查找 ) 命令可在光标所在的窗格中查找搜索字符串的下一个实 

例。 Visual Merge 还可使所有三个窗格保持同步 , 以便在所有这三个窗格中都出现相同 

的字符串 ( 或其大概的先前位置 )。 

查找文本 : 


■ 

在菜单栏中选择 Search ( 搜索 ) >Find( 查找 )。 

Find 

注 

■ 

在工具栏上单击 Find ( 查找 )。 

出现 Find ( 查找 ) 对话框。 

2 在 Find What ( 查找内容 ) 文本框中输入要查找的字符串。 

3 如果要按输入的大小写准确查找文本 , 可选中 Match Case ( 区分大小写 ) 复选框。 

4 可在需要时指定搜索方向。 

Visual Merge 会记住搜索字符串 , 直至输入了另一个字符串或关闭应用程序为止。更 

换窗格 , 以便在另一窗格中搜索。 

5 单击 Find Next ( 查找下一个 )。 

6 要查找下一个文本实例 , 请选择 Search ( 搜索 ) > Find Next ( 查找下一个 )。 

可使用 Visual Merge 菜单栏中的 Search ( 搜索 ) 菜单或工具栏按钮搜索下一组或上一 

组差异。 Visual Merge 查找这些行 , 然后将其定位在每个窗格的顶部。 



要查找下一个或上一个差异 , 可执行以下一项操作 : 

■ 

在菜单栏中选择 Search ( 搜索 ) > Next Difference ( 下一个差异 )。 

Next 

Difference 

■ 

单击工具栏上的 Next Difference ( 下一个差异 )( 黑色图标 )。 

■ 

在菜单栏中选择 Search ( 搜索 ) > Previous Difference ( 上一个差异 )。 

Previous 

Difference 

■ 

单击工具栏上的 Previous Difference ( 上一个差异 )( 黑色图标 )。 

此外 , 还可搜索下一组或上一组冲突 , 这些冲突即为发生变化的行 , 需要进行干预才能 

防止数据丢失。 

要查找下一个冲突或上一个冲突 , 可执行以下一项操作 : 

■ 

在菜单栏中 , 选择 Search ( 搜索 ) >Next Conflict ( 下一个冲突 )。 

Next 

Conflict 

■ 

单击工具栏上的 Next Conflict ( 下一个冲突 )( 红色图标 )。 

■ 

在菜单栏中选择 Search ( 搜索 ) > Previous Conflict ( 上一个冲突 )。 

Previous 

Conflict 

■ 

单击工具栏上的 Previous Conflict ( 上一个冲突 )( 红色图标 )。 

退出 Visual Merge 

如果在签入或签出操作过程中使用 Visual Merge 合并文件 , 则退出时需要执行几个步 

骤。编辑合并文件后 , 可能由于帮助您的用户的更改有丢失的危险 , 您必须决定是否保 

存合并的文件。如果正在签入文件 , 则还必须决定是签入合并文件还是仅替换工作文件。 

退出 Visual Merge: 

1 从菜单栏选择 File ( 文件 ) > Exit ( 退出 )。 

Visual Merge 会询问您是否要保存文件。在同一消息对话框中 ,Visual Merge 还会通 

知您文件是否还有未解决的冲突 ( 在有冲突的情况下 )。例如 : 


■ 

单击 Yes ( 是 ) 退出 Visual Merge, 并将合并文件保存为工作文件。 

■ 

单击 No( 否 ) 退出 Visual Merge, 工作文件为启动 Visual Merge 前的已有文件。 

工作文件的状态仍为 Merge ( 合并 )。 

■ 

单击 Cancel ( 取消 ), 返回到 Visual Merge 并继续编辑。 

3 退出 Visual Merge 后 , 如果合并文件可能更改工作文件 , 则会询问您是否要改写工作 

文件。 

执行以下一项操作 : 

■ 

单击 Yes ( 是 ) 用合并文件改写工作文件。工作文件的状态变为 Modified ( 已修 

改 )。 



■ 

单击 No ( 否 ) , 停止将合并文件保存为工作文件的过程。工作文件的状态仍为 

Merge ( 合并 )。 

4 如果正在签入文件而且 ( 在上一步中 ) 单击了 Yes ( 是 ) 以改写工作文件 , 会询问 

您是否要完成此签入操作。 


■ 

单击 Yes ( 是 ) 签入合并文件。 

工作文件的状态变为 Current ( 当前 )。 

■ 

单击 No ( 否 ) 或 Cancel ( 取消 ) 则停止签入操作。 

工作文件的状态仍为 Modified ( 已修改 )。( 如果单击了 Cancel ( 取消 ), 则可 

能需要执行 Update Status( 更新状态 ) 操作才能看到实际状态为 Modified( 已修 

改 )。) 

自定义 Visual Merge 

可以控制工具栏、行号和颜色等的外观。 

自定义 Visual Merge: 

1 在菜单栏中选择 Search( 搜索 )> Options( 选项 )。出现 Options( 选项 ) 对话框。 

2 选择对话框的顶部的 Display ( 显示 ) 或 Color ( 颜色 ) 选项卡。 

■ 

选择 Display ( 显示 ) 可更改主窗口和各个窗格中文本的外观。您可更改选项卡设 

置和字体、控制工具栏和状态栏以及打开或关闭行号。 

■ 

选择 Color( 颜色 ) 可更改删除文本、更改文本、插入文本和匹配文本的默认颜色。 

3 单击 OK ( 确定 )。 


使用 Visual Diff 

对二进制文件使用 Visual Merge 

可对文本文件和二进制文件执行合并操作。该实用程序对工作文件、最新修订及其共同 

祖先修订执行三向比较。但是 , 对二进制文件使用 Visual Merge 需要注意 : 

■ 

不要使用 Visual Merge 主窗口。 

■ 

必须决定是否要继续处理工作文件或最新修订。 

注 

用创建文件的应用程序合并这两个文件的内容可能更方便。例如 ,Microsoft Word 和 

FrameMaker 都提供了比较功能。 

合并二进制文件 : 

1 选择状态为 Merge ( 合并 ) 的文件。 

2 开始签入或签出操作。如果是二进制文件 , 则出现 StarTeam Cannot Merge Binary 

Files (StarTeam 无法合并二进制文件 ) 对话框。 


Status ( 状态 ) 字段指示源文件、目标文件或两者是否已改变 ( 与其共同祖先相比 

较 )。 

3 从 Merge Results ( 合并结果 ) 下拉列表框中选择 Use Source Contents ( 使用源内 

容 ) 或 Use Target Contents ( 使用目标内容 ), 以此决定使用这两个文件中哪个文 

件的内容作为合并的文件。 

4 单击 OK( 确定 ) 创建合并的文件 , 或单击 Cancel( 取消 ) 不在此时创建合并的文件。 

注如果正在签入文件 , 则可签入合并文件或替换当前工作文件。如果正在签出文件 , 

则合并文件将替换当前工作文件。 

访问 Visual Diff 的方法有 : 

■ 

■ 

可将其作为带图形用户界面的独立实用程序访问 

可从命令行将其作为独立实用程序 

■ 

通过在 StarTeam 中请求比较两个修订 ( 或一个修订和一个工作文件 ) 来访问。 

Visual 

Diff 

Visual Diff 是一个双向比较实用程序 , 它可以比较文本文件、二进制文件和文件夹内容。 

将 Visual Diff 作为带有图形用户界面的独立实用程序访问 : 


■ 

双击 StarTeam 程序组中的 Visual Diff 图标。 

■ 

选择 “ 开始 ” > “ 程序 ” > StarTeam > StarTeam Client x.x > Visual Diff。 

Visual Diff 窗口随即打开。 



2 在 Visual Diff 菜单栏中 , 执行以下一项操作 : 

■ 

选择 File ( 文件 ) > Open Files ( 打开文件 )。 

■ 

选择 File ( 文件 ) > Open Folders ( 打开文件夹 )。 

注 


3 选择要比较的第一个文件或文件夹 , 然后单击 Open( 打开 )。出现另一个 Open( 打 

开 ) 对话框。 

4 选择要比较的第二个文件或文件夹 , 然后单击 Open ( 打开 )。 

Visual Diff 比较文本文件或文件夹的内容并将它们显示在 Visual Diff 主窗口中。对 

于二进制文件 , Visual Diff 可指出两个文件是否相同。 

从命令行将 Visual Diff 作为独立实用程序访问 : 

■ 

在命令行输入以下命令 : 

visdiff first_file_path second_file_path 

使用 View Diff 主窗口 

Visual Diff 主窗口由一个菜单栏、一个工具栏和两个窗格组成。可以在这些窗格中显示 

比较的文件 , 显示方式可以是并排显示或一个文件在其它文件上面的方式 , 或在只有一 

个窗格的窗口中的合并视图中显示。 

下图显示了两个文本文件版本的并排比较。有关比较的详细信息 , 请参阅第 140 页的 

“ 比较文件和查看差异 ”。 

下图显示了两个文件夹内容的上下比较。它将文件夹内容作为文本处理 , 显示哪些行相 

同、哪些行不同等等。 



使用菜单命令和工具栏按钮 

Windows 和 Cross-Platform 客户机的菜单命令和工具栏按钮略有不同 : 

菜单命令工具栏按钮说明和注释 

File ( 文件 ) > Open 

Files ( 打开文件 ) 

(Cntrl+O) 

> Open Folders 

( 打开文件夹 ) 

(Cntrl+E) 

无在 Visual Diff 中打开两文件。 

无 

在 Visual Diff 中打开两个文夹件 ( 仅适用于 Windows 

客户机 )。 

> Close ( 关闭 ) 无在 Visual Diff 中关闭当前比较窗口。 

> Merge Files ( 合并 

文件 ) 

可将两文件保存为合并的文件 ( 仅适用于 Windows 客 

户机 )。 

> Reload( 重新加载 ) 无可在两个文件中至少有一个发生变化时重新加载这两个 

文件 ( 仅适用于 Cross-Platform 客户机 )。 

> Print Setup ( 打印无可设置打印机 ( 仅适用于 Windows 客户机 )。 

设置 ) 

> Print ( 打印 ) 

(Cntrl+P) 

可执行打印 ( 仅适用于 Windows 客户机 )。 

> Chart ( 图表 ) 显示比较匹配行、插入行、删除行和替换行的条形图。 

> Exit ( 退出 ) 无关闭 Visual Diff 应用程序。 

Edit ( 编辑 ) > Copy 

( 复制 ) 

(Cntrl+C) 

复制所选文本。 



菜单命令工具栏按钮说明和注释 

>Select All ( 全选 ) 

(Cntrl+A) 

无 

如果光标在源文件中 , 则选择源文件中的所有文本 

( 仅适用于 Cross-Platform 客户机 )。 

> Encoding ( 编码 ) 无可为两个文件选择编码。 

> Options ( 选项 ) 无显示 Options ( 选项 ) 对话框。在这两种客户机中 , 此 

对话框有不同的选项卡和选项。请参阅第 142 页的 

“ 自定义 Visual Diff”。 

> Search Find ( 搜索 

查找 ) 

(Cntrl+F) 

在光标所在的文件中搜索光标后指定文本的第一个实例。 

> Find Next ( 查找下 

一个 ) 

(F3) 

> Next 

Difference ( 下一个 

差异 ) 

(F8) 

> Previous Difference 

( 上一个差异 ) (F7) 

无在光标所在的文件中搜索指定文本的下一个实例。 

搜索两个文件之间的下一个差异 , 并将文本块的第一行 

显示在窗格的顶部。 

搜索两个文件之间的上一个差异 , 并将文本块的第一行 

显示在窗格的顶部。 

> Next Match ( 下一 

个匹配内容 ) 

(Shift+F8) 

> Previous Match 

( 上一个匹配内容 ) 

(Shift+F9) 

Window ( 窗口 ) > 

Split Vertically ( 垂直 

拆分 ) 

> Split Horizontally 

( 水平拆分 ) 

> Show Together 

( 一起显示 ) 

搜索两个文件之间的下一个匹配内容 , 并将匹配文本块 

的第一行显示在窗格的顶部。 

搜索两个文件之间的上一个匹配内容 , 并将匹配文本块 

的第一行显示在窗格的顶部。 

垂直拆分窗格 , 每侧显示一个文件。 

水平拆分窗格 , 上下显示文件。 

在同一窗格中一起显示两个文件 ( 仅适用于 Windows 

客户机 )。 

>Switch Panes ( 切 

换窗格 ); Switch 

Comparison Order 

( 切换比较顺序 ) 

> Differences only 

( 仅显示差异 ) 

更改文件编码 

切换显示两个文件的窗格。 

在显示所有行和只显示有差异的行这两种显示方式之间 

切换 ( 仅适用于 Cross-Platform 客户机 )。 

Windows 客户机是通过 Options ( 选项 ) 对话框的 

display ( 显示 ) 选项卡中的选项执行此操作的。 

> Help( 帮助 )> Help 无显示 Windows 帮助文件 ( 仅适用于 Windows 客户机 )。 

Topics ( 帮助主题 ) 

> About ( 关于 ) 无显示 About( 关于 ) 框 ( 仅适用于 Windows 客户机 )。 

默认情况下 , Visual Diff 会认为要比较的文本文件具有与操作系统默认代码页完全相同 

的编码。除非为每个文件指定正确的编码 , 否则当文件存在不同编码时 , 即便可以比较 , 

比较过程也非常困难。 



更改要比较的文件的编码 : 

1 从菜单栏选择 Edit ( 编辑 ) > Encoding ( 编码 )。出现 File Encoding ( 文件编码 ) 

对话框。 

2 在 File 1 Encoding ( 文件 1 编码 ) 列表框中选择第一个文件的正确编码。 

第一个文件显示在左侧或顶部 , 这要视您选择的文件显示方式而定。如果在一个窗格 

中一起显示两个文件 , 则需将这两个文件垂直或水平拆分才能正确设置编码。 

3 在 File 2 Encoding ( 文件 2 编码 ) 列表框中选择第二个文件的正确编码。 

4 单击 OK ( 确定 ) 以返回到 Visual Diff。 

用鼠标操控窗口拆分条 

除可使用 Window 菜单选项和工具栏按钮更改文件的显示选项外 , 还可以使用鼠标操控 

拆分条。 

使用时 , 拆分条可拆分 Visual Diff 主窗口。未使用时 , 水平拆分条位于垂直滚动条的上 

方 , 垂直拆分条位于水平滚动条的左边。 

水平 

垂直 

使用鼠标可以执行以下操作 : 

■ 

拖动分割两个窗格的拆分条重新调整窗格的比例。 

■ 

将分割两个窗格的拆分条拖动至窗口边缘便可取消拆分 , 并在一个窗格中一起显示 

文件。 

■ 

将垂直拆分条拖动至一个尚未拆分或水平拆分的窗口之上 , 便可将该窗口垂直拆分。 

■ 

将水平拆分条拖动至一个尚未拆分或垂直拆分的窗口之上 , 便可将该窗口水平拆分。 

■ 

双击未使用的拆分条可将其激活。 

■ 

双击使用中的拆分条可将其取消激活 ( 删除 )。 



Comparison 

Switch 

Order 

比较文件和查看差异 

无论是在 StarTeam 中启动 Visual Diff, 还是将其作为独立的应用程序打开 , 只要进行 

了标识 , Visual Diff 就会自动比较文件或修订。选择的第一个文件显示在左侧 , 第二个 

文件显示在右侧。 

注如果在 StarTeam 中访问 Visual Diff 来比较同一文件的两个修订 , 则旧文件在左侧 , 

新文件在右侧。 

左侧窗格中的文件 ( 最初为选择的第一个文件或旧修订 ) 与右侧窗格中的文件 ( 最初为 

选择的第二个文件 ) 比较。在第一个文件中存在但在第二个文件中不存在的文本被标记 

为 deleted ( 删除 ) 。在第二个文件中存在但在第一个文件中不存在的文本被标记为 

added ( 添加 )。 

如果选择文件的顺序错误 , 可更改比较顺序 , 即 , 可以更改在哪个窗格中显示哪个文件。 

要更改比较顺序 , 可在菜单栏中选择 Window( 窗口 )> Switch Comparison Order( 切 

换比较顺序 ), 或在工具栏中单击 Switch Comparison Order ( 切换比较顺序 )。 

如果所选择的两个文件无差异 , 则 Visual Diff 会显示一条声明文件相同的消息 , 而且不 

显示这些文件。 

Visual Diff 比较并显示文件后 , 用颜色指示差异。默认颜色如下 : 

■ 

黑色。匹配的文本块呈黑色。 

■ 

红色。删除的文本块呈红色且带有删除线。删除的文本只出现在左侧窗格中。 

■ 

绿色。插入的文本块呈绿色。插入的文本只出现在右侧窗格中。 

■ 

蓝色。更改的文本块呈蓝色。相似但不同的文本被视为已更改。 

注 

如果更改在 Visual Diff 中使用的颜色 , Visual Merge 会检查系统的背景颜色 , 以确 

保没有颜色冲突。如果背景颜色与设置的颜色之一相同 ,Visual Diff 将使用系统文本 

颜色。 

在单一窗格中显示比较文件时 , 只以相应的颜色显示一次匹配行、删除的行和插入的 

行。更改的行则显示两次 , 并以蓝色显示。第一行来自先选择的文件或较旧修订 , 并且 

带有删除线。第二行来自后选择的文件或较新修订。 

例如 : 

set pvxfid0=T111 (older revision) 

set pvxfid0=T112 (newer revision) 

搜索文本文件 

Visual Diff 的 Find ( 查找 ) 命令可在活动窗格中查找文本字符串。 Visual Diff 使这两个 

窗格保持同步 , 这样在这两个窗格中都会出现相同的字符串 ( 或其大概的先前位置 )。 

也可使用 Visual Diff 菜单栏中的 Search ( 搜索 ) 菜单或工具栏按钮搜索下一组匹配或 

不匹配行或上一组匹配或不匹配行。 Visual Diff 查找这些行 , 然后将其定位在每个窗格 

的顶部。 



查找文本 : 


■ 

在菜单栏中选择 Search ( 搜索 ) >Find( 查找 )。 

Find 

Next 

Difference 

■ 

在工具栏上单击 Find ( 查找 )。出现 Find ( 查找 ) 对话框。 

2 在 Find What ( 查找内容 ) 文本框中输入要查找的字符串。 

3 如果要按输入的大小写准确查找文本 , 可选中 Match Case ( 区分大小写 ) 复选框。 

4 可在需要时指定搜索方向。 

Visual Diff 会记住搜索字符串 , 直至输入了另一个字符串或关闭应用程序为止。要搜 

索另一窗格 , 只需要简单地更换窗格即可。 

5 单击 Find Next ( 查找下一个 )。 

6 要查找下一个文本实例 , 请使用 Search ( 搜索 ) > Find Next ( 查找下一个 )。 

要查找下一个或上一个差异 , 可执行以下一项操作 : 

■ 

在菜单栏中选择 Search ( 搜索 ) > Next Difference ( 下一个差异 )。 

■ 

单击工具栏上的 Next Difference ( 下一个差异 )。 

■ 

在菜单栏中选择 Search ( 搜索 ) > Previous Difference ( 上一个差异 )。 

Previous 

Difference 

Next 

Match 

Previous 

Match 

■ 

单击工具栏上的 Previous Difference ( 上一个差异 )。 

要查找下一个或上一个匹配内容 , 可执行以下一项操作 : 

■ 

在菜单栏中 , 选择 Search ( 搜索 ) >Next Match ( 下一个匹配内容 )。 

■ 

在工具栏中单击 Next Match ( 下一个匹配内容 )。 

■ 

在菜单栏中选择 Search ( 搜索 ) > Previous Match ( 上一个匹配内容 )。 

■ 

在工具栏中单击 Previous Match ( 上一个匹配内容 )。 

合并或打印比较文件 

合并两个文件或修订以创建一个新文件时 , 系统使用一系列字符 ( 而不是使用颜色 ) 来 

描绘文本。文件合并后 , 必须手动删除无关的文本。 

读取合并文件的要点 : 

####### 

上面的字符将更改的行与其余文本分开。更改的行的两个修订都显示出来 , 用 ~~~~~~~ 

分开。 

------- 

上面的字符将删除的行与其余文本分开。 

+++++++ 

上面的字符将插入的行与其余文本分开。 



下面是合并的文本文件的示例。 

@ECHO OFF 

C:\WINDOWS\NET START 

######################### 1 Line(s) Changed ########## 

C:\DOS\SMARTDRV.EXE /X 

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 

C:\DOS\SMARTDRV.EXE 1024 /X 

################################################### 

PROMPT $p$g 

PATH c:\windows;c:\dos;c:\mach32 

----------- 1 Line(s) Deleted --------------------- 

SET DIRCMD=/oen 

--------------------------------------------------- 

REM Set location for temp files. 

######################### 1 Line(s) Changed ########## 

SET TEMP=C:\DOS 

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 

SET TEMP=C:\TEMP 

################################################### 

+++++++++++++++++++++++++ 1 Line(s) Inserted +++++++++ 

SET TMP=C:\TEMP 

+++++++++++++++++++++++++++++++++++++++++++++++++ 

合并比较的文件 : 

1 打开并比较文件。 


■ 

从菜单栏选择 File ( 文件 ) > Merge Files ( 合并文件 )。 

Merge 

■ 

单击工具栏上的 Merge ( 合并 )。 

出现 Save Merged File As ( 将合并的文件另存为 ) 对话框。 

3 选择要用来存储文件的文件夹 , 然后为文件命名 , 再单击 Save ( 保存 )。 

Visual Diff 可创建新文件 , 并且可在设置了编辑选项时根据您的选择在 Windows 写字板 

或文本编辑器中将其打开。 

自定义 Visual Diff 

可以控制工具栏、行号和颜色等的外观。 

自定义 Visual Diff: 


■ 

在 Windows 客户机中 , 从菜单栏选择 Search ( 搜索 ) > Options ( 选项 )。 

■ 

在 Cross-Platform 客户机中 , 从菜单栏选择 Edit ( 编辑 ) > Options ( 选项 )。 



出现 Options ( 选项 ) 对话框。 

2 在对话框顶部选择一个选项卡。 

■ 

选择 Display ( 显示 ) 更改主窗口的外观和各个窗格中文本的显示。您可以 : 

■ 

■ 

■ 

■ 

■ 

更改选项卡设置 

更改字体 

只显示差异 

打开或关闭行号 

显示或隐藏工具栏或状态栏 

■ 

选择 Color( 颜色 ) 可更改匹配文本、替换文本、插入文本和删除文本的默认颜色。 

■ 

选择 Merge ( 合并 ) 可确定在何时以及用何种编辑器查看合并文件。 

■ 

选择 Compare ( 比较 ) 设置搜索选项 : 

■ 

Ignore case ( 忽略大小写 ) 

■ 

Ignore whitespace ( 忽略空白字符 ) 



如果使用 Windows 客户机 , 则可通过选中或清除复选框忽略或使用空白字符。 

若忽略空白字符 , 比较时会排除一行中的所有空格和制表符 ( 无论在何处出 

现 )。这与命令行的 stcmd diff -w 和 Cross-Platform 客户机的 Visual Diff 版本 

中所用的 VSS 样式是等同的 ( 接下来会进行解释 )。 

使用 Cross-Platform 客户机可以忽略特定类型的空白字符。 

选项按钮包括 : 

■ 

Do not ignore ( 不忽略 ) 

■ 

■ 

■ 

■ 

PVCS style (PVCS 样式 )。这与命令行的 stcmd diff -bpvcs 是等同的。比 

较文本文件的两个行时 , Visual Diff 忽略前导空白字符和尾随空白字符。例 

如 , 由于在 “hi” 和 “mom” 之间只有一个空格 , 所以以下两行是等同的 : 

" hi mom " 

" hi mom" 

但下面的行则不等同 : 

"hi mom" 

VSS style (VSS 样式 )。这与命令行的 stcmd diff -w 和 Window 客户机中 

的唯一选项 Ignore Whitespace ( 忽略空白字符 ) 是等同的。比较文本文件 

的两个行时 , Visual Diff 会忽略所有空白字符 ( 制表符和空格 )。例如 , 以 

下两行是等同的 : 

"a = ( b + 2);" 

"a=(b+2);" 

UNIX diff -b Style (UNIX diff -b 样式 ) 这与命令行的 stcmd diff -b 是等同 

的。比较文本文件的两行时 , Visual Diff 会忽略尾随的空白字符 , 并将所有 

其它空白字符串视为等长。例如 , 下面的两行相当 : 

" hi mom " 

" hi mom" 

Ignore end-of-line ( 忽略行尾 )。忽略行尾可比较不同平台上的文件 , 而不 

会将每一行都视为不同。对于 Windows 平台 , 行尾标记 (EOL) 是回车符与 

换行符的组合 , 对于 UNIX 平台 , 行尾标记是换行符 , 对于 Macintosh 文件 , 

行尾标记则因应用程序而异。它可以是传统的 Macintosh 回车符 , 也可能是 

UNIX 的换行符。 

3 单击 OK ( 确定 )。 


章 

管理文件 

第 8 章 

要使文件处于版本控制之下 , 可将文件添加到 StarTeam 项目视图。使文件处于版本控 

制之下后 , 团队成员便可签出文件 , 修订文件 , 然后签入新修订。StarTeam 保持着这种 

能力。 

StarTeam 保存有关每个文件修订的历史信息。并且 , 由于 StarTeam 具备链接功能 , 所 

以您可将一个文件修订链接到影响该文件或该文件的一个特定修订的其它项。 

可以对文件执行许多其它操作 , 例如移动文件或更改其分支行为。有关详细信息 , 请参 

阅第 223 页的 “ 执行一般性操作 ”。 

使用处于版本控制之下的文件 

如果一个文件位于 StarTeam 文件夹的工作文件夹中 , 则可将该文件添加到 StarTeam 

文件夹中。此操作使该文件处于版本控制之下。工作文件的一个副本将变为该文件的第 

一个修订 , 存储在 StarTeam 储存库中。如果以后删除工作文件 , 也不会丢失数据 , 因 

为储存库中有一个副本。每次签入该文件 ,StarTeam 都会在储存库中创建该文件的一个 

新修订。 

每次签出文件修订 , 都会将其内容复制到工作文件夹中。签出修订还确保您处理最新或 

特定的修订。例如 , 您可能需要团队成员对一个文件所做的最新更改 , 或者您可能已从 

硬盘驱动器中删除了工作文件 , 而现在需要另一个副本。 

以下是有关使用处于版本控制之下的文件的一些建议 : 

■ 

要使其他团队成员了解您打算对某个文件进行更改 , 请在签出过程中将锁定状态更改 

为独占。 

■ 

在签入过程中 , 可通过删除锁定状态的方式通知其他成员您已完成对该文件的更改 , 

他们可以签出该文件。 

■ 

■ 

如果您打算继续对该文件进行更改 , 但还要签入它以进行备份 , 请使文件保持锁定 

状态。 

如果两个团队成员同时更改同一个文本文件 , 或者一个成员更改过时的文件 , 则可使 

用合并选项将这些文件中的更改加以合并 , 这样便不会丢失任何工作。在此种情况 

下 ,StarTeam 将文件状态设置为 Merge( 合并 )。有关详细信息 , 请参阅第 161 页 

的 “ 合并文件 ”。 

第 8 章 : 管理文件 145

使用上部窗格中的文件列表 

■ 

要防止您自己更改您尚未锁定的文件 , 请选择 Mark Unlocked Working Files Readonly 

( 将解除锁定的工作文件标记为只读 ) 个人选项。然后 , 在您签出尚未锁定的文 

件时 , 工作副本便会变为只读。 

StarTeam 使您能够为视图中每一项的最新修订加上标签。例如 , 在项目达到某个特定里 

程碑 ( 例如 beta) 时 , 可以为视图的项加上标签 , 称为视图标签。然后 , 便可以将视图 

配置为返回到应用标签时的状态 , 使用标签将修订以组的形式签出 , 基于标签创建新视 

图 , 或者将标签分配到提升状态。有关详细信息 , 请参阅第 247 页的 “ 使用标签 ”。 

StarTeam 还有修订或版本标签。可在签入修订时为一个或多个修订加上标签 , 也可使用 

File ( 文件 ) 菜单中的 Labels ( 标签 ) 命令将标签应用于每一个修订。使用标签可以轻 

易地将文件以组的形式签出。 

一个文件修订可以有任何数量的标签。但是 , 相同视图中同一个文件的两个修订不能有 

相同的标签。 


All 

Descendants 

上部窗格中显示的文件取决于下列因素 : 

■ 

■ 

■ 

■ 

■ 

从左侧窗格内的文件夹层次中选择的 StarTeam 文件夹 

从上部窗格上方的 Filter ( 筛选器 ) 下拉列表中选择的筛选器 ( 有关详细信息 , 请参 

阅第 147 页的 “ 使用文件筛选器 ”) 

通过使用 All Descendants ( 所有后代 ) 按钮或从 File ( 文件 ) 菜单中选择 All 

Descendants ( 所有后代 ) 指定的深度 

对列表执行的排序、重排和查询操作 ( 有关详细信息 , 请参阅第 67 页的 “ 在上部窗 

格中管理数据 ”)。 StarTeam 按字母数字顺序对文件进行排序 , 不考虑大小写。 

使用文件夹的当前排除列表 ( 或继承的排除列表 ) 从显示中排除的文件 ( 有关详细 

信息 , 请参阅第 62 页的 “ 更改 StarTeam 文件夹名或说明 ”) 



从上部窗格中选择一个文件后 , 可对该文件执行某些操作 , 方法 : 从 File ( 文件 ) 菜单 

或上下文菜单中选择这些操作。例如 , 使用 StarTeam 菜单中的 File( 文件 )> Edit( 编 

辑 ) 可将该文件在记事本或备选编辑器中打开。此外 , 还可以执行以下操作 : 

■ 

双击可执行文件的名称以运行该文件。 

■ 

双击与应用程序关联的文件名称以在该应用程序中将其打开。 

在上部窗格中选择文件后 , 使用下部窗格中的选项卡查看或编辑文件属性。使用这些选 

项卡可以执行以下操作 : 

■ 

查看显示在上部窗格中的该文件的属性 ( 单击 Detail ( 详细信息 ) 选项卡 ) 

■ 

检查其修订历史 ( 单击 History ( 历史 ) 选项卡 ) 

■ 

编辑修订注释 ( 单击 History ( 历史 ) 选项卡 , 然后右键单击以显示上下文菜单 ) 

■ 

比较两个文件修订的内容 ( 单击 History ( 历史 ) 选项卡 , 然后右键单击以显示上下 

文菜单 ) 

■ 

在默认编辑器或适当的应用程序中查看所选文件修订的内容 ( 单击 History ( 历史 ) 

选项卡 , 然后右键单击以显示上下文菜单 ) 

■ 

查看为它创建的任何链接 ( 单击 Link ( 链接 ) 选项卡 ) 

( 通常 , 将一个文件链接到一个特定的文件夹、更改请求、任务、主题或另一个文 

件。) 

■ 

查看、附加和分离标签 ( 单击 Label ( 标签 ) 选项卡 ) 

■ 

查看所选文件的参考 ( 单击 Reference ( 参考 ) 选项卡 ) 

通过将文件拖动到新文件夹 , 可将文件从一个 StarTeam 文件夹、视图或项目移动到 

另一个 StarTeam 文件夹、视图或项目。 

可在按住 Ctrl 后将一个文件拖动到另一个文件夹 , 使该文件被共享。原始文件夹和接 

收文件夹均必须使用相同的 StarTeam Server 配置。 

■ 

■ 

单击一个列标题以根据该列中的值对显示的文件进行排序。可按数字、 ASCII、字母 

数字或内部关键字顺序的升序进行排序 , 具体排序方式将视数据而定。要将排序顺序 

从升序更改为降序 , 请再次单击标题 , 反之亦然。 StarTeam 在列标题中显示一个三 

角形。三角形的尖端将朝上 ( 升序 ) 或朝下 ( 降序 )。 

可重新排列字段、显示不同字段、对最多四个列进行排序、使用组带区和对上部窗格 

中的数据应用查询。可将对数据执行的操作保存为查询或筛选器。请参阅第 67 页的 

“ 控制列 ”、第 68 页的 “ 对数据排序和分组 ”、第 70 页的 “ 使用查询 ”、第 71 页 

的 “ 创建查询 ” 和第 78 页的 “ 使用筛选器 ”。 

■ 

按 Shift + F5 刷新整个视图 ( 所有选项卡及 StarTeam 文件夹层次中的所有项列表 )。 

按 F5 仅刷新上部窗格。按 Ctrl + F5 刷新上部窗格 , 同时折叠所有打开的组。按 F6 刷 

新外部存档 , 例如 VSS 和 PVCS。 

使用文件筛选器 

从 Filter ( 筛选器 ) 下拉列表框中选择一个筛选器 , 可以限制上部窗格中显示的文件种 

类和数量。有关创建您自己的筛选器的详细信息 , 请参阅第 78 页的 “ 使用筛选器 ”。 

第 8 章 : 管理文件 147

确定文件状态 

各 StarTeam 组件 ( 例如文件和更改请求 ) 的一组默认筛选器随 StarTeam 提供。但是 , 

根据贵公司的初始 StarTeam 版本以及您和您的团队成员对筛选器所做的更改 , 您可能 

无法看到下列所有 ( 或任何一个 ) 默认筛选器。 

 

 

Files In View ( 视图中的 

文件 ) 

Files Not In View ( 不在视 

图中的文件 ) 

Files To Check In ( 要签入 

的文件 ) 

Files To Check Out ( 要签 

出的文件 ) 

显示 StarTeam 文件夹 ( 其内容正在显示 ) 或其工作文件夹中存 

在的所有未排除的文件。 

将具有相同状态的文件形成一组 :Current ( 当前 )、 Missing 

( 缺失 )、 Modified ( 已修改 )、 Merge ( 合并 )、 Out Of Date 

( 过期 )、 Not In View ( 不在视图中 ) 或 Unknown ( 未知 )。 

显示工作文件夹内存在于当前项目视图中的文件。 

显示工作文件夹内不存在于当前项目视图中的文件。除非将这些 

文件添加到项目中 , 否则其名称决不会出现在项目文件列表中。 

显示视图中所有需要签入的文件。其状态为 Modified ( 已修 

改 )、 Merge ( 合并 ) 或 Not In View ( 不在视图中 )。 

显示视图中所有要签出的文件。其状态为 Out Of Date ( 过期 )、 

Missing ( 缺失 ) 或 Merge ( 合并 )。 

注 

在应用 Files To Check In ( 要签入的文件 ) 或 Files To Check Out ( 要签出的文件 ) 筛 

选器时 , StarTeam 将会列出需要合并的文件。 

确定文件状态 

文件状态决定着可对文件执行的操作 : 

Missing ( 缺失 ) 

Merge ( 合并 ) 

Modified ( 已修改 ) 

Out Of Date ( 过期 ) 

文件是 StarTeam 项目视图的一部分 , 但不在工作文件夹中。如 

果要将该文件置于硬盘驱动器上的工作文件夹中 , 则必须签出该 

文件。 

已更改工作文件 , 但并不是根据该文件的最新修订更改的。当您 

和另一个人同时处理一个文件 , 而此人在您之前签入文件时 , 通 

常会发生此类情况。当您签入该文件时 , 如果该文件是文本文 

件 , 则 Visual Merge 可调解工作文件和最新修订之间的差异。 

已更改工作文件 , 并且是基于该文件的最新修订进行更改的。您 

可能想要签入该文件以将最新修订置于 StarTeam 中。 

工作文件是该文件的旧修订的副本。如果需要最新修订 , 则应将 

其签出。 

Not In View ( 不在视图中 ) 文件在工作文件夹中 , 但不在 StarTeam 项目视图中。您可能想 

要将该文件添加到视图中。如果不再使用该文件 , 则您可能想要 

将其从工作文件夹中删除。 

Current ( 当前 ) 该文件的最新修订位于工作文件夹中。 

Unknown ( 未知 ) 工作文件夹内的文件与视图内的一个文件的名称相同 , 但是该文 

件并未从储存库中签出。您可能已从其它位置复制了该文件。使 

用 Update Status ( 更新状态 ) 可确定正确的状态。 


将文件添加到视图 


All 

Descendants 

如果文件在正确的工作文件夹中 , 可将文件添加到 StarTeam 文件夹。 

添加文件 : 

1 打开正确的视图。 

2 从文件夹层次中选择一个文件夹。 

3 从上部窗格中选择 File ( 文件 ) 选项卡。 

4 ( 可选 ) 单击工具栏上的 All Descendants ( 所有后代 ) 以显示位于所选父文件夹的 

子文件夹中的所有文件。 

5 从工具栏上的筛选器列表框中选择或 

Files Not In View ( 不在视图中的文件 ) 筛选器。 

如果选择了筛选器 , 则请单击 Not In 

View ( 不在视图中 ) 组前面的按钮来显示文件。 

Not In View ( 不在视图中 ) 状态被分配给工作文件夹内尚未添加到项目中 ( 因而尚 

未受到版本控制 ) 的每一个文件。 


■ 

分别选择要添加到项目中的文件。 

■ 

从 File ( 文件 ) 或上下文菜单中选择 Select ( 选择 ) > Select All ( 全选 ), 以同 

时选择所有文件。 

7 从 File ( 文件 ) 或上下文菜单中选择 Add Files ( 添加文件 )。出现 Add Files ( 添加 

文件 ) 对话框。 


■ 

在 File Description ( 文件说明 ) 文本框中输入所有文件的通用说明。 

■ 

选中 Prompt For Description For Each File ( 提示为每个文件输入说明 ) 复选框 , 

为每个文件写入单独的说明。 

9 从 Lock status ( 锁定状态 ) 组框中选择适当的选项按钮。使用 Exclusive ( 独占 ) 或 

Non-exclusive ( 非独占 ) 以您的名义锁定文件 , 或选择 Unlocked ( 解除锁定 ) 选项 

按钮 , 使文件在此时保持解锁状态。 

第 8 章 : 管理文件 149


其他团队成员可通过您所选择的锁定方式来了解您是否正在处理这些文件。独占锁定 

表示您打算更改文件。 

10 选中 Delete working files ( 删除工作文件 ) 将从工作站删除相关文件 , 而清除此框可 

将这些文件保留在工作文件夹中。在本练习中 , 请勿删除这些文件。 

11 如果贵公司实施了过程规则系统 , 则只有出于明确定义和批准的目的才能更改源代码 

和内容。必须将添加的所有文件链接到特定的过程项 ( 更改请求、需求或任务 )。 

可能会限制您只能将文件链接到一个特定类型的项或者多个具有特定状态的项。如果 

您拥有适当的访问权限 , 则可以选择 Project ( 项目 ) > Properties ( 属性 ), 然后使 

用 Process Rules ( 过程规则 ) 选项卡查看已选择了哪些规则。否则 , 此步骤为可选 

步骤 , 您可以选择任何更改请求、需求或任务作为过程项。 

要使新文件与特定的过程项相关联 , 请选中 Link and pin process item ( 链接并固定 

过程项 ) 复选框。 

a 如果已选择了活动过程项并且它出现在 Item ( 项 ) 框中 , 此操作将接受该项。 

b 如果尚未选择任何过程项 , 或者您想要选择另一不同的过程项 : 

1 单击 Select ( 选择 ) 按钮以打开 Select Process Item ( 选择过程项 ) 对话框。 

2 选择 List all permitted items ( 列出所有允许项 ) 或 List all permitted items 

assigned to me ( 列出分配给我的所有允许项 ) 选项按钮。 

3 选择 Change Request ( 更改请求 )、 Requirement ( 需求 ) 或 Task ( 任务 ) 

选项卡。 

4 选择特定项作为活动过程项。 

12 单击 OK ( 确定 ) 返回到 Add Files ( 添加文件 ) 对话框。 

13 如果活动过程项上的工作现已完成 , 请选中 Mark selected process item as fixed/ 

finished/complete ( 将所选过程项标记为已修复 / 结束 / 完成 ) 复选框。 

如果将更改请求标记为 Fixed ( 已修复 ), 则默认工作流将立即更改与输入更改请求 

的用户名称相关联的责任。 

如果添加的是多个文件 , 而并非所有添加操作都取得了成功 , 则不会将过程项标记为 

已修复、结束或完成。如果选择了禁用 ( 只读 ) 需求 , 则不能将其标记为完成。 

应清楚 : 将更改请求标记为 Fixed ( 已修复 ) 会立即更改与输入更改请求的用户名称 

相关联的责任。 

14 从 Revision label ( 修订标签 ) 下拉组合框中选择一个标签 , 或者通过输入名称创建 

一个新修订标签。如果计划以后将这些文件作为一个组来检索 , 或者将来需要这些文 

件的特定修订 , 则添加或创建标签将会非常有用。 

现有标签基于其创建时间按相反的时间顺序列出。 

15 如果使用的是 Windows 客户机 , 请单击 OK ( 确定 ) 添加这些文件。 


查看或设置可执行位 

16 如果使用的是 Cross-Platform 客户机 , 则您还可以使用其它一些选项。访问这些选项 : 

a 单击 Advanced( 高级 )。此操作将显示 Advanced Options( 高级选项 ) 对话框。 

虽然此对话框中的所有选项均非必需 , 但在某些特定情况下 , 它们很有用。 

b 

选中 Perform EOL conversion (CR-LF) ( 执行 EOL 转换 (CR-LF)) 复选框 , 以控 

制随这些文件存储的 EOL 字符。此复选框的默认设置取决于 Personal Options 

( 个人选项 ) 中的 EOL 设置。 

c 从下拉列表框中选择适当的 File Encoding ( 文件编码 )。 

d 单击 OK ( 确定 ) 以返回 Add Files ( 添加文件 ) 对话框。 

e 单击 OK ( 确定 ) 添加文件。 

将新文件添加到 StarTeam 后 , 这些文件的状态将从 Not In View( 不在视图中 ) 更改为 

Current( 当前 )( 除非您删除工作文件 , 这样一来这些文件的状态便会变为 Missing( 缺 

失 ))。 

根据所选的筛选器 , 所选文件的名称将从上部窗格中消失 , 或者只是将其状态更改为 

Current ( 当前 )。例如 , 如果使用 Files Not In View ( 不在视图中的文件 ) 筛选器 , 则 

可选择 Files In View ( 视图中的文件 ) 筛选器再次显示文件名称。 

提示可通过单击工具栏上的 Add Files ( 添加文件 ) 来添加文件 , 而不使用 Add Files 

( 添加文件 ) 对话框。 

查看或设置可执行位 

注 

从 UNIX 操作系统添加文件时 , Cross-Platform 客户机将保存可执行位的状态。对于每 

个文件 , 如果设置可执行位 , 则 Executable ( 可执行 ) 复选框将变为选中状态 ; 如果未 

设置可执行位 , 则该复选框将变为清除状态。将来的签出操作将确保签出文件的可执行 

位与 Executable ( 可执行 ) 复选框的设置相匹配。 

查看或更改可执行位的状态 : 

1 从上部窗格中选择一个文件。 

2 从菜单栏中选择 File ( 文件 ) > Properties ( 属性 )。 

3 从随即显示的 File Properties ( 文件属性 ) 对话框中查看、选中或清除 Executable 

( 可执行 ) 复选框。 

可以从 StarTeam Windows 客户机查看和设置 “ 可执行位 ”, 但使用 Windows 客 

户机签出文件对它没有任何影响 , 只有使用 Cross-Platform 客户机签出文件才会 

影响它。 

从 StarTeam 打开文件 

双击文件名时 , StarTeam 将执行下列操作之一 : 

■ 

如果文件是可执行文件 ( 例如 autoexec.bat), 则运行该文件。 

■ 

如果文件不是可执行文件 , 且没有与之相关联的应用程序 , 则显示一条错误消息。 

第 8 章 : 管理文件 151

从 StarTeam 编辑文件 

■ 

在关联的应用程序中打开文件。例如 ,.doc 文件将在 Microsoft Word for Windows 中 

打开。但是 , 只有在所选文件的扩展名存在与之关联的 “ 打开 ” 操作文件时 , 这才会 

起作用。 

可以通过多种方式将文件与应用程序相关联 , 其中包括 : 

■ 

从 Windows 资源管理器中 , 选择 “ 查看 ” > “ 选项 ”, 然后使用 “ 文件类型 ” 选 

项卡创建或编辑一种类型。 

■ 

从 Windows 资源管理器中 , 选择一个文件 , 在按住 Shift 键的同时右键单击 , 然后 

从上下文菜单中选择 “ 打开方式 ”。 

如果上下文菜单显示 “ 使用记事本打开 ” 或者 “ 打开 ”( 后跟某些其它特定的应 

用程序 ), 则这将与 “ 打开 ” 操作文件关联不同。相反 , 它是 “ 使用记事本打开 ” 

操作 , 不能与 StarTeam 一起工作。 

要从 StarTeam 打开文件 , 请执行以下操作之一 : 

■ 

双击上部窗格中的文件名。 

■ 

从上部窗格中选择文件 , 然后选择 File ( 文件 ) > Open ( 打开 )。 

如果文件未打开 , 则可能还没有为适当的编辑器创建关联。 

选择适当的编辑器 : 

1 如果正在尝试打开的文件并未启动 , 则会显示 Edit File Type( 编辑文件类型 ) 对话框。 

2 单击 Edit ( 编辑 )。该操作将显示 Folder Options ( 文件夹选项 ) 对话框。 

3 单击 File Types ( 文件类型 ) 选项卡。 

4 在此选项卡上 , 单击 Advanced ( 高级 ) 以更改该类型文件的设置。 

5 在 Editing Action for Type xx ( 编辑 xx 类型的操作 ) 对话框中 , 确认操作是 Open 

( 打开 ), 并指定用于打开文件的应用程序的位置。 

6 单击 OK ( 确定 )。 

从 StarTeam 编辑文件 

可在默认编辑器 ( 记事本 ) 或备选编辑器中 , 从 StarTeam 显示文件。如果文件是可执 

行文件 ( 例如 .bat 文件 ), 或者文件没有关联的应用程序 , 则必须使用 Edit ( 编辑 ) 命 

令从 StarTeam 编辑文件。 

在默认编辑器中编辑文件 : 


2 选择 File( 文件 )> Edit( 编辑 )。除非按照第 310 页的 “ 设置文件选项 ” 中所述的 

方法设置备选编辑器 , 否则文件将在默认编辑器 ( 记事本 ) 中打开。 

使用工作站上记事本以外的编辑器 : 

1 从菜单栏中选择 Tools ( 工具 ) > Personal Options ( 个人选项 ) 。出现 Personal 

Options ( 个人选项 ) 对话框。 

2 选择 Files ( 文件 ) 选项卡。 

3 单击 Alternate Applications ( 备选应用程序 ) 按钮。 

4 在随即显示的 Alternate Applications ( 备选应用程序 ) 对话框中 : 

a 选中 Editor ( 编辑器 ) 复选框。 

b 为备选编辑器指定可执行文件。 

c 单击 OK ( 确定 )。 

5 单击 OK ( 确定 )。 


更新文件状态 

更新文件状态 

签入文件 

要在签入或签出文件前检查文件的状态 , 请使用 Update Status ( 更新状态 ) 选项。该 

选项将工作文件夹中的每个文件与签出修订和最新修订进行比较。例如 , 上部窗格显示 

文件的状态为 Current( 当前 ), 但是其他人可能刚刚签入文件的一个副本 , 因此文件状 

态实际上是 Out Of Date ( 过期 )。 

重要说明 

■ 

Update Status ( 更新状态 ) 选项不会签入或签出文件。例如 , 如果文件不在工作 

文件夹中 , 则更新状态将仅仅告诉您文件状态被设为 Missing ( 缺失 )。 

■ 

Update Status ( 更新状态 ) 选项不合并文件。例如 , 如果文件状态在状态更新之 

前被设为 Current ( 当前 ), 然后被设为 Merge ( 合并 ), 则更新状态不会合并文 

件 ( 有关详细信息 , 请参阅第 127 页的 “ 使用 Visual Merge”)。 

与上部窗格的刷新不同 , Update Status ( 更新状态 ) 选项仅使用 MD5 校验和。刷新可 

使用时间戳 ( 和大小 ) 或校验和 , 这将视已设置的个人文件选项而定。有关详细信息 , 

请参阅第 310 页的 “ 设置文件选项 ”。 

更新文件状态 : 

1 从上部窗格中选择一个或多个文件。 

2 从 File ( 文件 ) 或上下文菜单中选择 Update Status ( 更新状态 )。 

如果上部窗格中当前显示的状态不正确 , 则 StarTeam 将会更改它。 

签入工作文件时 , StarTeam Server 将创建一个新的最新修订。 

签入文件 : 

1 在上部窗格中 , 选择一个或多个文件。 

如果选择状态为 Not In View ( 不在视图中 ) 的文件 , 并且文件已经在 StarTeam 的 

控制之下 , 则在签入操作过程中会将状态为 Not In View ( 不在视图中 ) 的文件添加 

到视图。 

2 从菜单栏或上下文菜单中选择 File( 文件 )> Check In( 签入 )。出现 Check In( 签 

入 ) 对话框。 

第 8 章 : 管理文件 153

签入文件 

3 在 Comment ( 注释 ) 文本框中说明对文件所做的更改。( 如果签入多个文件 , 还可 

以选中 Prompt for a comment (check-in reason) for each file ( 提示输入每个文件的 

注释 ( 签入原因 )) 复选框。) 

4 ( 可选 ) 要将所签入的文件与该文件在储存库中的最新修订进行比较 , 请单击 

Compare ( 比较 ) 按钮。如果存在差异 , 此操作将启动 Visual Diff ( 一个显示文件更 

改的实用程序 )。 

5 要在签入文件后释放您在其上所加的锁 , 请从 My Lock Status( 我的锁定状态 ) 组框 

中选择 Unlocked ( 解除锁定 ) 。如果已锁定文件并想使其保持锁定状态 , 请选择 

Keep Current ( 保持现状 )。 

6 ( 可选 ) 如果想要签入比最新修订旧的文件 , 请选择 Force check-in ( 强制签入 )。 

7 如果需要 , 请选中 Delete working files ( 删除工作文件 ) 复选框以从工作站上的工作 

文件夹中删除这些文件 , 并只将其存储在 StarTeam 储存库中。清除此复选框不仅会 

将这些文件保留在工作文件夹中 , 而且还会将其存储在储存库中。 

8 ( 当实施了过程项时为必需步骤 ) 要将文件修订链接到某个过程项 , 请选中 Link and 

pin process item ( 链接并固定过程项 ) 复选框。如果要求使用过程项 , 则默认情况 

下会选中此复选框。 

a 如果某个活动过程项已出现在 Item ( 项 ) 框中 , 此操作将接受该项。 

b 如果尚未选择任何过程项 , 或者您想要选择另一不同的过程项 : 

1 单击 Select ( 选择 ) 按钮以打开 Select Process Item ( 选择过程项 ) 对话框。 

2 选择以下选项之一 :List linked items ( 列出链接项 )、 List all permitted items 

( 列出所有允许项 ) 或 List all permitted items assigned to me ( 列出分配给我 

的所有允许项 )。 

3 选择 Change Request ( 更改请求 )、 Requirement ( 需求 ) 或 Task ( 任务 ) 

选项卡。 

4 选择特定项作为活动过程项。 

5 单击 OK ( 确定 ) 返回到 Check In Files ( 签入文件 ) 对话框。 

9 ( 可选 ) 从 Revision label ( 修订标签 ) 下拉组合框中选择一个标签 , 或者通过输入 

名称创建一个新修订标签。现有标签基于其创建时间按相反的时间顺序列出。 

请记住 , 不能对同一文件的两个修订使用同一标签。因此 , 如果要使用的标签当前 

与先前的修订相关联 , 则还必须选中 Move the label if it's already assigned to a 

previous revision ( 如果已将标签分配给先前修订则移动它 ) 复选框。 

10 如果使用的是 Windows 客户机 : 

a 

单击 Show Change Requests( 显示更改请求 ), 以查看已链接到所要签入文件的 

更改请求。 

b 单击 OK ( 确定 ) 签入这些文件。 


签入文件 

11 如果使用的是 Cross-Platform 客户机 , 则您还可以使用其它一些选项。访问这些选项 : 

a 单击 Advanced( 高级 )。此操作将显示 Advanced Options( 高级选项 ) 对话框。 

b ( 可选 ) 选中 Perform EOL conversion (CR-LF) ( 执行 EOL 转换 (CR-LF)) 复选 

框 , 以控制随这些文件存储的 EOL 字符。此复选框的默认设置取决于 Personal 

Options ( 个人选项 ) 中的 EOL 设置。 

c 在下拉列表框中 , 选择适当的 File encoding ( 文件编码 )。 

d 

需要时 , 单击 Show Change Requests( 显示更改请求 ), 以查看已链接到所要签 

入文件的更改请求。 

e 单击 OK ( 确定 ) 返回 Check In ( 签入 ) 对话框。 

f 单击 OK ( 确定 ) 签入这些文件。 

过程项和 Show Change Requests ( 显示更改请求 ) 按钮很少同时使用。这两种方法的 

差别是 : 

■ 

■ 

一个使用现有链接 , 而另一个则创建链接。对于 Show Change Requests( 显示更改 

请求 ), 不创建任何其它链接。对于过程项 , 在签入过程中创建链接。创建或更新每 

个文件与所选更改请求之间的链接。 

对于 Show Change Requests( 显示更改请求 ) 按钮 , 链接目标可以固定或浮动。对 

于过程项 , 链接目标被固定到特定的修订。 

■ 

如果将更改请求标记为已修复 , 则 : 

■ 

■ 

对于过程项 , StarTeam 将创建过程项与状态为 Fixed ( 已修复 ) 的更改请求的修 

订之间的链接。 

对于 Show Change Requests ( 显示更改请求 ) 按钮 , 更改请求将被标记为已修 

复 , 但在任何情况下都不会更改链接。如果链接与更改请求之间的连接从一个修订 

浮动到另一个修订 , 则现在它将被连接到更改请求的新修订。如果它已被固定到该 

更改请求的某个修订 , 则它现在仍然被固定到该处。 

提示单击工具栏上的 Check In ( 签入 ) 或 Check In And Unlock ( 签入并解除 

锁定 ) 以签入文件而不使用 Check In ( 签入 ) 对话框。如果需要过程规 

则 , 则无论如何都会打开该对话框。 

可通过右键单击列标题和使用 Sort and Group ( 排序和分组 ) 对话框 , 对更改请求进行 

排序和分组。单击单个标题可根据该列的内容对请求进行排序。 

第 8 章 : 管理文件 155

签出修订 

签出修订 

Check 

Out 

在签出一个文件时 , StarTeam 将该文件的请求的修订复制到相应工作文件夹中。 

如果在工作文件夹中已经有该文件的副本 , 则除非工作文件看起来比签入修订更新 , 否 

则签入修订将覆盖工作文件。然后 , 请求您确认签出。 

例如 , 如果您签出一个文件 , 编辑该文件 , 决定不要对该文件所做的编辑 , 然后再次签 

出该文件 , 则会请求您确认签出。 

提示使用 All Descendants ( 所有后代 ) 按钮 , 从文件夹层次中选择文件。( 也可从 

File ( 文件 ) 菜单中选择 All Descendants ( 所有后代 )。) 

使用 File ( 文件 ) 或上下文菜单中的 Check Out All ( 全部签出 ), 可签出所选文件夹及 

其后代文件夹中的所有文件。其作用等同于 : 选择 All Descendants ( 所有后代 ), 选择 

上部窗格中的所有文件 , 然后选择 Check Out ( 签出 ) 。使用 Check Out All ( 全部签 

出 ) 命令时 , 将出现确认对话框 , 而不管个人选项的设置是否需要确认。 

快速签出最新修订 : 

1 从上部窗格中选择一个或多个文件。 


■ 

单击工具栏上的 Check Out ( 签出 )( 黑箭头 )。 

■ 

单击工具栏上的 Check Out and Lock ( 签出并锁定 )( 红箭头 )。 

Check 

Out and 

Lock 

其中的任何一项操作都会将最新修订复制到工作文件夹中。 

使用 Check Out ( 签出 ) 对话框签出文件 : 


■ 

从上部窗格中选择一个或多个文件 , 然后从 File ( 文件 ) 或上下文菜单中选择 

Check Out ( 签出 )。 

■ 

从 File ( 文件 ) 或上下文菜单中选择 Check Out All ( 全部签出 )。 

出现 Check Out ( 签出 ) 对话框。 

2 ( 可选 ) 选择 Force Check-out ( 强制签出 ) 以覆盖所有工作文件 , 即使工作文件比 

StarTeam 储存库中的文件更新。 


签出修订 

3 选择以下选项之一 : 

■ 

Current Revision ( 当前修订 ), 签出每个所选文件的最新修订。 

■ 

Label ( 标签 ) , 签出具有特定视图或修订标签的每一个所选文件的修订。( 如果 

所选文件没有标签 , 则不会签出该文件的任何修订。) 从 Label ( 标签 ) 下拉列表 

框中选择标签。 

现有的视图和修订标签基于其创建的时间按相反的时间顺序列出。在列表中 , 视图 

标签列在修订标签之前。 

■ 

Promotion State( 提升状态 ), 签出具有特定提升状态的每一个所选文件的修订。 

实际上 , 这些修订的视图标签当前已被分配给该提升状态。 

■ 

As Of ( 截止于 ), 签出在指定日期和时间为最新修订的修订。 

1 单击日期和时间之间的按钮以使用日历。 

2 使用下个月和上个月按钮及箭头键来指定日期。 

3 要指定时间 , 请输入时间或使用旋钮框。 

4 选择 My Lock Status ( 我的锁定状态 ) 选项按钮之一 , 或选择 Keep Current ( 保持 

现状 ) 以保持每个文件的当前锁定状态。 

5 要访问其它不常使用的选项 , 请单击 Advanced ( 高级 )。将出现 Advanced Options 

( 高级选项 ) 对话框。 

a 可将文件签出到指定工作文件夹以外的其它文件夹 : 

b 

1 选择 Other ( 其它 ) 选项按钮。 

2 为签出文件输入或浏览新文件夹。 

选择一个选项按钮 , 指示签出的文本文件的相应 EOL 字符。这些选项包括 None 

( 无 )、 CR-LF、 LF 或 CR。 

对于 Windows,EOL 字符为 CR-LF( 回车 / 换行 ); 对于 UNIX,EOL 字符为 LF 

( 换行 ); 对于某些其它操作系统 , EOL 字符为 CR ( 回车 )。 

对于 Windows 客户机 , 默认设置基于从中签出文件的文件夹的 EOL 设置。请参阅 

第 63 页的 “ 为其它操作系统文件创建 StarTeam 文件夹 ”。 

对于 Cross-Platform 客户机 , 默认设置基于个人选项中的 EOL 设置 ( 有关详细信 

息 , 请参阅第 312 页 )。 

Cross-Platform 客户机的默认文件编码是在个人选项中设置的 , 但是可在此处更改 

某个特定的签出操作的默认文件编码。 

c 单击 Close ( 关闭 ) 返回到 Check Out ( 签出 ) 对话框。 

第 8 章 : 管理文件 157

签出修订 

提示 

6 单击 OK ( 确定 ) 以退出 Check Out ( 签出 ) 对话框。 

将文件签出到指定文件夹。如果这些文件是文本文件 , 并且您已改写了 EOL 字符 , 则 

这些文件的 EOL 字符将被转换为指定的字符或字符组合。 

7 如果使用了 Check Out All( 全部签出 ) 命令 , 请在确认对话框出现时单击 Yes( 是 )。 

可调整 Check Out( 签出 ) 对话框的大小。例如 , 如果标签名称较长 , 无法在 Label 

( 标签 ) 文本框中看到整个名称 , 则可拖动对话框的一个边将对话框扩大。 

按修订号签出单个文件的任何先前修订 : 

1 通过执行以下操作来显示历史列表 : 

a 从上部窗格中选择文件名称。 

b 选择下部窗格下方的 History ( 历史 ) 选项卡。 

2 选择要签出的修订。 


■ 

从 History ( 历史 ) 上下文菜单中选择 Check Out ( 签出 )。 

■ 

从 History ( 历史 ) 上下文菜单中选择 Check Out To ( 签出至 )。 

选择 Check Out To ( 签出至 ) 时 , 可使用一个不同的文件名和 / 或一个不同的路 

径签出文件。将出现 History Check Out ( 历史签出 ) 对话框。 

a 更改文件名或路径 : 

b 

1 选择 Other ( 其它 ) 选项按钮。 

2 为签出文件输入或浏览新路径和 / 或名称。 

如果该文件是文本文件 , 请选择一个指示相应 EOL 字符的选项按钮。这些选项包 

括 None ( 无 )、 CR-LF、 LF 或 CR。 

c 单击 OK ( 确定 ) 以退出 History Check Out ( 历史签出 ) 对话框。 

将文件签出到具有指定名称的指定文件夹。如果该文件是文本文件 , 并且您已改写了 

EOL 字符 , 则 EOL 字符将被转换为指定的字符或字符组合。 


了解状态对签入和签出的影响 

了解状态对签入和签出的影响 

在签出文件过程中 ,StarTeam 将文件修订从储存库复制到工作文件夹。签入文件会将新 

修订置于储存库中。在许多情况下 , 文件状态会对签入或签出过程产生影响。 

下表概述了文件状态与 StarTeam 的签入和签出操作之间的关系。成功的签入或签出操 

作会将工作文件的状态更改为 Current( 当前 )( 除非在操作过程中签出了历史修订或删 

除了工作文件 )。 

表 8.1 

状态对签入和签出操作的影响 

状态签入签出 

Current 

( 当前 ) 

Merge 

( 合并 ) 

Missing 

( 缺失 ) 

Modified 

( 已修改 ) 

Not In View 

( 不在视图 

中 ) 

Out Of Date 

( 过期 ) 

Unknown 

( 未知 ) 

无需要考虑的事项。无需要考虑的事项。 

启动 Visual Merge ( 除非强制签 

入 )。 

Merge ( 合并 ) 状态表示在您上次 

签出该文件之后其他人签入了该文 

件。您的工作文件中不会有其他人 

所做的更改 , 而其他人的工作文件 

中却有其自己所做的更改。 

不适用。 

如果一个文件的状态为 Missing 

( 缺失 ), 则该文件不在工作文件夹 

中 , 因此不存在可以签入的文件。 

无需要考虑的事项。 

除非其他人锁定了该文件 , 否则您 

可以将其签入。 

不适用。 

不能签入状态为 Not in View ( 不 

在视图中 ) 的文件。可以使用 Add 

Files ( 添加文件 ) 命令将其添加 

到项目中。 

除非强制执行 , 否则不允许签入。 

如果签入一个 Out Of Date ( 过 

期 ) 文件 , 则将意味着 : 自工作副 

本变为 Out Of Date ( 过期 ) 后 , 

最新修订中将不再具有对该文件所 

做的更改。 

除非强制执行 , 否则不允许签入。 

如果文件状态是 Unknown ( 未 

知 ), 则该操作的结果也未知。工 

作文件变为储存库中的最新修 

订。使用 Update Status ( 更新状 

态 ) 和 MD5 校验和查看能否确定 

文件。 

如果此方法不成功 , 您可能想要将 

工作文件与最新修订进行比较。 

除非强制执行 , 否则不允许签出。 

如果签出该文件 , 您的更改将会丢失。 

提示 : 可以使用创建该文件的应用程序 

( 例如 Word for Windows) 将最新修订和 

工作文件合并。如果文件是文本文件 , 请 

尝试签入操作。 


如果一个文件的状态为 Missing ( 缺 

失 ), 则打开该文件时将询问您是否要签 

出该文件。也可将文件手动签出。 


除非其他人锁定了该文件 , 否则您可以将 

其签入。 

不适用。 

状态为 Not in View( 不在视图中 ) 的文件 

不在储存库中 , 因此没有要签出的文件。 


签出 Out Of Date ( 过期 ) 文件将使工作 

文件变为 Current ( 当前 ) 文件。 

如果将文件与最新修订合并 , 则允许签 

出。但是 , 由于将最初的修订用作此次合 

并的祖先文件 , 所以很可能会更改许许多 

多的内容或者造成冲突。您可能更喜欢强 

制签出 ( 或强制签入 )。 

如果文件状态是 Unknown ( 未知 ), 则 

该操作的结果也未知。工作文件将被储存 

库中的最新修订所覆盖。使用 Update 

Status ( 更新状态 ) 和 MD5 校验和查看 

能否确定文件。 

如果此方法不成功 , 您可能想要将工作文 

件与最新修订进行比较。 

第 8 章 : 管理文件 159

查看修订内容 

查看修订内容 

比较文件内容 

可在默认编辑器 ( 默认情况下 , 编辑器是记事本 ) 或文件类型注册的 Windows 应用程 

序中查看历史文件修订的内容。 

查看修订内容 : 



b 选择视图窗口的下部窗格下面的 History ( 历史 ) 选项卡。 

2 选择历史列表中的修订并右键单击。打开 History ( 历史 ) 上下文菜单。 


■ 

■ 

单击 View Revision Content ( 查看修订内容 )。单击此命令将修订复制到临时文 

件 , 并在默认编辑器 ( 记事本或个人选项中指定的备选编辑器 ) 中显示临时文件。 

单击 Open Revision Content ( 打开修订内容 )。单击此命令将修订复制到临时文 

件 , 并在适当的应用程序中显示临时文件。 

Compare 

Contents 

可在文本文件和 / 或文本文件修订之间进行下列任何一种内容比较。由 Visual Diff 执行 

比较。 

比较文件的两个修订 : 

1 通过执行以下两项操作来显示历史列表 : 



2 从历史列表中选择文件的两个修订。 


■ 

单击工具栏上的 Compare Contents ( 比较内容 )。 

■ 

从 History ( 历史 ) 上下文菜单中选择 Compare Contents ( 比较内容 )。 

StarTeam 区分程序 Visual Diff 将显示这两个修订 , 并用不同颜色指出差异。 

4 从 Visual Diff 菜单栏中选择 File ( 文件 ) > Exit ( 退出 ) 以返回 StarTeam。 

将修订与工作文件进行比较 : 

1 通过执行以下两项操作来显示历史列表 : 



2 从历史列表中选择文本文件的一个修订。 


■ 

单击工具栏上的 Compare Contents ( 比较内容 ) 。 

■ 

从 History ( 历史 ) 上下文菜单中选择 Compare Contents ( 比较内容 )。 

Visual Diff 将显示这两个文件。 



合并文件 

比较两个工作文件 ( 都是文本文件 ): 


2 选择上部窗格下方的 File ( 文件 ) 选项卡。上部窗格将出现在该窗格中。 

3 从上部窗格中选择两个文本文件。 


■ 


■ 

从 File ( 文件 ) 或上下文菜单中选择 Compare Contents ( 比较内容 )。 



将工作文件夹中的文本文件与其最新修订进行比较 : 



■ 


■ 

从 File ( 文件 ) 或上下文菜单中选择 Compare Contents ( 比较内容 )。 

注 



有关 Visual Diff 应用程序的搜索差异及其它功能的信息 , 请参阅第 125 页的 “ 使用 

Visual Merge 和 Visual Diff”。 

也可使用 Visual Diff 比较二进制文件 , 但是在创建二进制文件的应用程序中比较二进 

制文件效率会更高一些。如果您只是需要知道这些文件是否相同 , 则 Visual Diff 可以 

轻松而高效地完成此项任务。 

合并文件 

在 StarTeam Windows 客户机中 

注 

StarTeam 提供文件锁定和通信工具 , 可帮助防止在团队成员同时处理文件时可能发生 

的文件间冲突。但是 , 这不可能总是能够防止此类情况的发生。例如 : 

■ 

一个团队成员可能未将文件锁定便开始进行更改 , 不料等他 ( 她 ) 意识到的时候却已 

经太迟了 , 因为另一个团队成员已经将该文件锁定并且也进行了更改。 

■ 

不在现场工作的团队成员可能会更新过期的文件 , 却不知道储库存中已存有该文件的 

新修订。 

对于文本文件 , Visual Merge 实用程序可帮助将这两个文件组合起来 , 这样便不会丢失 

任何工作。该实用程序将工作文件与最新修订进行合并 , 方法 : 将它们与其所基于的修 

订 ( 即 , 已被签出以创建工作文件的修订 ) 进行比较。 

对于二进制文件 ,Visual Merge 只能指出这些文件是相同的还是不同的。您可选择将 

文件的两个修订中的哪一个修订用作 “ 合并 ” 文件。 

由于合并功能可以解决多个用户处理一个文本文件时所发生的多数问题 , 所以您不必为 

了防止发生此类问题而始终独占锁定这些文件。 

第 8 章 : 管理文件 161

合并文件 

如果文件的状态为 Merge ( 合并 ) , 则 StarTeam 将在签入或签出过程中启动 Visual 

Merge。下面的步骤将说明这一过程。 

在签入或签出过程中合并文件 : 

1 签入或签出文件 ( 如果需要更多信息 , 请参阅第 153 页的 “ 签入文件 ” 或第 156 页 

的 “ 签出修订 ”)。 

StarTeam 将显示与下图类似的消息框 : 

重要说明 

如果文件是二进制文件 , 则最好停止此项操作。可将最新的签入文件签出到另一个 

位置 , 然后在适当的编辑器中比较这两个文件。例如 , 可使用 Microsoft Word for 

Windows 比较两个 .doc 文件。 

2 单击 Yes ( 是 )。然后 , Visual Merge 将执行三方面的比较。 

接下来该如何操作将取决于下列情况 : 

■ 

为工作站设置的 Visual Merge 选项。例如 , Visual Merge 主窗口可能始终打开 , 

或者只有在两个文本文件修订之间发生冲突时才会打开 ( 有关详细信息 , 请参阅 

第 168 页的 “ 设置文件选项 ”)。 

■ 

文件是文本文件还是二进制文件 

对于文本文件 , 可使用 Visual Merge 主窗口查看由 Visual Merge 创建的合并文件 

并对其进行编辑。 

对于二进制文件 , 可使用 Visual Merge 在工作文件和最新修订之间进行选择。 

3 如果 Visual Merge 窗口打开 : 

a 

b 

c 

d 

有关解决文本文件冲突等的信息 , 请参阅第 125 页的 “ 使用 Visual Merge 和 

Visual Diff”。 

从 Visual Merge 菜单栏中选择 File ( 文件 ) > Exit ( 退出 ) 以返回 StarTeam。 

StarTeam 将询问您是否已解决所有冲突以及是否要保存文件。它可能只询问是否 

要保存文件。 

单击 Yes ( 是 ) 以使用合并文件替换工作文件。工作文件的状态将从 Merge ( 合 

并 ) 更改为 Modified ( 已修改 )。 

4 如果文件是二进制文件 , 并且打开的对话框与下图类似 : 

a 

从 Merge Results ( 合并结果 ) 列表框中选择 Use Source Contents ( 使用源内 

容 ) 或 Use Target Contents ( 使用目标内容 )。 

b 单击 OK ( 确定 )。接下来执行何种操作将取决于您是签入文件还是签出文件。 

c 

如果选择了 Use Source Contents ( 使用源内容 ), 则该文件的最新修订将被复制 

到工作站中。工作文件的状态将从 Merge ( 合并 ) 更改为 Current ( 当前 )。 


合并文件 

d 

如果选择了 Use Target Contents ( 使用目标内容 ), 则工作文件的状态将会因为 

该文件被视为合并文件而从 Merge ( 合并 ) 更改为 Modified ( 已修改 )。 

e 如果是签出文件 , 则应立即终止操作。您有合并文件要处理。 

f 如果是签入文件 , 则会打开一个与下图类似的消息框。 

g 单击 Yes ( 是 ) 签入合并文件。 

在 StarTeam Cross-Platform 客户机中 

在 StarTeam Cross-Platform 客户机中 , 只有在签出文件时才能合并文件。如果不使用 

备选的合并实用程序 , 则 StarTeam 将以合并格式显示这两个文件 , 您可以滚动查看和 

编辑它们。 

有冲突的部分将会被标记。例如 , 下面的部分显示第一个冲突 : 

> C:\StarDraw\Source Code\Starvw.cpp, Branch Revision: 1.5 

以多个尖括号 > 开始的行将标识这两个文件并将冲突与文件的其它 

部分分开。 

其中 , 一个文件包含 “MFC C++”, 而另一个文件则包含 “This is a part of the Microsoft 

foundation Classes C++ library”。您可以编辑文件 , 使其包含一行、另一行或者两行都 

包括 , 只要适合即可。 

在本例中 , 冲突中只有一行 , 但是一个冲突中可以有许多行和许多冲突。 

第 8 章 : 管理文件 163

在文件中使用关键字 

根据为文件设置的个人选项 , 此对话框可在以下条件下显示 : 只要存在任何种类的差异 , 

或者仅当冲突是由差异所导致时。 

如果差异不造成冲突 , 则差异在合并文件中的显示形式与其在其所在的文件中的显示形 

式相同。在本例中 , 以 “This source code is only intended...” 开始并以 “Microsoft 

Foundation Classes product.” 结束的行仅存在于本地文件中。这在任何情况下都不会 

被特别标记为差异。 

如果在签出前进行比较 , 则可使用 Visual Diff 或备选的比较实用程序查看该差异。 

将工作文件与现有修订合并 : 

1 从上部窗格中选择该文件。其状态将为 Merge ( 合并 )。 

2 选择 File ( 文件 ) > Check Out ( 签出 )。出现 Check Out ( 签出 ) 对话框。 

3 选择最新 ( 当前 ) 修订或另一个修订 ( 按其标签、提升状态或日期 / 时间 )。 

4 单击 OK ( 确定 )。 

StarTeam 询问您是否将修订与工作文件合并。 

5 单击 Yes ( 是 )。 

StarTeam 将通知您文件中是否包含冲突。是否出现合并实用程序取决于差异或冲突 

( 这将视文件的个人选项设置而定 )。 

6 如果出现合并实用程序 , 则 : 

a 编辑合并文件。 

b 如果使用的是 StarTeam 提供的合并实用程序 , 则 : 

1 选择 File ( 文件 ) > Exit ( 退出 )。 

2 单击 Yes ( 是 ) 保存文件。 

合并文件变为工作文件。 

注从历史窗格中签出文件可覆盖具有所选修订的工作文件。 


如果管理员启用关键字扩展作为项目属性 , 则可将关键字嵌入项目文本文件中。在文件 

签出期间 , 系统将自动扩展关键字 , 以在文件中提供文件和修订信息。建议每行只使用 

一个关键字。关键字可用于纯文本文件 , 但在采用丰富文本格式的文件中不支持。不能 

为 Unicode 文件扩展关键字。 

注意切勿在修订注释中使用关键字 , 因为在关键字扩展过程中会将其扩展。 

StarTeam 中的可用关键字包括 : 

$Author$ 

签入修订的用户 

$Date$ 

修订的日期和时间戳 

$DateUTC$ 除了使用 UTC 时间代替本地时间之外 , 此关键字与 $Date$ 相同。 

UTC 时间以 “Z” 结尾 , 这样该时间便非常容易识别。“Z” 是 UTC 

时间的国际标准。 Z 代表 “ 零子午线 ”, 该线穿过伦敦的格林威治。 

它也常用于无线电通信 , 其发音与 “Zulu” 相同 ( 该词代表国际无线 

电通信字母表中的 Z)。 

$Header$ 

“ 工作文件 ”、“ 修订 ”、“ 日期 ” 和 “ 作者 ” 的组合 

$HeaderUTC$ 除了使用 UTC 时间代替本地时间之外 , 此关键字与 $Header$ 相同。 

UTC 时间以 “Z” 结尾。 

$Id$ 

除了此关键字是 “ 工作文件 ”、分支修订号 ( 前面加有表示版本的 

“v”, 例如 v 1.2.1.0)、 UTC 时间和 “ 作者 ” 的组合 , 它与 

$HeaderUTC$ 非常类似。分支修订号使用点标记。 

$Locker$ 将文件独占锁定的用户 ( 如果有 ) 



$Log$ or $Log[x]$ 文件更改历史 

$Log$ 是特殊关键字 , 因为它扩大为多行条目。关键字 $Log$ 扩大为 

可包括文件的每个修订的信息。修订历史包括 “ 修订号 ”、“ 日期 ”、 

“ 作者 ” 和 “ 签入原因 ”。 

使用 $Log$ 保留文件中每个修订的条目。如果要限制所保留的修订条 

目数 , 请使用 $Log[x]$。使用要保留的条目数替代 x。例如 , $Log[8] 

保存 8 个最新修订的条目。如果用小于 1 的数字或非数字字符替代 x, 

则 StarTeam 将忽略 x 并保留所有条目 ( 与 $Log$ 相同 )。 

$LogUTC$ or 除了使用 UTC 时间代替本地时间之外 , 此关键字与 $Log$ 相同。 

$LogUTC[x]$ UTC 时间以 “Z” 结尾。 

$NoKeywords$ 关闭文件其余部分的关键字扩展 

$Project$ 

项目名称 

$Revision$ 修订号 ( 整数 ) 

$Folder$ 

文件夹名称 

$Workfile$ 

工作文件的非限定名称 ( 例如 foo.cpp) 

Java 用户注意事项 

如果序列 “\u” 出现在扩展的标题中 , 则 $Header$ 可能会引起问题。例如 , 假设有 

一个名为 foo.java 的文件存储在 D:\util 中。在您初次使用 $Header$ 对其进行编译 

时 , 标题被扩大为 : 

$Header: D:\util\Foo.java, 1, 7/27/99 11:05:48 AM, StarTeam Administrator$ 

尽管它被包含在 java 注释中 , 但是 java 编译器也会始终查找 \u ( 表示 unicode)。 

而当您第二次编译 foo.java 时 , 便会出现编译器错误。 

第 8 章 : 管理文件 165

修改文件属性 

注 

下面的文件显示了一些扩展的关键字。由于本手册页面大小的原因 , 某些行将会换行 , 

显示在两个行上。 

$Author: StarTeam Server Administrator$ 

$Date: 10/20/2003 7:39:00 PM$ 

$Header: Stardoc.h, 9, 10/20/2003 7:39:00 PM, StarTeam Server Administrator$ 

$Id: Stardoc.h,v 1.8, 2003-10-21 02:39:00Z, StarTeam Server Administrator$ 

$Locker:StarTeam Server Administrator$ 

$Log[5]: 

9 StarDraw 1.8 10/20/2003 7:39:00 PM StarTeam Server Administrator 

8 StarDraw 1.7 8/1/1997 5:22:05 PM Francis Bacon New Step 8 

7 StarDraw 1.6 7/1/1997 5:15:52 PM Thomas Edison New Step 7 

6 StarDraw 1.5 6/1/1997 5:09:21 PM Albert Einstein New Step 6 

5 StarDraw 1.4 5/1/1997 5:04:58 PM Nikola Tesla New Step 5 

$ 

$Project: StarDraw$ 

$Revision: 9$ 

$Folder: Source Code$ 

$Workfile: Stardoc.h$ 

下面的关键字 $DateUTC$ 将被扩大为可以显示 UTC 日期表示法。请注意 , 该时间后面 

跟有 “Z”。 

$DateUTC: 2003-01-16 00:50:49Z$ 

可将下面的扩展关键字 $Header$ 和 $HeaderUTC$ 进行比较。 

$Header: EnumInfo.cpp, 24, 1/15/2001 4:50:49 PM, TEdison$ 

$HeaderUTC: EnumInfo.cpp, 24, 2001-01-16 00:50:49Z, TEdison$ 

可在历史列表中以 UTC 格式显示时间。有关详细信息 , 请参阅第 310 页的 “ 设置 

文件选项 ”。 


本部分说明如何使用标准属性对话框来编辑文件属性。根据您团队对 StarTeam 的设 

置 , 您可能会看到完全不同的、称为备选属性编辑器 (APE) 的对话框。 

每次修改文件属性时 , 都会创建该文件的新修订。如果修改一个属性 , 还应使用 

Revision Comment ( 修订注释 ) 选项卡来创建说明修改的修订注释。 

如果要重命名项目中的文件 , 则应在 StarTeam 内将其重命名。这样便可保留与该文件 

相关联的属性 , 例如历史和链接。但是 , 如果将视图或项回滚至更改名称之前的配置 , 

则旧名称将无法还原。这可能会引起问题。例如 , 早期内部版本或发行版本的安装脚本 

可能会因其使用文件的以前名称而失败。 

如果在 StarTeam 外重命名一个文件 ( 例如使用 Windows 资源管理器 ), 则 StarTeam 

会将该文件视为新文件。如果使用新名称添加该文件 , 则它将会没有与原始文件的历 

史、链接或其它属性的任何连接。 

修改文件属性 : 



■ 

从 File ( 文件 ) 或上下文菜单中选择 Properties ( 属性 )。 

■ 

单击工具栏上的 Properties ( 属性 )。 

Properties 

出现 File Properties ( 文件属性 ) 对话框。 



3 选择 General ( 常规 ) 选项卡。它将显示 : 

■ 

文件的名称和说明 ( 可修改这两项 )。 

例如 , 如果将文件的名称从 x.cpp 更改为 y.cpp, 则在项目视图中 y.cpp 将变为该 

文件的名称。工作文件的名称 ( 如果存在的话 ) 也会被更改。 

■ 

工作文件的当前状态。 

例如 , 如果工作文件夹不包含该文件 , 则该文件的状态将为 Missing ( 缺失 )。 

■ 

最新修订的大小 ( 以字节为单位 )。 

■ 

上次修改文件的人员姓名及修改日期和时间。 

修改可以是对文件属性进行更改 , 也可以是执行签入操作。 

■ 

所签入的最后一个工作文件的时间戳。 

■ 

独占锁定文件或非独占锁定文件的人员姓名。 

■ 

对于 UNIX 文件 , 将显示查看或更改可执行位的状态的能力。 

4 选择 Working File ( 工作文件 ) 选项卡。它将显示 : 

■ 

工作文件的路径。 

■ 

文件当前是否驻留在工作文件夹中 , 如果是 , 还将显示该文件的大小 ( 以字节为 

单位 ) 和时间戳。 

5 选择 Archive( 存档 ) 选项卡。此选项卡的内容将根据文件和您正在使用的 StarTeam 

客户机的不同而有所变化。 

a 

b 

如果使用 StarTeam Cross-Platform 客户机访问 StarTeam 6.0 Server ( 或更早版 

本 ) 上的文件 , 则出现的字段将视文件是 Native、 PVCS 还是 VSS 而定。 

对于 Native 文件 , 将显示以下字段 : 

■ 

■ 

Archive type ( 存档类型 ):Native 

Compression ( 压缩 ): 选项包括 None ( 无 )、 Maximize Speed ( 使速度达 

到最大 ) 、 Default ( 默认 )( 速度和压缩之间的折衷设置 ) 或 Maximize 

Compression ( 使压缩达到最大程度 )。 

■ 

Store revisions as deltas( 以增量形式存储修订 ): 使用向前增量方法存储文本 

文件的复选框。清除它可存储全部文件修订。 

对于 PVCS 或 VSS 文件 , 将显示以下字段 

■ 

■ 

Archive type ( 存档类型 ):Native、 PVCS 或 VSS 

Foreign archive path ( 外部存档路径 ):PVCS 或 VSS 文件的路径 

如果使用 StarTeam Windows 客户机 ( 任何版本 ) 或 StarTeam Cross-Platform 

客户机访问 StarTeam 2005 Server 上的文件 , 则出现的字段将视文件是 Native、 

PVCS 还是 VSS 而定。 

对于 Native 文件 , 将显示以下字段 : 

■ 

■ 

■ 

Type ( 类型 ):Native 

Format ( 格式 ):Native-I 或 Native-II 

Archive File Name ( 存档文件名 ):Native 文件的名称 

■ 

Compression ( 压缩 ):None ( 无 ) 或 Default ( 默认 ) 

第 8 章 : 管理文件 167

设置文件选项 

对于 PVCS 或 VSS 文件 , 将显示以下字段 : 

■ 

■ 

Type ( 类型 ):PVCS 或 VSS 

Foreign archive path ( 外部存档路径 ):PVCS 或 VSS 文件的路径 

6 选择 Custom ( 自定义 ) 选项卡。它将显示所有自定义的字段及其值。 

如果贵公司购买了 Repository Customization ( 储存库自定义 ) 功能 , 则管理员可能 

已创建了其它文件属性。 StarTeam 管理员指南可提供有关创建自定义字段的信息。 

a 双击自定义属性的名称。出现 Edit Property ( 编辑属性 ) 对话框。 


b 为该属性选择一个新值 , 然后单击 OK ( 确定 )。 

对于整型、文本和实型字段 , Value ( 值 ) 是一个文本框。对于枚举类型和用户 

ID, 它是一个列表框。对于日期和时间 , Value ( 值 ) 有一个日期复选框和一个时 

间复选框 , 每个复选框后面都跟有以您所在地区的格式表示的日期或时间。 

c 对于其它自定义属性 , 重复步骤 a 和 b。 

7 选择 Comment ( 注释 ) 选项卡。它将显示 : 

■ 

为该文件修订输入的注释或说明。可使用 History ( 历史 ) 上下文菜单来编辑该修 

订注释或任何其它修订注释 ( 有关详细信息 , 请参阅第 160 页的 “ 查看修订内 

容 ”)。 

■ 

新修订的注释文本框。应修改该注释以对任何其它属性更改进行说明。 

在 Comment For New Revision( 新修订的注释 ) 文本框中输入任何注释 , 例如更 

改此文件属性的原因。 

8 单击 OK ( 确定 )。 

许多个人选项都与文件相关。请参阅第 310 页的 “ 设置文件选项 ”。 


章 

使用需求 

第 9 章 

利用需求组件可在 StarTeam 中创建需求并显示各需求间的依存关系。例如 , 如果必须先 

实现一个需求才能考虑实现另一个需求 , 则可以将第一个需求作为第二个需求的子项。 

如果已实施过程规则且正在将需求用作过程项 , 则这些需求可用来推动开发过程。有关 

过程规则的详细信息 , 请参阅第 243 页的 “ 使用过程规则 ”。 

管理员和其他授权用户可从 CaliberRM 导出需求 , 然后再将其导入 StarTeam。这可使 

您将高级需求管理技术集成在开发过程中。 

如果开启通知 , 则负责特定需求的那些团队成员会在这些需求变化时收到通知。 

确定需求后 , 便可执行工作来实现这些需求。 

还可对需求执行许多其它操作 , 如移动需求或更改其分支行为。有关详细信息 , 请参阅 

第 223 页的 “ 执行一般性操作 ”。 

本章介绍如何使用标准属性对话框创建和编辑需求。根据您团队对 StarTeam 的设置 , 

您可能会看到完全不同的、称为备选属性编辑器 (APE) 的对话框。 

在上部窗格中显示现有需求 

要在项目视图窗口的上部窗格中显示现有需求 , 请选择 Requirement ( 需求 ) 选项卡。 

菜单栏上也将出现一个 Requirement ( 需求 ) 菜单。选择一个或多个需求后 , 可使用菜 

第 9 章 : 使用需求 169


单栏上的 Requirement ( 需求 ) 菜单或右键单击显示上下文菜单 , 然后执行操作。双击 

单个需求可显示其属性。 

上部窗格中的需求具有以下特征 : 

■ 

它们被附加到从 StarTeam 文件夹层次中选择的文件夹。 

■ 

它们与从 Filter ( 筛选器 ) 下拉列表框中选择的筛选器相匹配。 

■ 

它们与 All Descendants ( 所有后代 ) 指定的深度相匹配。( 可以在工具栏上单击该 

按钮或从 Requirement ( 需求 ) 菜单中选择 All Descendants ( 所有后代 )。) 

需求可能会显示有一个图标以指示其状态以及您是否阅读了最新修订。 

注按 Shift + F5 刷新整个视图 ( 所有选项卡和 StarTeam 文件夹层次中的所有项列表 )。 

按 F5 仅刷新上部窗格。按 Ctrl + F5 刷新上部窗格 , 同时折叠所有打开的组。 

需求列表的默认列包括 : 

Number ( 编号 ) 首次提交需求时 , StarTeam 分配给该需求的号码。 

Created By 创建需求的用户的名称。 

( 创建者 ) 

Created Time 创建需求的时间。 

( 创建时间 ) 

Name ( 名称 ) 为需求指定的名称。 

Description 需求的说明。 

( 说明 ) 

Status ( 状态 ) 表明需求从提交时起直到拒绝或完成的过程 ( 即需求的生命周期 )。下表 

显示状态的排序顺序 : 

Submitted ( 已提交 ) 

Pending ( 待决 ) 

Accepted ( 已接受 ) 

Draft ( 草稿 ) 

Deferred ( 延期 ) 

Review ( 审查 ) 

Complete ( 完成 ) 

ReadyForCCB (Change Control Board) (CCB ( 变更控制部门 ) 就绪 ) 

Rejected ( 已拒绝 ) 

Approved ( 已批准 ) 



Locked By 指示当前独占锁定需求的用户。 

( 锁定者 ) 

Priority ( 优先级 ) 指示需求的重要性。下表显示优先级的排序顺序 : 

Unassigned ( 取消分配 ) 

Essential ( 必要 ) 

Useful ( 有用 ) 

Desirable ( 期望 ) 

单击某个列标题 , 根据需求在该列中的值对需求进行排序。根据列中数据的类型 , 通常 

按数字或字母数字顺序进行升序排序。 

下面是关于使用需求的一些意见 : 

■ 

要将排序顺序从升序更改为降序 , 请再次单击标题 , 反之亦然。主要排序列的标题上 

将出现一个三角形 , 用于指示排序方向。 

■ 

可重新排列字段、显示不同字段、对最多四个列进行排序、使用组带区和对需求列表 




■ 

■ 

通过将需求拖动到新文件夹 , 可将需求从 StarTeam 文件夹层次中的一个文件夹移动 

到另一个文件夹中。还可在使用相同服务器配置的视图或项目之间移动需求。 

要在 StarTeam 文件夹层次中的文件夹之间共享需求 , 可先按住 Ctrl 键 , 然后将需求 

拖动到第二个文件夹。还可在使用相同服务器配置的视图或项目之间共享需求。 

使用树格式的益处 

在下图中 , 选择了 Tree Display ( 树显示 ) 按钮 , 因此 , 每个需求及其子项都形成了一 

个可展开的需求树。从中可以看到需求及其子需求之间的关系。它是需求的默认顺序。 

第 9 章 : 使用需求 171

使用需求筛选器 

树图标是 : 

可展开的分支或需求树 ; 单击可展开。 

已展开的分支或需求树 ; 单击可折叠。 

从 Requirement ( 需求 ) 菜单或上下文菜单选择 Expand All ( 全部展开 ) 和 Collapse 

All ( 全部折叠 ) 可完全展开或折叠所有树。 

您所负责的需求将一直保持粗体 ( 未读 ), 直到阅读它们。已读和未读的需求也可以通 

过图标来识别 : 

如果将先前已读或更新过的需求标记为未读 , 则它会再次以粗体显示。 

使用列表格式的益处 

已读的需求。 

未读需求或其分支中某处存在未读子需求的需求。 

在下图中 , 选择了 List Display ( 列表显示 ) 按钮。未显示任何关系。 

使用需求筛选器 

使用列表格式 , 您可以 : 

■ 

■ 

对需求排序 

将特定字段的值作为数据列查看。例如 , 可以查看每个需求的状态列 , 其中包含每个 

状态类型的图标 : 

Deferred ( 延期 ) 或 Rejected ( 已拒绝 ) 需求 

具有所有其它状态的需求 

利用筛选功能可限制需求列表中所显示的需求的种类和数量。从需求列表上方的 Filter 

( 筛选器 ) 下拉列表框中选择一个筛选器。该信息还取决于 : 

■ 

从左窗格的文件夹层次中选择的文件夹 

■ 

是否在工具栏或 Requirement ( 需求 ) 菜单中选择了 All Descendants ( 所有后代 ) 

按钮 

StarTeam 为每个选项卡提供了一组默认筛选器。但是 , 您可能看不到下面列出的所有 

( 或部分 ) 筛选器 , 这取决于贵公司开始采用的 StarTeam 的原始版本以及您和您的团队 

成员对筛选器所作的更改。 



默认筛选器是 : 

显示所有需求。 

Flagged Items 

仅列出已标志的需求 

Grouped by Creator 显示需求组 , 每组对应一个已创建需求的用户。 

Grouped by Status 显示需求组 , 每组对应一个现有状态。 

I Am Responsible 仅显示您所负责的需求。 


从需求列表选择一个需求后 , 利用下部窗格中的选项卡可以 : 

■ 

查看显示在上部窗格中的该需求的属性 ( 单击 Detail ( 详细信息 ) 选项卡 ) 

■ 


■ 


■ 

比较两个需求修订 ( 单击 History( 历史 ) 选项卡 , 然后右键单击以显示上下文菜单 ) 

■ 

查看为它创建的任何链接 ( 单击 Link ( 链接 ) 选项卡 ) 

( 通常 , 将需求与特定文件夹或另一项相链接。) 

■ 


■ 

查看所选文件的引用 ( 单击 Reference ( 引用 ) 选项卡 ) 

创建需求或子需求 

通过创建需求层次 , 可防止代价高昂和耗时的误解 , 从而有利于组织项目并缩短开发 

时间。 

创建需求 : 


■ 

要创建一个并非为现有需求子项的新需求 , 请在 Requirement ( 需求 ) 菜单或上 

下文菜单中单击 New ( 新建 )。 

■ 

要创建一个作为现有需求子项的新需求 , 请在 Requirement ( 需求 ) 菜单或上下 

文菜单中单击 New Child Requirement ( 新建子需求 )。 

第 9 章 : 使用需求 173


出现 New Requirement ( 新建需求 ) 对话框。 

2 使用 Requirement ( 需求 ) 选项卡可以 : 

a 为此需求提供一个名称。 

b 从 owner( 所有者 ) 下拉列表框选择一个所有者 ( 最终负责实现该需求的人员 )。 

c ( 可选 ) 在 External Reference ( 外部引用 ) 文本框中为此需求提供一个外部源或 

外部引用。 

( 如果要从 CaliberRM 导入需求 , 此字段将针对此需求显示 CaliberRM 标识。) 

d 输入此需求的初始说明。该说明通常随时间推移加以修订 , 以此来消除歧义。 

3 使用 Responsibilities( 责任 ) 选项卡列出负责此需求的团队成员。如果启用通知 , 则 

在需求发生变化时会向这些人发出通知。 

a 单击 Add ( 添加 ) 以显示 Select Responsible Users ( 选择负责用户 ) 对话框。 

b 双击要添加到列表的每个人员的姓名。 



双击姓名时 , 该姓名将从 Users( 用户 ) 列表框移动至 Responsible( 负责人 ) 列 

表框。 

c 在所有负责用户均添加到 Responsible ( 负责人 ) 列表框后 , 单击 OK ( 确定 )。 

4 以后 , 审查者将使用 Ambiguity Review ( 歧义审查 ) 选项卡查找初始说明中的歧义 

并进行修订。现在可忽略此选项卡。 

5 使用 Estimate ( 估计 ) 选项卡指出实现此需求的 “ 最佳情况 ” 和 “ 最差情况 ” 下的 

时间。输入通常以工作日为单位。 

a 

b 

c 

在 Expected Effort( 预期工作量 ) 文本框中输入实现此需求估计需要的单位数 ( 通 

常为天数 )。 

在 High Effort ( 高工作量 ) 文本框中输入 “ 最差情况 ” 下实现此需求估计需要的 

单位数 ( 通常为天数 )。 

在 Low Effort ( 低工作量 ) 文本框中输入 “ 最佳情况 ” 下实现此需求估计需要的 

单位数 ( 通常为天数 )。 

d 在 Notes ( 说明 ) 文本框中添加任何适当的说明。 

第 9 章 : 使用需求 175

从 CaliberRM 导出需求 

6 使用 Custom( 自定义 ) 选项卡为可能已由团队领导者或公司创建的需求属性提供值。 

StarTeam 管理员指南可提供有关创建自定义字段的信息。 



■ 

对于整型、文本和实型字段 , Value ( 值 ) 是一个文本框。 

■ 

对于枚举型和用户 ID, Value ( 值 ) 是一个列表框。 

■ 

对于日期和时间 ,Value( 值 ) 有一个日期复选框和一个时间复选框 , 每个复选 

框后面都跟有以您所在地区的格式表示的日期或时间。 


7 ( 可选 ) 使用 Attachments ( 附件 ) 选项卡向此需求添加附加文件。 

a 如果要附加文件 , 请单击 Add ( 添加 )。例如 , 要展示用户界面的外观。 


b 从 Open ( 打开 ) 对话框选择一个要附加的文件。 

c 单击 Open ( 打开 )。 

d 要进行其它附加 , 可重复以上步骤。最多可为一项附加 64 个文件。 

8 使用 Comment ( 注释 ) 选项卡解释创建需求的原因。 

其他团队成员应该在修订需求时添加注释以解释其所作更改。在 Comment For New 

Revision ( 新修订的注释 ) 文本框中输入原因。 

9 单击 OK ( 确定 ) 保存该需求。 

从 CaliberRM 导出需求 

您可以从 CaliberRM 导出需求。请使用自定义 CaliberRM DocFactory。有关详细信息 , 

请参阅 CaliberRM 文档。 

从 CaliberRM 导入需求 

重要说明 

StarTeam Extensions 含有一个名为 impreq 的专用 “ 需求导入实用程序 ” 。它是一个 

Java 应用程序 , 旨在将 CaliberRM 需求导入到需求组件中。此实用程序与 CaliberRM 

DocFactory 配合工作 , 并作为 StarTeam Extensions 的一部分而安装。如果使用默认安 

装位置 , 则其位于 Program Files\Borland\CaliberRM 文件夹中。有关详细信息 , 请参阅 

StarTeam Extensions User's Guide (StarTeam Extensions 用户指南 )。 

完成向 StarTeam 中导入需求后 , 在目标 StarTeam 项目打开副本的 Requirements( 需 

求 ) 选项卡上却不会显示这些需求。必须重新打开该项目才能显示导入的需求。 

来自 CaliberRM 的需求不能在 StarTeam 中进行编辑。如果要在 CaliberRM 中编辑这些 

需求 , 必须重新执行导出和导入操作。 

如果使用 Next ( 下一个 ) 和 Previous ( 上一个 ) 按钮在需求间移动 , 则 StarTeam 

会弄不清楚哪些需求是来自 CaliberRM 而无法编辑 , 哪些需求是在 StarTeam 中创建 

的且可编辑。如果需求为只读 , 则不保存数据 , 同时不会相应启用和禁用各个字段。 


在 StarTeam 中显示 CaliberRM 需求 

在 StarTeam 中显示 CaliberRM 需求 

如果使用 StarTeam Enterprise Advantage, 则需求的样例备选属性编辑器 (APE) 会含 

有一个用于启动 CaliberRMViewer 的按钮。 

使用 CaliberRMViewer 时 , 会在下面的对话框中显示一个需求 , 进而可在 CaliberRM 中 

编辑该需求 : 

第 9 章 : 使用需求 177


章 

跟踪更改请求 

第 10 章 

重要说明 

更改请求是要在项目作用域内进行更改的请求。例如 , 您可能建议改进某个产品或请求修 

复某个错误或问题。为了有效地使用更改请求跟踪系统 , 需要了解该系统所基于的模型。 

本章介绍如何使用标准属性对话框创建和编辑更改请求。根据您的团队对 StarTeam 的 

设置 , 您可能会看到完全不同的、称为备选属性编辑器 (APE) 的对话框。 

重要说明 

尽管您为更改请求使用标准属性对话框 , 但贵公司或团队领导者可能还会规定一组使用更 

改请求的规则 , 这些规则与下面介绍的模型不同。在此情况下 , 该模型仅作为一个示例。 

还可以对更改请求执行其它多种操作 , 例如移动更改请求或更改其分支行为。有关详细 

信息 , 请参阅第 223 页的 “ 执行一般性操作 ”。 

尽管您为更改请求使用标准属性对话框 , 但贵公司或团队领导者可能还会规定一组使 

用更改请求的规则 , 这些规则与下面介绍的模型不同。在此情况下 , 该模型仅作为一 

个示例。 

第 10 章 : 跟踪更改请求 179

更改请求跟踪系统模型 

更改请求跟踪系统模型 

下面的图及步骤显示了更改请求跟踪过程。其中的方框代表从提交更改请求到更改请求 

结束这段时间内所采取的步骤。每个方框指明一个操作及最有可能负责执行此操作的团 

队成员。箭头显示进行到每一步时该更改请求的状态。 

StarTeam 更改请求跟踪系统由以下内容组成 : 

1 某个团队成员创建了一个新更改请求 , 该更改请求执行以下一项工作 : 

■ 

汇总贵公司产品的问题并列出再现此问题所需的步骤。 

■ 

提出对该产品的改进建议。 

此更改请求的状态为 New ( 新建 )。 

2 其他人员 ( 如 StarTeam 管理员或团队领导者 ) 决定是否修复该问题或是否为该产品 

加入建议的改进。 

此成员可执行以下操作 : 

■ 

将该更改请求的状态设置为 Open ( 未决 ) 并分配一个团队成员解决该请求。 

■ 

在更改请求值得解决但不会在此时解决时 , 将该更改请求的状态设置为 Deferred 

( 延期 )。 

■ 

如果不是首次提交更改请求 , 将该更改请求的状态设置为 Is Duplicate ( 重复 )。 

如果需要 , 可在更改请求和原始提交之间创建一个链接 , 这样可一起跟踪该更改请 

求和原始提交。 

■ 

如果认为产品就应按原样工作 ( 即 , 没有缺陷 ), 将该更改请求的状态设置为 As 

Designed ( 按设计 )。 

状态为 Open ( 未决 ) 的更改请求转到步骤 3。 

3 指定解决更改请求的成员将该更改请求的状态更改为 In Progress ( 进行中 )。稍后 , 

在此成员检查完该更改请求后 , 将状态更改为以下之一 : 

■ 

Fixed ( 已修复 ) 

■ 

Documented ( 已制作文档 ) 

■ 

Cannot Reproduce ( 无法再现 ) 


内置工作流 

4 接下来 , 某个团队成员 ( 通常为测试者 ) 将核实该更改请求。例如 , 可开发一个测试 

以确定该问题是否已真正修复、制作文档或不可再现 , 并将状态更改为以下经核实的 

状态之一 : 

■ 

Verified As Designed ( 已核实按设计 ) 

■ 

Verified Cannot Reproduce ( 已核实无法再现 ) 

■ 

Verified Documented ( 已核实已制作文档 ) 

■ 

Verified Fixed ( 已核实已修复 ) 

■ 

Verified Is Duplicate ( 已核实重复 ) 

5 最后 , 其他团队成员将状态更改为 Closed( 已完结 )。此成员然后可执行与结束该更 

改请求相关的活动 , 如结束该更改请求前对其重新测试或将其添加到该产品的下一个 

版本将包含的报告中。 

在上述的大多数步骤中 , 可重新开始和重新处理该更改请求。 

内置工作流 

StarTeam 具有用于更改请求的内置工作流 , 此工作流可自动设置多个与更改请求相关 

的值。此内置工作流根据更改请求的 Status ( 状态 ) 字段确定这些设置。 

不能将其它设置添加到 Status ( 状态 ) 字段。但是 , 可重命名其它字段 , 使它们更适合 

贵组织设置的参数。例如 , 贵组织可能想要将 Status ( 状态 ) 的名称从 “New”( 新 

建 ) 更改为 “New Change Request”( 新建更改请求 )。 

更改某个更改请求的状态时 , 内置工作流自动选择与状态更改相关的相应属性。例如 , 

下图显示更改请求的状态设置为 New ( 新建 )、 Open ( 未决 ) 或 In Progress ( 进行 

中 ) 后可选择的状态。有关详细信息及概述自动工作流更改的表格 , 请参阅第 192 页的 

“ 摘要 ” 一节。 

选择 New ( 新建 )、 Open ( 未决 ) 或 In Progress ( 进行中 ) 后 , 在 Status ( 状态 ) 

下拉列表框中创建六个新状态。这些与所选状态相关的状态包括 : 

■ 

Deferred ( 延期 ) 

■ 

Cannot Reproduce ( 无法再现 ) 

■ 

As Designed ( 按设计 ) 

■ 


■ 


■ 

Is Duplicate ( 重复 ) 


在上部窗格显示现有更改请求 

下图显示初始状态为 Open ( 未决 ) 的某个更改请求的生命周期。之后状态被设置为 

Fixed ( 已修复 )。在此设置之后 , 内置工作流添加了一个附加状态字段 Verified Fixed 

( 已核实已修复 )。最后 , 结束该更改请求 , 即将其状态设置为 Closed( 已完结 )(Fixed 

( 已修复 ))。 

该图还显示可在更改请求生命周期的任何阶段重新将其打开 , 因为从三个已修复状态中 

的每一个状态指出的箭头都可在任何时候指回到 Open ( 未决 ) 状态。未决更改请求由 

一个圆形图标表示。 

此图还显示三个已修复状态的各自图标 : 

■ 

圆内包含锤子和钉子表示状态为 Fixed ( 已修复 )。 

■ 

锤子、钉子和勾号表示状态为 Verified Fixed ( 已核实已修复 )。 

■ 

锤子和钉子但没有圆表示状态为 Closed ( 已完结 )(Fixed ( 已修复 ))。 


要在项目视图窗口的上部窗格显示现有更改请求 , 请选择 Change Request( 更改请求 ) 

选项卡。 Change Request ( 更改请求 ) 菜单也出现在菜单栏上。选择一个或多个更改 

请求之后 , 可使用菜单栏上的 Change Request ( 更改请求 ) 菜单或右键单击以显示上 

下文菜单。双击某个更改请求可显示其属性。 

图标可随更改请求一起出现。这些图标指示更改请求的类型、状态及严重级别。 

上部窗格中所有更改请求都 : 

■ 

附加到从 StarTeam 文件夹层次中选择的文件夹。 

■ 

与从 Filter ( 筛选器 ) 下拉列表框中选择的筛选器匹配。 

■ 

与 All Descendants ( 所有后代 ) 指定的深度匹配。( 可单击工具栏上的按钮或从 

Change Request ( 更改请求 ) 菜单选择 All Descendants ( 所有后代 )。) 



注 

按 Shift + F5 刷新整个视图 ( 所有选项卡及 StarTeam 文件夹层次中的所有项列 

表 )。按 F5 仅刷新上部窗格。按 Ctrl + F5 刷新上部窗格 , 同时折叠所有打开的组。 

更改请求列表的默认列包括 : 

CR Number 首次提交更改请求时 , StarTeam 分配给该更改请求的号码。 

(CR 号 ) 

Synopsis ( 概要 ) 更改请求的简短说明。 

Type ( 类型 ) 更改请求的类型 : 

Defect ( 缺陷 ) 


Suggestion ( 建议 ) 

指示更改请求从未决到已解决再到已核实已完结的进展情况。也可称为更 

改请求的生命周期。 

New ( 新建 ) 

Open ( 未决 ) 

In Progress ( 进行中 ) 

Resolved ( 已解决 ) 

Verified ( 已核实 ) 

Cannot Reproduce 

( 无法再现 ) 

Closed ( 已完结 ) 

As Designed 

( 按设计 ) 


Documented 

( 已制作文档 ) 

Is Duplicate 

( 重复 ) 


使用更改请求筛选器 

Severity ( 严重性 ) 更改请求的严重程度 : 

高严重性 ( 红灯 ) 

中严重性 ( 黄灯 ) 

Responsibility 

( 责任 ) 

Addressed In 

( 解决请求的内部 

版本 ) 

Addressed By 

( 解决者 ) 

低严重性 ( 绿灯 ) 

负责该更改请求的人员。 

其中的更改请求已解决的内部版本。 

解决了更改请求的用户的名称。更改请求的状态变为 Cannot Reproduce 

( 无法再现 )、 As Designed ( 按设计 )、 Fixed ( 已修复 )、 

Documented ( 已制作文档 ) 或 Is Duplicate ( 重复 ) 时 , 该更改请求即 

已得到解决。 

Last Build Tested 在其中出现更改请求的内部版本。 

( 最后测试的内部 

版本 ) 

Work Around 除修复之外的其它更改请求解决方案。 

( 解决方法 ) 

Modified Time 最后修改更改请求的时间。 

( 修改时间 ) 

Priority ( 优先级 ) 指示该更改请求 : 

有优先级 

使用更改请求筛选器 

无优先级 

Description( 说明 ) 缺陷或建议的完整解释 , 包括再现问题所需采取的步骤。 

Test Command 可用于测试更改请求的解决方案的命令。 

( 测试命令 ) 

Fix ( 修复 ) 更改请求所提出的问题的解决方案。 

Entered On 提交更改请求的日期和时间。 

( 输入时间 ) 

Entered By 提交该更改请求的人员。 

( 输入者 ) 

单击某个列标题 , 以按照该列中的值对更改请求排序。根据列中数据的类型 , 通常按数 

字或字母数字顺序进行升序排序。其它排序顺序包括 : 

■ 

严重性 : 其升序顺序为低、中、高。 

■ 

状态 : 根据其生命周期排序 , 其升序顺序为从 new ( 新建 ) 到 closed ( 已完结 )。 

■ 

优先级 : 其升序顺序为从 No ( 无 ) 到 Yes ( 有 )。 

要将排序顺序从升序更改为降序 , 请再次单击标题 , 反之亦然。在主排序列的标题上出 

现一个三角形 , 指示排序的方向。 

可以在更改请求列表中重新排列字段、显示不同字段、对最多四个列进行排序、使用组 

带区以及对数据应用查询。可将对数据执行的操作保存为查询或筛选器。请参阅第 67 页 

的 “ 控制列 ”、第 68 页的 “ 对数据排序和分组 ”、第 70 页的 “ 使用查询 ”、第 71 页 


利用筛选功能可以限制在更改请求列表中出现的更改请求的种类和数量。从更改请求列 

表上方的 Filter ( 筛选器 ) 下拉列表框中选择一个筛选器。该信息还取决于 : 

■ 

您在左侧窗格的文件夹层次中进行的选择 


使用现有更改请求 

■ 

是否从工具栏或 Change Request ( 更改请求 ) 菜单选择了 All Descendants ( 所有 

后代 ) 按钮 

StarTeam 随附一组用于每个选项卡的默认筛选器。但是 , 您可能无法看到所有 ( 或任 

一 ) 下列筛选器 , 这取决于贵公司在开始时使用的 StarTeam 的原始版本以及您和您的 

团队成员对筛选器所做的更改。 


显示所有更改请求。 

By Status and 

按照更改请求的状态和当前负责处理这些请求的用户对更改请求进 

Responsibility ( 按状态行分组。 

和责任 ) 

Not a Priority( 无优先级 ) 只显示无优先级的更改请求。 

Priority ( 优先级 ) 只显示有优先级的更改请求。 

Show Unread Changes 只显示尚未阅读 ( 或修改后尚未阅读 ) 的更改请求。 

( 显示未读更改 ) 

Status = Closed 

只显示已完结的更改请求。 

( 状态 = 已完结 ) 

Status = Deferred 只显示已延期的更改请求。 

( 状态 = 延期 ) 

Status = Open 

只显示未决且在处理中的更改请求。 

( 状态 = 未决 ) 

Status = Resolved 

( 状态 = 已解决 ) 

Status = Verified 

( 状态 = 已核实 ) 

Type = Defect 

( 类型 = 缺陷 ) 

Type = Suggestion 

( 类型 = 建议 ) 

显示所有具有以下状态之一的更改请求 :As Designed ( 按设 

计 )、 Cannot Reproduce ( 无法再现 )、 Documented ( 已制作文 

档 )、 Fixed ( 已修复 ) 或 Is Duplicate ( 重复 )。 

显示所有具有以下状态之一的更改请求 :Verified As Designed 

( 已核实按设计 )、 Verified Cannot Reproduce ( 已核实无法再 

现 )、Verified Documented( 已核实已制作文档 )、Verified Fixed 

( 已核实已修复 ) 或 Verified Is Duplicate ( 已核实重复 )。 

只显示类型为 Defect ( 缺陷 ) 的更改请求。 

只显示类型为 Suggestion ( 建议 ) 的更改请求。 

使用现有更改请求 


以粗体显示的更改请求表示您对它们负责且它们尚未被阅读。以正常字体显示的更改请 

求是已阅读的或您不对其负责的更改请求。 

如果将先前已读过或更新过的更改请求标记为未读 , 它将再次以粗体显示。 

通过将更改请求拖动至新文件夹 , 可将更改请求从 StarTeam 文件夹层次中的一个文件夹 

移动到另一个文件夹中。还可在使用相同服务器配置的视图或项目之间移动更改请求。 

要在 StarTeam 文件夹层次中的文件夹之间共享更改请求 , 可先按住 Ctrl 键 , 然后将该 

更改请求拖动到第二个文件夹中。还可在使用相同服务器配置的视图或项目之间共享更 

改请求。 

在更改请求列表中选择某个更改请求时 , 利用下部窗格的选项卡可以 : 

■ 

查看在上部窗格中显示的此更改请求的属性 ( 单击 Detail ( 详细信息 ) 选项卡 ) 

■ 


■ 


■ 

比较两个更改请求的修订 ( 单击 History ( 历史 ) 选项卡 , 然后右键单击以显示上下 

文菜单 ) 


提交更改请求 

■ 

查看为该更改请求创建的任何链接 ( 单击 Link ( 链接 ) 选项卡 ) 

( 通常将某个更改请求链接到特定文件夹、文件、任务、主题或另一个更改请求。) 

■ 


■ 

查看对选定文件的引用 ( 单击 Reference ( 引用 ) 选项卡 ) 


提交更改请求后便可跟踪其解决方案。您的团队可能已经规定了一组填充更改请求中的 

字段的原则。例如 , 对于在更改请求的 Component ( 组件 ) 和 Category ( 类别 ) 字段 

输入何种信息 , 您可能有特定说明。 

创建更改请求 : 

1 从 StarTeam 文件夹层次中选择一个文件夹。 

2 在上部窗格中选择 Change Request ( 更改请求 ) 选项卡。上部窗格中出现更改请求 

列表。 


■ 

从 Change Request ( 更改请求 ) 或上下文菜单中选择 New ( 新建 )。 

New 

■ 

单击工具栏上的 New ( 新建 )。 

出现 New Change Request ( 新建更改请求 ) 对话框。 

4 接受默认状态 New ( 新建 ), 或从 Status ( 状态 ) 下拉列表框中选择其它状态。 

5 从 Severity ( 严重性 ) 下拉列表框中选择 High ( 高 )、 Medium ( 中 ) 或 Low ( 低 ) 

可指示此更改请求的严重性。 

团队领导者通常用高、中和低这三个状态来标识更改请求的条件。 

6 如果该更改请求需要立即引起注意 , 可从 Priority( 优先级 ) 列表框中选择 Yes( 是 )。 

7 从 Type ( 类型 ) 列表框选择 Defect ( 缺陷 ) 或 Suggestion ( 建议 ) 可指定更改请 

求的类型。 

8 从 Platform ( 平台 ) 下拉列表框选择此缺陷或建议适用的平台。 

9 ( 可选 ) 从 StarTeam 2.1 或 2.0 版本项目导入更改请求时 , 可使用 External 

Reference ( 外部引用 ) 文本框。或者 , 可使用该文本框指出由于哪个客户寻求技术 

支持而产生了此缺陷条目。 



External Reference ( 外部引用 ) 文本框最多可含有 64 个字符。 

10 ( 可选 ) 从 Last Build Tested ( 最后测试的内部版本 ) 下拉列表框选择内部版本可指 

示出现该更改请求的内部版本。默认值是最新内部版本的名称。 

11 ( 可选 ) 可使用 Component( 组件 ) 文本框来区分更改请求。例如 , 区分某个更改请 

求适用于客户机还是服务器。 

Component ( 组件 ) 文本框最多可含有 64 个字符。 

12 ( 可选 ) 可使用 Category ( 类别 ) 文本框按其它条件 ( 如对话框名称、菜单等 ) 对 

更改请求进行分组。 

Category ( 类别 ) 文本框最多可含有 64 个字符。 

13 在 Synopsis ( 概要 ) 文本框中输入更改请求的摘要。 

StarTeam 在此文本框内最多接受 20K 的字符。 

14 从 Responsibility ( 责任 ) 下拉列表框中选择负责改正此更改请求的团队成员的名称。 

15 选择 Description ( 说明 ) 选项卡。 

a 

在 Description ( 说明 ) 文本框中输入该更改请求的完整说明 , 包括再现它所需的 

步骤。 


b ( 可选 ) 在 Test Command( 测试命令 ) 文本框中输入或浏览到该更改请求的测试 

的路径。 

16 ( 可选 ) 选择 Solution ( 解决方案 ) 选项卡。在 Work Around ( 解决方法 ) 文本框中 

输入一个临时解决方案。Work Around( 解决方法 ) 文本框通常由修复该代码的用户 

完成。 


17 选择 Custom ( 自定义 ) 选项卡。 

如果贵公司购买了 Repository Customization ( 储存库自定义 ) 功能 , 则团队领导者 

可能创建了其它更改请求属性。 StarTeam 管理员指南可提供有关创建自定义字段的 

信息。 

a 双击自定义属性的名称。 

b 

在随后出现的 Edit Property ( 编辑属性 ) 对话框中 , 为该属性选择新值 , 然后单 

击 OK ( 确定 )。 

■ 


■ 

对于枚举类型和用户 ID, 它是一个列表框。 

■ 


框后面都接有用当前区域的格式表示的日期或时间。 


18 ( 可选 ) 选择 Attachments ( 附件 ) 选项卡。 

a 

单击 Add ( 添加 ) 将某个文件附加到该更改请求。例如 , 可附加某个问题的图像 

捕捉。 

显示 Open ( 打开 ) 对话框。 


分配更改请求 



d 要进行其它附加操作 , 可重复以上步骤。最多可为一个项附加 64 个文件。 

要删除某个附件 , 先选择该附件 , 然后单击 Remove ( 删除 )。 

19 ( 可选 ) 选择 Comment ( 注释 ) 选项卡。 

20 在 Comment For New Revision ( 新修订的注释 ) 文本框中输入任何说明 , 例如更改 

此更改请求的属性的原因。 

21 单击 OK ( 确定 ) 保存新更改请求。 

分配更改请求 

要分配更改请求 , 必须选择 Change Requests( 更改请求 ) 选项卡 , 然后从左侧窗格的 

文件夹层次选择正确的文件夹 , 如果需要 , 还要选择 All Descendants ( 所有后代 ) 工 

具栏按钮。可能已创建了筛选器或查询以查找所有状态为 New ( 新建 ) 的更改请求 , 或 

者可以在上部窗格对 Status ( 状态 ) 列进行排序。 

分配更改请求 : 


■ 

双击更改请求。 

Properties 

■ 

选择该更改请求然后单击工具栏上的 Properties ( 属性 )。 

■ 

选择该更改请求 , 然后从 Change Request ( 更改请求 ) 或上下文菜单中选择 

Properties ( 属性 )。 

出现 Change Request Properties ( 更改请求属性 ) 对话框。 

2 查看其设置并确定相应的状态。可将其状态设置为 Open( 未决 )、Is Duplicate( 重 

复 )、 As Designed ( 按设计 ) 或 Deferred ( 延期 )。 

3 如果将状态设置为 Open( 未决 ), 还可将 Responsibility( 责任 ) 属性更改为根据该 

更改请求中的说明最适合修复或改进产品的人员。 


■ 

单击 Apply ( 应用 ), 然后单击 Next ( 下一个 ) 或 Previous ( 上一个 ) 按钮以查 

看其它更改请求。 

■ 

单击 OK ( 确定 ) 以关闭此对话框。 

当某个更改请求的状态变为 Is Duplicate ( 重复 ) 或 As Designed ( 按设计 ) 时 : 

StarTeam 自动将负责人改为提交该更改请求的人员。假设情况是提交该更改请求的人 

员想要了解、核实或者可能要质询这种状态的更改。 

注处理新更改请求的人员也应定期处理延期的更改请求 , 例如在计划该产品的新版本时。 


解决未决的更改请求 

解决未决的更改请求 

要查找需要解决的更改请求 , 请选择 Change Requests( 更改请求 ) 选项卡、正确的文 

件夹 , 并在需要时选择 All Descendants ( 所有后代 ) 工具栏按钮。和大多数用户一样 , 

您可能要创建筛选器或查询 , 以查找您当前负责的所有更改请求 ( 有关详细信息 , 请参 

阅第 67 页的 “ 在上部窗格中管理数据 ”)。 

根据您的团队或组织所用的处理方式 , 可能要求您将未决更改请求链接到为修复更改请 

求而需要更改的一个或多个文件。而且 , 在开始处理该更改请求之前 , 可能要求将其状 

态更改为 In Progress ( 进行中 )。 

签入某个或某组文件时 , 可指出签入的文件修复了哪些更改请求。此操作可节省使用其 

它缺陷跟踪系统甚至使用视图窗口上部窗格中的更改请求列表单独更改每个更改请求的 

状态所需的时间。有关详细信息 , 请参阅第 153 页的 “ 签入文件 ”。 

解决更改请求 : 

1 双击更改请求。出现 Change Request Properties ( 更改请求属性 ) 对话框。 

2 将状态改为以下已解决的一个状态 : 

■ 


■ 


■ 

Cannot Reproduce ( 无法再现 )。 

提示 

如果将更改请求的状态改成了 Open( 未决 ) 的人员未注意到这些已提交的更改请求 , 

也可使用 Is Duplicate ( 重复 ) 或 As Designed ( 按设计 )。 

3 如果状态为 Fixed ( 已修复 ) 或 Documented ( 已制作文档 ), 请选择 Solution ( 解 

决方案 ) 选项卡 , 然后在 Work Around ( 解决方法 ) 和 / 或 Fix ( 修复 ) 文本框中输 

入相应信息。 

StarTeam 在上述每个文本框内最多可接受 20K 的字符。 

更改请求常常会为此问题提出一个或多个修复建议 , 但却都不是您实施的修复。为避 

免混淆 , 必须准确描述您的修复。测试者和编著者在很大程度上要借助于此信息。 

4 单击 OK ( 确定 ) 以关闭此对话框。 

StarTeam 在某个更改请求的状态变为已解决时自动进行以下更改 : 

■ 

■ 

更改请求的负责人改为提交该更改请求的人员。假设情况是提交该更改请求的人员想 

要了解、核实或者可能要质询这种状态的更改。 

如果状态更改为 Fixed ( 已修复 ) 或 Documented ( 已制作文档 ), 则 Addressed In 

Build ( 解决请求的内部版本 ) 属性的设置自动变为 “Next Build”( 下一个内部版 

本 ) 。然后在创建下一个内部版本标签 ( 特殊类型的视图标签 ) 时 , StarTeam 将 

“Next Build”( 下一个内部版本 ) 的值更改为此内部标签的名称。假设情况是核实此 

更改请求已实施的人员应该测试该产品的正确内部版本。 

因为 StarTeam 立即自动进行这些更改 , 所以您可能想在单击 Apply( 应用 ) 或 OK( 确 

定 ) 前更改 Responsibility ( 责任 ) 或 Addressed In Build ( 解决请求的内部版本 ) 的设 

置。执行此操作可绕过自动工作流并可按团队需要发送该更改请求。例如 , 可能需要由 

质量保证部门的某个成员负责系统中所有已解决的更改请求 , 而无论是谁提交了这些更 

改请求。 


核实已解决的更改请求 

核实已解决的更改请求 

要核实某个更改请求 , 可在产品的正确内部版本中对其进行测试。如果某个测试命令与该 

更改请求关联 , 可从该更改请求运行该命令。在很多情况下 , Test Command ( 测试命 

令 ) 属性将为空。可能必须为该更改请求设计一个新测试 , 或运行一个或多个现有测试。 

要将更改请求标记为已核实 , 请选择 Change Requests( 更改请求 ) 选项卡、正确的文 

件夹 , 并在需要时选择 All Descendants ( 所有后代 ) 工具栏按钮。和大多数用户一样 , 

您可能要创建筛选器或查询 , 以查找您当前负责的所有更改请求。然后 , 如果未在筛选 

器中建立排序 , 可单击 Status ( 状态 ) 列按状态对这些更改请求排序。 

如果确定该更改请求没有真正解决 , 可将其重新打开。 

运行与更改请求相关的测试 : 

1 从更改请求列表中双击某个更改请求。 

2 选择 Description ( 说明 ) 选项卡。 

3 如果 Test Command ( 测试命令 ) 文本框含有条目 , 则单击 Run ( 运行 )。 

将更改请求标记为已核实或将其重新打开 : 

1 双击某个更改请求。 


2 将其状态更改为 Open ( 未决 ) 或 Verified ( 已核实 )。 

StarTeam 具有以下已核实的状态 : 

■ 

Verified As Designed ( 已核实按设计 ) 

■ 

Verified Cannot Reproduce ( 已核实无法再现 ) 

■ 

Verified Documented ( 已核实已制作文档 ) 

■ 

Verified Fixed ( 已核实已修复 ) 

■ 

Verified Is Duplicate ( 已核实重复 ) 

3 如果状态设置为 Open ( 未决 ), 请将 “Reopen”( 重开 ) 一词添加到该更改请求的 

概要中 , 并在该词后面加上日期。否则 , 解决此更改请求的团队成员可能会认为他或 

她忘记了将其标记为已解决 , 而且如果未进一步调查 , 可能将其再次标记为已解决。 

4 单击 OK ( 确定 ) 以关闭此对话框。 

当某个更改请求的状态变为重开时 , 对其自动进行的更改包括 : 

■ 

如果状态为 Open( 未决 ),StarTeam 将更改请求的负责人更改为解决该更改请求的 

人员。 

假设情况是首次解决更改请求的人员应当是继续处理该更改请求的人。 

■ 

Addressed In Build ( 解决请求的内部版本 ) 属性的设置变为空。 

假设情况是该更改请求未解决 , 因此在任何内部版本中都未解决。 


结束已核实的更改请求 

结束已核实的更改请求 

要结束更改请求 , 必须选择 Change Requests ( 更改请求 ) 选项卡、正确的文件夹 , 并 

在需要时选择 All Descendants ( 所有后代 ) 工具栏按钮。您可能已创建了筛选器或查 

询 , 以查找所有状态为 Verified( 已核实 ) 的更改请求 , 或者可在上部窗格对 Status( 状 

态 ) 列进行排序。 

结束更改请求 : 

1 双击某个更改请求。 


2 将状态更改为 Closed ( 已完结 )。 

StarTeam 有以下已完结的状态 : 

■ 

Closed (As Designed) ( 已完结 ( 按设计 )) 

■ 

Closed (Cannot Reproduce) ( 已完结 ( 无法再现 )) 

■ 

Closed (Deferred) ( 已完结 ( 延期 )) 

■ 

Closed (Documented) ( 已完结 ( 已制作文档 )) 

■ 

Closed (Fixed) ( 已完结 ( 已修复 )) 

■ 

Closed (Is Duplicate) ( 已完结 ( 重复 )) 


■ 

单击 Apply ( 应用 ), 然后单击 Next ( 下一个 ) 或 Previous ( 上一个 ) 按钮以查 

看其它更改请求。 

■ 

单击 OK ( 确定 ) 以关闭此对话框。 

如果需要 , 可在此时重开某个更改请求。请参阅第 190 页的 “ 核实已解决的更改请求 ”, 

以获得有关重开某个更改请求时添加到概要的信息及自动工作流更改的详细信息。 


摘要 

摘要 

下表按本章中的说明总结了处理更改请求时使用的步骤。它包括 StarTeam 根据更改请 

求的状态而对其进行的自动工作流更改。 

表 10.1 

更改请求过程管理 

步骤 

说明 

提交任何用户 ( 通常是测试者 ) 都可提交更改请求。 

过程 : 选择 Change Request ( 更改请求 ) 选项卡。然后从 Change 

Request ( 更改请求 ) 或上下文菜单中选择 New ( 新建 )。 

更改请求具有以下默认属性 ( 需要时可以更改 )。 

Status ( 状态 ):New ( 新建 ) 

Severity ( 严重性 ):Low ( 低 ) 

Priority ( 优先级 ):Not prioritized ( 无优先级 ) 

Type ( 类型 ):Defect ( 缺陷 ) 

Platform ( 平台 ):All ( 所有 ) 

Last Build Tested ( 最后测试的内部版本 ):Current build label ( 当前 

内部版本标签 ) 

Entered By ( 输入者 ): 当前登录到 StarTeam 的人 

许多其它字段初始时为空。 

某些团队领导者希望所有更改请求都在根文件夹下提交。他们使用拖放 

操作将更改请求移动到相应子文件夹。 

分配 * 过程 : 团队领导者查找所有新更改请求并执行以下一项操作 : 

■ 打开更改请求并将其分配给某个开发者、帮助的编著者或其他相应团 

队成员。 

■ 将更改请求延至以后的某个日期 , 也许是产品的下一个版本。 

■ 指出该更改请求是 “As Designed”( 按设计 ) 且不需修复。 

如果该更改请求的状态为 Open ( 未决 ), 则不进行任何自动更改。 

如果更改请求的状态为 Deferred ( 延期 ) 或 As Designed ( 按设计 ), 

则 Addressed in Build ( 解决请求的内部版本 ) 会被禁用 , 而且将责任分 

配给创建该更改请求的用户。 

解决 * 过程 : 用户查找分配给他们的 Open ( 未决 ) 或 In Progress ( 进行中 ) 

的更改请求 , 并为每个请求执行以下一项操作 : 

在系统中解决问题并更新更改请求的属性。( 指示更改请求已解决的状态 

包括 Cannot Reproduce ( 无法再现 )、 As Designed ( 按设计 )、 Fixed 

( 已修复 )、 Documented ( 已制作文档 ) 和 Is Duplicate ( 重复 )。) 

将更改请求延至以后的某个日期 , 也许是产品的下一个版本。团队领导 

者可能不希望您将更改请求延期。 

如果更改请求的状态为一个可能的已解决状态 , 则对于 Fixed ( 已修复 ) 

和 Documented ( 已制作文档 ) 这两个状态 , Addressed in Build ( 解决 

请求的内部版本 ) 属性设置变为 Next Build ( 下一个内部版本 )。而对于 

其它状态 , 该属性被禁用。默认情况下 , 责任被分配给提交更改请求的 

用户 , 并期望该用户核实此解决方案。 

如果该更改请求的状态为 Deferred ( 延期 ), 则 Addressed in Build 

( 解决请求的内部版本 ) 被禁用 , 而且默认将责任分配给创建该更改请求 

的用户。 


使用报告和图表 

表 10.1 更改请求过程管理 ( 续 ) 

步骤 

说明 

建立 

谁建立了此项目 ? 项目视图可能有正式或非正式的建立过程。但在某个 

时间点 , 当前视图中的所有文件等会收到该内部版本标签。该标签通常 

应用于已编译的源代码文件等 ( 可能需要更改 ), 而不应用于产生于该 

内部版本的可执行文件。 

对更改请求的影响 : 对于 Addressed In Build ( 解决请求的内部版本 ) 属 

性设置为 Next Build ( 下一个内部版本 ) 的所有已解决的更改请求 , 

“Next Build”( 下一个内部版本 ) 被所创建的下一个内部版本标签替换。 

注 : 如果新内部版本标签是基于某个过去的配置 ( 而非当前配置 ), 则 

它对 Addressed In Build ( 解决请求的内部版本 ) 属性无任何影响。 

如果某个更改请求在当前位置未分支 , 则 “Next Build”( 下一个内部版 

本 ) 可能会被其它视图的内部版本标签替换。例如 , 假设创建了某个分 

支子视图或将某个文件夹从一个视图共享到另一个视图。假设 “Next 

Build”( 下一内部版本 ) 是某个更改请求的 Addressed In Build ( 解决请 

求的内部版本 ) 属性的值 , 而且该更改请求尚未分支。在源视图中创建 

内部版本标签时 , 无论该内部版本标签位于何处 ,“Next Build”( 下一 

个内部版本 ) 都将被其名称替换。 

核实 * 提交更改请求人员 ( 通常是测试者 ) 将核实解决方案。 

过程 : 安装要核实解决方案的内部版本 , 并确定是否已正确解决该更改 

请求。执行以下一项操作 : 

核实更改请求 , 将其标记为 Verified Cannot Reproduce ( 已核实无法再 

现 )、 Verified As Designed ( 已核实按设计 )、 Verified Fixed ( 已核实 

已修复 )、 Verified Documented ( 已核实已制作文档 ) 或 Verified Is 

Duplicate ( 已核实重复 )。 

重开该更改请求并更新 Last Build Tested ( 最后测试的内部版本 ) 的 

设置。 

如果更改请求的状态为 Verified ( 已核实 ), 则不进行任何自动更改。 

如果更改请求的状态为 Open ( 未决 ), 则 Addressed in Build ( 解决请 

求的内部版本 ) 为空。如果更改请求的状态从已解决更改为 Open ( 未 

决 ), 则将状态更改为 Fixed ( 已修复 ) 或 Documented ( 已制作文档 ) 

的用户成为负责用户。 

结束 * 通常由团队领导者结束更改请求。 

过程 : 团队领导者执行以下一项操作 : 

查看并结束已核实的更改请求。 

重开更改请求。 

如果更改请求的状态为 Closed ( 已完结 ), 则不进行任何自动更改。 

如果更改请求的状态为 Open ( 未决 ), 则 Addressed in Build ( 解决请 

求的内部版本 ) 为空。如果更改请求的状态从已解决更改为 Open ( 未 

决 ), 则将状态更改为 Fixed ( 已修复 ) 或 Documented ( 已制作文档 ) 


之后 : 

Addressed in Build ( 解决请求的内部版本 ): 空白 

Responsibility ( 责任 ): 对于从已核实到 Open ( 未决 ) 的更改 , 将更 

改请求的状态更改为 Fixed ( 已修复 ) 或 Documented ( 已制作文档 ) 


* 状态的更改可导致对其它属性的自动更改。 


可使用更改请求报告和更改请求图表功能创建许多图表和报告。本节包含两个样例并解 

释如何将此类设置保存为筛选器 , 以便将来使用。有关使用报告和图表的详细信息 , 请 

参阅第 281 页的 “ 报告和导出数据 ” 和第 293 页的 “ 使用图表 ”。 

以下示例将指导您如何使用 Show Fields( 显示字段 )、Sort and Group( 排序和分 

组 ) 和 Queries ( 查询 ) 这三个命令。有关这些命令的详细信息 , 请参阅 “ 在上部窗 

格中管理数据 ”。 



创建可显示所有新建更改请求及其作者的报告或图表 : 

1 从左侧窗格的文件夹层次选择根文件夹。 

2 选择 Change Request ( 更改请求 ) 选项卡。 

3 从工具栏或 Change Request( 更改请求 ) 菜单选择 All Descendants( 所有后代 )。 

4 右键单击列标题 , 然后从上下文菜单中选择 Show Fields ( 显示字段 )。 

5 在随即显示的 Show Fields ( 显示字段 ) 对话框中 : 

a 

确保 CR Number (CR 号 )、 Entered By ( 输入者 ) 及所有其它相应字段显示在 

更改请求列表中。 

b 单击 OK ( 确定 )。 

6 右键单击列标题 , 然后从上下文菜单中选择 Sort and Group ( 排序和分组 )。 

a 在 First By ( 首先按 ) 组框中 , 从下拉列表框中选择 Status ( 状态 )。 

b 选中 Group By ( 分组依据 ) 复选框。 

c 在第一个 Then By( 然后按 ) 组框中 , 从下拉列表框中选择 Entered By( 输入者 )。 

d 选中 Group By ( 分组依据 ) 复选框。 

e 单击 OK ( 确定 )。 

7 选择 New Grouping ( 新建分组 )。 


■ 

从 Change Request ( 更改请求 ) 或上下文菜单中选择 Reports ( 报告 )。有关详 

细信息 , 请参阅第 281 页的 “ 报告和导出数据 ”。 

■ 

从 Change Request( 更改请求 ) 或上下文菜单中选择 Charts( 图表 )> Distribution 

( 分布 )。有关详细信息 , 请参阅第 293 页的 “ 使用图表 ”。 

创建有关在特定时间段修复的缺陷的报告或图表 : 

1 从左侧窗格的文件夹层次选择根文件夹。 

2 选择 Change Request ( 更改请求 ) 选项卡。 

3 从工具栏或 Change Request( 更改请求 ) 菜单选择 All Descendants( 所有后代 )。 

4 右键单击列标题 , 然后从上下文菜单中选择 Show Fields ( 显示字段 )。 

5 在随即显示的 Show Fields ( 显示字段 ) 对话框中 : 

a 确保 CR Number (CR 号 )、 Status ( 状态 )、 Modified Time ( 修改时间 )、 

Modified By ( 修改者 ) 及所有其它相应字段都显示在更改请求列表中。 

b 单击 OK ( 确定 )。 

6 右键单击列标题 , 然后从上下文菜单中选择 Queries ( 查询 )。 

7 在随即显示的 Queries ( 查询 ) 对话框中 : 

a 

b 

创建一个查询 , 以查找 Modified Time ( 修改时间 ) 晚于或等于感兴趣的最早日期 

的所有更改请求。 

如果结束日期不是当前日期 , 则单击 AND ( 与 ) 加入一个条件 , 要求 Modified 

Time ( 修改时间 ) 早于或等于结束日期。 


8 右键单击列标题 , 然后从上下文菜单中选择 Sort and Group ( 排序和分组 )。 

a 在 First By ( 首先按 ) 组框中 , 从下拉列表框中选择 Status ( 状态 )。 

b 选中 Group By ( 分组依据 ) 复选框。 


9 选择状态为 Fixed ( 已修复 ) 的组。 




■ 

从 Change Request ( 更改请求 ) 或上下文菜单中选择 Reports ( 报告 )。有关详 

细信息 , 请参阅第 281 页的 “ 报告和导出数据 ”。 

■ 

从 Change Request ( 更改请求 ) 或上下文菜单中选择 Charts ( 图表 ) >Time 

Series ( 时间序列 )。有关详细信息 , 请参阅第 293 页的 “ 使用图表 ”。 

执行完排序、分组、选择列、应用查询等操作后 , 可将出现在上部窗格的更改请求数据 

的排列保存为筛选器。 

为当前更改请求排列创建筛选器 : 

1 右键单击列标题 , 然后从上下文菜单中选择 Save Current Settings ( 保存当前设 

置 )。出现 Save Current Settings ( 保存当前设置 ) 对话框。 

2 在 Filter Name ( 筛选器名 ) 文本框中输入筛选器的名称。 

3 根据是只在您的工作站上使用此筛选器还是所有用户都使用此筛选器 , 可选中或清除 

Public ( 公用 ) 复选框。 

4 单击 OK ( 确定 )。此筛选器的名称便出现在 Filter ( 筛选器 ) 下拉列表框中。 




章 

管理任务 

第 11 章 

重要说明 

借助 “ 任务 ” 组件 , 本地和远程的用户可以报告他们接受的任务的进展情况。此组件既 

可以独立操作 , 又可以与 Microsoft Project 交互。在每种情况下 ,“ 任务 ” 组件的用法 

是不同的。本章介绍如何独立操作 “ 任务 ” 组件。有关与 Microsoft Project 交互操作的 

信息 , 请参阅 StarTeam Microsoft Project Integration User’s Guide (StarTeam 

Microsoft Project 集成用户指南 )。 

您可能无法使用 “ 任务 ” 组件 , 这取决于客户机或服务器的许可证。 

独立操作时 ,“ 任务 ” 组件对于管理项目是非常有用的。通过任务 , 您可以大致规划出 

哪些人应哪些时候进行哪些工作。可以估计出完成某项任务需要多长时间 , 记录实际完 

成任务所花费的时数 , 并将这两个时间进行比较。可以将项目日程集成到版本控制系统 

和缺陷跟踪系统中 , 从而将任务链接到文件或更改请求 , 并执行许多其它有用的操作。 

可以对任务执行许多其它操作 , 例如移动或共享它们。有关详细信息 , 请参阅第 223 页 

的 “ 执行一般性操作 ”。 

本章介绍如何使用标准属性对话框创建和编辑任务。根据您团队对 StarTeam 的设 

置 , 您可能会看到完全不同的、称为备选属性编辑器 (APE) 的对话框。 

在上部窗格中使用任务 

All 

Descendants 

选择 Task( 任务 ) 选项卡时 , 任务以树或列表形式出现在上部窗格中。此外 , 所显示的 

任务取决于以下条件 : 

■ 

从左窗格的文件夹层次中选择了哪个 StarTeam 文件夹 

■ 

从上部窗格上面的 Filter ( 筛选器 ) 下拉列表中选择了哪个筛选器 ( 有关详细信息 , 

请参阅第 200 页的 “ 使用任务筛选器 ”) 

■ 

■ 

通过 All Descendants ( 所有后代 ) 按钮或通过从 Task ( 任务 ) 菜单选择 All 

Descendants ( 所有后代 ) 而指定的深度 


格中管理数据 ”)。只有在任务处于列表模式时 , 才能对它们进行排序。 

下方窗格下面的状态栏可以显示任务的总数和在树或列表视图中选择的任务数。 

在列表或树格式中选择某个任务或子任务后 , 通过下方窗格的选项卡可以 : 

■ 

(Detail( 详细信息 ) 选项卡 ) 查看将在上部窗格中显示的属性 ( 如果选择了列表格式 ) 

■ 

(History ( 历史 ) 选项卡 ) 检查其修订历史 

第 11 章 : 管理任务 197


重要说明 

■ 

■ 

■ 

(History ( 历史 ) 选项卡和右键单击显示上下文菜单 ) 编辑修订注释 

(History ( 历史 ) 选项卡和右键单击显示上下文菜单 ) 比较两个任务或子任务的修订 

(Link ( 链接 ) 选项卡 ) 查看为它创建的任何链接 

任务不是自动链接至其子任务 , 但您可以手动链接它们。通常 , 应将任务链接至特定的 

文件夹、文件、主题或更改请求。 

■ 

■ 

( 单击 Label ( 标签 ) 选项卡 ) 查看、附加和分离标签 

( 单击 Reference ( 引用 ) 选项卡 ) 查看所选任务或子任务的引用 

提示 

■ 

要在文件夹层次中将任务树或其一个分支从一个文件夹移动到另一个文件夹 ( 或从一 

个视图移动到另一个视图 ), 请将该任务或分支拖动到其新文件夹。如果移动某个任 

务 , 它将成为其新位置中的任务。 

■ 

使用 Ctrl + 拖放可共享任务和子任务。 

■ 

双击任务可显示其属性。 

■ 

使用 Task ( 任务 ) 菜单或在任务树窗格中右键单击可显示上下文菜单。 

List 

Display 

Tree 

Display 

■ 

按 Shift + F5 可刷新整个视图 , 按 F5 可只刷新上部窗格。按 Ctrl + F5 可刷新上部窗格并 

同时折叠所有打开的组。 

■ 

使用 List Display ( 列表显示 ) 按钮可以列表格式查看任务和子任务。 

■ 

使用 Tree Display ( 树显示 ) 按钮可以树格式查看任务和子任务。 


在下图中 , 选择了 Tree Display( 树显示 ) 按钮。任务和工作分配的默认顺序是其 

树顺序。每个任务及其子任务集构成可展开的任务树 : 

使用树格式时 , 您可以看到任务和子任务之间的关系。例如 , 必须在完成某项任务前完 

成某项子任务。也可以将整个分支标记为已读或未读。 


可展开的分支或任务树 ; 单击可展开。 

已展开的分支或任务树 ; 单击可折叠。 

从 Task ( 任务 ) 菜单或上下文菜单选择 Expand All ( 全部展开 ) 或 Collapse All ( 全 

部折叠 ) 可完全展开或折叠所有树。 



您所负责的任务和子任务将一直保持粗体 ( 未读 ), 直到阅读它们。已读和未读的任务 

也可以通过图标来识别 : 

已读的 StarTeam 任务。 

未读的 StarTeam 任务。与主题不同 , 树格式中的红色标志不会将您指引到未 

读项。 

已读的 StarTeam 子任务。 

未读的 StarTeam 任务。与主题不同 , 树格式中的红色标志不会将您指引到未 

读项。 

已读的 Microsoft Project 任务。 

未读的 Microsoft Project 任务。与主题不同 , 树格式中的红色标志不会将您指 

引到未读项。 

已读的 Microsoft Project 子任务。 

未读的 Microsoft Project 任务。与主题不同 , 树格式中的红色标志不会将您指 

引到未读项。 

List 

Display 


在下图中 , 选择了 List Display ( 列表显示 ) 按钮。未显示任何关系。可以单击 List 

Display ( 列表显示 ) 来按列表形式显示任务 , 这种形式下它们可以排序。 

第 11 章 : 管理任务 199

使用任务筛选器 


■ 

将特定字段的值作为数据列查看。例如 , 可以查看每个任务的状态列 , 其中包含每个 

状态类型的图标。 

■ 

对任务或子任务排序。 

可以单击某个列标题来按该列中的值对行进行排序。再次单击可颠倒排列顺序。例如 , 

单击 Created Time ( 创建时间 ) 列来查看最新输入的任务。 

使用列表格式 , 还可以 : 

■ 

可在任务列表中重新排列字段、显示不同字段、对最多四个列进行排序、使用组带区 

和对数据应用查询 , 并可以保存这些操作以供将来使用 , 如将某些数据显示为查询或 

筛选器 ( 请参阅第 67 页的 “ 控制列 ”、第 68 页的 “ 对数据排序和分组 ”、第 70 页 

的 “ 使用查询 ”、第 71 页的 “ 创建查询 ” 和第 78 页的 “ 使用筛选器 ”)。 

■ 

查询和筛选任务树。 

使用任务筛选器 

创建任务或子任务 

从 Filter( 筛选器 ) 下拉列表框选择某个筛选器可以很容易地找到与该筛选器匹配的任 

务或子任务。 


■ 

( 识别所有任务 ) 

可以自定义任务筛选器。例如 , 使用 “Responsibility Equals ” 筛选器只 

识别某人负责使用的任务 , 而使用 “Percent Complete Less Than 100” 筛选器可以识 

别未完成的任务。 

有关创建筛选器的详细信息 , 请参阅第 67 页的 “ 在上部窗格中管理数据 ”。 

可以创建一项单独的任务或者一项包含子任务集的摘要任务。这需要一定的计划。您需 

要了解 : 

■ 

即使任务只有一个子任务 , 也不能添加工作记录 ( 虽然可以为其子任务添加工作记 

录 )。这种情况下 ,StarTeam 认为该任务定义子任务。换句话说 , 该任务的名称指示 

出子任务完成时将达到的目标 ( 也许是里程碑 )。 

■ 

为某个任务添加了工作后 , 就不能再为其添加子任务。 



可在一个或多个 StarTeam 文件夹中创建一个任务树 , 每个都可包含子项、孙项等。但 

只能将工作添加到不含子任务的任务。 

例如 , 假设某个任务树对应于您所交付的产品的第一个服务包。该任务树如下 : 

■ 

Service Pack 1 ( 服务包 1) 

■ 

New features ( 新功能 ) 

■ 

New feature 1 ( 新功能 1) 

■ 

Coded ( 编码 ) 

■ 

Tested ( 测试 ) 

■ 

Documented ( 形成文档 ) 

■ 

New feature 2 ( 新功能 2) 

■ 


■ 


■ 


■ 

Major fixes ( 主要修正 ) 

■ 

Fix 1 ( 修正 1) 

■ 


■ 


■ 


■ 

Fix 2 ( 修正 2) 

■ 


■ 


■ 


■ 

Preparations for web site downloading ( 网站下载准备 ) 

■ 

Announcements to press and current customers ( 给出版和当前用户的声明 ) 

服务包的发布将成为一个里程碑。它一定是带有子任务的任务 , 所以不能向其添加工 

作。同样 , 也不能向 New features ( 新功能 )、 Major fixes ( 主要修正 ) 等任务添加工 

作 , 因为这些任务中的每一个都必须包含子任务。可向不含其它子任务的子任务添加工 

作 , 如 Coded ( 编码 )、 Tested ( 测试 )、 Documented ( 形成文档 )。 

无论是否可以为任务分配工作 , 都需要分配一个团队成员来负责该任务的完成。对于可 

以分配工作的任务 , 可估计该操作需要的时间并提供其它初始信息。 

创建任务或子任务 : 


2 选择 Task ( 任务 ) 选项卡。 

Task ( 任务 ) 菜单显示在菜单栏上 , 任务则显示在上部窗格中。 


■ 

从 Task ( 任务 ) 或上下文菜单中选择 New ( 新建 )。此操作将创建一项新任务 , 

它是任务树的根。 

■ 

在工具栏上单击 New ( 新建 )。此操作将创建一项新任务 , 它是任务树的根。 

New 

■ 

从 Task ( 任务 ) 或上下文菜单中选择 New Subtask ( 新建子任务 )。此操作将创 

建所选任务的子任务。 

如果已为所选任务添加了工作记录 , 则 New Subtask( 新建子任务 ) 命令被禁用。 

第 11 章 : 管理任务 201


出现 New Task ( 新建任务 ) 对话框 , 其中的 Task ( 任务 ) 选项卡被选定。 

重要说明 

4 在 Name ( 名称 ) 文本框中输入任务的名称。 

Name ( 名称 ) 文本框最多可包含 255 个字符。 

5 从 Responsibility ( 责任 ) 下拉列表框中选择负责完成此任务的团队成员的名称。 

Responsibility ( 责任 ) 字段被分配给负责完成任务的人员。但可将其他人分配为 

附加资源。例如 , 如果此任务的完成依赖于子任务的完成 , 而这些子任务被分配给 

其他团队成员 , 可选择 Resources( 资源 ) 选项卡将这些团队成员作为资源分配。 

6 选中 Milestone ( 里程碑 ) 复选框 , 以指示将此任务看作里程碑任务。 

可在任务列表中显示 Milestone ( 里程碑 ) 列并分拣出指定为里程碑的任务。 

7 从 Status ( 状态 ) 下拉列表框选择任务的当前状态。 

Pending 

( 待决 ) 

新任务的默认状态 , 表示该任务正在等待前置任务的完成或开始。 

Ready to Start 

( 准备开始 ) 

因为所有前置任务都已完成 , 所以此任务可以开始。 

In Progress 

( 进行中 ) 

该状态表明已为此任务输入了工作。 

Finished 

( 结束 ) 

根据处理此任务的团队成员 , 此任务已结束。 

Closed 

( 已完结 ) 

该任务已完成 , 并达到团队领导或任务检查者的满意。 

Hold ( 保持 ) 

根据其前置任务的状态 , 此任务的工作可以执行 , 但它已因进度问题被置 

于保持状态。 


分配任务资源 

8 从 Priority ( 优先级 ) 下拉列表框选择该任务的重要性。这些优先级与在 Microsoft 

Project 中使用的相同。 

■ 

Highest ( 最高 ) 

■ 

Very High ( 非常高 ) 

■ 

Higher ( 较高 ) 

■ 

High ( 高 ) 

■ 

Medium ( 中 )( 默认值 ) 

■ 

Low ( 低 ) 

■ 

Lower ( 较低 ) 

■ 

Very Low ( 非常低 ) 

■ 

Lowest ( 最低 ) 

■ 

Do Not Level ( 不分级 ) 

重要说明 Do Not Level ( 不分级 ) 选项是应忽略的 Microsoft Project 特定术语。 

分配任务资源 

9 在 Duration( 持续时间 ) 文本框中输入完成任务将需要的小时数。如果任务包含子任 

务 , 则此字段被禁用 , 因为父任务的持续时间取决于子任务的持续时间。 

10 在 Percent Complete( 完成百分比 ) 文本框中 , 输入某项任务已完成的工作的百分比。 

Percentage Complete( 完成百分比 ) 文本框的值可介于 0 到 100 之间 , 新任务的默 

认值为 0。 

11 ( 可选 ) 选中 Needs Attention( 需要注意 ) 复选框 , 以通知团队领导或任务检查者需 

要注意此任务。在文本框中输入有关此任务需要注意的原因的信息。 

团队领导可将 Needs Attention ( 需要注意 ) 列添加到任务列表并分拣出这些项。 

12 此过程将在下一节 “ 分配任务资源 ” 中继续介绍。 

创建任务或子任务时 , 可分配其它团队成员 ( 资源 ) 来帮助完成任务。 Resources ( 资 

源 ) 选项卡用于查看可为此任务分配的团队成员列表。 

将团队成员分配给任务 : 

1 选择 Resources ( 资源 ) 选项卡。 

第 11 章 : 管理任务 203

估计完成任务需要的时间 

2 单击 Add ( 添加 )。出现 Select Task Resources ( 选择任务资源 ) 对话框。 

3 从 Users ( 用户 ) 列表中选择要分配给该任务的团队成员 , 然后单击 Add ( 添加 )。 

所选的团队成员出现在 Assigned Resources ( 已分配的资源 ) 列表中。 

4 单击 OK ( 确定 ) 返回 Resources ( 资源 ) 选项卡。 

作为资源添加的团队成员列表出现在 Task Resources Assignment ( 任务资源分配 ) 

列表中。 

5 执行以下任一项操作 : 

估计完成任务需要的时间 

■ 

如果 Task Resources Assignment( 任务资源分配 ) 列表正确 , 单击 Apply( 应用 )。 

■ 

要从 Task Resource Assignment ( 任务资源分配 ) 列表中删除某个资源 , 选择其 

名称 , 然后单击 Remove ( 删除 )。 

■ 

如果需要添加其它资源 , 单击 Add ( 添加 ) 并按步骤 3 到 4 操作。 

6 此过程将在下一节 “ 估计完成任务需要的时间 ” 中继续介绍。 

通过 Time ( 时间 ) 选项卡可估计完成某个任务所需的时间量。可以设置该任务的估计 

时间和实际时间。 StarTeam 不提供估计、实际和差异值的汇总机制。 

设置完成任务的估计时间 : 

1 选择 Time ( 时间 ) 选项卡。 


将工作添加到任务或子任务 


■ 

使用 Start ( 开始 ) 下拉日历输入该任务的开始日期。 

■ 

在 Start ( 开始 ) 文本框中输入日期 (mm/dd/yy)。 


■ 

使用 Finish ( 结束 ) 下拉日历输入该任务的结束日期。 

■ 

在 Finish ( 结束 ) 文本框中输入结束日期 (mm/dd/yy)。 

4 在 Work ( 工作 ) 字段中输入完成此任务所需的估计工作量 ( 小时数 )。 

例如 , 如果计算的任务需要三天 , 按一天八小时算 , 则应在 Work ( 工作 ) 文本框中 

键入 24。 

此对话框的其余部分被禁用。 Microsoft Project 将使用这些字段 , 但您不能。 

将工作添加到任务或子任务 

处理某项任务时 , 可添加工作记录 , 以指示所作的工作及所花费的时间。例如 , 假设您 

的任务是邀请媒体 , 您获得了一个 25 位记者的名单 , 需要给他们打电话。如果您为执行 

此任务 , 第一天工作一小时 , 第二天工作三小时 , 则您应输入两个工作记录 , 每天一个。 

您也可以对此项任务进行其它更改。例如 , 如果联系不上某一位记者 , 您可能要使用 

Notes( 说明 ) 选项卡做一个注释或使用 Task( 任务 ) 选项卡上的 Needs Attention( 需 

要注意 ) 复选框让其他人介入此问题。 

将工作添加到任务或子任务 : 


■ 

双击该任务。从随后出现的 Task properties ( 任务属性 ) 对话框中 , 选择 Work 

( 工作 ) 选项卡 , 然后单击 Add ( 添加 )。 

■ 

选择该任务。从菜单栏中选择 Task ( 任务 ) > Add Work ( 添加工作 )。 

Add 

Work 

■ 

选择该任务。单击工具栏上的 Add Work ( 添加工作 )。 

出现 Work Record ( 工作记录 ) 对话框并在 User Name ( 用户名 ) 下拉列表框中显 

示您的名称。 

2 从下拉日历中输入或选择工作记录的日期。 

3 在 Work ( 工作 ) 文本框中输入工作的小时数。 

4 在 Remaining Work ( 剩余工作 ) 文本框中输入完成该任务的工作所需的小时数。 

5 在 Comments ( 注释 ) 文本框中输入任务已进行的进度的说明。 

第 11 章 : 管理任务 205

向任务添加说明 

向任务添加说明 

编辑工作记录 : 

1 选择 Work ( 工作 ) 选项卡。 

2 从 Work Records ( 工作记录 ) 列表中选择工作记录。 

3 单击 Edit ( 编辑 )。出现 Work Record ( 工作记录 ) 对话框。 

4 编辑任何字段 , 然后单击 OK ( 确定 )。 

删除工作记录 : 

1 选择 Work ( 工作 ) 选项卡。 

2 从 Work Records ( 工作记录 ) 列表中选择工作记录。 

3 单击 Delete ( 删除 )。出现 “Delete Work Record?”( 删除工作记录 ?) 消息。 

4 单击 Yes ( 是 )。 

使用 Notes ( 说明 ) 选项卡可提供有关任务的其它信息。 

向任务添加说明 : 

1 从 Task ( 任务 ) 属性对话框 , 选择 Notes ( 说明 ) 选项卡。 

2 在 Notes ( 说明 ) 文本框中输入有关该任务的其它信息或说明。 


为任务设置自定义属性字段 

为任务设置自定义属性字段 

您可能无法进行存储库自定义 , 这取决于客户机或服务器的许可证。如果您的管理员已 

创建了额外的任务属性 , 您可能需要为每个任务填写这些属性。StarTeam 管理员指南 

提供了有关创建自定义字段的信息。 

设置自定义属性字段 : 

1 从 Task ( 任务 ) 属性对话框 , 选择 Custom ( 自定义 ) 选项卡。 

2 双击自定义属性的名称。 

出现 Edit Property ( 编辑属性 ) 对话框。 

3 为该属性选择一个新值 , 然后单击 OK ( 确定 )。 

■ 


■ 


■ 

对于日期和时间 ,Value ( 值 ) 有一个日期复选框和一个时间复选框 , 每个复选框 

后面都接有用当前区域的格式表示的日期或时间。 

4 为其它自定义属性重复步骤 2 和 3。 

第 11 章 : 管理任务 207

包含附件 

包含附件 

使用 Attachments ( 附件 ) 选项卡可在任务中包含屏幕快照和文档。 

向任务添加附件 : 

1 选择 Attachments ( 附件 ) 选项卡。 

2 单击 Add ( 添加 )。出现 Open ( 打开 ) 对话框。 

3 选择文件 , 然后单击 Open ( 打开 )。所选项出现在 Attachments ( 附件 ) 列表中。 

4 为其它文件重复步骤 2 和 3。 

最多可为一个项附加 64 个文件。 

从任务删除附件 : 


2 从 Attachments ( 附件 ) 列表中选择文件。 

3 单击 Remove ( 删除 )。从该任务中删除此附件。 

以新名称保存此附件 : 


2 从 Attachments ( 附件 ) 列表中选择文件。 

3 单击 Save As ( 另存为 )。出现 Save As ( 另存为 ) 对话框。 

4 输入此文件的新名称 , 然后单击 Save ( 保存 )。 


为任务修订加入注释 

为任务修订加入注释 

在 Task properties ( 任务属性 ) 对话框中修改一项或多项属性后 , 单击 OK ( 确定 ), 

StarTeam 将创建该任务的新修订。应在单击 OK( 确定 ) 前添加修订注释或说明 , 用以 

解释进行修订的原因。 

提供修订注释 : 

1 选择 Comment ( 注释 ) 选项卡。 

修改任务属性 

2 输入修订注释。 

您可以随时查看和编辑任务属性 ( 只要具有执行此操作的安全权限 )。 

修改任务的属性 : 


■ 

在任务列表或任务树中双击任务。 

Properties 

■ 

选择某项任务 , 然后在工具栏上单击 Properties ( 属性 )。 

■ 

选择某项任务 , 然后从 Task ( 任务 ) 或上下文菜单中选择 Properties ( 属性 )。 

出现 Task properties ( 任务属性 ) 对话框。 

2 选择任何选项卡 (Task( 任务 )、Time( 时间 )、Work( 工作 )、Notes( 说明 )、 

Custom ( 自定义 )、 Attachments ( 附件 ) 或 Revision Comment ( 修订注释 )), 

然后开始编辑。 

第 11 章 : 管理任务 209


章 

管理主题 

第 12 章 

主题可就项目提出一般问题 , 也可就问题 ( 如功能实现 ) 开始非常具体的讨论。尽管对 

主题的响应可使这些问题得以解决 , 但是与项目间的这些对话的历史值甚至可能更加重 

要。将来的团队成员可以 : 

■ 

■ 

提高重新评估决策的能力 

避免再次尝试先前发现有缺陷的解决方法 

■ 

了解某个问题的特定解决办法变成必要的解决办法的原因 , 从而不会用不符合所有必 

要条件的解决方法来代替该解决方法 

团队成员可使用主题执行以下操作 : 

■ 

在主题和响应中搜索特定的词或短语 

■ 

对主题和响应进行排序 

■ 

对主题和响应进行筛选 

■ 

查看主题与其响应之间的关系 

■ 

移动和共享主题 ( 通过树格式 ) 

重要说明 

上部窗格由主题和每个主题的一系列响应组成。主题树系列是最后形成的 , 每个树都由 

一个根主题及其响应组成。主题树类似于可在几个人之间进行的对话。在 StarTeam 中 , 

它被称为线索化对话 , 其原因是主题及其响应被以线索形式合在一起 , 以根主题为开始。 

通过在线索中逐个读取每个响应以及对这些响应所作出的响应 , 可以看到该讨论是如何 

演化的。 

可以对主题或响应执行许多其它操作 , 例如移动或共享它们。有关详细信息 , 请参阅 

第 223 页的 “ 执行一般性操作 ”。 

本章说明如何使用标准属性对话框创建和编辑主题与响应。根据您团队对 StarTeam 

的设置 , 您可能会看到完全不同的、称为备选属性编辑器 (APE) 的主题对话框。 

第 12 章 : 管理主题 211

在上部窗格中使用主题 


All 

Descendants 

选择 Topic ( 主题 ) 选项卡后 , 上部窗格将以树或列表格式显示主题。此外 , 所显示的 

主题取决于以下所有条件 : 

■ 

■ 

■ 

从左侧窗格内的文件夹层次中选择的 StarTeam 文件夹 

从上部窗格上方的 Filter ( 筛选器 ) 下拉列表中选择的筛选器 ( 有关详细信息 , 请参 

阅第 214 页的 “ 使用主题筛选器 ”) 

通过 All Descendants ( 所有后代 ) 按钮或通过从 Topic ( 主题 ) 菜单选择 All 

Descendants ( 所有后代 ) 指定的深度 

■ 


格中管理数据 ”)。仅当主题处于列表模式时 , 才能对它们进行排序。 

下部窗格下面的状态栏可以显示主题的总数和在树或列表视图中选择的主题数。 

在列表或树格式中选择某个主题或响应后 , 通过下部窗格的选项卡可以 : 

■ 

(Detail( 详细信息 ) 选项卡 ) 查看将在上部窗格中显示的属性 ( 如果选择了列表格式 ) 

■ 

■ 

■ 

■ 

■ 

(History ( 历史 ) 选项卡 ) 检查其修订历史 

(History ( 历史 ) 选项卡和右键单击显示上下文菜单 ) 编辑修订注释 

(History ( 历史 ) 选项卡和右键单击显示上下文菜单 ) 比较两个主题或响应的修订 

(Link ( 链接 ) 选项卡 ) 查看为它创建的任何链接 

( 单击 Label ( 标签 ) 选项卡 ) 查看、附加和分离标签 

■ 

( 单击 Reference ( 引用 ) 选项卡 ) 查看所选文件的引用 

以下是主题的使用方法 : 

■ 

要在文件夹层次中将一个主题树或它的一个分支从一个文件夹移动到另一个文件夹 

( 或从一个视图移动到另一个视图 ) , 请将该主题或分支拖动到其新文件夹。如果移 

动某个主题 , 它将成为其新位置中的主题。 

■ 

使用 Ctrl 加上拖放可共享主题和响应。 

■ 

双击主题可显示其属性。 

■ 

使用 Topic ( 主题 ) 菜单或在主题树窗格中右键单击可显示上下文菜单。 

List 

Display 

■ 

按 Shift + F5 可刷新整个视图 , 按 F5 可只刷新任务列表。按 Ctrl + F5 刷新上部窗格 , 同 

时折叠所有打开的组。 

■ 

使用 List Display ( 列表显示 ) 按钮可以列表格式查看主题和响应。 

■ 

使用 Tree Display ( 树显示 ) 按钮可以树格式查看主题和响应。 

Tree 

Display 




在下图中 , 选择了 Tree Display ( 树显示 ) 按钮。主题和响应的默认顺序是其树顺序。 

每个主题及其响应构成可展开的主题树 : 

提示 

使用树格式时 , 您可以看到主题和其响应之间的关系。例如 , 响应可以对主题本身或对 

另一响应进行评论。 


可展开的分支或主题树 ; 可通过单击将其展开。 

已展开的分支或主题树 ; 可通过单击将其折叠。 

从 Topic ( 主题 ) 菜单或上下文菜单选择 Expand All ( 全部展开 ) 和 Collapse All ( 全 

部折叠 ) 可完全展开或折叠所有树。 

已读的主题。 

未读主题或其中的一些响应尚未被读取的主题。 

响应 

未读响应或其分支中某处具有未读响应的响应。红色标志可将您引至未 

读项。 

第 12 章 : 管理主题 213

使用主题筛选器 


在下图中 , 选择了 List Display ( 列表显示 ) 按钮。未显示任何关系。 

提示 


■ 

■ 

■ 

将特定字段的值作为数据列查看。例如 , 可以查看每个主题的状态列 , 其中包含每个 

状态类型的图标 : 

活动主题 

非活动主题 

对主题和响应进行排序 

可以单击某个列标题来按该列中的值对行进行排序。再次单击可颠倒排列顺序。例 

如 , 单击 Created Time ( 创建时间 ) 列可查看最新输入的主题和响应。 

可重新排列字段、显示不同字段、对最多四个列进行排序、使用组带区和对主题列表 



的 “ 创建查询 ” 和第 78 页的 “ 使用筛选器 ”。还可以对主题和响应树进行查询和筛 

选。 

使用主题筛选器 

从 Filter ( 筛选器 ) 下拉列表框中选择一个筛选器可以很容易地找到与筛选器匹配的主 

题和响应。各选项卡的一组默认筛选器随 StarTeam 提供。但是 , 您可能看不到下面列 

出的所有 ( 或任何一个 ) 筛选器 , 这取决于贵公司在开始时所用的 StarTeam 的原始发 

行版以及您和您的团队成员对筛选器所做的更改。 


创建主题 


(< 我是 

收件人 >) 

标识所有将您指定为收件人的主题。 

By Creator ( 按创建者 ) 

Show Active ( 显示活动 ) 

标识所有具有 Active ( 活动 ) 状态的主题 

和响应。 

Show All ( 全部显示 ) 标识所有主题和响应。 

可以自定义主题筛选器。某些建议如下 : 

Created By = 仅标识某人 ( 您 ) 提交的主题。 

Hot Topics = 

 

仅标识被分配给高优先级的主题和响应。 

可以自定义主题筛选器。某些建议如下 : Created By = , 仅标识某人 ( 您 ) 

提交的主题 ; Hot Topics = , 仅标识被分配给高优先级的主题和响应。 

创建主题 

要启动线索化对话 , 必须先创建一个主题。 

创建主题 : 


2 选择 Topic ( 主题 ) 选项卡。 Topic ( 主题 ) 菜单将出现在菜单栏上 , 而主题则出现 

在上部窗格中。 

3 要创建主题 , 请执行以下一项操作 : 

■ 

从 Topic ( 主题 ) 或上下文菜单中选择 New ( 新建 )。 

New 

■ 

单击工具栏上的 New ( 新建 )。 

第 12 章 : 管理主题 215

创建主题 

出现 New Topic ( 新建主题 ) 对话框 , 其中的 Topic ( 主题 ) 选项卡被选定。 

4 在 Title ( 标题 ) 文本框中输入标题。 

5 在 Content ( 内容 ) 文本框中输入交流信息。 

6 ( 可选 ) 如果要将此主题只通知给特定的团队成员 , 请选择 Options( 选项 ) 选项卡、 

分配优先级或指定状态。 

a 要就某个主题通知特定的团队成员 , 请单击 Add ( 添加 ) 。将出现 Select Topic 

Recipients ( 选择主题收件人 ) 对话框。 

所有团队成员均可阅读主题 , 但通知过程只能限于少数重要人员。 

b 从列表中选择团队成员 , 然后单击 Add ( 添加 )。 

c 单击 OK ( 确定 ) 返回 New Topic ( 新建主题 ) 对话框。 

d 

要为主题分配一个优先级 , 请从 Priority( 优先级 ) 下拉列表框中选择 “ 低 ”、“ 正 

常 ” 或 “ 高 ”。 

e 要指示主题状态 , 请在下拉列表框中选择 Active ( 活动 ) 或 Closed ( 已完结 )。 

主题状态的默认值为 “ 活动 ”。 

7 ( 可选 ) 选择 Custom ( 自定义 ) 选项卡。 

如果贵公司购买了 Repository Customization ( 储存库自定义 ) 功能 , 则管理员可能 

已创建了其它主题属性。 StarTeam 管理员指南可提供有关创建自定义字段的信息。 



■ 


■ 



回复主题或响应 

■ 


框后面都跟有以您所在地区的格式表示的日期或时间。 

c 对于其它自定义属性 , 重复步骤 a 到 b。 

8 ( 可选 ) 选择 Attachments ( 附件 ) 选项卡可将文件 ( 如图形 ) 附加到主题。 

a 单击 Add ( 添加 )。将出现 Open ( 打开 ) 对话框。 



d 要进行其它附加 , 可重复以上步骤。 

最多可为一个项附加 64 个文件。 

注可通过选择一个附件并单击 Remove ( 删除 ) 的方式删除该附件。 

1 ( 可选 ) 选择 Comment ( 注释 ) 选项卡可在 Comment For New Revision ( 新修订 

的注释 ) 文本框中添加附加说明或注释。 

2 单击 OK ( 确定 )。 

当上部窗格使用树格式时 , 主题树窗格中将出现图标、主题的标题、您的用户名和时 

间戳。 

当上部窗格使用列表格式时 , 主题列表中的默认列显示相同的信息。主题列表有一个附 

加列 Description ( 说明 ), 它显示主题文本中的前几个词。 

回复主题或响应 

修改主题和响应属性 

要参与线索化对话 , 需要对主题或其一个或多个响应进行响应。 

对主题或响应进行响应 : 

1 从主题列表或主题树窗格中选择主题或响应。 

2 单击 Topic ( 主题 ) 或上下文菜单中的 Respond ( 响应 )。出现 New Topic ( 新建 

主题 ) 对话框。 

3 在 Title ( 标题 ) 文本框中输入标题。 

4 在 Content ( 内容 ) 文本框中输入交流信息。 

5 按照第 215 页的 “ 创建主题 ” 中的步骤 6 到 10 进行操作。 

可修改以下主题和响应属性 : 

■ 

主题或响应的标题和文本 

■ 

Priority ( 优先级 )( 如 “ 低 ”、“ 正常 ” 或 “ 高 ”) 

■ 

Status ( 状态 )( 例如活动和非活动 ) 

■ 

Recipients ( 收件人 )( 接收主题或响应的人员列表 ) 

■ 

Attachments ( 附件 )( 主题或响应中包含的附加文件 ) 

重要说明 

■ 

■ 

任何自定义字段的值 

添加附加修订注释或说明 

修改属性并单击 Apply ( 应用 ) 或 OK ( 确定 ) 后 , StarTeam 将创建主题或响应的 

一个新修订。也可添加用于解释修订原因的修订注释或说明。 

如果对主题的更改只是要删除收件人 , 则在自己作为收件人时将无法将自己删除 — 

除非删除所有收件人。在未指定收件人时 , 包括您在内的所有人都可收到关于此主题 

第 12 章 : 管理主题 217

的通知 , 此时您可将自己删除。在指定收件人时 , StarTeam 不允许您将身为主题收 

件人的您自己删除。 

修改主题或响应属性 : 

1 从文件夹层次中选择主题或响应被附加到的文件夹。 

2 从上部窗格中选择 Topic ( 主题 ) 选项卡。 


■ 

双击主题或响应。 

Properties 

■ 

选择主题或响应 , 然后单击工具栏上的 Properties ( 属性 )。 

■ 

选择主题或响应 , 然后从 Topic ( 主题 ) 菜单、上下文菜单或 History ( 历史 ) 上 

下文菜单中选择 Properties ( 属性 )。 

出现 Topic Properties ( 主题属性 ) 对话框。 

4 更改属性的设置。 


章 

使用审核日志 

第 13 章 

审核日志是由 StarTeam 保留的按年代顺序排列的记录。它存储与对文件夹和项执行的 

操作相关的数据。下图显示了一个样例项目的审核日志 : 

不能移动、共享、修改或分支审核日志条目。 

可以对审核日志条目执行许多其它操作 , 例如按属性搜索审核条目或者以电子邮件形式 

从 StarTeam 发送一个条目。有关详细信息 , 请参阅第 223 页的 “ 执行一般性操作 ”。 

如果选择上部窗格上的 Audit ( 审核 ) 选项卡 , 而审核日志为空 , 则管理员已从服务器 

将审核日志禁用。 

如果启用审核日志 , 则它将列出满足下列条件的条目 : 

■ 

附加到从文件夹层次选择的文件夹 

■ 

与通过 All Descendants ( 所有后代 )( 可在工具栏上单击该按钮 , 也可从 Audit ( 审 

核 ) 菜单中选择 All Descendants ( 所有后代 )) 指定的深度相匹配 

■ 

与从 Filter ( 筛选器 ) 下拉列表框中选择的筛选器相匹配 

第 13 章 : 使用审核日志 219

使用审核日志筛选器 

审核日志中的每个条目都包含几个字段 , 每个字段都有其自己的列标题。通常显示以 

下列 : 

User ( 用户 ) 执行操作的人员。 

Created Time ( 创建时间 ) 操作的日期和时间。 

Class Name ( 类名称 ) 项类型 : 文件、文件夹、更改请求、主题或任务。 

Event ( 事件 ) 

操作名称 , 例如 Created ( 创建 )、 Added ( 添加 )、 Deleted 

( 删除 )、 Modified ( 修改 )、 Branched ( 分支 )、 Moved 

From ( 移动自 )、 Shared ( 共享 )、 Locked ( 锁定 )、 

Unlocked ( 解除锁定 )、 Moved to ( 移动至 ) 或 Lock broken 

( 中断锁定 )。 

View ( 视图 ) 项所在的视图名称。 

Project ( 项目 ) 视图所在的项目名称。 

注 

筛选器或查询可为一个特定项查找所有条目。例如 , 要查看与更改请求号 1030 相关 

的所有条目 , 可以创建一个查询 , 搜索更改请求号为 1030 的每一个项的所有条目。 

单击某个列标题以按该列中的值对显示的条目进行排序。可以按升序、数字顺序、字母 

数字顺序或关键字进行排序 , 具体排序方式将视数据而定。要将排序顺序从升序更改为 

降序 , 请再次单击标题 , 反之亦然。主要排序列的标题中将显示一个方向箭头。 

使用 All Descendants( 所有后代 ) 按钮从文件夹层次中选择审核条目。( 也可以从 

Audit ( 审核 ) 菜单中选择 All Descendants ( 所有后代 )。) 从 Audit ( 审核 ) 菜单或上 

下文菜单中选择 Audit ( 审核 ) > Select ( 选择 ) >All( 所有 ) 可同时选择所有条目。 

选择一个审核条目。选择下部窗格上的 Details ( 详细信息 ) 选项卡以在下部窗格中显 

示该条目的相关数据。由于审核条目没有历史且不能被链接 , 所以 History ( 历史 ) 和 

Link ( 链接 ) 选项卡不可用。 

选择一个或多个条目后 , 使用 Audit ( 审核 ) 菜单或右键单击以显示上下文菜单。 

可重新排列字段、显示不同字段、对最多四个列进行排序、使用组带区和对审核日志中 

的数据应用查询。可将对数据执行的操作保存为查询或筛选器。请参阅第 67 页的 “ 控 

制列 ”、第 68 页的 “ 对数据排序和分组 ”、第 70 页的 “ 使用查询 ”、第 71 页的 “ 创 

建查询 ” 和第 78 页的 “ 使用筛选器 ”。 

按 Shift + F5 刷新整个视图 , 或者按 F5 仅刷新审核列表。按 Ctrl + F5 可刷新上部窗格并同 

时折叠所有打开的组。 

从上部窗格中的审核日志中选择一个审核条目后 , 可使用下部窗格中的选项卡来查看显 

示在上部窗格中的该审核条目的属性 ( 单击 Detail ( 详细信息 ) 选项卡 ) 

可以对审核日志条目执行许多其它操作 , 例如按属性搜索审核条目或者以电子邮件形式 

从 StarTeam 发送一个条目。有关详细信息 , 请参阅第 223 页的 “ 执行一般性操作 ”。 

使用审核日志筛选器 

使用筛选功能可限制审核日志中所显示的条目的种类和数量。从审核日志上方的 Filter 

( 筛选器 ) 下拉列表框中选择一个筛选器。在文件夹层次进行的选择以及是否单击了 All 

Descendants ( 所有后代 ) 按钮 , 将会影响所显示的项。 


Show All ( 全部显示 ) 显示所有审核条目。 

By Class and Event 显示按 Class Name 1 ( 类名称 1) 字段 ( 文件夹、 

( 按类和事件 ) 

文件、更改请求、主题、任务、标签或链接 ) 和 

Event ( 事件 )( 添加、修改、删除、移动自、移动 

至、共享、创建、锁定、解除锁定、编辑注释、创建 

标签、附加标签、修改提升模型等 ) 中的值进行排序 

的审核条目。 


审核日志事件 

提示可创建和自定义筛选器。有关详细信息 , 请参阅第 78 页的 “ 使用筛选器 ”。 

有关创建审核筛选器的一些建议 : 

■ 

要仅显示已修改的条目 , 请使用 Event ( 事件 ) 字段。 

■ 

要仅显示与对更改请求所执行的操作相关的条目 , 请使用 Class Name ( 类名称 ) 

字段。 

■ 

要仅显示从指定日期到现在所创建的条目 , 请使用 Created Time( 创建时间 ) 字段。 

■ 

要仅显示与指定用户执行的操作相关的条目 , 请使用 User ( 用户 ) 字段。 


事件是对所有者执行的操作。例如 , 可签入某个文件或从版本控制删除某个文件。此类 

事件将被记录在审核日志中。可对多数项执行以下操作 : 

■ 

Added ( 添加 ) 

■ 

Branched ( 分支 ) 

■ 

Comment Edited ( 编辑注释 ) 

■ 

Created ( 创建 ) 

■ 

Deleted ( 删除 ) 

■ 

Locked ( 锁定 ) 

■ 

Lock Broken ( 中断锁定 ) 

■ 

Modified ( 修改 ) 

■ 

Moved From ( 移动自 ) 

■ 

Moved To ( 移动至 ) 

■ 

Shared ( 共享 ) 

■ 

Unlocked ( 解除锁定 ) 

此外 , 还可以对文件执行以下操作 : 

■ 

Converted ( 转换 ) 

■ 

Edited ( 编辑 ) 

■ 

Item Overwritten ( 改写项 )( 外部存档文件变为本地文件时 ) 

■ 

Vault ( 储存仓 ) 

第 13 章 : 使用审核日志 221


可以对标签执行以下操作 : 

■ 

Created ( 创建 ) 

■ 


■ 

Deleted ( 删除 ) 

■ 

Frozen ( 冻结 ) 

■ 

Unfrozen ( 解冻 ) 

■ 

Attached ( 附加 ) 

在这种情况下 , Item 1 ( 项 1) 是标签 , Item 2 ( 项 2) 是附加了标签的项 , 而 Item 

2 Info ( 项 2 信息 ) 是对该项的修订。 

■ 

Moved ( 移动 ) 

在这种情况下 , Item 1 ( 项 1) 是标签 , Item 2 ( 项 2) 和 Item 3 ( 项 3) 都是附加 

了标签的项 , Item 2 Info ( 项 2 信息 ) 是对现在附加了标签的项的修订 , Item 3 Info 

( 项 3 信息 ) 是对先前附加了标签的项的修订。 

■ 

Detached ( 分离 ) 

在这种情况下 ,Item 1( 项 1) 是标签 ,Item 2( 项 2) 是不再附加标签的项 , 而 Item 

2 Info ( 项 2 信息 ) 则是对分离了标签的项的修订。 

可对提升模型执行以下操作 : 

■ 


可对提升状态执行以下操作 : 

■ 


在这种情况下 ,Item 1( 项 1) 是状态 ,Item 2( 项 2) 是分配给状态的标签 , 而 Item 

3 ( 项 3) 则是先前分配给状态的标签。 


章 

执行一般性操作 

第 14 章 

对文件夹和组件项 ( 文件、更改请求、需求、任务和主题 ) 执行的许多操作会产生相似 

的效果 , 因此被视为一般性操作。下表简要概括可以和不可以对文件夹和组件执行的一 

般性操作。本章稍后将更深入地解释这些操作中的许多操作。但特定于某个组件的操作 

将在有关该组件的章节介绍。 

表 14.1 

文件夹和项的一般性操作 

操作文件夹文件更改请求需求任务主题审核 

移动 

将项拖动到新位置 

是 

移动文件夹 

时其内容、 

子文件夹及 

其内容随之 

移动。 

是是是 , 除了使 

用 Microsoft 

Project 集 

成时 

创建项的快捷方式否是是是是否 

共享 

按住 Ctrl 键拖动项到 

新位置 

是是是是是是否 

分支行为 

分支发生在视图级 , 

但可在项级控制分支 

行为 ( 即某个项更改 

时它是否分支 ) 

是 

将文件夹 

分支并不会 

使其内容或 

子项分支 

是是否否否否 

配置到或冻结于过去是是是是是是否 

某个时间点 

锁定否是是是是是否 

比较同类型两个项的否是是是是是否 

属性 

比较两个修订的属性是是是是是是否 

查看修订历史是是是是是是否 

查看修订属性是是是是是是否 

编辑修订注释是是是是是是否 

合并修订 

否 , 除非在 

合并视图过 

程中 , 此操 

作通常由管 

理员完成 

是 , 使用 

Visual 

Merge 



程中 



程中 



程中 

是 

否 , 除非 

在合并视 

图过程中 

否 

否 

第 14 章 : 执行一般性操作 223

执行一般性操作 

表 14.1 文件夹和项的一般性操作 ( 续 ) 

操作文件夹文件更改请求需求任务主题审核 

基于字段内容查找否是是是是是是 

通过查询选择 

请参阅第 70 页的 

“ 应用现有查询 ”。 

否是是是是是是 

通过标签选择 


“ 为项加标签 ”。 

为修订加标签 


“ 为文件夹加标签 ” 

和第 257 页的 “ 为项 

加标签 ”。 

查看参考 


“ 使用引用 ”。 

链接到文件夹和项 


“ 使用链接 ”。 

打印 

此操作打印所选项的 

默认报告 

否是是是是是否 




否是是是是是否 

以电子邮件发送项否否是是是是是 

接收有关更改的电子 

邮件通知 ( 当管理员 

启用通知时 ) 

控制系统托盘通知 


“ 控制系统托盘通 

知 ”。 

将项标记为已读 / 未 

读。请参阅第 239 页 

的 “ 将项标记为已读 

或未读 ”。 

否否是 

仅 “ 责任 ” 

中的更改 

是 

您所负责的 

项中的所有 

更改 

是 

您所负责的 

项中的所有 

更改 

是 

您为收件 

人的项中 

的所有更 

改 

否否是是是是否 

否否是 

也可将树标 

记为已读 / 

未读 

是 


记为已读 / 未 

读 

是 


记为已读 / 

未读 

是 

也可将树 

标记为已 

读 / 未读 

为项加标志否是是是是是否 

删除是是是是是是否 

设置访问权限。通常 , 

此功能由管理员执 

行。请参阅 StarTeam 



创建报告。请参阅 

第 281 页的 “ 报告和 

导出数据 ”。 

窗格图表。请参阅 

第 293 页的 “ 使用图 

表 ”。 



否 

否 


在项目视图之间移动文件夹和项 

在项目视图之间移动文件夹和项 

注 

可将文件夹和项从一个项目视图移动到另一个 , 只要这两个视图使用相同的服务器配 

置。也可在相同视图中将它们从一个位置移动到另一个。 

移动某个文件夹时 , 该文件夹的内容 ( 包括其子文件夹以及子文件夹中的内容 ) 随该文 

件夹一起移动。 

移动某个项 ( 文件、更改请求、任务或主题 ) 后 , 它属于新项目视图。但项行为、配置 

和其它属性不会更改。项会失去一个属性 , 即它的标签 , 也就是说它在以前视图中拥有 

的所有标签都将丢失。其原因是标签不能在视图之间移动。 

如果将视图回滚至更早的时间点 , 它将不再显示已移动的文件夹和 / 或项。 

有时 , 对于移动的文件夹、文件或更改请求 , 其禁用的 Branch On Change ( 更改时分 

支 ) 复选框会变为启用 , 因为移动的文件夹或项已传播到其它视图。( 任务和主题不具 

有分支行为。) 

启用 Branch On Change( 更改时分支 ) 复选框后 , 更改请求的工作流会受到以下的影响 : 

■ 

■ 

■ 

如果某个更改请求中的 Last Build Tested ( 最后测试的内部版本 ) 和 Addressed In 

Build ( 解决请求的内部版本 ) 字段以内部版本标签作为字段值 ( 换言之 , 如果这些 

字段不为空且不含 “Next Build”( 下一个内部版本 ) 值 ), 则移动的更改请求将保留 

这些值。 

在新视图中 , 可以更改这些值 , 但只能更改新视图现有的内部版本标签名。 

如果在移动时 ,Addressed In Build( 解决请求的内部版本 ) 字段的值为 “Next Build” 

( 下一个内部版本 ), 则 “Next Build”( 下一个内部版本 ) 值会由要在原始视图中创 

建的下一个内部版本标签 ( 而不是在新视图创建的下一个内部版本标签 ) 的名称替 

换。即使在新视图中对此更改请求进行了其它更改时也是如此。 

如果在移动时 , 更改请求的 Last Build Tested( 最后测试的内部版本 ) 和 Addressed 

In Build ( 解决请求的内部版本 ) 字段中没有任何值 , 则其工作流特定于新视图。 

本节上一段有关标签和工作流的注释也适用于在父视图和从中派生的分支视图中 

都出现的文件夹和项。但是 , 更改请求的工作流是在其分支时 ( 而不是在其移动 

时 ) 受 Last Build Tested( 最后测试的内部版本 ) 和 Addressed In Build( 解决请 

求的内部版本 ) 字段中的值影响。 

管理员通常负责合并更改请求并控制在合并过程中哪些属性最终出现在哪些视图 

中。但合并更改请求也会产生以上所解释的结果。例如 , 在分配了 “Next Build” 

( 下一个内部版本 ) 值的视图中 , 下一个视图标签变为 Addressed In Build ( 解决 

请求的内部版本 ) 字段的值 , 而不管合并的更改请求现在位于哪个视图。 

在项目之间移动文件夹或项 : 

1 从菜单栏中选择 Project ( 项目 ) > Open ( 打开 ) 以打开第一个及另一个视图窗口。 

确保两个项目视图都可以看到。可能需要重新调整窗口的大小。 

如果在相同视图中将文件夹或项从一个位置移动到另一个 , 只需要打开一个视图。 

2 将要移动的文件夹或项从一个项目视图拖动到另一个视图中的某个文件夹。 

3 出现要求确认的消息框 , 单击 Yes ( 是 )。 

注意不能移动已从 MS Project 导出到 StarTeam 的任务和子任务。 

创建项的快捷方式 

为了能很容易地访问到正在跟踪的项 , 可以将这些项的快捷方式保存在桌面上。打开快 

捷方式时 , 将启动 StarTeam, 以创建快捷方式时项目视图的配置打开该项目视图 , 显示 

项的 Properties ( 属性 ) 对话框。 

保存某个项的快捷方式 : 

1 从上部窗格选择某个文件、更改请求、主题或任务。 


与其它视图共享文件夹和项 

2 从项或上下文菜单中选择 Save Shortcut( 保存快捷方式 )。出现 Save As( 另存为 ) 

对话框。 

3 在 File Name ( 文件名 ) 文本框中为此快捷方式输入名称或使用默认名称。切勿更改 

扩展名 .stx。 

4 选择存储此项快捷方式的位置 , 通常是桌面。 

5 单击 Save ( 保存 )。 

要使用快捷方式打开项 , 请执行以下一项操作 : 

■ 

从桌面或 Windows 资源管理器双击该快捷方式。 

■ 

从菜单栏中选择 Project ( 项目 ) > Open Shortcut ( 打开快捷方式 )。在随后出现的 

Open ( 打开 ) 对话框中 , 选择该快捷方式的名称 , 然后单击 Open ( 打开 )。 

登录后 , 出现项的 Properties ( 属性 ) 对话框。 

与其它视图共享文件夹和项 

如果两个视图属于使用相同服务器配置的项目 , 则可在这两个视图间共享文件夹和项。 

某个文件夹共享后 , 这两个视图的用户都可以访问其内容 , 包括子文件夹及其内容。也 

可在相同视图中的两个位置共享文件夹或项。 

共享文件夹是设置视图的一个重要部分。例如 , 假设所有产品都使用公司常规库的一部 

分。虽然这些库不是由特定产品的开发者维护 , 但该产品基于源代码的某个修订 , 因此 

必须使用这些库进行编译。所以 , 该产品的视图中应包含某些库文件夹。 

在新视图中共享某个项 ( 文件夹、文件或更改请求 ) 时 , 其在此新视图中的行为由称为 

Set Items Shared Into View To Branch On Change( 将共享到视图的项设置为在更改时 

分支 ) 的属性控制。该项在原始视图中的行为对其在新视图中的行为无任何影响。而且 , 

如果父视图是参考视图 ( 即不允许分支的视图 ), 则新视图不继承父视图的属性。在此 

情况下 , 父视图的设置控制共享项的 Branch On Change ( 更改时分支 ) 设置。 

任务和主题不具有分支行为 , 所以此视图属性不影响它们。 

最初 , 共享的文件夹或项的配置 ( 浮动 , 基于标签、提升状态或某时间点 ) 在两个视图 

中是相同的。但可以在任一视图中对此配置进行修改。也就是说 , 共享的项在每个视图 

中可以不同。 

共享的文件夹或项会丢失其在以前视图中的任何标签。标签不能在视图间移动。但共享 

的文件夹或项将拥有在新位置附加的所有标签 , 而不管它们是否分支。 

注意共享已从 MS Project 导出的任务时 , 必须从根任务开始共享整个任务树。 

要冻结共享的文件夹 , 可将它们中的每一个配置到特定日期和时间。有关详细信息 , 请 

参阅第 229 页的 “ 重新配置文件夹和项 ”。 

在视图之间共享文件夹或项 : 

1 从菜单栏中 , 选择 Project ( 项目 ) > Open ( 打开 ) 以打开项目视图 , 然后打开另一 

个项目视图窗口。确保两个项目视图都可以看到。如果必要 , 可重新调整窗口的大小。 

如果在相同视图中将文件夹或项从一个位置共享到另一个 , 则只需打开一个视图。 

2 按住 Ctrl 键 , 将要共享的文件夹或项从一个视图拖动到另一个视图的某个文件夹。 

3 出现要求您确认的消息框。单击 Yes ( 是 )。 

共享文件夹或项时 , 务必注意以下情况 : 

■ 

避免循环共享。将文件夹或项 ( 如文件 ) 共享回原始位置时会发生循环共享。例如 , 

可能按以下方式共享了同一个文件夹 : 从第一个视图共享到第二个视图 , 从第二个视 

图到第三个视图 , 然后从第三个视图回到第一个视图。共享回第一个视图使此例成为 

循环共享。 

■ 

删除共享文件夹或项的原始项不会使共享的项成为孤立项。请记住 , 实际上没有从 

StarTeam 删除任何项。 


了解分支 

注 

■ 

■ 

■ 

避免冗余共享。一个共享与其它共享相同时发生冗余共享。例如 , 如果多次地将相同 

文件夹从第一个视图共享到第二个视图 , 则产生冗余共享。而且 , 此相同共享文件夹 

包含存储在相同工作文件夹的同名文件。 

从一个文件夹签出文件时 , 将会覆盖来自另一个文件夹的对应文件 , 导致文件状态 

出错。 

如果将文件夹或项共享到参考视图时 , 则它也将共享到父视图 , 因为父视图是参考视 

图的源。这是冗余共享的另一个示例。 

如果某个项目超过三分之一的部分由共享到该项目的文件夹或项组成 , 则可能应该重 

新考虑该项目的结构。它可能不必如此复杂。而且 , 大量共享可能导致某些性能问题。 

了解分支 

注 

了解分支行为是很重要的 , 因为创建分支视图 ( 即允许分支的视图 ) 时 , 最终必须决定 

是否选择 Branch All ( 全部分支 ) 选项或 Branch None ( 无分支 ) 选项。在创建视图 

时 , 您的决定将影响从父视图派生来的新视图中的每个项。 

如果子视图中的项的行为设置为允许分支和 Branch On Change ( 更改时分支 ), 则当 

其发生更改时 , 会发生分支。某个项分支时 , 该项与父视图中对应项之间发生分离。这 

些项也开始具有不同的分支修订号。当某个项分支时 ,StarTeam 不再发送或应用来自父 

视图对应项的更新。 

分支时 , 请注意以下情况 : 

■ 

如果选择 Branch All ( 全部分支 ), 则系统会将创建该视图时其中每个项的行为都设 

置为 Branch On Change ( 更改时分支 )。 

■ 

■ 

如果选择 Branch None ( 无分支 ), 则不会将在创建该视图时其中每个项的行为设置 

为 Branch On Change ( 更改时分支 )。换言之 , 对于具有浮动配置的任何项 , 项的 

更改都可传播至父视图。( 这些更改也可能传播至父视图某些其它子视图中的对应 

项 , 这取决于对应项的当前行为及配置。) 

添加、移动、共享和修改项时 , 它们的行为会更改。以下几节将解释特定行为设置的 

含义。 

对于具有冻结或固定配置的任何项 , 如果其行为不设置为 Branch On Change( 更 

改时分支 ), 则它是只读。只读意味着不能在视图内更改此项的任何数据。例如 , 

虽然或许能够编辑某个文件 , 但不能将其签入或更改其属性。 

禁用分支 

如果禁用 Branch On Change ( 更改时分支 ) 复选框 , 会出现以下一种情况 : 

■ 

项已分支。 

注 

■ 

项不能更改。例如 , 如果项在参考视图中 , 则不允许分支。如果参考视图允许更改 , 

则这些更改会自动传播至父视图。该项与其父视图中的对应项之间不发生分离。 

■ 

对于创建、移动、共享 ( 及其它操作 ) 该项的位置和时间 , 分支对该项毫无意义。例 

如 , 没有理由将刚刚添加到根视图的文件分支。没有理由将在父视图中没有对应项的 

项分支。 

如果创建空白分支视图 ( 不是从父视图派生的视图 ), 则最初该视图中无任何项。因 

此 , 在父视图中无对应项 , 所以分支行为被禁用。 

在分支视图中 , 将项添加到某个不分支的文件夹 ( 即清除文件夹的 Branch On 

Change ( 更改时分支 ) 复选框 ) 时 , 该新项在父视图中没有对应项。因为此新项 

独立于父视图 , 所以禁用分支。 


文件夹、文件或更改请求分支 

分支行为设置为更改时分支 

启用并选中 Branch On Change ( 更改时分支 ) 复选框时 , 下次该项发生更改时 , 会发 

生分支。此时 , 新视图中的该项与父视图中的对应项之间发生分离。与父视图中对应项 

分离的项会表现出以下行为方式 : 

■ 

其 Branch on Change ( 更改时分支 ) 复选框变为禁用。 

■ 

其修订号是新的且不与父视图中的修订共享。 

分支行为未设置为更改时分支 

如果启用但清除 Branch On Change( 更改时分支 ) 复选框 , 则更改该项时不发生分支。 

如果项的配置是浮动的 , 则该项的更改会传播至父视图 ( 有时还会传播至父视图的其它 

子视图 )。 

如果项的配置不浮动 , 则不能更改该项 , 因为无法更新父视图。该项被视为只读的。只 

读意味着不能在此视图内更改此项的数据。例如 , 虽然可以编辑某个文件 , 但不能将其 

签入或更改其属性。 

文件夹、文件或更改请求分支 

注 

假设您正在处理某个产品 , 客户请求对该产品进行特殊的编辑。例如 , 客户请求为他们 

专门定制几个特殊的功能。为了使当前产品的项 ( 如文件和更改请求 ) 与用于特殊请求 

的项分离 , 应创建分支视图。 

从父视图中为新视图选择的文件夹和在这些文件夹中找到的项都会出现在新视图中。事 

实上 , 对于单个文件夹或项 , 在其行为变为 Branch On Change ( 更改时分支 ) 且其属 

性确实发生更改之前 , StarTeam 只为这两个视图存储一个文件夹或项。 

文件夹或项的分支行为取决于其历史。如果不知道某个文件夹或项的完整历史 , 就不 

应认为自己了解其行为。 

例如 , 如果在创建分支视图时其中的某个文件夹或项是其父视图的一部分 , 而且创建该 

分支视图时其分支选项为 Branch All ( 全部分支 ), 则开始时该文件夹或项的分支行为 

是启用的 , 且 Branch On Change ( 更改时分支 ) 复选框被选中。如果创建该分支视图 

时其分支选项为 Branch None( 无分支 ), 则开始时该文件夹或项的分支行为是启用的 , 

且 Branch On Change ( 更改时分支 ) 复选框被清除。但您可以更改此行为。 

如果在分支视图创建后将文件夹或项添加到该视图 , 则该文件夹或项的分支行为被禁 

用。 Branch On Change ( 更改时分支 ) 复选框被清除且无法访问。另一方面 , 如果共 

享该文件夹或项 , 在新视图中其分支行为自动变为启用。 

文件夹会因其属性的更改而分支。将某个文件夹分支时 , 其内容不会分支 ( 无论是子文 

件夹还是项 ) 。文件分支时 , 其属性已发生更改或该文件本身已被编辑。更改请求分支 

时 , 其属性已更改。 

项可能也能分支 ; 也就是说 , 它们可以派生自成为它们祖先的其它项。项可能有几个具有 

共同祖先的、完全不同的修订历史。例如 , 如果是文本文件 , 分支的项以后可与其起源文 

件合并。例如 , 针对某个新操作系统的产品开发可能基于第一个操作系统的现有文件。 

文件夹、文件或更改请求分支时 , 其修订号将更改。例如 , 如果某个文件在分支前的修 

订号是 1.13, 则分支后其修订号变为 1.13.1.0。在分支视图中对该项的下一次更改的修 

订号为 1.13.1.1。在父视图中对该项的下一次更改的修订号为 1.14。 

查看或更改文件夹或项的行为 : 

1 从文件夹层次中选择文件夹或从上部窗格中选择该项。 

2 从 Folder( 文件夹 ) 菜单、项菜单或其上下文菜单中选择 Advanced( 高级 )> Behavior 

( 行为 )。 


重新配置文件夹和项 

出现 Item Behavior( 项行为 ) 对话框。只有当该文件夹或项可以分支时 ,Branch on 

Change ( 更改时分支 ) 复选框才是启用的。 


■ 

选中 Branch On Change( 更改时分支 ) 复选框 , 使文件夹或项在下次发生更改时 

进行分支。 

■ 

清除该复选框使该项不随下次更改而进行分支。 

分支发生后 , 此复选框变为禁用。该文件夹或项收到带两个附加整数的新修订号。 

4 ( 可选 ) 如果正在更改文件夹的行为 , 可通过选中 Apply To Entire Folder Tree ( 应 

用于整个文件夹树 ) 复选框同时更改其子文件夹的行为。 

文件夹的分支行为会影响添加到新分支视图中该文件夹的项。下列情况下可将项添加到 

新分支视图中的该文件夹 : 

■ 

文件夹已分支。 

■ 

文件夹尚未分支但其行为是 “branch on change”( 更改时分支 )。 

■ 

对于所添加的项的行为 , Branch On Change ( 更改时分支 ) 复选框是禁用的。 

如果该文件夹尚未分支且其行为不是 “branch on change”( 更改时分支 ) , 则不能添 

加该文件 ; 会有错误消息指出该文件夹是只读的。 

更改文件夹的分支行为对以下项的分支行为没有任何影响 : 

■ 

更改前文件夹中的项。预先存在的项有它们自己的行为。 

■ 

后来移动到该文件夹或与该文件夹共享的项。 

■ 

后来从父视图传播到该文件夹的项。 


各文件夹或项都可以重新配置。 

所有配置更改都设置为浮动或设置到特定日期和时间。例如 , 如果将某项配置给视图标 

签 , 则该项的配置变为标签的日期和时间或标签附加到的修订的日期和时间 ( 如果标签 

已移动 )。如果重新打开 Behavior ( 行为 ) 对话框并重新选择 Configuration ( 配置 ) 

选项卡 , 该配置被设置为 Revision As Of ( 修订截止 ), 其后跟着带标签的修订的日期 

和时间。 

如果将修订重新配置到提升状态 , 则根据重新配置时提升状态所应用的标签 , 此配置也 

成为日期和时间配置。如果更改状态使它反映其它标签 , 则文件夹或项的配置不反映此 

更改。 

文件夹和项可以 : 

■ 

从现有日期和时间设置回滚到更早的视图标签、提升状态或日期和时间。 

■ 

例如 , 可能要将文件在某特定时间点的版本签出并将其与最新修订比较。 

在根视图中回滚文件夹或项可使其成为只读。只读意味着不能在视图内更改此文件夹 

项的任何数据。例如 , 虽然可以编辑某个文件 , 但不能将其签入或更改其属性。 

如果某个文件夹或项不能分支 , 则在子视图中回滚它可使其成为只读。 

从过去某个时间向后滚到更晚的 ( 也许是浮动的 ) 时间。时间可由视图标签、提升状 

态或浮动设置 ( 而不是特定日期和时间 ) 代表。 

例如 , 基于特定的标签、提升状态或时间创建分支视图时 , 子视图中每项的配置都设 

置为相应时间。如果在子项分支前对父项进行了更改 , 可将配置时间提前以包括父项 

中的更改。例如 , 如果将某项配置为 2003 年 6 月 5 日 4:44 P.M., 而在 6 月 8 日和 7 

月 14 日对父项进行了更改 , 则可将子项的配置时间提前到 7 月 14 日的适当时间 , 从 

而在子视图中包括这些更改。可同时选择几个项并同时将其所有配置重新设置为相同 

时间。这一重新确定基础的操作需要确认。 



如果某个文件夹或项符合以下一个条件 , 它会变为只读 : 

■ 

它位于只读参考视图中 

■ 

它位于分支视图中且其行为被禁用或未设置为 Branch On Change ( 更改时分支 ) 

注意 

在创建新视图时如果选择 Branch None ( 无分支 ), 则该新视图中的每个文件夹和项 

都将变为只读 , 直到各文件夹或项设置为 Branch On Change ( 更改时分支 ) 或获得 

浮动配置。然后这些文件夹或项将分支 , 或者对它们的更改将被传播到父视图中的对 

应项。 

例如 , 假设另一个团队为您提供了一些文件。您需要将自己的文件与他们的文件一起 

编译 , 但不想让其他团队或您自己的团队更改他们的文件。您可将这些文件的配置回 

滚到它们处于稳定状态的某个时间点 , 然后设置它们的行为 , 使它们不能分支。 

与视图不同 , 文件夹或项会保持其配置 , 直到您手动更改配置或该文件夹或项分支。关 

闭视图后 , 文件夹或项不像视图那样返回到当前状态。 

更改某个文件夹的配置时 , 已与其相关的任何项或子文件夹的配置不会随之更改。重新 

配置时只是将该文件夹的属性重置为它们在配置时的值。根据该文件夹的行为 , 该文件 

夹可能变为只读。文件夹为只读时 , 不能更改其属性。 

文件夹的配置会影响哪些新项或子文件夹能浮动到其中。例如 , 在浮动分支视图中为避 

免项浮动到特定文件夹 , 可将该文件夹配置为标签、提升状态或过去的某个时间点。可 

以后再将该文件夹重新配置为浮动 , 以从父项接收新项。但如果在文件夹未浮动时向父 

文件夹中添加项 , 则这些项一定不会自动存在于此文件夹中。必须将它们手动共享。 

如果要将某个文件夹或项冻结到特定日期和时间 , 可重新配置该文件夹或项。 

使用更少的永久解决方案即可更好地执行其它操作。例如 , 如果要检查某个特定文件修 

订的内容 ( 如带 Beta 标签的修订 ), 可选择该文件 , 然后选择 Labels ( 标签 ) 选项卡 

查找具有该标签的修订。最后 , 选择 History( 历史 ) 选项卡签出该修订或将其与最新修 

订比较。 

如果要查看在特定时间点视图内容的情况 , 可重新将视图配置到该时间。例如 , 要找到 

已删除的文件夹或项 , 需要将视图回滚。然后可以看到文件夹 ( 例如 , 在指定时间的 ), 

即使它们已在该时间后被删除。 

已配置到过去时间的文件夹是无法定位的 , 除非您还记得它们的位置。如果它们不能 

分支 , 则可以发现它们 , 因为尝试更改它们属性时会出现只读消息。但文件夹可能因 

其它原因变为只读。 

重新配置文件夹或项 : 

1 从 StarTeam 文件夹层次中选择该文件夹或项。 

2 从文件夹、项或上下文菜单中选择 Advanced ( 高级 ) > Behavior ( 行为 ) 。出现 

Behavior ( 行为 ) 对话框。 



3 选择 Configuration ( 配置 ) 选项卡。 

4 选择某个配置选项 : 

■ 

Floating ( 浮动 ) 

此选项允许对相应父项的更改浮动到子视图 ( 有时 , 反之亦可 )。如果是根视图 , 

它允许将新修订添加到该项 , 因为该项不再只读。 

■ 

Labeled Revision ( 加标签的修订 ) 

此选项使带有指定视图标签的文件夹或项修订成为最新修订。如果没有为此视图 

定义任何标签 , 则此选项禁用。 

现有视图标签按其创建时间的相反顺序列出。 

■ 

Promotion State Configuration ( 提升状态配置 ) 

此选项使带有当前分配到所选提升状态的视图标签的文件夹或项修订成为最新修 

订。如果没有为此视图定义任何提升状态 , 则此选项禁用。 

■ 

Revision As Of ( 修订截止 ) 

此选项使正处于指定时间点之前的文件夹或项修订成为最新修订。 

此选项默认为当前日期和时间 , 但您也可以选择过去的日期和时间 , 只要此日期和 

时间处于该文件夹或项的创建时间之后。 

标识回滚的项 : 

1 将 Configuration Time ( 配置时间 ) 字段添加到上部窗格 ( 有关详细信息 , 请参阅 

第 67 页的 “ 控制列 ”)。 

在此字段中 , 只有带过去配置时间的项才有对应值。可根据此列排序。请参阅第 68 页 

的 “ 对数据排序和分组 ”。 

如果 Configuration Time ( 配置时间 ) 与视图标签的时间匹配 , 可将此项配置到该视 

图标签或配置到基于该视图标签的提升状态。 

2 要查找与视图标签相关的时间 , 选择 View( 视图 )> Labels( 标签 ), 选择该标签 , 

然后单击 Properties ( 属性 )。 


锁定和解锁项 

锁定和解锁项 

Lock 

其它可能需要的字段有 Branch On Change( 更改时分支 ) 和 Branch State( 分支状态 )。 

■ 

■ 

Branch On Change ( 更改时分支 ) 指示文件在更改时是否分支。这是通过值 Yes 

( 是 ) 或 No ( 否 ) 指示的。如果 Branch On Change ( 更改时分支 ) 为 No ( 否 ) 且 

Configuration Time ( 配置时间 ) 字段有值 , 则该项为冻结 ( 只读 )。 

Branch State ( 分支状态 ) 指示某个项是否已在子视图中分支、是否尚未分支 ( 因此 

是父视图的一部分 ) 或是否处于项目的根视图中 ( 因此不能分支 ) 。其值可以是 

Branched ( 已分支 )、 Not Branched ( 未分支 ) 和 Root ( 根 )。 

计划更改文件的内容或编辑项的属性时 , 总应将该项独占锁定。通过锁定项 , 可警示团 

队成员您打算更改该项 , 并防止他们同时编辑该项。对某个项的独占锁定可防止其他人 

在您将锁释放前创建该项的新修订。您可以通过单独的操作将任何类型的项锁定或解锁 

( 参见下面的步骤 )。此外 , 您还可以在签入或签出过程中锁定和解锁文件。 

如果其他人独占锁定了某个项 , 您可以查看其属性但不能创建这些属性的新修订。通常 

标题栏中会出现 “Read Only”( 只读 ) 字样和锁定该项的用户名。但如果该项在您打 

开它之后才变为锁定 , 则只有在您单击 OK ( 确定 ) 时才会知道这一锁定情况。 

使用工具栏锁定某个项 : 

1 从上部窗格中选择一个或多个项。 

2 在工具栏上单击 Lock ( 锁定 )。 

所选的项被您独占锁定。 

为某项删除锁定状态 : 


2 从项或上下文菜单中选择 Lock/Unlock( 锁定 / 解除锁定 )。出现 Set My Lock Status 

( 设置我的锁定状态 ) 对话框。 

3 选择某个锁定状态选项 : 

■ 

Unlocked ( 解除锁定 ), 删除对所选项的独占或非独占锁定。 

■ 

■ 

Exclusive ( 独占 ), 这样除了您之外其他人都不能创建此项的新修订 ( 直到您将 

锁释放或其他人中断了您的锁定 ) 

Non-exclusive ( 非独占 ), 表明您正在处理该项并可能对其进行更改 ( 不建议对 

除文件之外的项使用非独占锁定 ) 

4 根据您对选定项的访问权限和权限 , 您或许可以中断其他团队成员对该项的锁定。要 

中断锁定 , 请选中 Break Existing Lock ( 中断现有锁定 ) 复选框。 

如果在服务器配置中启用电子邮件 , StarTeam 会发送电子邮件消息来通知被您中断 

了锁定的团队成员。 

5 单击 OK ( 确定 )。 

要删除某个项的锁定 , 选中 Lock/Unlock ( 锁定 / 解除锁定 ) 或在工具栏上单击 Unlock 

( 解除锁定 ) 。 

根据您个人选项的设置 , 可以对项进行自动锁定或解锁。请参阅第 310 页的 “ 设置文件选 

项 ” 和第 317 页的 “ 自动锁定非文件项 ”。 


比较属性 

比较属性 

可以比较同类型两个项的属性。也可以比较某个文件夹或项的两个修订的属性。 

比较同类型两个项的属性 : 

1 从上部窗格选择这两个项。 


■ 

单击工具栏上的 Compare Properties ( 比较属性 )。 

Compare 

Properties 

■ 

从项或上下文菜单中选择 Compare Properties ( 比较属性 )。 

出现 Compare ( 比较 ) 对话框 , 然后即可并排地查看两组属性。差异以粗体标记。 

比较相同项的两个修订的属性 : 

1 从上部窗格中选择项。 

2 选择 History ( 历史 ) 选项卡。 

3 选择要比较的两个修订。 


■ 

单击工具栏上的 Compare Properties ( 比较属性 ) 。 

■ 

在 history ( 历史 ) 列表中右键单击选定的项 , 然后选择 Compare Properties ( 比 

较属性 )。 

出现 Compare ( 比较 ) 对话框 , 然后即可并排地查看两个修订的属性。差异以粗体 

标记。 

下图将某主题的两个修订加以比较。 

比较相同文件夹的两个修订的属性 : 

1 从 StarTeam 文件夹层次中选择文件夹。 


3 选择 History ( 历史 ) 选项卡。( 要使 History ( 历史 ) 选项卡出现 , 您必须具有使用 

此选项卡和查看此文件夹历史的访问权限。) 

4 选择要比较的两个修订。 


■ 

单击工具栏上的 Compare Properties ( 比较属性 ) 。 

■ 

在 history ( 历史 ) 列表中右键单击选定的项 , 然后选择 Compare Properties ( 比 

较属性 )。 

出现 Compare ( 比较 ) 对话框 , 然后即可并排地查看两个修订的属性。差异以粗体 

标记。 


使用历史列表 

注 

也在视图比较中比较文件夹和项修订。比较和合并视图通常只由管理员进行。有关 

说明请参阅 StarTeam 管理员指南。 

使用历史列表 

从下部窗格或 Folder Properties ( 文件夹属性 ) 对话框选择 History ( 历史 ) 选项卡 

后 , 将列出选定文件夹或项的所有修订。此历史列表包含几个列 , 每个列都有自己的列 

标题。历史列表的列包括 : 

View ( 视图 ) 文件所属视图的名称。 

Revision ( 修订 ) 在签入修订时 StarTeam 为其分配的号码。 

Author ( 作者 ) 签入此修订的用户。 

Time ( 时间 ) 修订的日期和时间。 

Comment ( 注释 ) 为创建该修订提供的原因。 

Branch Revision 修订号的特殊形式 , 指示此修订的分支路径。 

( 分支修订 ) 

历史列表有其自己的上下文菜单。使用它可以 : 

■ 

将某个修订的属性与其它修订的属性进行比较。 

■ 

查看某个修订的属性或参考。 

■ 

添加或更改修订注释。 

■ 

对于文件 , 该菜单还可用于 : 

■ 

签出修订。 

■ 

在与修订相关的应用程序中查看该修订的内容。 

■ 

将修订的内容与其它修订或工作文件的内容进行比较。 

注 

在上一节的 “ 比较属性 ” 中已介绍了两个修订的比较。查看修订属性和编辑注释将在下文 

介绍。仅适用于文件的功能在第 156 页的 “ 签出修订 ”、第 160 页的 “ 查看修订内容 ” 和 

第 160 页的 “ 比较文件内容 ” 中介绍。 

查看修订属性 

您可以查看某个项或文件夹的修订属性。 

查看某个项的修订的属性 : 


a 从上部窗格中选择项。 

b 选择视图窗口下部窗格下面的 History ( 历史 ) 选项卡。 


3 单击 Properties ( 属性 )。出现相应的 Properties ( 属性 ) 对话框。 

查看某个文件夹的修订的属性 : 


a 从 StarTeam 文件夹层次中选择文件夹。 

b 从 Folder ( 文件夹 ) 或上下文菜单中选择 Properties ( 属性 )。 

c 

选择 History ( 历史 ) 选项卡。( 如果没有查看此文件夹历史的访问权限 , 则不会 

出现 History ( 历史 ) 选项卡。) 



合并修订 

合并修订 

3 单击 Properties( 属性 )。出现相应的 Properties( 属性 ) 对话框。它不显示 Exclude 

( 排除 ) 和 Files ( 文件 ) 选项卡。 

编辑修订注释 

创建某个项或文件夹的修订时 ( 例如 , 通过签入文件或更改其属性 ), 可提供有关每个 

修订的注释以解释更改的原因。以后 , 还可在历史列表中添加或编辑其它注释。 

注意切勿在修订注释中使用关键字 , 因为在关键字扩展过程中会将其扩展。 

编辑某个项的修订注释 : 




2 选择历史列表中的修订并右键单击。 History ( 历史 ) 上下文菜单打开。 

3 单击 Edit Comment( 编辑注释 )。Edit Comment( 编辑注释 ) 对话框显示该修订的 

注释。 

4 编辑该注释 , 然后单击 OK ( 确定 )。 

编辑某个文件夹修订的修订注释 : 



3 选择 History( 历史 ) 选项卡。( 如果没有查看此文件夹历史的访问权限 , 则不会出现 

History ( 历史 ) 选项卡。) 


5 单击 Edit Comment( 编辑注释 )。Edit Comment( 编辑注释 ) 对话框显示该修订的 

注释。 

6 编辑该注释 , 然后单击 OK ( 确定 )。 

注 

文件夹和项修订的合并可以在视图合并过程中进行。但是 , 合并视图通常只由管理员进 

行。有关说明请参阅 StarTeam 管理员指南。 

也可使用 Visual Merge 在签入或签出过程中合并文件修订。此外 , Visual Merge 可 

用作独立的实用程序。有关详细信息 , 请参阅第 161 页的 “ 合并文件 ” 和第 125 页的 

“ 使用 Visual Merge 和 Visual Diff”。 

按字段内容查找项 

可以在上部窗格显示的所有项中搜索任何显示的字段中包含的数据。例如 , 可按更改请 

求的号码查找更改请求 , 或搜索具有特定名称、状态、时间戳或大小的文件。如果要搜 

索未显示的某个字段 , 可依次单击该列标题和 Show Fields( 显示字段 ) 来添加该字段。 

查找项 : 

1 从上部窗格中选择 File ( 文件 )、 Change Request ( 更改请求 )、 Topic ( 主题 ) 或 

Task ( 任务 ) 选项卡。 

2 从项或上下文菜单中选择 Find ( 查找 )。 


打印项 

出现 Find ( 查找 ) 对话框。 

3 在 Search For ( 搜索内容 ) 文本框中输入部分或全部数据。切勿使用通配符。 

如果按号码搜索 , 应注意 Cross-Platform 客户机使用逗号 ( 或其它数字分隔符 ) 而 

Windows 客户机则不使用。例如 , 要在 Windows 客户机上查找更改请求 4344, 应输 

入 4344。要在 Cross-Platform 客户机上查找同一个更改请求 , 则必须输入 4,344。 

4 选择 Forward ( 向前 ) 从上至下搜索上部窗格或选择 Backward ( 向后 ) 从下至上搜 

索上部窗格。 

5 选择 Starting At Currently Selected Item ( 从当前选定项开始 ) 从当前选择的项开始 

搜索 , 或者选择 First Item ( 第一项 ) 或 Last Item ( 最后一项 ) 从列表的开始或结尾 

处开始搜索 ( 根据选择的是向前还是向后搜索 )。 

6 选择 All Displayed Fields ( 所有显示的字段 ) 或 This Field ( 此字段 ) 选项。如果选 

择 This Field ( 此字段 ), 请从下拉列表框选择要搜索的字段。 

7 根据是否适合进行区分大小写的搜索 , 选中 Match Case ( 区分大小写 ) 复选框。 

8 单击 OK ( 确定 ) 进行搜索。 

提示为提高效率 , 请使用快捷键 : 

■ 

■ 

■ 

Ctrl+F 开始搜索 

F3 查找下一个与搜索文本匹配的更改请求 

Shift+F3 查找上一个与搜索文本匹配的更改请求 

打印项 

可以打印上部窗格中的数据以作为默认的报告。但是 , 只有在您的计算机为 .htm 扩展名 

建立了 “ 打印 ” 操作文件关联时 ,Print( 打印 ) 命令才起作用。在计算机上安装浏览器 

可以创建此关联。 

打印上部窗格中显示的数据 : 

1 请确保所需信息的行和列出现在上部窗格中。 

2 选择要打印的行。 

3 从 File ( 文件 )、 Change Request ( 更改请求 )、 Topic ( 主题 ) 或 Audit ( 审核 ) 

菜单或者它们的上下文菜单中选择 Print ( 打印 )。 

StarTeam 基于项的所选行准备默认报告并打印该报告。 


通过电子邮件发送项 


可将所选项属性的文本表示通过电子邮件的形式与其它一些文本一起发送出去。为每个 

项发送的信息包括显示在上部窗格中的字段。例如 , 如果选择一个文件 , 您可以发送其 

属性而非其内容。如果选择一个更改请求 , 其属性即是其 “ 内容 ”。 

通过 StarTeam 发送的项均来自于 StarTeam 而非来自于您。如果要给自己发送一个副 

本 , 请选中 Send Copy to Myself ( 发送副本给我自己 ) 复选框。否则将只有收件人会 

收到该电子邮件。 

对于所发送的项或通知 , 即使只有一个收件人的电子邮件地址格式不正确 ( 如 

“junk”), 所有人也都不会收到该电子邮件。 

Send 

如果电子邮件地址格式正确 , 但无效 ( 如 “junk@place.com”), 则电子邮件将发送 

给所有有效的收件人 , 发送者会收到来自电子邮件系统的有关无效地址的 “ 无法送达 

消息 ”。 

通过电子邮件发送项属性 : 



■ 

在工具栏上单击 Send ( 发送 )。 

( 请注意 , File ( 文件 ) 组件的工具栏上没有 Send ( 发送 ) 按钮。) 

■ 

从项或上下文菜单中选择 Send To ( 发送至 )。 

出现 Send To ( 发送至 ) 对话框。与 Windows 客户机比较 , 此对话框在 StarTeam 

Cross-Platform 客户机中的选项更多。 

Windows 客户机的 Send To ( 发送至 ) 对话框 : 



Cross-Platform 客户机的 Send To ( 发送至 ) 对话框 : 

3 将电子邮件发送给团队成员 : 

a 单击 To ( 收件人 )。 

出现 Select Primary Mail Recipients ( 选择主要邮件收件人 ) 对话框。 

b 

从 Available Users ( 供选用户 ) 列表框中选择收件人 , 然后单击 Add ( 添加 ) 将 

他们置于 Selected Users ( 选定用户 ) 列表框中。 Selected Users ( 选定用户 ) 

列表框中的用户名将出现在 To ( 收件人 ) 文本框中。 

c 单击 OK ( 确定 ) 返回 Send To ( 发送至 ) 对话框。 

注可在 To ( 收件人 ) 或 Cc ( 抄送 ) 文本框中直接输入 StarTeam 用户的地址 , 

只要您的电子邮件应用程序可以对他们唯一地判定。例如 , 如果两个联系人的 

电子邮件地址都以 “jmarsh” 开头 , 或者如果 “jmarsh” 有电子邮件应用程序 

已知的两个电子邮件地址 , 则这将无法唯一地解析。所以 “jmarsh” 是不合格 

的地址。 

从 Select Primary/Secondary Mail Recipients( 选择主要 / 次要邮件收件人 ) 对 

话框选择收件人后 , 邮件可能仍无法送达 , 原因是为团队成员列出的电子邮件 

地址 ( 作为其一项 StarTeam 用户属性 ) 不明确或不正确。 

4 抄送其他团队成员 : 

a 

b 

单击 Cc ( 抄送 ) 。出现 Select Secondary Mail Recipients ( 选择次要邮件收件 

人 ) 对话框。 

从 Available Users ( 供选用户 ) 列表框中选择收件人 , 然后单击 Add ( 添加 ) 将 

他们置于 Selected Users ( 选定用户 ) 列表框中。 Selected Users ( 选定用户 ) 

列表框中的用户名将显示在 Cc ( 抄送 ) 文本框中。 

c 单击 OK ( 确定 ) 返回 Send To ( 发送至 ) 对话框。 

5 在 Subject ( 主题 ) 文本框中输入主题。 

6 ( 可选 ) 要收到此电子邮件的副本 , 请选中 Send A Copy To Myself ( 发送副本给我 

自己 ) 复选框。 

7 ( 可选 ) 要通过电子邮件发送某个项的快捷方式 , 请选中 Attach Item Shortcut( 附加 

项快捷方式 ) 复选框。 



注 

项快捷方式可启动 StarTeam、以创建快捷方式时项目视图的配置打开该项目视 

图 , 打开该项的 Properties ( 属性 ) 对话框。如果同时发送多个项 , 则只有一 

个快捷方式显示在电子邮件消息中。打开快捷方式后 , 可使用 Properties ( 属 

性 ) 对话框的 Next ( 下一个 ) 和 Previous ( 上一个 ) 按钮在所发送的项之间 

移动。 

8 ( 可选 ) 要发送附加到此项的任何文件 , 请选中 Include Item Attachments ( 包括项 

附件 ) 复选框。 

9 ( 可选 ) 要将所选项的属性作为 HTML 页 ( 而不是电子邮件消息的内容 ) 发送 , 请选 

中 Send Items As HTML Attachment ( 作为 HTML 附件发送项 ) 复选框。此电子邮 

件的正文将为空。 

10 ( 可选 ) 在 Add Text To The Mail Message ( 向邮件消息添加文本 ) 文本框中输入其 

它信息。 

11 单击 Send Now ( 现在发送 ) 以发送该消息。 

以下是 Thomas Edison 从 StarTeam 项目发送给 Albert Einstein 的更改请求示例。 

注 

其主题指出谁是电子邮件的发件人 , 而且与自动电子邮件通知不一样的是 , 此主题中未 

提及 “ 通知 ”。它列出发送此消息时发件人在上部窗格显示的所有字段 ( 即使某些字段 

为空 )。这些字段的排列顺序与其在上部窗格的排列顺序相同。 

请勿将个人发送的电子邮件消息与 StarTeam Server 自动发送的电子邮件通知消 

息相混淆。如果 

您的 StarTeam 管理员已启用电子邮件通知 , 您将自动收到有关您负责的更改请 

求、或您负责或为收件人的需求、任务或主题中的任何更改的电子邮件消息。 


某些个人选项可控制使用系统托盘通知获得新项提示的频率。请参阅第 316 页的 “ 控制系 

统托盘通知 ” 。在 StarTeam Windows 客户机中 , 通知图标显示在任务栏的系统托盘部 

分。在 Cross-Platform 客户机中 , 通知图标显示在 StarTeam 状态栏上。 

将项标记为已读或未读 

有时 , 将项标记为已读或未读是很方便的。因为任务和主题可以树格式和列表格式显 

示 , 所以也可将整个树 ( 称线索 ) 标记为已读或未读。 

将项标记为已读或未读 : 

1 选择要加粗 ( 未读 ) 或不加粗 ( 已读 ) 的项。 

2 从项或上下文菜单中选择 Mark as Unread( 标记为未读 ) 或 Mark as Read( 标记为 

已读 )。 

将整个线索标记为已读或未读 : 


管理已读 / 未读项 

Tree 

Display 

1 单击 Tree Display ( 树显示 ) 按钮以树格式显示任务或主题。 

2 选择树的根。 


3 从项或上下文菜单中选择 Mark Thread as Unread ( 将线索标记为未读 ) 或 Mark 

Thread as Read ( 将线索标记为已读 )。 

整个树或线索被标记为已读或未读。 

某些个人选项可控制项标记为已读或未读的时间。请参阅第 315 页的 “ 管理已读 / 未读项 ”。 

为项加标志 

删除文件夹或项 

可为项 ( 除审核条目 ) 加标志 , 以在项列表中识别项。创建标志的用户可以设置、查看和 

删除标志。例如 , 您可以使用标志来提醒您跟踪某项客户请求。 Flag ( 标志 ) 字段显示 

Yes ( 是 ) 和一个蓝色标志 ( 指示该项已加标志 ) 或 No ( 否 ), 指示该项尚未加标志。 

为项加标志 : 

1 选择要加标志的项。 

2 从项或上下文菜单中选择 Flag ( 标志 )。 

项列表此时显示已标志的项。 

查看已标志的项 : 

1 右键单击列标题。 

2 从上下文菜单中选择 Show Fields ( 显示字段 )。 

3 从 Available Fields ( 可用字段 ) 列表中选择 Flag ( 标志 ) 字段。 

4 单击 Add ( 添加 )。 

清除标志 : 

1 选择要清除标志的项。 

2 从项或上下文菜单中选择 Remove Flag ( 删除标志 )。 

提示为提高效率 , 请使用快捷键 : 

■ 

■ 

Ctrl+Shift 标志某个项 

Ctrl+Shift+F2 从项删除标志 

您的权限和访问权限决定着您是否可以删除某个文件夹或项。 

删除某个文件夹或项时 , 它自此从视图中消失。回滚视图可使该文件夹或项恢复可见。 

使用此步骤时要小心。 

从项目中删除某个文件夹时 , 该文件夹相关的所有项都随之删除。它还会删除该文件夹 

的子文件夹及其内容。但不删除该文件夹的工作文件夹或工作文件夹中的任何文件。 

不能从视图删除根文件夹。要消除根文件夹 , 必须删除该视图。 

删除某个主题或响应时 , 其子响应 ( 即以所选主题或响应为根的整个分支 ) 也随之删除。 

删除某项任务或子任务时 , 其子任务 ( 即以所选任务或子任务为根的整个分支 ) 也随之 

删除。 



如果删除某个文件 , 即将其从版本控制中删除 , 而且还可以从其工作文件夹中删除此文 

件的工作副本。 

删除文件夹 : 


2 从 Folder ( 文件夹 ) 或上下文菜单中选择 Delete ( 删除 )。 

显示消息 “Delete Folder Name?”( 删除文件夹 Name?)。 

3 单击 OK ( 确定 )。 

从版本控制删除一个或多个文件 : 

1 从文件夹层次中选择相应的文件夹。 


3 选择要从上部窗格的 File ( 文件 ) 列表删除的文件。 

4 从 File ( 文件 ) 或上下文菜单中选择 Delete ( 删除 )。出现消息框 , 询问是否要从计 

算机上的工作文件夹删除相应的工作文件。 

5 决定是否应删除工作文件 , 然后选择 Yes ( 是 )、 No ( 否 ) 或 Cancel ( 取消 )。 

6 确认从 StarTeam 删除的每个文件。删除某个文件后 , 当前 StarTeam 视图中将不再显 

示该文件的信息。但此信息保留在项目储存库和存档 ( 储存仓 ) 中 , 直到该文件被清 

除。要访问已删除但尚未清除的文件 , 可将文件夹或视图回滚到该文件存在的时间。 

如果文件的状态为 Not In View( 不在视图中 ), 则删除该文件时 , 工作站上的副本被 

删除。它不从 StarTeam 中删除该文件 , 因为它当前不在 StarTeam 中。 

删除项 ( 除文件和审核条目 ): 

1 从上部窗格中选择项。( 可选择多个更改请求。) 

2 从项或上下文菜单中选择 Delete ( 删除 )。 

显示以下一条消息 : 

■ 

“Delete Change Request #?”( 删除更改请求 #?) 

■ 

“Delete Requirement # and its sub-requirements?”( 删除需求 # 及其子需求 ?) 

■ 

“Delete Task # and its sub-tasks?”( 删除任务 # 及其子任务 ?) 

■ 

“Delete Topic # and its sub-topics?”( 删除主题 # 及其子主题 ?) 

3 单击 OK ( 确定 ) 确认删除。 




章 

使用过程规则 

第 15 章 

现代的开发实践要求提高对整个发展过程的控制。 StarTeam 过程规则要求开发者遵循 

既定的开发过程 , 确保所有更改均链接到更改请求、需求或任务 , 这种方式将更改管理 

提升至更高的水平。在此方式中使用的项称作过程项。 

与典型的基于文件的软件配置管理 (SCM) 系统不同 , 过程规则将更改管理与 SCM 结合 

在一起。通过过程规则 , 用户可以清楚地区分哪个文件修订解决了更改请求、哪个完成 

了需求、哪个结束了任务。这样可确保代码和内容的修改必须基于明确定义和批准的目 

标 ( 以更改请求、需求或任务表达 )。 

在创建基准线内部版本或配置时 ,StarTeam 过程规则尤为有用。内部版本是带标签的配 

置 , 可以识别定义代码和内容基准线的文件修订和其它项。在不实施过程规则时 , 使用 

StarTeam 的开发者通过以下一种方法创建基准线 : 

■ 

在某个时间点为整个项目视图加标签 

■ 

签入后将文件修订与修订标签相关联 

即使不实施过程规则 ,StarTeam 用户也可在添加或签入文件时选择一个更改请求、需求 

或任务作为过程项。此外 , 用户还可以在此过程中将更改请求标记为已修复、将需求标 

记为完成或将任务标记为结束。如果选择了一个禁用的需求 ( 由于是从 CaliberRM 导入 

的 , 所以为只读 ) 作为过程项 , 则无法将其标记为完成。 

为方便起见 ,StarTeam 用户也可在添加或签入文件前选择一个更改请求或任务作为 “ 活 

动过程项 ”。 

使用过程项 

无论是否需要过程规则 , 您都可以享受到链接和跟踪的益处 , 过程项使之成为可能。添 

加或签入文件时 , 指出新文件修订要链接和固定到特定过程项。通过为操作选择一个更 

改请求、需求或任务作为过程项可实现这一点。同时可将更改请求标记为已修复、将需 

求标记为已完成、将任务标记为结束。 

使用过程项可以清楚地区别以下事项 : 

■ 

哪些文件修订与特定更改请求相关或解决特定更改请求 

■ 

哪些文件修订与特定需求相关或完成特定需求 

■ 

哪些文件修订与特定任务相关或结束特定任务 

第 15 章 : 使用过程规则 243

了解过程项限制 

要指定过程项 , 可执行以下操作 : 

■ 

从 StarTeam 主窗口预先选择一个过程项。 

■ 

例如 , 阅读一个由您负责的更改请求后 , 您可能决定将其状态更改为 In Progress( 进 

行中 ) 并立即处理它。可以使用菜单命令或工具栏按钮将该更改请求指定为活动过程 

项。请参阅第 244 页的 “ 预先选择活动过程项 ”。 

从 Add Files( 添加文件 ) 或 Check In Files( 签入文件 ) 对话框选择一个过程项。请 

参阅第 149 页的 “ 将文件添加到视图 ” 和第 153 页的 “ 签入文件 ”。 

了解过程项限制 

只有更改请求、需求和任务可以是过程项。如果未实施过程规则 , 可以使用任何更改请 

求、需求或任务作为过程项 , 而无论其状态如何。 

如果实施了过程规则 , 您可能只能选择一个类型的项作为过程项。例如 , 您可能只能选 

择更改请求。此外 , 您还可能只能选择有特定状态的项。如果您没有查看属性的访问权 

限 , 请向管理员咨询 , 了解对过程项进行了哪些限制。 

过程项选择是按视图进行的。当逐个视图更改时 , 您会看到在状态栏中显示的过程项信 

息不断变化。 

查看项目属性 : 

1 从菜单栏中选择 Project ( 项目 ) > Properties ( 属性 )。 

出现 Project Properties ( 项目属性 ) 对话框。 

2 选择 Process Rules ( 过程规则 ) 选项卡。 

3 查看限制。如果没有为允许的项选择状态 , 则可以使用任何状态。 

如果打算使用过程规则 , 则必须有正确的访问权限 , 包括以下权限 : 

■ 

在项目视图中查看和修改用作过程项的项。 

■ 

在文件及用作过程项的项上创建和修改链接。 

预先选择活动过程项 

Set 

Active 

Process 

Item 

选择一个活动过程项是一种便捷的方式 , 这样可以在以后添加或签入文件时节省时间。 

例如 , 查看一项任务后 , 您通常会知道接下来是否继续处理它。因为您已从上部窗格中 

选择了该任务 , 所以要使它成为活动过程项是非常简单的。 

一次只能将一个项指定为活动过程项。 

预先选择一个活动过程项 : 

1 从上部窗格中 , 选择适当的项。 

如果实施过程规则 , 则选择的项必须具有允许的状态、允许的项类型。 


■ 

选择 Change Request( 更改请求 )> Set Active Process Item( 设置活动过程项 )。 

■ 

选择 Requirement ( 需求 ) > Set Active Process Item ( 设置活动过程项 )。 

■ 

选择 Task ( 任务 ) > Set Active Process Item ( 设置活动过程项 )。 

■ 

在工具栏上单击 Set Active Process Item ( 设置活动过程项 )。 

虽然 Change Request ( 更改请求 )、 Requirement ( 需求 ) 和 Task ( 任务 ) 菜单上有 

Clear Active Process Item ( 清除活动过程项 ) 命令 , 但您可能永远不会使用它。选择 

另一个活动过程项就会将第一个活动过程项清除。 

添加或签入文件时不必使用活动过程项。活动过程项是默认的过程项选择 , 但您也可以 

选择另一个合适的项。 


将文件链接到过程项 

将文件链接到过程项 

使用到过程项的链接 

将文件添加到 StarTeam 视图或签入文件时 , 您可选择文件将链接到的过程项。链接的 

一端固定到新的文件修订 , 另一端则固定到更改请求、需求或任务的当前修订。 

在添加或签入文件过程中 , 可将更改请求的状态更改为 Fixed( 已修复 ), 将需求的状态 

更改为 Complete( 完成 ) 或将任务的状态更改为 Finished( 结束 )。如果过程项变成已 

修复、完成或结束 , 每个新文件修订会被固定到过程项的新修订 ( 有正确状态的修订 )。 

可通过查看某个过程项的链接来确定哪些文件修订与该项相关。 

查找链接到某个过程项的文件修订 : 

1 从 StarTeam 客户机的上部窗格中选择过程项。 

2 从下部窗格中选择 Link ( 链接 ) 选项卡。 


■ 

单击 Item Type ( 项类型 ) 列标题 , 以对链接进行排序 , 更轻松地查看从所选过程 

项到文件的链接。 

■ 

右键单击列标题 , 然后使用 Sort and Group ( 排序和分组 ) 对话框查找到文件的 

链接。 

可手动将一个项与另一个项链接多次。但是 , 如果 StarTeam 通过多次添加和签入操 

作将一个文件链接到同一过程项 , 它会更新现有链接而不是创建新链接。也就是说 , 

无论同一文件有多少修订固定到同一过程项的修订 , 要固定到该过程项的该文件的最 

后一个修订只能是在链接的属性中指定的修订。 

4 右键单击 Link( 链接 ) 窗格中的一个链接 , 然后从上下文菜单中选择 Link Properties 

( 链接属性 )。 

出现 Link Properties ( 链接属性 ) 对话框。 

5 检查 Link Properties ( 链接属性 ) 对话框 , 以找到所需的信息。 

每个链接都有两个端。从上部窗格中选择的项在一端 , 叫源项。另一项叫目标项。 

在上图中 , 源项是 Task 4, 目标项是名为 no.bmp 的文件。在本例中 , 任务的状态变 

成了 Finished ( 结束 ), 其修订号为 1.3。但是 , 固定到此任务的 no.bmp 的最新修 

订号是 1.2。它固定到此任务的修订 1.1, 说明它在此任务完成前即已签入。 

第 15 章 : 使用过程规则 245

使用到过程项的链接 

不过 , 为了完成此任务 , 仍创建了 no.bmp 的指定修订。如果签出所有与 Task 4 相关 

的文件 , 其中之一将是 no.bmp 的修订 1.2。 

6 对于其它链接 , 请重复步骤 4 至 5。 


章 

使用标签 

第 16 章 

StarTeam 允许您创建两种类型的标签 : 

■ 

视图标签 , 即通常所说的整个视图内容的 “ 时间戳 ”。将视图回滚至该标签时 , 您可 

以看到该时间点的所有内容 , 除非该标签已被调整。 

视图标签是针对特定时间点而创建 , 或者作为另一个现有视图标签的副本而创建。除 

非视图标签被冻结 , 否则可以调整它 , 使其包括或排除某些文件夹和项。这可通过为 

其附加或分离视图标签来实现。也可以将视图标签从一个修订移动至另一个修订。例 

如 , 在创建标签前有几个文件可能尚未签入 , 但需要将它们也包括在内。 

■ 

修订标签 , 该标签不自动附加到视图中的任何项。 

修订标签用于与视图中的一组文件夹或项一起使用。例如 , 您可能要给应一起签入和 

签出的一组文件加标签。 

每个标签名称在其视图内都是唯一的。在一个视图内 , 不能存在同名的视图标签 , 不能 

存在同名的修订标签 , 也不能有视图标签与修订标签同名。 

任何项 ( 例如文件修订或更改请求修订 ) 都可以有多个标签。但是 , 同一个项的两个修 

订不能同时有相同的标签。可以从文件夹或项分离任何标签 , 这样便不存在任何带有该 

修订标签的修订。 

只有在视图具有当前配置时才能创建和操控标签。在回滚视图中不能创建和移动任何 

标签。 

可以使用 Folder ( 文件夹 ) 菜单、项菜单或它们的上下文菜单中的 Labels ( 标签 ) 命 

令为文件夹或项手动附加或分离任何类型的标签。另外 , 签出文件时还可以使用标签 

( 任何类型 ) 标识文件。签入文件时可以附加 ( 或附加和创建 ) 修订标签。 

可以将标签从一个修订移动到另一个修订。例如 , 假定由于新的帮助文件尚未准备就 

绪 , 因而在内部版本中使用旧的帮助文件。一旦签入帮助文件的新修订 , 就可以将视图 

标签移动到新修订。 

再比如 , 假定同时签入若干文件但只为它们提供一个标签。之后 , 您认为需要再次更改 

其中的一个文件 , 从而产生该文件的新修订。签入新修订时 , 通过为该新修订提供一个 

与组相同的标签将其添加到组。但是 , 由于任何一个文件都不能存在多个带有相同修订 

标签的修订 , 所以该操作将此特定文件修订标签与先前的修订分离。 

可以按标签选择任何类型的项 ( 文件、更改请求、任务或主题 )。例如 , 可以选择具有 

特定修订标签的所有文件。选择这些文件后 , 可以将它们回滚到该标签 ( 这样便会使具 

有该标签的修订成为最新修订 )。然后 , 可以将工作文件与它们的回滚修订进行比较。 

第 16 章 : 使用标签 247

创建视图标签 


视图标签有多种用途。将视图标签用作时间戳 , 可以将视图回滚到任一视图标签 , 以查 

看它在某一特定时间点的所有内容。例如 , 要查看某一特定文件是否为产品的 beta 版 , 

可以将视图回滚到 beta 标签。 

通过使用视图标签可以让测试者了解 , 在验证更改请求时 , 如果下列条件为 true, 应使 

用哪个内部版本 : 

■ 

视图标签被指定作为内部版本标签。 

■ 

当更改请求的 Addressed In ( 解决请求的内部版本 ) 字段中包含值 “Next Build” 

( 下一个内部版本 ) 时 , 即创建内部版本标签。在这种情况下 , 内部版本标签的名称 

将替换 “Next Build”( 下一个内部版本 ), 以使测试者了解应使用哪个内部版本。 

例如 , 假定管理员在生成每个内部版本之前创建一个视图标签 , 并将该标签分配给视图 

中的每个文件的最新修订 , 然后签出带有该内部版本标签的所有文件。如果一个文件的 

最新修订在几个星期 ( 或更长时间 ) 内没有变化 , 则该文件会获得若干视图标签 , 而经 

常进行更改的文件可能会带有若干不带有任何视图标签的修订 , 以及其它一些只带有一 

个视图标签的修订。 

如果将视图标签从某个文件夹分离 , 则该标签会自动从以该文件夹为根的子树中的所有 

内容分离。如果将视图回滚到特定视图标签 , 并且某个文件夹没有该标签 , 则无论如何 

都看不到文件夹的子文件夹及其内容。 

只能在视图级别上并且仅当配置为当前配置时创建视图标签。但是 , 可以为当前配置创 

建视图标签 , 也可以为过去的某个时间创建视图标签。在这两种情况下 , 将新标签附加 

到属于指定时间的视图的每个文件夹、文件、更改请求、任务或主题的最新修订。 

也可以作为现有视图标签的副本创建视图标签 , 或者作为当前附加到提升状态的视图标 

签的副本创建视图标签。在这两种情况下 , 新标签附加到与现有视图标签完全相同的项 

和修订。 

可以使用此标签签出文件修订 , 或者将视图回滚到该标签并查看与该标签关联的所有 

项。例如 , 如果从视图生成产品的 Build 100 时创建视图标签 Build 100, 则视图中的所 

有文件都具有标签 Build 100。 

如果不包括某些项 , 可以从这些项逐个分离标签。例如 , 如果某些文件不应带有该标签 , 

可选择这些文件 , 然后从 File( 文件 ) 菜单或上下文菜单选择 Labels( 标签 )> Detach 

( 分离 ) 将标签分离。如果不应包括在内的所有文件都属于同一个文件夹 , 并且该文件 

夹中只有这些文件 , 则可以使用 Folder ( 文件夹 ) 菜单中的 Labels ( 标签 ) 命令。例 

如 , 如果直到附加视图标签之后才签入帮助文件 , 则可以将标签从帮助文件的先前修订 

移动到新签入的帮助文件。 

可以将视图标签指定作为内部版本标签。如果使用内部版本标签 , QA 团队可以立即确 

定使用哪个内部版本进行针对任何指定更改请求的修复的测试。这是因为当 StarTeam 

创建内部版本标签时 , 每个 Addressed In Build ( 解决请求的内部版本 ) 属性设置为 

“Next Build”( 下一个内部版本 ) 的更改请求的该属性都将被重置为内部版本标签 , 以 

替代 “Next Build”( 下一个内部版本 ) 。( 由于创建了先前的内部版本标签 , 所以 

Addressed In Build ( 解决请求的内部版本 ) 属性设置为 “Next Build”( 下一个内部版 

本 ) 的任何更改请求都已得到解决。) 



创建新视图标签 : 

1 从菜单栏中选择 View ( 视图 ) >Labels ( 标签 )。 

出现 Labels ( 标签 ) 对话框 , 并已选择 View ( 视图 ) 选项卡。现有标签 ( 及其说 

明 ) 按其创建时间的相反顺序列出。 

2 单击 New ( 新建 ) 创建新标签 , 并将其名称添加到列表框。出现 View Label ( 视图 

标签 ) 对话框。 

3 在相应文本框中输入标签的名称和说明。标签名最长为 64 个字符 , 说明最长为 254 

个字符。 

4 选择下列任一选项按钮 : 

■ 

■ 

■ 

选择 Current Configuration ( 当前配置 ), 将标签附加到此视图的当前配置中的每 

一项的最新修订。 

选择 Labeled Configuration ( 加标签的配置 ) , 将标签附加到带有指定标签的修 

订。现有视图标签按其创建时间的相反顺序列出。 

在另一个视图标签的基础上创建视图标签与复制该视图标签的效果相同。 

选择 Promotion State Configuration ( 提升状态配置 ), 将标签附加到当前处于指 

定提升状态的修订 ( 实际上是将标签附加到同样具有该提升状态的当前视图标签 

的修订 )。 

第 16 章 : 使用标签 249

复制视图标签 

注 

■ 

选择 Configuration As Of( 配置截止日期 ), 将标签附加到是指定日期和时间的最 

新修订的修订。 

5 ( 可选 ) 选中 Use As Build Label ( 用作内部版本标签 ) 复选框 , 以更新 Addressed 

In Build ( 解决请求的内部版本 ) 属性设置为 “Next Build”( 下一个内部版本 ) 的每 

个更改请求。如果不选中该选项 , 则更改请求仍具有该标签 , 但它不影响 Addressed 

In Build ( 解决请求的内部版本 ) 属性的设置。 

6 ( 可选 ) 要冻结此标签 , 以使附加到该标签的修订不能被更改 , 请选中 Frozen ( 冻 

结 ) 复选框。 

运行 StarTeam Server 的计算机与客户机的日期和时间必须同步。StarTeam 的许 

多功能都依靠涉及时间和日期的计算 , 尤其是标签、配置和提升状态 , 它们都是通 

过时间和日期计算来控制的。如果客户机与服务器不保持同步 , 许多操作都会失败 

或导致错误的或不可靠的操作 ( 如签出、显示文件状态或创建标签 )。 

复制视图标签 

用户有时会希望创建一个视图标签 , 将其附加到与现有视图标签完全相同的项修订 , 但 

有几个例外情况。例如 , 假定带有视图标签 Release 1.0 文件作为一个产品提供。随后 , 

创建一个修复新产品问题的修补程序。该修补程序的源代码文件带有修订标签 Migration 

Patch。您要创建一个名为 Release 1.0 and Migration Patch 的新视图标签。但是 , 创建 

视图标签时 , 它被附加到所有当前文件的最新修订。并不是所有这些文件都用来创建 

Release 1.0, 而对于其中用来创建 Release 1.0 的文件 , 在发行的产品中使用的修订不 

再是最新修订。 

如果正在执行操作的视图中存在视图标签 , 并且该视图的配置是当前配置 , 则可以复制 

这些视图标签。您不能从另一个视图复制视图标签。 

基于现有视图标签创建视图标签 , 但有几个例外情况 : 

1 创建新视图标签 , 该标签附加到与现有视图标签相同的项修订。 

a 从菜单栏中选择 View ( 视图 ) >Labels ( 标签 )。出现 Labels ( 标签 ) 对话框 , 

并已选择 View ( 视图 ) 选项卡。 

b 单击 New ( 新建 )。出现 View Label ( 视图标签 ) 对话框。 

c 在相应的文本框中输入标签的名称 ( 例如 Release 1.0-Patch 1) 和说明。 

d 

选中 Labeled Configuration ( 加标签的配置 ) 选项按钮 , 将标签附加到带有现有 

标签 ( 例如 Release 1.0) 的修订。 

e ( 可选 ) 默认情况下 , 所有视图标签都被指定作为内部版本标签。如果不希望该标 

签为内部版本标签 , 请清除 Use As Build Label ( 用作内部版本标签 ) 复选框。 

f ( 可选 ) 选中 Frozen ( 冻结 ) 复选框可冻结此标签。 

g 单击 OK ( 确定 )。新的视图标签随即附加到与现有视图标签相同的修订。 

2 选择文件 , 这些文件的新标签必须不同于复制的标签。例如选择所有用于生成修补程 

序 ( 并希望以指定修订标签签入 ) 的文件。 

如果这些文件没有修订标签 , 则要单独选择它们 , 而不是按照下面的步骤操作。 

a 

b 

从项或上下文菜单中选择 Select ( 选择 ) > By Label ( 按标签 )。 Select A Label 

( 选择标签 ) 对话框列出所有现有标签。 

选择与选定文件相关联的修订标签 , 例如 Migration Patch。 

c 单击 OK ( 确定 )。在上部窗格中带有该标签的文件变为选中状态。 

3 将新标签移动到相应修订。 

a 

从 File( 文件 ) 或上下文菜单中选择 Labels( 标签 )> Attach( 附加 )。Attach a 

Label ( 附加标签 ) 对话框列出所有现有标签。 

b 从列表中选择新标签 ( 例如 Release 1.0-Patch 1)。 


创建修订标签 

创建修订标签 

c 

d 

选中 Labeled Configuration ( 加标签的配置 ) 选项按钮调整新标签 , 使修补程序 

中包括该修订。 

从下拉列表框中选择与修补程序相关联的修订标签 , 例如 Migration Patch。 

e 单击 OK ( 确定 )。 

对于从上部窗格中选择的文件 , 新视图标签被移动到 ( 或添加到 ) 带有选定修订标签 

的修订。新视图标签此时与复制的视图标签有少许不同。 

如果这些文件没有修订标签但却是最新修订 , 则选择 Current Configuration ( 当前配 

置 ) 选项按钮 , 而不选择 Labeled Configuration ( 加标签的配置 ) 选项按钮。如果它 

们不是最新修订 , 或许可以使用 Configuration As Of ( 配置截止日期 ) 选项按钮。 

4 如果需要为除文件以外的其它类型的项调整新标签 , 请重复步骤 2 和 3。 

在文件签入过程中 , 或者在文件夹或项的附加过程中 , 可以在视图级别创建修订标签。 

但是 , 如果从另一个视图中的现有修订标签复制新修订标签 , 则必须使用 View ( 视图 ) 

菜单。 

从一个视图 ( 来源视图 ) 移动或共享项到另一个视图 ( 目标视图 ) 时 , 来源视图中的标 

签不能成为目标视图的一部分。但是 , 可以移动或共享项到目标视图中 , 然后复制修订 

标签。此方法允许您有选择性地维护移动项或共享项的修订标签。 

有关签入时创建或附加标签的详细信息 , 请参阅第 153 页的 “ 签入文件 ”。还可以在附 

加到文件夹或项修订时创建标签。请参阅第 254 页的 “ 为文件夹加标签 ” 和第 257 页的 

“ 为项加标签 ”。 

还可以根据标签签出文件。有关详细信息 , 请参阅第 156 页的 “ 签出修订 ”。 

创建新修订标签 : 

1 从菜单栏中选择 View ( 视图 ) >Labels ( 标签 )。出现 Labels ( 标签 ) 对话框。 

2 选择 Revision ( 修订 ) 选项卡。 

Labels ( 标签 ) 对话框按照创建时间的相反顺序列出现有修订标签 ( 及其说明 )。 

第 16 章 : 使用标签 251

复制修订标签 

3 单击 New( 新建 ) 创建新标签 , 并将其名称添加到列表框。出现 Revision Label( 修 

订标签 ) 对话框。 

复制修订标签 


个字符。 

5 ( 可选 ) 要冻结此标签 , 以使附加到该标签的修订不能被更改 , 请选中 Frozen ( 冻 

结 ) 复选框。 

6 单击 OK ( 确定 ) 退出 Revision Label ( 修订标签 ) 对话框。 

有时可能要复制修订标签。例如 , 假定为发行的产品创建修补程序时使用修订标签 

Migration Patch 在文件签入时为文件加标签。假定该修补程序被发送给客户 , 但遗憾的 

是 , 需要对用于创建修补程序的源代码文件中的一个文件进行其它更改。为了区分这两 

个修补程序 , 可根据修订标签 Migration Patch 创建一个新修订标签 , 例如 Migration 

Patch 2。然后 , 可以调整 Migration Patch 2, 以包括更改的源代码文件。 

可以多种方式复制修订标签。无论修订标签在当前视图中还是在另一个可访问的视图 

中 , 使用本部分介绍的方法都可以复制。 

复制修订标签后 , 它立即附加到与原始修订标签相同的项的相同修订。如果在同一个视 

图中存在两个修订标签 , 则每个标签都附加到相同数目的项。 

如果从另一个视图复制修订标签 , 新修订标签附加到相同项的相同修订 , 但只有在复制 

时新修订标签的视图中存在这些项 ( 及其正确的修订 ) 的情况下才出现这种情况。例如 , 

如果两个视图只共享少数几项 , 或者已将多个项从一个视图移动到另一个视图 , 则可附 

加到新修订标签的项的数目可能与附加到原始修订标签的项的数目不同。 

下列步骤假定您正在处理文件 , 但其它项也可以采用相同的步骤。 

基于现有标签创建修订标签 , 但有几个例外情况 : 

1 创建新修订标签 , 该标签附加到与现有标签相同的修订。 

a 从菜单栏中选择 View ( 视图 ) >Labels ( 标签 )。出现 Labels ( 标签 ) 对话框。 

b 选择 Revision ( 修订 ) 选项卡。 

c 单击 New ( 新建 )。出现 Revision Label ( 修订标签 ) 对话框。 

d 在相应的文本框中输入标签的名称 ( 例如 Migration Patch 2) 和说明。 

e 选中 Copy From Another Revision Label ( 从另一个修订标签复制 ) 复选框。 


冻结标签 

f 单击 Select ( 选择 )。出现 Copy a Revision Label ( 复制修订标签 ) 对话框。 

g 

使用 Project ( 项目 ) 列表框和 View ( 视图 ) 树选择包含要复制的修订标签的项 

目视图。 

h 从 Labels ( 标签 ) 列表框中选择修订标签。 

i 单击 OK ( 确定 ) 退出 Copy a Revision Label ( 复制修订标签 ) 对话框。 

j 单击 OK ( 确定 )。新修订标签即附加到与现有标签相同的修订。 


■ 

使用新修订标签签入更改的一个或多个文件。 

■ 

将新修订标签手动附加到更改的文件修订。 

1 选择更改的文件。 

2 选择下部窗格下方的 Label ( 标签 ) 选项卡。 

3 将新修订标签拖动到正确的 ( 可能是最新 ) 修订。 

4 对于任何其它更改的文件 , 重复上述步骤。 

如果是添加文件而不是更改当前带标签的文件 , 则必须使用 Labels ( 标签 ) >Attach 

( 附加 ) 命令 , 而不能将标签从一个修订拖放到另一个修订。 

冻结标签 

如果冻结标签 , 则任何人都不能将其添加到任何修订 , 或从任何修订中删除它。 

冻结或解冻标签 : 

1 从菜单栏中选择 View ( 视图 ) >Labels ( 标签 )。出现 Labels ( 标签 ) 对话框。 

2 如果要冻结或解冻的标签是视图标签 , 请选择 View( 视图 ) 选项卡。否则选择 Revision 

( 修订 ) 选项卡。 

3 从列表框中选择标签。 

现有标签 ( 及其说明 ) 按其创建时间的相反顺序列出。 

4 单击 Freeze ( 冻结 ) 或 Unfreeze ( 解冻 )。 

Freeze/Unfreeze ( 冻结 / 解冻 ) 按钮的名称随选定标签的当前状态变化。例如 , 如 

果标签当前处于冻结状态 , 则该按钮显示为 Unfreeze ( 解冻 )。 

第 16 章 : 使用标签 253

删除标签 

在列表框中冻结标签的前面有一个雪花状图标。 

标签被冻结时 , 不能对其执行以下操作 : 

■ 

■ 

■ 

附加到其它文件夹或项 

从任一文件夹或项分离 

从文件夹或项的一个修订移动到另一个修订 

删除标签 

查看标签属性 

删除标签会将标签与修订分离并从数据库中删除标签。如果标签被冻结 , 则必须首先将 

其解冻 , 然后才能删除它。 

从当前视图删除标签 : 

1 从菜单栏中选择 View ( 视图 ) > Labels ( 标签 )。出现 Labels ( 标签 ) 对话框。 

2 如果要删除的标签是视图标签 , 请选择 View( 视图 ) 选项卡。否则选择 Revision( 修 

订 ) 选项卡。 


3 从列表框中选择标签。 


标签便从视图中删除。在任何标签列表中都不再显示该标签。除非将视图回滚到标签存 

在时的日期和时间 , 否则标签不再附加到任何文件夹或项。但是 , 以后可以使用完全相 

同的名称创建新标签。 

标签的属性包括名称、说明和冻结 / 解冻状态。视图标签的属性还包括配置日期和时间 

以及是否为内部版本标签。还可以从标签的属性对话框冻结 / 解冻标签。 

查看标签的属性 : 

1 从菜单栏中选择 View ( 视图 ) > Labels ( 标签 )。出现 Labels ( 标签 ) 对话框。 

2 选择 View ( 视图 ) 选项卡或 Revision ( 修订 ) 选项卡。 



■ 

双击标签。 

■ 

从列表框中选择标签 , 然后单击 Properties ( 属性 )。 

出现属性对话框 , 其中列出标签的属性。 

为文件夹加标签 

为文件夹加标签与为项加标签有少许不同。例如 , 使用菜单命令而不是 Label ( 标签 ) 

选项卡查看附加到文件夹的标签。 

为文件夹附加标签时 , 还可以将其附加到以下任一项 : 

■ 

文件夹中包含的项 

■ 

文件夹的内容、子文件夹及其内容 ( 该文件夹为根的子树中的所有内容 ) 

将标签附加到项或文件夹时 , 会将标签自动附加到视图中的所有项或文件夹的所有父文 

件夹。如果标签是修订标签 , 还可以将选定修订标签与此文件夹及其关联项分离 , 或者 , 

将标签附加到文件夹的子文件夹或与之分离。 



如果将视图标签与某个文件夹分离 , 则该标签会自动与该文件夹包含的项分离。它还自 

动与该文件夹的子文件夹及其内容分离。如果将视图回滚到特定视图标签 , 并且某个文 

件夹没有该标签 , 则无论如何也看不到文件夹的子文件夹及其内容。 

查看附加到文件夹修订的标签 : 


2 从 Folder ( 文件夹 ) 或上下文菜单中选择 Labels ( 标签 )。 

Labels ( 标签 ) 对话框按修订列出当前附加到此文件夹或项的标签。 

将标签从一个修订移动到另一个修订 : 

1 从文件夹层次中选择文件夹或从上部窗格中选择项。 

2 从 Folder ( 文件夹 ) 或上下文菜单中选择 Labels ( 标签 )。出现 Labels ( 标签 ) 对 

话框。 

3 将标签从一个修订拖动到另一个修订。 

创建修订标签并将其附加到文件夹及其内容 : 

1 从文件夹层次中选择文件夹或从上部窗格中选择项。 

2 从 Folder ( 文件夹 ) 或上下文菜单中选择 Labels ( 标签 )。出现 Labels ( 标签 ) 对 

话框。 

3 选择要附加新标签的修订。 

4 单击 New ( 新建 ) 创建新修订标签。出现 Attach a New Revision Label ( 附加新修 

订标签 ) 对话框。 

第 16 章 : 使用标签 255



个字符。 

6 ( 可选 ) 为确保只有选定修订可以具有该修订标签 , 请选中 Frozen ( 冻结 ) 复选框。 

7 执行以下操作之一。将标签附加到 : 

■ 

仅限选定文件夹 , 选中 Folder Only ( 仅限文件夹 ) 选项按钮。 

■ 

■ 

文件夹及其非文件夹内容 , 选中 Folder And Items Contained In Folder ( 文件夹 

和文件夹中包含的项 ) 选项按钮。 

文件夹及其内容 , 文件夹的子文件夹及其内容等等 , 选中 Everything In Subtree 

Rooted At Folder ( 文件夹为根的子树中的所有内容 ) 选项按钮。 

注因为将标签附加到文件夹也会将标签附加到该文件夹的内容和子文件夹等等 , 

所以标签始终附加到每个文件夹和项的当前配置。如果为特定项加标签 , 还可 

以为其过去修订加标签。但是这对于文件夹却是不能实现的。 

将现有标签附加到文件夹及其内容 : 


2 从 Folder ( 文件夹 ) 菜单、项菜单或它们的上下文菜单之一选择 Labels ( 标签 ) 。 

出现 Labels ( 标签 ) 对话框。 

3 单击 Attach ( 附加 )。 

Attach a Label ( 附加标签 ) 对话框列出所有现有标签并将它们标识为视图标签或修 

订标签。由于默认情况下 View Labels ( 视图标签 ) 和 Revision Labels ( 修订标签 ) 

两个复选框都为选中状态 , 因此会列出这两种类型的标签。 

4 ( 可选 ) 通过清除不想显示的标签类型所对应的复选框 , 可以将列表限制为只显示视 

图标签或只显示修订标签。 

5 从列表中选择标签。 

6 执行以下操作之一。将标签附加到 : 

■ 

仅限选定文件夹 , 选中 Folder Only ( 仅限文件夹 ) 选项按钮。 

■ 

文件夹及其非文件夹内容 , 选中 Folder And Items Contained In Folder ( 文件夹 

和文件夹中包含的项 ) 选项按钮。 

■ 

文件夹及其内容 , 文件夹的子文件夹及其内容等等 , 选中 Everything In Subtree 

Rooted At Folder ( 文件夹为根的子树中的所有内容 ) 选项按钮。 

将标签与文件夹及其内容分离 : 



为项加标签 

2 从 Folder ( 文件夹 ) 或上下文菜单中选择 Labels ( 标签 )。 

Labels ( 标签 ) 对话框列出当前附加到该文件夹的标签。 

3 选择要与该文件夹分离的标签。 

4 单击 Detach ( 分离 )。出现 Detach Label ( 分离标签 ) 对话框。 

5 ( 可选 ) 如果要将修订标签与文件夹分离 , 选中 Folder Only ( 仅限文件夹 )、 Folder 

And Items Contained In Folder ( 文件夹和文件夹中包含的项 ) 或 Everything In 

Subtree Rooted At Folder ( 文件夹为根的子树中的所有内容 ) 选项按钮。 

要显示标签的属性 , 可双击相应标签 , 或者选择标签后单击 Properties ( 属性 )。修订 

标签具有名称和说明。视图标签具有名称、说明和配置时间。 


除了为文件夹加标签时可使用的操作以外 , 还可以根据项是否有特定标签从上部窗格中 

选择这些项。然后可以执行诸如打印相关报告等操作。如果为选定项加上标志 , 还可以 

创建查询 , 供以后查找这些项时使用。 

Label( 标签 ) 窗格中显示选定项的修订的树 , 在该树中 , 附加到这些修订的标签显示为 

这些修订的子项。在该树中 , 标签的类型 ( 视图或修订 ) 显示在其名称之前。 

右键单击某个修订会显示一个上下文菜单 , 可通过该菜单将另一个标签附加到修订。如 

果右键单击标签 , 还可以查看其属性并将其与修订分离。无论右键单击什么 , 都可以从 

上下文菜单中选择 Expand All ( 全部展开 ) 或 Collapse All ( 全部折叠 ), 以完全展开 

或完全折叠修订树。 

双击修订也可以展开或折叠该修订。双击标签可显示其属性。 

查看附加到项修订的标签 : 


2 选择 Label ( 标签 ) 选项卡。 

选定项的标签显示在下部窗格中 , 其显示方式与它们显示在上述 Labels ( 标签 ) 对话 

框 ( 用于文件夹 ) 中的方式几乎相同。 

将标签从一个修订移动到另一个修订 : 



修订名称和每个修订的标签显示在下部窗格中。 

3 将标签从一个修订拖动到另一个修订。 

创建修订标签并将其附加到项 : 


第 16 章 : 使用标签 257


2 从项或上下文菜单中选择 Labels ( 标签 ) >New( 新建 ) 。出现 Attach a New 

Revision Label ( 附加新修订标签 ) 对话框。 


个字符。 

4 ( 可选 ) 为确保只有选定修订可以具有该修订标签 , 请选中 Frozen ( 冻结 ) 复选框。 

5 通过选择配置选项按钮指示要接收此标签的项修订。选项包括 : 

■ 

Current Configuration ( 当前配置 ), 将标签附加到最新修订。 

■ 

Labeled Configuration ( 加标签的配置 ), 将标签附加到带有指定标签的修订。 

现有视图标签和修订标签按其创建时间的相反顺序列出。在列表中 , 视图标签列在 

修订标签之前。 

注在另一个修订标签的基础上创建修订标签与复制该修订标签的效果相同。 

■ 

Promotion State Configuration ( 提升状态配置 ), 将标签附加到当前处于指定提 

升状态的修订 ( 将标签附加到同样具有该提升状态的当前视图标签的修订 )。 

■ 

Configuration As Of ( 配置截止日期 ), 将标签附加到是指定日期和时间的最新修 

订的修订。 

将现有标签附加到项 : 


2 从项或上下文菜单中选择 Labels ( 标签 ) > Attach ( 附加 )。 



Attach a Label ( 附加标签 ) 对话框列出所有现有标签并将它们标识为视图标签或修 






5 通过选择配置选项按钮指示要接收此标签的项修订。选项包括 : 

■ 

Current Configuration ( 当前配置 ), 将标签附加到最新修订。 

■ 

Labeled Configuration ( 加标签的配置 ), 将标签附加到带有指定标签的修订。 

现有视图标签和修订标签按其创建时间的相反顺序列出。在列表中 , 视图标签列在 

修订标签之前。 

■ 

Promotion State Configuration ( 提升状态配置 ), 将标签附加到当前处于指定提 

升状态的修订 ( 将标签附加到同样具有该提升状态的当前视图标签的修订 )。 

■ 

Configuration As Of ( 配置截止日期 ), 将标签附加到是指定日期和时间的最新修 

订的修订。 

将标签附加到特定修订 : 



3 右键单击修订。 

4 从 Label ( 标签 ) 上下文菜单中选择 Attach ( 附加 )。出现 Attach a Label ( 附加标 

签 ) 对话框。 




从项分离标签 : 


第 16 章 : 使用标签 259

应用于标签的访问权限 

2 从项或上下文菜单中选择 Labels ( 标签 ) >Detach( 分离 )。 

Detach a Label( 分离标签 ) 对话框列出所有可用标签。由于默认情况下 View Labels 

( 视图标签 ) 和 Revision Labels( 修订标签 ) 两个复选框都为选中状态 , 因此会列出 

这两种类型的标签。 



4 选择要与该项分离的标签。 

从特定修订分离标签 : 



3 右键单击标签。 

4 从 Label ( 标签 ) 上下文菜单中选择 Detach ( 分离 )。 

5 单击 OK ( 确定 ) 以确认。 

从上部窗格中选择在一些修订上有特定标签的项 : 

1 从项或上下文菜单中选择 Select ( 选择 ) > By Label ( 按标签 )。 

Select A Label ( 选择标签 ) 对话框列出所有现有标签并将它们标识为视图标签或修 



应用于标签的访问权限 



3 选择所需标签。在上部窗格中 , 带有该标签的项变为选中状态。 

通常 , 选择这些项的原因是要将它们用作一个组。例如 , 可以为这些项打印相关报告、 

加标志、附加标签或签出 ( 如果是文件 )。 

状态栏将指示上部窗格中的项数以及该窗格中的选中项数 ( 例如 ,8 files, 1 selected(8 

个文件 , 1 个选中 ))。 

可以在视图级别和文件夹 / 项级别设置应用于标签的访问权限。在视图级别设置的访问权 

限允许用户或组创建标签、编辑标签属性和删除标签。例如 , 如果可以创建标签 , 则可 

以设置其初始属性。但是 , 如果没有编辑标签属性的权限 , 则以后不能冻结或解冻标签。 

可以将标签附加到单个文件夹或项 , 从文件夹或项分离标签 , 或者将其从一个修订移动 

到另一个修订。移动标签的权限的名称为 “Adjust a label”( 调整标签 ) 。可以在文件 

夹或项级别授予或拒绝这些权限。 


章 

使用链接 

第 17 章 

链接文件夹和项 

Link 

链接是指两个文件夹、两个项或一个文件夹和一个项之间的连接。创建链接有很多好 

处。例如 , 当查看某个文件以及已经与该文件链接的、影响该文件的更改请求时 , 可以 

查看更改请求而无需选择 Change Request ( 更改请求 ) 选项卡。方法是选择该文件 , 

然后选择下部窗格下面的 Link ( 链接 ) 选项卡 , 再双击相应链接。 

此外 , 将文件与更改请求链接还能够在签入对应文件时将更改请求标记为已修复。依此 

类推 , 如果将每组文件都与它们所实现的需求文档链接 , 则可以很容易地引用或更新该 

文档。有关将其它项与文件链接的详细信息 , 请参阅第 153 页的 “ 签入文件 ”、第 245 

页的 “ 将文件链接到过程项 ” 和第 245 页的 “ 使用到过程项的链接 ”。 

链接不提供与单独共享 ( 或引用 ) 的连接 , 而是提供与某个项的所有相关共享和分支的 

连接。链接不受任何项操作 ( 如分支、移动、共享等 ) 的影响。 

如果要将几个相同类型的项 ( 如更改请求 ) 与同一个项 ( 例如文件 ) 链接 , 则可以同时 

创建所有这些链接。从上部窗格中选择几个项 , 然后使用 Link ( 链接 ) 按钮或菜单命令 

将它们连接到另一个文件夹或项。不能使用 Link ( 链接 ) 按钮链接文件夹。 

将一个文件夹或项与另一个文件夹或项链接 : 

1 进行第一个选择 ( 例如从文件夹层次中选择一个 StarTeam 文件夹或从上部窗格中选 

择一个文件 )。从上部窗格中选择时 , 可选择多个项。从文件夹层次 ( 右侧窗格 ) 中 

选择时 , 一次只能选择一个文件夹。 

2 从 Folder ( 文件夹 ) 或菜单或其上下文菜单中选择 Links ( 链接 ) > Create 

Link ( 创建链接 )。或者 , 如果最初选择的是文件、更改请求、主题或任务 , 可使用 

工具栏中的 Link( 链接 ) 按钮。如果开始创建链接时使用的是文件夹 , 则此按钮将被 

禁用。 

鼠标指针将变成打结的绳子状。 

3 进行第二个选择 : 一个文件夹或同一类型的一个或多个项。 

您可能需要更改选项卡 , 使用 All Descendants ( 所有后代 )( 工具栏上的按钮或项 

菜单中的命令 ) 等等找到第二个选择。 

第 17 章 : 使用链接 261

链接文件夹和项 

4 从 Folder( 文件夹 ) 或菜单或其上下文菜单中选择 Links( 链接 )> Complete 

Link ( 完成链接 )。 

可第二次单击工具栏上的 Link( 链接 ) 按钮完成与某个项的链接。如果将某个 

项与文件夹链接 , 则 Link ( 链接 ) 按钮将被禁用。 

5 要检查操作结果 , 请执行以下一项操作 : 

■ 

选择一个已链接的文件、更改请求、主题或任务 , 然后选择下部窗格下面的 Link 

( 链接 ) 选项卡 , 以查看该项的链接。 

■ 

选择一个已链接的文件夹。选择 Folder ( 文件夹 ) > Properties ( 属性 ), 然后选 

择 Link( 链接 ) 选项卡 , 以查看该文件夹的链接。( 如果您没有查看链接的访问权 

限 , Folder Properties ( 文件夹属性 ) 对话框不会显示 Link ( 链接 ) 选项卡。) 

可通过选择链接的任一端查看该链接。您选择的那一端 ( 无论是文件夹还是项 ) 称为源。 

链接的另一端称为目标 , 它在 Link ( 链接 ) 选项卡的 Item Type ( 项类型 ) 列中列出。 

可选择任一端 , 这样 , 哪一端是源哪一端是目标便因您的选择而异。 

默认情况下 , 链接会连接链接对的最新修订。例如 , 如果将文件与更改请求链接 , 则连 

接会浮动 , 它始终将文件的最新修订与更改请求的最新修订连接。 

可更改链接 , 以使特定文件修订与更改请求的特定修订连接。连接变为固定 , 而不是 

浮动。 


了解链接列表中的列 

了解链接列表中的列 

如果您已开始创建链接 , 但在尚未完成时不想继续再创建此链接 , 可从 Folder ( 文件 

夹 )、 File ( 文件 )、 Change Request ( 更改请求 )、 Topic ( 主题 ) 或 Task ( 任务 ) 

菜单或其各自的上下文菜单中选择 Links ( 链接 ) > Cancel Link ( 取消链接 )。如果使 

用的是工具栏上的 Link ( 链接 ) 按钮 , 请按 Esc。 

在链接列表 ( 在下部窗格中 ) 或 Folder Properties ( 文件夹属性 ) 对话框中 , 都可右键 

单击列标题 , 以将链接排序和分组。例如 , 要按链接所指向的项的类型排序 , 请单击 Item 

Type ( 项类型 ) 列标题。有关详细说明 , 请参阅第 68 页的 “ 对数据排序和分组 ”。 

下面列出了链接列表中的各列及其说明。这些列还出现在 Folder Properties ( 文件夹属 

性 ) 对话框的 Link ( 链接 ) 选项卡上。( 如果您没有查看链接的访问权限 , 则 Folder 

Properties ( 文件夹属性 ) 对话框没有 Link ( 链接 ) 选项卡。) 

每个链接有两端 : 源和目标。源是从上部窗格或文件夹层次中选择的项 ( 如果正在查看 

Folder Properties ( 文件夹属性 ) 对话框的 Link ( 链接 ) 选项卡 )。 

第 17 章 : 使用链接 263

选择链接的特定修订 

链接列表中的每行定义一个链接 , 该链接的一端为源项或源文件夹。因为无法看到链接 

的另一端 , 所以链接列表中的各列对它进行标识。 

Created By 创建链接的用户的名称。 

( 创建者 ) 

Created On ( 创建创建链接的日期 / 时间。 

时间 ) 

View ( 视图 ) 假设您要随时查找当前视图中的项 , 因此视图字段包含以下一项内容 : 

如果链接是在当前视图中创建的 , 或链接是在另一视图中创建的 , 但项 

( 当前项与该项链接 ) 的共享副本存在于当前视图中 , 则应包含当前视图 

的名称。 

包含链接的视图的名称。如果视图是参考视图 , 则此名称为父视图的名称。 

Folder ( 文件夹 ) 链接列表中的文件夹或项所在的文件夹的名称。 

Item Type 

( 项类型 ) 

Item ( 项 ) 

Item Details ( 项详 

细信息 ) 

Item Version 

( 项版本 ) 

Selection Version 

( 选择版本 ) 


Folder Path ( 文件 

夹路径 ) 

标识链接的目标端所连接到的项的类型。此项为链接列表中列出的项。可 

出现在此列中的值为 Folder( 文件夹 )、 File ( 文件 )、 Change Request 

( 更改请求 )、 Task ( 任务 ) 和 Topic ( 主题 )。 

用文件夹名称、文件名、更改请求号或任务号等标识链接的目标端所连接 

到的项。 

使用文件夹说明、文件说明、更改请求概要、任务名或主题标题对项进行 

说明。 

当一个链接的两端固定到文件夹或项的特定修订时 , 这些修订会出现在链 

接列表的 Item Version ( 项版本 ) 和 Selection Version ( 选择版本 ) 列 

中 ( 如果该修订在当前视图中 )。 

如果该修订在当前视图中 , 则 Item Version ( 项版本 ) 会显示链接目标端 

的版本号。 

Selection Version ( 选择版本 ) 显示链接源端的修订号。源为从文件夹层 

次中选择的文件夹 ( 当查看文件夹的链接时 ), 或从上部窗格中选择的项 

( 当查看项的链接时 )。 

此列中没有修订号时 , 该链接的一端是浮动的 , 而不是固定的。 

在 Link Properties ( 链接属性 ) 对话框中 , 可输入有关此特定链接的注 

释。该注释出现在此列中。 

仅当链接的项在同一视图中时 , 才显示文件夹路径信息。否则 , 显示以下 

消息 :“Unavailable. Item in another view. ( 不可用。项在另一视图 

中。)”。 


链接的每一端都有一个相关的开始修订和结束修订 , 它们决定应用链接的修订的范围。 

开始修订总是在创建链接时固定 , 并设置为当前分支的第一个修订。结束修订由用户控 

制 , 它可以是固定的 ( 为链接的修订设置上限 ), 也可以是浮动的 ( 不设置此上限 )。 

如果某个链接端是固定的 , 则它始终连接到所链接的文件夹或文件的同一版本。如果某 

个链接端是浮动的 , 则创建链接的文件夹或项的新修订时 , 它从一个修订移动到另一个 

修订。 

判断链接在给定项上是否可见非常简单。如果为链接定义的开始和结束修订之间的任何 

修订都在选定项的历史记录中 , 则该链接可见。否则 , 不可见。 

将链接端连接到最新修订 : 

1 选择已链接的文件夹或项。 


■ 

如果选择了一个项 , 则在下部窗格中选择 Link ( 链接 ) 选项卡。 Link ( 链接 ) 选 

项卡会列出与其它项的链接。 

■ 

如果选择了一个文件夹 , 则选择 Folder ( 文件夹 ) > Properties ( 属性 ), 然后从 

Folder Properties ( 文件夹属性 ) 对话框中选择 Link ( 链接 ) 选项卡。( 如果没有 

查看链接的访问权限 , 则没有 Link ( 链接 ) 选项卡。) 

3 在 Link ( 链接 ) 选项卡中 , 选择一个或多个链接。 



4 右键单击以打开 Link ( 链接 ) 上下文菜单。 


■ 

■ 

■ 

■ 

■ 

■ 

对于任何在 Link( 链接 ) 选项卡中选择的链接 ,Pin Link( 固定链接 )> To Source 

Item At Tip( 到最新修订的源项 ) 命令将此链接固定到链接的源的最新修订。此处 

的源是指您正在查看属性的文件夹或从上部窗格中选择的项。 

例如 , 如果从上部窗格中选择了一个文件 , 从 Link ( 链接 ) 选项卡选择了指向某 

个更改请求的链接 , 则此命令会将它们之间的链接固定到该文件的最新修订。 

又比如 , 如果从某个文件夹的 Folder Properties ( 文件夹属性 ) 对话框选择了指 

向一个文件的链接 , 则此命令会将它们之间的链接固定到此文件夹的最新修订。 

对于任何在 Link( 链接 ) 选项卡中选择的链接 ,Pin Link( 固定链接 )> To Target 

Items At Tip ( 到最新修订的目标项 ) 命令将此链接固定到链接目标的最新修订。 

此处的目标是指 Link ( 链接 ) 选项卡的 Item ( 项 ) 列中的文件夹或项。 

例如 , 如果从上部窗格中选择了一个文件 , 从 Link ( 链接 ) 选项卡选择了一个更 

改请求 , 则此命令会将它们之间的链接固定到该更改请求的最新修订。 

对于任何在 Link( 链接 ) 选项卡中选择的链接 ,Pin Link( 固定链接 )> To Source 

And Target Items At Tip ( 到最新修订的源和目标项 ) 命令将固定此链接的源和 

目标。 


改请求 , 则此命令会将它们之间的链接固定到该文件和更改请求的最新修订。 

对于任何从 Link( 链接 ) 选项卡中选择的链接 ,Float Link( 浮动链接 )> To Source 

Item( 到源项 ) 命令会在创建新修订时使链接的源从一个最新修订浮动到另一个最 

新修订。此处的源是指从文件夹层次中选择的文件夹 , 或从上部窗格中选择的项。 


改请求 , 则它们之间的链接会从文件的一个最新修订浮动到另一个。 

对于任何从 Link( 链接 ) 选项卡中选择的链接 ,Float Link( 浮动链接 )> To Target 

Items ( 到目标项 ) 命令会在创建新修订时使链接的目标从一个最新修订浮动到另 

一个最新修订。此处的目标是指 Link ( 链接 ) 选项卡的 Item ( 项 ) 列中的文件夹 

或项。 


改请求 , 则它们之间的链接会从更改请求的一个最新修订浮动到另一个。 

对于在 Link( 链接 ) 选项卡中选择的任何链接 ,Float Link( 浮动链接 )> To Source 

And Target Items( 到源和目标项 ) 命令会使链接的源和目标都从一个最新修订浮 

动到另一个最新修订。 

例如 , 如果从文件列表中选择了一个文件 , 从 Link ( 链接 ) 选项卡选择了一个更 

改请求 , 则它们之间的链接会在文件的最新修订之间浮动 , 也会在更改请求的最新 

修订之间浮动。 

第 17 章 : 使用链接 265


链接特定修订 : 

1 选择已链接的文件夹或项。 


■ 

如果选择了一个项 , 则在下部窗格中选择 Link ( 链接 ) 选项卡。 

■ 

如果选择了一个文件夹 , 则选择 Folder ( 文件夹 ) > Properties ( 属性 ), 然后选 

择 Link ( 链接 ) 选项卡。( 如果没有查看链接的访问权限 , 则没有 Link ( 链接 ) 

选项卡。) 

3 从 Link ( 链接 ) 选项卡中选择一个链接。 

4 右键单击以打开上下文菜单。 

5 选择 Link Properties ( 链接属性 )。出现 Link Properties ( 链接属性 ) 对话框。 

6 ( 可选 ) 在 Comment ( 注释 ) 文本框中输入链接说明或注释。在此处输入的说明会 

出现在链接列表的 Comment ( 注释 ) 列中。 

7 在 Source Item ( 源项 ) 组框中 , 执行以下一项操作 : 

■ 

■ 

单击 Pin ( 固定 ), 选择从文件夹层次中选择的文件夹的特定修订 , 或选择从上部 

窗格中选择的项的特定修订。出现 Select Version ( 选择版本 ) 对话框。 

从列表中选择文件夹或项修订。此修订号将出现在链接列表的 Selection Version 

( 选择版本 ) 列。 

■ 

单击 Float ( 浮动 ), 以使该链接总是连接到此项的最新修订。 

8 在 Is Linked To Target Item ( 链接到目标项 ) 组框中 , 执行以下一项操作 : 

■ 

单击 Pin( 固定 ), 以选择在链接列表的 Item( 项 ) 列中标识的项的特定修订。在 

随后显示的 Select Version ( 选择版本 ) 对话框中 , 从列表中选择文件夹或项修 

订。此修订号将出现在链接列表的 Item Version ( 项版本 ) 列。 

■ 

单击 Float ( 浮动 ), 以使该链接总是连接到此项的最新修订。 

9 单击 OK ( 确定 )。 


查看属性 

查看属性 

在 Link ( 链接 ) 选项卡中 , 可编辑链接的属性 , 或在只读对话框中显示目标文件夹或项 

的属性。修改链接的能力受您对所链接的项的访问权限的控制。对于那些对链接有总体 

影响的操作 ( 如 Comment( 注释 )), 您必须有访问链接的两端的项的权限。对于只影 

响链接的一端的操作 , 仅需要具有访问受影响端的项的权限。 

查看链接的属性 : 

1 从上部窗格中选择一项 , 或从文件夹层次 ( 右侧窗格 ) 中选择一个文件夹。 


■ 


■ 



选项卡。) 

3 从 Link( 链接 ) 选项卡中右键单击一个链接 , 并从上下文菜单中选择 Link Properties 

( 链接属性 )。 

4 在所显示的 Link Properties ( 链接属性 ) 对话框中 , 根据需要编辑这些属性。 

5 单击 OK ( 确定 )。 

查看链接的项的属性或链接的文件夹的属性 : 

1 从上部窗格中选择一项 , 或从文件夹层次 ( 右侧窗格 ) 中选择一个文件夹。 


■ 


■ 



选项卡。) 


■ 

从 Link ( 链接 ) 选项卡中双击一个链接。 

■ 

右键单击一个链接 , 以打开 Link( 链接 ) 上下文菜单 , 并选择 Item Properties( 项 

属性 )。 

Properties ( 属性 ) 对话框显示有关位于该链接的目标端的文件夹或项的信息。它是 

Link ( 链接 ) 选项卡的 Item ( 项 ) 列中的文件夹或项。此对话框为只读。 

删除链接 

若某个链接是错误链接或已过时 , 则可删除它。 

删除链接 : 

1 从上部窗格中选择项 , 或从文件夹层次 ( 右侧窗格 ) 中选择文件夹。 


■ 


■ 



选项卡。) 

3 右键单击要删除的链接。 

4 从上下文菜单中选择 Delete Link ( 删除链接 )。 

第 17 章 : 使用链接 267

删除链接 


章 

使用引用 

第 18 章 

一个 StarTeam 位置的文件夹或项可以基于存储在相同服务器配置内不同 StarTeam 位 

置的另一个文件夹或项。引用指示原文件夹或项与基于它的其它文件夹或项之间的关 

系。引用可用于决定对一个位置的文件夹或项所做的更改是否需要应用于其它位置。 

执行以下操作时 , 至少会创建文件夹或项的一个引用 : 

■ 

创建文件夹或项 , 或者将文件夹或项添加到 StarTeam。 

■ 

创建包含文件夹或项的分支子视图。 

由于分支子视图是从其父项创建的 , 因而该父项的文件夹或项的子集也是子视图的一 

部分。该子集中的文件夹和项自动共享到子视图中。 

■ 

将文件夹或项从一个位置手动共享到另一个位置。 

注 

如果视图是分支和浮动的子视图 , 或者视图带有分支和浮动的子视图 , 则在添加、共享 

或移动文件夹或项时 , 会产生对它的多个引用。 

例如 , 假定要将文件从一个文件夹移动到同一个视图中的另一个文件夹。假定视图有两 

个子视图 , 这两个子视图中都包含该文件。这意味着至少有三个此文件的引用 , 这三个 

视图各有一个。现在 , 将文件移动到同一视图的另一个文件夹。当前视图中的引用会被 

移动 , 以表示文件的新位置。根据两个子视图的属性 , 可能会为每个子视图中的文件创 

建一个新引用。那些子视图中对原始位置文件的引用仍然存在 , 因为 StarTeam 假定您 

不会仅仅因为移动了当前视图中的文件而更改这些引用。加上先前的三个引用 , 最终会 

有对该文件的五个引用。 

如果用户很可能执行许多将导致附加引用的操作 , 则大多数管理员会避免使用分支和 

浮动视图。例如 , 移动和共享会产生对相同文件夹或项的多个多余的引用 , 从而会造 

成混乱。 

第 18 章 : 使用引用 269

查看引用 

下表说明在当前视图、接收视图、接收视图的父视图及接收视图的子视图中会创建哪些引 

用。这常常是递归的。例如 , 如果在父视图中创建一个引用 , 则可能会在该视图的其它子 

视图或者该视图的父视图等地方创建新引用 , 具体情况取决于哪些视图是浮动视图。 

表 18.1 哪些因素会导致创建引用 ? 

文件夹或项 : 

是否将引用添加 

到接收视图 ? 


到接收视图的父 

视图 ? 


到接收视图的子 

视图 ? 

是新建视图的一 

部分 

是 , 除非新视图是 

参考视图。在本例 

中 , 不真正创建新 

视图 , 因为参考视 

图只是一种新的查 

看现有视图的方 

法。新建的视图中 

存在对文件夹或项 

的引用。 

否 , 因为父视图是 

文件夹或项的源 , 

所以父视图中的引 

用已经存在。 

否 , 因为新建的视 

图没有子视图。 

添加到当前视图 

是 , 当前视图中存 

在对新文件夹或项 

的引用。 

是 , 如果当前视图 

是父视图的无分 

支、浮动子视图。 

否则为否。 

是 , 如果子视图是 

当前视图的分支 

( 无分支或全部分 

支 )、浮动子视图。 


在当前视图内共享 

是 , 在当前视图 

的新位置为共享 

的文件夹或项创 

建新引用。 










在当前视图内移动 

否 , 原始引用被更 

新 , 来反映移动。 










查看引用 

Current 

在手动共享和视图是其它视图的子项的情况下 , 文件夹或项可与 ( 相同服务器配置内 ) 

多个项目、视图或父文件夹关联。文件夹或项的每个实例都有对其最新修订的引用。 

要查看文件夹引用 , 请打开单独的对话框 ; 要查看项引用 , 请使用项目视图窗口和下部 

窗格上的 Reference ( 引用 ) 选项卡。 

查看文件夹引用 : 


2 从 Folder( 文件夹 ) 或上下文菜单中选择 Advanced( 高级 )> References( 引用 )。 

随即出现的 Folder References ( 文件夹引用 ) 对话框将显示一个树结构 , 指出哪些 

项目视图引用该文件夹及其彼此的关系。 

在下面的 Folder References( 文件夹引用 ) 对话框样例中 , 选定的文件夹有四个引用。 

Current( 当前 ) 图标指示哪个引用代表当前选择的文件夹或项。否则 , 不管在哪个视图 

中选择该文件夹 , 此对话框都包含相同的信息。 

每个引用显示下列内容 , 用双冒号 (::) 分隔 : 

■ 

■ 

■ 

项目名 ( 例如 Help Files)。 

从根视图到包含文件夹 ( 或项 ) 的视图的路径。例如 Help Files\Freeze Check\New 

View, 其中 Help Files 是根视图的名称 , Freeze Check 是根视图的子视图 , New 

View 是 Freeze Check 视图的子视图。 

视图内文件夹的路径 ( 例如 Help Files\release 4\StarTeam)。如果是项 , 则此路径 

是项的父文件夹的路径。 


查看引用 

■ 

与项关联的名称或号码 ( 如果是项 )。这可以是文件名、更改请求号、需求号、任务 

号或主题号。 

■ 

该视图中文件夹 ( 或项 ) 的最新修订号。( 此信息使用逗号与引用的其余信息分隔 , 

而不使用双冒号。) 

例如 , 图中除 variant 2 视图外 ( 即树中最后一个叶 ) 的所有视图中 ,StarTeam 文件 

夹都是修订 1.0。在 variant 2 视图中 , 该文件夹的修订是 1.0.1.2, 这表示该文件夹从 

其父视图中的修订 1.0 分支 , 在 variant 2 视图中有三个修订。这些修订是 1.0.1.0、 

1.0.1.1 和 1.0.1.2。 

在本示例中 ( 这是 StarTeam 中的典型示例 ), 项目的名称、其根视图的名称及根视图 

中的根文件夹的名称都相同。 

可以调整该对话框的大小 ( 通过拖动边或角 )。适当时将显示滚动条。 

以粗体显示的引用指示当前选定的文件夹或项的哪些修订是其后代。换言之 , 当前选定 

的文件夹或项是以粗体显示的引用的修订历史的一部分。 

下图显示文件 (auditscc.doc) 的引用。当前选定文件的引用指示文件的修订是 1.6。如粗 

体指示的引用所示 , 修订 1.8 是修订 1.6 的唯一后代。如果在 auditscc.doc 的修订 1.6 

中发现缺陷 , 粗体显示有助于确定 1.6 的哪些后代也需要更正行。在本例中 , 只需要更 

新 1.8。 

查看项引用 : 


2 单击下部窗格下方的 Reference ( 引用 ) 选项卡。 

与 Folder References ( 文件夹引用 ) 对话框中的数据类似的数据显示在下部窗格中。 

Reference ( 引用 ) 窗格没有上下文菜单。 

查看项的过去修订的引用 : 





3 单击 References ( 引用 )。 

第 18 章 : 使用引用 271

了解初始引用 

了解初始引用 

出现相应的 References ( 引用 ) 对话框。它包含的数据与 Folder References ( 文件 

夹引用 ) 对话框中的数据类似。对于历史或最新修订 , 引用是相同的。但对于粗体显示 

的则不同。 

查看文件夹的过去修订的引用 : 



3 选择 History( 历史 ) 选项卡。( 如果没有查看此文件夹历史的访问权限 , 则不会出现 

History ( 历史 ) 选项卡。) 


5 单击 References ( 引用 )。出现相应的 References ( 引用 ) 对话框。 

将文件夹或项添加到 StarTeam 时 , 会创建引用。下图显示新建的 StarTeam 项目的 

StarTeam 文件夹层次。( 在本例中 , 它是该项目的根视图的文件夹层次。 ) 

下图显示此视图中 Source Code 文件夹的 Folder References ( 文件夹引用 ) 对话框。 

在此时间点 , 只有一个该文件夹的引用。 

一个引用有几个部分 , 包括项目名称、视图路径、StarTeam 文件夹路径和最新版本号。 

对该文件夹的属性进行更改后 , 修订号可能从 1.0 变为 1.1, 以后再变为 1.2。但是 , 该 

文件夹的引用仍然只有一个。 


了解通过分支视图创建的引用 

如果创建参考视图 ( 例如由一组审查者使用 ) , 则 Big Product 项目的视图层次将包括 

两个视图 , 但 Source Code 文件夹中仍然只有一个引用。 

参考视图中包含其父视图中的文件夹子集 , 但这些文件夹与父视图中的文件夹相同。它 

们不能分支。有关参考视图的详细信息 , 请参阅 StarTeam 管理员指南。 

请勿将参考视图与文件夹和项引用混淆。参考视图类似一个新视图 , 但它实际上是现有 

视图的一个子集。文件夹或项引用类似一个引用计数。它指示有多少个对象副本存在或 

者可以存在 ( 如果对象在其每个新位置都分支 )。 

这两个术语中都使用 reference 一词的矛盾之处在于 , 创建参考视图并不会导致任何文 

件夹或项引用的创建。下图显示为审查者创建参考视图后的 Folder References ( 文件 

夹引用 ) 对话框。 

用户手动共享文件夹或创建分支子视图时自动共享文件夹之前 , 附加的引用不会出现在 

Folder References ( 文件夹引用 ) 对话框中。 


创建分支视图时 , 从父视图自动共享的到子视图每个文件夹或项都会获得附加的引用。 

在引用层次中 , 新引用是原始引用的子项。 

假定交付 Big Product 的版本 1.0 时 , 团队负责人创建一个分支视图 ( 根据版本 1.0 的 

交货日期 ) 用于服务包 , 而版本 2.0 的新开发仍在 StarTeam 项目根视图中继续。下图 

显示所有三个视图的 StarTeam 文件夹层次。 

第 18 章 : 使用引用 273


此点的引用计数变为 2。下图显示根视图和为 1.0 服务包创建的子视图中 Source Code 

文件夹的 Folder References ( 文件夹引用 ) 对话框。 

Current 

Current( 您所在处 ) 图标指示哪个引用代表当前选择的文件夹或项。否则 , 不管在哪个 

视图中选择该文件夹 , 此对话框都包含相同的信息。 

子视图的引用以缩进形式显示在其父视图的引用的下方。 

以粗体显示的引用指出文件夹或项的哪些修订是带有 Current ( 您所在处 ) 图标的文件 

夹或项的后代。换言之 , 当前文件夹或项是以粗体所示修订的历史的一部分。 

在上两个图中 , 两个引用都以粗体显示。在下两个图中 , 则不是这样。在父视图和子视 

图中都更改了 Source Code 文件夹的属性。父视图的文件夹现在有修订 1.3, 子视图的 

文件夹现在有修订 1.2.1.0。这两个文件夹的历史沿新的方向分支。 


了解通过向视图添加项创建的引用 

当前文件夹被视为其自身的后代 , 因此它始终以粗体显示。但是现在另一视图中的该文 

件夹已经有发展。它不再存在于当前文件夹的历史中。 

查看文件夹或项的历史时 , 您看到的是其祖先 , 而非其后代。但是 , 如果您更改一个位 

置的最新修订 , 而该修订是另一个位置的最新修订的祖先 , 则可以也将更改应用于另一 

个位置的最新修订 ( 第一个对象的后代 )。判断修订是否有后代的方式是查看其引用。 

下图显示文件 (auditscc.doc) 的引用。如粗体所示 , 如果当前修订是 1.6, 则 1.8 是其唯 

一后代。这也意味着可以在 1.8 的历史中找到修订 1.6。 

如果在 auditscc.doc 的修订 1.6 中发现缺陷 , 粗体显示有助于确定 1.6 的哪些后代还需 

要更正行。在本例中 , 需要更新 1.8。其它引用用于下列文件修订 : 

■ 

已经分叉 ( 分支 ) 而且可能与当前文件有很大程度的不同。 

■ 

是当前文件的祖先但不太可能需要更改。例如 , 它们在只读或不再使用的视图中。不 

管产生缺口的原因为何 , 这些祖先可能需要更多工作来处理将签入的更改。 

在创建文件夹或项的新修订之前 ( 也可能之后 ), 应该检查后代。在更改成为 StarTeam 

中的新修订之前 , 可以看到后代。之后 , 可以看到哪些其它引用有与新更改的文件夹或 

项相同的修订号。如果它们也有新修订号 , 则说明它们也已经含有新更改内容。例如 , 

文件可能在其它视图中浮动。 


向父视图或子视图添加新文件夹或项可以产生一两个引用 , 这取决于这两个视图之间的 

关系。 

如果子视图是分支浮动视图 , 向父视图添加新文件夹或项时将在每个视图中创建一个 

引用。 

如果子视图是使用 Branch None ( 无分支 ) 选项创建的分支浮动视图 , 向子视图添加新 

文件夹或项时将在每个视图中创建一个引用。 

第 18 章 : 使用引用 275


向下浮动 

如果视图是分支子视图 ( 使用 Branch None ( 无分支 ) 或 Branch All ( 全部分支 ) 选项 

创建 ) , 并且该子视图是浮动视图 , 则向父视图添加的任何文件夹或项在两个视图中都 

可见。该文件夹或项的历史指出创建对象的视图 , 而引用层次将标识父视图的引用显示 

为父引用。 

例如 , 如果向父视图添加一个文件 , 则在任一视图中该文件的历史都显示父视图的名 

称 , 直到该文件在子视图中分支。 

下图显示添加到父视图且向下浮动的文件在父视图中的历史。 

下图显示添加到父视图且向下浮动的文件在子视图中的历史。该文件的历史显示最初将 

该文件添加到 StarTeam 中时其源视图的名称 , 直到文件分支。然后它显示产生文件分 

支的视图的名称。 

下图显示在子视图中分支后该文件的引用。 

请注意 , 在文件分支之前 , 历史清楚地显示父视图为 “Big Product”。添加到父视图的 

文件夹和项的历史和引用与创建子视图时在父视图中的文件夹和项的历史和引用类似。 

注这些图形中的视图名称是为了使图形更易于理解。您决不能将视图命名为 “ 父视图 ” 

或者图中显示的任何其它名称。 

向上浮动 

如果视图是分支子视图 ( 使用 Branch None ( 无分支 ) 创建 ), 并且该子视图是浮动视 

图 , 则向子视图添加的任何文件夹或项在两个视图中都可见。使用 Branch All ( 全部分 

支 ) 选项创建的分支浮动子视图则不适用。 

该文件夹或项的历史指出创建对象的视图 , 而引用层次将标识父视图的引用显示为父 

引用。 

下图显示添加到子视图且向上浮动的文件在父视图中的历史。请注意 , 即使这是在父视 

图中的历史 , 该历史仍显示最初将文件添加到 StarTeam 时源视图的名称。 


了解通过手动共享对象创建的引用 

下图显示添加到子视图且向上浮动的文件在子视图中的历史。该文件的历史显示最初将 

该文件添加到 StarTeam 中时其源视图的名称 , 直到文件分支。然后它显示产生文件分 

支的视图的名称。在本例中 , 这两个视图正好是同一个视图。 

下图显示向上浮动的文件的引用层次。请注意 , 通过引用 , 您无法判断文件是从分支子 

视图添加到 StarTeam 的。 

文件的历史能够帮助您确定文件的原始位置。 

向上和向下浮动 

如果视图层次很深 ( 根视图有孙视图和曾孙视图等 ), 使用分支浮动视图会造成很大程 

度的混乱。例如 , 假定向根视图的孙视图添加文件。再假定 , 孙视图是使用 Branch None 

( 无分支 ) 选项创建的 , 其父视图 ( 根视图的子视图 ) 也是使用 Branch None ( 无分 

支 ) 选项创建的。添加的文件可以向上浮动到当前视图的父视图和祖父视图 , 进而再向 

下浮动到当前视图。这将导致 : 

■ 

当前视图中有一个文件引用 

■ 

当前视图的父视图中有一个文件引用 ( 从当前视图向上浮动的结果 ) 

■ 

根视图中有一个文件引用 ( 从当前视图的父视图向上浮动的结果 ) 

如果当前视图有浮动的子视图和孙视图等 , 则会创建更多引用。如果除了上述视图外 , 

根视图或父视图还有其它浮动的子视图 , 则还会创建更多引用。 

了解通过手动共享对象创建的引用 

在位置间 ( 无论是否在同一个视图中 ) 共享文件夹或项时 , 将为新位置的对象另外创建 

引用。新文件夹或项的引用成为所共享文件夹或项的引用的子项。 

下图显示名为 timeout.cpp 的文件的两个引用。该文件从名为 Source Code 的文件夹手 

动共享到同一个视图中的名为 Timeout 的文件夹。请注意 , 这两个引用与上文显示的两 

个文件夹的引用非常类似 , 第二个是基于第一个创建的 , 但它是创建分支视图的副产品。 

StarTeam 不根据其创建原因区分引用。但您可以从引用层次判断出第一个引用是第二 

个引用的源 , 因为第二个引用以缩进格式显示在第一个引用的下方。还可以判断出发生 

了手动共享或移动操作 , 因为它们在同一个视图中。( 如果第二个引用是在创建子视图 

时自动创建的 , 则它应该在不同的视图中。) 

共享的文件夹或项可以分支 , 但不会这样做。无论如何 , 其历史的某一子集是原始文件 

夹或项的历史的一部分。 

第 18 章 : 使用引用 277

了解通过移动对象创建的引用 


如果视图层次很深 ( 根视图有孙视图和曾孙视图等 ), 使用分支浮动视图会造成很大程 

度的混乱。假定除根视图外的所有视图都分支和浮动。根据创建视图的方法 , 共享的文 

件夹或项在其新位置可以浮动 : 

■ 

■ 

沿视图层次从接收视图向上浮动到根视图 

向下浮动到接收视图的所有子视图和孙视图等 

■ 

从接收视图的父视图和祖父视图等浮动到所有其它子视图 

其结果是 , 在项目视图层次的每个视图中的每个新位置都出现文件夹或项的一个引用。 

许多视图可能在旧位置已经有了该文件夹或项的引用。 

下图显示通过将名为 “shared within child view.doc” 的文件从 “branch none floating” 

视图中的一个位置共享到同一个视图中的另一个位置而创建的所有引用。前三个引用在 

执行共享操作之前就已经存在。第四个引用是根文件夹中的新引用。因为它是从 

“branch none floating” 视图向上浮动而来的 , 所以显示为该视图的第一个位置的子项。 

第五个和第六个引用是通过向下浮动到 “branch none floating” 视图的子视图而产生的 

引用。 

下图显示名为 shareall.doc 文件在共享到另一个视图之前只存在于 “branch all floating” 

视图中。根文件夹的引用是共享操作后产生的各引用的起点。但是 , 因为文件向上浮动 

到根然后向下浮动 , 所以接收视图可以是任何其它视图。向下浮动时 , 在 “branch all 

floating” 视图中创建第二个引用。 


从一个位置向同一个视图中的另一个位置移动文件夹或项时 , 对象在旧位置删除 , 并在 

新位置复原。但是 , 如果该视图的父视图和子视图中有任何一个是浮动的 , 则会在这些 

父视图和子视图中产生副作用。这是因为 , 除当前视图外 , 其它视图中旧位置的副本不 

随之删除。最终父视图和子视图中将有两个引用 ( 旧位置的引用和新位置的引用 ), 而 

不是只有新位置的引用。 

假设在没有任何分支子视图的指定视图中 , 将名为 timeout.doc 的文件从 Marketing 

Documentation 文件夹移动到 Timeout 文件夹。 



下两个图显示移动前和移动后该文件的引用。引用数相同 , 只是文件路径发生变化。文 

件从原始位置删除 , 并添加到新位置。 

但是 , 假定该视图有一个子视图在创建时没有切断与父视图的连接 ( 换句话说 , 该子视 

图是分支和浮动的 ) 。在该子视图中 , 如果移动的文件尚未分支 , 则它不会从其旧位置 

删除 , 因为您确实仍希望它在那里。但是 , 它会被添加到新位置 , 因为它是对父视图的 

更改 , 应该在子视图中反映出来。 

请注意 , 该文件在父视图中只有一个引用 , 但在子视图中有两个引用。 

一些客户使用文件夹对项进行分类。例如 , 他们决定在一个视图中创建一系列文件夹 , 

按如下标准对更改请求进行分类 : 

■ 

明确开始下一版本 

■ 

正在考虑下一版本 ( 时间允许 ) 

通常 , 这些更改请求从根文件夹移动到其中一个分类文件夹 , 或者在以后从一个分类文 

件夹重新整理并移动到另一个。这种方法在当前视图是很方便 , 但在父视图或子视图中 

会造成多个引用。如果视图层次很深 , 则当前视图的父视图、祖父视图、子视图、孙视 

图等都会受到影响。使用这种方法的客户通常创建不浮动的子视图。 


如果视图层次很深 ( 根视图有孙视图和曾孙视图等 ), 使用分支浮动视图会造成很大程度 

的混乱。假定除根视图外的所有视图都分支和浮动。在新位置 , 移动的文件夹或项可以 : 

■ 

■ 

沿视图层次从接收视图向上浮动到根视图 

向下浮动到接收视图的所有子视图和孙视图等 

■ 

从接收视图的父视图和祖父视图等浮动到所有其它子视图 

移动操作的结果是 , 在作为移动源的视图中 , 对所移动文件夹或项的引用少一个 , 而在 

接收视图中则多一个。 

下例显示将名为 “move within parent view” 的文件从根视图中的一个位置移动到同一 

个视图中的另一个位置 ( 这就是在该视图中只有一个该文件的引用的原因 ) 。开始时 , 

第 18 章 : 使用引用 279


在五个视图中都有该文件的引用。移动操作后 , 在根文件夹的所有子视图中都创建一个 

新引用 , 每个视图中有两个对所移动文件的引用 ( 原位置一个引用 , 新位置一个引用 )。 


章 

报告和导出数据 

第 19 章 

生成报告的样例情形 

StarTeam 提供多种报告。这些报告预先都格式化为 HTML 格式。但是 , 通过修改正确 

的报告模板可修改报告中所用的 HTML 格式或列。 

报告的生成受以下操作的影响 : 在 StarTeam 视图窗口的文件、更改请求、主题或任务 

列表中排序、分组和选择项。生成报告前 , 请在 StarTeam 视图窗口中排列数据。 

报告的生成出于多种原因。以下示例介绍了使用更改请求生成报告的三种可能情形并简 

要介绍了生成这些报告的步骤。有关更深入的说明 , 请参阅第 282 页的 “ 创建报告 ”。 

一位管理者需要一份关于整个项目中已解决的所有更改请求的报告 : 

1 该管理者从文件夹层次中选择根文件夹。 

2 接着 , 选择 Change Requests ( 更改请求 ) 选项卡。此操作打开上部窗格中的更改 

请求列表。 

3 然后从 Status ( 状态 ) 下拉列表框中选择 Status=Resolved 筛选器。 

4 接下来激活 All Descendants ( 所有后代 ) 按钮 ( 从工具栏或 Change Request ( 更 

改请求 ) 菜单 )。 

5 最后 , 该管理者从 StarTeam 客户机的菜单栏选择 Change Request ( 更改请求 ) > 

Reports ( 报告 ), 以生成一份更改请求摘要报告。 

一位团队领导者希望根据修复更改请求的负责人查看更改请求 : 

1 此团队领导者从文件夹层次中选择与其团队对应的项目文件夹。 



3 然后从 Status ( 状态 ) 下拉列表框中选择筛选器。 

4 接着激活 All Descendants ( 所有后代 ) 按钮。 

5 然后此团队领导者单击 Responsibility ( 责任 ) 列的标题 , 以根据负责的团队成员对 

更改请求进行排序。 

6 最后 , 此团队领导者从 StarTeam 客户机的菜单栏选择 Change Request ( 更改请 

求 ) > Reports ( 报告 ), 以生成一份更改请求详细报告。 

第 19 章 : 报告和导出数据 281

创建报告 

个别程序员想只查看他们所负责的那些更改请求 : 

1 个别程序员从文件夹层次中选择他们的项目文件夹。 



3 然后应用查询 (Responsibility Equals ) 以便只查看这些个别程序员当前 

所负责的更改请求。 

4 接着激活 All Descendants ( 所有后代 ) 按钮。 

5 最后 , 他们从 StarTeam 客户机的菜单栏选择 Change Request( 更改请求 )> Reports 

( 报告 ), 以生成一份更改请求详细报告。 

虽然以上示例仅适用于更改请求 , 但可创建其它项的其它报告。还可以将数据导出 , 以 

用于电子表格和其它应用程序。 

创建报告 

以下部分介绍如何生成 HTML 格式的报告。 

创建 HTML 格式的报告 : 

1 从 File( 文件 )、Change Request( 更改请求 )、Topic( 主题 )、Task( 任务 ) 或 

Audit ( 审核 ) 菜单中选择 Reports ( 报告 )。 

随即出现的 Reports( 报告 ) 对话框在 Available Reports( 可用报告 ) 列表框中显示 

一列可能的报告。 

2 在 Available Reports ( 可用报告 ) 列表框中 , 选择任何类型的报告。 


■ 

选择 Current Selection ( 当前选择 ) 选项按钮 ( 在 Create Report For ( 报告创建 

对象 ) 组框中 ), 以便只使用从上部窗格中选择的项创建报告。 

■ 

选择 Select All ( 全选 ) 选项按钮 , 以使用上部窗格中显示的所有项。 

4 在 Output File Name( 输出文件名 ) 文本框中 , 输入或浏览到报告的名称和位置 ( 如 

果不想使用默认值 )。请务必使用 .htm 或 .html 作为扩展名。 

报告的默认文件夹被设置为个人选项。有关详细信息 , 请参阅第 307 页的 “ 自定义 

StarTeam”。 

5 ( 可选 ) 在 Report title ( 报告标题 ) 文本框中 , 输入报告的名称。 


■ 

单击 Generate ( 生成 ) 以查看报告。 Web 浏览器将打开并显示您的报告。 


导出数据 

■ 

单击 Print ( 打印 ) 按报告在浏览器中显示的样子打印该报告。仅当您的计算机为 

.htm 扩展名建立了 “ 打印 ” 操作文件关联时 , Print ( 打印 ) 命令才起作用。在计 

算机上安装浏览器可创建此关联。 

要打印详细信息报告 , 请从 File( 文件 )、Change Request( 更改请求 )、Topic 

( 主题 )、 Task ( 任务 ) 或 Audit ( 审核 ) 菜单中选择 Print ( 打印 )。 

导出数据 

可以将数据导出 , 以用于电子表格和其它应用程序。 

可在上部窗格中显示的最多列数为 60。这也是可以导出的最多列数 ( 即使数据库中的列 

数多于该值 )。确保使用导出的数据的应用程序可接受多达 60 列的数据。 

创建可导入到 Excel 或其它此类应用程序的文本文件 : 


■ 

从 File( 文件 )、Change Request( 更改请求 )、Topic( 主题 ) 或 Task( 任务 ) 

菜单中选择 Advanced ( 高级 ) > Export ( 导出 )。 

■ 

从 Audit ( 审核 ) 菜单中选择 Export ( 导出 )。 

出现 Export ( 导出 ) 对话框。 

Export( 导出 ) 对话框显示两个列表。Available Fields( 可用字段 ) 列表框包含可显 

示为列标题但当前并未显示的所有字段。 Show These Fields In This Order ( 按此顺 

序显示这些字段 ) 列表框显示当前显示的所有字段。 

上图显示了可用于文件的字段。其它项具有不同的字段。 

有关各项可用的字段列表 , 请参阅从第 290 页的 “ 更改在模板中指定的字段 ” 开始 

的表格。 

2 执行以下任意操作组合 : 

■ 

将字段添加到报告。 

■ 

选择要显示在报告中的 Available Fields ( 可用字段 ) 列表中的字段。最多可显 

示 60 个字段。 

■ 

单击 Add ( 添加 )。 


导出数据 

■ 

从报告中删除字段。 

■ 

从 Show These Fields In This Order ( 按此顺序显示这些字段 ) 列表框选择要 

删除的字段。 

■ 

单击 Remove ( 删除 )。 

■ 

更改字段在报告中的显示顺序。 

■ 

在 Show These Fields In This Order ( 按此顺序显示这些字段 ) 列表框中将每 

个字段名拖动到所需位置。 

请记住 , 可双击一个字段名称将其从一个列表框移动到另一个列表框。 

Show Fields ( 显示字段 ) 对话框最初显示最常用的字段。选中 Show Advanced 

Fields ( 显示高级字段 ) 复选框可从可用字段的完整列表中选取。 

3 在 Create Report For ( 报告创建对象 ) 组框中选择 Current Selection ( 当前选择 ) 

选项按钮 , 以便只使用从上部窗格中选择的项创建报告。选择 Select All ( 全选 ) 选 

项按钮 , 以使用上部窗格中显示的所有项。 

4 选中 Export Field Names( 导出字段名称 ) 复选框 , 可在报告中包括选定的列标题字 

段。清除此复选框可在报告中排除列标题字段。 

5 如果要从导出的数据中删除任何可能嵌入文本字段中的回车符 , 请选中 Replace 

Embedded Carriage Returns With Spaces ( 用空格替换嵌入的回车符 ) 复选框。 

6 在 Text Qualifier ( 文本限定符 ) 文本框中输入一个限定符。 

限定符用在文本字段的两端。这样可防止对 HTML 输出中出现的回车 / 换行符和特殊 

字符进行特殊处理。 

无论限定符出现在文本的任何位置 , 它都是成对的。例如 , 假设限定符是双引号 , 更 

改请求报告的 Description ( 说明 ) 列包含 : 

Type "whatever" then press Enter. 

报告文件中将包含 : 

"Type ""whatever"" then press Enter." 

7 从 Delimiter ( 定界符 ) 下拉列表框选择一个用于分隔数据的字符。 

8 从 Encoding ( 编码 ) 下拉列表框选择一个编码。 

下图显示了此列表框的一个示例。此示例显示选择了 cp 1252, 即英语的代码页。根 

据您使用的操作系统等 , 可能看到不同的选项。 

有关编码的完整列表 , 请参阅下面的 “ 可用编码 ”。 

9 在 Output File Name ( 输出文件名 ) 文本框中 , 输入或浏览到报告文件夹和位置。 

请务必使用 .txt 或其它适当的扩展名。如果不使用扩展名 , 则文件的扩展名将是 .txt。 

10 单击 OK ( 确定 ) 以生成报告。 

11 在选定的应用程序中打开报告 , 然后按照打印说明打印报告。 


可用报告 

可用编码 

如果使用 Cross-Platform 客户机导出数据 , 将看到以下一些可能作为导出数据的编码的 

编码子集。编码列表取决于您的工作站可使用的编码。 

ASCII 

8859_1 // ISO Latin 1 

8859_2 // ISO Latin 2 (Eastern Europe) 

8859_3 // ISO Latin 3 (Latin, Esperanto) 

8859_4 // ISO Latin 4 (Baltic - old) 

8859_5 // ISO Cyrillic 

8859_6 // ISO Arabic 

8859_7 // ISO Greek 

8859_8 // ISO Hebrew 

8859_9 // ISO Latin 5 

Big5 // Windows Taiwan 

Cp297 // EBCDIC France; cp 代表代码页 ; 

Cp278 // EBCDIC Finland, Sweden 

Cp936 // Chinese (simplified) 

Cp950 // Chinese (traditional) 

Cp932 // Japan 

Cp1250 // Windows Latin 2 

Cp1251 // Windows Cyrillic 

Cp1252 // Windows Latin 1; American English 

Cp1253 // Windows Greek 

Cp1254 // Windows Latin 5 (Turkey) 

Cp1255 // Windows Hebrew; Israel 

Cp1256 // Windows Arabic 

Cp1257 // Windows Latin 4 (Baltic) 

Cp1258 // Windows Vietnamese 

EUC_CN // cp1383; EUC Chinese 

EUC_JP // EUC Japanese 

EUC_KR // EUC Korea 

EUC_TW // EUC Taiwanese 

GBK // Chinese 

ISO2022CN // Chinese and Taiwanese 

ISO2022CN_CNS // Chinese 

ISO2022CN_GB // Chinese 

ISO2022JP // Japanese 

ISO2022KR // Korean (South Korea) 

KOI8_R // Russian/Cyrillic 

SJIS // Japanese 

UTF8 // UTF-8 Unicode 

Unicode 

可用报告 

根据所选择的选项卡 , 可查看和打印许多不同的报告。 

表 19.1 

报告名称 

可用报告 : 文件选项卡 

报告说明 

默认值 

列出 Detail ( 详细信息 ) 窗格中的信息 , 每个字段使 

用一行。 

Detail ( 详细 ) 列出文件及其修订历史。 

Detail with Description 

( 带说明的详细报告 ) 

列出文件及其说明和修订历史。 


可用报告 

表 19.1 可用报告 : 文件选项卡 ( 续 ) 

报告名称 

Grouping Summary ( 分组指示每组中的文件数以及文件总数。 

摘要 ) 

Links ( 链接 ) 列出选定文件名称以及与之链接的项。 

Summary ( 摘要 ) 列出每个选定文件 ( 或未选择任何文件时列出全部文 

件 )。该报告显示 File Name ( 文件名 )、 Status ( 状 

态 )、 Locked By ( 锁定者 ) 和 Revision ( 修订 ) 字 

段以及选定文件总数。 

Summary with Description 

( 带说明的摘要 ) 

报告说明 

列出每个选定文件 ( 或未选择任何文件时列出全部文 

件 )。该报告显示 File Name ( 文件名 )、 Status ( 状 

态 )、 Locked By ( 锁定者 )、 Revision ( 修订 ) 和 

Description ( 说明 ) 字段以及选定文件总数。 

表 19.2 

报告名称 

可用报告 : 更改请求 

报告说明 

默认值列出 Detail ( 详细信息 ) 窗格中的信息 , 每个字段使用一行。 

Detail ( 详细 ) 列出特定更改请求字段 :Modified Time ( 修改时间 )、 

Responsibility ( 责任 )、 Entered On ( 输入时间 )、 Entered By 

( 输入者 )、 Last Build Tested ( 最后测试的内部版本 )、 Status 

( 状态 )、 Severity ( 严重性 )、 Addressed In ( 解决请求的内部版 

本 )、 Addressed By ( 解决者 )、 Priority ( 优先级 )、 Test 

Command ( 测试命令 )、 Type ( 类型 )、 Synopsis ( 概要 )、 

Description ( 说明 )、 Work Around ( 解决方法 ) 和 Fix ( 修复 )。 

Grouping Summary ( 分组指示每组中的更改请求数以及更改请求的总数。 

摘要 ) 

History ( 历史 ) 

列出 Detail ( 详细 ) 报告中的更改请求字段 , 后接有关该更改请 

求的每个修订的信息 : 修订号、修订日期和时间、作者、视图、 

注释以及分支修订。 

Links ( 链接 ) 列出选定更改请求以及与之链接的项。 

Summary ( 摘要 ) 列出每个选定的更改请求 ( 或未选择任何更改请求时列出全部更 

改请求 )。该报告显示 Modified Time ( 修改时间 )、 

Responsibility ( 责任 )、 Entered On ( 输入日期 )、 Entered By 

( 输入者 )、 Priority ( 优先级 )、 Type ( 类型 )、 Status ( 状 

态 )、 Severity ( 严重性 ) 和 Synopsis ( 概要 ) 字段以及选定更 

改请求的总数。 

表 19.3 可用报告 : 需求 

报告名称 

报告说明 

默认值 

列出 Detail ( 详细信息 ) 窗格 ( 采用列表格式时 ) 中的信息 , 每 

个字段使用一行。当此窗格为树或列表格式时均可创建此报告。 

Detail ( 详细 ) 

列出特定需求字段 :Modified Time ( 修改时间 )、 Name ( 名 

称 )、 Type ( 类型 )、 Status ( 状态 )、 Owner ( 所有者 )、 

Priority ( 优先级 ) 和 Description ( 说明 )。 

Grouping Summary ( 分组指示每组中的需求数以及需求总数。 

摘要 ) 

Links ( 链接 ) 列出选定需求以及任何与之链接的项。 

Summary ( 摘要 ) 

列出每个选定需求 ( 或未选择任何需求时列出全部需求 )。该报 

告显示 Title ( 标题 )、 Created By ( 创建者 ) 和 Created Time 

( 创建时间 ) 字段以及选定需求的总数。 


使用报告模板 

表 19.4 

报告名称 

可用报告 : 任务 

报告说明 

Detail ( 详细 ) 列出特定任务字段 :Modified Time ( 修改时间 )、 

Responsibility ( 责任 )、 Created Time ( 创建时间 )、 Created 

By ( 创建者 )、 Name ( 名称 )、 Status ( 状态 )、 Priority ( 优 

先级 )、Milestone( 里程碑 )、Duration( 持续时间 )、Percent 

Complete ( 完成百分比 )、 Needs Attention ( 需要注意 )、 

Attention Notes ( 注意说明 )、 Planned Start ( 计划开始 )、 

Planned Finish ( 计划完成 )、 Planned Work ( 计划工作 )、 

Actual Start ( 实际开始 )、 Actual Finish ( 实际完成 )、 Actual 

Work ( 实际工作 ) 和 Notes ( 说明 )。 

Grouping Summary ( 分组指示每组中的任务数以及任务总数。 

摘要 ) 

Links ( 链接 ) 列出选定任务以及任何与之链接的项。 

Summary ( 摘要 ) 

列出每个选定任务 ( 或未选择任何任务时列出全部任务 )。该报 

告显示 Task Name ( 任务名 )、 Created By ( 创建者 ) 和 

Created Time ( 创建时间 ) 字段以及选定任务的总数。 

表 19.5 

报告名称 

默认值 

可用报告 : 主题 

报告说明 

列出 Detail ( 详细信息 ) 窗格 ( 采用列表格式时 ) 中的信 

息 , 每个字段使用一行。当此窗格为树或列表格式时均可 

创建此报告。 

Detail ( 详细 ) 

列出特定主题字段 :Created By ( 创建者 )、 Status ( 状 

态 )、 Created Time ( 创建时间 )、 Priority ( 优先级 )、 

Title ( 标题 ) 和 Description ( 说明 )。 

Grouping Summary ( 分组摘要 ) 指示每组中的主题数以及主题总数。 

Links ( 链接 ) 列出选定主题以及任何与之链接的项。 

Summary ( 摘要 ) 列出每个选定主题 ( 或未选择任何主题时列出全部主题 )。 

该报告显示 Title ( 标题 )、 Created By ( 创建者 ) 和 

Created Time ( 创建时间 ) 字段以及选定主题的总数。 

表 19.6 

报告名称 

可用报告 : 审核条目 

报告说明 

默认值列出 Detail( 详细信息 ) 窗格中的信息 , 每个字段使用一行。 

Grouping Summary( 分组摘要 ) 指示每组中的审核条目数以及审核条目的总数。 

Summary ( 摘要 ) 列出每个选定条目 ( 或未选择任何条目时列出全部条目 )。 

该报告显示 Event ( 事件 )、 Class ( 类 )、 Created Time 

( 创建时间 )、 User ( 用户 ) 和 Item ( 项 ) 字段以及选定 

条目的总数。 


StarTeam 允许您自定义报告模板。这些模板位于安装过程中指定的 StarTeam 文件夹 

中。如果使用了默认路径 , 则 Reports 文件夹位于 installation_folder\Reports。应清楚 , 

不同的客户机 ( 例如 ,StarTeam Windows 客户机和 StarTeam Cross-Platform 客户机 ) 

以及同一客户机的不同版本可能有不同的安装文件夹。您可能需要将模板放在多个位 

置。所有模板都采用 HTML 格式。 

可在任何文本编辑器 (Microsoft 的 Developer Studio) 或 HTML 工具中打开和编辑报 

告模板。创建和编辑模板的一种简易方法是使用 Microsoft Word 97 或更高版本 , 它具有 

自动生成 HTML 文件的功能。 



Reports 文件夹包括各类型报告的一系列模板。每个模板都提供创建部分报告所需的格 

式信息。例如 , 更改请求默认值报告使用以下模板 : 

■ 

ChangeDefault.Title 

■ 

■ 

■ 

ChangeDefault.GrpInfo 

ChangeDefault.Group1 

ChangeDefault.EndReport 

首先处理 xDefault.Title, 并只处理一次。它使用您在 Reports ( 报告 ) 对话框中提供的 

标题作为报告标题。 

对于每个组 , 只处理一次 xDefault.GrpInfo。虽然可通过单击列标题来对数据进行排序 , 

但这样不会产生报告的分组。必须使用 Sort and Group ( 排序和分组 ) 功能来排列组 

( 如下图所示 ), 此功能先按状态再按优先级对更改请求进行分组 : 

对报告中的每项 ( 在本例中为每个更改请求 ) 重复使用 xDefault.Group1 模板。它为该 

项创建了一个记录 , 并用一条水平线将其与其它项记录分开。 

只处理一次 xDefault.EndReport。它计算报告中的总项数。 

下图是一个更改请求默认值报告的样例。它显示以下内容 : 

■ 

标题 ( 由 ChangeDefault.Title 格式化 ) 

■ 

两个组行 ( 灰色背景 , 由 ChangeDefault.GrpInfo 格式化 ) 

■ 

两个记录 ( 每个都由 ChangeDefault.Group1 格式化 ) 



样例报告中的每个组只包含一个记录。但是 , 大部分报告在每组中会有几个记录。本样 

例不显示总数 ( 由 ChangeDefault.EndReport 格式化 ) , 但最后一行应该是 :Total: 4 

( 总数 :4)。 

文件分组摘要报告使用 : 

■ 

■ 

■ 

FileGrouping Summary.Title 

FileGrouping Summary.GroupSummary 

FileGrouping Summary.EndReport 

对于每个组 , 只使用一次 xGrouping Summary.GroupSummary 模板。下图提供了一个 

样例。 



模板说明 

.Title: 在 .Title 模板中 , 报告标题用 ~~ReportTitle~~ 标记来表示。 

在 .Title 模板中 , 您可能想添加贵公司的徽标、更改字体或大小等。 

.GrpInfo:.GrpInfo 模板包含说明组的信息 , 该信息用 ~~GroupingInfo~~ 标记表示。 

.Group1..9: 按找到 .Groupx 文件的数字顺序对其进行处理。数字不必连续。当 

StarTeam 在报告中为各项创建记录时 , 它会搜索 Group1 到 Group9。 

组件中的字段名在双颚化符 (~~) 内单独指定。必须使用正确的 SQL 名。( 有关详细 

信息 , 请参阅第 290 页的 “ 更改在模板中指定的字段 ”。) 

字段的数据会替换 SQL 名和双颚化符。所有要在报告中出现的字段在报告生成时都 

必须显示为上部窗格中的列。否则 , 会跳过这些字段。 

.GroupSummary: 计算组中的总项数时使用 .GroupSummary 模板。组用 

~~GroupingInfo~~ 标记表示。 

.EndReport: 此模板结束报告。它可能包括以下进行合计的标记 : 

■ 

~~TotalHistoryCount~~ 

■ 

~~TotalRecordCount~~ 

■ 

~~TotalLinkCount~~ 

注 

因为一个报告有几个模板并且通常只有第一个模板有标记 , 因而您可能 

需要将标记添加到一个模板的开头才能编辑该标记。只有最后一个模板 

才应有标记。 

更改在模板中指定的字段 

可通过更改在报告模板中指定的字段来更改在报告中出现哪些字段。必须在模板中使用 

字段的内部标识符来指定字段。标识符通常不同于字段的显示名称 ( 用作列标题、窗格 

中显示的名称以及报告中的名称 )。 

例如 , TopicsSummary.Group1 模板包含以下几行 : 

~~Title~~ 

~~CreatedUserID~~ 

~~CreatedTime~~ 

如果要将 Read Status ( 读状态 ) 字段添加到此报告 , 则需要知道它的内部标识符为 

Read Status。然后您可能会将下面一行添加到模板中 : 

~~Read Status~~ 

请记住 , 即使在模板中指定了一个字段 , 但如果该字段不作为项目视图窗口的上部窗格 

中的列显示 , 它也将被跳过。在创建报告前 , 您可能想为特定报告创建筛选器。有关筛 

选器的详细信息 , 请参阅第 78 页的 “ 使用筛选器 ”。 



有关各字段的说明及其内部标识符的名称的信息 , 请参阅第 83 页的 “ 了解字段 ”。下表 

列出了历史和链接的一些附加字段。 

表 19.7 

文件历史 

文件历史和链接的附加字段 

显示字段名称 

Author ( 作者 ) 

Branch Revision ( 分支修订 ) 



Time ( 时间 ) 


链接 

内部标识符 

HistoryAuthor 

HistoryBranchRevision 

HistoryReason 

HistoryRevision 

HistoryDate&Time 

HistoryView 

显示字段项 

内部标识符 

Item Type ( 项类型 ) 

LinkType 


LinkComment 

Created By ( 创建者 ) LinkCreatedBy 

Created On ( 创建时间 ) LinkCreatedTime 


LinkFolder 

Folder Path ( 文件夹路径 ) LinkFolderPath 

Item ( 项 ) 

LinkItem 

Item Details ( 项详细信息 ) LinkItemDetails 

Item Version ( 项版本 ) LinkItemVersion 

Selection Version ( 选择版本 ) LinkSelectionVersion 


LinkViewCreated 



章 

使用图表 

第 20 章 

StarTeam Windows 客户机可提供各种图表。可在上部窗格中筛选出数据以仅显示要在 

图表中包含的数据。此外 , 还可从筛选的数据中选择要在图表中包含的特定项。 

可从上部窗格中显示的数据创建图表。上部窗格中最多可显示 60 个字段。 

可用图表 

根据所选选项卡和图表菜单选项 , 可显示许多不同的图表。可创建的不同类型图表包括 : 

■ 

■ 

■ 

■ 

Simple ( 简单 ) 图表 

Distribution ( 分布 ) 图表 

Correlation ( 相关性 ) 图表 

Time-series ( 时间序列 ) 图表 

对于审核条目 , 图表包括 : 

■ 

■ 

Distribution ( 分布 ) 图表 

Time-series ( 时间序列 ) 图表 

第 20 章 : 使用图表 293

可用图表 

下表提供了可用于创建图表的字段。从 Show Fields( 显示字段 ) 对话框 , 可选中 Show 

Advanced Fields( 显示高级字段 ) 复选框以显示可包括在图表中的其它字段。有关更改 

列标题字段的详细信息 , 请参阅第 5 章 “ 管理数据 ”。 

表 20.1 

文件图表 : 可用字段 

简单分布相关性时间序列 

Content Revision 

( 内容修订 ) 

DotNotation ID 

EOL Character 

(EOL 字符 ) 


Parent ID ( 父 ID) 

Parent Branch 

Revision ( 父分支 

修订 ) 

Parent Revision 

( 父修订 ) 

Project ID ( 项目 ID) 


Revision on Disk 

( 磁盘上的修订 ) 

Root Object ID 

( 根对象 ID) 


Sync Branch Version 

( 同步分支版本 ) 

Sync Content Version 

( 同步内容版本 ) 

Sync Local Size 

( 同步本地大小 ) 

Sync on Path to Root 

( 在根路径上同步 ) 

Vault Branch Version 

( 储存仓分支版本 ) 

Version ( 版本 ) 

Working File Size 

( 工作文件大小 ) 

根据当前正在分组的 

字段创建图表。 

Content Revision 

( 内容修订 ) 


EOL Character 

(EOL 字符 ) 



Parent Branch 


修订 ) 


( 父修订 ) 

Project ID ( 项目 ID) 


Revision on Disk 

( 磁盘上的修订 ) 




Sync Branch Version 

( 同步分支版本 ) 

Sync Content Version 

( 同步内容版本 ) 

Sync Local Size 

( 同步本地大小 ) 

Sync on Path to Root 

( 在根路径上同步 ) 

Vault Branch Version 

( 储存仓分支版本 ) 


Working File Size 

( 工作文件大小 ) 

Configuration Time 

( 配置时间 ) 

Created Time ( 创 

建时间 ) 

Deleted Time ( 删除 

时间 ) 

File Time Stamp at 

Check-In ( 文件签入 

时的时间戳 ) 

Modified Time ( 修 

改时间 ) 

Sync Local Time 

Stamp ( 同步本地时 

间戳 ) 

Working File Time 

Stamp ( 工作文件时 

间戳 ) 


可用图表 

表 20.2 

更改请求图表 : 可用字段 


Attachment Count 

( 附件计数 ) 

CR Number (CR 号 ) 




Parent Branch 


修订 ) 


( 父修订 ) 




根据当前正在分组的 




CR Number(CR 号 ) 




Parent Branch 


修订 ) 


( 父修订 ) 




Closed On ( 关闭 

时间 ) 



Created Time 


Deleted Time ( 删除 

时间 ) 

Entered On ( 输入 

时间 ) 


改时间 ) 

Resolved On ( 解决 

时间 ) 

Total Open* ( 打开 

总数 *) 

Verified On ( 验证 

时间 ) 

* 仅当显示 Entered On ( 输入时间 ) 和 Closed On ( 关闭时间 ) 字段时 , Total Open ( 打开总数 ) 才会 

可用。其值是该日 / 周 / 月输入的更改请求总数减去在该日 / 周 / 月关闭的更改请求总数之差。要获得 

在任何给定时间打开的更改请求的计数 , 最好选中 Cumulative Totals ( 累计总数 ) 复选框且不限制 

时间段。 

表 20.3 

需求图表 : 可用字段 


Ambiguities Found 

( 发现歧义 ) 



Children Count 

( 子项计数 ) 

CommentID 

Expected Effort 

( 预期工作量 ) 

High Effort ( 高工 

作量 ) 

Low Effort ( 低工 

作量 ) 

Number ( 号码 ) 

Object ID ( 对象 

ID) 

Parent 

Requirement ID 

( 父需求 ID) 

Responsible Count 

( 负责人计数 ) 

Revision Flags 

( 修订标志 ) 


根据当前正分组的 


Ambiguities Found 

( 发现歧义 ) 





CommentID 

Expected Effort 

( 预期工作量 ) 

High Effort ( 高工 

作量 ) 

Low Effort ( 低工 

作量 ) 

Number ( 号码 ) 


ID) 

Parent 

Requirement ID 

( 父需求 ID) 

Responsible Count 

( 负责人计数 ) 

Revision Flags 

( 修订标志 ) 



建时间 ) 



Deleted Time ( 删 

除时间 ) 


改时间 ) 

End Modified Time 

( 最终修改时间 ) 

第 20 章 : 使用图表 295

可用图表 

表 20.4 

任务图表 : 可用字段 


Actual Hours 

( 实际小时数 ) 





Estimated Hours 

( 估计小时数 ) 

MS Task Unique 

ID (MS 任务的 

唯一 ID) 


ID) 

Parent Task ID 

( 父任务 ID) 

Percentage 

Complete ( 完成 

百分比 ) 

Task Duration 

( 任务持续时间 ) 

Task Number 

( 任务号 ) 


根据当前正在分组 

的字段创建图表。 

Actual Hours 

( 实际小时数 ) 





Estimated Hours 

( 估计小时数 ) 

MS Task Unique 

ID (MS 任务的 

唯一 ID) 


ID) 

Parent Task ID 

( 父任务 ID) 

Percentage 

Complete ( 完成 

百分比 ) 

Task Duration 

( 任务持续时间 ) 

Task Number 

( 任务号 ) 


Actual Finish 

( 实际完成 ) 

Actual Start ( 实际 

开始 ) 



Constraint Date 

( 限制日期 ) 


建时间 ) 

Deleted Time ( 删 

除时间 ) 

Estimated 

Finish ( 估计完成 ) 

Estimated Start 

( 估计开始 ) 

Last MS Project 

Update ( 上次从 

MS Project 更新 ) 

Last Work/ 

Dependency 

Update ( 上次工作 

/ 依存关系更新 ) 

Modified Time 


表 20.5 

主题图表 : 可用字段 







( 收件人计数 ) 


ID) 

Parent Topic ID 

( 父主题 ID) 

Topic Number 

( 主题号 ) 








Recipient Count 

( 收件人计数 ) 


ID) 

Parent Topic ID 

( 父主题 ID) 

Topic Number 

( 主题号 ) 


Created Time 




Deleted Time 

( 删除时间 ) 

Modified Time 


表 20.6 

审核条目图表 : 可用字段 


不可用 



不可用 

Created Time 


Deleted Time 

( 删除时间 ) 

Modified Time 



创建简单图表 

创建简单图表 

简单图表由一系列的条组成 , 用于比较选定项的一个或多个字段的值。所比较的每一个 

字段都有其自己的唯一的彩色条。例如 , 下面的简单图表比较的是文件大小。 

创建简单图表 : 

1 从 File ( 文件 )、 Change Request ( 更改请求 )、 Topic ( 主题 ) 或 Task ( 任务 ) 

菜单中选择 Charts ( 图表 ) > Simple ( 简单 )。出现 Simple Chart ( 简单图表 ) 对 

话框。 

2 在 Chart Name ( 图表名称 ) 文本框中输入图表名称。 

3 从 Series( 系列 ) 列表框中选择一个或多个字段。StarTeam 在上部窗格中列出可以 

图表形式显示的字段。上部窗格中最多可显示 60 个字段。 


■ 

为仅显示选定项的图表选择 Current Selection ( 当前选择 )。 

■ 

选择 Select All ( 全选 ) 以显示包含列表中所有项的图表。 

5 选择打印机页面方向 :Portrait ( 纵向 ) 或 Landscape ( 横向 )。 

6 单击 OK ( 确定 ) 显示图表。 

第 20 章 : 使用图表 297

创建分布图表 

创建分布图表 

分布图表以上部窗格中已分组的项为基础。 

注上部窗格内未显示的字段也可与上部窗格内已分组的项一起被包括在内。 

分布图表以饼图的形式显示 , 其中每个楔形表示一个组在整体中所占的份额。例如 , 您 

可能想要根据状态或者已编写了更改请求的组件 , 对所有更改请求进行分组。 

下面的分布图表指示了每种文件类型 (ASCII 和二进制 ) 在整体中所占的百分比。 

有关根据特定字段中项的值对项进行分组的信息 , 请参阅第 68 页的 “ 对数据排序和分 

组 ”。可根据多达四个字段的值进行分组。 

创建分布图表 : 


Audit ( 审核 ) 菜单中选择 Charts ( 图表 ) > Distribution ( 分布 )。出现 Distribution 

Chart ( 分布图表 ) 对话框。 



■ 


■ 

选择 Selecti All ( 全选 ) 以显示包含列表中所有项的图表。 


5 单击 OK ( 确定 ) 显示该分布图表。 


创建相关性图表 

创建相关性图表 

相关性图表以散点图的形式显示。选择代表 x 轴和 y 轴的字段。 StarTeam 在图表上绘 

制点来显示两个轴之间的相关性。 

例如 , 下面的散点图将附加到更改请求的附件数与该更改请求的标识号相关。它表明 : 

用户对编写请求越熟悉 , 他们就越有可能向每个请求添加一个或多个附件。 

创建相关性图表 : 

1 从 File ( 文件 )、 Change Request ( 更改请求 )、 Topic ( 主题 ) 或 Task ( 任务 ) 

菜单中选择 >Charts ( 图表 ) > Correlation ( 相关性 )。出现 Correlation Chart ( 相 

关性图表 ) 对话框。 


3 从 x 坐标列表框中选择一个轴标签。此坐标列表框显示在上部窗格中显示的、可用作 

轴的字段名称。上部窗格中最多可显示 60 个字段。 

4 从 y 坐标列表框中选择另一个轴标签。 


■ 


■ 



7 单击 OK ( 确定 ) 显示该相关性图表。 

第 20 章 : 使用图表 299

创建时间序列图表 

创建时间序列图表 

时间序列图表是一种线形图 , 显示在指定时间 / 日期字段中具有相同的日、周或月的项 

的数量。 

例如 , 下面的时间序列图表显示了在某个项目的每个月中创建的更改请求数。 

创建时间序列图表 : 


Audit ( 审核 ) 菜单中选择 Charts ( 图表 ) > Time Series ( 时间序列 )。出现 Time- 

Series Chart ( 时间序列图表 ) 对话框。 

注时间序列图表必须以时间 / 日期字段为基础。如果上部窗格未显示时间 / 日期字段 , 

则 StarTeam 将显示错误消息。 


3 ( 可选 ) 选中 Cumulative Totals ( 累计总数 ) 复选框以在图表中显示累计的项。 

4 ( 可选 ) 选中 Include Non-Represented Dates ( 包括未显示的日期 ) 复选框以在图 

表中包括所有日期范围。 

5 从 Tracking Interval ( 跟踪时间间隔 ) 框中选择 Daily ( 每天 )、 Weekly ( 每周 ) 或 

Monthly ( 每月 )。 

6 从 Time Series ( 时间序列 ) 列表框中选择一个或多个项。 


使用图表窗口 


7 ( 可选 ) 选中 Limit To Period Of Time ( 时间段限制 ) 复选框以在图表中包括特定时 

间范围。 


■ 


■ 



10 单击 OK ( 确定 ) 显示该时间序列图表。 

默认情况下 , 图表窗口显示工具栏和调色板栏。或者 , 显示图案栏。以下是绘图工具栏 

按钮列表 : 

Import Chart ( 导入图表 ) 

打开先前保存到磁盘的图表文件。 

Export Chart ( 导出图表 ) 

将图表文件保存到磁盘。 

Copy to Clipboard as Bitmap ( 以位图格式复制到剪贴板 ) 

以位图格式将图表复制到 Windows 剪贴板。 

Copy to Clipboard as Text ( 以文本格式复制到剪贴板 ) 

以文本格式将图表数据复制到 Windows 剪贴板。 

Print Chart ( 打印图表 ) 

打印图表。 

Change Gallery Type ( 更改图库类型 ) 

打开下拉列表框 , 可利用该列表框更改图表类型 ( 条形图、散点图、饼图等 )。按钮将 

发生变化以指示当前的选择。 

Change Color ( 更改颜色 ) 

打开下拉调色板 , 利用该调色板更改处于活动状态的颜色。然后 , 便可将该颜色拖动到 

接受颜色的任何图表元素。 

Switch between 3D and 2D ( 在 3D 和 2D 之间切换 ) 

在三维和二维图表之间切换。 

第 20 章 : 使用图表 301


Rotate Chart ( 旋转图表 ) 

打开一个对话框 , 利用该对话可更改三维图表的视角。 

Z-Clustered Series (Z 群集系列 ) 

为多系列图表添加深度。 

Zoom ( 缩放 ) 

放大图表的特定区域。 

Show or Hide Legend ( 显示或隐藏图例 ) 

打开和关闭图表图例的显示。 

Show or Hide Series Legend ( 显示或隐藏系列图例 ) 

打开和关闭系列图例的显示。 

Vertical Grid ( 垂直网格 ) 

打开和关闭垂直网格的显示。 

Horizontal Grid ( 水平网格 ) 

打开和关闭水平网格的显示。 

Edit Titles ( 编辑标题 ) 

编辑标题文本。 

Change Text Fonts ( 更改文本字体 ) 

为图表标签和图例选择字体。 

Tools ( 工具 ) 

打开下拉列表框 , 利用该列表框可打开和关闭显示元素 , 如工具栏、调色板栏和图案栏。 

Change Chart Options ( 更改图表选项 ) 

打开多选项卡对话框 , 可在其中设置图表类型和外观、比例、视图、标题文本。 


编辑图表 

编辑图表 

生成图表后 , 可更改图表外观、更改图表数据、以位图或文本格式复制图表、打印图表。 

更改图表类型 

Gallery 

Type 

StarTeam 生成适合于所选数据的图表类型。可用图表类型包括饼图、条形图、散点图、 

面积图、曲面图等。可更改图表类型以适合您的需要。 

更改图表类型 : 

1 从工具栏 , 单击 Change Gallery Type ( 更改图库类型 ) 下拉列表框。打开可能的类 

型的下拉式值集。 

2 选择一种图表类型。每一种图表类型都有一个工具提示 , 说明该图片所代表的图表 

类型。 

更改图表数据 

Tools 

生成图表后 , 可更改数据以执行 “ 假定 ” 计算或微调图表。 

更改图表数据 : 

1 从工具栏 , 单击 Tools ( 工具 ) 按钮。打开 Tools ( 工具 ) 下拉菜单。 

2 从菜单栏选择 Data Editor ( 数据编辑器 )。 Data Editor ( 数据编辑器 ) 窗口代替图 

表出现。它列出了用于创建图表的每一个值。 

3 根据需要编辑这些值。 

a 双击要更改的值。该值会突出显示 , 其对齐方式从右对齐改为左对齐。 

b 输入新值。 

c 执行以下一项操作 : 

■ 

按 tab 键在数据间移动并进行更改。 

■ 

双击另一个要更改的值。 

d 可根据需要多次重复步骤 c 直到完成编辑数据。 

4 从工具栏 , 单击 Tools ( 工具 ) 按钮。打开 Tools ( 工具 ) 下拉菜单。在 Data 

Editor ( 数据编辑器 ) 项旁边有一个复选标记。 

5 从菜单栏选择 Data Editor ( 数据编辑器 ), 以从菜单栏删除该复选标记 , 关闭 Data 

Editor ( 数据编辑器 ) 窗口 , 然后重新生成图表。 

更改图表颜色或图案 

可更改任何图表元素的颜色或图案 , 包括 : 

■ 

■ 

■ 

■ 

饼图的各个扇区 

条形图的条 

图表背景 

图例背景 

第 20 章 : 使用图表 303

编辑图表 

更改图表元素的颜色或图案 : 

■ 


■ 

从 Change Color ( 更改颜色 ) 工具栏按钮或颜色调色板将颜色拖至接受颜色的 

元素。 

■ 

从图案栏将图案拖至接受图案的元素。 

Change 

Color 

Change 

Chart 

Options 

Color 

Scheme 

在 Change Color ( 更改颜色 ) 工具栏按钮上更改颜色 : 

1 从工具栏 , 单击 Change Color ( 更改颜色 ) 下拉列表框。 

打开下拉调色板。 

2 从调色板中选择颜色。 

调色板关闭 , 按钮上的颜色更改以反映您的选择。 

要更改某条线上的点的颜色 , 请单击工具栏上的 Change Chart Options ( 更改图表选 

项 ), 选择 Series( 系列 ) 选项卡 , 选择正确的系列 , 然后从 Series Color( 系列颜色 ) 

框中选择一种颜色。 

显示调色板栏和 / 或图案栏 : 

1 从工具栏 , 单击 Tools ( 工具 ) 按钮。 

打开下拉菜单。此菜单上的项可以切换。选择不带复选标记的项可激活该选项并将一 

个复选标记加在该菜单项旁。再次选择该项可取消激活该选项并将复选标记从菜单栏 

项删除。 

2 选择 Palette Bar ( 调色板栏 ) 或 Pattern Bar ( 图案栏 ) 以显示元素。 

在调色板栏和 / 或图案栏显示时 , 可使用拖放技术将颜色或图案复制到任何接受颜色 

或图案的图表元素 ( 与图案相比 , 颜色更容易被图表元素所接受 )。 

从图表元素中删除图案 : 

1 从工具栏中 , 单击 Change Chart Options ( 更改图表选项 ) 按钮。 

出现 Chart Properties ( 图表属性 ) 对话框 , 该对话框中的 General ( 常规 ) 选项卡 

已被选定。 

2 从工具栏 , 单击 Color Scheme ( 配色方案 ) 下拉列表框。 

打开下拉式值集。配色方案选项有 : 

Solid color ( 纯色 ) 

Black and White pattern ( 黑白模式 ) 

Color pattern ( 彩色模式 ) 

3 选择 Solid Color ( 纯色 ) 以删除先前应用的任何模式 , 然后单击 Apply ( 应用 )。 

更改图表文本 

Tools 

StarTeam 自动为图表提供顶部标题和图例。也可提供左侧、右侧和底部标题文本 , 编辑 

标题或图例文本 , 以及在图表上为每个文本元素更改文本字体。 

更改图例文本 : 


打开 Tools ( 工具 ) 下拉菜单。 


编辑图表 

Edit 

Titles 

Change 

Text 

Fonts 

2 从菜单栏选择 Data Editor ( 数据编辑器 )。 

Data Editor ( 数据编辑器 ) 窗口代替图表出现。 Data Editor ( 数据编辑器 ) 列出了 

用于创建图表的每一个值。 

3 根据需要编辑图例文本。 

a 双击要更改的文本元素。文本将突出显示。 

b 输入新文本。 

c 可根据需要多次重复步骤 a 和 b, 直到完成编辑数据。 


打开 Tools( 工具 ) 下拉菜单。在 Data Editor( 数据编辑器 ) 项旁边有一个复选标记。 

5 从菜单栏选择 Data Editor ( 数据编辑器 ), 以从菜单栏删除该复选标记 , 关闭 Data 

Editor ( 数据编辑器 ) 窗口 , 然后重新生成图表。 

添加或更改标题文本 : 

1 从工具栏 , 单击 Edit Titles ( 编辑标题 ) 按钮。 

出现 Titles ( 标题 ) 对话框。 

2 为顶部、底部、左侧和 / 或右侧标题输入标题文本 ( 或编辑现有文本 )。 

3 在关闭此对话框前单击 Apply ( 应用 ) 查看所做的更改 , 或单击 OK ( 确定 )。 

为任何文本元素更改字体或颜色 : 

1 从工具栏 , 单击 Change Text Fonts ( 更改文本字体 ) 按钮。 

打开列出所有可用文本元素的下拉菜单。 

2 选择要更改字体的文本元素。 

出现标准的 Font ( 字体 ) 对话框。 

3 根据需要对字体、字形、磅值、强调和 / 或颜色进行更改。 

为 3D 图表更改查看选项 

Switch 

Views 

Rotate 

Chart 

可在二维 (2D)、三维 (3D) 或完全 3D 视图中查看图表。在完全 3D 视图中 , 可倾斜和旋 

转图表。 

在 2D 和 3D 之间切换 : 

■ 

从工具栏 , 单击 Switch Between 2D and 3D Views( 在 2D 和 3D 视图之间切换 ) 按钮。 

倾斜和旋转 3D 图表 : 

1 从工具栏 , 单击 Rotate Chart ( 旋转图表 ) 按钮。 

出现 3D View Properties (3D 视图属性 ) 对话框。 

2 必要时 , 选中 Full 3D View ( 完全 3D 视图 ) 复选框以激活完全三维查看选项。 

3 使用鼠标 , 围绕 x 轴平面拖动蓝色点和 / 或围绕 y 轴平面拖动红色点。 

第 20 章 : 使用图表 305

分离饼图 

要强调一个或多个值 , 可经常将饼图 “ 分离 ”。即 , 显示饼图的一个或多个与其它部分 

分开的扇区。 

分离饼图 : 

1 单击要与饼图其它部分分开的扇区。 

鼠标指针变成十字形。 

2 将该扇区拖离饼图中心。 


章 

设置个人选项 

第 21 章 

自定义 StarTeam 

使用 StarTeam, 您和您的团队成员可以设置适合您个人工作方式的个人选项。这些选项 

适用于给定工作站上当前登录的用户。您还可以更新可用于您的工作站的服务器列表 , 

并更新您在当前登录的服务器上的用户帐户。 

您可确定将要显示哪些确认消息、是否记住快捷方式和文件夹选择以及控制工具栏和状 

态栏等等。 

自定义 StarTeam: 



第 21 章 : 设置个人选项 307


1 选择 Workspace ( 工作区 ) 选项卡。 

2 使用 Confirm ( 确认 ) 复选框确认删除、移动、共享和警告。 

3 使用 Display ( 显示 ) 复选框显示或隐藏工具栏和状态栏。 

4 如果您更喜欢将 History ( 历史 ) 窗格 Time ( 时间 ) 列中的时间显示为 UTC 时间而 

不是您当地时区的时间 , 则选中 Show History Times As UTC ( 以 UTC 形式显示历 

史时间 ) 复选框。 UTC 时间以 “Z” 结尾 , 以区别于当地时间。 

Z 代表 “ 零子午线 ”, 该线穿过伦敦的格林威治。它也常用于无线电通信 , 其发音与 

“Zulu” 相同 ( 该词代表国际无线电通信字母表中的 Z)。 

5 如果选中 Restore Folder Selection On Tab Change ( 选项卡更改时还原文件夹选 

择 ) 复选框 , 则 StarTeam 会记住您上次使用某个特定选项卡时所选择的文件夹 , 并 

在您重新选择该选项卡时返回到该文件夹。如果您尚未在此会话中选择某个特定的选 

项卡 , 则在您切换该选项卡时 , StarTeam 会自动选择视图的根文件夹。 

否则 , 在选项卡间切换时所选的文件夹将保持不变。 

6 每次更改文件夹时 , 使用 Reset Scope to Local on Folder Change( 文件夹更改时将 

范围重置为本地 ) 复选框自动重置 All Descendants ( 所有后代 ) 。这样便可节省 

StarTeam 扫描项时所需的时间。清除此复选框以便仅由您来更改 All Descendants 

( 所有后代 )。(All Descendants ( 所有后代 ) 既是工具栏上的按钮 , 又是 File ( 文 

件 )、 Change Request ( 更改请求 )、 Task ( 任务 )、 Topic ( 主题 ) 和 Audit ( 审 

核 ) 菜单上的命令。) 

7 选中 Maintain Group State On Folder/Scope Change ( 文件夹 / 作用域更改时维持组 

状态 ) 复选框 , 这样一来即使更改文件夹或重置 All Descendants( 所有后代 ), 您也 

仍将处于上部窗格中。例如 , 在某个特定组已打开时 , 如果您选择一个不同的文件夹 , 

则该组仍将保持打开状态。清除此复选框可在更改文件夹或作用域时折叠所有组。 

8 使用 Automatic Refresh with a Maximum Delay of __ Minutes ( 以 __ 分钟的最大延 

迟自动刷新 ) 文本框可设置 StarTeam 项目的两次刷新之间相隔的最大分钟数。 

此刷新的作用与按 Shift+F5 相同。它更新 StarTeam 文件夹层次和上部窗格。 

9 如果已打开项目视图窗口 , 则可选中 Restore Workspace at Startup ( 启动时还原工 

作区 ) 复选框 , 以重新打开上次退出 StarTeam 时仍处于打开状态的任何视图或视图 

比较窗口。 

10 在 Report Output Path ( 报告输出路径 ) 文本框中 , 输入或浏览报告文件的名称和路 

径。此路径将成为使用 StarTeam 创建的所有报告的默认位置。 

11 使用 Look and feel ( 外观 ) 下拉列表框为 Cross-Platform 客户机选择一个不同的外 

观。这可更新用户界面的外观。 

12 Font adjustment ( 字体调整 ) 下拉列表框提供了用于增大或缩小 Cross-Platform 客 

户机用户界面中显示的文本大小的选项。 

13 使用 StarTeam 日志 : 

a 

在 Log Output Path( 日志输出路径 ) 文本框中 , 输入或浏览 StarTeam.Log 文件的 

名称和路径。其默认设置是安装 StarTeam 的文件夹 , 如 C:\Program Files\Borland\ 

StarTeam。当前日志文件始终被命名为 StarTeam.Log。工作站上 StarTeam 的较 

早会话中的日志文件 , 其名称包括上次修改文件的日期和时间。 

StarTeam-12-Mar-01-09-45-04.Log 

StarTeam.Log 文件包含从您的工作站向一个或多个服务器发送的、有关操作的数 

据 , 这将视已打开的项目视图而定。这些数据包括项目名 , 这样您便可在必要时将 

某个特定服务器的数据分离。要查看 StarTeam.Log, 请选择 Tools( 工具 )> View 

StarTeam Log ( 查看 StarTeam 日志 )。有关其它信息 , 请咨询您的管理员或参 

阅 StarTeam 管理员指南。 

b 选中 Log Errors ( 记录错误 ) 复选框可记录使用 StarTeam 时出现的错误。 

例如 , 您会看到 : 

...Operation 40956 failed: TCP/IP Socket Error 10054:... 



c 

如果记录的是错误和操作 , 则 StarTeam 还将记录出错时服务器正在执行的操作。 

选中 Log Operations That Take At Least __ Milliseconds( 记录至少执行 __ 毫秒 

的操作 ) 复选框可记录操作和 / 或事件。 

1 ( 可选 ) 选择一个毫秒数。 

毫秒时间设置可防止在日志中加入不重要的操作和事件。默认值 10 毫秒是一个 

合理的设置。 


■ 

选择 Summary ( 摘要 ) 选项按钮可包含每项操作在 StarTeam 客户机和 

StarTeam Server 上所花费时间的详细分类。下图显示了几个操作的摘要。 

■ 

选择 Details ( 详细信息 ) 选项按钮可将命令与摘要一起列出。下图显示了一个 

示例。只有使用 Details ( 详细信息 ) 选项按钮才能用地址或名称标识服务器。 

d 选中 Log StarTeamMPX Server Events( 记录 StarTeamMPX Server 事件 ) 复选框。 

例如 , 您会看到 : 

...Statistics for Events /STEvent/01b21d208-51ea... 




■ 

单击 OK ( 确定 ) 以保存选项并关闭 Personal Options ( 个人选项 ) 对话框。 

■ 

选择 Personal Options ( 个人选项 ) 对话框的另一个选项卡。 


可设置具有以下功能的各种文件选项 : 锁定文件 , 签出文件 , 控制状态信息的存储位置 , 

使用所选的应用程序来编辑、比较和合并文件等。 

设置文件选项 : 




3 选择以下任何一个用于文件的签出选项 : 

a 

b 

选中 Use Last Modification Time For Checked-Out Files( 为签出的文件使用最后 

修订时间 ), 以使签出的修订的时间戳成为每个签出文件的时间戳。否则 , 签出文 

件的时间戳将为当前时间 — 签出操作的时间。 

如果更改此复选框的设置 , 则工作文件夹中已有的文件状态将会影响随后对这些文 

件执行的签出操作的结果。例如 , 如果在此复选框有一项设置时签出一个文件 , 然 

后更改此复选框的设置 , 则只有强制签出才能更改该文件的时间戳。这是因为该文 

件被视为 Current( 当前 ) 文件 , 因此除非执行强制签出 , 否则根本无法将其签出。 

StarTeam 并非仅依赖于计算机的时钟和工作文件的日期 / 时间戳来确定需要签入 

或签出的内容。即使计算机的时钟与其他团队成员的时钟不同步 , 它也仍然会正常 

工作。但是 , 多数编译器和开发环境对于日期和时间戳仍然十分敏感。默认情况 

下 , 由团队的其他成员签入的文件将具有由该队友的时钟所设置的日期和时间戳 , 

即使在签出该文件时也会如此。如果您的时钟与队友的时钟不同步 , 则在编译或生 

成文件时便可能遇到问题。因此 , 我们仍然建议使用您的网络服务器所支持的同步 

所有工作站时钟的任何服务。 

Windows 网络用户可执行以下操作来同步其工作站和服务器的时间 : 

Net time \\server_Name/set/yes 

选中 Optimize for Slow Connections ( 慢速连接优化 ) 复选框 , 可使 StarTeam 

Server 发送当前签出的修订 ( 在工作文件夹中 ) 与所要签出的修订之间的差异以 

提高数据传输速度。 



如果清除此复选框 , 则服务器将始终发送所请求的完整的修订。 

4 选择以下任何一个用于文件的锁定选项 : 

a 

b 

c 

d 

选择 Exclusively Lock Files On Check-out ( 签出时独占锁定文件 ) 对话框 , 以使 

Check Out( 签出 ) 对话框的锁定状态选项默认为 Exclusive( 独占 )。( 否则 , 默 

认值为 Keep Current ( 保持现状 )。) 

选择 Clear File Locks On Check-in ( 签入时清除文件锁定 ) 以使 Check In ( 签 

入 ) 对话框的锁定状态默认为 Unlock ( 解除锁定 ) 。( 否则 , 默认值为 Keep 

Current ( 保持现状 )。) 

选中 Use Non-exclusive Locks In Integrations ( 在集成中使用非独占锁定 ) 复选 

框 , 以在从 StarTeam 集成中访问时影响文件的锁定方式。选中此复选框时 , 锁定 

文件 ( 例如 , 在执行 Get ( 获取 ) 或 Check Out ( 签出 ) 操作的过程中 ) 会创建 

一个非独占锁 , 而不是独占锁。 

就独占锁而言 , 只有锁定文件的人员才能签入该文件。而对于非独占锁 , 其他人员 

可签入文件。独占锁是最为安全的 , 但通常都优先选用非独占锁 , 其原因是可以使 

用 Visual Merge 轻松地合并文本文件。使用非独占锁可允许多个人同时编辑一个 

文件。如果团队成员所编辑的不是文件中相同的行 , 则合并后的文件通常不会存在 

冲突。 

如果将 StarTeam 集成用于您的开发环境 ( 例如 Visual Studio .NET), 则在选中 

Project Properties ( 项目属性 ) 对话框 (Options ( 选项 ) 选项卡 ) 中的 Require 

Exclusive Lock When Files Are Checked In ( 签入文件时需要独占锁定 ) 复选框 

和 Personal Options( 个人选项 ) 对话框 (Files( 文件 ) 选项卡 ) 中的 Use Nonexclusive 

Locks In Integrations ( 在集成中使用非独占锁定 ) 复选框时将无法从开 

发环境签入文件。通常由 StarTeam 管理员确定 Require Exclusive Lock When 

Files Are Checked In ( 签入文件时需要独占锁定 ) 复选框的设置。但是 , 个人选 

项则可由您为您所在的工作站进行设置。 

如果设置了 Use Non-exclusive Locks In Integrations( 在集成中使用非独占锁定 ) 

复选框并遇到签入问题 , 则可尝试清除此复选框。您可能想要与您的管理员探讨有 

关 Require Exclusive Lock When Files Are Checked In ( 签入文件时需要独占锁 

定 ) 复选框的设置。 

选中 Mark Unlocked Working Files Read-Only ( 将解除锁定的工作文件标记为只 

读 ) 复选框 , 以在执行以下文件操作时 , 将从 “ 已锁定 ” 状态更改为 “ 解除锁定 ” 

状态的文件的工作副本变为只读 : 

■ 

文件签入 

■ 

文件签出 ( 从文件或历史列表 ) 

注意 

■ 

文件解除锁定 

这样 , 只有锁定的文件才可以编辑。 

此选项与项目属性完全相同。选择此选项后 , 项目属性将覆盖个人选项。它适用于 

从 StarTeam 或从 StarTeam 与第三方应用程序的集成解除锁定的文件。 

如果在选择此个人选项 ( 或项目属性 ) 后又改变了主意 , 请确保在将设置从选中 

变回清除前没有文件处于只读状态。在更改为清除之前 , 可将所有文件 ( 或所 

有只读文件 — 如果知道哪些文件是只读文件 ) 作为锁定文件强制签出。然后 , 

将它们解除锁定。清除此选项后 , 必须使用操作系统将只读属性更改为读 / 写。 

5 选择以下任何一个用于文件的合并选项 : 

a 

b 

Always Pop Up Merge Utility ( 始终弹出合并实用程序 ), 查看合并后的文件 ( 即 

使未找到任何冲突 )。 

Pop Up Merge Utility In Case Of Conflicts Only ( 仅在存在冲突时弹出合并实用 

程序 ), 仅当合并后的文件包含冲突时才查看该文件。否则 , 文件将被自动签入和 

签出。 



6 选择以下任何一个用于文件的常规选项 ( 仅可用于 StarTeam Windows 客户机 ): 

a 

b 

选中 Use File Checksums (MD5) To Calculate Status( 使用文件校验和 (MD5) 计 

算状态 ) 复选框 , 以在刷新 StarTeam 时使用文件的校验和 ( 而不是时间戳 ( 和 

大小 )) 来计算 Status( 状态 ) 字段。校验和可提供更为准确的状态值 , 只是需要 

的时间更长一些。例如 , 就基于时间戳的状态而言 , 如果仅更改其时间戳 , 则文件 

的状态将可能变为 Modified ( 已修改 )。( 可能已在编辑器中打开了一个文件 , 并 

在未做任何更改的情况下将其保存。) 在 Current( 当前 ) 状态中使用校验和结果 , 

因为本地文件的校验和将与文件的最新修订相匹配。 

有时 , 即使两个文件并不相同 , 它们也可具有相同的时间戳和大小。此外 , 为了在 

此情况下获得正确的状态信息 , 请使用 MD5 校验和。 

选中 Automatically Detect Changes To Working Files ( 自动检测工作文件的更 

改 ) 复选框以监控本地文件的更改。将该复选框选中后 , StarTeam 可早些意识到 

本地文件的更改。在手动或自动刷新出现之前 ,StarTeam 不显示这些更改。但是 , 

刷新的速度更快 , 因为 StarTeam 已具有完成刷新所需的本地文件状态信息。 

清除此复选框可阻止 StarTeam 监控本地文件的更改。 

7 选择以下任何一个用于文件的 EOL 选项 ( 仅可用于 Cross-Platform 客户机 ): 

EOL 选项是按 StarTeam Windows 客户机中的文件夹为该文件夹的所有用户设置 

的。该客户机假设您正在使用的文件夹被映射到一个与您工作站平台不同的平台。有 

关详细信息 , 请参阅第 63 页的 “ 为其它操作系统文件创建 StarTeam 文件夹 ”。 

Cross-Platform 客户机假设您始终或长期从一个特定平台进行工作。它还假设您想要 

确保您工作站上的任何文件都具有在该平台上工作所需要的 EOL 字符。在添加文件 

或者签入或签出文件时 , 文件内的 EOL 字符可转换为所选的 EOL 字符。利用 EOL 

字符的个人选项可选择这些操作的默认设置。 

在添加文件或签入文件时 , EOL 字符始终被转换为 CR/LF。比较文件时 , EOL 字符 

将被忽略。更新状态时 , EOL 字符也始终会被转换为 CR/LF。 

设置用于添加和签入文件的 EOL 字符 : 

■ 

选中或清除 “Automatic EOL conversion (CR-LF) for add/check-in operations( 执 

行添加 / 签入操作时自动转换 EOL (CR-LF))” 复选框。 

设置用于签出文件的 EOL 字符 : 

a 

选中或清除 “Automatic EOL conversion for check-out operations ( 执行签出操 

作时自动转换 EOL)” 复选框。 

b 为 EOL 字符选择适当的选项按钮。 

注根据应用程序的不同 ,Mac System X 文件可能会将 LF 或 CR 用作 EOL 字符。 

8 选择用于关键字扩展的默认文件编码。此处选择的是用于文件签出的默认文件编码。 

9 选择文件的文件状态储存库选项 : 

文件状态信息存储在您的工作站中。默认情况下 , 该信息存储在中心位置。其默认位 

置是名为 syncdb 的文件夹 , 但其路径将视工作站的平台的不同而有所变化。 

■ 

对于 Windows NT, syncdb 是一个子文件夹 , 其路径为 : 

C:\Winnt\Profiles\username\Local Settings\Application Data\Borland\StarTeam 

■ 

对于 Windows 2000 或 XP, syncdb 是一个子文件夹 , 其路径为 : 

C:\Documents and Settings\username\Local Settings\Application Data\Borland\ 

StarTeam\ 



■ 

对于非 Windows 平台 , syncdb 是一个子文件夹 , 其路径为 : 

/user_home_directory/.starteam-client/ 

每个 syncdb 文件夹都包含代表您工作文件的文件夹 ( 尽管其名称看起来似乎不相 

关 ), 并包含一个 .sdb 文件和一个 .lck 文件。 

可更改中心位置 , 如果愿意的话 , 可指定按文件夹存储。然后 , 每个工作文件夹都将 

文件状态信息存储在名为 .sbas 的子文件夹中。每个 .sbas 文件夹都包含一个 Sync 

文件和一个 SyncLock 文件。 

a 控制状态信息的存储位置 : 

1 通过选择 Central or Per Folder ( 中心或按文件夹 ) 选项按钮指定存储类型。 

2 ( 可选 ) 如果选择了 Central ( 中心 ), 则可输入或浏览默认值以外的位置。新 

位置将进入 Central Repository Location( 中央储存库位置 ) 文本框。在此情况 

下 , 储存库这个术语指的不是数据库 , 而是存储文件状态的位置。 

b 删除旧的和不相关的状态信息 : 

1 单击 Purge ( 清除 ) 以清除文件状态储存库。出现 Status Repository Cleanup 

( 状态储存库清除 ) 对话框。 

2 单击 Start ( 开始 ) 可看到文件夹的路径列表已不再存在。 

3 单击 Purge ( 清除 ) 以删除所选文件夹的状态信息 , 或单击 Purge All ( 全部清 

除 ) 删除所有多余的状态信息。 

可通过设置视图属性 , 为特定的视图使用不同的存储方法。有关详细信息 , 请参阅 

第 27 页的 “ 控制文件状态信息 ”。 

10 在 Windows 以外的操作系统中 , 可设置打开方式选项以在指定的应用程序中显示 

文件。 

如果 StarTeam 客户机是安装在 Windows 系统中 , 则在上部窗格中双击一个文件即 

可将该文件显示在关联的应用程序中。由于没有在非 Windows 平台上显示文件的标 

准方法 , 所以 StarTeam Cross-Platform 客户机提供了一个个人选项来解决这一问 

题。( 如果客户机是在 Windows 系统中运行 , 则您决不会看到此选项。) 

利用 Open With( 打开方式 ) 文本框 , 您可提供一个至少可以显示一种文件类型的命 

令。该命令由应用程序路径和命令行选项组成 , StarTeam 可用所选文件将命令行选 

项替换。 

在执行以下一项操作时 , StarTeam 可随时运行此命令 : 

■ 

■ 

双击项列表中的一个文件 

双击一个附件 

■ 

生成并打开一个报告 

建议使用以下命令 : 

netscape -remote "openFile($file)" 

因为 Netscape 可处理多种不同的介质类型 , 如图像文件、文本文件和 html。 

与特定的文件类型关联 : 

a 单击 Browse ( 浏览 ) 以查找该命令。 

b 添加适当的选项。 

StarTeam 将用所选文件替换命令中的 $file。 



11 为文本编辑器、比较实用程序和 / 或合并实用程序设置备选应用程序选项 : 

a 

单击 Alternate Applications( 备选应用程序 )。出现 Alternate Applications( 备选 

应用程序 ) 对话框。 

b 选中 Editor ( 编辑器 ) 复选框以使用记事本以外的编辑器。 

c 

d 

1 在文本框中输入该编辑器的路径或浏览该编辑器。 

2 ( 可选 ) 在 Options ( 选项 ) 文本框中 , 添加要与该实用程序一起使用的命令行 

选项。例如 , 如果使用的是 CodeWright 编辑器 , 则可使用 -nosplash 来隐藏初 

始屏幕。 

选中 Merge Utility ( 合并实用程序 ) 复选框以使用 Visual Merge 以外的合并实用 

程序。 

1 在文本框中输入该合并实用程序的路径或浏览该程序。 

2 在 Options( 选项 ) 文本框中 , 添加要与该实用程序一起执行的命令行选项。请 

使用下列术语 : 

$branchtip: 要合并文件的最新修订的路径占位符。 

$usertip: 要合并的本地工作文件的路径占位符。 

$basefile:$branchtip 和 $usertip 文件的共用祖先的路径占位符。 

$resultfile: 用于存储合并文件输出的文件的路径占位符。 

例如 , 假设 Merge Utility ( 合并实用程序 ) 文本框的内容为 “D:\Programs\Merge 

Utility 5\Mergeutil.exe”,Options( 选项 ) 文本框的内容为 “-s $branchtip $usertip 

$basefile $resultfile”。StarTeam 假设您的选项适用于所要使用的实用程序。每当 

StarTeam 需要调用该合并实用程序时 , 都会以相应文件的实际路径替换以 $ 开头 

的项 , 并请求操作系统执行替换后的命令。 

选中 Comparison Utility ( 比较实用程序 ) 复选框以使用 Visual Diff 以外的比较实 

用程序。 

1 在文本框中输入该比较实用程序的路径或浏览该程序。 

2 在 Options( 选项 ) 文本框中 , 添加要与该实用程序一起执行的命令行选项。请 

使用下列术语 : 

$file1: 两个要比较的文件中第一个文件的路径占位符。 

$file2: 两个要比较的文件中第二个文件的路径占位符。 

例如 , 假设 Comparison Utility ( 比较实用程序 ) 文本框的内容为 “D:\Programs\ 

Comparison Utility 8\Diffutil.exe”, Options ( 选项 ) 文本框的内容为 

“$file1 $file2” 。StarTeam 假设您的选项适用于所要使用的实用程序。每当 

StarTeam 需要调用该比较实用程序时 , 都会以相应文件的实际路径替换以 $ 开头 

的项 , 并请求操作系统执行替换后的命令。 

12 单击 OK ( 确定 ) 以保存选项并关闭 Personal Options ( 个人选项 ) 对话框。 




未读项可在上部窗格中以粗体列出 , 条件是 : 

■ 

您是负责更改请求、需求或任务的用户。 

■ 

您是主题的收件人。 

此功能不适用于文件和审核条目。 

显示其属性后 , 粗体便会消失。 

可对粗体消失的附加条件进行控制。在下列条件下 , 一个项可从已读变为未读 : 

■ 

■ 

如果该项已被选定一段时间 

通过选择另一个项的方式从该项移开 

■ 

仅当手动选择菜单命令 , 将该项标记为已读或未读时 

管理已读 / 未读项 : 

1 从菜单栏选择 Tools( 工具 )> Personal Options( 个人选项 )。出现 Personal Options 

( 个人选项 ) 对话框。 

2 选择 Change Request( 更改请求 )、Requirement( 需求 )、Topic( 主题 ) 或 Task 

( 任务 ) 选项卡。 

3 选择以下任何一个 Mark as Read ( 标记为已读 ) 选项 : 

■ 

■ 

选择 When Change Request (or Task or Topic) Is Selected ( 选择更改请求 ( 或 

任务或主题 ) 时 ) 选项按钮 , 以指示一个项在被选择时即为已读。 

选择 When Selected For __ Seconds Or More ( 被选择 __ 秒或更长时 ) 选项按 

钮 , 以指示一个项在指定的时间间隔后已处于已读状态。其范围为 15 至 9999 秒。 

■ 

选择 Only When Manually Marked As Read( 仅当手动标记为已读时 ) 选项按钮 , 

以便仅通过使用菜单选项而不是通过选择将该项标记为已读。 

显示项的属性时 , 项始终被标记为已读。 





在运行 StarTeam 时 , 可检查可能对您产生响应的更改项。此功能不适用于文件和审核 

条目。在以下情况下 , StarTeam 会通知您 : 

■ 

当更改请求、需求或任务变成您的责任 , 或者某个主题将您指定为收件人时。 

如果某个主题未列出收件人 , 则将无人接收通知。 

■ 

当您负责需求或任务 , 或者您作为收件人的某个主题已发生更改时。 

注 

在 StarTeam Windows 客户机中 , 缺陷、需求、任务或主题图标显示在 

工作站的任务栏中 ( 该任务栏位于系统托盘中 )。 

在 StarTeam Cross-Platform 客户机中 , 这些图标显示在状态栏的右端 , 而不是系统托 

盘中。 

双击该图标可打开 : New (< 项目 >: 新建 < 项类型 >) 对话框 , 

该对话框中列出需要注意的项。双击该项可显示其属性。打开该项的属性 ( 如果顺利的 

话 , 还可读取该项的属性 ) 之后 , 该项将从对话框中消失。您可在显示该项的属性时做 

一些记录。 

如果您的管理员已启用了电子邮件通知 , 则您会自动收到一些电子邮件消息 , 告 

知您有关您所负责的更改请求、您所负责的任何需求和任务中的更改以及您作为 

收件人的任何主题中的更改的信息。电子邮件通知是独立于客户机的 , 所以无需 

运行 StarTeam 来接收通知。但是 , 可以使用带有或不带有电子邮件通知的系统托 

盘通知。 

控制系统托盘通知 : 


出现 Personal Options ( 个人选项 ) 对话框。 


( 任务 ) 选项卡。 

此选项卡的内容在 StarTeam Windows 客户机和 Cross-Platform 客户机中看起来略 

有不同。 


自动锁定非文件项 

自动锁定非文件项 

3 在 StarTeam Windows 客户机中 : 

a 

要获得有关您所负责 ( 或作为收件人 ) 的未读项的通知 , 请选中 Check for New Or 

Modified Every __ Minutes( 每 __ 分钟检查一次新的或已修改的 < 项 >) 

复选框。 

b 输入检查需要注意的项的时间间隔。默认值为 10 分钟。 

c 转到步骤 5。 

4 在 StarTeam Cross-Platform 客户机中 : 

a 

b 

要获得有关您所负责 ( 或作为收件人 ) 的未读项的通知 , 请选中 Check for New 

Or Modified ( 检查新的或已修改的 < 项 >) 复选框。 

在 Interval ( 时间间隔 ) 文本框中 , 输入检查需要注意的项的时间间隔。默认值为 

10, 时间间隔以分钟为单位。 

c 转到步骤 5。 


有两个个人选项用于控制非文件项的锁定。使用它们可执行以下操作 : 

■ 

在打开一个项的 Properties(< 项 > 属性 ) 对话框时 , 将该项锁定。(StarTeam 

假设您要编辑它。) 

■ 

在单击 OK ( 确定 ) 以退出一个项的 Properties (< 项 > 属性 ) 对话框时 , 将 

该项解除锁定。此选项将在创建该项的一个新修订时将其解除锁定。 

如果这两个选项都不选择 , 则打开一个项时便不会将其锁定。可对项的所有锁定和解除 

锁定进行手动控制。 

如果仅选择这两个选项中的第一个选项 , 则在打开尚未锁定的项时会将其锁定 , 在单击 

Cancel ( 取消 ) 或 OK ( 确定 ) 时会将其解除锁定。 

如果仅选择第二个选项 , 则在单击 OK ( 确定 ) 创建新修订时 , 尚未被手动锁定的任何 

项便会被解除锁定。 

如果这两个选项都选择 , 则可手动锁定项 , 也可通过打开的方法将其锁定。在单击 OK 

( 确定 ) 创建新修订时 , 这些项将会被解除锁定。如果这些项在打开前并未锁定 , 则在 

单击 Cancel ( 取消 ) 后它们也会被解除锁定。 

自动锁定和解除锁定项 : 


出现 Personal Options ( 个人选项 ) 对话框。 


使用 StarTeamMPX Server 


( 任务 ) 选项卡。( 这不适用于文件 , 因为其锁定选项略有不同。请参阅第 311 页的 

“ 选择以下任何一个用于文件的锁定选项 :”。) 

有关 StarTeam Windows 和 Cross-Platform 客户机中的此对话框 , 请参阅上图。 

3 要在打开项的属性对话框时将未锁定的项锁定 , 请选中 Exclusively Lock On 

Edit ( 编辑时独占锁定 < 项 >) 复选框。 

4 要在创建项的新修订时将锁定项解除锁定 , 请选中 Clear Locks After Edit( 编 

辑后清除 < 项 > 锁定 ) 复选框。 


使用 StarTeamMPX Server 

要利用由使用 StarTeamMPX Server 的 StarTeam Server 所提供的缓存服务和增强功 

能 , 必须在您的工作站上启用 StarTeamMPX Server。要查看您工作站上 StarTeamMPX 

Server 的当前状态 , 请查看 StarTeam 状态栏的右端。例如 , 您会看到 : 

下表显示了在状态栏中出现的、可提供有关 StarTeamMPX Server 的信息的图标和词语。 

表 21.1 有关 StarTeamMPX Server 的状态栏信息 

状态栏信息 

说明 

指示 StarTeamMPX Server 可用 , 且可用于当前所选的项目视图。 

指示 StarTeamMPX Server 可用于当前所选的项目视图 , 只是尚 

未将其启用。 

指示已为当前所选的项目视图启用了 StarTeamMPX Server, 只 

是因发生了某种情况而使连接断开。可能是网络工作不正常。 

No icon ( 无图标 ) 指示 StarTeamMPX Server 不可用于当前所选的项目视图。 

Instant ( 即时 ) 指示 StarTeamMPX Server 的自动刷新已打开。 

Auto ( 自动 ) 

指示工作站的自动刷新已打开 , 但 StarTeamMPX Server 的自动 

刷新已关闭或不可用。工作站的自动刷新位于 Personal Options 

( 个人选项 ) 对话框的 Workspace ( 工作区 ) 选项卡上。 

Manual ( 手动 ) 

指示工作站的自动刷新已关闭 , 以及 StarTeamMPX Server 的自 

动刷新已关闭或不可用。 

默认情况下 , 工作站会启用 StarTeamMPX Server。 


更改个人信息 

在工作站上使用 StarTeamMPX Server: 

1 从菜单栏选择 Tools( 工具 )> Personal Options( 个人选项 )。出现 Personal Options 

( 个人选项 ) 对话框。 


2 选择 StarTeamMPX Server 选项卡。 

3 选中 Enable StarTeamMPX Server ( 启用 StarTeamMPX Server) 复选框以使用 

StarTeamMPX Server。 


■ 

要手动刷新 (Shift+F5), 请清除 Automatic Refresh With( 自动刷新 , 使用 ) 复选框。 

■ 

自动刷新 : 

每次更改后 , StarTeam 均会等待至少几秒钟的时间 , 然后才能进行刷新。这意味 

着 : 如果更改不是经常性的 , 则 StarTeam 几乎立即执行刷新。但是 , 如果更改是经 

常性的 , 则此最小刷新计时器将会不断地被复位 , 且永远无法达到为刷新所设置的 

秒数。在此种情况下 , 当最大刷新间隔秒数强制进行刷新时 , 便会发生下一次刷新。 

1 选中 Automatic Refresh With ( 自动刷新 , 使用 ) 复选框。 

2 在 Minimum Delay Of ___ Seconds ( 最少延迟 ___ 秒 ) 文本框中设置刷新之 

间相隔的最小秒敉。默认值为 30 秒。 

3 在 Maximum Delay Of ___ Seconds ( 最多延迟 ___ 秒 ) 文本框中设置刷新之 

间相隔的最大秒敉。默认值为 60 秒。 

5 单击 OK ( 确定 )。 

停止使用 StarTeamMPX Server: 

■ 

清除 Enable StarTeamMPX Server ( 启用 StarTeamMPX Server) 复选框以停止使 

用 StarTeamMPX Server。 

有时 , 您会需要更新有关您在服务器中的帐户的信息。例如 , 您有时会想要更改您的 

密码。 

查看帐户信息 : 

1 从菜单栏中选择 Tools( 工具 )> Server Administration( 服务器管理 )。出现 Server 

Administration ( 服务器管理 ) 对话框。 



2 单击 My Account ( 我的帐户 )。出现 My User Account ( 我的用户帐户 ) 对话框。 

3 输入或编辑任何适当的信息。 

更改密码 : 

1 从菜单栏中选择 Tools ( 工具 ) > Server Administration ( 服务器管理 )。 

出现 Server Administration ( 服务器管理 ) 对话框。 

2 单击 My Account ( 我的帐户 )。出现 My User Account ( 我的用户帐户 ) 对话框。 

3 单击 Logon ( 登录 ) 选项卡。 


■ 

如果您的管理员允许使用空密码而且您要使用此种密码 , 则请选中 Set A Blank 

Password ( 设置空密码 ) 复选框。 

■ 

在 Password ( 密码 ) 和 Confirm ( 确认 ) 文本框中 , 请输入新密码并进行确认。 


章 

使用 stcmd 命令行界面 

第 22 章 

StarTeam stcmd 命令行界面有 COM (Windows) 和 Java 两个版本。这两个版本包含相 

同的命令 , 并都作为 StarTeam SDK Runtime 的一部分而安装。在 Windows 工作站上 , 

命令行的 COM 版本随 StarTeam Windows 客户机或 StarTeam Cross-Platform 客户机 

一起安装。对于 UNIX 和其它非 Windows 工作站 , 命令行的 Java 版本随 StarTeam 

Cross-Platform 客户机一起安装。 

可从以下环境执行命令行操作 : 

■ 

使用命令 stcmd 和相应选项的命令行会话。 

■ 

可使您为菜单添加工具的开发环境。 

StarTeam Server 必须是可以访问的而且正在运行要访问的项目的服务器配置。 

命令行操作包括 : 

■ 

添加文件 (stcmd add) 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

添加文件夹 (stcmd add-folder) 

添加项目 (stcmd add-project) 

添加视图 (stcmd add-view) 

为选定文件应用标签 (stcmd apply-label) 

签入文件 (stcmd ci) 

签出文件 (stcmd co) 

从工作文件夹删除文件 (stcmd delete-local) 

显示文件的两个版本之间的差异 (stcmd diff) 

更改说明 (stcmd dsc) 

显示文件的修订历史 (stcmd hist) 

为视图创建新标签 (stcmd label) 

锁定或解除锁定文件 (stcmd lck) 

列出文件 (stcmd list) 

创建工作文件夹 (stcmd local-mkdir) 

将文件状态信息从服务器移动至客户机 , 作为升级到 StarTeam Server 5.2 或更新版 

本的一部分 (stcmd move-status) 

第 22 章 : 使用 stcmd 命令行界面 321

语法 

■ 

■ 

■ 

从版本控制删除文件 (stcmd remove) 

锁定和解除锁定服务器 (stcmd server-mode) 

指定要使用的客户端状态类型 (stcmd set-personal-options) 

■ 

升级文件状态 (stcmd update-status) 

使用 -? 显示该命令可用的选项。 

例如 , stcmd -? 显示 stcmd 的常规语法 , 而 stcmd add -? 显示添加文件时可用的选 

项。( 不带 -? 使用 stcmd 和 stcmd add 也可以。) 

语法 

命令行语法使用以下约定 : 

表 22.1 

约定 

命令行语法 

说明 

粗体必须完全按所示内容使用的信息。 

斜体用具体文件名、子文件夹等替换的信息。 

[ ] 方括号标识可选的语法。 

| 竖线分隔互斥的选择项。只能选择其中的一个选项。 

常见选项 

某些选项出现在本章介绍的所有或几乎所有的命令中。在每个命令中 , 它们具有完全相 

同的含义 , 因而本节所述内容以后不再重复。未在所有命令中出现的选项或含义因命令 

而异的选项与命令一起解释。 

所有命令行语法均解释为 UNIX 而非 Windows 语法。 

所有选项都可用连字符 (-) 或斜杆 (/) 书写。示例 :- p 或 /p。本章指示某个选项需要引号 

时 , 则应使用引号 , 尽管您的操作系统也可接受不带引号的选项。这样既可保持一致也 

很安全。 

例如 , 当选项中含有空格时 ,Windows 操作系统要求使用引号。例如 , 如果某个修订注释 

是几个字 , 则必须用引号将它括起来。一个字的注释不需要引号 — 尽管使用引号也可以。 


常见选项 

应注意 , 如果工作文件夹和文件的名称中含有空格 , 则通过命令行的 Java 版本发送的注 

释可能会失败。根据使用的 Shell 和其它因素 , 含有空格的 UNIX 名称经常需要括在双 

引号中。 

-? 列出命令的语法和每个选项的说明。-? 与各个命令一起使用 , 虽然它不显示在 

语法中。- h 和 -help 是 -? 的同义词。此信息被发送至 stderr 而不是 stdout。要 

从 Windows 2000 命令提示符捕获此信息 , 需要使用 "2>" 而不是 ">"。 

-active 指示活动的过程项。 

-cmp 压缩在工作站和服务器之间传送的所有数据 , 然后在数据到达后将其解压缩。 

如果没有此选项 , 则不进行压缩。 

当客户机与服务器通过慢速连接进行通信时 , 最适合使用压缩。要确定是否要 

使用压缩 , 一个小型的测试实例可能会有用。您必须考虑在压缩和解压缩数据 

上花费的时间是否比通过慢速连接发送未压缩数据花费的时间更短。 

-csf 

当此命令将在 -p 选项中指定的文件夹映射到底层的 starTeam 文件夹时 , 使用 

csf 可使此命令根据这些文件夹名称的区分大小写的拼写来区分它们。例如 , 使 

用此选项 , 名为 doc 和 Doc 的 StarTeam 文件夹被识别为不同文件夹。没有此 

选项 , 这两个文件夹可能都被识别为 “doc” 文件夹。 

默认情况是 StarTeam 文件夹名称不区分大小写。 

此选项与文件名区分大小写无关。 

-encrypt 加密所有在工作站和服务器之间传送的数据 , 然后在数据到达后将其解密。若 

无此选项 , 则不进行加密。加密可防止未授权方通过不安全的网络线路读取文 

件和其它项目信息。 

完整语法如下 : 

-encrypt encryptionType 

加密类型包括 : 

RC4 

RSA R4 流密码 ( 快速 ) 

RC2_ECB 

RSA R2 块密码 ( 电子密码本 ) 

RC2_CBC 

RSA R2 块密码 ( 密码块链 ) 

RC2_CFB 

( 仅限 Windows 平台 ) 

RSA R2 块密码 ( 密码反馈 ) 

这些加密类型按由快到慢的顺序排列。每种加密类型都比其前面的类型慢 , 但 

更安全。 

eol 

执行文本文件的行尾转换。 

[on|off] 

-f NCI 对所有需要签入的文件应用命令。 


常见选项 

files... 

使用名称或文件名模式说明 ( 例如 "*.c") 指定要在命令中使用的文件。使用 

UNIX ( 而不是 Windows) 的语义约定解释所有选项 , 因为 UNIX 的约定更具 

体。这意味着 "*" ( 而不是 "*.*") 表示 “ 所有文件 ”。模式 "*.*" 表示 “ 带文件 

扩展名的所有文件 ”。例如 , 使用 "star*.*" 可以找到 starteam.doc 和 

starteam.cpp, 但不能找到 starteam。要找到上述所有名称 , 可以使用 

"star*"。 

如果不带该选项 , 则默认为 "*"。如果使用 , 则该选项必须始终是最后一个选 

项。其后的所有选项将被忽略。 

如果使用 * ( 而不是 "*") 表示所有文件 , 则 UNIX shell 会将其展开为一系列 

项 , 然后将该系列作为一组选项传送到 stcmd 命令。这样做可能会引起问题 

( 例如如果签出缺失的文件 ), 因此最好使用 "*" 以避免出现意外情况。 

如果使用一组文件模式 , 则应将各模式用自已的一组引号括起来。例如 , 可以 

使用 "*.bat" "*.c", 但不能使用 "*.bat *.c"。 

■ 注 : 如果没有特殊原因 , 我们建议您无论在哪个平台上 , 都用引号将该选项 

括起来。在 Windows 平台上 , 除非使用引号 , 否则不能正确解释带空格的 

文件名和文件夹名称。在 UNIX 平台上 , 如果不使用引号 , shell 将展开该 

选项 , 然后将因展开而显示出来的项列表传递给客户机。这常常会导致意外 

结果。如果用引号将该选项括起来 , 就可以避免上述这两种结果。仅当该选 

项必须由 UNIX shell 展开时 , 才可以省略引号。如果其中任一平台上的批 

处理脚本神秘失败 , 原因可能就是忽略了引号。 

在文件说明中可以使用以下几种特殊字符 : 

* 

与任何字符串 ( 包括空字符串 ) 匹配。例如 , "*" 与任何带或不带扩展名的文 

件名匹配。"xyz*" 将与 "xyz"、 "xyz.cpp" 和 "xyzutyfj" 匹配。 

? 

与任何单个字符匹配。例如 , "a?c" 与 "abc" 匹配 , 但不与 "ac" 匹配。 

[...] 

与用左括号和右括号括起来的字符中的任何一个字符匹配。 

用连字符 (-) 隔开的一对字符指定匹配的字符范围。 

如果左括号 ( [ ) 后的第一个字符是感叹号 ( ! ) 或脱字符 ( ^ ), 则其余字符不匹 

配。括号外的任何字符都匹配。例如 ,"x[a-d]y" 与 "xby" 匹配 , 但与 "xey" 不匹 

配。"x[!a-d]y" 与 "xey" 匹配 , 但与 "xby" 不匹配。 

可以匹配连字符 (-) 或右括号 ( ] ), 只要将其作为第一个或最后一个字符包括在 

一组括号中。 

要在模式中使用星号 (*)、问号 (?) 或左括号 ( [ ), 必须在其前面使用转义符 

( 此处为反斜杠 \)。 

-filter 文件状态筛选器。状态为 C = Current ( 当前 )、 M = Modified ( 已修改 )、 

O = Out of Date ( 过期 )、 N = Not in View ( 不在视图中 )、 I = Missing ( 缺 

失 )、 G = Merge ( 合并 ) 和 U = Unknown ( 未知 )。例如 , 使用 CM 仅将命 

令应用于状态为 Current ( 当前 ) 或 Modified ( 已修改 ) 的文件。 


常见选项 

-fp 

覆盖指定文件夹的工作文件夹或工作目录。这相当于为该文件夹设置备选工作 

路径。 

这样不仅使您可以使用不同于 StarTeam 文件夹指定的工作文件夹 , 其重要价值 

还在于提供跨平台的兼容性。例如 ,UNIX 和 Windows 系统以不兼容的方式指定 

驱动器和目录路径名称。虽然在 Windows 平台上可以理解路径 "D:\ 

MYPRODUCT\DEVELOPMENT\SOURCE", 但在 UNIX 平台上却不理解。如果 

您的平台不理解在 StarTeam 项目中指定的路径 , 请使用此选项定义工作路径。 

当反斜杠 (\) 放在引号之前时 , 将被解释为转义符。因此 , 在下面的示例中出现 

了错误 : 

stcmd ci -p "xxx" -fp "C:\" "*" 

将被解释为 : 

stcmd ci -p "xxx" -fp "C:" *" 

为避免出现此类情况 , 请将 "C:\" 中最后的字符转义 , 如下所示 : 

stcmd ci -p "xxx" -fp "C:\\" "*" 

或者 , 如果 -fp 路径不象在 "C:\orion\" 中那样以根文件夹结束 , 可按照如下方 

式避免此类情况的发生 : 

stcmd ci -p "xxx" -fp "C:\orion" "*" 


-fp "folderPath" 

“ 文件夹 ” 是 Windows 术语 , 出现在 StarTeam 用户界面中。 “ 目录 ” 是 

UNIX 平台的正确术语。 

-i 当文件状态为 Merge ( 合并 )、 Out of Date ( 过期 ) 或 Unknown ( 未知 ) 

时 , 提示用户确认签入。 

-is 

以递归方式将此命令应用于所有子文件夹。如果带有此选项 , 则该命令仅应用 

于指定文件夹。 

-l 锁定文件。 

-mark 将更改请求标记为已修复、将需求标记为完成或将任务标记为结束。 

-nel 非独占锁定文件。 

-nologo 隐含版权声明。- nologo 虽然不显示在语法中 , 但可与每个命令一起使用。 

-nomove 不能移动已附加的标签。 

-o 强制签入。 


常见选项 

-p 指示要使用的视图或文件夹 ; 还提供访问服务器所需的用户名和密码。 


-p "userName:password@hostName:portNumber/ 

projectName/[viewName/][folderHierarchy/]" 

如果省略了用户名 , 则使用当前用户名。 

如果省略密码 , 则提示用户输入密码。用户键入密码时 , 字符不显示在屏幕上。 

需要输入端点。在示例中使用默认端口号 49201。 

始终都需要项目名。 

使用视图层次确定视图。使用冒号 (:) 作为视图名称之间的定界符。视图层次应 

始终包含根视图。例如 ,“StarDraw:Release 4:Service Packs” 表示要使用的 

视图是 Service Packs 视图 , 该视图是 Release 4 视图的子视图 , 是 StarDraw 

根视图的孙视图。如果省略视图名 , 则使用根 ( 默认 ) 视图。如果此视图是该 

项目中具有该名称的唯一视图 , 则只能使用该视图名称。 ( 建议不这样做 , 因 

为以后可能会创建另一个具有该名称的视图 , 并因此造成混淆。) 示例中的视图 

名为 StarDraw。因为这是 StarDraw 项目的根视图 , 所以可能已将其省略。 

使用文件夹层次确定文件夹。使用正斜杆 (/) 作为文件夹名称之间的定界符。文 

件夹层次从不包含根文件夹。如果文件位于视图的根文件夹中 , 则省略文件夹 

层次。例如 , 如果视图的根文件夹是 StarDraw, 而且文件的层次是 

“StarDraw/SourceCode/Client”, 则仅使用 “SourceCode/Client”。 

如果与此选项一起使用的任何变量含有用作定界符的字符 , 则为这些字符中的 

每个字符都使用百分号 (%), 后接该字符的十六进制代码。例如 , 如果 "@" 作 

为一个字符出现在密码中 , 则必须用 "%40" 将其替换。 

对于 ":", 使用 "%3a"。 

对于 "/", 使用 "%2f"。 

对于 "@", 使用 "%40"。 

对于 "%", 使用 "%25"。 

在 UNIX 和其它操作系统中 , 某些特殊字符必须位于反斜杆 "\" 或其它转义符之 

后。在 -p 选项中 , 可用十六进制代码替换这些字符。例如 , 在 UNIX 中可用 

"%3c" 代替 "\

退出代码 

退出代码 

本章中的命令返回退出代码。这些代码包括 : 

■ 

■ 

■ 

0 表示成功 

1 表示失败 

101 表示指定文件模式中至少有一个不匹配 

■ 

102 表示指定的文件模式都不匹配 

stcmd diff 命令包含可返回退出代码的其它选项 (-e)。- e 选项有三个退出代码 (0、 1 和 

2), 与以上所列的含义不同。此外 , 如果不同时使用 -x 选项 , 可能不返回 1。 

对于 Windows 平台 , 可在批处理文件中使用 ERRORLEVEL 以执行基于命令结果的操 

作。例如 , 在某个批处理文件中的 stcmd 命令后 , 可能会使用以下语句 : 

IF ERRORLEVEL int statement 

其中 int 是 0 或 1。 

例如 : 

IF NOT ERRORLEVEL 1 GOTO OPOK 

ECHO ERROR OCCURRED AT STEP5>LOGFILE.TXT. 

:OPOK 

对于 Windows NT 或 2000, 也可使用伪环境变量 %ERRORLEVEL%。例如 , 可能在 

shell 中或在命令行 (stcmd 命令后 ) 使用以下语句 : 

SET /A STEPNUMBER=5 

SET /A THISERROR=STEPNUMBER*ERRORLEVEL 

SET /A ERRORMASK=+THISERROR 

对于 UNIX, 每个 shell 都有自己的判断退出代码的方法。例如 , 在 Bourne shell 中 , 以 

下语句可能出现在 stcmd 命令后 : 

if [ return ]; then statement 

添加文件 :stcmd add 

使用 stcmd add 从命令行将文件添加到视图。 

可将所添加的文件同时链接到某个过程项。所有使用此命令成功添加的文件都将被链接 

并固定到该过程项的最新修订。使用 -active 选项指定当前活动的过程项 ( 之前在工作 

站上使用 StarTeam 客户机设置 )。如果没有活动项 , 或者您要使用其它项 , 请使用指明 

过程项类型的选项 (-cr、-req 或 -task), 后接从 StarTeam 项目视图的根文件夹到要使 

用的项的完整路径。使用 -mark 选项可根据过程项类型将其同时标记为已修复、结束或 

完成。例如 , 可将某个更改请求标记为已修复。除非已成功添加所有文件 , 否则不将项 

标记为已修复、结束或完成。 

语法 

stcmd add 

-p "projectSpecifier" [-pwdfile "filePath"] [-cmp] [-csf] [-encrypt 

encryptionType] 

[-is] [-q] [-x] [-stop] 

[-rp "folderPath" | -fp "folderPath"] 

[-l | -u | -nel [-ro | -fw] 

[-d "description"] [-vl "labelName"] 

[-eol [on | off] ] [[ -active | 

[-cr | -req | -task ] processItemPath] 

[-mark]] [files...] 

-active 活动的过程项。 

-cr 从项目视图的根文件夹到将用作过程项的 CR 号的完整路径。 


添加文件夹 :stcmd add-folder 

-d 将新添加的文件的说明设置为指定说明。此说明括在双引号内。 

-eol 

在将工作文本文件传送到 StarTeam Server 的储存库时 , 自动将行尾 

标记转换为回车 / 换行符 (CR/LF)。如果使用 on, 工作文件的当前行尾 

标记转换为 CR/LF 的组合。如果使用默认值 off, 则不执行行尾转换。 

例如 , 从运行 UNIX 的计算机向储存库添加工作文件时 , 如果希望储 

存库将文本文件存储为 CR/LF, 则将此选项设置为 on。 

-l 在每个文件添加到视图后将其锁定。如果不带 -l、- u 或 -nel, 这些文件 

在默认情况下被解除锁定。 

-mark 

指示如果已成功添加所有文件 , 则该过程项的状态将更改为已修复 

( 更改请求 )、结束 ( 任务 ) 或完成 ( 需求 )。这些文件固定于最新 

状态的修订。 

-nel 在添加每个文件后将其非独占锁定。 

-req 从项目视图的根文件夹到将用作过程项的需求号的完整路径。 

-ro 

在此操作后使工作文件成为只读文件。如果不带此选项 , 该文件将保 

留其操作前的状态。通常 , 使用 -ro 可防止您自己编辑不是由您锁定 

的文件。 

-ro 必须与 -l 或 -u 或 -nel 一起使用。如果使用 -ro, 则不能使用 -rw。 

-rw 

在此操作后使工作文件成为可读写文件。如果不带此选项 , 该文件将 

保留其操作前的状态。 

-rw 必须与 -l 或 -u 或 -nel 一起使用。如果使用 -rw, 则不能使用 -ro。 

-task 从项目视图的根文件夹到将用作过程项的任务号的完整路径。 

-u 将新添加的文件保留为解除锁定状态。 

-vl 

指定要应用于新文件的标签。此标签括在双引号内。此选项可在命令 

中出现多次。此标签可以是视图或修订标签 , 但它必须已存在于 

StarTeam 中。另请参阅第 342 页的 “ 创建标签 :stcmd label”。 

示例 

以下示例使用 stcmd add 将状态为 Not In View( 不在视图中 ) 的 .doc 文件添加到 User 

Manual ( 用户手册 ) 文件夹中 , 该文件夹是根文件夹 StarDraw ( 在 StarDraw 项目的 

StarDraw 视图中 ) 的子文件夹。它锁定这些文件并为它们提供说明 “First draft of 

chapter”( 章节初稿 )。 

stcmd add -p "JMarsh:password@Orion:49201/StarDraw/ StarDraw/User Manual" -l 

-d "First draft of chapter" "*.doc" 


使用 stcmd add-folder 从命令行将 StarTeam 文件夹添加到视图。可将它添加到根文件 

夹或该视图中的任何其它文件夹。 

默认情况下 , 新 StarTeam 文件夹的工作文件夹创建于 StarTeam 中 , 而不是工作站上。 

此工作文件夹的名称与该 StarTeam 文件夹相同。它是 StarTeam 文件夹的父项的工作 

文件夹的子文件夹。 

例如 , 假设创建一个名为 "Wizard" 的 StarTeam 文件夹。 Wizard 是工作文件夹为 "C:\ 

StarDraw" 的 StarTeam 文件夹的子文件夹。 Wizard 的工作文件夹变为 "C:\StarDraw\ 

Wizard"。 

使用 -is 可将文件夹的分支添加到 StarTeam 项目视图的文件夹层次中。使用 -is 时 , 使 

用 -rp 或 -fp 指定工作站上其子文件夹将成为新 StarTeam 文件夹的子文件夹的文件夹。 

建议使用 -fp, 因为它可指定直接到这些子文件夹的父文件夹的路径。这是因为 -rp ( 该 

选项指定 StarTeam 视图的根文件夹的工作文件夹的路径 ) 可将从根文件夹到新文件夹 

这一范围的层次中的 StarTeam 文件夹名称附加到指定的路径。只有使用 -is 时 ,- rp 和 

-fp 才对此命令起作用。 



语法 

stcmd add-folder -p "projectSpecifier" 

[-pwdfile "filePath"] [-cmp] [-csf] 

[-encrypt encryptionType] [-is] 

[-q] [-x] [-stop] 

[-rp "folderPath" | -fp "folderPath" ] 

-name "folderName" [-d "description"] [-ex "excludeType" ] 

[-exlist "fileMask" | -exfile "filePath"] 

-d 指定文件夹的说明。最多使用 254 个字符。 

-ex 指示此新文件夹将使用的排除列表。 

排除列表将特定文件或文件类型排除 , 使其不可见。如果此 

StarTeam 文件夹的工作文件夹中的某个工作文件状态为 Not In View 

( 不在视图中 ), 但它符合一个排除列表中的某个文件规范 , 则 

StarTeam 不显示它。就好像该文件不存在一样。 

例如 , 假设正在某个应用程序中创建文件 , 此应用程序在您每次保存 

文件时都对每个文件进行自动备份 ( 使用扩展名 .bak)。您的工作文 

件夹可能包含若干 .bak 文件 , 但却没有理由将它们添加到 StarTeam 

项目视图中。在 StarTeam 中看到这些作为可能的备用文件的 .bak 

文件会产生干扰 , 因此将它们排除。排除文件是按文件夹进行的。但 

排除列表可从父文件夹继承。 


-ex excludeType 

类型包括 : 

inherit, 指示此文件夹将继承其父文件夹所用的所有排除列表 , 并 

使用由 -exfile 或 -exlist 指定的排除列表 ( 如果已创建 )。此为默认 

选项。 

local, 指示此文件夹只使用由 -exfile 或 -exlist 指定的排除列表。 

none, 指示此文件夹将不使用任何排除列表 , 而无论用 -exfile 或 

-exlist 指定了何种列表。 

-exfile 

指定含有此文件夹的本地排除列表的文件的路径。有关排除列表的内 

容的说明 , 请参阅 -exlist。 

-exlist 

为此文件夹指定本地排除列表。最多使用 254 个字符。输入一个或多 

个文件规范 ( 使用标准 * 和 ? 通配符 ), 用逗号、空格或分号分隔。 

要将逗号、空格或分号作为规范的一部分 , 可将该规范括在双引号 

中。例如 : 

*.exe,*.dll p*z.doc;*.t?t "test *.*" 

如果在排除列表中使用双引号或含有过长的排除列表 , 建议使用 

-exfile 选项。如果使用 -exlist, 则排除列表中的每个引号前都需要有 

您使用的系统或 shell 的转义符。例如 , 在 NT 系统上使用脱字符 

(^)。如果使用 -exfile, 则不需要使用转义符。 

-name 指定文件夹的名称。最多使用 254 个字符。 

在文件中 , 如果排除列表含有双引号 , 则不必使用转义符。 

示例 

以下示例使用 stcmd add-folder 创建名为 Wizard 的文件夹 , 作为 StarDraw 文件夹的子 

文件夹 , StarDraw 项目视图的根文件夹。此外 , 它为 Wizard 设置本地排除列表。默认 

情况下 , Wizard 继承其父文件夹的排除列表 , 也使用本地排除列表。 

stcmd add-folder -p "JMarsh:password@Orion:49201/ StarDraw/StarDraw/" -name 

"Wizard" -d "StarDraw setup wizard" -exlist "*.bak" 

下面的示例创建与上一个示例相同的文件夹。但它包含子文件夹。在此情况下 , 路径为 

"C:\Wizard" 的文件夹含有子文件夹 (Source、 Spec 和 Doc), 除 Wizard 之外所有子 

文件夹将作为 StarTeam 文件夹添加。 StarTeam Server 将自动为所有新文件夹 

(Wizard、Source、Spec 和 Doc) 分配默认工作文件夹 , 而无论 -fp 的设置如何。Wizard 

将是 Source、 Spec 和 Doc 的父文件夹。 StarDraw 是 Wizard 的父文件夹。 

stcmd add-folder -p "JMarsh:password@Orion:49201/ StarDraw/StarDraw/" -name 

"Wizard" -d "StarDraw setup wizard" -is -fp "C:\" -exlist "*.bak" 


添加项目 :stcmd add-project 

添加项目 :stcmd add-project 

使用 stcmd add-project 从命令行将项目添加到 StarTeam Server 配置。项目创建时 , 

也创建其根视图和根视图的根文件夹。在此命令中 ,- rp 选项为该根文件夹指定工作文 

件夹。 

使用 -is 可在 StarTeam 文件夹层次中将工作文件夹的子文件夹用作根文件夹的子文 

件夹。 

语法 

stcmd add-project[ -pwdfile "filePath"] [-cmp] 

[-encrypt encryptionType] [-is] [-q] 

[-x] [-stop] -s "serverName" 

-name "projectName" -rp "folderPath" 

[-d "description"] 

[-kw "fileMask" | -kwfile "filePath"] 

[-ex "excludeType" ] 

[-exlist "fileMask" | -exfile "filePath"] 

-d 指定项目的说明。最多使用 254 个字符。 

-ex 指示项目的根文件夹将使用的排除列表。 

排除列表将特定文件或文件类型排除 , 使其不可见。如果此 

StarTeam 文件夹的工作文件夹中的某个工作文件状态为 Not In 

View ( 不在视图中 ), 但它符合一个排除列表中的某个文件规范 , 

则 StarTeam 不显示它。就好像该文件不存在一样。 

例如 , 假设正在某个应用程序中创建文件 , 此应用程序在您每次 

保存文件时都对每个文件进行自动备份 ( 使用扩展名 .bak)。您 

的工作文件夹可能包含若干 .bak 文件 , 但却没有理由将它们添加 

到 StarTeam 项目视图中。在 StarTeam 中看到这些作为可能的备 

用文件的 .bak 文件会产生干扰 , 因此将它们排除。排除文件是按 

文件夹进行的。但排除列表可从父文件夹继承 


-ex excludeType 

类型包括 : 

inherit, 指示根文件夹将继承其父文件夹所用的排除列表 , 并使 

用由 -exfile 或 -exlist 指定的排除列表 ( 如果已创建 )。此为默认 

选项 — 即使根文件夹无可继承的内容。 

local, 指示根文件夹只使用由 -exfile 或 -exlist 指定的排除列表。 

none, 指示根文件夹将不使用任何排除列表 , 无论用 -exfile 或 

-exlist 指定了何种列表。 

-exfile 

-exlist 

-kw 

指定含有根文件夹的本地排除列表的文件的路径。有关排除列表 

的内容的说明 , 请参阅 -exlist。 

为根文件夹指定本地排除列表。最多使用 254 个字符。输入一个 

或多个文件规范 ( 使用标准 * 和 ? 通配符 ), 用逗号、空格或分 

号分隔。要将逗号、空格或分号作为规范的一部分 , 可将该规范 

括在双引号中。例如 : 

*.exe,*.dll p*z.doc;*.t?t "test *.*" 

如果在排除列表中使用双引号或含有过长的排除列表 , 建议使用 

-exfile 选项。如果使用 -exlist, 则排除列表中的每个引号前都需要 

有您使用的系统或 shell 的转义符。例如 , 在 NT 系统上使用脱字 

符 (^)。如果使用 -exfile, 则不需要使用转义符。 

指定要使用关键字的文件扩展名。最多使用 254 个字符。输入一 

个或多个文件规范 ( 使用标准 * 和 ? 通配符 ), 用逗号、空格或 

分号分隔。要将逗号、空格或分号作为规范的一部分 , 可将该规 

范括在双引号中。例如 : 

*.cpp,*.h p*z.doc;*.t?t "test *.*" 

如果在关键字列表中使用双引号或含有过长的列表 , 建议使用 

-kwfile 选项。如果使用 -kwlist, 则关键字列表中的每个引号前都 

需要有您使用的系统或 shell 的转义符。例如 , 在 NT 系统上使用 

脱字符 (^)。如果使用 -kwfile, 则不需要使用转义符。 


添加视图 :stcmd add-view 

示例 

以下示例使用 stcmd add-project 在名为 Orion 的计算机上创建名为 Integrations 的项 

目。(Orion 正在运行服务器配置使用端口 49201 的 StarTeam Server 实例。) 此命令创 

建项目 , 指定在工作站和服务器之间传送的数据将被压缩和加密 , 并为该项目提供说明。 

stcmd add-project -s "JMarsh:password@Orion:49201" -cmp -encrypt "RC4" -name 

"Integrations" -rp "C:\integrations" -d "integrations between our products and our 

partner’s products" 


-kwfile 指定含有要使用关键字的文件扩展名的文件的路径。 

-name 指定项目的名称。最多使用 254 个字符。 

-s 标识 StarTeam Server。 


-s "userName:password@host:portNumber" 

例如 : 

-s "JMarsh:password@orion:49201" 

如果省略了用户名 , 则使用当前用户名。示例中的用户名为 

“JMarsh” 

如果省略密码 , 则提示用户输入密码。示例中的密码为 

“password” 

如果省略主机名 , 则默认值为 localhost。示例中的主机名为 

“orion”。 

必须有端口号。在示例中使用默认端口号 49201。 

使用 stcmd add-view 从命令行将视图添加到 StarTeam Server 配置。创建视图时 , 其父 

视图是用 -p 选项指定的视图 , 其根文件夹是用 -p 选项指定的文件夹。在此命令中 ,- rp 

选项为该根文件夹指定工作文件夹。 

使用以下选项创建下列视图类型 : 

■ 

使用 -dr 创建读 / 写参考视图。 

■ 

使用 -dr -ro 创建只读参考视图。 

■ 

使用 -dr -ba 创建分支视图 , 其中现有项的行为被设置为在更改时分支。 

■ 

使用 -dr -bn 创建分支视图 , 其中现有项的行为未设置为在更改时分支。 

■ 

如果不使用 -dr, 则创建一个空白视图。 

如果使用 -ro、- ba 或 -bn 而不带 -dr 选项 , 则显示一条错误消息。 

如果使用 -cfgl、- cfgp 或 -cfgd 时即不带 -dr 选项 , 也不带 -ro、- ba 或 -bn 选项中的一个 

选项 , 则显示一条错误消息。 

有关每种视图类型的详细信息 , 请参阅 StarTeam 管理员指南。 



语法 

stcmd add-view 

示例 

-p "projectSpecifier" 

[-pwdfile "filePath"] [-cmp] 

[-encrypt encryptionType] [-q] [-x] 

[-stop] -name "viewName" 

[-rp "folderPath"] [-d "description"] 

[-dr [-ro |-ba |-bn [-cfgl "labelName"| 

-cfgp "stateName" | -cfgd "asOfDate"]]] 

-ba 

与 -dr 一起使用时 , 指定某个分支视图 , 其中现有项的行为设置为 

在更改时分支。最初视图属性 Set Items Shared Into View To 

Branch On Change ( 将共享到视图的项设置为在更改时分支 ) 的 

值被设置。 

此选项必须与 -dr 一起使用。 

-bn 

与 -dr 一起使用时 , 指定某个分支视图 , 其中现有项的行为未设置 

为在更改时分支。最初视图属性 Set Items Shared Into View To 

Branch On Change ( 将共享到视图的项设置为在更改时分支 ) 的 

值被清除。 

此选项必须与 -dr 一起使用。 

-cfgd 配置指定日期 / 时间前的视图。示例包括 : 

■ 

■ 

"12/29/01 10:52 AM" 

"December 29, 2001 10:52:00 AM PST" 

■ 

"Monday, December 29, 2001 10:52:00 oclock AM PST" 

此选项必须与以下组合之一共同使用 :- dr -ro、- dr -ba 或 -dr -bn。 

-cfgl 

使用指定标签配置视图。如果不带 -cfgl、- cfgp 或 -cfgd, 则使用视 

图的当前配置。 


-cfgp 使用指定提升状态配置视图。 


-d 指定视图的说明。最多使用 254 个字符。 

-dr 

指定派生视图。除空白视图之外的所有视图均为派生视图。另请参 

阅 -ba、- bn 和 -ro。 

若使用时不带 -ba、- bn 或 -ro, 则创建读 / 写参考视图。读 / 写参考 

视图的配置与其父视图的配置相同。因此 , 使用 -dr 而不带 

-ba、- bn 或 -ro 但带 -cfgl、- cfgp 或 -cfgd 可导致出现错误消息。 

如果不使用此选项 , 则创建空白视图。对于空白视图 , 初始时清除 

名为 Set Items Shared Into View To Branch On Change ( 将共享 

到视图的项设置为在更改时分支 ) 的视图属性的值。 

-name 指定视图的名称。最多使用 254 个字符。 

-ro 与 -dr 一起使用可指定某个只读参考视图。 

以下示例使用 stcmd add-view 在名为 Orion 的计算机上创建名为 Maintenance 5.1 的 

分支视图。(Orion 正在运行服务器配置使用端口 49201 的 StarTeam Server 实例。) 

此命令将该视图创建为现有 StarDraw 视图的子视图 , 并将 StarDraw 文件夹用作其根文 

件夹。此新视图是基于 5.1 产品在发布前的最后内部版本所用的标签 ( 内部版本 403)。 

它有一个与其父项的工作文件夹不同的工作文件夹。该视图中的所有现有项的行为将被 

设置为在更改时分支。 

stcmd add-view -p "JMarsh:password@Orion:49201/ StarDraw/StarDraw/" -cmp 

-encrypt "RC4" -name "Maintenance 5.1" -rp "C:\StarDraw\Maintenance 5.1" -d 

"Maintenance view for 5.1 release of our product" -dr -ba -cfgl "Build 403" 

以下示例使用 stcmd add-view 在名为 Orion 的计算机上创建名为 Rooted At Source 

Code 的读 / 写参考视图。(Orion 正在运行服务器配置使用端口 49201 的 StarTeam 

Server 实例。) 


应用标签 :stcmd apply-label 

此命令将该视图创建为现有 StarDraw 视图的子视图 , 并将 SourceCode 文件夹用作其 

根文件夹。它与其父项具有相同的工作文件夹。 

因为读 / 写参考视图必须与其父项具有相同的配置 , 所以不能使用 -cfgl、- cfgp 和 -cfgl 中 

的任何选项。 

stcmd add-view -p "JMarsh:password@Orion:49201/ StarDraw/StarDraw/Source 

Code" -cmp -encrypt "RC4" -name "Rooted At SourceCode" -d "StarDraw main view 

but with SourceCode folder as the root of the hierarchy" -dr 

应用标签 :stcmd apply-label 

使用 stcmd apply-label 可为指定文件修订加上视图标签或修订标签。这些标签必须已存 

在于 StarTeam 中。可在 StarTeam 中或使用 stcmd label 命令创建标签。请参阅第 342 

页的 “ 创建标签 :stcmd label”。 

语法 

stcmd apply-label -p "projectSpecifier" 


[-encrypt encryptionType] 

[-is] [-q] [-x] [-stop] 


[-filter "fileStatus"] 

[-vl "labelName" | -vd "asOfDate" 

| -vn revisionNumber] 

-lbl "labelName" [files...] 

-filter 

指定由一个或多个字符组成的字符串 , 每个字符代表一种文件状 

态。字符串中不得包含空格或其它空白字符。此标签仅适用于当 

前具有指定状态的文件。不能将标签应用于状态为 Not In View 

( 不在视图中 ) 的文件。 

用于表示状态的字母包括 : 

C 表示 Current( 当前 )、M 表示 Modified( 已修改 )、G 表示 

Merge ( 合并 )、 O 表示 Out of Date ( 过期 )、 I 表示 Missing 

( 缺失 )、 U 表示 Unknown ( 未知 )。 

-lbl 指定要添加到指定修订的标签名。可重复使用此选项。 

StarTeam 将所有标签附加到指定文件或修订。 

-vd 指定用于识别获得新标签的修订的截止日期 / 时间。示例包括 : 

■ 

■ 

"12/29/01 12:41 PM" 

"December 29, 2001 12:41:21 PM" 

■ 

"Monday, December 29, 2001 12:41" 

-vl 

指定用于标识获得新标签的修订的修订标签或视图标签。此标签 

必须已存在于 StarTeam 中。若不带 -vn 或 -vd 或 -vl 选项 , 则 

每个文件的最新修订都会收到该标签。 

-vn 指定用于标识获得新标签的修订的修订号。 

示例 

以下示例使用 stcmd apply-label 将 Beta 标签应用于 User Manual 文件夹中的文件 , 该 

文件夹是根文件夹 StarDraw 的子文件夹 ( 在 StarDraw 项目的 StarDraw 视图中 ) 。 

StarTeam 将此标签应用于时间为 2003 年 7 月 7 日中午的文件的修订。 

stcmd apply-label -p "JMarsh:password@Orion:49201/StarDraw/StarDraw/User 

Manual" -vd "07/07/03 12:00 PM" -lbl "Beta" "*" 


签入文件 :stcmd ci 

签入文件 :stcmd ci 

从命令行使用 stcmd ci 用将文件从工作文件夹签入到 StarTeam 储存库。 

可同时将多个新文件修订链接到某个过程项。所有使用此命令成功添加的文件都将被链 

接并固定到该过程项的最新修订。使用 -active 选项指定当前活动的过程项 ( 之前在工 

作站上使用 StarTeam 客户机设置 )。如果没有活动项 , 或者您要使用其它项 , 请使用指 

明过程项类型的选项 (-cr、-req 或 -task), 后接从 StarTeam 项目视图的根文件夹到要 

使用的项的完整路径。使用 -mark 选项可根据过程项类型将其同时标记为已修复、结束 

或完成。例如 , 可将某个更改请求标记为已修复。除非已成功添加所有文件 , 否则不将 

项标记为已修复、结束或完成。 

语法 

stcmd ci 

-p "projectSpecifier" [-pwdfile "filePath"] [-cmp] [-csf] 


[-is] [-q] [-x] [-stop] 



[-l | -u | -nel [-ro | -rw] ] 

[-vl "labelName"] [-nomove] [-f NCI] 

[-o | -i] [-r "comment" | -rf "filePath"] 

[-eol [on | off] ] [ -active | 

[-cr | -req | -task ] processItemPath 

[-mark]] [files...] 

-active 活动的过程项。 

-cr 从项目视图的根文件夹到将用作过程项的 CR 号的完整路径。 

-eol 

在将工作文本文件传送到 StarTeam Server 的储存库时 , 自动将 

行尾标记转换为回车 / 换行符 (CR/LF)。如果使用 on, 工作文件 

的当前行尾标记转换为回车 / 换行符 (CR/LF) 的组合。如果使用 

默认值 off, 则不执行行尾转换。在 Windows 客户机上 , 行尾标 

记是 CR/LF ; 在 UNIX 平台上 , 它是换行符 (LF)。 

例如 , 从运行 UNIX 的计算机将工作文件签入储存库时 , 可将此 

选项设置为 on, 储存库会将文本文件存储为 CR/LF。 

-f NCI 指定签入状态为 Modified ( 已修改 ) 的任何文件。 NCI 代表 “ 需 

要签入 ”。不选择签入任何其它文件类型。 

如果使用 -filter, 则忽略 -f NCI。 

-filter 


态。字符串中不得包含空格或其它空白字符。只签入当前具有指 

定状态的文件。不能签入状态为 Not In View ( 不在视图中 ) 的 

文件。 


C 表示 Current ( 当前 )、 M 表示 Modified ( 已修改 )、 G 表示 



-filter 优先于 -f NCI。如果使用 G、 O 或 U, 还必须指定 -i 或 -o。 

否则将忽略 G、 O 或 U。 

-i 对于其状态通常不允许它们签入的文件 , 可进行交互式签入。对 

于状态为 Merge ( 合并 )、 Out of Date ( 过期 ) 或 Unknown 

( 未知 ) 的每个文件 , 都会询问您是否要签入。可通过您的响应 

强制签入文件。 

如果使用 -i 选项 , 则不能使用 -o 选项。 

-l 将每个签入的文件锁定。若不带 -l、- u 或 -nel, 则文件锁定状态 

不变。 

-mark 

指示如果已成功添加所有文件 , 则该过程项的状态将更改为已修 

复 ( 更改请求 )、结束 ( 任务 ) 或完成 ( 需求 )。这些文件固定 

于最新状态的修订。 

-nel 非独占锁定每个签入的文件。 

-nomove 

如果某个要签入的文件已经具有带标签的修订 , 则停止应用由 -vl 

选项指定的标签。否则 , 将从当前带标签的修订将此标签移动到 

新签入的修订。 


签出文件 :stcmd co 

示例 


-o 对于其状态通常不允许它们签入的文件可进行强制签入。此选项 

将状态为 Merge ( 合并 )、 Out of Date ( 过期 ) 或 Unknown 

( 未知 ) 的所有文件强制签入。 

如果使用 -o 选项 , 则不能使用 -i 选项。 

-r 提供修订注释 , 通常是签入文件的原因。 

如果使用 -r 选项 , 则不能使用 -rf 选项。 

-req 从项目视图的根文件夹到将用作过程项的需求号的完整路径。 

-rf 提供含有修订注释的文件的路径。 

如果使用 -rf 选项 , 则不能使用 -r 选项。 

-ro 

在此操作后使工作文件成为只读文件。如果不带此选项 , 该文件 

将保留其操作前的状态。 

通常使用 -ro 防止您自己编辑不是由您锁定的文件。 

-ro 必须与 -l 或 -u 或 -nel 一起使用。如果使用 -ro, 则不能使用 

-rw。 

-rw 

在此操作后使工作文件成为可读写文件。如果不带此选项 , 该文 

件将保留其操作前的状态。 

-rw 必须与 -l 或 -u 或 -nel 一起使用。如果使用 -rw, 则不能使用 

-ro。 

-task 从项目视图的根文件夹到将用作过程项的任务号的完整路径。 

-u 解除锁定新签入的文件。 

-vl 

指定要应用于签入文件的标签 ( 使用 stcmd label 创建 )。此标签 

括在双引号内。此选项可在命令中出现多次。此标签可以是视图 

或修订标签 , 但它必须已存在于 StarTeam 中。另请参阅第 342 

页的 “ 创建标签 :stcmd label”。 

以下示例使用 stcmd ci 将 .bmp 文件签入到 Online Help 文件夹 , 该文件夹是根文件夹 

StarDraw( 在 StarDraw 项目的 StarDraw 视图中 ) 的子文件夹。该命令解除锁定文件、 

使工作副本变为只读并提供修订注释 ( 签入文件的原因 )。 

stcmd ci -p "JMarsh:password@Orion:49201/StarDraw/StarDraw/SourceCode/Online 

Help" -u -ro 

-r "revised for beta" "*.bmp" 

从命令行使用 stcmd co 将文件从 StarTeam 储存库签出到工作文件夹。此命令尝试将所 

有文件 ( 或所有指定文件 ) 从指定 StarTeam 位置签出 , 而无论其状态如何。如果不使 

用 -o, 此命令将在每个状态为 Modified ( 已修改 )、 Merge ( 合并 ) 或 Unknown ( 未 

知 ) 的文件处暂停 , 以便让您知道不会将该文件签出。 

使用 -merge 选项可将文件合并为签出过程的一部分。合并不是签入过程的一部分。 



语法 

stcmd co -p "projectSpecifier" [-pwdfile "filePath"] 

[-cmp] [-csf] [-encrypt encryptionType] 

[-is] [-q] [-x] [-stop] 


[-cfgl "labelName"| -cfgp "stateName" 

| -cfgd "asOfDate"] 

[-filter "fileStatus"] [-o | -i | 

-merge [ reportOption ][-hook "appName"]] 

[-l | -u | -nel [-ro | -rw]] 

[-vl "labelName" | -vd "asOfDate" | 

-vn revisionNumber] [-f NCO] [-ts] 

[-eol on | off | cr| lf| crlf ] [-fs] [files...] 


"12/29/01 10:52 AM" 



-cfgl 

使用指定标签配置视图。如果不带 -cfgl、- cfgp 或 -cfgd, 则使用视图 

的当前配置。 


-eol 可自动转换行尾标记。 

如果使用 on, 则从 StarTeam Server 的储存库向工作站的工作文件 

夹传输文本文件时 , 使用平台 ( 该平台执行由 Java VM 确定的命 

令 ) 的行尾处理约定。 

如果使用默认值 off, 则不执行行尾转换。使用 off 与根本不使用 -eol 

相同。 

如果指定行尾字符 (cr、 lf 或 crlf), 则使用指定的行尾约定从 

StarTeam Server 的储存库向工作站的工作文件夹传输文本文件。 

对于 Windows 客户机 , 行尾标记是回车与换行符的组合 (crlf) ; 对 

于 UNIX 平台 , 行尾标记是换行符 (lf) ; 对于 MAC 系统 , 行尾标记 

是回车 (cr)。 

例如 , 将储存库中的文件与 UNIX 系统中的工作文件进行比较后 , 会 

将该选项设置为 on 或 lf ( 如果储存库将文本文件存储为 crlf)。 

-f NCO 指定签出任何状态为 Missing ( 缺失 ) 或 Out of Date ( 过期 ) 的文 

件。 NCO 代表 “ 需要签出 ”。未选择签出其它任何文件。 

如果使用 -filter, 则忽略 -f NCO。 

-filter 指定由一个或多个字符组成的字符串 , 每个字符代表一种文件状 

态。字符串中不得包含空格或其它空白字符。只能签出当前具有指定 

状态的文件。不能签出状态为 Not In View ( 不在视图中 ) 的文件。 



Merge ( 合并 )、 O 表示 Out of Date ( 过期 )、 I 表示 Missing ( 缺 

失 )、 U 表示 Unknown ( 未知 )。 

-filter 优先于 -f NCO。如果使用 G、 M、 O 或 U, 还必须指定 

-merge 或 o, 以强制执行签出操作。否则将忽略 G、 M、 O 或 U。 

-fs 

防止在文件签出后记录其状态。这些文件的随后状态值将不正确 , 并 

且无法确定。请在文件状态不相关时使用该选项。例如 , 如果在签出 

某个内部版本的文件之前例行删除工作文件夹 , 则不会存在文件 , 而 

且文件的状态也无关紧要。 

应清楚即使以后使用 update-status 命令 , 也可能永远无法知道文件 

状态。您可以执行强制签出而不带有 -fs 选项 , 以获得状态正确的当 

前文件。 



-hook 

只与 -merge 一起使用。使您能够指定备选应用程序 ( 可通过 

StarTeam 获得的除外 ) 执行合并。 

此选项的值应是运行能执行合并的程序的名称 , 例如 : 

-hook mymerge.sh 

该合并应用程序必须返回一个退出代码 , 0 表示未检测到冲突 , 1 表 

示检测到冲突。返回任何其它值都表示有错误。 

此合并应用程序不能是 Windows 平台上的批处理文件 , 因为通过 

Java 运行时 , 不能正确返回结果代码。 

对于每个要合并的文件 ,stcmd 为此合并应用程序提供三个参数。这 

些参数是以下三个文件 ( 按此顺序 ) 的全限定路径 : 

localFile: 本地工作文件 

commonFile: 储存库中文件修订的内容 , 此修订是在该储存库中要 

在本地修改的文件和指定的修订之间的最新常用修订 

otherFile: 要签出的文件修订的内容 

此合并挂钩程序必须将合并结果发送到标准输出 (stdout)。 

-i 允许对其状态通常不允许它们签出的文件进行交互式签出。对于状态 

为 Modified ( 已修改 )、 Merge ( 合并 ) 或 Unknown ( 未知 ) 的每 

个文件 , 都会询问您是否要签出。可通过您的响应强制签出文件。 

如果使用 -i 选项 , 则不能使用 -o 或 -merge 选项。 

-l 锁定每个签出的文件。如果不使用 -l 或 -u 或 -nel, 则文件锁定状态 

保持不变。 

-merge 

使您能够将工作文件与要签出的修订以及与这两者 ( 工作文件和要 

签出的修订 ) 所基于的修订进行合并。此工作文件的状态必须为 

Merge ( 合并 )。 

可用 -merge 指定以下报告选项之一 : 

-dryrun: 指示已合并的结果文件是否有冲突 ; 因为未签出任何内容 , 

所以本地工作文件不变。这样可以提供预览。 

-alwaysprompt: 总是提示用户在工作文件夹中保存已合并的结果文 

件 , 而无论是否存在合并冲突。 

-neverprompt: 总是将已合并的结果文件保存到工作文件夹。 

-conflictprompt: 只在检测到冲突时提示用户保存已合并的结果文件。 

选项 -dryrun、- alwaysprompt、- neverprompt、- conflictprompt 为互斥 

选项。如果不指定任何选项 , 则默认行为是 -conflictprompt。 

可指定备选应用程序 ( 可通过 StarTeam 获得的除外 ) 执行合并。 

请参阅第 337 页的 “- hook”。 

如果使用 -merge 选项 , 则不能使用 -i 或 -o 选项。 

如果未使用 -hook 且保存了含有冲突的已合并文件 , 则每个冲突在 

工作文件中按以下方式标记 : 

> fileName (version x) 

其中 fileName 是文件的名称 , x 是要签出的修订的编号。 

如果未指定 -merge, 将忽略状态为 Merge ( 合并 ) 的文件 , 除非指 

定 -o 并强制执行签出操作。 

-nel 非独占锁定签出的文件。 

-o 强制签出任何状态的文件。 

如果使用 -o 选项 , 则不能使用 -i 或 -merge 选项。 

-ro 

-rw 

在此操作后使工作文件成为只读文件。如果不带此选项 , 该文件将 

保留其操作前的状态。通常使用 -ro 防止您自己编辑不是由您锁定的 

文件。 

-ro 必须与 -l 或 -u 或 -nel 一起使用。如果使用 -ro, 则不能使用 -rw。 

在此操作后使工作文件成为可读写文件。如果不带此选项 , 该文件将 

保留其操作前的状态。 


-ro。 


删除本地文件 :stcmd delete-local 

-ts 

将每个工作文件的时间戳设置为签出时间。如果不带此选项 , 则提供 

给文件的时间戳与文件修订的签入的时间戳相同。 

-u 解除锁定签出的文件。 

-vd 

指定用于标识要签出的修订的截止日期 / 时间。指定日期 / 时间前的 

最后修订是为每个文件签出的修订。请参阅前面的 -cfgd 的日期 / 时 

间示例。 

-vl 

指定用于标识要签出的修订的修订标签或视图标签。若不带 -vn 或 

-vd 或 -vl 选项 , 则签出每个文件的最新修订。 

-vn 指定要签出的文件的修订号。 

示例 

以下示例使用 stcmd co 将 .doc 文件锁定并从 User Manual 文件夹中并签出 , User 

Manual 文件夹是根文件夹 StarDraw ( 在 StarDraw 项目的 StarDraw 视图中 ) 的子文 

件夹。 

stcmd co -p "JMarsh:password@Orion:49201/StarDraw/StarDraw/User Manual" -l 

"*.doc" 

下面的示例使用 stcmd co 合并自述文件。 

stcmd co -p "NTesla:@10.50.5.179:49201/WebDev/WebDev" -encrypt RC4 -fp "/ 

export/home0/johnson/working" -merge "README" 

删除本地文件 :stcmd delete-local 

使用 stcmd delete-local 从工作文件夹删除文件。可删除版本控制下以及不在 StarTeam 

中的文件。此选项不会从版本控制中删除任何文件 ; 它只是减少您的工作站上的工作文 

件夹中存储的数据量。如果根据文件的 StarTeam 状态删除文件 , 最好先使用 stcmd 

update-status。有关详细信息 , 请参阅第 349 页的 “ 更新文件状态 :stcmd 

update-status”。 

语法 

stcmd delete-local 

-p "projectSpecifier" 



[-is] [-q] [-x] [-stop] 


[-cfgl "labelName" | -cfgp "stateName" | -cfgd 

"asOfDate"] 

[-filter "fileStatus"] [files...] 


"12/29/01 10:52 AM" 


"Monday, December 29, 2001 10:52:00 oclock AM 

PST" 

-cfgl 使用指定标签配置视图。如果不带 -cfgl、- cfgp 或 -cfgd, 则 

使用视图的当前配置。 


-filter 

指定由一个或多个字符组成的字符串 , 每个字符代表一种文 

件状态。字符串中不得包含空格或其它空白字符。只删除当 

前具有指定状态的文件。 


C 表示 Current( 当前 )、M 表示 Modified( 已修改 )、G 表 

示 Merge ( 合并 )、 O 表示 Out of Date ( 过期 )、 I 表示 

Missing ( 缺失 )、 U 表示 Unknown ( 未知 )。 


比较文件修订 :stcmd diff 

示例 

以下示例使用 stcmd delete-local 从 StarTeam 文件夹的工作文件夹 ( 名为 SourceCode) 

中删除某些文件。SourceCode 是根文件夹 StarDraw( 在 StarDraw 项目的 StarDraw 视 

图中 ) 的子文件夹。它删除不在版本控制下的所有文件。这些文件的状态为 Not In View 

( 不在视图中 )。 

stcmd delete-local -p "JMarsh:password@Orion:49201/StarDraw/StarDraw/ 

SourceCode" /filter "N" "*" 


使用 stcmd diff 可显示文本文件或二进制文件的两个修订之间的差异。此命令可指定多 

个文件 , 每个文件都可进行相似的比较。如果未指定任何修订 ( 使用 -vn 或 -vd 或 -vl), 

则每个指定文件的工作副本与其在储存库中的最新修订进行比较。如果指定了单个修 

订 , 则每个指定文件的工作副本与该修订进行比较。如果指定两个修订 , 则会比较每个 

指定文件的这两个修订。比较文本文件时 , 可显示差异。二进制文件的比较生成指出该 

文件的修订是否相同的输出。 

语法 

stcmd diff -p "projectSpecifier" 



[-is] [-q] [-x] [-stop] 


[-cfgl "labelName" |-cfgp "stateName" 



[-eol [on | off | cr| lf| crlf]] ] 

[-w | -Bpvcs | -b] [-i] [-m "maskSet"] 

[-t number] [-c number] [-n] [-nd] [-e] 


| -vn revisionNumber] [files...] 

-b 比较文本文件的两个行时 , 忽略尾随的空白字符 , 并将所有其它 

空白字符串视为等长。例如 , 下面的两行相当 : 

" hi mom " 

" hi mom" 

-Bpvcs 

比较文本文件的两行时忽略前导空白字符和尾随空白字符。例 

如 , 因为在 "hi" 和 "mom" 之间只有一个空格 , 所以以下两行是 

等同的 : 

" hi mom " 

" hi mom" 

但下面的行则不等同 : 

"hi 

mom" 

-c 指定要在文本文件中找到的差异之前和之后显示的未更改的行数。 

若不带此选项 , 则显示文件的所有行。例如 ,-c 2 在已更改的每一 

行或一组行的前后放置两个未更改的行。 


"12/29/01 10:52 AM" 



-cfgl 




-e 使命令返回以下退出代码 : 

■ 如果所有已比较的文件等同 , 则返回 0 

■ 如果出现一个错误情况 , 则返回 1 

■ 如果至少一个文件不同 , 则返回 2 

文本或二进制文件使用 -e。 



-eol 

-filter 

此命令在此时间点不相关 , 因为 diff 当前忽略行尾标记。如果除此 

之外两行相同 , 则它们被报告为等同。 


态。字符串中不得包含空格或其它空白字符。只比较当前具有指 

定状态的文件。不能比较状态为 Not In View ( 不在视图中 ) 的文 

件的修订。 





-i 比较两个文本文件时忽略字母的大小写。例如 , "A" 等同于 

"a"。 

-m 比较两个文本文件时 , 忽略特定列中用一个或多个掩码指定的字 

符。每个掩码具有以下语法 : 

"columnNumber-columnNumber[(numeric)]" 

例如 , "1-6" 忽略每行前六列的字符 , 而 "1-6(numeric)" 忽略每 

行前六列 ( 如果这两个文件的第 1 列中的字符均为数字 )。 

可使用一系列掩码 , 但它们必须由逗号隔开。语法如下 : 

"mask[,mask]..." 

-n 抑制两个文本文件中行数的显示。 

-nd 

抑制两个文本文件中的差异的显示。二进制文件的比较不显示差 

异。此选项与 -e 选项一起使用时很有用。 

-t 显示文本文件的文件差异时指定用于每个制表位的空格数。默认 

为四个。使用 -t 0 抑制制表符转换。 

-vd 

指定用于标识要比较的修订的截止日期 / 时间。指定日期 / 时间前 

的最后一个修订即是所用的修订。请参阅前面的 -cfgd 的日期 / 时 

间示例。 

-vl 

指定用于标识要比较的修订的修订标签或视图标签。可指定 

-vn、- vd、- vl 选项中的零个、一个或二个的任意组合。 

使用零个选项将工作文件与最新修订进行比较 , 使用一个选项将 

工作文件与指定修订进行比较 , 使用二个选项则比较两个修订。 

-vn 指定要比较的修订号。 

-w 比较文本文件的两行时忽略所有空白字符 ( 制表符和空格 )。例 

如 , 以下两行是等同的 : 

"a = ( b + 2);" 

"a=(b+2);" 

-w、- Bpvcs 和 -b 选项为互斥选项。 

示例 

以下示例使用 stcmd diff 比较 SourceCode 中每个 .cpp 文件的 Beta1 和 Beta2 修订 , 其 

中 SourceCode 文件夹是根文件夹 StarDraw ( 在 StarDraw 项目的 StarDraw 视图中 ) 

的子文件夹。它忽略所有空白字符。 

stcmd diff -p "JMarsh:password@Orion:49201/StarDraw/StarDraw/SourceCode" -w 

-vl "Beta1" -vl "Beta2" "*.cpp" 


更改说明 :stcmd dsc 

更改说明 :stcmd dsc 

使用 stcmd dsc 从命令行更改文件说明。此命令创建一个含新说明并将该说明视为属性 

之一的新文件修订。 

语法 

示例 

以下示例使用 stcmd dsc 更改 User Manual 中的 stdafx.cpp 的说明 ,User Manual 文件 

夹是根文件夹 StarDraw ( 在 StarDraw 项目的 StarDraw 视图中 ) 的子文件夹。 

stcmd dsc -p "JMarsh:password@Orion:49201/StarDraw/StarDraw/SourceCode" -d 

"SourceCode for StarTeam" "stdafx.cpp" 

显示文件历史 :stcmd hist 

stcmd dsc 


encryptionType] [-is] [-q] [-x] [-stop] 



-d "description" [files...] 

-d 提供文件的说明。此说明括在双引号内。 

-filter 指定由一个或多个字符组成的字符串 , 每个字符代表一种文件状态。 

字符串中不得包含空格或其它空白字符。只对当前具有指定状态的文 

件提供说明。不能更改状态为 Not In View ( 不在视图中 ) 的文件的 

说明。 

使用 stcmd hist 显示文件的修订历史。 

语法 





stcmd hist -p "projectSpecifier" [-pwdfile "filePath"] 

[-cmp] [-csf] [-encrypt encryptionType] 

[-is] [-q] [-x] [-stop] 


[-cfgl "labelName" | -cfgp "stateName" 




"12/29/01 10:52 AM" 



-cfgl 




创建标签 :stcmd label 

示例 

创建标签 :stcmd label 


-filter 


态。字符串中不得包含空格或其它空白字符。只报告当前具有指 

定状态的文件。不能查看状态为 Not In View ( 不在视图中 ) 的文 

件的历史。 

以下示例使用 stcmd hist 显示 SourceCode 中的文件 star.h 的修订历史 , SourceCode 

文件夹是根文件夹 StarDraw ( 在 StarDraw 项目的 StarDraw 视图中 ) 的子文件夹。 

stcmd hist -p "JMarsh:password@Orion:49201/StarDraw/StarDraw/ 

SourceCode" "star.h" 

使用 stcmd label 创建视图标签或修订标签。如果标签是视图标签 , 可将它指定为内部版 

本标签。默认情况下 , 视图标签自动应用于视图中的每个文件夹、文件、更改请求、主 

题和任务。默认情况下 , 修订标签不应用于任何项。 

可使用 stcmd apply-label 将使用 stcmd label 创建的标签应用于指定文件。请参阅第 333 

页的 “ 应用标签 :stcmd apply-label” 。也可在签入这些文件时在 stcmd ci 中使用标签 

选项 (-vl), 以便将这些文件附加新标签。请参阅第 334 页的 “ 签入文件 :stcmd ci”。 

语法 





stcmd label 

-p "projectSpecifier" [-pwdfile "filePath"] [-cmp] [-encrypt 

encryptionType] [-q] [-x] [-stop] -nl "labelName" 


| -vp "stateName"] [-d "description"] 

[-b | -r] [-f] 

-b 指出新标签为内部版本标签。若不带 -b 或 -r, 则此标签为视图 

标签。视图标签 ( 内部版本标签是特殊类型的视图标签 ) 被立 

即、自动应用于视图中的每个文件夹、文件、更改请求、任务和 

主题。 

-d 指定标签的说明。 

-f 创建新标签作为冻结标签。 

-nl 指定新标签的名称。 

-r 指出新标签为修订标签。可使用新标签为签入的文件加上标签。 

此命令不将新标签附加到任何项 , 除非通过复制附加到一个或多 

个项的现有修订标签创建该标签。请参阅下面的 -vl 选项。 

-vd 

创建视图标签时指定标签的截止日期 / 时间。如果要创建修订标 

签 , 则忽略 -vd。 

若不带 -vn 或 -vd 或 -vl 选项 , 则为视图标签使用当前时间。 

示例包括 : 

"12/29/01 12:41 PM" 

"December 29, 2001 12:41:21 PM" 

"Monday, December 29, 2001 12:41" 


锁定和解除锁定文件 :stcmd lck 

-vl 

-vp 

指定要复制的标签的名称。此标签的名称括在双引号内。指定的 

标签必须已存在于 StarTeam 且必须与正在创建的标签类型相 

同。如果指定标签是附加到一个或多个项的修订标签 , 则新标签 

将被附加给那些相同的项。 


如果此标签是修订标签 , 请务必设置 -r。 

指定提升状态 , 该状态的标签将被复制。此状态的名称括在双引 

号内。指定标签必须已存在于 StarTeam 而且您必须创建视图标 

签 , 此选项才有效。 


示例 

以下示例使用 stcmd label 为 StarDraw 项目的 StarDraw 视图创建名为 Beta 的新内部 

版本标签。 

stcmd label -p "JMarsh:password@Orion:49201/StarDraw/StarDraw" -nl "Beta" -b 

锁定和解除锁定文件 :stcmd lck 

使用 stcmd lck 从命令行锁定或解除锁定视图中的文件。 

语法 

stcmd lck 



[-is] [-q] [-x] [-stop] 


[-filter "fileStatus"] [-break] 

[-l | -u | -nel [-ro | -rw]] [files...] 

-break 如果您具有断开锁的访问权限 , 可由其他用户断开当前锁。 

-filter 


态。字符串中不得包含空格或其它空白字符。只锁定或解除锁定当 

前具有指定状态的文件。不能锁定或解除锁定状态为 Not In View 

( 不在视图中 ) 的文件。 





-l 锁定文件。若未使用 -l、- nel 或 -u, 则默认使用该选项。 

-nel 非独占锁定文件。 

-ro 

在此操作后使工作文件成为只读文件。如果不带此选项 , 该文件将 

保留其操作前的状态。通常使用 -ro 防止您自己编辑不是由您锁定 

的文件。 

-ro 必须与 -l 或 -u 或 -nel 一起使用。如果使用 -ro, 则不能使用 

-rw。 

-rw 

在此操作后使工作文件成为可读写文件。如果不带此选项 , 该文件 

将保留其操作前的状态。 


-ro。 

-u 解除锁定文件。 


列出文件 :stcmd list 

示例 

列出文件 :stcmd list 

下面的示例使用 stcmd lck 解除锁定 SourceCode 中的所有文件以及 SourceCode 的子 

文件夹中的所有文件 , 其中 SourceCode 文件夹是根文件夹 StarDraw( 在 StarDraw 项 

目的 StarDraw 视图中 ) 的子文件夹。 

stcmd lck -p "JMarsh:password@Orion:49201/StarDraw/StarDraw/SourceCode" -is -u 

"*" 

使用 stcmd list 列出由 -p 选项指定的文件夹中的所有文件。这些文件是存在于特定时间 

或具有特定标签的文件。 

语法 

sstcmd list 



[-is ] [-q] [-x] [-stop] [-short] 


[-cfgl "labelName" | -cfgp "stateName" 

| -cfgd "asOfDate"] [-filter "fileStatus"] [-cf] [files...] 

-cf 使文件夹中子文件夹的名称添加到列表中。 


"12/29/01 10:52 AM" 



-cfgl 




-filter 


态。字符串中不得包含空格或其它空白字符。只列出当前具有指定 

状态的文件。不能列出状态为 Not In View ( 不在视图中 ) 的文件。 

-short 



Merge( 合并 )、O 表示 Out of Date ( 过期 )、I 表示 Missing( 缺 


提供本地文件及其状态的简短列表 , 此列表含有状态缩写和工作文 

件的相关路径 , 例如 : 

M /starteam/Server.java 

N /starteam/LabelInfo.java 

如果不带此选项 , 则列表由以下内容组成 : 

由每个 StarTeam 文件夹名称后接其工作文件的路径组成的一行 

在文件夹内 , 每个文件都有一个行 , 该行以非缩写状态开始且含有 

权限、时间戳和文件名。 

例如 : 

Folder: Source (working dir: E:\Source) 

Unknown rw 4/6/02 7:42:18 PM PST 230 req.bmp 

示例 

下面的示例使用 stcmd list 列出 SourceCode 中的所有文件以及 SourceCode 的子文件 

夹中的所有文件 , 其中 SourceCode 文件夹是根文件夹 StarDraw( 在 StarDraw 项目的 

StarDraw 视图中 ) 的子文件夹。 

stcmd list -p "JMarsh:password@Orion:49201/StarDraw/StarDraw/SourceCode" -is 

"*" 


创建工作文件夹 :stcmd local-mkdir 

创建工作文件夹 :stcmd local-mkdir 

使用 stcmd local-mkdir 在工作站上为指定 StarTeam 文件夹创建工作文件夹或工作目 

录。使用 -is 也可为指定 StarTeam 文件夹的子文件夹创建工作文件夹 ( 或工作目录 )。 

语法 

stcmd local-mkdir -p "projectSpecifier" 



[-is] [-q] [-x] [-stop] 

[-rp "folderPath" |-fp "folderPath" ] 

[-cfgl "labelName" | -cfgp "stateName" | -cfgd "asOfDate"] 


"12/29/01 10:52 AM" 



-cfgl 




"12/29/01 10:52 AM" 



示例 

以下示例使用 stcmd local-mkdir 为 SourceCode 及其子文件夹创建工作文件夹 , 

SourceCode 文件夹是根文件夹 StarDraw ( 在 StarDraw 项目的 StarDraw 视图中 ) 的 

子文件夹。 

stcmd local-mkdir -p "JMarsh:password@Orion:49201/StarDraw/StarDraw/ 

SourceCode" -is 

合并文件 

可将文件作为签出命令 stcmd co 的一部分合并。请参阅第 335 页的 “ 签出文件 :stcmd 

co”。 

也可使用 View Comparison 实用程序和 viewmerge 命令行合并文件。请参阅 StarTeam 


移动状态 :stcmd move-status 

stcmd move-status 命令可帮助您将 StarTeam 5.1 和更早版本的服务器上的存储文件状 

态转换为 StarTeam 5.2 和更新版本的客户机上的存储文件状态。 

stcmd move-status 命令可将文件状态信息从服务器移至客户机。只有在将 StarTeam 

Server 升级到 5.2 以后的版本之前和将 StarTeam Windows 客户机或 Cross-Platform 

客户机升级到 5.2 以后的版本之后 , 才能使用此命令。升级服务器后 , 状态信息不再存 

在于服务器上 , 而且不再有任何要移动的内容。 

使用此命令前 , 必须设置个人选项 , 以指示存储客户机端状态信息的位置。此信息可按 

文件夹存储或集中存储。可从 StarTeam Windows 客户机、Cross-Platform 客户机或在 

命令行使用 stcmd set-personal-options 设置个人选项。如果未设置任何个人选项 , 则所 

有命令都将在以下的集中位置寻找状态信息 : 

■ 

对于 Windows NT, 在已安装该应用程序的文件夹中。 


移动状态 :stcmd move-status 

■ 

对于 Windows 2000 或 XP: 

C:\Documents and Settings\username\Local Settings\ Application Data\Borland\ 

StarTeam\syncdb 

■ 

对于非 Windows 平台 :/user_home_directory/.starteam-client/syncdb 

建议在升级服务器前移动状态信息。否则所有文件状态将变为 Unknown ( 未知 )。 

可在命令行使用 stcmd update-status 命令或在 Windows 或 Cross-Platform 客户机中使 

用 File ( 文件 ) \Update Status ( 更新状态 ) 命令重新计算许多状态 , 但却不能计算一 

个相当重要的状态 , 即 Merge ( 合并 )。此外 , 重新计算比 move-status 操作需要更长 

的时间。 

一种替代方法是 , 可确保在将服务器升级到 5.2 之后的版本前 , 所有文件都为当前状态。 

语法 

stcmd move-status -p "projectSpecifier" 



[-is] [-q] [-x] [-stop] 


[-cfgl "labelName" | -cfgp "stateName" | -cfgd "asOfDate"] 



"12/29/01 10:52 AM" 



-cfgl 

使用指定标签配置视图。如果不带 -cfgl、- cfgp 或 -cfgd, 则使用视图 

的当前配置。 


-filter 

指定由一个或多个字符组成的字符串 , 每个字符代表一个要移动的 

文件状态。字符串中不得包含空格或其它空白字符。只有当前具有 

指定状态的文件的状态才会移动到客户机。状态 Not In View ( 不在 

视图中 ) 不在此列表中 , 因为 StarTeam 不存储有关此状态的文件的 

信息。 

示例 





以下示例使用 stcmd move-status 将 SourceCode 文件夹及其子文件夹中的所有文件状 

态信息从服务器移动到客户机。 

stcmd move-status -p "JMarsh:password@Orion:49201/StarDraw/StarDraw/ 

SourceCode" -is "*" 


删除文件 :stcmd remove 

删除文件 :stcmd remove 

使用 stcmd remove 从版本控制删除文件。除非将项目视图回滚到删除之前的某个时 

间 , 否则指定的文件及其修订历史不再出现在 StarTeam 中。 

语法 

stcmd remove -p "projectSpecifier" 



[-is] [-q] [-x] [-stop] 


[-filter "fileStatus"] [-df] [files...] 

-df 

删除用户的工作文件。若不带此选项 , 则工作文件将保留在工作站 

上的工作文件夹中。 

-filter 指定由一个或多个字符组成的字符串 , 每个字符代表一种文件状态。 

字符串中不得包含空格或其它空白字符。只删除当前具有指定状态 

的文件。不能从版本控制中删除状态为 Not In View ( 不在视图中 ) 

的文件。 





示例 

下面的示例使用 stcmd remove 从 SourceCode 中删除所有文件以及 SourceCode 的子 

文件夹中的所有文件 , 其中 SourceCode 文件夹是根文件夹 StarDraw( 在 StarDraw 项 

目的 StarDraw 视图中 ) 的子文件夹。它也删除工作文件。 

stcmd remove -p "JMarsh:password@Orion:49201/StarDraw/StarDraw/SourceCode" 

-is -df "*.hm" 

锁定 / 解除锁定服务器 :stcmd server-mode 

使用 stcmd server-mode 锁定和解除锁定服务器 ( 如果具有相应的访问权限或权限 )。 

锁定服务器将在执行备份或其它操作时限制对服务器的访问。锁定服务器后 , 将只接受 

服务器管理命令。解锁服务器后 , 会恢复正常操作。 

注 

不能将用户名 “StarTeam” 与此命令一起使用 , 因为即使已提供密码或用户密码为 

空 , 它也要求用户输入密码。 

语法 

stcmd server-mode [-pwdfile "filePath"] [-cmp] 

[-encrypt encryptionType] [-q] [-x] [-stop] -s "serverName" 

-mode [lock | exlock | unlock] 

exlock 独占锁定服务器 , 使任何人都不能访问该服务器。 

锁定非独占锁定服务器。只可执行管理命令。 

-mode 指示服务器是被锁定、独占锁定还是解除锁定。 

如果使用 -mode lock, 在服务器解除锁定前只接受服务器管理命令。 

例如 , 可在运行备份程序时使用此命令。 

如果使用 -mode exlock, 则在服务器解除锁定前 , 只有您能访问该 

服务器。例如 , 可在创建自定义字段时执行此操作。 

使用 -mode unlock 使用户可再次访问服务器。 


设置个人选项 : stcmd set-personal-options 

解除锁定 

将服务器解除锁定 , 使具有相应访问权限的任何人都可以访问该服 

务器。 

-s 指定服务器。完整语法如下 : 

-s "userName:password@hostName:portNumber" 

示例 

以下示例使用 stcmd server-mode 在端口 49201 上非独占锁定 Orion 服务器。 

stcmd server-mode -s "JMarsh:password@Orion:49201" -mode lock 

设置个人选项 : stcmd set-personal-options 

使用 stcmd set-personal-options 设置并列出个人选项。只可在此时间点设置的个人选 

项有 : 

■ 

存储文件状态信息的方法 

■ 

在中心位置存储该信息时的存储位置 

此信息存储于 starteam-client-options.xml 文件中。如果没有 starteam-client-options.xml 

文件 , 此命令将在默认位置创建该文件。此默认位置与 central-status 选项 ( 下面列出 ) 

的默认位置相同。 

语法 

stcmd set-personal-options 

例如 : 

-s "JMarsh:password@orion:49201" 

如果省略了用户名 , 则使用当前用户名。示例中的用户名为 

“JMarsh” 

如果省略密码 , 则提示用户输入密码。示例中的密码为 

“password” 



必须有端口号。在示例中使用默认端口号 49201。 

[-q] [-x] [-stop] 

[-central-status | 

-per-folder-status] 

[-central-repository "folderPath"] [-list] 

-central-repository 允许您指定中心储存库的位置。 

-central-status 

指示将在工作站上在中心位置为此用户存储文件状态信息。可使 

用 StarTeam Windows 客户机、 Cross-Platform 客户机或此命令 

设置此位置 ( 请参阅 -central-repository 选项 )。 

如果不设置此位置 , 则默认位置为 : 

■ 对于 Windows NT, 在已安装该应用程序的文件夹中。 

-per-folder-status 

-list 

■ 

■ 

对于 Windows 2000 或 XP: 

C:\Documents and Settings\username\Local Settings\ 

Application Data\Borland\StarTeam\ 

对于非 Windows 平台 :/user_home_directory/.starteamclient/ 

指示每个工作文件夹将含有各自文件的文件状态信息。此信息存 

储于文件夹 .sbas ( 工作文件夹的子文件夹 ) 中。如果移动工作 

文件夹 , 则文件状态信息也随之移动。 

按当前在存储个人选项的 starteam-client-options.xml 中设置的 

个人选项显示个人选项列表。 


更新文件状态 :stcmd update-status 

示例 

以下示例使用 stcmd set-personal-options 指示将在某个中心位置存储文件状态信息 : 

C:\jmarsh\statusinfo。 

stcmd set-personal-options -central-status 

-central-repository "C:\jmarsh\statusinfo" 


更新某个文件的状态时 , StarTeam 将工作文件与签出的修订及最新修订进行比较。例 

如 ,StarTeam 可能显示某个文件状态为 Current ( 当前 ), 但其他人刚刚签入该文件的 

一个副本 , 因此您的实际状态为 Out Of Date ( 过期 )。 

更新文件状态与更新文件不同。例如 , 如果某个文件不在工作文件夹中 , 则更新状态将 

使您知道文件状态为 Missing( 缺失 )。它不为您签出该文件 , 这样该文件不再为缺失状 

态。您终究可能还是不希望该文件存在于您的硬盘驱动器上。通常 , 您使用文件状态确 

定是否应将文件签入、签出、添加或忽略。 

例如 , 您可能希望 : 

■ 

如果某个文件的状态为 Out Of Date ( 过期 )、 Missing ( 缺失 ) 或 Merge ( 合并 ), 

则签入该文件。 

■ 

如果某个文件的状态为 Modified ( 已修改 ) 或 Merge ( 合并 ), 则签出该文件。 

■ 

如果某个文件的状态为 Not In View ( 不在视图中 ) , 则将该文件添加到 StarTeam 

中。但 update-status 命令始终都不会列出状态为 Not In View ( 不在视图中 ) 的文 

件 , 因为它们不存储在储存库中。 

有关文件状态的完整列表 , 请参阅第 148 页的 “ 确定文件状态 ”。 

使用 stcmd update-status 显示文件名、执行该命令前的状态和执行该命令后的状态。例 

如 , 可能输出下面的一行 : 

x.cpp: status is Current (was Unknown) 

语法 

stcmd update-status -p "projectSpecifier" 



[-is] [-q] [-x] [-stop] 

[-rp "folderPath" |-fp "folderPath" ] 

[-cfgl "labelName"| -cfgp "stateName" | -cfgd 

"asOfDate"] 


[-eol [on | off]] 

[-v] [files...] 


"12/29/01 10:52 AM" 



PST" 

-cfgl 

使用指定标签配置视图。如果不带 -cfgl、- cfgp 或 -cfgd, 则使用 

视图的当前配置。 


-eol 

如果使用 on, 判断文本文件的状态而不使用行尾 (eol) 标记。如 

果使用 off ( 默认选项 ), 在工作文件和最新修订上确定更新状 

态 , 因为它们带有当前行尾标记。 

启用此选项时 , 可将含有 LF eol 标记的工作文件与带有 CR/LF 

eol 标记的最新修订进行比较 , 并可将该文件视为 Current ( 当 

前 )( 如果 eol 标记是唯一差异 )。 



-filter 


态。字符串中不得包含空格或其它空白字符。只更新当前具有指 

定状态的文件。 




-v 报告指定的 StarTeam 文件夹的工作文件夹中每个文件的状态 , 

除非其状态为 Not In View ( 不在视图中 )。如无此选项 , 只有在 

文件状态更改时才显示它。 

示例 

以下示例使用 stcmd update-status 以确保 StarTeam 文件夹的名为 SourceCode 的工 

作文件夹中的每个文件都具有正确状态。 SourceCode 是根文件夹 StarDraw ( 在 

StarDraw 项目的 StarDraw 视图中 ) 的子文件夹。 

stcmd update-status -p "JMarsh:password@Orion:49201/StarDraw/StarDraw/ 

SourceCode" "*" 


章 

使用 bco 命令行界面 

第 23 章 

使用可在 StarTeam Windows 和 StarTeam Cross-Platform 客户机上运行的 “ 批量签 

出 ”(bco) 实用程序 , 可将大量文件从 StarTeam 储存库快速签出到工作文件夹。您可能 

想要使用该实用程序签出文件以进行生成 , 因为它的速度比标准 StarTeam 命令行签出 

stcmd co ( 第 335 页 ) 更快 , 在与 “ 高速缓存代理 ” 结合使用时尤其如此。 

大多数生成过程从视图标签或提升状态签出 ( 使用 -cfgl 和 -cfgp)。如果您签出最新修 

订 , 则应清楚 : 用户可能会签入您正在签出的文件 , 这样便会导致快照不一致。如果您 

需要快照 , 则必须使用其它方法确保快照一致。例如 , 您可以使用 stcmd 服务器模式命 

令独占锁定服务器 , 或者要求用户在得到进一步通知之前不要签入文件。 

“ 批量签出 ” 实用程序不区分大小写 , 所以不会识别文件夹名称中的此类差异。但它识 

别文件名中的这些差异。对于大多数用户来说 , 这不会是问题。 

第 23 章 : 使用 bco 命令行界面 351

语法 

语法 

bco -p "projectSpecifier" [-pwdfile "filePath"] 

[-autoLogon] [-is] 


[-cmp] [-dryrun] [-csf] 

[-encrypt encryptionType] [-q] 

[-cfgl "labelName"| -cfgp "stateName" 



[-o] [-ro] [-ts] 

[-eol on | off | cr| lf| crlf ] [-fs] 

[-vl "labelName" | -vd "asOfDate" | 

-vn revisionNumber] 

[-netmon] [-t] [-h | -help] 

[files...] 

-autoLogon 

如果在 -p 选项中未指定用户名 , 则尝试使用 “StarTeam 工具 

栏 ” 实用程序中存储的指定 StarTeam Server 的用户 ID 和密码进 

行登录。只有在 Windows 操作系统中才能使用该选项。 

-cfgd 配置截至指定日期 / 时间的视图。示例包括 : 

■ 

■ 

■ 

"12/29/01 10:52 AM" 



PST" 

-cfgl 

使用指定标签配置视图。如果没有 -cfgl、- cfgp 或 -cfgd, 则使用 

视图的当前配置。 

-cfgp 使用指定的提升状态配置视图。 

-cmp 

压缩在工作站与服务器之间发送的所有数据 , 然后在数据到达时 

将其解压缩。如果没有此选项 , 则不进行压缩。 

当客户机与服务器通过慢速连接进行通信时 , 最适合使用压缩。 

要确定是否使用压缩 , 一个小型的测试实例可能会非常有用。您 

必须考虑花费在压缩和解压缩数据上的时间是否要比通过慢速连 

接发送非压缩数据所花费的较长的传输时间更划算。 

-dryrun 

如果未指定 -dryrun, 则不会签出文件 , 只显示将要签出的文件列 

表。路径是作为文件复制目的地的工作文件夹的路径。如果与 -vb 

一起使用 , 则可了解到整个过程。 

-encrypt 

加密所有在工作站和服务器之间传送的数据 , 然后在数据到达后 

将其解密。若无此选项 , 则不进行加密。加密可防止未授权方通 

过不安全的网络线路 ( 例如 Internet) 读取文件和其它项目信息。 


-encrypt encryptionType 

加密类型包括 : 

RC4 

RSA R4 流密码 ( 快速 ) 

RC2_ECB 

RSA R2 块密码 ( 电子密码本 ) 

RC2_CBC 

RSA R2 块密码 ( 密码块链 ) 

RC2_CFB 

( 仅限 Windows 平台 ) 

RSA R2 块密码 ( 密码反馈 ) 

这些加密类型按由快到慢的顺序排列。每种加密类型都比其前面 

的类型慢 , 但更加安全。 


语法 

-eol 可自动转换行尾标记。 

如果使用 on, 则从 StarTeam Server 的储存库向工作站的工作文 

件夹传输文本文件时 , 使用平台 ( 该平台执行由 Java VM 确定的 

命令 ) 的行尾处理约定。 

如果使用默认值 off, 则不执行行尾转换。使用 off 与根本不使用 

-eol 相同。 

如果指定行尾字符 (cr、lf 或 crlf), 则使用指定的行尾处理约定从 

StarTeam Server 的储存库向工作站的工作文件夹传输文本文件。 

对于 Windows 客户机 , 行尾标记是回车与换行符的组合 (crlf) ; 

对于 UNIX 平台 , 行尾标记是换行符 (lf) ; 对于 MAC 系统 , 行尾 

标记是回车 (cr)。 

例如 , 在将储存库的文件与 UNIX 系统中的工作文件进行比较后 , 

可将该选项设置为 on 或 lf( 如果储存库将文本文件存储为 crlf)。 

files... 

使用名称或文件名模式说明 ( 例如 "*.c") 指定要在命令中使用的 

文件。使用 UNIX ( 而不是 Windows) 的语义约定解释所有选 

项 , 因为 UNIX 的约定更具体。这意味着 "*" ( 而不是 "*.*") 表示 

“ 所有文件 ”。模式 "*.*" 表示 “ 带文件扩展名的所有文件 ”。例 

如 , 使用 “star*.*” 可以找到 starteam.doc 和 starteam.cpp 但不能 

找到 starteam。要找到所有这些名称 , 可以使用 "star*"。 

如果没有此选项 , 则默认值为 "*"。如果使用此选项 , 则其必须始 

终是最后一个选项。其后的所有选项将被忽略。 

如果使用 * ( 而不是 "*") 来表示所有文件 , 则 UNIX shell 将其展 

开为一系列项 , 并将这一系列项作为一个选项组传递到 bco 命 

令。这样可能会造成问题 ( 例如在签出丢失的文件时 ), 因此最 

好使用 "*" 来避免出现意想不到的问题。 

如果使用一组文件模式 , 则应将各模式用其自已的一组引号括起 

来。例如 , 可使用 "*.bat" "*.c", 但不能使用 "*.bat *.c"。 

■ 注 : 如果没有特殊原因 , 我们建议您无论在哪个平台上 , 都用 

引号将该选项括起来。在 Windows 平台上 , 如果不使用引 

号 , 则将无法正确解释带空格的文件和文件夹名称。在 UNIX 

平台上 , 如果不使用引号 , shell 将展开该选项 , 然后将因展 

开而显示出来的项列表传递给客户机。这经常会产生意外结 

果。可通过用引号将该选项括起来的方式 , 避免产生这两种结 

果。仅当该选项必须由 UNIX shell 展开时 , 才可以省略引号。 

如果其中任一平台上的批处理脚本神秘失败 , 其原因可能便是 

省略了引号。 

在文件说明中可以使用以下几种特殊字符 : 

* 

与任何字符串 ( 包括空字符串 ) 匹配。例如 , "*" 与任何有扩展名 

或没有扩展名的文件名相匹配。 "xyz*" 将与 "xyz"、 "xyz.cpp" 和 

"xyzutyfj" 匹配。 

? 

与任何单个字符匹配。例如 ,"a?c" 与 "abc" 匹配 , 但不与 "ac" 匹 

配。 

[...] 

与用左括号和右括号括起来的字符中的任何一个字符匹配。 

用连字符 (-) 隔开的一对字符指定要匹配的字符范围。 

如果右括号 ( [ ) 后面的第一个字符是感叹号 ( ! ) 或脱字符 ( ^ ), 

则其余字符将不匹配。而未用括号括起来的任何字符将都匹配。 

例如 , "x[a-d]y" 与 "xby" 匹配 , 但不与 "xey" 匹配。 "x[!a-d]y" 与 

"xey" 匹配 , 但不与 "xby" 匹配。 

可以匹配连字符 (-) 或右括号 ( ] ), 方法 : 将其作为第一个或最后 

一个字符包括在一组括号内。 

要在模式中使用星号 (*)、问号 (?) 或左括号 ( [ ), 必须在其前面 

使用转义符 - 反斜杠 \。 

第 23 章 : 使用 bco 命令行界面 353

语法 

-filter 指定由一个或多个字符组成的字符串 , 每个字符代表一种文件状 

态。字符串中切勿包含空格或其它空白。只能签出当前具有指定状 

态的文件。不能签出状态为 Not In View ( 不在视图中 ) 的文件。 


C 表示 “ 当前 ”、 M 表示 “ 已修改 ”、 G 表示 “ 合并 ”、 O 表示 

“ 过期 ”、 I 表示 “ 缺失 ”、 U 表示 “ 未知 ”。 

-fp 

-fs 

-h 

-help 

-is 

如果使用 G、 M、 O 或 U, 还必须指定 -o 强制执行签出操作。如 

果没有 -o, 则将跳过用 G、 M、 O 和 U 表示状态的文件 , 但会在 

日志文件中记录警告。 

覆盖指定文件夹的工作文件夹或工作目录。这等于为该文件夹设 

置备选工作路径。 

尽管这将使您能够使用与 StarTeam 文件夹所指定的工作文件夹 

不同的文件夹 , 但是其重要价值在于它可以用于提供跨平台兼容 

性。例如 , UNIX 和 Windows 系统以不兼容的方式指定驱动器和 

目录路径名称。虽然 Windows 平台理解路径 "D:\MYPRODUCT\ 

DEVELOPMENT\SOURCE", 但是 UNIX 平台上却不理解。如果 

您的平台不理解 StarTeam 项目中指定的路径 , 请使用此选项定 

义工作路径。 

当反斜杠 (\) 放在引号之前时 , 将被解释为转义符。因此 , 在下面 

的示例中出现了错误 : 

bco -p "xxx" -fp "C:\" "*" 

将被解释为 : 

bco -p "xxx" -fp "C:" *" 

为避免发生此类情况 , 请将 "C:\" 中最后的字符转义 , 如下所示 : 

bco -p "xxx" -fp "C:\\" "*" 

或者 , 在 -fp 路径不以根文件夹结束时 ( 例如在 "C:\orion\" 中 ), 

按照如下方式避免此类情况的发生 : 

bco -p "xxx" -fp "C:\orion" "*" 


-fp "folderPath" 

“ 文件夹 ” 是 Windows 术语 , 出现在 StarTeam 用户界面中。 

“ 目录 ” 是 UNIX 平台的正确术语。 

防止文件状态在发生签出操作后被记住。这些文件的随后状态值 

将不正确 , 并且无法确定。请在文件状态不相关时使用该选项。 

例如 , 如果在签出一个内部版本的文件之前例行删除工作文件 

夹 , 则不会存在文件 , 而且文件的状态也无关紧要。 

应清楚 : 即使以后使用 update-status 命令 , 也可能永远无法知道 

文件的状态。要获得具有正确状态的当前文件 , 可在没有 -fs 选项 

的情况下进行强制签出。 

显示关于选项的信息。 

以递归方式将此命令应用于所有子文件夹。如果没有此选项 , 则 

该命令将仅应用于指定文件夹。 

-netmon 

将 SDK NetMonitor 信息输出到控制台窗口。 NetMonitor 显示服 

务器命令的统计信息。请参阅本章末尾的 bco 示例。 

-o 将文件状态通常不允许其签出的文件强制签出。这些状态为 

Modified ( 已修改 )、 Merge ( 合并 ) 或 Unknown ( 未知 )。 


语法 

-p 指示要使用的视图或文件夹 , 而且还提供访问服务器时所需的用 

户名和密码。 


-p "userName:password@hostName:portNumber/ 

projectName/[viewName/][folderHierarchy/]" 

例如 : 

-p "JMarsh:password@orion:49201/StarDraw/ 

StarDraw/SourceCode/" 

如果省略用户名 , 则使用当前用户名。 

示例中的用户名为 “JMarsh”。 

如果省略密码 , 则会提示用户输入密码。用户键入密码时 , 字符 

不会显示在屏幕上。示例中的密码为 “password”。 



需要端口号。在示例中使用默认端口号 49201。 

始终都需要项目名。示例中的项目名为 StarDraw。 

使用视图层次确定视图。使用冒号 (:) 作为视图名称之间的定界 

符。视图层次应始终包含根视图。例如 ,“StarDraw:Release 

4:Service Packs” 表示要使用的视图是 Service Packs 视图 , 该 

视图是 Release 4 视图的子视图、 StarDraw 根视图的孙视图。如 

果省略视图名 , 则使用根 ( 默认 ) 视图。如果视图是该项目中具 

有该名称的唯一视图 , 则只能使用该视图名称。( 不建议这样做 , 

因为以后可能会创建另一个具有该名称的视图 , 并因此造成混 

淆。) 示例中的视图名为 StarDraw。因为这是 StarDraw 项目的 

根视图 , 所以可能已将其省略。 

使用文件夹层次确定文件夹。使用正斜杆 (/) 作为文件夹名称之间 

的定界符。文件夹层次从不包含根文件夹。如果文件位于视图的 

根文件夹中 , 则省略文件夹层次。例如 , 如果视图的根文件夹是 

StarDraw, 而且文件的层次是 “StarDraw/SourceCode/ 

Client”, 则仅使用 “SourceCode/Client”。 

如果与此选项一起使用的任何变量 ( 例如用户名或视图名 ) 包含 

用作定界符的字符 , 则请使用百分号 (%), 后跟这些字符中每个 

字符的十六进制代码。例如 , 如果 “@” 作为一个字符出现在密 

码中 , 则必须用 “%40” 将其替换。 

对于 “:”, 使用 “%3a”。 

对于 “/”, 使用 “%2f”。 

对于 “@”, 使用 “%40”。 

对于 “%”, 使用 “%25”。 

在 UNIX 和其它操作系统中 , 某些特殊字符前面必须加上反斜杆 

“\” 或另一个转义符。在 -p 选项中 , 可用十六进制代码替换此类 

字符。例如 , 在 UNIX 中可用 “%3c” 代替 “\

语法 

-ts 

将每个工作文件的时间戳设置为签出时间。如果没有此选项 , 则 

提供给文件的时间戳与文件的签入修订相同。 

-useCA 尝试使用 StarTeamMPX Cache Agent 签出文件。 


-useCA hostName:portNumber | autolocate 

如果指定要使用的 Cache Agent 的主机名 ( 或 IP 地址 ) 和端口 

号 , 则在运行 BCO 实用程序时 StarTeam Server 不必启用 

MPX。 

如果使用 autolocate, 而不是指定主机名和端口号 , 则该实用程 

序可自动查找离网络最近的 Cache Agent, 但只有在 StarTeam 

服务器启用 MPX 时才可这样做。 

-vb 

输出内容非常详细。按照其签出时的样子显示每一个文件。文件 

夹路径是 StarTeam 文件夹路径 , 而不是工作文件夹路径。 

示例 

下面的示例使用 bco 强制签出 Source Code 中的所有文件 , Source Code 是根文件夹 

StarDraw ( 在 StarDraw 项目的 StarDraw 视图中 ) 的一个子文件夹。 

bco -p "JMarsh:password@Orion:1024/StarDraw/StarDraw/Source Code" -is -o "*" 

下一个示例显示使用 -netmon 的 bco 命令以及由 “ 网络监视器 ” 显示的输出。 

bco -p "Administrator:Administrator@10.50.6.91:49201/StarDraw/WebSite" -fp D:\ 

Test -netmon -o "*.htm" 

输出 : 

StarTeam BulkCheckOut Utility version 7.0.xxx 

Copyright (c) 2004 Borland Software Corporation. All rights reserved. 

Start: (rev 100) SRVR_CMD_GET_PROJECT_LIST Time: 62 millis; Sent: 42 bytes; 

Got: 1834 bytes 

Start: (rev 100) SRVR_CMD_GET_PROJECT_VIEWS Time: 47 millis; Sent: 46 

bytes; Got: 186 bytes 



Start: (rev 100) SRVR_CMD_PROJECT_OPEN Time: 188 millis; Sent: 70 bytes; Got: 

120 bytes 

Start: (rev 100) PROJ_CMD_GET_VIEW_PROPERTIES Time: 31 millis; Sent: 42 


Start: (rev 100) PROJ_CMD_GET_FOLDERS Time: 63 millis; Sent: 42 bytes; Got: 

1112 bytes 

Start: (rev 100) PROJ_CMD_GET_FOLDER_ITEMS Time: 16 millis; Sent: 50 bytes; 

Got: 40 bytes 

Start: (rev 100) PROJ_CMD_REFRESH_ITEMS Time: 3562 millis; Sent: 122 bytes; 

Got: 414 bytes 



Start: (rev 100) PROJ_CMD_GET_PROJECT_PROPERTIES Time: 31 millis; Sent: 

42 bytes; Got: 4797 bytes 

Start: (rev 100) FILE_CMD_CHECKOUT Time: 47 millis; Sent: 78 bytes; Got: 108 

bytes 


bytes 


bytes 

Start: (rev 100) SRVR_CMD_PROJECT_CLOSE Time: 15 millis; Sent: 62 bytes; Got: 

16 bytes 

Start: (rev 100) SRVR_CMD_RELEASE_CLIENT Time: 31 millis; Sent: 42 bytes; 

Got: 16 bytes 


附录 

附录 A 

比较 Windows 和 Cross-Platform 

客户机 

本附录可使您根据 StarTeam Windows 客户机和 StarTeam Cross-Platform 客户机的菜 

单命令来比较它们的功能。存在差异时使用粗体文本。 

Project ( 项目 ) 菜单命令 Windows 客户机 Cross-Platform 客户机 

New ( 新建 ) 是是 , 外部存档项目例外 

Open ( 打开 ) 是是 

Close ( 关闭 ) 是是 

Open Shortcut ( 打开快捷是 

是 

方式 ) 

Save Shortcuts As ( 另存快是 

是 

捷方式为 ) 

Properties ( 属性 ) 是是 

Access Rights ( 访问权限 ) 是是 

Delete ( 删除 ) 是是 

Recent Projects ( 最新是 

否 

项目 ) 

Connection Properties 是 

是 

( 连接属性 ) 

Logoff ( 注销 ) 否 , 不需要是 

Exit ( 退出 ) 是是 , 但如果开启警告 , 会要求确认 

View ( 视图 ) 菜单命令 Windows 客户机 Cross-Platform 客户机 

New View ( 新建视图 ) 是是 

Delete View ( 删除视图 ) 是是 

Select View ( 选择视图 ) 是是 

Select Configuration ( 选择是 

是 

配置 ) 

Profiles ( 配置文件 ) 是否 

View Properties( 视图属性 ) 是是 

View Access Rights ( 视图是 

是 

访问权限 ) 

Labels ( 标签 ) 是是 

附录 A: 比较 Windows 和 Cross-Platform 客户机 357

比较 Windows 和 Cross-Platform 客户机 

Promotion States ( 提升 

状态 ) 

View Compare/Merge 

( 视图比较 / 合并 ) 

View Manager ( 视图管 

理器 ) 

是 

是 

否 

Folder ( 文件夹 ) 菜单命令 Windows 客户机 Cross-Platform 客户机 

New ( 新建 ) 是是 


Create Working Folders 是 

是 

( 创建工作文件夹 ) 

Properties ( 属性 ) 是 , 但不同 , 请参阅文件 

夹属性菜单 

是 , 但不同 , 请参阅文件夹属性 

菜单 

Labels ( 标签 ) 是是 

Advanced ( 高级 ) > 是 

是 

Behavior ( 行为 ) 

Advanced ( 高级 ) > 是 

是 

References ( 引用 ) 

Advanced( 高级 )> Access 是 

是 

Rights ( 访问权限 ) 

Links ( 链接 ) > Create 是 

是 

( 创建 ) 

Links ( 链接 ) > Complete 

( 完成 ) 

是 

是 

Folder Properties ( 文件夹 Windows 客户机 Cross-Platform 客户机 

属性 ) 对话框 

Name ( 名称 ) 选项卡是是 

Exclude ( 排除 ) 选项卡是是 

Files ( 文件 ) 选项卡是 

否 , 从个人选项中执行 

设置 EOL 转换 

Files ( 文件 ) 选项卡是 

否 

设置区分大小写 

History ( 历史 ) 选项卡是是 

Links ( 链接 ) 选项卡是是 

菜单命令 Windows 客户机 Cross-Platform 客户机 

New ( 新建 )( 不是在 File 是 

是 

( 文件 ) 或 Audit ( 审核 ) 菜 

单上 ) 

New Child Requirement 

( 新建子需求 ) ( 仅 

Requirement ( 需求 ) 菜单 ) 

是 

是 

New Subtask ( 新建子任务 ) 是 

是 

( 仅 Task ( 任务 ) 菜单 ) 

Respond ( 响应 ) 

是 

是 

( 仅 Topic ( 主题 ) 菜单 ) 

Open ( 打开 )( 仅 File ( 文是 

是 

件 ) 菜单 ) 

Edit ( 编辑 )( 仅 File ( 文是 

是 

件 ) 菜单 ) 

Properties ( 属性 ) * 是是 

Print ( 打印 ) 是否 

Send To ( 发送至 ) 是是 

Save Shortcut ( 保存快捷是 

是 

方式 ) 

Add Files ( 添加文件 )( 仅 

File ( 文件 ) 菜单 ) 

是 

是 

是 

否 

是 



Check In ( 签入 )( 仅 File 

( 文件 ) 菜单 ) 

Check Out ( 签出 )( 仅 File 

( 文件 ) 菜单 ) 

Check Out All ( 全部签出 ) 

( 仅 File ( 文件 ) 菜单 ) 

Update Status ( 更新状态 ) 

( 仅 File ( 文件 ) 菜单 ) 

Move Status Locally ( 在 

本地移动状态 )( 仅 File 

( 文件 ) 菜单 ) 

Lock/Unlock ( 锁定 / 解除是 

是 

锁定 ) 

Compare Properties ( 比较是 

是 

属性 ) 

Compare Contents ( 比较内是 

是 

容 )( 仅 File ( 文件 ) 菜单 ) 

Labels( 标签 )> New( 新建 ) 是是 

Labels ( 标签 ) > Attach 是 

是 

( 附加 ) 

Labels ( 标签 ) > Detach 

( 分离 ) 

是 

是 

是 

是 

是 

是 

否 

是 

是 

是 

是 

是 , 5.2 之前的版本升级时有用 

菜单命令 Windows 客户机 Cross-Platform 客户机 

Advanced ( 高级 ) > 

Convert Archive ( 转换存 

档 )( 仅 File ( 文件 ) 菜单 ) 

是 

是 


Export ( 导出 )( 不在 

Audit ( 审核 ) 菜单的 

Advanced ( 高级 ) 下 ) 


Behavior ( 行为 )( 不在 

Audit ( 审核 ) 菜单上 ) 

Advanced ( 高级 ) > Item 

Access Rights ( 项访问权 

限 )( 不在 Audit ( 审核 ) 菜 

单上 ) 


Component Access Rights 

( 组件访问权限 )( 不在 



Customize( 自定义 )( 不在 


是 , 但不含有导出编码 

是 

是 

是 

是 

Select( 选择 )> All( 所有 ) 是是 

Select ( 选择 ) > By Query 是是 ( 不在 Audit ( 审核 ) 菜单上 ) 

( 按查询 ) 

Select ( 选择 ) > By Label 

( 按标签 )( 不在 Audit ( 审 

核 ) 菜单上 ) 

是 

是 

Expand All ( 全部展开 ) 是是 

Collapse All ( 全部折叠 ) 是是 

All Descendants( 所有后代 ) 是是 

Flag ( 标志 ) 是是 

Remove Flag ( 删除标志 ) 是是 


Find ( 查找 ) 是是 

Find Next ( 查找下一个 ) 是是 

Find Prev ( 查找前一个 ) 是是 

是 

是 

是 

是 

是 



Filters ( 筛选器 ) > Show 

Fields ( 显示字段 ) 

Filters( 筛选器 )> Sort and 

Group ( 排序和分组 ) 

Filters ( 筛选器 ) > Queries 

( 查询 ) 

Filters ( 筛选器 ) > Save 

Current Settings ( 保存当前 

设置 ) 

Filters ( 筛选器 ) > Reset 

Current Settings ( 重置当前 

设置 ) 

是 

是 

是 

是 

是 

Filters ( 筛选器 ) > Filters 是 

是 

( 筛选器 ) 

Reports ( 报告 ) 是是 , 但无 Print ( 打印 ) 按钮 

Charts ( 图表 ) > Simple 是 

否 

( 简单 ) 

Charts ( 图表 ) > 

是 

否 

Distribution ( 分布 ) 

Charts ( 图表 ) > 

是 

否 

Correlation ( 相关性 ) 

Charts ( 图表 ) > Time 是 

否 

Series ( 时间序列 ) 

Links ( 链接 ) > Create 是 

是 

( 创建 ) 

Links ( 链接 ) > Complete 是 

是 

( 完成 ) 

Links ( 链接 ) > Cancel 是 

是 

( 取消 ) 

Set Active Process Item ( 设是 

是 

置活动过程项 )( 不在 File 

( 文件 )、 Topic ( 主题 ) 或 


Clear Active Process Item 是 

是 

( 清除活动过程项 )( 不在 

File( 文件 )、Topic( 主题 ) 

或 Audit ( 审核 ) 菜单上 ) 

Clear Active Process Item 

( 清除活动过程项 )( 不在 

File( 文件 )、Topic( 主题 ) 

或 Audit ( 审核 ) 菜单上 ) 

是 

是 

Tools ( 工具 ) 菜单命令 Windows 客户机 Cross-Platform 客户机 

Personal Options ( 个人 

选项 ) 

是 , 但有一些差异 , 请参 

阅下面的 Personal 

Options ( 个人选项 )。 

Server Administration ( 服务是 

是 

器管理 ) 

Client Log ( 客户机日志 ) 是否 

Convert to Native Format 

( 转换为本地格式 ) 

是 

否 

Personal Options ( 个人选 

项 ):Workspace ( 工作 

区 ) 选项卡 

Windows 客户机 

Confirm delete ( 确认删除 ) 是是 

Confirm move/share ( 确认是 

是 

移动 / 共享 ) 

Confirm warnings ( 确认是 

是 

警告 ) 

Display toolbars ( 显示 

工具栏 ) 

是 

是 

是 

是 

是 

是 

是 

是 , 但有一些差异 , 请参阅下面的 

Personal Options ( 个人选项 )。 

Cross-Platform 客户机 



Display status bar ( 显示 

状态栏 ) 

Show times as UTC 

( 按 UTC 显示时间 ) 

Restore folder selection on 

tab change ( 选项卡更改时 

还原文件夹选择 ) 

Reset scope to local on 

folder change ( 文件夹更改 

时将范围重置为本地 ) 

Maintain group state on 

folder/scope change ( 文件 

夹 / 范围更改时维护组状态 ) 

Automatic refresh with 

max delay ( 以最大延迟 

自动刷新 ) 

Restore workspace at 

startup ( 启动时还原工 

作区 ) 

是 

是 

是 

是 

是 

是 

是 

Report output path ( 报告输是 

是 

出路径 ) 

Log output path ( 日志输是 

否 

出路径 ) 

Log errors ( 记录错误 ) 是否。 Cross-Platform 客户机基于 

个案记录错误。显示错误时 , 可保 

存有关它的日期。 

Log operations that take at 是 

否 

least( 记录至少执行的操作 ) 

Log MPX events ( 记录 

MPX 事件 ) 

是 

否 


项 ):StarTeamMPX 

Server 选项卡 


Enable MPX ( 启用 MPX) 是是 

Automatic refresh with 是 

是 

( 自动刷新 , 使用 ) 

Minimum delay ( 最小延迟 ) 是是 

Maximum delay( 最大延迟 ) 是是 


项 ):File ( 文件 ) 选项卡 

Use MD5 to calculate status 

( 使用 MD5 计算状态 ) 

Auto detect file changes 

( 自动检测文件更改 ) 

Use last modification time for 

checked-out files ( 为签出的 

文件使用最后修改时间 ) 

Optimize for slow connections 

( 慢速连接优化 ) 

Exclusively lock files on 

check-out ( 签出时独占锁定 

文件 ) 

Clear file locks on check-in 

( 签入时清除文件锁定 ) 

Use non-exclusive locks in 

integrations ( 在集成中使用 

非独占锁定 ) 

Mark unlocked working files 

read-only ( 将解除锁定的工 

作文件标记为只读 ) 


是 

是 

是 

是 

是 

是 

是 

是 

是 

是 

是 

是 

是 

是 

否 



是 

是 

是 

是 

是 

是 

是 

是 




项 ):File ( 文件 ) 选项卡 

Always context merge utility 

( 始终使用上下文合并实用 

程序 ) 

Context merge utility only for 

conflicts ( 上下文合并实用 

程序仅用于冲突 ) 

Central status repository 

( 中央状态储存库 ) 

Per folder status repository 

( 每个文件夹状态储存库 ) 

Central repository location 

( 中央储存库位置 ) 

Purge file status repository 

( 清除文件状态储存库 ) 

Alternate editor ( 备选编 

辑器 ) 

Alternate editor options 

( 备选编辑器选项 ) 

Alternate merge utility 

( 备选合并实用程序 ) 

Alternate merge utility 

options ( 备选合并实用程序 

选项 ) 

Alternate comparison utility 

( 备选比较实用程序 ) 

Alternate comparison utility 

options ( 备选比较实用程序 

选项 ) 

Set EOL conversion type 

( 设置 EOL 转换类型 ) 


是 

是 

是 

是 

是 

是 

是 

是 

是 

是 

是 

是 

否 , 实现方式不同。请参 

阅 Folder Properties 

( 文件夹属性 ) 


Personal Options ( 个人选 Windows 客户机 Cross-Platform 客户机 

项 ): 选项卡 

Mark as read options 是 

否 

( 标记为读选项 ) 

System tray notification 是 

是 

options ( 系统托盘通知选项 ) 

Locking options( 锁定选项 ) 是是 

Window ( 窗口 ) 菜单命令 Windows 客户机 Cross-Platform 客户机 

Cascade ( 层叠 ) 是是 

Tile Horizontally( 横向平铺 ) 是是 

Tile Vertically ( 纵向平铺 ) 是是 

Arrange Icons ( 排列图标 ) 是是 

Refresh ( 刷新 ) 是是 

Component Refresh ( 组件是 

是 

刷新 ) 

Component Refresh/ 是 

是 

Collapse ( 组件刷新 / 折叠 ) 

Foreign Refresh ( 外部 

刷新 ) 

是 

否 

Help ( 帮助 ) 菜单命令 Windows 客户机 Cross-Platform 客户机 

Help Topics ( 帮助主题 ) 是是 

About StarTeam ( 关于 

StarTeam) 

是 

是 

是 

是 

是 

是 

是 

是 

是 

是 

是 

是 

是 

是 

是 



Details ( 详细信息 ) 选项卡 Windows 客户机 Cross-Platform 客户机 

Displayed Properties ( 显示是 

是 

的属性 ) 

History ( 历史 ) 选项卡 Windows 客户机 Cross-Platform 客户机 

Item History List Displayed 是 

是 

( 显示的项历史列表 ) 

Check Out( 签出 )( 仅文件 ) 是是 

Check Out To ( 签出至 ) 是 

是 

( 仅文件 ) 



是 

属性 ) 


是 

容 )( 仅文件 ) 

View Revision Contents 是 

是 

( 查看修订内容 )( 仅文件 ) 

Open Revision Contents 是 

是 

( 打开修订内容 )( 仅文件 ) 

References ( 引用 ) 是是 

Edit Comment ( 编辑注释 ) 是是 

Label ( 标签 ) 选项卡 Windows 客户机 Cross-Platform 客户机 

Show Label Tree ( 显示是 

是 

标签树 ) 


Attach ( 附加 ) 是是 

Detach ( 分离 ) 是是 

Expand All ( 全部展开 ) 是是 

Collapse All ( 全部折叠 ) 是是 

Link ( 链接 ) 选项卡 Windows 客户机 Cross-Platform 客户机 

Item Links Displayed ( 显示是 

是 

的项链接 ) 

Item Properties ( 项属性 ) 是是 

Link Properties ( 链接属性 ) 是是 

Delete Link ( 删除链接 ) 是是 

Pin Link ( 固定链接 ) > 是 

是 

Source At Tip ( 最新源 ) 

Pin Link ( 固定链接 ) > 是 

是 

Target At Tip ( 最新目标 ) 

Pin Link ( 固定链接 ) > 

Source and Target At Tip 

( 最新源和目标 ) 

是 

是 

Float Link ( 浮动链接 ) > 

Source ( 源 ) 


Target ( 目标 ) 


Source and Target ( 源和 

目标 ) 

是 

是 

是 

Reference ( 引用 ) 选项卡 Windows 客户机 Cross-Platform 客户机 

Show Item Reference Tree 是 

是 

( 显示项引用树 ) 

Project ( 项目 ) 工具栏 Windows 客户机 Cross-Platform 客户机 

New Project ( 新建项目 ) 是是 

Open Project ( 打开项目 ) 是是 

Save View Shortcut ( 保存 

视图快捷方式 ) 

是 

是 

是 

是 

是 


工具栏 Windows 客户机 Cross-Platform 客户机 



是 

属性 ) 


是 

容 )( 仅文件 ) 

Add Files ( 添加文件 )( 仅是 

是 

文件 ) 

Check In ( 签入 )( 仅文件 ) 是是 

Check In and Unlock ( 签入是 

是 

并解除锁定 )( 仅文件 ) 

Check Out( 签出 )( 仅文件 ) 是是 

Check Out and Lock ( 签出是 

是 

并锁定 )( 仅文件 ) 

New ( 新建 )( 不是用于文是 

是 

件或审核条目 ) 

Add Work ( 添加工作 )( 仅是 

是 

任务 ) 

Send ( 发送 )( 不是用于是 

是 

文件 ) 

Lock ( 锁定 )( 不是用于审是 

是 

核条目 ) 

Unlock ( 解除锁定 )( 不是是 

是 

用于审核条目 ) 

Filter drop down ( 筛选器下是 

是 

拉列表 ) 

All Descendants( 所有后代 ) 是是 

List display ( 列表显示 ) 是 

是 

( 仅需求、任务和主题 ) 

Tree display ( 树显示 )( 仅是 

是 

需求、任务和主题 ) 

Link ( 链接 )( 不是用于审 

核条目 ) 

是 

是 

工具栏 Windows 客户机 Cross-Platform 客户机 

Set active process item 

( 设置活动过程项 )( 仅更 

改请求、需求和任务 ) 

是 

是 

* 设置 Executable ( 可执行 ) 复选框仅影响从 Cross-Platform 客户机执行的签入 / 签出操作。 


附录 

附录 B 

术语表 

All Descendants 

( 所有后代 ) 

在上部窗格顶部的按钮。它还是 File ( 文件 )、 Change Request ( 更改 

请求 )、 Task ( 任务 )、 Topic ( 主题 ) 和 Audit ( 审核 ) 菜单上的命令。 

选择此按钮时 , 视图窗口显示选定文件夹及其子文件夹的信息。否则 , 视 

图窗口只显示与文件夹 ( 而非与其子文件夹 ) 相关的项。 

ASCII 文件一种文本文件。 StarTeam 将不含空字符的文件识别为文本文件。 

build ( 生成 , 内部 

版本 ) 

按正确顺序编译、组合和链接所有项目文件以生成产品的过程 ( 生成 )。 

也指产品生命周期中的一个事件 , 代表项目进展过程中的一个可计量步骤 

( 内部版本 )。 

例如 , 某个软件产品每隔几天就能为测试此产品的团队成员交付一个新的 

内部版本。通过将内部版本标签应用于视图级的一组修订 , 可以确保在该 

内部版本中 , 该视图中的每个项有相同的标签。例如 , 通过这样 , 可以识 

别每个内部版本中有哪些产品源代码文件修订。 

版本控制版本控制是存储和跟踪对一个或多个文件的各项更改 ( 修订 ) 的过程。 

版本控制系统可保留在文件演变为最终形式的过程中产生的修订历史。 

使用自动版本控制系统的主要优点是快捷 , 易于调回以前的修订。 

StarTeam 也跟踪其它项的修订。 

版本控制系统用于帮助管理相同文件的多个修订的应用软件。 

保持当前锁定状态一个选项 , 若选择该项 , 则不能在当前操作中更改锁的状态 ( 独占、非 

独占或未锁定 )。 

备选工作文件夹通过创建备选工作文件夹 , 您可将该文件夹的工作文件存储在工作站的指 

定位置。通过为 StarTeam 视图的根或 StarTeam 文件夹层次中的分支创 

建备选工作文件夹 , 可以改变子文件夹的工作文件夹路径。 

变体视图请参阅分支视图。 

标签 

为一个或多个文件夹和 / 或项附加视图或修订标签的操作。请参阅内部版 

本标签、修订标签和视图标签。 

不在视图中文件状态。文件在工作文件夹中 , 但不在 StarTeam 视图中。您可能要将 

该文件添加到视图中。 

参考计数 

参考其它项的项列表。例如 , 同一台服务器上的两个项目视图 ( 甚至同 

一视图的各文件夹之间 ) 可共享一个文件 , 因此存在此文件的两个参考。 

参考视图 

一种派生自父视图的视图 , 通常与父视图使用不同的 StarTeam 文件夹作 

为根文件夹 , 但使用相同的工作文件夹。如果是浮动视图 , 它在父视图更 

改时会收到更新。如果它浮动但不只读 , 则它在发生变化时会向父视图发 

送更新。如果参考视图基于父视图内的特定标签或日期和时间 , 则它在该 

时刻被冻结并为只读。 

测试命令 

一条命令 , 通过它 , StarTeam 可按适当顺序执行自动测试步骤 , 以检测 

缺陷。 

附录 B: 术语表 365

术语表 

查询从许多项中选择部分项时使用的条件。可对上部窗格中的各项应用查询 , 

以便只显示感兴趣的项。 

重新配置按标签、提升状态或某个时间点的定义 , 可以将视图、文件、更改请求、 

主题或任务重新配置到过去的某个时刻。 

储存仓 

存储版本控制下的文件修订的位置。对于 StarTeam 6.0 和更早版本 , 使 

用 Native-I 储存仓。对于 StarTeam 2005 和更新版本 , 使用 Native-II 储 

存仓。要了解储存仓结构的差异 , 请参阅 StarTeam 安装指南和 

StarTeam 管理员指南。 

储存库 

存储配置单元、附件文件夹、日志文件等的位置 ; 与特定服务器配置相 

关联。 

储存库自定义一项 StarTeam Server 功能 , 允许您修改现有枚举字段的值和创建代表特 

定于您工作环境的信息的自定义字段。 

窗格 

StarTeam 客户机的项目视图窗口分为三个窗格。左窗格显示项目当前视 

图中的文件夹层次结构。上部窗格列出各项 , 而下部窗格则显示与从上部 

窗格选择的项对应的详细信息、历史或链接信息。 

次要排序 

已排序 ( 主要排序 ) 的列表中的排序项。例如 , 某个文件列表可能先按扩 

展名排序 , 然后 ( 在次要排序中 ) 在具有相同扩展名的组内按名称排序。 

从版本控制删除使某个项在当前视图中不可见并且不可访问。但关于该项的所有信息都保 

留在储存库中 , 如果是文件 , 则保留在存档中。 

如果需要再次访问它 , 可将文件夹或视图回滚至该项目曾存在的时间。 

存档 

一个或一组文件 , 可用于重新创建处于版本控制之下的某个文件的过去修 

订版。 

当前文件状态。工作文件夹中的文件内容与此文件的最新修订的内容相同。 

电子邮件 

一个有组织的系统 , 用于发送无纸 “ 电子 ” 消息 , 因其与邮件系统的相 

似性而得名。 StarTeam 为使用 MAPI 兼容的电子邮件系统的团队提供多 

种有利条件 ( 如邮寄项 )。 

冻结 

如果某个项在特定时刻基于父视图中其对应项的状态且不能被分支 , 则称 

它是冻结的 ( 也即为只读的 )。如果将某个项重新配置给特定标签、提升 

状态或过去的时间 , 则该项也是冻结的。 

独占锁 

一种锁 , 表明您正在编辑特定文件。其他人看到的图标是系有红色书带的 

一本书。而您看到的图标是一本打开的书。此锁可通知他人您要修订此文 

件。其他人不能签入您已独占锁定的文件。 

端点基于所用协议的服务器唯一标识符。端点为 TCP/IP 协议的端口号。 

对象 

面向对象编程及其它情况中使用的通用术语 , 指示可对其执行操作的某些 

事物。请参阅项。 

二进制文件任何在严格意义上不属于 ASCII 文本文件的文件。二进制文件包含机器码 

形式的程序或数据。例如 , 二进制文件及其各自文件扩展名包括可执行文 

件 (.exe 和 .dll)、字处理文档 (Windows 的 Word 中的 .doc)、电子表 

格 (Excel 中的 .xls)、对象文件 (.obj) 和位图文件 (.bmp)。 StarTeam 将 

任何不含空字符的文件识别为文本文件。所有其它文件都是二进制文件。 

访问权限 

一项安全功能。赋予 ( 或在某些例外情况下拒绝 ) 用户或组的权限 , 允 

许团队成员查看、修改、创建项目等等。 

非独占锁 

指示您正打算更改文件的一种锁。它通知其他有类似意愿的人在独占锁定 

文件并进行更改之前应告知您。非独占锁定某个文件时 , 其他人仍可签入 

此文件。 

对于文本文件 , 几个人同时修改文件并依靠 Visual Merge 管理更改是很 

正常的 ( 除非存在冲突 )。在此情况下 , 非独占锁有助于识别能够输入对 

解决冲突有用的信息的人。 

分支 

从父视图中对应项创建派生的独立项的过程。如果是文本文件 , 分支项以 

后可与其起源文件合并。例如 , 针对某个新操作系统的产品开发可能基于 

第一个操作系统的现有文件。另请参阅分支视图。 

也是一种树分支 , 如 StarTeam 文件夹层次或主题树。 

分支视图 

可能是 ( 或不是 ) 派生自父视图的视图。如果不是派生自父视图 , 它是 

一个空白分支视图。分支视图总是允许进行分支。如果它们是浮动的且设 

置了 Branch On Change ( 更改时分支 ) 选项 , 它们将由父视图逐个文件 

进行更新 , 直到文件在分支视图中发生更改。如果它们是浮动的但未设置 

Branch On Change ( 更改时分支 ) 选项 , 则在设置 Branch On Change 

( 更改时分支 ) 选项之前 , 更新始终被发送到父视图。如果它们基于某个 

标签、提升状态或某个时刻 , 则除非设置了 Branch On Change ( 更改时 

分支 ) 选项 , 否则它们是只读的。 


术语表 

分支修订 

修订号是 StarTeam 分配给项修订的标识号。它指示在视图中进行连续修 

订的次数 , 而且当项被分支到新视图时它将出现分支。例如 , 如果创建的 

某分支视图包含修订号为 1.9 的更改请求 , 则在此新视图中 , 该更改请求 

的下一个修订号可能将是 1.9.1.0。 

服务器为客户机提供服务的计算机或系统。客户机可能是其它计算机。 

服务器配置含有安装 StarTeam Server 时所选的储存库和选项设置。例如 , 管理员可 

能希望项目使用加密和压缩 , 可通过服务器配置指定这些功能。如果项目 

使用相同的服务器配置 , 即可共享 StarTeam 项 , 如文件夹和文件。可使 

用几个服务器配置中的任何一个启动服务器 , 但该配置将控制在该会话中 

可访问的项目等。 

浮动 

如果某个视图与其父视图保持同步 , 则称该视图是浮动的。这意味着 , 来 

自父视图的更新将被传送到子视图。如果该子项不是只读 , 则来自子项的 

更新也可转至其父项。 

个人选项 

可由用户选择的选项 , 决定着在特定工作站上 StarTeam 针对当前登录的 

用户所表现的行为。 

根文件夹 

StarTeam 文件夹层次中最顶端的文件夹。项目的根视图中的根文件夹通 

常与该视图和项目具有相同的名称。 

更改请求号首次提交更改请求时 , StarTeam 分配给该请求的号码。 

更改请求列表更改请求的列表 , 与从 StarTeam 文件夹层次所做的选择相关 , 它在选择 

Change Request ( 更改请求 ) 选项卡时显示。此列表可通过选择 All 

Descendants ( 所有后代 ) 按钮和筛选器进一步细化。 

工作文件 

工作文件夹中的任何文件都可视为工作文件。您经常会签出文件来进行修 

改。签入时 , 工作文件变为修订。签入时 , 工作文件变为修订。 

工作文件夹每个 StarTeam 文件夹都有一个对应的工作文件夹 , 可将文件的工作副 

本签出至此文件夹 , 也可从此文件夹将文件添加和签入至 StarTeam 文 

件夹。 

关键字 

以美元符号 ($) 开始和结尾的保留字。用在文本文件中时 , StarTeam 用 

关键字所代表的数据替换它们。例如 , 用签入文件的用户名替换 

$Author$。 

关键字扩展一项技术 , 用于在以相应数据替换关键字的文本文件中插入信息。例如 , 

用签入文件的用户名替换 $Author$。 

管理员 

StarTeam 操作中的一个功能性角色。管理员可创建和 / 或导入项目、管 

理服务器配置、管理用户和组等等。 

过期 

文件状态。工作文件是该文件的旧修订的副本。如果需要当前修订 , 应将 

其签出。 

合并 

一种文件状态 , 表明工作文件不是基于其最新修订。签入或签出此文件 

时 , StarTeam 会询问是否要将其与最新修订合并。 

合并 

将工作文件与其最新修订组合或将已分支的文件与分支前的原始文件组合 

的过程。这是一种三向的比较 , 两个文件都要与作为其最新的共同祖先的 

文件修订进行比较。签入合并的文件前 , 用户可对其进行检查或修订。 

加标签的配置新视图或重新配置的视图的基础。此视图只包含带指定标签的项。如果新 

视图或重新配置的视图的父视图未定义标签 , 则禁用此选项。 

加密 

可将在工作站和服务器之间传输的数据加密。加密可防止未授权方通过不 

安全的网络线路读取文件和其它项目信息。 

解除锁定释放锁定文件的过程 , 表明不再更改该文件或不再打算更改它。 

解决方法 

为避免产品的缺陷而需执行的步骤。在解决缺陷更改请求的修订可用之 

前 , 将频繁提供解决方法。 

空白分支视图空的分支视图。它与父视图无关联。 

快捷方式 

用于启动另一个应用程序的文件 , 通常包含特定的文档或数据集。快捷方 

式通常存储为桌面上的图标。为实现快速访问 , 可将快捷方式保存到 

StarTeam 项目视图、 View Comparison ( 视图比较 ) 窗口和单个项 ( 除 

文件和审核条目之外 )。 

里程碑 

在产品生命周期中选择的代表进展过程中的重要步骤的事件 , 例如 , 产 

品的 Alpha 版、 Beta 版或最终版。在 StarTeam 中 , 达到某个里程碑 

时 , 可以应用一个视图标签 , 通常是一个内部版本标签 , 以表明已达到 

该里程碑。 

在 Microsoft Project 中 , 里程碑是一种任务类型 , 可代表预定项目的生命 

周期中的重要标志、发展或转折点。通常可通过输入任务名并为其分配零 

持续时间来定义里程碑。里程碑通常象征着工作已开始或结束 , 它们不代 

表工作过程。 


术语表 

历史列表 

从视图窗口上部窗格的列表中选择的项目的修订列表。在视图窗口下部窗 

格中选择 History ( 历史 ) 选项卡时 , StarTeam 显示此列表。 

列标题 

显示在项目视图窗口上部窗格中的列的标签或名称。单击列标题可按该列 

中的值启动排序操作。每个列标题都是列表中项的属性名。 

MAPI 

“ 邮件应用程序编程接口 ” 的缩写。一种编程接口 , 它可允许应用程序通 

过 Microsoft Mail 消息传递系统收发电子邮件。 StarTeam 使用 SMTP 而 

不使用 MAPI。 

命令行文件比较两个文件或修订时 , StarTeam 将含有相应选项的命令行文件发送至 

Visual Diff。合并两个文件时 , 将相似文件发送至 Visual Merge。如果没 

有用于此文件的空间或者没有用来创建此文件的临时文件夹 , 则将显示错 

误消息。 

内部版本标签创建视图标签时 , 可将其指定为内部版本标签。内部版本标签将新解决的 

更改请求的 Addressed In ( 解决请求的内部版本 ) 字段设置从 Next Build 

( 下一个内部版本 ) 更改为内部版本标签。这可以让测试者知道可通过安 

装该内部版本来测试已解决的更改请求。 

排序或主要排序在项目视图窗口的上部窗格中根据某列的值以升序或降序排列项。根据列 

中的值 , 可按数字、字母数字、内部顺序或键值对值排序。单击列标题一 

次即可排序。再次单击可将排序顺序从升序更改为降序 , 反之亦然。要按 

值对已排序的项分组 , 请使用 Sort and Group ( 排序和分组 ) 对话框。 

配置部件或元素的相对排列。 StarTeam 有视图、文件夹、项和服务器配置。 

视图、文件夹或项配置是该视图、文件夹或项对于基于某个时间点的特殊 

修订的隔离。例如 , 可以将视图配置为 : 

■ 当前 ( 可以在视图中始终看到每个文件夹和项的最新修订 )。 

■ 视图标签 ( 可以在视图中看到所有分配有选定标签的修订 )。开始时 

视图标签代表某时间点 , 虽然可以将标签调整为包括该时间点的非当 

前修订 , 而排除当前修订。 

■ 提升状态 ( 可以在视图中看到所有分配有当前与选定提升状态相关联 

的标签的修订 )。 

■ 任何选定的日期和时间 ( 可以在视图中看到特定日期和时间的所有当 

前修订 )。 

也可以配置单个文件夹和项。另请参阅服务器配置。 

配置文件 

应用于视图的一组限制条件。配置文件指定哪些文件夹是可以看到的、对 

于那些文件夹应用哪些 EOL 及路径大小写区分设置。例如 , 如果要从同 

一视图构建某产品的 UNIX 版本和 Windows 版本 , 则每个版本都需要一 

个配置文件。 

每个视图最初都有默认的配置文件 , 但也可用默认设置或基于以前的配置 

文件创建新的配置文件。 

对某个文件夹的可见性、 EOL 和路径大小写区分设置所作的任何更改都 

将自动成为当前所选配置文件的一部分。 

签出 

一项操作 , 将文件的修订从 StarTeam 存档复制到某个团队成员的工作文 

件夹。不管打不打算更改文件 , 团队成员都可以将文件签出。 StarTeam 

一次只允许一个团队成员修订一个项目文件 , 允许多个人使用一组公用文 

件。锁定文件标志着一个作者修订的开始。 

签入 

一项操作 , 将新文件修订存储为 StarTeam 中的存档文件和储存库中关于 

该文件的数据。 

StarTeam 一次只允许一个团队成员修订一个项目文件 , 允许多个人使用 

一组公用文件。签入标志着一个修订的结束。签入此文件的团队成员可使 

它保持锁定 , 或者通过解锁将其释放给其他人。 

缺失文件状态。文件不在您的工作文件夹中。您可能要签出该文件。 

缺陷产品中的故障或错误。 

缺陷跟踪记录有关更改请求的信息并保留检测和最终解决方案历史的系统方法。 

任务组件 

用户可使用 StarTeam 创建、跟踪和解决与项目相关的任务。此组件也可 

与 Microsoft Project 交互操作。 

容器 

此术语用于指示包含其它类型的项的能力。例如 , 项目是视图、文件夹和 

其它项的容器。视图和文件夹也是容器。 

SMTP 

“ 简单邮件传输协议 ”, 通常用于 Internet 和 UNIX 邮件系统。它通常使 

用端口 25。在 StarTeam 中通过电子邮件发送项时需要 SMTP。 


术语表 

StarDisk 

StarDisk 是一个虚拟文件系统 , 可使您使用常规的 Windows 应用程序 

( 如 Windows 资源管理器、 Microsoft Word for Windows 和 Microsoft 

Developer Studio) 访问和管理位于版本控制下的文件。使用 StarDisk 

将 StarTeam 视图映射到虚拟驱动器。然后可从资源管理器或其它应用 

程序访问该驱动器上的任何文件。如果该文件尚未签出 , StarDisk 可将 

其签出。 

StarTeam 文件 StarTeam 版本控制下的文件 ; 也即 StarTeam 项目中的文件。 

StarTeam 文件夹 


层次 

筛选器 

StarTeam 文件夹层次中的一个文件夹。StarTeam 文件夹有助于将项目视 

图组织为独立的、易懂的部分。例如 , 软件产品的项目可以有 SourceCode 

( 源代码 )、User Manuals( 用户手册 ) 和 Corporate Libraries( 公司库 ) 

文件夹。每个文件夹在硬盘驱动器上都对应的工作文件夹。 StarTeam 文 

件夹可能有子文件夹。可能有与之相关的项 , 如文件。 

与 StarTeam 项目视图相关的文件夹层次。 

从许多项中选择部分项时使用的条件。使用视图窗口中的 Filter ( 筛选 

器 ) 下拉列表可只显示您感兴趣的项。应用筛选器也可控制显示哪些列、 

对哪些列排序以及在排序的列中如何将值分组。 

删除从 StarTeam 数据库删除信息。可以删除 : 

■ 项目中的项。 

将视图或父文件夹回滚至删除前的时间则可以再次看到它们。 

■ 工作文件。删除这些文件时 , 它们便会消失。如果工作文件在删除之 

前被签出且没有更改、添加和 / 或签入 , 则不丢失任何数据。 

删除项时要小心。 

上下文菜单在项目视图窗口中右键单击某个区域时显示的菜单。菜单内容因上下文 

( 即单击的项目或区域 ) 而异。 

审核日志 

由 StarTeam 保留的按时间顺序排列的记录 , 可显示对 StarTeam 文件夹 

和项执行的所有操作。 

审核条目 

对 StarTeam 项目执行的操作的记录 , 显示在审核日志中。例如 , 每次将 

文件添加到项目视图中时 , 该操作即被输入到审核日志中。 

时间戳由 StarTeam 维护的有关文件和修订的信息。 

事件通知 

视图 

视图标签 

■ 对于文件修订 : 指将文件签入 StarTeam 的日期和时间。 

■ 对于文件 : 指工作文件的日期和时间。 

如果使用系统托盘通知 , StarTeam 将在需要阅读某个项时 , 通过在系统 

托盘中显示相应图标的方式通知您。如果您的服务器设置了电子邮件通 

知 , 您会收到关于您负责的项等内容的电子邮件通知。 

由 StarTeam 文件夹层次、与该层次中的每个文件夹相关的项、视图属性 

和视图访问权限组成。 

视图的行为可以允许 ( 或不允许 ) 分支 , 可以是 ( 或不是 ) 只读的 , 也 

可以有 ( 或没有 ) 与其父视图的连接。 

视图标签的主要用途是为视图的整个内容加上 “ 时间戳 ”。然后可将视图 

回滚至该标签 , 查看在该时间点存在的一切。但只有当视图标签未冻结 

时 , 才能进行一些调整。可通过附加或分离视图标签来在视图标签中包括 

或排除某些文件夹和项。也可以将视图标签从一个修订移动至另一个修 

订。例如 , 在创建标签前有几个文件可能尚未签入 , 但需要将它们也包括 

在内。 

创建视图标签时 , 它们会自动、立即附加到视图中的所有文件夹和项。 

视图窗口 

StarTeam 用来显示打开的视图的窗口。也称项目视图窗口。它包含三个 

窗格。左窗格显示 StarTeam 文件夹层次。上部窗格显示与从 StarTeam 

文件夹层次中选择的文件夹相关的项。下部窗格显示从上部窗格选择的项 

的详细信息、历史和链接。 

属性在版本控制下为每个项 ( 及某个项的每个修订 ) 存储的属性。 

数值由有效数字 0-9 组成的数值。 


术语表 

刷新更新项目视图窗口或其上部窗格中的信息。 

■ 按下 F5 键为当前项刷新右上窗格。 

■ 按下 Ctrl+F5 可刷新上部窗格 , 同时折叠所有打开的组。 

■ 按下 Shift + F5 可刷新整个视图 ( 包括所有选项卡和文件夹层次中的所 

有项列表 )。 

■ 按下 F6 键可从外部存档 ( 如 Visual SourceSafe 或 PVCS) 刷新文 

件。在按 F6 键之前 , 务必启用 All Descendants ( 所有后代 ) 按钮 

( 或从 File ( 文件 ) 菜单选择 All Descendants ( 所有后代 )), 这样 

刷新可在所有子文件夹中进行递归。 

锁定 

文件锁定是一种通知其他人您正在修订某个文件 ( 参见独占锁 ) 或正打 

算修订它 ( 非独占锁 ) 的技术。 

签入和签出文件并不意味着在 StarTeam 中会自动锁定。您可在签入或签 

出过程中手动锁定或解锁某个文件。但也可使用 Lock/Unlock ( 锁定 / 解 

除锁定 ) 对话框锁定或解锁文件。可以覆盖和中断锁定。 

根据个人选项 , 可以将解锁的文件标记为只读 , 从而防止也可由其他人锁 

定的文件被更改。 

所有者由 StarTeam 存储的、有关对某个项执行了某些初始操作的用户的信息。 

■ 对于文件 : 指将文件添加到项目视图的用户。 

■ 对于修订 : 指签入此修订的用户。 

■ 对于更改请求 : 指提交更改请求的用户。 

■ 对于主题或响应 : 指编写主题或响应的用户。 

■ 对于需求或任务 : 指创建任务的用户。 

TCP/IP Internet 用来在计算机之间通信的协议。“ 传输控制协议 /Internet 协议 ” 

的缩写。 

提升模型 

StarTeam 提供一种支持实体关系建模的面向对象的结构。借助 

StarTeam, 您可以在项目的不同阶段之间移动 ( 或提升 ) 更改 , 例如从 

开发到测试再到产品发布等等。开发者在独立于其它开发工作的提升状态 

下处理代码更改。 

提升状态 

产品所经历的状态。例如 , 经历开发、测试和发布周期的软件应用程序可 

使用 Development ( 开发 )、 Test ( 测试 ) 和 Release ( 发布 ) 三种提 

升状态。在 StarTeam 中 , 每个提升状态都分配有一个视图标签。视图标 

签随时间变化 , 但以始终在 Test ( 测试 ) 状态中工作的测试者为例 , 他 

们可以忽略当前分配给该状态的标签。 

提升状态配置新视图或重新配置的视图的基础。此视图只包含具有您指定的提升状态 

的项。如果新视图或重新配置的视图的父视图未定义提升状态 , 则禁用 

此选项。 

添加文件通过将文件添加至 StarTeam 项目视图而使它们处于版本控制之下的过程。 

团队成员任何项目用户。有时用于表示不具有管理员状态的用户。 

Visual Diff 

StarTeam 实用程序 , 可将两个文本文件或一个文本文件的两个修订进行 

比较 , 并显示两者之间的差异 ( 如果有 )。 

Visual Merge StarTeam 实用程序 , 可帮助将某文件的基于相同签入修订的两个修订合 

并。它执行三向的比较 , 将两个修订彼此比较并将它们与其共同祖先进行 

比较。 

外部刷新 

按下 F6 键可在视图窗口中更新 PVCS 或 SourceSafe 项目 ( 正在通过 

StarTeam 与其进行通信 ) 的信息。 

完整修订存储一种可完整保存文件的所有修订的存储方式。在 StarTeam 6.0 和更早版 

本中 , 选择完整修订存储可减少重新构建在存档文件中以增量格式存储的 

复杂二进制文件所必需的处理时间。在 StarTeam 2005 及更新版本中 , 

所有存档文件均被完整存储 , 尽管有些可能会被压缩。请参阅增量存储。 

未知 

文件状态。工作文件夹内的文件与视图内的一个文件的名称相同 , 但是该 

文件并未从储存库中签出。您可能已从其它位置复制了该文件。使用 

Update Status ( 更新状态 ) 可确定正确的状态。 

文本文件或 ASCII 

文件 

一种文件 , 只含有可打印的文本字符、空格、回车符 , 有时含有制表符和 

文件结尾标记 , 但不含有任何格式代码。 

StarTeam 将任何不含空字符的文件视为文本文件。所有其它文件都是二 

进制文件。 

文件夹请参阅 StarTeam 文件夹、文件夹层次和工作文件夹。 

文件夹层次 StarTeam 视图及其相关文件夹的层次显示。文件夹层次总是显示在视图 

窗口的左窗格中。 


术语表 

文件压缩 

一种通过从文件删除冗余信息来缩小文件的技术。大多数磁盘文件都含有 

重复的常用字符序列。压缩算法可删除多余的这些序列 , 并保存用于恢复 

被删除序列的信息。 

线索化对话对所发布的主题的一系列响应。每个对话构成一个主题树 , 该主题是树的 

根。之所有称之为线索化对话 , 是因为该树层次指示究竟哪一个响应是该 

主题的答复 , 所以称它为线程对话。通过在线索中逐个读取每个响应 , 可 

以看到该讨论是如何演化的。 

响应 

一个主题的多个答复中的任何一个 , 这些答复 ( 与主题一起 ) 可形成称 

为主题树的层次结构。 

项 StarTeam 对象或元素。项包括项目、视图、文件夹、文件、更改请求、 

需求、任务、主题及审核条目。 

项目 

相关视图 ( 每个视图通常都代表 StarTeam 版本控制下某个产品的一个版 

本 )、项目属性和项目访问权限的集合。 

协议控制如何完成任务的一组规则。网络协议控制数据在网络上的传输方式。 

修订修订某个项 ( 如更改请求 ) 时 , 每组更改都被保存为一个修订。 

修订标签 

修订标签提供了一种按名称识别某个项的修订或一组修订的方便方法。它 

主要用于文件。例如 , 签入一组需要一起签出的文件时 , 可以为它们分配 

一个修订标签。 

修订号 

修订号是 StarTeam 分配给项修订的标识号。它指示出该项自最初创建以 

来进行连续修订的次数 ( 可能在不同视图中 )。 

需求组件 

StarTeam 使用户可创建、跟踪和完成与项目相关的需求。此组件还从 

CaliberRM 导入需求。 

压缩 

可以压缩在工作站和服务器之间传输的数据。数据压缩可减少网络上的通 

信量。但压缩和解压缩数据将增加传输时间。 

已修复的更改请求更改请求的标志 , 指示此请求已得到解决。 

已修改文件状态。工作文件已经更改 , 并且是基于此文件的最新修订而更改的。 

您可能要签入此文件。 

用户有权访问服务器配置和项目 ( 通过 StarTeam Server 进行管理 ) 的个人。 

通常 , 该访问受密码保护。用户也称为团队成员。 

增量存储 

计算某个文件的各个渐进式修订之间的差异的方式。在 StarTeam 6.0 和 

更早版本中 , StarTeam 可在存档文件中存储文本文件的第一个完整修 

订 , 以及更新修订的一组正向增量。StarTeam 2005 中没有此增量存储功 

能。在 StarTeam 6.0 和更早版本中 , 增量也可用于优化慢速连接 ( 如果 

用户选择了该选项 )。StarTeam Server 2005 及更新版本继续沿用这一功 

能 , 但将这些增量存储在每个配置单元的 Delta 文件夹中 , 此文件夹为每 

个配置单元的高速缓存路径的子文件夹。另请参阅完整修订存储。 

只读参考视图一种参考视图 , 虽然在更新父视图时可以修改它 , 但不能从其自身对其进 

行修改。如果是浮动的 , 则可更新。如果是基于标签 ( 或提升状态 ) 和 

带有指定标签更改的项 , 则只读参考视图将反映这些项。如果是基于特定 

日期和时间 , 它将被冻结为父视图在该时间点的副本。 

主题 

附加在 StarTeam 文件夹层次中某个文件夹上关于特定主题的第一个消 

息。某个团队成员提交主题后 , 其他人可对其作出响应 , 从而创建一个主 

题树。 

主题树 

许多种可能的层次结构中的一种 , 选择 Topic ( 主题 ) 选项卡和 Tree 

Display ( 树显示 ) 按钮时 , 它显示在项目视图窗口中。其根是一个主 

题 , 其分支由该主题的响应组成。主题树代表线索化对话。 

状态文件状态是工作文件和储存库中的最新修订之间的关系。文件状态包括 : 

In View ( 在视图中 )、 Not in View ( 不在视图中 )、 Missing ( 缺失 )、 

Current ( 当前 )、 Merge ( 合并 )、 Modified ( 已修改 )、 Out of Date 

( 过期 ) 和 Unknown ( 未知 )。有关状态的介绍 , 请参阅第 148 页的 

“ 确定文件状态 ” 和第 159 页的 “ 了解状态对签入和签出的影响 ”。 

字母数字由 A-Z 的字母和 0-9 的数字组成的值。 

自动刷新 

组件 

StarTeam 的自动更新功能。由于各团队成员总在不断修订由 StarTeam 

管理的项目、文件夹和项 , 因此屏幕信息在首次显示之后可能会过时。自 

动刷新功能定期读取项目数据库 , 以更改显示的信息。 

本手册将 StarTeam 部件称作组件。例如 , 它可以指 File ( 文件 ) 组件或 

Change Request ( 更改请求 ) 组件。由组件管理的文件、更改请求等称 

为项。 


术语表 

最新修订某个项 ( 如文件或更改请求 ) 的最新修订。最新修订基于视图的配置。 

例如 , 如果将视图配置给某个特殊标签 , 最新修订则是带有该标签的修 

订。如果将视图配置给特殊日期和时间 , 最新修订则是恰好在此时间点之 

前签入的修订。 

作者创建修订的人。 


索引 

符号 

$Author$ 关键字 164 

$Date$ 关键字 164 

$Folder$ 关键字 165 

$Header$ 关键字 164 

$Id$ 关键字 164 

$Locker$ 关键字 164 

$Log$ 关键字 165 

$NoKeywords$ 关键字 165 

$Project$ 关键字 165 

$Revision$ 关键字 165 

$Workfile$ 关键字 165 

.sbas 

文件状态 313 

? 

命令行选项 323 

A 

About 命令 (StarTeam Toolbar) 36, 37 

active 

命令行选项 327, 334 

Actual Finish 任务字段 107 

Actual Hours 任务字段 107 

Actual Start 任务字段 107 

add 

命令 , 在 DOS 提示符 327 

Add Tool 命令 (StarTeam Toolbar) 36 

add-folder 


add-project 


Addressed By 更改请求字段 93 

Addressed In 更改请求字段 93 

Addressed In View 更改请求字段 93 

add-view 


All Descendants 按钮 

定义 365 

all descendants 按钮 149 

Am I Recipient? 主题字段 114 

Am I Responsible? 需求字段 100 

am 选项 

Visual Merge 129 

Ambiguities Found 需求字段 101 

amt 选项 


AND 操作 71 

apply-label 


Archive Path 文件字段 84 

Archive Type 文件字段 84 

ASCII 文件 

比较 125 

定义 365, 370 

合并 125 

at 选项 


Attachment Count 更改请求字段 93 

Attachment Count 任务字段 107 

Attachment Count 需求字段 101 

Attachment Count 主题字段 115 

Attachment IDs 更改请求字段 93 

Attachment IDs 任务字段 107 

Attachment IDs 需求字段 101 

Attachment IDs 主题字段 115 

Attachment Names 更改请求字段 93 

Attachment Names 任务字段 107 

Attachment Names 需求字段 101 

Attachment Names 主题字段 115 

Attention Notes 任务字段 107 

Audit Trail 选项卡 220 

Auto 

StarTeamMPX Server 状态 318 

autoLogon 

bco 命令选项 352 

按钮 

图表工具栏 301 

按状态和责任 

更改请求 185 

B 

b 

命令行选项 339, 342 

ba 


bco 命令 

autoLogon 选项 352 

包含文件夹 354 

包含子文件夹 354 

cfgd 选项 352 

cfgl 选项 352 

cfgp 选项 352 

cmp 选项 352 

dryrun 352 

encrypt 选项 352 

eol 选项 353 

fs 选项 354 

覆盖视图的工作文件夹 355 

覆盖特定文件夹的工作文件夹 354 

h 选项 354 

help 选项 354 

is 选项 354 

卷统计信息 355 

密码文件 355 

netmon 选项 354 

o 选项 354 

p 选项 355 

pwdfile 选项 355 

签出文件 , 而不管状态如何 354 

强制签出 354 

ro 选项 355 

rp 选项 354, 355 

SDK NetMonitor 信息 354 

筛选器选项 354 

时间戳 356 

时间统计信息 355 

视图配置标签名称 352 

视图配置截止日期 352 

视图配置状态 352 

使用 Cache Agent 356 

使用 StarTeam 工具栏 352 

t 选项 355 

ts 选项 356 

索引 373

vb 选项 356 

useCA 选项 356 

文件夹选项 355 

文件说明 353 


详细的 356 

行尾转换 353 

预览 352 

只读文件 355 

另请参阅 bco 命令 

bn 


Bpvcs 


Branch On Change 更改请求字段 93 

Branch On Change 文件字段 85 

Branch State 更改请求字段 94 

Branch State 文件字段 85 

break 


批量签出实用程序 

版本 

按标签分组 146 

比较 125 

非永久存储 146 

管理 145 

合并 145 

可用报告 285 

永久存储 146 

在 Visual Diff 中的顺序 140 

版本标签 

请参阅修订标签。 

版本号 

请参阅修订号。 

版本控制 

定义 365 

概述 14 

版本控制系统 

定义 365 

版权声明 

在命令行隐含 325 

帮助 

StarTeam Toolbar 46 

状态栏 13 

保持当前锁定状态 

定义 365 

保存 

快捷方式 25 

任务附件 208 

图表 301 

报告 

表 291 

创建 281 

打印 283 

导出数据 , 以在其它应用程序中使用 283 

定义数据 281 


可用 285 

命令行 326 

模板 290 

输出路径 308 

数据库名 291 

显示字段名 291 

备选工作文件夹 28 

定义 365 

比较 

版本 125 

更改请求属性 233 

更改请求修订 233 

客户机 357 

两个工作文件 161 

任务属性 233 

任务修订 233 

三向 125 

双向差异 125 

Visual Diff 和 Visual Merge 125 

文件 125, 160 

文件属性 233 

文件修订 160 

文件 , 在命令行 339 

修订 125, 160 

修订和工作文件 160, 161 

颜色代码 140 

主题属性 233 

主题修订 233 

比较实用程序 

默认 314 

编辑 

报告模板 287 

查询 77 

储存库自定义 168 

任务中的工作记录 205 

筛选器 81 

图表 303 

图表标题 302, 305 

图表标题文本 302 

图表图例 304 

文件 152, 156 

文件的修订注释 235 

编辑器 

默认 314 

编码 

文件 131, 138 

变体视图 

请参阅分支视图。 365 

表 

报告 291 

标记 


任务 239 

主题 239 

标签 

不可重复使用 146 

创建 249, 251 

创建修订标签并附加到文件夹修订 255 

创建修订标签并附加到项修订 257 

从视图中删除 254 

从文件夹分离 256 

从一个文件夹修订移动到另一个 255 

从一个项修订移动到另一个 257 

冻结和解冻 253 

冻结 ( 在命令行 ) 342 

访问权限 260 

分离 259 

附加 258 

附加到文件夹 256 

复制视图标签 250 

复制修订标签 252 

概述 247 


基于提升状态 ( 在命令行 ) 343 


将版本分组 146 

截止日期 ( 在命令行 ) 342 

Label 选项卡 11 

里程碑 146 


命令行 328, 333, 334, 335, 338, 340, 342 

内部版本 146 

任务 247 

属性 254 

文件 247 

文件夹 247 

选择 260 

已复制 ( 在命令行 ) 343 

在分支视图中 225 

在命令行应用 333 

主题 247 

标签树 10 

标题 

编辑图表 302, 305 

标志 213 

创建 240 


任务 240 

删除 240 

文件 240 

项 240 

主题 240 

饼图 

分离 306 

布尔型 

关系运算符 83 

不分级 203 

不在视图中 

定义 365 


C 

c 


Cache Agent 

使用 bco 命令 356 

CaliberRM 

导入需求自 176 

需求 177 

CaliberRM Import DocFactory 

配置 176 

Category 更改请求字段 94 

cfgd 


命令行选项 332, 336, 338, 339, 341, 344, 345, 346, 

349 

cfgl 


命令行选项 332, 336, 338, 339, 341, 344, 345, 346, 

349 

cfgp 

bco 命令 352 

命令行选项 332, 336, 338, 339, 342, 344, 346, 349 

Children Count 任务字段 107 

Children Count 需求字段 101 

Children Count 主题字段 115 

ChildType 需求字段 101 

ci 


Class Name 1 审核日志字段 119 



Closed 

任务状态 202 

Closed On 更改请求字段 94 

cmp 



co 


Comment 更改请求字段 94 

Comment 任务字段 108 

Comment 文件字段 85 

Comment 需求字段 101 

Comment 主题字段 115 

CommentID 更改请求字段 94 

CommentID 任务字段 108 

CommentID 文件字段 85 

CommentID 需求字段 101 

CommentID 主题字段 115 

Comments 需求字段 101 

Component 更改请求字段 94 

Compression Level 文件字段 85 

Configuration Time 更改请求字段 94 

Configuration Time 任务字段 108 

Configuration Time 文件字段 86 

Configuration Time 需求字段 102 

Configuration Time 主题字段 115 

Constraint Date 任务字段 108 

Constraint Type 任务字段 108 

Content 294 

Content Revision 文件字段 86 

Content 主题字段 115 

cr 

命令行选项 327, 334 

CR Number 更改请求字段 95 

Created By 

需求列表中的列 170 

Created By 更改请求字段 95 

Created By 任务字段 108 

Created By 审核日志字段 119 

Created By 文件字段 86 

Created By 需求字段 102 

Created By 主题字段 115 

Created Time 


Created Time 更改请求字段 95 

Created Time 任务字段 108 

Created Time 审核日志字段 120 

Created Time 文件字段 86 

Created Time 需求字段 102 

Created Time 主题字段 116 


与 Windows 客户机比较 357 

Current ( 当前 ) 


菜单 


任务 198 

审核日志 220 

状态栏中的帮助 13 

菜单命令 

Visual Diff 137 

菜单选择约定 2 

参考计数 

定义 365 

索引 375

参考视图 

定义 365 

操作 

文件夹 223 

项 223 

操作系统 

StarTeam 控制下的非 Windows 文件 63 

测试 


测试命令 

定义 365 

更改请求列表中的列 184 

插入的文本颜色 130, 140 

查看 

标签属性 254 

高速缓存的服务器 / 用户关联 38 


过程项链接 245 

链接的项的属性 267 

链接属性 267 


图表 301, 305 


项引用 270 

主题引用 217 

查询 

编辑 77 

创建 71 

定义 366 


复制 77 

删除 78 

使用 71 

选择 71 

应用于上部窗格 70 

状态栏信息 13 

查找 

比较文件中的差异 132, 140 

比较文件中的匹配 132, 140 

比较文件中的文本 132, 140 

更改请求基于字段内容 235 

任务基于字段内容 235 

审核条目基于字段内容 235 

文件基于字段内容 235 

主题基于字段内容 235 

拆分条 139 

差异 132, 140 



颜色代码 140 

请参阅比较。 

在命令行 339 

在命令行抑制 340 

产品支持 1 

程序快捷方式 

重命名 44 

删除 45 

为 StarTeam Toolbar 创建 42 

为 StarTeam Toolbar 复制 43 

修改属性 43 

冲突 


重开 


重命名程序快捷方式 44 

重新配置 

定义 366 


任务 230 

视图 26 

文件 230 

文件夹 230 

主题 230 

重置 

筛选器 82 

储存仓 

定义 366 

储存库 

定义 366 

文件状态 27, 312 

储存库自定义 

定义 366 

初始引用 272 

传输 

数据 25 

窗格 

定义 366 

刷新 10 

创建 

报告 281 

标签 , 在命令行 342 

查询 71 

从头开始创建的筛选器 79 


工作文件夹 56 

简单图表 297 

任务 200 

任务的工作记录 205 

视图标签 249 

使用当前设置的筛选器 79 

条件 73, 75 

图表 293 

文件夹 59 

文件夹结构 56 

响应 217 

修订标签 251 

需求 173 

主题 215 

创建时间 


链接列表列 264 

创建者 



窗口 

刷新 10 

图表 301 

Visual Diff 136, 139 

Visual Merge 130, 134 

窗口 (StarTeam Toolbar) 36 

垂直 

图表网格 302 

次要排序 

定义 366 

粗体 


任务 199 

需求 172 

粗体约定 2 

存储 

版本 146 


存档 

定义 366 

错误 

停止命令行执行 326 

错误消息 

命令行 326 

D 

d 

命令行选项 328, 329, 330, 332, 341, 342 

Delete Tool 命令 (StarTeam Toolbar) 36 

Deleted By 更改请求字段 95 

Deleted By 任务字段 108 

Deleted By 审核日志字段 120 

Deleted By 文件字段 86 

Deleted By 需求字段 102 

Deleted By 主题字段 116 

Deleted Time 更改请求字段 95 

Deleted Time 任务字段 109 

Deleted Time 审核日志字段 120 

Deleted Time 文件字段 86 

Deleted Time 需求字段 102 

Deleted Time 主题字段 116 

delete-local 


Description 


Description 更改请求字段 95 

Description 文件字段 86 

Description 需求字段 102 

Detail 选项卡 


任务 197 

说明 10 

文件 147, 220 

需求 173 

主题 212 

df 


diff 


Disabled 需求字段 102 

打开 

更改请求 188, 190 

StarTeam Toolbar 窗口 34 

文件 151 

项目 23 

DOS 提示符 

StarTeam 的命令 321 

Dot Notation 更改请求字段 95 

Dot Notation ID 更改请求字段 95 

Dot Notation ID 文件字段 87 

Dot Notation 任务字段 109 

Dot Notation 文件字段 86 

Dot Notation 需求字段 102 

Dot Notation 主题字段 116 

dr 


dryrun 


dsc 


大小写 

忽略 143 

打印 

报告 283 

比较的文件 141 


任务 236 

审核条目 236 

图表 301 


项 236 

详细报告 283 

主题 236 

代码 

更改颜色 140 

在 Visual Diff 中的颜色 140 


弹出菜单 8, 147, 182 

定义 369 


StarTeam Toolbar 系统托盘图标 37 

导出 

报告 283 

数据 , 以在其它应用程序中使用 283 

图表 301 

导入 

CaliberRM 需求 176 

图表 301 

灯 

严重性 184 

灯泡 213 

登录 


以不同用户身份 39 

以默认用户身份 38 

自动 40 

登录时间 30 

登录用户 30 

低 

严重性 184 

第三方合并应用程序 337 

电子邮件 

定义 366 

发送更改请求 237 

发送任务 237 

发送项作为快捷方式 238 

发送主题 237 

定义 

报告的数据 281 

冻结 

标签 253 

定义 366 


任务 230 

文件 230 

文件夹 230 

主题 230 

逗号分隔的数据 283 

独立操作 

任务 197 

独占锁 

定义 366 

独占锁定 149 

端点 

定义 366 

断开连接 

从服务器 31 

索引 377

对话 

图标 213 

对象 

定义 366 

E 

e 


encrypt 



End Modified Time 更改请求字段 96 

End Modified Time 任务字段 109 

End Modified Time 文件字段 87 

End Modified Time 需求字段 102 

End Modified Time 主题字段 116 

Entered By 更改请求字段 96 

Entered On 更改请求字段 96 

EOL 63 

Cross-Platform 客户机的选项 312 

忽略 144 

eol 


命令行选项 328, 334, 336, 340, 349 

EOL Character 文件字段 87 

EOL 设置 

文件夹 29 

Estimated Finish 任务字段 109 

Estimated Finish Variance 任务字段 109 

Estimated Hours 任务字段 109 

Estimated Hours Variance 任务字段 109 

Estimated Start 任务字段 109 

Estimated Start Variance 任务字段 109 

Event 审核日志字段 120 

ex 

命令行选项 329, 330 

Executable 文件字段 87 

exfile 

命令行选项 329, 330 

Exit 命令 (StarTeam Toolbar) 36, 37 

exlist 

命令行选项 329, 330 

Expected Effort 需求字段 103 

Extension 文件字段 87 

External Reference 更改请求字段 96 

External Reference 需求字段 103 

二进制文件 

差异 339 

定义 366 

合并 135 

二维图表 301, 305 

F 

f 


f NCI 


f NCO 


File Time Stamp at Check-In 文件字段 87 

File Type 文件字段 87 

Files 选项卡 146 

-filter 324 

Finish 


Fix 更改请求字段 96 

Flag 更改请求字段 96 

Flag 任务字段 110 

Flag User List 更改请求字段 96 

Flag User List 任务字段 110 

Flag User List 文件字段 88 

Flag User List 需求字段 103 

Flag User List 主题字段 116 

Flag 文件字段 87 

Flag 需求字段 103 

Flag 主题字段 116 

Flagged Items 

需求 173 

Folder 更改请求字段 96 

Folder Path 更改请求字段 96 

Folder Path 任务字段 110 

Folder Path 审核日志字段 120 

Folder Path 文件字段 88 

Folder Path 需求字段 103 

Folder Path 主题字段 116 

Folder 审核日志字段 120 

Folder VMID 审核日志字段 120 

Folder 文件字段 88 

fs 



发送 

更改请求 , 通过电子邮件 237 

任务 , 通过电子邮件 237 

项作为快捷方式 238 

主题 , 通过电子邮件 237 

方括号约定 2 

访问权限 

标签 260 

查询 82 

定义 366 

筛选器 82 

非独占锁 

定义 366 

非独占锁定 149 

非分支行为 

定义 227 

分布图表 298 

分离 

标签 259 

标签 , 从文件夹和内容 256 

饼图 306 

分配 

更改请求 188, 192 

资源 203 

分支 

定义 366 


禁用 227 

设置 228 

未设置 228 

文件 228 

文件夹 228 

分支视图 

定义 366 


分支行为 

定义 227 


分支修订 

历史列表 234 

分组 

版本 ( 按标签 ) 146 

浮动 

定义 367 

链接 264 

配置 231 

覆盖 

自动登录 39 

覆盖 StarTeam 文件夹的工作文件夹 325, 354 

覆盖视图的工作文件夹 326, 355 

附加 

标签 258 

标签 , 到文件夹 256 

附件 


任务 208 

主题 217 

服务器 

传输数据 25 

定义 367 

断开连接 31 

命令行标识 331 


在命令行解除锁定 347 

在命令行锁定 347 

服务器配置 

定义 367 

服务器说明 

当前视图窗口 30 

复制 

查询 77 

筛选器 81 


图表数据 301 

图表位图 301 

修订标签 251, 252 

G 

Grouped by Creator 

需求 173 

Grouped by Status 

需求 173 

概述 

版本控制 14 

标签 247 

更改请求 15, 179 

任务 3 

StarTeam 3 


视图 21 

手册 4 

文件夹 49 

项目 5 

需求 169 

引用 269 

主题 18 

概要 



高 

严重性 184 

高级字段 83 

高速缓存的服务器 / 用户关联 38 

高速缓存用户名和密码 ( 使用 StarTeam Toolbar) 40 

个人信息 

更改 319 

个人选项 

定义 367 

Visual Merge 129, 311 

文件 168 

已读 / 未读 315 

已读和未读 240 


根文件夹 

定义 367 

更改 

更改请求行为 228 


密码 319 

图表标题 302, 305 

图表类型 301, 303 

图表数据 303 

图表图案 303 


图表颜色 301, 303 

图表字体 305 

Visual Diff 颜色 140 

文件夹行为 228 

文件行为 228 

更改的文本颜色 131, 140 

更改请求 

按标签选择 260 

按查询选择 71 

按状态和责任 185 

报告 193 

比较属性 233 

比较修订 233 

标记为已读或未读 239 

标签的访问权限 260 

标签概述 247 

标志 240 

菜单 182 

操作 223 

测试 190 

查看 188 

查找 235 

重开 190 

创建修订标签 257 

粗体 185 

打开 188, 190 

打印 236 

发送电子邮件 237 

分离标签 259 

分配 188, 192 

分支 228 

附加标签 258 

附件 187 


概述 15, 179 

概要 187 

共享 226 

工作流 181 

工作站功能 315 

过程项 243 

合并 235 

核实 190, 193 

回滚 230 

建立的影响 193 

建议类型 186 

索引 379

解决 189, 192 

结束 191, 193 



类型 185 

历史 185 

链接 186, 261 

内部版本标签 248 

配置 230 

缺陷类型 186 

Show All 185 

筛选器 184 

删除 241 

受视图中的更改影响的工作流 225 

刷新 183 

双击 182 

说明 187 

提交 186, 192 

通知 15, 316 

图标 182 

图表 193, 293 

拖放 185, 189 

无优先级 185 

显示未读更改 185 

详细信息 185 

行为 228 

修复 189 

严重性 186 

移动 225 

移动标签 257 

已读 185 

已修复 243 

优先级 185 

在命令行 327, 334 

在字段中搜索特定数据 235 

责任 187 

状态 182, 185 

自定义字段 187 

更改请求号 

定义 367 


更改请求列表 

测试命令 184 

创建时间 184 

创建者 184 

定义 367 

概要 183 

更改请求号 183 

解决方法 184 

解决请求的内部版本 184 

解决者 184 

类型 183 

排序 68, 184 

说明 184 

修复 184 

修改时间 184 

优先级 184 

责任 184 

状态 183 

最后测试的内部版本 184 

更改请求字段 93 

更新 


更新状态 


工具 

从 StarTeam Toolbar 启动 41 

工作站 307 

添加到 StarTeam Toolbar 42 

图表 302 

工具栏 

图表窗口 301 


工具栏 , 参阅 StarTeam Toolbar 

工具栏按钮 


工作记录 205 

工作流 181 

受视图中更改的影响 225 

工作文件 

比较 161 

定义 367 

检测更改 312 

与修订相比较 160 

与最新修订相比较 161 

在命令行删除 347 

工作文件夹 50, 52 

bco 命令中的覆盖 354, 355 

备选 57, 65 

备选路径 28 

创建 56, 59 

更改 65 

默认 56 

在命令行创建 345 

在命令行覆盖 325, 326 

工作站 

传输数据 25 

更改请求功能 315 

任务功能 315 

文件功能 310 

主题功能 315 

工作站工具 307 

公用文件 

请参阅共享文件。 

功能 


任务 315 

文件 310 

主题 315 

共享 


确认操作 308 

任务 198, 226 

文件 226 

文件夹 226 

主题 226 

固定 

链接 264 

文件修订到过程项 245 

固定间距字型约定 2 

关闭 


项目视图窗口 31 

关键字 

$Author$ 164 

$Dater$ 164 

$Folder$ 165 

$Header$ 164 

$Id$ 164 

$Locker$ 164 

$Log$ 165 


$NoKeywords$ 165 

$Project$ 165 

$Revision$ 165 

$Workfile$ 165 

定义 367 

扩展名 , 命令行上的项目 330 

使用 164 

文件 164 

关键字扩展 

定义 367 

管理 

版本 145 

任务 197 


文件 145 

项 223 

主题 211 

管理员 

定义 367 

关系运算符 71, 83 

用于布尔型字段 83 

用于枚举型字段 83 

用于日期 / 时间型字段 83 

用于数值型字段 83 

用于文本字段 83 

规则 

过程 243 

过程 

规则 243 

项 243 

过程项 


活动 244 

链接 245 

链接到文件修订 245 

任务 243 

设置 244 

限制 244 

允许 244 

在命令行链接 327, 328, 334, 335 

状态已在命令行更改 328, 334 

过期 

定义 367 

H 

h 



help 



Help 命令 (StarTeam Toolbar) 36, 37 

High Effort 需求字段 103 

hist 


History 选项卡 234 


任务 197 

说明 11 

文件 147 

需求 173 

主题 212 

Hold 


hook 


行 

在命令行抑制数 340 

行号 


行数抑制 

选项 , 在命令行 340 

行尾标记 63 

忽略 144 

还原 


文件夹选择 308 

合并 

比较的文件 141 

第三方应用程序 337 

定义 367 

二进制文件 135 


任务 235 

StarTeam 之外的文件 127 

三向 125 

文件 235 

文件版本 145 

文件夹 235 


项 235 

修订 125 


主题 235 

合并实用程序 

默认 314 

核实 

更改请求 190, 193 

黑色 

匹配文本颜色 130, 140 

红灯图标 184 

红色 

删除的文本颜色 130, 140 

忽略 

大小写 143 

空白字符 143 

行尾标记 144 

黄灯图标 184 

回复 

主题 217 

回滚 


任务 230 

视图 26 

文件 230 

文件夹 230 

主题 230 

活动 

过程项 244 

I 

i 

命令行选项 334, 337, 340 

I Am Responsible 

需求 173 

In Progress 


Instant 


索引 381

is 



Is My Task? 任务字段 110 

Is Replicated 任务字段 110 

记事本 

默认编辑器 314 

Item 1 Info 审核日志字段 121 

Item 1 审核日志字段 120 





iw 选项 


J 

集成 

锁定的文件 311 

记录 


技术支持 1 

加标签 

文件夹及其内容 254 

加标签的配置 26 

加密 

bco 命令中的数据 352 

定义 367 

禁用 25 


启用 25 

数据 25 

数据 , 在命令行 323 

简单图表 294, 297 

简介 


任务 3 

StarTeam 3 

主题 18 

建立 

对更改请求验证的影响 193 

建议 

更改请求类型 186 

建议图标 

缺陷列表 183 

校验和 

确定状态 312 

结构 

文件夹 56 

解除锁定 

定义 367 

服务器 , 在命令行 347 

文件 154 

文件 ( 在签入时 ) 311 

文件 , 在命令行 328, 335, 338, 343 

项 232, 317 

解冻 

标签 253 

解决 

更改请求 189, 192 

解决方法 

定义 367 


解决请求的内部版本 


解决者 


结束 

更改请求 191, 193 

截止 

配置 27, 231 

修订 231 

界面 

命令行 321 

进度报告 

命令行 326 

禁用 

分支 227 

警告 

确认 308 

卷统计信息 


K 

kw 


kwfile 


开发者支持 1 

可读写文件 

在命令行 328, 335, 337, 343 

客户端 

状态 27, 312 

客户机 

比较 357 

克隆 

修订标签 251, 252 

可执行位 151 

空白分支视图 

定义 367 

空白字符 

忽略 143 

选项 , 在命令行 339, 340 

控制 

任务列表 197 

任务树 197 

上部窗格 9 

快捷方式 

保存 25 

定义 367 

还原 308 

启用加密 25 

启用压缩 25 


通过电子邮件发送 238 

项 225 

项目 25 

括号约定 2 

扩展名 

关键字 , 在命令行 330 

L 

l 

命令行选项 328, 334, 337, 343 

Label 选项卡 


任务 198 

说明 11 

文件 147 


需求 173 

主题 212 

Last Build Tested 更改请求字段 97 

Last MS Project Update 任务字段 110 

Last Work/ Dependency Update 任务字段 110 

lbl 


lck 


Link 选项卡 


任务 198 

说明 11 

文件 147 

需求 173 

主题 212 

list 


List Display 按钮 172, 199, 214 

local-mkdir 


Locked By 


Locked By 更改请求字段 97 

Locked By 任务字段 110 

Locked By 文件字段 88 

Locked By 需求字段 103 

Locked By 主题字段 116 

Low Effort 需求字段 103 

蓝色 

更改的文本颜色 131, 140 

类型 



视图 , 在命令行 332 

图表 301, 303 

里程碑 202 

标签 146 

定义 367 

历史 


任务 197 

文件 147 

显示文件历史 341 

需求 173 

主题 212 

历史窗格 

当地时间 308 

UTC 时间 308 


定义 368 

分支修订 234 


列 234 

签入的原因 234 

时间戳 234 

视图 234 

显示 234 

修订 234 

作者 234 

连接属性 30 

链接 

创建时间列 264 

创建者列 264 

到特定修订 264 

浮动 264 


固定 264 

过程项 245 

Link 选项卡 11 

链接的项的属性 267 

链接列表中的列 263 


任务 198 

视图列 264 

属性 267 

文件 147 

文件夹列 264 

文件修订到过程项 245 

项 261 

项版本列 264 

项类型列 264 

项列 264 

项属性 267 

项详细信息列 264 

需求 173 

选择版本列 264 

注释列 264 

主题 212 

链接列表 10 

排序 68 

链接属性 

更改 264 

列 


排序数据 10 



列标题 

定义 368 

列出文件 


路径 

报告的默认位置 308 

区分大小写 63 

StarTeam.log 308 

路径名称 

平台差异 325, 326, 354, 355 

绿灯图标 184 

绿色 

插入的文本颜色 130, 140 

逻辑运算符 71 

M 

m 


Maintain Group State on Folder/Scope Change 308 

Manual 


MAPI 

定义 368 

mark 

命令行选项 328, 334 

MD5 

确定状态 312 

MD5 Checksum 文件字段 88 

MD5 校验和 

状态确定依据 153 

Merge 


索引 383

merge 


Message Broker 22 

Milestone 任务字段 110 

Missing 


mode 


Modified 


Modified By 更改请求字段 97 

Modified By 任务字段 111 

Modified By 审核日志字段 121 

Modified By 文件字段 88 

Modified By 需求字段 104 

Modified By 主题字段 117 

Modified Time 更改请求字段 97 

Modified Time 任务字段 111 

Modified Time 审核日志字段 121 

Modified Time 文件字段 88 

Modified Time 需求字段 104 

Modified Time 主题字段 117 

Modify Tool 命令 (StarTeam Toolbar) 36 

MS Project File Name 任务字段 111 

MS Task GUID 任务字段 111 

MS Task Unique ID 任务字段 111 

MS WBS Code 任务字段 111 

Multicast Service 22 

My Lock 更改请求字段 97 

My Lock 任务字段 111 

My Lock 文件字段 88 

My Lock 需求字段 104 

My Lock 主题字段 117 

枚举型 


密码 


更改 319 


名称 

更改文件夹名 62 


文件夹 , 在命令行 329 

项目 , 在命令行 331 

命令 

viewmerge 129 

命令行 

active 选项 327, 334 

ba 选项 332 

bn 选项 332 

cr 选项 327, 334 

d 选项 328, 329, 330, 332, 341, 342 

dr 选项 332 

ex 选项 329, 330 

exfile 选项 329, 330 

exlist 选项 329, 330 

kw 选项 330 

kwfile 选项 331 

mark 选项 328, 334 

name 选项 329, 331, 332 

req 选项 328, 335 

ro 选项 332 

s 选项 331 

task 选项 328, 335 

命令行界面 321 

? 选项 323 

b 选项 339, 342 

Bpvcs 选项 339 

break 选项 343 

版权声明 325 

包含文件夹 325 

包含子文件夹 325 

比较文件 339 

标签 328, 333, 334, 335, 338, 340, 342 

标签冻结 342 

标签截止日期 342 

c 选项 339 

cfgd 选项 332, 336, 338, 339, 341, 344, 345, 346, 

349 

cfgl 选项 332, 336, 338, 339, 341, 344, 345, 346, 

349 

cfgp 选项 332, 336, 338, 339, 342, 344, 346, 349 

cmp 选项 323 

创建标签 342 

创建工作文件夹 345 

df 选项 347 

大小写 340 

e 选项 339 

encrypt 选项 323 

eol 选项 328, 334, 336, 340, 349 

f NCI 选项 334 

f NCO 选项 336 

f 选项 342 

filter 选项 333, 334, 336, 338, 340, 341, 342, 343, 

344, 346, 347, 350 

fs 选项 336 

非独占锁定文件 328, 334, 337, 343 

覆盖视图的工作文件夹 325, 326 

更改文件说明 341 

更新文件状态 349 

关键字扩展名 330 

过程项 327, 328, 334, 335 

h 选项 323 

help 323 

help 选项 323 

hook 选项 337 

忽略特定列中的字符 340 

i 选项 334, 337, 340 

is 选项 325 

基于提升状态的标签 343 

将服务器解锁 347 

交互式强制签出 337 

交互式强制签入 334 

解除锁定文件 328, 335, 338, 343 

可读写文件 328, 335, 337, 343 

空白字符 339, 340 

l 选项 328, 334, 337, 343 

lbl 选项 333 

列出文件 344 

列出子文件夹 344 

m 选项 340 

merge 选项 337 

mode 选项 347 

密码文件 326 

n 选项 340 

nd 选项 340 

nel 选项 328, 334, 337, 343 

nl 选项 342 

nologo 选项 325 

nomove 选项 334 


o 选项 335, 337 


p 选项 326 

pwdfile 选项 326 

派生视图 332 

q 选项 326 

签出缺失或过期的文件。 336 

签出文件 335 

签出文件 , 而不管状态如何 336 

签入的原因 335 

签入文件 334 

签入已修改的文件 334 

强制签出 337 

强制签入 335 

r 选项 335, 342 

rf 选项 335 

ro 选项 328, 335, 337, 343 

rp 选项 325, 326 

rw 选项 328, 335, 337, 343 

绕过错误消息 326 

s 选项 348 

sf 选项 344 

StarTeam Server 331 

stcmd add 327 

stcmd add-folder 328 

stcmd add-project 330 

stcmd add-view 331 

stcmd apply-label 333 

stcmd ci 334 

stcmd co 335 

stcmd delete-local 338 

stcmd diff 339 

stcmd dsc 341 

stcmd hist 341 

stcmd label 342 

stcmd lck 343 

stcmd list 344 

stcmd local-mkdir 345 

stcmd remove 347 

stcmd server-mode 347 

stcmd update-status 349 

stop 选项 326 

删除工作文件 347 

删除文件 338, 347 


时间戳 338 

视图类型 332 

视图名称 332 

视图配置标签名称 332, 336, 338, 339, 341, 344, 

345, 346, 349 

视图配置截止日期 332, 336, 338, 339, 341, 344, 

345, 346, 349 

视图配置状态 332, 336, 338, 339, 342, 344, 346, 

349 

锁定服务器 347 

锁定文件 328, 334, 337, 343 

t 选项 340 

ts 选项 338 

添加视图 331 

添加文件 327 

添加文件夹 328 

添加项目 330 

退出代码 339 

u 选项 328, 335, 338, 343 

vd 选项 333, 338, 340, 342 

vl 选项 328, 333, 335, 338, 340, 343 

vn 选项 333, 338, 340 

vp 选项 343 

w 选项 340 

文件夹名称 329 

文件夹排除列表 329, 330 

文件夹说明 329 

文件夹选项 326 

文件说明 324, 328, 341, 342 

文件状态 333, 334, 336, 338, 340, 341, 342, 343, 

344, 346, 347, 350 

x 选项 326 


项目名 331 

项目说明 330, 332 

行数抑制 340 

行尾转换 328, 334, 336, 340, 349 

修订标签 342 

修订号 333, 338, 340 

修订截止日期 333, 338, 340 

移动文件状态 345 

已复制的标签 343 

抑制差异 340 

隐含进度报告 326 

因为错误停止执行 326 

应用标签 333 

语法 322 

制表位 340 

指定服务器 348 

只读视图 332 

只读文件 328, 335, 337, 343 

中断锁定 343 

命令行文件 

定义 368 


模板 

更改报告 290 

目录 

请参阅文件夹。 

N 

n 


name 

命令行选项 329, 331, 332 

Name 


Name 文件字段 89 

Name 需求字段 104 

NCI 


NCO 


nd 


Needs Attention 任务字段 111 

nel 

命令行选项 328, 334, 337, 343 

netmon 


New Folder wizard 59 

New Revision Comment 更改请求字段 97 

New Revision Comment 任务字段 111 

New Revision Comment 文件字段 89 

New Revision Comment 需求字段 104 

New Revision Comment 主题字段 117 

nl 


索引 385

nologo 


nomove 


Non-Exclusive Lockers 更改请求字段 97 

Non-Exclusive Lockers 任务字段 112 

Non-Exclusive Lockers 文件字段 89 

Non-Exclusive Lockers 需求字段 104 

Non-Exclusive Lockers 主题字段 117 

Not In View 


Not Started 


Notes 任务字段 112 

Notes 需求字段 104 

Number 


Number 需求字段 104 

内部版本 

标签 146 

定义 365 


定义 368 

命令行 342 

视图标签类型 250 

内容 

主题和响应 220 

O 

o 


命令行选项 335, 337 

Object ID 更改请求字段 97 

Object ID 任务字段 112 

Object ID 审核日志字段 121 

Object ID 文件字段 89 

Object ID 需求字段 104 

Object ID 主题字段 117 

Open 命令 (StarTeam Toolbar) 37 

Open Tools Folder 命令 (StarTeam Toolbar) 36 

OR 操作 71 

Owner 需求字段 105 

Out Of Date 


P 

p 



Parent Branch Revision 更改请求字段 97 

Parent Branch Revision 文件字段 89 

Parent ID 更改请求字段 98 

Parent ID 文件字段 89 

Parent Requirement ID 需求字段 105 

Parent Revision 更改请求字段 98 

Parent Revision 文件字段 89 

Parent Task ID 任务字段 112 

Parent Topic ID 主题字段 117 

Path 文件字段 89 

Pending 


Percent Complete 任务字段 112 

Platform 更改请求字段 98 

Priority 


Priority 更改请求字段 98 

Priority 任务字段 112 

Priority 需求字段 105 

Priority 主题字段 117 

Project ID 文件字段 90 

Project 审核日志字段 121 

PVCS Revision 文件字段 90 

pwdfile 



排除列表 

文件夹 , 在命令行 329, 330 

排序 

定义 368 

更改请求列表 68, 184 

链接列表 68 

列中的数据 10 

任务 200 


审核日志 68, 220 

文件列表 68, 147 

需求 172 

需求列表 171 


主题列表 68 

派生视图 


配置 

bco 命令中的截止日期 352 

CaliberRM Import DocFactory 176 

定义 368 

浮动 231 


加标签 26 

加标签的修订 231 

截止 27, 231 

截止日期 , 在命令行 332, 336, 338, 339, 341, 344, 

345, 346, 349 

任务 230 

日期 / 时间 27, 231 

提升状态 27, 231 

文件 230 

文件夹 230 

主题 230 

配置文件 

定义 368 

MPX 22 

视图 28 

文件夹可见性 29 

文件夹设置 29 

批量签出实用程序 351 

匹配 

查找 132, 140 


匹配文本颜色 130, 140 

平台兼容性 325, 326, 354, 355 

Q 

q 


启动工具 ( 从 StarTeam Toolbar) 41 


启用 

加密 25 

压缩 25 

签出 

bco 命令中的强制 354 

bco 命令中的文件 354 

定义 368 

解除锁定的文件 311 

时间戳 310 

锁定的文件 311 

文件 148, 156, 351 

文件 ( 通过慢速连接 ) 310 

文件 , 在命令行 335, 336 

修订 145, 156 

在命令行交互式强制 337 

在命令行强制 337 

只读文件 311 

状态的影响 159 

签入 

定义 368 

解除锁定的文件 311 

文件 148 



修订 145 

已修改的文件 , 在命令行 334 

原因 , 在命令行 335 

在命令行交互式强制 334 

在命令行强制 335 

状态的影响 159 

签入的原因 


前置 202 

清除 

标志 240 

文件状态信息 313 

倾斜 

图表 305 

驱动器 

映射 63 


区分大小写设置 

文件夹 29 

确认 

共享操作 308 

警告 308 

删除 308 

移动操作 308 

缺失 

定义 368 

缺陷 

定义 368 

更改请求类型 186 

缺陷跟踪 

定义 368 

缺陷列表 

建议图标 183 

缺陷图标 183 

缺陷图标 

缺陷列表 183 

R 

r 

命令行选项 335, 342 

RC2_CBC 323, 352 

RC2_CF 323, 352 

RC2_ECB 323, 352 

RC4 323, 352 

Read Only 更改请求字段 98 

Read Only 任务字段 112 

Read Only 文件字段 90 

Read Only 需求字段 105 

Read Only 主题字段 117 

Read Status 更改请求字段 98 

Read Status 任务字段 112 

Read Status User List 更改请求字段 98 

Read Status User List 任务字段 112 

Read Status User List 需求字段 105 

Read Status User List 主题字段 118 

Read Status 需求字段 105 

Read Status 主题字段 118 

Recipient Count 主题字段 118 

Recipient IDs 主题字段 118 

Recipient Names 主题字段 118 

Reference 选项卡 


任务 198 

说明 12 

文件 147 

需求 173 

主题 212 

Refresh Tools 命令 (StarTeam Toolbar) 36 

remove 


req 

命令行选项 328, 335 

Reset scope to local on folder change 308 

Resolved On 更改请求字段 98 

Resource Count 任务字段 113 

Resource IDs 任务字段 113 

Resource Names 任务字段 113 

Responsibility 更改请求字段 99 

Responsibility 任务字段 113 

Responsible Count 需求字段 105 

Responsible IDs 需求字段 105 

Responsible Names 需求字段 105 

Reviewed By 需求字段 106 

Revised Description 需求字段 106 

Revision Flags 更改请求字段 99 

Revision Flags 任务字段 113 

Revision Flags 文件字段 90 

Revision Flags 需求字段 106 

Revision Flags 主题字段 118 

Revision on Disk 文件字段 90 

Revision 文件字段 90 

rf 


ro 


命令行选项 328, 332, 335, 337, 343 

Root Object ID 更改请求字段 99 

Root Object ID 文件字段 90 

rp 

bco 命令选项 354, 355 

命令行选项 325, 326 

rw 

命令行选项 328, 335, 337, 343 

任务 



保存附件 208 

索引 387






标志 240 

不分级 203 

菜单 198 

操作 223 

查找 235 

窗格 197 

创建 200 


打印 236 



分配资源 203 


附件 208 


概述 3 

共享 198, 226 

工作记录 205 


管理 197 

过程项 243 

合并 235 

回滚 230 

结束 243 


里程碑 202 

历史 197 

链接 198, 261 

排序 200 

配置 230 

前置 202 

筛选器 200 

删除 241 

删除附件 208 

时间估计 204 

使用树格式 198 


属性 209 

刷新 198 

双击 198 

添加任务到项目 200 

添加说明 206 

通知 15, 316 

图表 293 

拖放 198 

完成百分比 203 

未读 199 

无 Microsoft Project 集成 197 


修订注释 209 

需要注意 203 

移动 225 


已读 199 

优先级 203 

在命令行 328, 335 


状态 202 


任务栏按钮 (StarTeam Toolbar 窗口 ) 37 

任务列表 

控制 197 

排序 68 

益处 199 

任务树 197 

控制 197 

图标 198 

益处 198 

展开 198 

折叠 198 

任务字段 107 

任务组件 

定义 368 

日期 / 时间 


配置 27, 231 

修订 231 

日期范围 

主题 215 

日志 


输出路径 308 

请参阅审核日志 

容器 

定义 368 

S 

s 

命令行选项 331, 348 

server-mode 


Severity 更改请求字段 99 

sf 


Share State 更改请求字段 99 

Share State 任务字段 113 

Share State 文件字段 90 

Share State 需求字段 106 

Share State 主题字段 118 

Short Comment 更改请求字段 99 

Short Comment 任务字段 113 

Short Comment 文件字段 91 

Short Comment 需求字段 106 

Short Comment 主题字段 118 

Show All 



需求 173 

主题 215 

Size 文件字段 91 

SMTP 

定义 368 

StarDisk 

定义 369 

StarTeam 

概述 3 

客户机刷新 308 

StarTeam Cross-Platform 客户机 

与 Windows 客户机比较 357 

StarTeam 工具栏 



About 命令 36, 37 

Add Tool 命令 36 

查看高速缓存的服务器 / 用户关联 38 


重命名工具 44 

窗口 36 

窗口弹出菜单中的命令 36 

Delete Tool 命令 36 

打开窗口 34 

登录 StarTeam 服务器 38 

对每台服务器都使用相同用户名和密码 40 

Exit 命令 36, 37 

复制现有快捷方式 43 

概述 33 

高速缓存用户名和密码 40 

功能 33 

功能变化 35 

关闭窗口 46 

管理窗口 45 

Help 命令 36, 37 

结束进程 ( 使用任务管理器 ) 48 

Modify Tool 命令 36 

Open 命令 37 

Open Tools Folder 命令 36 

启动 34 

启动工具 41 

启动时显示窗口 36 

Refresh Tools 命令 36 

删除工具 45 

刷新 45 

添加工具 42 

调整窗口大小 46 

退出 47 

系统托盘图标 37 

系统托盘图标的弹出菜单中的命令 37 

显示 About 对话框 46 

显示帮助 46 

显示窗口 36 

新建快捷方式 42 

修改工具属性 43 

以不同用户身份登录 39 

以默认用户身份登录 38 

隐藏任务栏按钮 37 

隐藏系统托盘图标 37 

用户界面 35 

展开窗口 45 

折叠窗口 45 

自定义 41 

最小化窗口 46 

StarTeam Windows 客户机 

与 Cross-Platform 客户机比较 357 

StarTeam 文件 

定义 369 


定义 369 

StarTeam 文件夹层次 

定义 369, 370 

StarTeam 用户指南 

概述 4 

StarTeamMPX Server 22 

设置选项 318 

停止 319 

状态栏信息 318 

Status 


Status 更改请求字段 99 

Status 任务字段 113 

Status 文件字段 91 

Status 需求字段 106 

Status 主题字段 118 

stcmd 321 

add 327 

add-folder 328 

add-project 330 

add-view 331 

apply-label 333 

标签 342 

ci 334 

co 335 

delete-local 338 

diff 339 

dsc 341 

hist 341 

lck 343 

list 344 

local-mkdir 345 

move-status 345 

remove 347 

server-mode 347 

set-personal-options 348 

update-status 349 

stop 


Storage Type 文件字段 91 

Sync Branch Version 文件字段 91 

Sync Content Version 文件字段 91 

Sync Known 文件字段 91 

Sync Local Size 文件字段 91 

Sync Local Time Stamp 文件字段 91 

Sync MD5 文件字段 92 

Sync On Path To Root 文件字段 92 

syncdb 


Synopsis 更改请求字段 100 

三维图表 301, 305 

三向合并 125 

筛选 


任务 200 


文件列表 147 

需求 172 

主题 214 

筛选器 


编辑 81 

重置 82 

从头开始创建 79 

定义 369 


复制 81 

命令行选项 333, 334, 336, 338, 340, 341, 342, 343, 

344, 346, 347, 350 

删除 82 

上部窗格 78 

使用 79 

使用当前设置创建 79 

文件 148 

性能 67 

删除 

标签 , 从视图 254 

标志 240 

查询 78 

从版本控制 ( 定义 ) 366 

定义 369 


索引 389

工作文件 , 在命令行 347 

确认 308 

任务 241 


任务中的工作记录 205 

StarTeam Toolbar 中的工具 45 

筛选器 82 

图表图案 304 

文件 241 

文件 , 在命令行 338, 347 

文件夹 241 

主题 241 

删除的文本颜色 130, 140 

上部窗格 

查询 70 

创建筛选器 79 

控制 9 

排序 10 

筛选器 78 

说明 7 

深度 

图表 302 

审核日志 

菜单 220 

定义 369 

控制 219 

列 220 

排序 68, 220 

Show All 220 

筛选器 220 

事件 221 

双击 220 

Type 220 

User 220 

显示 219 

审核日志字段 119 

审核条目 

操作 223 

查找 235 

打印 236 

定义 369 

刷新 220 

图表 293 


时间 

当地 308 

UTC 308 

为任务估计 204 

时间戳 


定义 369 


命令行 338 

签出 310 

状态确定依据 153 

时间统计信息 


时间序列图表 300 

事件 


事件通知 

定义 369 

视图 


bco 命令中的覆盖工作文件夹 355 

bco 命令中的配置截止日期 352 

bco 命令中的配置名称 352 

bco 命令中的配置状态 352 

备选工作文件夹 57 

备选工作文件夹属性 28 



重新配置 26 

存储文件状态 27 

定义 369 

覆盖 bco 命令中的工作文件夹 354 

概述 21 

共享更改请求 226 

共享任务 226 

共享文件 226 

共享文件夹 226 

共享主题 226 

回滚 26 

加标签的配置 26 

类型 , 在命令行 332 



名称 , 在命令行 332 


配置截止日期 , 在命令行 332, 336, 338, 339, 341, 

344, 345, 346, 349 

配置名称 , 在命令行选项 332, 336, 338, 339, 341, 

344, 345, 346, 349 

配置文件 28 

配置状态 , 在命令行选项 332, 336, 338, 339, 342, 

344, 346, 349 

日期 / 时间配置 27 

删除标签 254 

属性 30 

刷新 30, 147, 170, 183, 220 

说明 , 在命令行 332 

提升状态配置 27 



通过分支创建的引用 273 

未排除的文件 148 

文件 148 

移动更改请求 225 

移动任务 225 

移动文件 225 

移动文件夹 225 

移动主题 225 

在命令行分支 332 

在命令行覆盖工作文件夹 325, 326 

在命令行派生 332 

在命令行只读 332 

状态栏中显示的配置 13 



创建 249 

定义 369 

复制 250 

命令行 333, 338, 342 

内部版本标签 248, 250 

在命令行 332, 336, 338, 349 

视图窗口 

当前连接属性 30 

定义 369 

说明 7 

使用 

版本控制 14 

查询 71 


关键字 164 

任务窗格 197 


筛选器 79 

实用程序 

批量签出 351 

手册 

概述 4 

输出路径 

报告 308 


属性 267, 369 

比较 233 

标签 254 

程序快捷方式 43 

连接 30 

链接 267 

链接的项 267 

任务 209 

视图 30 

文件 166 

文件夹 62 

主题 217 

树 

任务图标 198 

主题图标 213 

树格式 

任务 198 

需求 171 

主题 213 

竖线约定 2 

数 

在命令行抑制 340 

数据 

bco 命令中的加密 352 

bco 命令中的压缩 352 

复制图表 301 

更改图表 303 

加密 25 

为报告定义 281 

压缩 25 

在命令行加密 323 

在命令行压缩 323 

数值 

定义 369 

数值型 


刷新 

定义 370, 371 


任务 198 

StarTeam 客户机 308 


StarTeam 主窗口中的数据 10 


视图 30, 147, 170, 183, 220 

外部存档 (PVCS 和 SourceSafe) 30, 147 

文件 147 


需求 170 

双击 147 


任务 198 


响应 213 

需求 170 

主题 213 


水平 

图表网格 302 

顺序 

在 Visual Diff 中的文件 140 

说明 



更改文件夹说明 62 


添加到任务 206 

文件 , 在命令行 328, 341, 342 




搜索 

比较文件中的文本 132, 140 

更改请求字段 235 

任务字段 235 

审核条目字段 235 

Visual Merge 文本 132 

文本 132, 140 

文件字段 235 

主题字段 235 

锁定 

从集成中使用的文件 311 

服务器 , 在命令行 347 

文件 154 

文件 ( 在签出时 ) 311 

文件 , 在命令行 328, 334, 337, 343 

项 232, 317 

在命令行中断 343 

中断 232 

锁定状态 149 

缩放 

图表 302 

所有者 

定义 370 

T 

t 



Target 1 Class ID 审核日志字段 122 

Target 1 Object ID 审核日志字段 122 

Target 1 Revision Time 审核日志字段 122 







task 

命令行选项 328, 335 

Task Duration 任务字段 114 

Task Name 任务字段 114 

Task Number 任务字段 114 

Task Origin 任务字段 114 

Task Type 任务字段 114 

TCP/IP 

定义 370 

Test Command 更改请求字段 100 

Title 主题字段 119 

索引 391

Topic Number 主题字段 119 

Tree Display 按钮 171, 198, 213 

ts 



Type 

审核日志中的列 220 

Type 更改请求字段 100 

Type 需求字段 106 

Type 主题字段 119 

提交 

更改请求 186, 192 

提升状态 


定义 370 

将文件夹或项配置到 231 

配置定义 370 

提升模型 370 

在命令行 332, 336, 338, 339, 342, 344, 346, 349 

提升状态配置 27 

添加 

工具到 StarTeam Toolbar 42 

任务到项目 200 

任务的说明 206 



文件 145, 149 

文件夹 59 




添加文件 

定义 370 

条 , 拆分 139 

条件 

创建 73, 75 

调色板栏 

图表 304 

停止 

错误 , 在命令行 326 

StarTeamMPX Server 319 

统计信息 


通知 

更改请求 15, 316 

任务 15, 316 

系统托盘 316 

主题 15, 316 

图案 

在图表上更改 303 

图案栏 

图表 304 

图标 


任务树 198 

文件夹 8 

响应 213 

需求 172 

图标 172 

主题 213 

主题树 213 

图表 

保存 301 

编辑标题文本 302, 305 

编辑图例文本 304 

创建 293 

窗口 301 

打印 301 

导出 301 

导入 301 

二 / 三维 301, 305 

分布 298 

分离饼图 306 

更改类型 301, 303 

更改请求 193, 293 

更改数据 303 

更改图案 303 

更改颜色 301, 303 

工具 302 

工具栏 301 

简单 294, 297 

可用 293 

倾斜 305 

任务 293 

删除图案 304 


时间序列 300 

缩放 302 

添加深度 302 

调色板栏 304 

图案栏 304 

图例 302 

网格 302 

文件 293 

相关性 299 

选项 302 

旋转 302, 305 

以数据形式复制 301 

以位图格式复制 301 

z 群集 302 

主题 293 

字体 305 

图库 

更改图表类型 301, 303 

更改图表数据 303 

图例 

编辑图表 304 

团队成员 

定义 370 

分配给任务 203 

退出 

登录 31 



退出代码 326, 327 


拖放 

更改请求 185, 189 

任务 198 

文件 147 

文件夹 52 

需求 171 

U 

u 

命令行选项 328, 335, 338, 343 

UNIX 

可执行位 151 

StarTeam 控制下的文件 63 

Unknown 



update-status 


useCA 


User 

审核日志中的列 220 

User 审核日志字段 122 

UTC 时间 308 

V 

Vault Branch Version 文件字段 92 

vb 


vd 

命令行选项 333, 338, 340, 342 

Verified On 更改请求字段 100 

Version 更改请求字段 100 

Version 任务字段 114 

Version 文件字段 92 

Version 需求字段 106 

Version 主题字段 119 

View 更改请求字段 100 

View 审核日志字段 123 

View 文件字段 92 

viewmerge 

命令和选项 129 

Visual Diff 160, 161 

比较文件或版本 125 

菜单命令 137 

查找差异 132, 140 

查找匹配 132, 140 

拆分窗口 139 

差异 141 

定义 370 

更改文件编码 138 

更改颜色代码 140 

工具栏按钮 137 

合并文件 141 

默认的比较实用程序 314 

默认颜色代码 140 

匹配 141 


文件顺序 140 

与 Visual Merge 比较 125 

在比较文件中查找文本 132, 140 

主窗口 136 


am 选项 129 

amt 选项 129 

at 选项 129 

比较和合并修订 125 

差异 133 

冲突 133 

窗口 134 

定义 370 

个人选项 129 

更改文件编码 131 

工具栏 134 

行号 134 

iw 选项 129 

默认的合并实用程序 314 

StarTeam 个人选项 311 


示例 125 

搜索文本 132 

退出 133 

选项卡设置 134 

颜色 134 

用作独立的实用程序 127 

与 Visual Diff 比较 125 

主窗口 130 

主窗口外观 134 

状态栏 134 

自定义 134 

字体 134 

vl 

命令行选项 328, 333, 335, 338, 340, 343 

vn 

命令行选项 333, 338, 340 

vp 


W 

w 



与 Cross-Platform 客户机比较 357 

Work Around 更改请求字段 100 

Work Record Count 任务字段 114 

Working File Exists 文件字段 92 

Working File Size 文件字段 92 

Working Time Stamp 文件字段 92 

外部刷新 30, 147 

定义 370 

完成百分比 

任务 203 

完整修订存储 

定义 370 

网格 

图表 302 

未读 240, 315 

更改请求 185, 239 

任务 199, 239 

需求 172 

主题 239 

未读项 239 

未知 

定义 370 

位 

可执行 151 

位图 

复制图表 , 所采用的格式为 301 

文本 


搜索比较文件 140 


文本文件 

报告 283 

比较 125 

差异 339 

定义 370 

合并 125 

搜索比较文件 132 

在 Visual Merge 中搜索 132 

文件 



按状态排序 148 

bco 命令中的密码 355 

bco 命令中的签出 354 

索引 393

co 命令中的强制签出 354 

bco 命令中的时间戳记 356 

bco 命令中的说明 353 

bco 命令中的只读 355 

bco 命令中的状态 354 

比较 125, 160 

比较两个修订 160 


编辑 152 

编辑修订注释 235 

编码 131, 138 



标志 240 

不在视图中 148, 149 

操作 223 

查看修订内容 160 

查找 235 

查找匹配 132, 140 


从版本控制删除 240 

从集成中锁定 311 

打开 151 

打印比较的 141 

打印文件属性 236 

逗号分隔的文本文件 283 

非 Windows 操作系统 63 


分支 228 



个人选项 168 

更新状态 153 

共享 226 


关键字 164 

管理 145 

合并 125, 235 

合并版本 145 

合并比较的 141 

合并二进制文件 135 

合并修订 161 

回滚 230 

检测工作文件的更改 312 

将 Visual Merge 用作独立的实用程序 127 

将工作文件与修订进行比较 160 

将工作文件与最新修订进行比较 161 

解除锁定 154 

可读写命令行 328, 335, 337, 343 


控制列表 146 

历史 147 

链接 147, 261 

链接到过程项 245 

密码 , 在命令行 326 

命令行说明 324, 341 

排序列表 147 

配置 230 

签出 145, 156, 351 

签出时锁定 311 

签出文件的时间戳 310 

签入 145, 153 

签入和解除锁定 311 

签入原因 , 在命令行 335 



筛选器列表 147 

删除 241 


时间戳 , 在命令行 338 


属性 166 

刷新 147 


说明 , 在命令行 328, 341, 342 

锁定 154 

添加 145 

添加到项目 149 

图表 293 

图表可用 293 

拖放 147 

UNIX 63 

未从视图中排除 148 


详细信息 147, 220 

行为 228 

要签出 148 

要签入 148 

移动 225 


优化通过慢速连接所执行的签出 310 

由校验和确定的状态 312 

在 Visual Diff 中的顺序 140 

在命令行交互式强制签出 337 

在命令行交互式强制签入 334 

在命令行解除锁定 328, 335, 338, 343 

在命令行列出 344 

在命令行签出 336 

在命令行签入已修改的文件 334 

在命令行强制签出 337 

在命令行强制签入 335 

在命令行删除 347 

在命令行删除工作文件 347 

在命令行锁定 328, 334, 337, 343 

在命令行移动状态 345, 348 

在视图中 148 


只读 311 

只读命令行 328, 335, 337, 343 

状态储存库选项 27, 312 

状态对签入和签出文件的影响 159 

状态 , 在命令行 333, 334, 336, 338, 340, 341, 342, 

343, 344, 346, 347, 350 


文件夹 



bco 命令中的覆盖工作文件夹 355 

备选工作文件夹 57, 65 



不可见 29 

操作 223 

重置作用域 308 

创建 59 

创建结构 56 


定义 370 

EOL 设置 29 


分支 228 

覆盖 bco 命令中的工作文件夹 354 



概述 49 

更改工作文件夹 65 

共享 226 





工作 50, 52, 56 

还原选择 308 

合并 235 

回滚 230 

加标签 254 

可见 29 

链接 261 


名称 62 


命令行 325 


排除列表 , 在命令行 329, 330 

配置 230 

配置文件 29 

区分大小写设置 29 

删除 241 

使用映射驱动器使 UNIX 位置成为 StarTeam 

文件夹 63 


属性 62 

说明 62 


添加到项目视图 59 

图标 8 

拖放 52 

行为 228 

移动 52, 225 





引用 270 

在命令行创建工作文件夹 345 

在命令行覆盖工作文件夹 325, 326 

在命令行列出子文件夹 344 

文件夹层次 50 

定义 370 

展开 8 

折叠 8 

文件列表 

排序 68 

显示 146 

文件压缩 

定义 371 

文件状态 

Current 159 

存储 27 

对签入和签出文件的影响 159 

Merge 159 

Missing 159 

Modified 159 

Not In View 159 

Out Of Date 159 

清除 313 

Unknown 159 

文件字段 84 

我的帐户 319 

无优先级 


X 

x 


系统托盘 

通知 316 

系统托盘通知 15, 316 

系统托盘图标 (StarTeam Toolbar) 37 

隐藏 37 

下部窗格 

控制 10 

说明 7 

显示 


启动时显示 StarTeam Toolbar 窗口 36 

任务树 197 

StarTeam Toolbar 帮助 46 


StarTeam Toolbar 的 About 对话框 46 



文件列表 146 

显示未读更改 


线索化对话 

定义 371 

相关性图表 299 

向导 

New Folder 59 

项 


标志 240 

操作 223 

打印 236 

定义 371 

管理 223 

过程 243 

合并 235 

解除锁定 232, 317 


链接 261 


确认共享操作 308 

确认移动操作 308 


锁定 232, 317 

未读 239 

已读 239 

引用 270 

作为快捷方式 , 通过电子邮件 238 

项版本 


项类型 


项目 

打开 23 

定义 371 

概述 5 




共享文件夹 226 


索引 395

关键字扩展名 , 在命令行 330 


了解 5 



添加任务 200 





移动文件 225 

移动文件夹 225 


详细报告 

打印 283 

详细的 


详细信息列表 10 

项详细信息 


响应 

创建 217 

定义 371 

管理 211 

内容 220 

排序 214 

双击 213 

图标 213 

另请参阅主题。 

主题 217 

消息 

错误 , 在命令行 326 

斜体约定 2 

协议 

定义 371 

信封 213 

行为 

非分支 227 

分支 227 


共享的项 226 

禁用分支 227 

设置分支 228 

未设置分支 228 

文件 228 

文件夹 228 

性能 

筛选器 67 

修订 



比较 125, 160 

比较更改请求 233 

比较两个 160 

比较两个任务 233 

比较两个主题 233 


查看文件修订内容 160 

定义 371 



History 选项卡 11 

号 , 在命令行 333, 338, 340 

合并 125, 161 

加标签 231 

将标签从一个项修订移动到另一个 257 

截止 231 

截止日期 ( 在命令行 ) 333, 338, 340 


链接的 264 

配置 231 

签出 145, 156 

签出过去的修订 158 

签出最新 156 

签入 145, 153 

日期 / 时间 231 

为文件夹创建修订标签 255 

为文件夹移动标签 255 

为项创建修订标签 257 

与工作文件相比较 160, 161 

注释 209 

修订标签 

创建 251 

定义 371 

复制 252 

克隆 251 

命令行 333, 338, 342 

修订号 

定义 371 

修订注释 

为文件编辑 235 

修复 

更改请求 189, 371 


修改 

程序快捷方式属性 43 


视图属性 30 


请参阅 “ 更改 ”。 

主题属性 218 

修改时间 


需求 

CaliberRM 177 

创建 173 

从 CaliberRM 导入 176 

Flagged Items 173 

Grouped by Creator 173 

Grouped by Status 173 

概述 169 

I Am Responsible 173 

历史 173 

链接 173 

排序 172 

Show All 173 

筛选器 172 


刷新 170 

双击 170 

拖放 171 

未读 172 


已读 172 

在命令行 328, 335 

需求列表 

Created By 170 

Created Time 170 

Description 170 

Locked By 171 

Name 170 

Number 170 


Priority 171 

排序 171 

Status 170 

益处 172 

需求树 

益处 171 

展开 172 

折叠 172 

需求字段 100 

需求组件 

定义 371 

需要注意 203 

选项 

设置文件 310 

图表 302 


文件状态存储 27, 312 

在命令行设置个人选项 348 

选项卡 

Audit Trail 220 

选项卡设置 


选择 

标签 260 

查询 71 

选择版本 


旋转 

图表 302, 305 

Y 

压缩 

bco 命令中的数据 352 

定义 371 

禁用 25 


启用 25 

数据 25 

数据 , 在命令行 323 

颜色 

插入的文本 130, 140 

更改 Visual Diff 140 

更改的文本 131, 140 

更改图表 303 

更改图表字体 305 

匹配文本 130, 140 

删除的文本 130, 140 

图表 301 



严重性 


要点 , 合并的文件 141 

益处 3, 15 


任务树 198 

需求列表 172 

需求树 171 

主题列表 214 

主题树 213 

移动 


确认操作 308 

任务 225 

文件 225 

文件夹 225 

文件状态 , 在命令行 345 

主题 225 

已读 240, 315 


任务 199, 239 

需求 172 

主题 239 

已读项 239 

已修改 

定义 371 

抑制 

行数 , 在命令行 340 

隐藏 

任务栏按钮 (StarTeam Toolbar 窗口 ) 37 

StarTeam Toolbar 系统托盘图标 37 


引用 

初始 272 

概述 269 

Reference 选项卡 12 

通过分支视图创建 273 

通过手动共享创建 277 

通过添加项创建 275 

项 270 

向上浮动 276 

向上和向下浮动 277, 278 

向下浮动 276 

主题 217 

映射驱动器 

作为 StarTeam 文件夹 63 

用户 

定义 371 

分配给任务 203 

用户指南 

概述 4 

右键单击 147, 182 

优先级 



任务 203 

语法 

命令行 322 

语法约定 

变量 2 

互斥选项 2 

选项 2 

预览 


约定 

菜单选择 2 

粗体 2 

固定间距字型 2 

括号 2 

竖线 2 

斜体 2 

运算符 

关系 71 

逻辑 71 

允许 

过程项 244 

Z 

z 群集图表 302 

索引 397

责任 



增量存储 

定义 371 

展开 

任务树 198 



需求树 172 

主题树 213 

折叠 

任务树 198 



需求树 172 

主题树 213 

制表位 


支持 1 

只读 

参考视图定义 371 

文件 311 

只读视图 


只读文件 


在命令行 328, 335, 337, 343 

中 

严重性 184 

中断 

锁定 232 

锁定 , 在命令行 343 

主题 








标志 240 

操作 223 

查看引用 217 

查找 235 

创建 215 


打印 236 

定义 371 




附件 217 


概述 18 

共享 226 


管理 211 

合并 235 

回滚 230 


历史 212 

链接 212, 261 

内容 220 

排序 214 

配置 230 

日期范围 215 

Show All 215 

筛选器 214 

删除 241 



属性 217 

双击 213 

通知 15, 316 

图标 213 

图表 293 


移动 225 




作者 215 

主题列表 

排序 68 

益处 214 

主题树 

定义 371 

图标 213 

益处 213 

展开 213 

折叠 213 

主题字段 114 

主要排序 

定义 368 

注释 


任务修订 209 

为文件编辑 235 

注销 31 

转换 

eol 328, 334, 336, 340, 349, 353 

行尾 328, 334, 336, 340, 349, 353 

状态 

bco 命令中的文件 354 

定义 371 

对签入和签出文件的影响 159 

更改请求 182, 185 


任务 202 

文件 27, 312 

文件更新 153 

文件 , 在命令行 333, 334, 336, 338, 340, 341, 342, 

343, 344, 346, 347, 350 

由校验和确定 312 

状态栏 

菜单的帮助 13 

查询 13 

上部窗格统计信息 13 

视图配置 13 


桌面 


自定义 

定义 366 



自定义字段 


任务 207 

文件 168 

主题 216 


自动登录 40 

覆盖 39 

自动刷新 

定义 371 

子目录 

请参阅文件夹和子文件夹。 

子任务 

参阅任务。 

子文件夹 


命令行 325 

请参阅文件夹和子文件夹。 

子需求 

创建 173 

字段 

常用 83 

高级 83 

文件 147 

字母数字 

定义 371 

字体 

图表 305 


资源 

分配 203 

组件 

定义 371 

最后测试的内部版本 


最新修订 

定义 372 

左窗格 7 

作者 

定义 372 


主题 215 

索引 399

StarTeam

Sie wollen auch ein ePaper? Erhöhen Sie die Reichweite Ihrer Titel.

Template löschen?

Als Template speichern?