StarTeam入门指南,StarTeam

cpp 10
入门指南 StarTeam® BorlandSoftwareCorporation100EnterpriseWayScottsValley,California95066-3249 BorlandSoftwareCorporation可能拥有涵盖本文档主旨的专利和/或待批专利申请。
要获得适用专利列表,请参阅产品光盘或About(关于)对话框。
提供本文档并不表示向您发放这些专利的任何许可证。
版权所有©1995–2004BorlandSoftwareCorporation。
保留所有权利。
所有Borland品牌名和产品名均为BorlandSoftwareCorporation在美国和其它国家/地区的商标或注册商标。
其它所有标记均为其各自所有者的财产。
有关第三方条件和免责声明,请参阅产品光盘上的“发行说明”。
美国印制。
目录 第1章 简介
1 StarTeam联机文档..................2 联系Borland支持...................2 文档约定.......................3 第2章 StarTeam概述
5 StarTeam的组件...................6 什么是版本控制?.................6 什么是更改请求?.................6 什么是需求?...................6 什么是任务?...................7 什么是主题?...................7 什么是审核日志?.................7 如何使用入门指南...................7 第3章 StarTeam的管理
9 配置StarTeamServer.................9 创建服务器配置..................10 修改服务器配置..................15 启动和停止服务器配置...............20 创建StarTeam项目..................21 什么是项目?...................21 创建项目之前...................22 创建项目......................22 创建项目之后...................25 向项目视图添加文件.................26 创建其它项目视图...................28 创建分支视图...................29 创建视图标签.....................32 使用提升状态.....................33 将视图标签提升到下一状态............35 自定义项属性.....................37 更改属性字段.....................37 翻译自定义字段....................40 添加组.........................41 添加用户.......................42 设置访问权限.....................45 查看审核日志.....................50 第4章 StarTeam的使用 53 学习如何使用StarTeam................53 启动StarTeam....................54 添加服务器配置....................54 登录到StarTeam...................56 打开现有项目.....................57 使用项目视图窗口...................59 了解StarTeam文件夹................60 向StarTeam层次添加文件夹...........60 修改文件夹属性..................64 将文件置于版本控制之下...............65 添加文件......................65 修改文件以创建新修订...............67 查看修订历史...................72比较文件修订...................73签出先前的修订..................74从样例项目中删除文件夹.............76处理更改请求....................76创建更改请求...................76解决更改请求...................77创建主题和响应...................79创建链接.......................82从样例项目中删除项.................83创建图表.......................84创建报告.......................85 索引 87 i ii 章 简介第1章 StarTeam文档集说明了如何使用StarTeam产品套件中的应用程序。
根据贵公司已获准并安装的StarTeam产品,可能并非这些手册中所述的所有应用程序都存在于您的系统上。
■StarTeam安装指南 提供StarTeam产品的分步安装说明以及每种产品的系统要求。
■StarTeam入门指南 概述介绍StarTeam并就配置管理进行指导。
第3章“StarTeam的管理”说明如何执行必要的管理功能,如配置服务器以及添加用户和组。
第4章“StarTeam的使用”说明团队成员在日常工作中最常用的StarTeam功能,如签入和签出文件、发送消息等。
■StarTeam用户指南就使用StarTeam跟踪和管理文件更改、在团队成员间共享文件、访问文件的先前版本以及其它功能做了详细介绍。
还说明了如何使用更改请求、需求、主题和任务。
■StarTeam管理员指南描述配置和维护StarTeamServer、创建和维护StarTeam对象以及管理用户访问所需的步骤。
其中就StarTeamServer与现有PVCS及VisualSourceSafe文件的配合使用进行了介绍。
■StarTeamExtensionsUser'sGuide(StarTeamExtensions用户指南)说明如何设计和管理StarTeamExtensions,如备选属性编辑器(APE)。
还述及了StarTeamWorkflowDesigner和StarTeamNotificationAgent。
第1章:简介
1 StarTeam联机文档 ■StarTeamMPXServerAdministrator'sGuide(StarTeamMPXServer管理员指南) 提供有关StarTeamMPXServer系统的基本操作和体系结构的信息,包括安装和配置说明。
■StarDiskUser'sGuide(StarDisk用户指南) 说明StarDisk客户机的安装及使用过程,它是一个虚拟文件系统,借此可从基于Windows的应用程序(如Microsoft®Windows®Explorer或Netscape®)访问StarTeamServer所管理的文件。
StarTeam联机文档 安装StarTeam时,还会将StarTeam手册的联机版本放在StarTeam或StarTeamServer的OnlineDocumentation文件夹中。
下表列出了StarTeam联机手册及其文件名。
您所收到的联机手册取决于贵公司获准的StarTeam产品以及所安装的StarTeam客户机。
表1.1 StarTeam联机文档 文件名 StarTeam手册 install.pdfstart.pdfuser.pdfadmin.pdfworkflow.pdf adminMPX.pdf stardisk.pdf StarTeam安装指南 StarTeam入门指南 StarTeam用户指南 StarTeam管理员指南 StarTeamExtensionsUser'sGuide(StarTeamExtensions用户指南) StarTeamMPXServerAdministrator'sGuide(StarTeamMPXServer管理员指南) StarDiskUser'sGuide(StarDisk用户指南)(仅限Windows客户机) 重要说明 这些联机手册以Adobe的可移植文档格式(.pdf)分发,并且要求用AdobeAcrobatReader4.0或更高版本来显示。
AdobeAcrobatReader的安装程序位于StarTeam安装光盘的\Docs文件夹中。
也可从Adobe网站免费获得该阅读器,网址为。
联系Borland支持 Borland致力于在咨询和技术支持领域提供世界级服务。
我们在向开发者和企业客户提供支持方面拥有15年以上的经验。
我们合格的技术支持工程师们已做好准备,根据具体个案或是通过建立长期合作关系,处理您的支持需求。
Borland在世界范围内提供支持,通过交付及时、可靠的服务来确保每个客户的业务均能获得成功。
有关Borland支持服务的详细信息,请访问我们的网站,网址为。
您还可以通过网站访问许多新闻组,它们是用户交换信息、意见和技巧的场所。
要获得免费产品新闻组的最新列表,请访问/newsgroups/。
还可以通过访问BorlandDeveloperNetwork(Borland开发者网络)站点,网址为。
在此Borland社区可以访问到产品特定的信息、文章、代码示例和新闻。
寻求支持时,请准备好提供有关以下方面的完整信息:具体环境、所用产品的版本以及问题的详细说明。
要获得第三方工具或文档方面的支持,请与工具的供应商联系。
2StarTeam入门指南 文档约定 本指南使用以下文档约定: 注提示重要说明注意 选择File(文件)>表示级联菜单命令。
在此情况下,请从菜单栏选择File(文件), Exit(退出) 然后从下拉菜单选择Exit(退出)。
固定间距字体 表示必须输入的信息;也用于表示来自系统的消息。
斜体 表示应以具体的文件名、子文件夹等替换的手册名、对话框名称和 信息。
粗体 突出显示菜单名、选项、按钮或字段;也用于表示新术语或需要特
别注意的项。
[] 包围可选的语法。
| 分隔互斥的选择项。
标识补充信息。
标识关于备选步骤的信息或其它有用但不重要的信息。
标识对于完成任务非常重要的信息。
标识可能导致数据丢失的操作或为确保数据不丢失而必须遵循的过程。
第1章:简介
3 文档约定 4StarTeam入门指南 章 第2章StarTeam概述 Borland®StarTeam®通过自动化的配置和更改管理增强了对于开发过程的控制。
配置管理最常用于软件项目,此类项目需要版本控制、过程管理、内部版本管理以及对并行开发的支持。
但鉴于StarTeam的强大能力,也可利用它来执行其它各种侧重细节的任务,包括技术写作、金融预测、法律案件以及其它所有涉及多个部分和频繁修订的工作。
除了其强大的版本控制功能之外,StarTeam还提供了灵活的集成解决方案,使得您可以:■跟踪缺陷以及建议对产品或项目进行的更改。
■创建需求或从Borland®CaliberRM®导入需求,同时将用户和文件分别分配和链接到 特定需求。
■创建分配给团队成员的任务并对其进度进行监视。
如果需要,可将此功能与 Microsoft®Project集成在一起。
■存储关于项目中所做决定的线索化讨论。
StarTeam系列包括StarTeamServer、StarTeam(Windows和Cross-Platform客户机)、StarTeamWebEdition、StarDisk以及与第三方产品的各种集成,其中包括TestDirector、Borland®JBuilder®以及MicrosoftProject。
StarTeam服务器和客户机工作站彼此连接以维护储存库、存储对文件所做的更改以及授予用户对项目数据的访问权。
第2章:StarTeam概述
5 StarTeam的组件 StarTeam的组件 为全面支持开发过程,StarTeam提供了五个集成式组件,包括文件版本控制、更改请求、需求、任务、主题和审核日志。
这些组件将在下节中进行讨论。
什么是版本控制? 简而言之,版本控制是指对诸多项的多个版本的管理和维护,这些项以可靠、组织合理的存档构成了整个项目,团队成员可以方便地对该存档进行访问。
虽然该术语常指文件管理,但StarTeam也会存储对更改请求、需求、主题和任务的修订。
StarTeam用户可以签出某个文件(通常是最近的修订,称为最新版本)、对其进行修改,然后签入已修订的版本,而不会改写以前的版本或其他人的工作。
签入到StarTeam中的每个文件均以特殊的专有格式存储,从而可以标记、维护和跟踪多个修订。
可在服务器上保留项目文件的任意多个先前修订。
StarTeamFile组件通过提供以下功能精简了项目资源的管理过程:■用鼠标指向并单击即可访问项目工作文件。
■版本历史。
■简便的签入和签出功能。
■本地文件状态。
■锁定文件以防用户间发生冲突。
■修订比较。
■命令行访问。
■无限制的文件类型和数目。
■与诸多编程环境(如Jbuilder)的兼容性。
什么是更改请求? 在StarTeam中,更改请求组件提供了一个缺陷跟踪系统,借此可以记录产品、项目或服务中的缺陷并提出可能的改进建议。
像其它此类系统一样,StarTeam也具有搜索和报告机制,可以使用它们来监视指定由您修复或测试的缺陷。
除此之外,利用更改请求组件还可以:■将更改请求放入特定的文件夹。
■将更改请求链接到文件、需求、主题或其它更改请求。
■在签入文件的同时将缺陷标记为已解决,在一个应用程序中执行一项操作。
■自动将下一个内部版本标签与已解决的缺陷相关联,使测试者准确知道应该测试哪 一个内部版本。
■自动接收与您可能需要修复或检验的更改请求有关的电子邮件。
什么是需求? 采用需求驱动式开发过程,公司可以防止高消耗和代价高昂的误解,并且可以缩短上市时间。
为实现此目的,可以使用StarTeam内置的需求组件作为基本工具或从BorlandCaliberRM导入复杂的需求。
通过在StarTeam中使用需求,业务分析员、管理者、开发者、QA职员及其他人可以:■以层次化格式组织业务、用户和功能需求。
■指出需求间的依存关系。
6StarTeam入门指南 如何使用入门指南 ■随时查看所有需求层。
■按重要程度确定需求优先级。
■确定需求更改的影响。
■使用需求进行工作估计。
■确定创建需求的人员。
■通知将要负责实现需求的人员。
■在整个生命周期对需求进行跟踪,从提交时起直到完成或拒绝。
■通过将需求链接到文件、更改请求和主题来提供需求上下文。
什么是任务? 利用任务组件可以创建任务列表和分配工作。
借助该组件,团队成员可以指出何人应在何时做何事、查看当前任务状态、估计完成某项任务所需时间、记录完成该任务所花时间以及将估计时间与实际时间进行比较。
由于StarTeam既包含版本控制系统又包含更改请求系统,所以利用它还可以将任务链接到与其相关联的文件、产品缺陷或建议。
任务组件既可以独立使用,又可以对来自MicrosoftProject的数据进行交互操作。
它能以树格式或列表格式显示任务,前一种格式可清楚地显示任务与子任务之间的关系,后一种格式允许对任务进行排序、分组、查询,或选择所要显示的特定字段。
为了提高效率,每项任务均显示有图标,用以标识任务的状态、优先级、里程碑以及需要注意的事项。
什么是主题? 主题是指线索化对话,即指示消息相关方式的系列消息。
每一系列消息构成一个树,以初始消息为树根。
可将主题组件所提供的线索化对话置于特定的项目文件夹并链接到特定的项目项。
例如,可将某个主题链接到由该主题讨论产生的更改请求和文件修订。
什么是审核日志? StarTeam审核日志是按时间顺序所做的记录,其中累积的数据记载了对文件夹、文件、需求、更改请求、任务和主题所执行的操作。
每个日志条目均显示有执行操作的用户、执行操作的日期和时间、类名(项类型)、事件(操作类型)、视图名以及项目名。
使用筛选器或查询可以查找特定项的所有条目。
对于大多数项而言,可能的事件有添加、分支、注释、创建、删除、修改、移动自、移动至和共享。
对于文件,事件可能还包括转换、编辑、改写项、锁定、断开锁以及解锁。
日志条目本身不能进行移动、共享、修改或分支。
如果StarTeam窗口的Audit(审核)选项卡未显示任何条目,可能是管理员已禁用了审核日志功能。
如何使用入门指南 入门指南简要概述了StarTeam易于使用的工具。
其中还提供了示范练习,以使管理员和用户得以了解对其工作至关重要的活动。
■StarTeam的管理阐述了如何创建和配置试用服务器配置、创建项目、创建视图和标 签、向项目添加用户以及其它诸如此类的任务。
■StarTeam的使用描述了如何执行基本的StarTeam操作,如启动应用程序、打开现 有项目、创建文件夹、添加文件等。
Borland提供的StarTeam分为Standard、Enterprise和EnterpriseAdvantage三个等级,其功能依次递增。
当管理员安装StarTeam的试用服务器配置时,它将处于评估模式并具有EnterpriseAdvantage等级的所有功能。
在贵公司注册StarTeamServer及客户机之后,它将具有您的许可证所允许的功能。
第2章:StarTeam概述
7 如何使用入门指南 要完成练习,管理员必须首先安装StarTeamServer(请参阅StarTeam安装指南)。
然后,管理员必须在运行StarTeamServer的计算机上创建试用服务器配置。
试用服务器配置包含StarDraw样例项目。
如果管理员不愿使用StarDraw项目,可以创建一个专为自己公司设计的自定义项目。
一旦有了样例项目,客户机用户便可开始进行应用程序学习。
注“备选属性编辑器”(APE)是为了管理项的工作流而创建的表格。
由于本指南无法获悉贵公司所使用的自定义APE和表格,所以它只就在StarTeam中使用一组标准表格进行教学。
评估StarTeam时,默认情况下会关闭StarTeamExtensions中的APE功能,以便您能看到每个组件的标准属性对话框。
有关APE的详细信息,请参阅StarTeamExtensionsGuide(StarTeamExtensions指南)。
8StarTeam入门指南 章 第3章StarTeam的管理 StarTeam管理员负责安装和配置StarTeamServer、创建StarTeam项目、添加用户、授予访问权限等。
本章介绍开始使用StarTeamServer和StarTeam所必需的基本管理功能:■创建服务器配置。
■修改服务器配置。
■启动和停止服务器配置。
■创建StarTeam项目。
■创建项目视图。
■创建视图标签。
■使用提升状态。
■自定义项属性。
■向项目添加用户。
■设置访问权限。
■查看审核日志。
配置StarTeamServer 作为管理员,您的第一项任务是按照StarTeam安装指南中的说明安装、配置和注册StarTeamServer。
接着,必须在安装StarTeamServer的计算机上创建一个实例(称为服务器配置)。
必须先运行一个服务器配置,您和您的团队成员才能访问StarTeam并完成本指南中的练习。
服务器配置定义了以下内容:■用于访问服务器的选项集,其中包括端点和加密级别。
■存储项目数据、数据库DSN及其它相关信息的数据库的位置。
■储存库及其相关文件夹的位置。
第3章:StarTeam的管理
9 配置StarTeamServer 创建服务器配置 可以使用ServerTools实用程序创建服务器配置。
创建服务器配置前,需要为配置确定一个唯一的名称。
此名称不区分大小写,且不能包含冒号(:)、返斜线(\)或正斜线(/),但可包含空格或撇号(')。
还必须设置服务器配置所用的数据库。
一个数据库只能包含一个服务器配置;但是,其它应用程序可以与StarTeam共享一个数据库。
StarTeamServer将服务器日志文件放在作为服务器配置的储存库路径而指定的位置。
首次启动新服务器配置时,该服务器会在同一位置创建Attachments文件夹、HiveIndex及其它文件夹。
这些文件夹由该服务器维护;请勿删除它们。
可使用ServerAdministration(服务器管理)对话框更改其中一些文件夹的路径。
用于存储服务器配置存档文件的初始配置单元随服务器配置一同创建。
必须提供此配置单元的存档路径和高速缓存路径。
默认路径为repository_path\DefaultHive\Archives和repository_path\DefaultHive\Cache。
如果需要,以后可使用HiveManager(配置单元管理器)对话框更改这些路径的位置。
一个服务器配置可有若干配置单元,每个单元都有各自的存档路径和高速缓存路径。
配置单元使用StarTeamNative-II储存仓格式,它是StarTeam2005中引入的一个增强功能。
此储存仓格式允许更大的文件修订、更多的存档存储位置以及更快速有效的性能。
有关StarTeam2005中存档存储方面的信息,请参阅StarTeam安装指南和StarTeam管理员指南。
10StarTeam入门指南 配置StarTeamServer 使用ServerTools创建服务器配置:1在安装了StarTeamServer的计算机上,选择开始>程序>StarTeam>StarTeam Serverx.x>StarTeamServer。
出现ServerTools(服务器工具)对话框。
2单击New(新建)。
此操作将显示CreateaNewConfiguration(创建新配置)对话框,可在其中定义新配置。
第3章:StarTeam的管理11 配置StarTeamServer 3在Configurationname(配置名称)文本框中输入一个唯一的名称。
例如,您可以输入StarDraw。
4在RepositoryPath(储存库路径)文本框中,输入或浏览到StarTeamServer将创建服务器配置文件的位置。
5从DatabaseType(数据库类型)列表框中选择一种数据库类型。
可以选择MicrosoftSQLServer/MSDE和Oracle。
一旦创建了服务器配置,便无法更改数据库类型。
6选择或取消选择CreatenewStarTeamdatabaseandODBCdatasource(创建新StarTeam数据库和ODBC数据源)。
默认情况下会选中此选项。
7在InitialHiveSettings(初始配置单元设置)中,选择Default(默认)或Custom(自定义)配置单元选项。
8如果选择Default(默认)配置单元,则更改储存库路径将会更改默认配置单元设置。
如果选择Custom(自定义)配置单元,则更改储存库路径不会产生这种影响。
9如果创建的是Custom(自定义)配置单元,可以覆盖默认配置单元设置。
可更改以下任何字段:■Name(名称):配置单元的唯一名称。
默认名称是DefaultName。
■Archivepath(存档路径):配置单元Archives目录的路径。
默认值为■Cachepath(高速缓存路径):配置单元Cache目录的路径。
默认值为■Maximumcachesize(最大高速缓存大小):“高速缓存”可以使用的最大硬盘空间兆字节数。
默认值为设置此选项时可用磁盘空间的20%。
■Cachecleanupinterval(高速缓存清理时间间隔):相邻的高速缓存清理/刷新操作之间间隔的秒数。
默认值为600。
范围是60(1分钟)到3153600(1年)。
■Storagelimitthreshold(存储限制阈值):总磁盘空间中可用于配置单元的百分比。
达到此百分比时,便不能再向配置单元添加存档。
默认值为总磁盘空间的95%。
10填完上述信息后,单击Next(下一步)。
此操作将显示Createa[Database]DataSource(创建[Database]数据源)对话框的第一个屏幕。
必须输入的信息取决于所选择的数据库。
创建完服务器配置后,便不能更改ODBC数据源。
MicrosoftSQLServer或MSDE数据库要求输入以下信息:■Hostname(主机名)■SysAdmin(sa)password(系统管理员密码)■ODBCdatasourcename(ODBC数据源名称)■Newdatabasename(新数据库名)■Newdatabaseloginname(新数据库登录名)■Newdatabasepassword(新数据库密码)■Confirmdatabasepassword(确认数据库密码) 12StarTeam入门指南 配置StarTeamServer 以下是CreateaMicrosoftSQLServer/MSDEDatabase(创建MicrosoftSQLServer/MSDE数据库)对话框的示例: 对于Oracle数据库,请在以下字段中输入文本:■TNSservicename(TNS服务名)■Systempassword(系统密码)■NewODBCdatasourcename(新ODBC数据源名称)■Newschemausername(新模式用户名)■Newschemapassword(新模式密码)■Confirmschemapassword(确认模式密码)11填完上述信息后,单击Next(下一步)。
第3章:StarTeam的管理13 配置StarTeamServer a对于MicrosoftSQLServer或MSDE数据库,将出现CreateaMicrosoftSQLServer/MSDEDataSource(创建MicrosoftSQLServer/MSDE数据源)对话框。
1查看该对话框。
2如果要编辑数据文件和事务文件的大小或位置,请取消选中Usedefault configuration(使用默认配置)并进行更改。
Microsoft根据许可证将MSDE数据库的大小限制为2048MB。
如果需要更大的数据库,必须购买MicrosoftSQLServer许可证。
3如果信息正确,请单击Finish(完成)。
将显示一条消息,指出已成功创建服务器配置。
b对于Oracle数据库,将出现CreateanOracleDataSource(创建Oracle数据源)对话框。
1查看该对话框。
2根据需要编辑Tablespacename(表空间名)、InitialSize(初始大小)和Location(位置)。
3如果信息正确,请关闭该窗口。
将显示一条消息,指出已成功创建服务器配置。
12完成新服务器配置后,它会出现在ServerTools(服务器工具)对话框中,且其状态为New(新)。
选择该配置,然后单击StartServer(启动服务器)。
StarTeamServer随即会初始化数据库并创建默认配置单元和文件夹。
有关详细信息,请参阅第20页的“启动和停止服务器配置”。
初始化过程可能需要几分钟。
StarTeamServer完成此活动后,该服务器配置的Status(状态)列会从New(新)变为Running(正在运行)。
13在服务器配置开始运行后,单击Exit(退出)关闭ServerTools(服务器工具)对话框。
14StarTeam入门指南 配置StarTeamServer 修改服务器配置 通过从StarTeam菜单栏中选择Tools(工具)>ServerAdministration(服务器管理)或者使用ServerAdministration实用程序,都可以修改服务器配置。
首次启动新服务器配置时,StarTeamServer会自动将服务器配置选项以其默认值添加到数据库中。
请务必查看这些选项,因为您可能希望更改默认设置。
修改服务器配置:1启动在前面的练习中创建的服务器配置(如果它尚未运行)。
a在安装了StarTeamServer的计算机上,选择开始>程序>StarTeam>StarTeamServerx.x>StarTeamServer。
出现ServerTools(服务器工具)对话框。
b选择要启动的服务器配置。
c单击StartServer(启动服务器)。
服务器配置完成启动过程后,Status(状 态)列会变为Running(正在运行)。
2选择开始>程序>StarTeam>StarTeamServerx.x>ServerAdministration。
出 现ServerAdministration(服务器管理)对话框。
3如果新创建的服务器配置出现在左窗格所显示的列表中,请将其选定。
然后转到步骤
6。
第3章:StarTeam的管理15 配置StarTeamServer 如果新服务器配置未出现在列表中,请单击AddServer(添加服务器)显示AddServer(添加服务器)对话框。
然后转到步骤
4。
4在AddServer(添加服务器)对话框中:a在Serverdescription(服务器说明)文本框中输入服务器名。
b在Serveraddress(服务器地址)文本框中输入服务器的机器名或IP地址。
c输入正确的TCP/IPendpoint(TCP/IP端点)信息。
d(可选)如果希望压缩在您的计算机与该服务器配置之间传输的数据,请选中CompressTransferredData(压缩传输数据)复选框。
e(可选)如果要防止未授权方通过不安全的网络线路读取在您的计算机与该服务器配置之间传输的数据,请选中Encryption(加密)类型复选框。
加密类型(从上到下)按速度排序。
每种加密类型都比其上面的类型慢,但更安全。
输入服务器信息后,一定要记下服务器配置名、IP地址、端点和加密级别。
在从StarTeam客户机添加对该服务器配置的访问权时需要此信息。
5完成后,单击OK(确定)。
此操作将使您返回到ServerAdministration(服务器管理)对话框。
此时,其中列出了新的服务器配置,从而可以选择它。
6单击ConfigureServer(配置服务器)。
出现LogOnto[server:port](登录到[server:port])对话框。
7在Username(用户名)字段输入Administrator。
8在Password(密码)字段输入Administrator。
请记住,密码区分大小写。
9单击OK(确定)。
16StarTeam入门指南 配置StarTeamServer 10此时将出现StarTeamServerConfiguration(StarTeam服务器配置)对话框。
在此对话框中,可以查看、添加或更改服务器配置信息。
第18页的表3.1描述了此对话框各选项卡上已有的选项。
11查看和修改完服务器配置信息后,单击OK(确定)。
12根据所修改的选项,StarTeamServer可能会显示以下消息: Serverconfigurationchanged.Theservermustberestartedforthechangestotakeeffect.(服务器配置已更改。
必须重新启动服务器才能使更改生效。
)重新启动服务器配置:■在ServerAdministration(服务器管理)对话框中,单击ShutDownServer(关闭服务器)。
■在ServerShutdown(服务器关闭)对话框中,单击ShutdownAndRestartSelectedServer(关闭并重新启动选定服务器)。
13单击Close(关闭)以关闭ServerAdministration(服务器管理)对话框。
第3章:StarTeam的管理17 配置StarTeamServer 表3.1 服务器配置选项 选项 默认值 General(常规)选项卡 Serverstartuplogfile(服务器启动日志文件) Attachmentspath(附件路径) ..\RepositoryPath\server.log ..\RepositoryPath\Attachments Logonsequencetimeout(登录序列超时) Inactivitytimeout__minutes(不活动超时__分钟) Excludenamedusers(排除指定用户) 60秒关禁用 Reconnecttimeout___minutes(重新连接超时___分钟) Enablee-mailsupport(启用电子邮件支持) 30分钟关 SMTPserver(SMTP服务器) Port(端口) 禁用禁用 Audits(审核)选项卡 Enableaudit 开 generation(启用审 核生成) Purgeauditentries关olderthan__days (清除超过__天的审核条目) Database(数据库)选项卡 Databasetype(数据库类型) 禁用 DSN 禁用 Pooledconnections10(池连接) 注释 只读;创建新服务器配置时指定的路径。
可编辑路径;StarTeamServer创建的文件夹。
在此时间段中未完成的所有登录都将失败。
如果选择了此选项并设置了超时限制,将会自动注销在更长一段时间不活动的用户。
如果选择了此选项,则即使指定用户超过指定的不活动超时限制,系统也不会将其注销。
仅当选择了InactivityTimeout(不活动超时)并设置了时间限制时,此功能才可用。
确定客户机在失去与服务器的连接后须得在多长时间内重新建立连接。
允许用户从StarTeam内部通过电子邮件将各项发送给其他用户,即使当时收件人未在运行StarTeam也可以。
必须启用此功能才可选择电子邮件通知选项。
启用电子邮件支持时,必须为每个用户输入电子邮件地址。
如果启用了电子邮件则为必需项。
如果启用了电子邮件,则默认SMTP端口为25。
审核日志数据存储在服务器配置数据库中;如果数据需要太多空间,则可以禁用此选项。
自动删除超过指定天数的审核条目,以最大程度地减少所需的日志空间数量。
如果启用此选项,默认值为90天。
可以编辑天数。
只读;仅当创建了服务器配置时,方可设置数据库类型。
只读;仅当创建了服务器配置时,方可设置该项。
增加池连接的数量可提高数据库的吞吐量。
Borland建议对MicrosoftSQLServer将该项设置为20-25。
18StarTeam入门指南 配置StarTeamServer 表3.1 服务器配置选项(续) 选项 默认值 注释 Native-IVault(Native-I储存仓)选项卡(对于“Native-II储存仓”不可用) Vaultpath(储存仓路径) ..\RepositoryPath\Vault 可编辑路径;StarTeamServer创建的文件夹。
Diskcachepath(磁盘高速缓存路径) ..\RepositoryPath\Vault\Cache 可编辑路径;StarTeamServer创建的文件夹。
Archivepath(存档路径) ..\RepositoryPath\Vault\Archive 可编辑路径;StarTeamServer创建的文件夹。
Verifydatabaseat关 startup(启动时验证数据库) Borland建议仅在还原备份后或遇到数据库问题时验证数据库。
Attemptautomatic recovery(尝试自动恢复) 禁用/关 当选择了Verifydatabaseatstartup(启动时验证数据库)选项时可用;如果启用,验 证实用程序会协调服务器配置数据库与存档之间的差异。
serveron errors(出现错误时停止服务器) 禁用/关 如果验证实用程序报告错误,此选项会使服 务器停止运行;当选择了Verifydatabaseatstartup(启动时验证数据库)选项时可用。
Maximumcache size(最大高速缓存大小) 100MB Borland建议开始时使用默认大小,然后根据需要进行修改。
Vaultfilelocktime limit(储存仓文件锁定时间限制) 60秒 Borland建议开始时使用默认大小,然后根据需要进行修改。
Cacherefresh interval(高速缓存刷新时间间隔) 10秒 Borland建议开始时使用默认大小,然后根据需要进行修改。
Notifications(通知)选项卡 Enablee-mail 关 notification(启用电 子邮件通知) 当选择了Enablee-mailsupport(启用电子邮件支持)、启用了SMTPserver(SMTP服务器)并指定了SMTP服务器的Port(端口)时,此选项可用。
如果启用,则在 出现以下情况时会通知用户:用户被指定负 责某一更改请求;用户所负责的需求或任务 发生了变化;用户作为收件人的主题发生了 变化。
Protocol
(协议)选项卡 TCP/IPendpoint(TCP/IP端点) 49201 在创建服务器配置期间选择。
TCP/IPencryption levels(TCP/IP加密级别) 不加密 此选项用于为通过TCP/IP传输的数据设置最低加密级别;使用Add(添加)、Remove(删除)和Modify(修改)按钮还可添加其它加密级别。
EventHandlers(事件处理程序)选项卡 Eventhandler 无 (事件处理程序) 此选项允许输入或选择事件处理程序。
Eventhandler 开 description(事件 处理程序说明) 此选项允许对所选事件处理程序进行说明。
第3章:StarTeam的管理19 配置StarTeamServer 表3.1 服务器配置选项(续) 选项 默认值 注释 DirectoryService(目录服务)选项卡 Enabledirectory 关 servicesupport(启 用目录服务支持) 使用现有目录服务验证用户登录ID和密码。
对于每个要针对目录服务器验证的用户,必 须在NewUserProperties(新用户属性)或UserProperties(用户属性)对话框中选择Validatewithdirectoryservice(使用目录服务验证)选项,并输入DistinguishedName(标识名)。
StarTeamServer还必须在与目录服务器相关的受信域中。
Host(主机) 无 必填字段;最多254个字符的字母数字值。
对于ActiveDirectory,输入目录服务器的主机名、IP地址或域名。
如果使用域名,则StarTeamServer会联络该域中使用指定端口的第一个ActiveDirectory活动副本。
对于OpenLDAP,输入目录服务器的主机名或IP地址。
Port(端口) 636(安全端口) 目录服务器所用的端口号。
默认值为安全端口636,即ActiveDirectory的加密端口。
Useasecureport开(使用安全端口) 指示端口是安全的(默认)还是非安全的。
Diagnostics(诊断)选项卡 Traceoperationsthattakeatleast___milliseconds(追踪至少用时___毫秒的操作) 0毫秒 创建允许追踪命令的.trc文件。
将追踪持续时间等于或超过指定毫秒数的命令。
如果使 用0(默认值),将会追踪所有命令。
Unexpected 关 conditions(意外 情况) 为断言(代码号为8的服务器日志条目)创建诊断(.dmp)文件。
Errors(错误) 关 为例外(代码号为4的服务器日志条目)创建诊断(.dmp)文件。
启动和停止服务器配置 可按本节所述使用ServerTools实用程序来启动和停止服务器配置。
启动服务器配置: 1在安装了StarTeamServer的计算机上,选择开始>程序>StarTeam>StarTeamServerx.x>StarTeamServer。
出现ServerTools(服务器工具)对话框。
2选择要启动的服务器配置,然后单击StartServer(启动服务器)。
3根据所选的服务器配置,将发生以下事件之一: ■如果服务器配置是在StarTeam2005中创建的,或其文件已完全转换为Native-II格式,则系统继续执行启动操作。
■如果服务器配置定义了一个或多个配置单元,但包含仍为Native-I格式的文件且关闭了转换,则消息框将指出:“TherearefilesinthisserverconfigurationthathavenotbeenconvertedtotheNative-IIformatandconversionisturnedoff.Wouldyoulikeconversionturnedon?
”(此服务器配置中有尚未转换为Native-II格式的文件且转换已关闭。
是否要开启转换?)如果显示此消息,请单击Yes(是)或No(否)。
系统随即会继续启动操作。
■如果服务器配置无关联的配置单元(即,它完全为Native-I格式),则消息框将指出:“ThisserverconfigurationhasnotbeenconvertedtotheNative-IIformat.Ifyoustarttheservernow,adefaulthivewillbecreatedbecauseallnewfilesmustbeplacedinaNative-IIVaulthive.ClickOKtostarttheserver(anduseadefaulthive)orClickCanceltocreateyourownhiveusingtheHiveManager.”(此服务器配置尚未转换为Native-II格式。
如果现在启动服务器,将会创建一个 20StarTeam入门指南 创建StarTeam项目 默认配置单元,因为所有新文件均须放在Native-II储存仓配置单元中。
单击“确定”启动服务器(并使用默认配置单元),或单击“取消”使用HiveManager创建自己的配置单元。
)如果单击OK(确定),系统将创建配置单元,然后继续启动操作。
如果选择Cancel(取消),将会退到ServerTools(服务器工具)对话框,从中可以访问HiveManager并创建新的配置单元。
然后可返回到ServerTools(服务器工具)对话框,启动该服务器配置。
4服务器配置完成启动过程后,Status(状态)列会变为Running(正在运行)。
单击Close(关闭)以关闭ServerTools(服务器工具)对话框。
停止服务器配置:1在安装了StarTeamServer的计算机上,选择开始>程序>StarTeam>StarTeamServerx.x>StarTeamServer。
此操作将显示ServerTools(服务器工具)对话框。
2选择要停止的服务器配置,然后单击ShutDown(关闭)。
系统将显示以下消息: 3单击OK(确定)。
4当服务器配置的Status(状态)列从Running(正在运行)变为Ready(就绪) 时,服务器配置即被停止。
5单击Exit(退出)关闭ServerTools(服务器工具)对话框。
创建StarTeam项目 其余练习可在安装并注册完StarTeam服务器和客户机后,从您的计算机工作站来完成。
(如果需要指导,请参阅StarTeam安装指南。
)在这些练习中,您将添加对StarTeam客户机中新服务器配置的访问权、创建StarTeam项目、向项目添加用户和组,并且会学到有关特定StarTeam功能的更多知识。
什么是项目? 从本质上讲,项目是在一组文件夹中按层次分组和管理相关项的一种方法。
通过创建项目,可将文件置于版本控制之下、设置需求、跟踪更改请求、管理任务、审核用户操作以及对项目进行讨论。
可在同一个服务器配置上创建多个项目。
每个项目均至少有一个视图,称为初始视图或根视图。
例如,一个软件产品项目可能包括该产品的功能规格说明、营销需求、源代码以及测试套件方面的文件,它们全都分别存储在初始视图的不同文件夹中。
当产品从一个版本进展到另一版本时,可以创建这些文件夹的附加视图。
可用一个视图表示产品的1.0版本,而用第二个视图表示2.0版本,以此类推。
第3章:StarTeam的管理21 创建StarTeam项目 创建项目之前 StarTeam项目通常建立在文件夹层次基础之上,这些文件夹位于您的计算机上,或位于您在共享文件服务器上的个人目录中。
在下面的图中,左侧窗口显示的是StarDraw样例项目的工作文件夹;右侧窗口显示的是StarTeam项目视图。
工作文件夹窗口 StarTeam视图窗口 不过,您的工作文件夹及其子文件夹不必与该StarTeam项目完全一样。
例如,您可以从StarTeam项目中省略工作文件夹中的子文件夹,或只将现有StarTeam项目中的特定子文件夹复制到工作文件夹。
添加或签入文件时,StarTeam会将这些文件从工作文件夹复制到StarTeam储存库中。
签出文件时,StarTeam会将这些文件从StarTeam储存库复制到工作文件夹中。
注意在进行下面的练习之前,请先通过复制和重命名一个文件夹及该文件夹内的一些文件,在您的计算机上创建一个新文件夹层次。
执行完这一重要步骤后,您便可以放心地对StarTeam功能进行试验了。
创建项目 您可以在任何服务器配置上创建项目,只要您具有在该位置创建项目所需的权限。
创建项目时,必须输入项目名并指定工作文件夹的位置。
创建项目时,会同时在StarTeam中创建该项目的初始视图以及根文件夹。
默认情况下,它们会采纳与项目相同的名称,但如果您愿意,可在以后更改这些名称。
在本练习中,您将通过从您的计算机向StarTeam拖动文件夹和使用NewProject(新建项目)向导来创建一个StarTeam项目。
如果尚未向您的客户机添加服务器配置,可在本练习当中进行此操作。
创建StarTeam项目:1在您的计算机上创建一个名为DemoExercise的文件夹,并在其中放置若干文件。
2选择开始>程序>StarTeam>StarTeamx.x。
22StarTeam入门指南 创建StarTeam项目 3将DemoExercise文件夹从您的计算机拖动到StarTeam主窗口。
出现NewProjectWizard(新建项目向导)。
4如果此前已将服务器配置添加到您的计算机工作站,请直接转到步骤
5。
如果尚未将所需的服务器配置添加到您的计算机工作站,请单击AddServer(添加服务器)。
此操作将显示AddServer(添加服务器)对话框。
在对话框中:a在ServerDescription(服务器说明)文本框中输入StarDraw。
(StarDraw服 务器配置包含StarDraw样例项目,该项目将在后面的练习中使用。
)服务器名必须唯
一。
它不区分大小写,且不能包含冒号(:)、正斜线(/)或反斜线(\),但可包含空格或撇号。
b在ServerAddress(服务器地址)文本框中,输入确切的计算名或IP地址。
如果需要浏览查找确切的名称,请单击Browse(浏览)按钮。
c在TCP/IPEndpoint(TCP/IP端点)文本框中输入端点。
端点是指端口号。
d(可选)选中CompressTransferredData(压缩传输数据)复选框,以压缩在您的计算机与该服务器配置之间传输的数据。
e(可选)如果要防止未授权方通过不安全的网络线路读取在您的计算机与该服务器配置之间传输的数据,请选中Encryption(加密)类型复选框。
加密类型(从上到下)按速度排序。
每种加密类型都比其上面的类型慢,但更安全。
第3章:StarTeam的管理23 创建StarTeam项目 f单击OK(确定)。
重新打开NewProjectWizard(新建项目向导)。
在打开现有项目或从StarTeam菜单栏中选择Tools(工具)>ServerAdministration(服务器管理)时,也可以添加服务器连接。
5从服务器列表框中选择服务器配置,然后单击Next(下一步)继续。
出现LogOnto[server:port](登录到[server:port])对话框。
6输入Administrator作为UserName(用户名),输入Administrator作为Password(密码)。
出现NewProjectWizard:ProjectName(新建项目向导:项目名)对话框。
7在ProjectName(项目名)文本框中输入名称。
如果创建项目时使用的是拖放方法,则默认项目名为所放文件夹的名称。
8在ProjectDescription(项目说明)文本框中输入说明。
24StarTeam入门指南 创建StarTeam项目 9单击Next(下一步)继续。
出现NewProjectWizard:WorkingFolder(新建项目向导:工作文件夹)对话框。
默认的工作文件夹名称为放入StarTeam的文件夹的名称。
请勿更改该名称,因为您将要从此位置添加文件。
10单击Next(下一步)。
出现NewProjectWizard:ChildFolders(新建项目向导:子文件夹)对话框。
11如果工作文件夹有子文件夹,可在此对话框中将其选定,然后单击Exclude(排除)将其从StarTeam文件夹层次中省略掉。
要重新列出已排除的文件夹,请单击Reset(重置)。
12要完成项目,请单击Finish(完成)。
StarTeam随即将在项目窗口中显示初始视图。
创建项目之后 创建项目后,StarTeam窗口的标题栏会依次显示服务器、项目视图、根文件夹和工作文件夹。
StarTeam窗口的左窗格显示在项目的初始视图中可见的文件夹层次。
第3章:StarTeam的管理25 向项目视图添加文件 在下面的窗口中,DemoExercise是根文件夹。
此时,您项目中文件的状态为NotInView(不在视图中),因为尚未将这些文件从您的工作文件夹添加到StarTeam。
如果在上部窗格中选择特定文件,下部窗格中的Details(详细信息)选项卡会显示有关该文件的信息,如文件的名称、状态、修订版本、时间戳和大小。
当在日常工作中使用StarTeam时,您可能需要使用文件筛选器下拉列表(在工具栏中)来显示特定文件组,如“要签出的文件”、“要签入的文件”等。
向项目视图添加文件 第一次显示项目视图时,项目文件的状态为NotInView(不在视图中)。
NotInView(不在视图中)的含义是文件存在于工作文件夹中,但尚未添加到StarTeam,即它们不在版本控制之下。
必须将文件添加到项目视图,这样,所有团队成员才能访问它们并且可在需要时使用过去的修订。
虽然可以一次一个文件夹向项目视图添加文件,但以下练习展示了如何在一次操作中添加各项目文件夹中的所有文件。
向StarTeam项目添加所有文件: 1从左窗格的StarTeam文件夹层次中选择根文件夹。
该文件夹位于列表顶端。
2确保从上部窗格中选择了File(文件)选项卡。
All 3如果文件夹包含子文件夹,请单击StarTeam工具栏上的AllDescendants(所有 Descendants 后代)。
4单击Status:NotInView(状态:不在视图中)分组栏前面的按钮以显示文件。
5从File(文件)或上下文菜单中选择Select(选择)>SelectAll(全选),以突出显示所有文件。
6执行以下一项操作: ■从File(文件)或上下文菜单中选择AddFiles(添加文件)。
AllFiles ■在工具栏上单击AllFiles(所有文件)按钮。
26StarTeam入门指南 上述两项操作都将显示AddFiles(添加文件)对话框。
向项目视图添加文件 7(可选但建议采用)执行以下一项操作: ■在Filedescription(文件说明)文本框中输入所有文件的一般说明。
■选中Promptfordescriptionforeachfile(提示输入每个文件的说明)复选框,以便为每个文件输入单独的说明。
8从Lockstatus(锁定状态)组框中选择适当的选项按钮。
使用Exclusive(独占)或Non-exclusive(非独占)以您的名义锁定文件,或选择Unlocked(解除锁定)选项按钮,使文件在此时保持解锁状态。
其他团队成员可以通过您所选择的锁来了解您是否正在这些文件上工作。
独占锁定表示您打算更改文件。
9选中Deleteworkingfiles(删除工作文件)将从工作站中删除关联的文件,而清除此框会将这些文件保留在工作文件夹中。
在本练习中,请勿删除这些文件。
10如果贵公司实施了过程规则系统,则只有出于明确定义和批准目的才能更改源代码和内容。
必须将添加的所有文件链接到特定的过程项(更改请求、需求或任务)。
要使新文件与特定过程项相关联,请选中Linkandpinprocessitem(链接并固定过程项)复选框。
a如果已选择了活动过程项并且它出现在Item(项)框中,此操作将接受该项。
b如果尚未选择任何过程项,或者您想要选择另一不同的过程项:1单击Select(选择)按钮以打开SelectProcessItem(选择过程项)对话框。
2选择Listallpermitteditems(列出所有允许项)或Listallpermitteditemsassignedtome(列出分配给我的所有允许项)选项按钮。
3选择ChangeRequest(更改请求)、Requirement(需求)或Task(任务)选项卡。
4选择特定项作为活动过程项。
5单击OK(确定)返回到AddFiles(添加文件)对话框。
11如果活动过程项上的工作现已完成,请选中Markselectedprocessitemasfixed/plete(将所选过程项标记为已修复/结束/完成)复选框。
12从Revisionlabel(修订标签)下拉组合框中选择一个标签,或者通过输入名称创建一个新修订标签。
如果计划以后作为一组来检索这些文件,或者将来需要这些文件的特定修订,则添加或创建标签很有用。
第3章:StarTeam的管理27 创建其它项目视图 13如果使用的是Windows客户机,请单击OK(确定)添加这些文件。
14如果使用的是Cross-Platform客户机,您还可以使用其它一些可能有用的选项。
要 访问这些选项:a单击Advanced(高级)。
此操作将显示AdvancedOptions(高级选项)对话 框。
虽然此对话框中的所有选项均非必需,但在某些特定情况下,它们很有用。
b选中PerformEOLconversion(CR-LF)(执行EOL转换(CR-LF))复选框,以控制随这些文件存储的EOL字符。
此复选框的默认设置取决于PersonalOptions(个人选项)的General(常规)选项卡上的EOL设置。
c从下拉列表框中选择适当的FileEncoding(文件编码)。
d单击OK(确定)返回到AddFiles(添加文件)对话框。
e单击OK(确定)添加这些文件。
添加文件后会重新显示项目视图窗口。
这些文件的状态会从NotInView(不在视图中)变为Current(当前),这意味着这些文件属于当前项目视图、处于在版本控制之下,且工作文件夹中的副本与储存库中的最新(最近)修订相同。
创建其它项目视图 创建项目时,默认情况下还会创建该项目的初始视图。
初始视图与项目同名。
根文件夹也是如此,不过这些名称以后都可以更改。
初始视图始终是读/写视图。
其它视图可以为各种类型中的任意一种。
可使用项目视图来限制团队成员看到的项目部分。
例如,开发者可能只需要看到项目的源代码文件夹及其子文件夹;营销人员可能只需要看到营销文件夹及其子文件夹,依此类推。
每个视图可以用不同的文件夹作为其根文件夹。
视图也支持分支并行开发。
例如,可在新视图中对文件和其它数据进行分支,然后开始进行产品的2.0版本,同时却又不妨碍创建1.0版本的服务包。
28StarTeam入门指南 创建其它项目视图 每次打开StarTeam项目时,也都要选择视图。
项目的默认视图通常包含主要开发所使用的配置。
可基于此视图建立其它视图,并且它们可以有不同的行为。
视图通常都有名称,如Baseline、5Maintenance、Special5forAustralia和5.0NewDevelopment。
它们代表项的配置并支持相同代码库的不同开发基准线。
如果需要,可以比较和合并视图。
例如,可能最终需要将文件从5Maintenance和5.0NewDevelopment合并到Baseline视图中。
StarTeam允许创建多种不同类型的视图,包括:■动态项目视图。
这些视图会立即显示项目中的所有源代码和文档变化。
初始项目视图即属于此类别。
■父视图中各项的子集的参考视图。
这些视图引用了父视图中的某些项(而非所有项),且它们所包含的项是可写的。
如果此类视图中的某项发生变化,该项在其源自的父视图中也会发生变化。
如果父视图中的某项发生变化,参考组中的可比项也将发生变化。
这些视图通常只包含部分项目团队成员(如开发者)感兴趣的项。
■基于父视图特定状态的参考视图。
创建父视图中所有项的只读参考视图,目的是便于查找产品版本中所用项的修订。
例如,4.1版本视图的用途可能是为了在将来重建4.1版,或是为了使想要购买您源代码的公司可以查看该代码。
■基于父视图特定状态的分支视图。
使用分支视图,可在不影响主要开发的情况下修改具有特定视图状态的项。
分支视图通常是在建立和维护某个维护基准线时创建的。
■并非从现有视图派生的分支视图。
空白分支视图开始时既无文件也无子文件夹。
即使为它选择了父视图,并且它出现在视图层次中,它也不是从现有视图派生的。
通常会将文件夹和项添加或移动到此视图,或者与此视图共享。
可以重新配置视图,以便按各项在某较早时间点存在于视图中的样子,或者基于视图标签或关联的提升状态,显示这些项。
使用View(视图)菜单上的SelectConfiguration(选择配置)命令可以回滚视图,但回滚视图是只读的。
它显示各项的准确状态,但不允许对它们进行更改。
创建分支视图 以下练习将创建一个分支视图。
有关创建视图的详细信息,请参阅StarTeam管理员指南中的“使用视图”。
分支视图派生自现有视图。
但是,并不是分支视图中的每个文件夹(乃至文件夹中的每一项)都必须分支。
而且,只有当设置为更改时分支的项发生变化时,才会进行分支。
可使用分支视图实现以下目的:■创建满足开发主线以外不同需要的基准线分支。
例如,可以创建产品的维护版本或 自定义版本。
■使用先前版本中的某些或所有文件开始开发产品的下一个版本。
■使某个项目区保持专用,直到该项目完成并经过测试。
此时,可将所做更改合并到 开发主线中。
创建分支视图:1在DemoExercise项目中,选择View(视图)>SelectView(选择视图)。
然后 选择出现在列表顶端的初始视图(DemoExercise)。
此视图将成为新视图的父视图。
第3章:StarTeam的管理29 创建其它项目视图 2在View(视图)或上下文菜单中,选择New(新建)。
出现NewViewWizard(新建视图向导)。
3在下拉Viewtype(视图类型)框中,选择Branchall(全部分支),以便将新视图中的所有项都设置为更改时分支。
4输入CustomRelease1作为Viewname(视图名称),并在Viewdescription(视图说明)文本框中输入Branchingview。
5单击Next(下一步)。
出现NewViewWizard:RootFolder(新建视图向导:根文件夹)对话框。
30StarTeam入门指南 创建其它项目视图 6从树中为此视图选择根文件夹。
如果是对整个父视图进行分支,必须使用父视图的根文件夹。
然后单击Next(下一步)。
出现NewViewWizard:WorkingFolder(新建视图向导:工作文件夹)对话框。
7创建分支视图时,Borland建议选择与父视图的工作文件夹不同的工作文件夹。
如果不改变工作文件夹,则在进入下一个对话框前,会显示一条警告消息,请求您就该项决定进行确认。
如果所输入的文件夹名不存在,StarTeam会自动创建该文件夹。
在本例中,输入C:\DemoExercise\CustomRelease1作为您的工作文件夹。
然后单击Next(下一步)。
出现NewViewWizard:Configuration(新建视图向导:配置)对话框。
8选择Floatingconfiguration(浮动配置)选项按钮。
新子视图中的所有项都将与父视图中的对应项完全相同。
对父视图中某项所做的更改,在该项分支之前将一直在子视图中可见。
同样,对子视图中某项所做的更改,在该项分支之前也一直会在父视图中反映出来。
第3章:StarTeam的管理31 创建视图标签 9单击Finish(完成)。
新的子视图出现在StarTeam的项目视图窗口中。
如果已选择了新的工作文件夹,则所有文件的状态都将为Missing(缺失),因为尚未将它们签出到新工作文件夹。
创建视图标签 视图标签是在给定时间点对视图全部内容的快照,即视图中的文件修订及其它项的特定配置。
将视图回滚到该标签时,您会看到该时刻视图中的各项(除非后来对该标签进行了调整)。
可为当前配置或过去某时刻的配置创建视图标签。
无论是哪种情况,都会将标签附加到在指定时间属于该视图的每个文件夹、文件、更改请求、需求、任务或主题的最近修订。
还可以将视图标签创建作为现有视图标签(包括当前附加到提升状态的标签)的副本。
在这些情况下,会将新标签附加到与原始视图标签完全相同的项和修订。
除非视图标签已被冻结,否则,可以对其进行调整,以反映对产品内部版本所做的最后更改。
例如,在创建标签前有几个文件可能尚未签入,但需要将它们包括在内部版本中。
要在视图中包括或排除文件夹和项,只需将视图标签附加到其上或与之分离。
还可以将视图标签从文件夹或项的一个修订移动到另一个修订。
创建视图标签时,会将视图中的所有文件与指定标签相关联。
因此,可将视图回滚到该标签来查看这些文件。
还可以将视图标签与提升状态一起使用,以使测试者知道应在检验更改请求时测试哪个内部版本。
有关详细信息,请参阅StarTeam用户指南中的“使用标签”。
创建新视图标签:1在View(视图)或上下文菜单中,单击Labels(标签)。
在Labels(标签)对话 框中,View(视图)选项卡应已被选定。
32StarTeam入门指南 使用提升状态 2单击New(新建)创建新标签并将其名称添加到列表框中。
出现ViewLabel(视图标签)对话框。
3在Labelname(标签名称)文本框中输入Build01,在Labeldescription(标签说明)文本框中输入说明。
标签名最长为64个字符,说明最长为254个字符。
4选择Currentconfiguration(当前配置)选项按钮,将标签附加到此视图中每一项的最近修订。
5选中Useasbuildlabel(用作内部版本标签)复选框,以更新每一个以NextBuild(下一个内部版本)作为其Addressedinbuild(解决请求的内部版本)属性设置的更改请求。
如果不选择此选项,则更改请求仍将附加到Build01标签,但是会保留Addressedinbuild(解决请求的内部版本)属性的NextBuild(下一个内部版本)设置。
6确保清除Frozen(冻结)复选框。
(选中Frozen(冻结)复选框可防止更改附加到标签的修订。
) 7单击OK(确定)返回到Labels(标签)对话框。
8重复步骤2至
7,输入标签Build02。
此标签将在后面的练习中使用。
9单击Close(关闭)。
注运行StarTeam客户机和StarTeamServer的所有计算机的日期和时间都应当同步。
例如,假设运行StarTeam客户机的计算机比运行StarTeamServer的计算机提前十分钟。
当您在客户计算机的Configuration(配置)框中选择当前时间时,在十分钟之内标签将不会出现在视图中,因为据服务器配置所知,标签尚不可见。
使用提升状态 在StarTeam中,提升状态通常由视图标签定义。
当与视图标签关联的文件符合某提升状态所要求的条件时,便会将这些标签分配给该提升状态。
可在适当时将一个视图标签重新分配给另一提升状态。
作为StarTeam管理员,您可以创建提升状态,以使用户可以在开发周期的特定阶段在文件和其它项上工作。
例如,可以创建Development(开发)、Test(测试)和Release(发布)提升状态。
提升状态常常是出于为各个团队角色建立项目视图的目的而定义的。
例如,开发者经常需要在最近或最新修订上工作,所以,可以创建Development(开发)提升状态,同时为其分配(<当前>)视图标签。
注通常,分配给提升状态的每个视图标签也是内部版本标签,这样便可在更改请求中将这些标签作为属性使用。
第3章:StarTeam的管理33 使用提升状态 在创建提升状态前,需要决定: ■所需要的状态数。
■要为状态指定的名称。
■最初要与状态关联的视图标签。
在本练习中,您将创建以下三个提升状态:Development(开发)、Test(测试)和Release(发布),并将它们分配给前一练习中所创建的视图标签,或使用(<当前>)代替视图标签。
创建提升状态:1选择View(视图)>Promotion(提升)。
出现Promotion(提升)对话框。
按从后到前顺序创建提升状态。
例如,如果文件依次经历Development(开发)、Test(测试)和Release(发布)状态,则这些状态在Promotion(提升)对话框中应以相反顺序出现:先是Release(发布)、Test(测试),然后是Development(开发)。
如果状态创建顺序不正确,请使用MoveUp(上移)和MoveDown(下移)按钮重新对其进行排列。
2单击Add(添加)。
出现PromotionState(提升状态)对话框。
3在Name(名称)文本框中输入Release。
4在Description(说明)文本框中输入状态的说明。
5从ViewLabel(视图标签)下拉列表框中选择(<当前>)(假设目前尚 未做好任何发布准备)。
6单击OK(确定)返回到Promotion(提升)对话框。
34StarTeam入门指南 使用提升状态 7单击Add(添加)。
再次出现PromotionState(提升状态)对话框。
8在Name(名称)文本框中输入Test。
9在Description(说明)文本框中输入状态的说明。
10假如要测试产品的Build01,请从ViewLabel(视图标签)下拉列表框中选择 Build01。
现有视图标签根据其创建时间按相反的时间顺序列出。
可在合适时使用此对话框更改此标签或将其提升到下一状态。
11单击OK(确定)返回到Promotion(提升)对话框。
12单击Add(添加)。
再次出现PromotionState(提升状态)对话框。
13在Name(名称)文本框中输入Development。
14在Description(说明)文本框中输入状态的说明。
15从ViewLabel(视图标签)下拉列表框中选择(<当前>)。
此操作假定开发者总是在最为近期的文件修订(最新修订)上工作。
在此情况下,决不会将现有视图标签分配给Development(开发)状态。
16单击OK(确定)返回到Promotion(提升)对话框。
17如果提升状态未按从最后一个状态到第一个状态的顺序列出,请一次选择一个状态,然后使用MoveUp(上移)和MoveDown(下移)按钮纠正顺序。
18单击OK(确定)。
将视图标签提升到下一状态 可将视图标签从一个状态提升到下一个状态。
例如,假设Build01(分配给Test(测试)提升状态的视图标签)现在就绪,可以向外发布给所选的几位用户,并且Build02做好了测试准备。
本练习将向您展示如何将Build01提升到Release(发布)提升状态,并将Build02视图标签分配给Test(测试)提升状态。
第3章:StarTeam的管理35 使用提升状态 将视图标签从一个状态提升到下一状态: 1选择View(视图)>Promotion(提升)。
Promotion(提升)对话框将显示当前为此视图创建的任何状态。
状态按从后到前的顺序显示(从最终状态降至最初状态)。
2选择Test(测试),即当前与所要提升的视图标签关联的状态。
3单击Promote(提升)。
PromoteViewLabel(提升视图标签)对话框会指出该视图标签现在与下一状态(Promotion(提升)对话框中紧上方的状态)相关联。
4核实该信息正是您期望看到的,然后单击OK(确定)返回到Promotion(提升)对话框。
请注意,Build01现在是同时与Release(发布)和Test(测试)提升状态相关联的视图标签。
由于在此情形下将Development(开发)状态分配给了(<当前>)视图,所以不能简单地将Test(测试)提升到Build02,而必须首先对其属性进行编辑。
5选择Test(测试)(如果它尚未被选定)。
36StarTeam入门指南 自定义项属性 6单击Edit(编辑)。
再次出现PromotionState(提升状态)对话框。
7从ViewLabel(视图标签)下拉列表框中选择Build02。
8核实Test(测试)现为Build02。
9单击OK(确定)返回到Promotion(提升)对话框。
10单击OK(确定)退出Promotion(提升)对话框。
自定义项属性 重要说明 StarTeamEnterprise和EnterpriseAdvantage客户可以通过向文件、更改请求、需求、主题和任务添加属性来自定义储存库。
例如,如果贵公司从多个站点跟踪更改请求,您可以添加一个UserSite(用户站点)字段,以指出某个缺陷是在哪个站点检测到的。
新的属性字段可以为以下任何类型:实数、枚举、整数、文本、日期/时间或用户ID。
有关详细信息,请参阅StarTeam管理员指南。
自定义数据库时,应将StarTeam服务器调到另一端口,并且该服务器只能由创建这些自定义字段的用户使用。
还可以更改某些现有属性,例如,Priority(优先级)更改请求属性。
在ChangeRequestProperties(更改请求属性)对话框的Synopsis(概要)选项卡上,Priority(优先级)的值为Yes(是)和No(否),但它是按枚举类型实现的。
如果贵公司喜欢按从1(低)到4(高)的数值等级确定更改请求的优先级,可以编辑Priority(优先级)的值。
还可以将新属性和已更改的属性翻译成默认语言之外的语言,以供贵公司在其它国家使用。
这些属性出现在FileProperties(文件属性)、ChangeRequestProperties(更改请求属性)、RequirementProperties(需求属性)、TaskProperties(任务属性)或TopicProperties(主题属性)对话框中。
新属性也可能出现在Custom(自定义)选项卡中。
更改属性字段 以下练习具体说明如何将Priority(优先级)更改请求字段从Yes/No(是/否)改为级别1-4以及如何加入NotPrioritized(无优先级)级别。
修改优先级更改请求属性: 1从上部窗格中选择ChangeRequest(更改请求)选项卡。
2从菜单中选择ChangeRequest(更改请求)>Advanced(高级)>Customize (自定义)。
Customize(自定义)对话框将列出可以自定义的字段。
根据已为更改请求创建的自定义字段,您可能会看到以下某些或全部图标。
■带有红、黄两色图标的字段是StarTeam字段。
它始终是枚举型,并且可以完全自定义。
您可以添加、禁用、重命名或重新排列枚举型的值。
■新字段具有绿色图标。
它可以是多种类型之
一,并且可以完全自定义。
第3章:StarTeam的管理37 更改属性字段 如果禁用新字段,其图标将变为黄色。
■带有白、蓝两色图标的StarTeam字段是限制枚举类型。
对于这些字段,只能更改StarTeam所显示的枚举类型值的名称。
原因是这些字段通常具有无法改变的工作流特征。
例如,请考虑下图所示的更改请求字段Status(状态)。
此字段的值将影响更改请求的处理方式及其下一个可能的值。
下图所显示的更改请求Customize(自定义)对话框含有两个新字段,其中一个当前已禁用。
3从列表中选择Priority(优先级)字段。
4单击Edit(编辑)。
出现ModifyField(修改字段)对话框。
5选择枚举值No(否)。
6单击Edit(编辑)。
出现EditValue(编辑值)对话框。
38StarTeam入门指南 7将名称从No(否)改为NotPrioritized(无优先级)。
更改属性字段 8单击OK(确定)返回到ModifyField(修改字段)对话框。
9选择名为Yes(是)的枚举值。
10单击Edit(编辑)。
出现EditValue(编辑值)对话框。
11将名称从Yes(是)改为
1。
12单击OK(确定)返回到ModifyField(修改字段)对话框。
13单击Add(添加)。
出现AddValue(添加值)对话框。
StarTeam保留了0到100 的数值代码,所以此对话框显示默认值101。
对于此练习,请勿更改默认值。
Code(代码)字段的数值代码会自动递增。
数值代码在执行查询时使用。
在查询中,关系运算符适用于枚举类型。
14在Name(名称)文本框中输入
2。
15单击OK(确定)返回到ModifyField(修改字段)对话框。
第3章:StarTeam的管理39 翻译自定义字段 16重复步骤12到14以向枚举值列表添加名称3和
4。
完成后,ModifyField(修改字段)对话框应如下图所示。
17确保默认值为NotPrioritized(无优先级),方法是从Defaultvalue(默认值)列表框中选择该值。
18单击OK(确定)返回到Customize(自定义)对话框。
19单击Close(关闭)。
可通过选择ChangeRequest(更改请求)>New(新建) 来检验自定义的属性。
Priority(优先级)下拉列表框将显示1-4和NotPrioritized(无优先级)。
翻译自定义字段 在StarTeam中,可以翻译自定义字段显示名和枚举属性显示名。
翻译自定义属性:1单击某个组件选项卡。
2从组件菜单项中选择Advanced(高级)>Customize(自定义)。
此操作将显示 Customize(自定义)对话框,其中显示有为该组件创建的自定义属性以及可以自定义的组件现有属性。
3在Customize(自定义)对话框中,执行以下一项操作:a单击Add(添加)并创建一个自定义字段。
然后从AddField(添加字段)对话 框中选择Translate(翻译)。
b选择一个现有自定义字段,并单击Edit(编辑)以显示ModifyField(修改字 段)对话框。
然后单击Translate(翻译)。
上述两项操作都将显示Translate(翻译)对话框。
在此对话框中,Language(语言)组框显示当前所选的语言。
4要选择其它语言,请在Language(语言)组框中单击Add(添加)。
此操作将显示AddLanguage(添加语言)对话框,其中显示有可以从中选择的完整语言列表。
当前未启用UserDefined(用户定义)文本框。
5选择一种或多种语言后,单击OK(确定)。
此操作将重新显示Translate(翻译)对话框。
Language(语言)下拉列表框现在包括您所选择的语言。
6从Language(语言)下拉列表框中选择一种特定语言。
40StarTeam入门指南 添加组 添加组 7在Translateddisplayname(翻译的显示名称)文本框中,输入要用于自定义字段的翻译名称。
8接着,双击该字段的其中一个Enumeratedvalues(枚举值),或选择一个值,然后单击Edit(编辑)。
上述两项操作都将显示TranslateEnumeratedValue(翻译枚举值)对话框。
此对话框显示枚举值的代码和默认(原始)名称。
9在Translatedtext(翻译的文本)框中输入该值的翻译名称。
10单击OK(确定)返回到Translate(翻译)对话框。
11对于自定义字段的每个值重复步骤8-10,直到翻译完所有值。
12要将字段翻译成另一不同的语言,请从Language(语言)列表框中选择另一种语 言,然后重复步骤7-11。
13翻译过程完成后,单击OK(确定)。
作为管理员,您应负责向系统添加用户组和各个用户,以使他们可以登录到服务器配置并使用已创建的项目视图。
可为用户组分配一组适用于该组所有成员的权限(访问权限)。
在以下练习中,您将向StarTeam添加两个组。
但是,此时您将不授予这些组任何权限。
创建组需要以下信息:■您的管理名(Administrator)以及区分大小写的密码(Administrator)。
■每个组的名称(在本例中为TechnicalWriters(技术编著者)和CasualUsers(临 时用户))。
可通过以下方式创建组:■在运行StarTeam的计算机上使用本练习中所述的方法。
■在运行StarTeamServer的计算机上使用ServerAdministration实用程序。
■如果安装StarTeam的计算机运行的是Windows2000或2003,可从所在网络域导 入现有的组。
有关详细信息,请参阅StarTeam管理员指南。
从您的计算机工作站创建组:1从StarTeam菜单栏中选择Tools(工具)>ServerAdministration(服务器管 理)。
出现ServerAdministration(服务器管理)对话框。
2单击UserManager(用户管理器)。
登录后,或者如果您已经登录,会出现User Manager(用户管理器)对话框。
第3章:StarTeam的管理41 添加用户 3从Groups(组)树中选择AllUsers(所有用户)组作为新组的父项。
Borland建议将每个新组均作为AllUsers(所有用户)组或其某一子组的子项。
4单击NewGroup(新建组)。
出现NewGroupProperties(新建组属性)对话框。
5在Name(名称)文本框中输入TechnicalWriters作为组名。
6在Description(说明)文本框中输入组的说明。
7单击OK(确定)。
所添加的组将出现在位于UserManager(用户管理器)对话框 的Groups(组)列表中。
8重复步骤3到7以创建CasualUsers(临时用户)组。
此时,UserManager(用 户管理器)对话框中的组树看似下图: 添加用户 只要您具有所需的安全访问权限,可以随时从StarTeamServer或StarTeam客户机添加用户。
通常先将用户添加到AllUsers(所有用户)组,然后再将其移动到另外的一个或多个组,如Developers(开发者)或Testers(测试者)。
可通过以下方法添加用户:■在运行StarTeam的计算机上使用本练习中所述的方法。
■在运行StarTeamServer的计算机上使用ServerAdministration实用程序。
■如果安装StarTeam的计算机运行的是Windows2000或2003,可从所在网络域导 入现有的组。
有关详细信息,请参阅StarTeam管理员指南。
注意如果只有您具有管理权限,则当您的帐户被锁定时,您将无法解锁自已的帐户。
因此, 在尚未完成这些练习之前,务必要将管理权限授予一个以上的用户。
如果确实只有您一位StarTeam管理员,请确保为自已创建一个以上的帐户。
42StarTeam入门指南 添加用户 通常,添加新用户时需要以下信息:■用户的全名。
■用户的电子邮件地址(如果要在StarTeam中使用电子邮件和电子邮件通知)。
■用户的登录名和密码,除非每个用户开始时都使用一个通用密码。
■(可选)允许每个用户访问服务器配置的时间。
对于本练习,我们将只添加三个用户:RobertFrost、AbigailAdams和PabloPicasso。
添加用户:1从StarTeam菜单栏中选择Tools(工具)>ServerAdministration(服务器管 理)。
出现ServerAdministration(服务器管理)对话框。
2选择StarDraw服务器。
3单击UserManager(用户管理器)。
登录后,或者如果您已经登录,会出现User Manager(用户管理器)对话框。
4从Groups(组)树中选择AllUsers(所有用户)组。
所有用户都必须是此组的 成员。
5单击NewUser(新建用户)。
出现NewUserProperties(新建用户属性)对话框。
6在Fullname(全名)文本框中输入RobertFrost。
7在E-mail(电子邮件)文本框中输入您自己的电子邮件地址。
8(可选)填写其余的信息文本框。
第3章:StarTeam的管理43 添加用户 9选择Logon(登录)选项卡,然后输入RFrost作为Username(用户名)。
10向StarTeam服务器验证用户:a选择ValidatethroughStarTeamServer(通过StarTeamServer验证)按钮。
b在Password(密码)文本框中键入password,然后在Confirm(确认)文本框中再次键入。
出现的是星号而非密码本身。
11向目录服务器验证用户:a选择Validatethroughdirectoryservice(通过目录服务验证)按钮。
b输入用户的DistinguishedName(标识名)。
此值最多包含254个字母数字字符,用于唯一地标识目录服务用户。
注:只有先在Serverconfiguration(服务器配置)对话框的DirectoryService(目录服务)选项卡上选择Enabledirectoryservice(启用目录服务)选项并输入目录服务器的位置和端口号,才能向目录服务器验证用户。
StarTeamServer还必须在与目录服务器相关的受信域中。
12单击OK(确定)。
随即会将用户名添加到数据库并重新显示UserManager(用户管理器)对话框。
13对于AbigailAdams(用户名AAdams)和PabloPicasso(用户名PPicasso)分别重复步骤4到11。
14清除UserManager(用户管理器)对话框底端的ShowUsersInAllDescendantGroups(显示所有后代组中的用户)复选框。
15采用按下Ctrl并拖动的方式,将RobertFrost添加到Developers(开发者)组。
(仅限Win客户机)当StarTeam显示ShareUsers?
(是否共享用户?)消息时,单击Yes(是)。
16按照步骤14中所述的过程,将AbigailAdams添加到Testers(测试者)组,将PabloPicasso添加到CasualUsers(临时用户)组。
17在UserManager(用户管理器)对话框中,单击Developers(开发者)、Testers(测试者)或CasualMembers(临时成员)组,以显示用户列表。
每组都将包含新用户的名称。
18单击Close(关闭)。
44StarTeam入门指南 设置访问权限 设置访问权限 重要说明 通过在StarTeam中设置访问权限,管理员可以控制哪些人能够查看和操作项目、视图或文件夹以及它们所包含的项。
还可以为文件、更改请求、需求、任务和主题组件以及这些组件所用的筛选器和查询设置访问权限。
对象所有权或组权限可以覆盖访问权限,这取决于您在ServerAdministration(服务器管理)对话框中的SystemPolicy(系统策略)按钮的essRights(访问权限)选项卡上选择的设置。
有关这些安全功能的其它信息,请参阅StarTeam管理员指南。
以下练习以Windows客户机中的StarDraw样例项目和屏幕快照为例,说明如何在StarTeam中为组设置项目级访问权限。
StarTeamCross-Platform客户机具有相同的功能,只是在外观上略有不同。
项目级访问权限应用于项目中的所有视图、文件夹和项。
仅在有限几种情况下,您才会希望在视图或文件夹级设置访问权限,以指定哪些用户可以访问特定视图或文件夹以及它们所包含的项(如公司人员文件)。
在较低级别设置的访问权限优先于在较高级别设置的访问权限。
例如,如果为文件设置了文件夹级访问权限,这些权限会覆盖在视图或项目级设置的任何访问权限。
为具有项目视图权限的所有组定义一组完整的项目级访问权限至关重要。
默认情况下,具有视图权限的组对未定义权限的类别具有完全访问权限。
因此,Borland建议在所有组的所有项目类别上指定访问权限。
授予项目级访问权限时,StarTeam会自动将它们分配给当前显示的项目。
授予对StarDraw项目的项目级访问权限: 1打开StarDraw样例项目(如果尚未将其打开)。
要打开该项目,请选择Project(项目)>Open(打开)>StarDraw>StarDraw,然后单击Finish(完成)。
2从StarTeam菜单栏中选择Project(项目)>essRights(访问权限)。
出现Project(Project_Name)essRights(项目(Project_Name)访问权限)对话框。
在左侧的Categories(类别)面板中,默认情况下会选择Project(项目)选项。
中间面板显示尚未授予任何组或用户对该项目的访问权限。
右侧的面板显示一个树,其中包含可为项目分配的访问权限。
要查看这些权限的完整列表,请单击按钮。
第3章:StarTeam的管理45 设置访问权限 3要添加用户或组,请单击Add(添加)。
此操作将显示AssignessRightsto(将访问权限分配给)对话框。
4从Groups(组)列表框中选择Administrators(管理员)。
5确保选择了Grant(授予)选项按钮。
6单击OK(确定)返回到Project(Project_Name)essRights(项目 (Project_Name)访问权限)对话框。
7单击SelectAll(全选)授予Administrators(管理员)组对此项目的完全访问权限。
建议授予Administrators(管理员)组所有访问权限,因为服务器配置可能被设置为忽略组权限。
8单击Apply(应用)分配这些权限。
9要添加另一用户或组,请单击Add(添加)。
此操作将显示AssignessRightsto(将访问权限分配给)对话框。
10从Groups(组)列表框中选择Developers(开发者)。
11确保选择了Grant(授予)选项按钮。
12单击OK(确定)返回到Project(Project_Name)essRights(项目(Project_Name)访问权限)对话框。
46StarTeam入门指南 设置访问权限 13在右侧的面板中,展开Genericessrights(一般访问权限)树。
开发者需要查看项目和修改项目属性,但一般来说,不应允许他们删除项目或更改项目安全设置。
为这些权限选中正确的复选框。
14单击Apply(应用)分配这些权限。
15要添加另一用户或组,请单击Add(添加)。
此操作将显示AssignessRights to(将访问权限分配给)对话框。
16按照步骤9-13中概述的过程,授予Testers(测试者)组Seeprojectandits properties(查看项目及其属性)的权限。
不需要其它权限。
接下来,您将在项目级为视图设立访问权限。
这些权限应用于当前存在的所有视图以及将来为项目创建的所有视图。
在项目级为视图设置访问权限:1如果未显示Project(Project_Name)essRights(项目(Project_Name)访问权 限)对话框,请从StarTeam菜单栏中选择Project(项目)>essRights(访问权限)。
2在左侧的Categories(类别)列表中,选择View(视图)选项。
右侧的面板随即会显示一个树,其中包含可分配给视图的访问权限。
要查看这些权限的详细信息,请单击按钮。
第3章:StarTeam的管理47 设置访问权限 3要添加用户或组,请单击Add(添加)。
出现AssignessRightsTo(将访问权限分配给)对话框。
4从Groups(组)列表框中选择Administrators(管理员)。
5确保选择了Grant(授予)选项按钮。
6单击OK(确定)返回到Project(Project_Name)essRights(项目(Project_Name)访问权限)对话框。
7在右侧的面板中,单击SelectAll(全选)授予Administrators(管理员)组对视图的完全访问权限。
8单击Apply(应用)分配这些权限。
9要添加另一用户或组,请单击Add(添加)。
此操作将显示AssignessRights to(将访问权限分配给)对话框。
10从Groups(组)列表框中选择Developers(开发者)。
11确保选择了Grant(授予)选项按钮。
12单击OK(确定)返回到Project(Project_Name)essRights(项目 (Project_Name)访问权限)对话框。
13在右侧的面板中,展开GenericObjectRights(一般对象权限)和ViewSpecific Rights(视图特定权限)。
48StarTeam入门指南 设置访问权限 14授予Developers(开发者)查看和修改视图属性并对标签执行操作的权限。
不应允许他们创建或删除视图、更改视图访问权限、删除修订标签、定义提升模型等。
15单击Apply(应用)分配这些权限。
16要添加另一用户或组,请单击Add(添加)。
此操作将显示essRights(访问 权限)对话框。
17按照步骤10-15中概述的过程,授予Testers(测试者)组与Developers(开发 者)组相同的权限。
如这些练习所示,授予访问权限需要四个基本步骤:1选择设置访问权限的级别。
■对于项目,选择Project(项目)>essRights(访问权限)以显示Project(Project_Name)essRights(项目(Project_Name)访问权限)对话框。
■对于视图,选择View(视图)>essRights(访问权限)以显示View(View_Name)essRights(视图(View_Name)访问权限)对话框。
■对于特定文件夹,选择该文件夹,然后单击Folders(文件夹)>Advanced(高级)>essRights(访问权限)以显示Folder(Folder_Name)essRights(文件夹(Folder_Name)访问权限)对话框。
2在左侧窗格中选择要为其设立权限的Category(类别)项。
根据设置权限的级别是项目级、视图级还是文件夹级,所列出的Categories(类别)会略有不同。
3选择要为其设置权限的用户或组。
4选中要授予用户或组的权限。
使用此方法并遵照下面的建议,为Administrators(管理员)、Developers(开发者)和Testers(测试者)组设置对其余项目级Categories(类别)的权限。
对于PromotionState(提升状态)类别:■在大多数公司,只应将这些权限授予生成产品内部版本的组。
请据此授予这些权限。
对于ChildFolders(子文件夹)类别:■授予Administrators(管理员)组所有可用权限。
■授予Developers(开发者)组除删除文件夹、共享或移动文件夹、更改文件夹行为 或配置以及更改文件夹访问权限以外的所有权限。
■授予Testers(测试者)组与Developers(开发者)相同的子文件夹权限。
对于Filecategory(文件类别):■授予Administrators(管理员)组所有权限。
■授予Developers(开发者)组除更改文件安全设置权限以外的所有权限。
第3章:StarTeam的管理49 查看审核日志 ■如果测试者将要签入和签出测试计划,则授予他们与Developers(开发者)组相同的权限。
(实现了StarTeam之后,您可能想要在特定文件夹级设置一些访问权限,如授予Developers(开发者)组对源文件的所有权限,授予Testers(测试者)组对测试计划的所有权限,等等。
)如果测试者只需要对文件的视图访问权限,则仅将这些权限授予他们。
对于ChangeRequest(更改请求)类别:■授予Administrators(管理员)组所有权限。
■授予Developers(开发者)组除更改安全设置、移动和共享更改请求以及更改其行 为的权限以外的所有权限。
本建议假定移动、共享更改请求和更改其行为是贵公司的管理决策。
若并非如此,请根据需要另行授予Developers(开发者)其它权限。
■授予Testers(测试者)组与Developers(开发者)组相同的权限。
如果您没有使用Requirement(需求)、Topic(主题)或Task(任务)类别,则访问权限的授予便已完成。
如果使用了这些功能,则必须也要为其授予访问权限。
访问权限管理的一般原则:在前面的练习中,您授予了Administrators(管理员)、Developers(开发者)和Testers(测试者)对特定项目中若干类别的项的项目级访问权限。
然而,在实践中,必须为有权访问项目的每个组定义贵公司所用的每个类别的访问权限。
如果某个组不需要特定类别的任何权限,则应为不包含权限的组创建授权记录。
为不需要Category(类别)权限的组创建授权记录:1在Categories(类别)列表中突出显示某项。
2选择将无权访问所选项的Group(组)。
3确保选择了Grant(授予)。
4查看Rights(权限)窗格中的各项,但不选中任何复选框。
5单击Apply(应用)。
此操作将为该组创建无授权记录。
查看审核日志 审核日志记录了对文件夹、文件、更改请求、主题和任务执行的操作。
它由StarTeamServer维护,但可随时在StarTeam客户机的Audit(审核)选项卡中对其进行查看。
查看审核日志:1在StarTeam项目树中选择一个文件夹。
50StarTeam入门指南 查看审核日志 2选择Audit(审核)选项卡。
该日志将显示对此文件夹及其中的项执行的所有操作的序时记录。
使用筛选功能,可限制审核日志中所显示的条目种类和数量。
从审核日志上方的Filter(筛选器)下拉列表框中选择一个筛选器。
项目树中的选择以及AllDescendants(所有后代)按钮的使用也会对显示有影响。
默认筛选器是: ShowAll(全部显示所有条目。
显示) ByClassand Event(按类和事件) 显示按类类型(文件、更改请求、需求、任务或主题)和事件(添加、修改、创建等)排序的条目。
可以创建和自定义筛选器。
例如: ■要仅显示已修改的条目,请使用Event(事件)字段。
■要仅显示与对更改请求的操作有关的条目,请使用ClassName(类名称)字段。
■要仅显示从指定日期到现在所创建的条目,请使用CreatedTime(创建时间)字段。
■要仅显示与特定用户所执行的操作有关的条目,使用User(用户)字段。
祝贺您,您已成功掌握了基本的StarTeam管理功能!但StarTeam还提供了其它许多功能和高级功能,例如,更改服务器配置属性、使用服务器诊断、创建查询,等等。
有关完整说明,请参阅StarTeam管理员指南。
第3章:StarTeam的管理51 查看审核日志 52StarTeam入门指南 章 第4章StarTeam的使用 开始本章练习之前,先熟悉一下基本的StarTeam术语会很有帮助。
在StarTeam中,文件和其它数据都是以项目、视图和文件夹层次(根文件夹及其子项)方式进行组织的。
什么是项目?项目是一种组织方式,可以组织与具体事宜有关的一切。
例如,贵公司可以为所生产的每个产品创建一个项目,或为该产品的每个组件创建一个项目。
它是服务器内最高级别的容器。
什么是视图?视图是一种划分方式,可将项目细分成更易管理的单元。
例如,可以创建一个视图,只显示所需的项目部分。
通过视图还可在项目分道而行时(例如,在产品从1.0版本向2.0版本过渡时),随时间推移对项目进行细分。
每个版本可以存储在不同的视图中。
什么是StarTeam文件夹?StarTeam文件夹用于在项目视图内组织StarTeamServer上存储的信息。
例如,针对“源代码”、“用户手册”、“营销材料”及其它主题,将StarDraw样例项目分成了多个文件夹。
什么是工作文件夹?工作文件夹位于您的计算机上或位于您在文件服务器上的个人目录中,StarTeam会将从服务器签出的文件复制至此。
可从这些位置修改文件、新制修订并将其回签到StarTeam中。
还可在工作文件夹中创建要向StarTeam项目视图添加的新文件。
学习如何使用StarTeam 本章练习假定贵公司的StarTeam管理员已安装了该应用程序、输入了服务器配置、确定了StarTeam样例项目并已开始了服务器运行。
样例项目可以是StarTeamServer随带的StarDraw,也可以是与您在工作中使用的文件夹及文件类型更加贴近的样例项目。
本章示例假定您使用的是StarDraw。
但是,由于自该项目安装以来其他用户可能曾对其进行过改动,所以插图可能与您计算机上所显示的并不完全一样。
为使您和您的团队成员逐渐熟悉基本的StarTeam操作,以本章练习为例具体说明了如何执行以下操作:■启动StarTeam。
■添加对服务器的访问权。
第4章:StarTeam的使用53 启动StarTeam ■登录到StarTeam。
■打开现有项目。
■管理StarTeam文件夹。
■向项目添加文件。
■签入和签出文件修订。
■查看修订历史。
■创建更改请求、主题和链接。
■创建图表和报告。
启动StarTeam 使用StarTeam之前,必须核实计算机上已安装了StarTeam客户机。
如果尚未安装,请参阅StarTeam安装指南或与您的系统管理员联系。
启动StarTeam客户机:■选择开始>程序>StarTeam>StarTeamx.x。
计算机屏幕上出现一个空的 StarTeam窗口。
添加服务器配置 重要说明 OpenProject StarTeam将所有项目都存储在StarTeamServer上,其中可能包含多个服务器配置。
要访问某个现有项目,必须首先将其服务器配置添加到系统中。
需要从系统管理员那里获取以下信息:■StarTeamServer的位置(IP地址或运行该服务器配置的计算机名称)。
■该服务器所使用的TCP/IP端点(端口)。
■用于访问该项目的用户名和区分大小写的密码。
■样例项目的名称。
StarDraw是标准StarTeam样例项目。
■要使用的视图的名称。
对于StarDraw样例项目,请使用StarDraw初始视图或 根视图。
首次创建StarTeam项目时,其初始(根)视图与其根文件夹同名。
添加新的服务器配置:1执行以下一项操作: ■在工具栏上单击OpenProject(打开项目)图标。
■从菜单栏中选择Project(项目)>Open(打开)。
54StarTeam入门指南 添加服务器配置 这些操作将显示OpenProjectWizard(打开项目向导)。
由于它当前未显示存储样例项目的StarDraw服务器配置,所以必须将该服务器添加到StarTeam。
2单击AddServer(添加服务器)。
出现AddServer(添加服务器)对话框。
Browse a在Serverdescription(服务器说明)文本框中输入一个易于记忆的说明(如StarDraw)。
Serverdescription(服务器说明)区分大小写并且应当唯
一。
b在Serveraddress(服务器地址)文本框中,键入运行StarTeamServer的计算机的确切名称或正确的IP地址,以指示StarTeamServer在何处运行。
如果需要浏览确切的名称,请单击Browse(浏览)按钮。
c在TCP/IPEndpoint(TCP/IP端点)文本框中输入相应信息。
端点是端口号。
d(可选)选中CompressTransferredData(压缩传输数据)复选框,以压缩在计算机与服务器配置之间传输的数据。
e(可选)如果要防止未授权方通过不安全的网络线路读取在您的计算机与StarTeamServer之间传输的数据,请选中Encryption(加密)类型复选框。
加密类型(从上到下)按速度排序。
每种加密类型都比其上面的类型慢,但更安全。
第4章:StarTeam的使用55 登录到StarTeam f单击OK(确定)。
此操作将重新显示OpenProjectWizard(打开项目向导),此时其中会显示服务器的名称。
3双击该服务器名称。
由于先前并未登录到StarTeam,所以会出现LogOntoStarDraw(登录到StarDraw)对话框。
登录到StarTeam 在继续StarTeam会话之前,必须在LogOntoStarDrawputer_name](登录到StarDrawputer_name])对话框中输入所要求的信息。
登录:1在相应的文本框中输入Username(用户名)和Password(密码),然后单击 OK(确定)。
密码区分大小写,并且可能有长度限制。
对于StarDraw样例项目,请使用名称ALincoln作为UserName(用户名),使用password作为Password(密码)。
如果遇到任何问题,请向您的系统管理员咨询。
56StarTeam入门指南 打开现有项目 登录后,系统托盘中会出现StarTeam工具栏图标。
可以单击此图标来显示该工具栏,其中会显示当前已配置的所有服务器列表。
使用此工具栏,只需登录一次即可访问所有服务器,并可添加快捷方式来启动其它产品。
打开工具栏:1双击系统托盘中的工具栏图标。
2选择想要使用的工具栏选项。
3如您所看到的那样,工具栏中自动填充有系统上所安装的StarTeam和CaliberRM 产品的快捷方式。
要从工具栏启动其它程序,必须添加这些程序的快捷方式。
要创建快捷方式,或者■在工具栏标题栏的任何位置右键单击,然后使用下拉菜单命令,或者■右键单击StarTeam工具栏图标,此时会显示一个下拉菜单。
然后选择Open ToolsFolder(打开工具文件夹),并直接使用资源管理器窗口中出现的程序快捷方式。
4单击Exit(退出)以启用所选的工具栏选项。
打开现有项目 登录后,OpenProjectWizard(打开项目向导)会显示所选StarTeamServer上可用的项目(在本例中为StarDraw)。
1双击样例项目名称(例如,StarDraw)。
第4章:StarTeam的使用57 打开现有项目 2接着选择该项目的某个视图。
要查看项目视图的完整列表,请在OpenProjectWizard(打开项目向导)上单击Next(下一步)。
此操作将显示OpenProjectWizard:SelectView(打开项目向导:选择视图)对话框,其中会显示一个视图树。
如果视图名旁出现有图标,则您无权访问该视图。
在本练习中,应使用样例项目的初始视图。
要选择此视图,请核实该项目名已突出显示,然后单击Finish(完成)。
此操作将在项目视图窗口中显示该初始视图。
3请注意,项目视图窗口有三个窗格。
左窗格包含StarTeam文件夹层次。
窗格右侧有两个窗格,分别称为上部窗格和下部窗格。
上部窗格此时不会显示任何内容,因为您尚未选择具体的项。
不过,它可以显示文件、更改请求、需求、任务和主题的列表或审核日志。
每个StarTeam组件的选项卡均出现在上部窗格的底端。
下部窗格提供有关上部窗格中所选特定项的附加信息。
为项目视图创建快捷方式:1项目视图打开后,从菜单栏中选择Project(项目)>SaveShortcutAs(将快捷 方式另存为)。
此操作将显示SaveAs(另存为)对话框。
2接受默认的快捷方式位置(桌面)。
3请注意,Fi

标签: #cot #cbd #cia #cdc #ceo #con #什么意思 #什么意思