1、StarTeam操作指南,作者：58-1email：52-,介绍,Borland StarTeam 通过自动的配置和变更管理增加了对开发过程的控制.软件工程需要版本控制，进程管理，编译管理，以及对于并行开发的支持，因此配置管理是软件工程中经常用到的功能.除了它的强有力的版本控制特性，StarTeam 也提供了灵活的、综合的解决方案，使你能够：查询产品或项目的缺陷并提出改进建议.从Borland CaliberRM 中创建或输入要求，分配用户和连接文件到具体的要求中.创建和监控组内成员的任务进程.如果愿意，这一功能可以与Microsoft Project 进行结合.存储工程中所作出的决定的线形的
2、讨论.StarTeam 家族包括StarTeam 服务器，StarTeam（Windows 和跨平台的客户端），StarTeam 网络版，Stardisk,以及与一系列与第三方产品（包括Test Director,Borland JBuilder,和MicrosoftProject）的综合版.StarTeam 服务器和客户端相连接来维护数据库，存储对文件的更改，以及授权用户访问工程数据.,术语,Project:项目或指工程，它是组织与某一特定任务相关的事件的一种方式.View:视图，它是将Project分成更小的管理单元的一种方式或提供一种随着时间而采用不同的路径对项目进行再分配的方法.Sta
3、rTeam文件夹：对其存储在StarTeam服务器上的项目视图内的信息进行组织.工作文件夹：指你的计算机中的位置或者是在文件服务器中的个人目录.Check in :输入.把你修改的文件输入到相应的项目视图中去.Check on :输出.从项目视图中输出文件到你的工作文件夹下.Update Status:对状态进行更新.,StarTeam组件,File version control 版本控制是对由可靠的、组织良好的档案所构成项目的多个分项的多个版本的管理和维护.ChangeRequests 提供了一种缺陷追踪系统，它能够记录产品、项目或服务中的缺陷并提出改进的建议.Requirements 以
4、需求为导向的开发过程，利用该组件作为基本工具，可以避免对需求的误解.Tasks 利用Task组件可以创建任务列表和对工作进行分配.Topics 一种线性对话.即信息之间是如何相关的一系列消息.Audit Log 一个以时间为顺序的记录，它记录对文件夹、文件、需求、变更请求、任务和主题所进行的所有操作.每一次登录都会显示执行操作的用户，进行操作数据和时间，项目名称、窗口名称等.,安装StarTeam,1、双击“安装程序”图标 ，系统进入准备状态. 2、待蓝色条目走完，系统会自动进入工具“介绍”对话框.,Third/Four,3、了解Borland对工具的简单介绍后，单击“Next”按钮，进入“用
5、户协议”对话框.4、选中“I accept”选项，单击“Next”按钮进入“用户信息”对话框.,Five/Six,5、在相应的文本框中输入“名称、单位”，单击“Next”按钮进入“选择安装类型”对话框.6、普遍选择“Typical”类型，单击“Next”按钮后进入“选择安装目录”对话框.,Seven/Eight,7、根据个人需求，选择相应的存放路径后，单击“Next”进入“选择捷径文件”对话框.8、根据个人爱好选择相应的选项后，单击“Next”进入“安装概要信息”对话框.,Nine/Ten,9、信息确认后，单击“Next”进入“安装starTeam 5.4版”对话框.10、稍等片刻，待进度条走
6、完，系统自动进入“完装结束”对话框.,End,11、单击“Done”按钮，安装结束！,启动StarTeam,安装完毕后，下一步就得启动工具进行操作.找到你程序安装的路径，通常默认的是开始程序StarTeam5.4-StarTeam Client.打开StarTeam Client，屏幕上将会显示一个空的StarTeam窗口，此时还没跟服务器连接及并未有任何项目存在.这也是我们下步要进行开展的工作.,添加服务器配置,StarTeam将所有项都存储在StarTeam Server上，而StarTeam Server包含大量的服务器配置，要访问一个现存的项目，我们就要把它的服务器配置实例添加进来.此
7、时，你应清楚以下几点信息： StarTeam Server服务器的位置（IP地址或计算机名） 访问服务器的协议（一般默认为TCP/IP） 服务器使用的端口号. 访问项目的用户名和密码、 项目的名称. 你要使用的视图名注意： 创建了一个新的项目，他的初始视图（根视图）和他的根文件夹具有相同的名称.,步骤,1.从菜单栏选择“Project-open”或点击工具栏上的“Open Project”按钮.打开open project wizard对话框，你可以看到“Server/Project box”列表框中没有任何选项，此时你应该进行“Add Server”操作把服务器配置添加进来.2、单击左边的“
8、 Add Server”按钮，出现Server对话框.在相应的文本框中输入各自信息.Server description:输入一个容易记忆的描述.Server address:输入服务器IP地址或计算机名.Protocol:从列表框中选择一个协议.Endpoint:输入端口号.Encryption:免于不安全网络访问的选项.Compress transferred data :该选项是用于压缩你的计算机与服务配置之间传输的数据.任选项.,完成上面操作后，系统返回open project wizard对话框，现你可以看到“Server/Project box”列表框中出现了你刚才添加的服务器配置
9、.双击服务器配置或点击前面的号，弹出Lon on 项目库服务器对话框.这是接下来要做的事登入StarTeam.,登入StarTeam,在Lon on 项目库服务器对话框中，分别在User name和Password文本框中输入管理员分配的用户名和密码.单击“Log On”即可.登入后，在操作系统的任务栏右下角会出现StarTeam Toollbar图标，你可以单击此处打开它。显示了所有当前配置的服务器列表，可以使你用一次登录访问所有服务器，并添加启动其他产品的快捷方式.,打开现存的项目,在登录后， open project wizard对话框中打开选中的服务器配置上的所有项目.选中项目.单击“
10、完成”.如果要选择项目视图，双击项目名称或单击“下一步”打开project wizard:select view对话框，对话框中显示一颗视图树（这是在有附加视图的前提下）.如果视图名的前面显示打叉的图标，说明你没有访问的权限.这时候，你选择一个你想使用的视图（这里我们只有一个初始视图），单击“完成”即可.,完成上面的操作后，项目视图窗口上将显示项目的初始视图.项目视图窗口分为三个部分，如图.上窗格显示文件列表、变更请求、任务、主题或日志等信息，但在没选择对象的情况下，上窗格中无任何内容.下窗格显示关于上窗格中选中的具体对象的附加信息.,创建快捷方式,一个项目视图，你有可能会频繁的打开进行操作，
11、为了能够快速的启动它，你可以为你的项目视图创建一个快捷方式.选中打开的项目视图，从菜单栏选择“Project-Save ShortcutAs”,打开保存快捷方式的对话框.接受快捷方式的默认位置（桌面）.保存时，在文件名列也了项目视图的建议名为statTeamWork-statTeamWork.stx，你可以采用这个名，也可以取自己喜欢的名称.点击保存，返回StarTeam.查看桌面，出现如图的快捷方式.,使用项目视图窗口,如果你想要同时看见两个视图，你可以打开另一个窗口.左边是一个典型的项目视图窗口.左面的窗格显示了本项目当前视图的文件夹树.上面的窗格显示的是与选中文件夹相关的数据.显示的数据
12、类型取决于你选择哪一个选项卡.下面的窗格显示关于上面选中的对象的附加信息.所有的信息也取决于你选中哪一个选项卡.,上窗格选项卡File 文件Change Request 变更请求Requirement 需求Task 任务Topic 主题Audit 日志,下窗格选项卡：Detali列举了上面的窗格中选中的对象的信息.History列举了上面的窗格中所选中的对象的更改版本，从最近的版本到最除的版本.Label根据版本上所附加的标签，列举了上面的窗格中所选中的对象的更改版本.最近的版本排在最上面.Link列举了于上面的窗格中选中的对象相关的对象或文件夹。例如，一个更改要求可能与解决问题的文件相关.R
13、eference列举了上面的窗格中选中的，并在工程中所使用的对象在工程中的位置.,了解StarTeam文件夹,拥有一定权限的你，可以在StarTeam中创建、删除、修改文件夹，也可以对文件输入输入出操作.为工作文件夹所选择的路径不需要与StarTeam文件夹的路径相关.你的工作文件夹可以在不同的位置上，因为它们不需要彼此相关、比如：你可以把市场需求放在C盘下，而把用户手册放在E盘下.下面将指导你如何在StarTeam文件夹分级列表中添加一个文件夹.即如何创建一个新的文件夹及修改文件夹属性.,创建新文件夹,1、从菜单栏选择Folder-New,弹出New Folder Wizard对话框;在列表
14、中选择作为新文件夹的上级文件夹.（想查看文件夹的子文件夹可以单击文件夹前面的号） ，单击“下一步”，进入Folder Name对话框.2、输入的信息Folder Name：输入文件夹名称.Working:输入或查看计算机中创建的工作文件夹名称.StarTeam Folder description:输入对文件夹的描述.输完后，单击“下一步”.,3、在child folders对话框显示了你新的StarTeam文件夹.如果工作文件夹下还有子文件夹，你并不想把它们也加放，你可以点击Exclude.在starteam folders对话框中显示了StarTeam文件夹完整的列表，包括正在添加的文件夹
15、.这时，点击“完成”按钮即可完成操作.,重新返回项目视图窗口，你可在左面板中看到新添加的文件夹以及原本存在的文件夹.你会发现在新文件夹下的文件显示的Status:Not in View.表示这些还未添加到项目中即还未进行版本控制中，这时候，你要进行添加文件操中，这是我们下一步的工作.,添加文件,1、选中新文件夹单击工具栏上的“All Descendants”按钮或从菜单栏File中选择。在确保上窗格中的File选项卡被选中时,单击Status:Not In View前面的号，列出所有文件.2、选择一个或多个文件，选中所有文件可以从File菜单项或右健快捷菜单中选择Select-Select A
16、ll.3、接着从File菜单项或右健快捷菜单中选择File-Add Files,弹出Add Files对话框。信息的输入如图.Comment:对添加的文件进行描述.如果添加多个文件，可以选中”Prompt for a comment for each file“选项，为每个文件做独立的注释.Lock status:添加文件状态，可根据自己的需要选择相应的选项.Link and pin process item：使新文件与具体的过程对象相连.项。如果文本框中出现了活动的对象，则接受它;如果没有，详情参照Select Process option对话框. Advance:高级选项，详情参照Adva
17、nced Options对话框.,Select Process Item对话框，选择要连接的项目Avanced Options对话框：Delete working files:该选项会删除工作文件夹中的文件，建议不选中.Revision label：从下拉列表中选择一个标签或输入名称创建一个新的标签.选中底下的选项将使用你的标签与以前的一个版本相连.Override default storage optionos:该选项是用于压缩存储在StarTeam Vault中的的文件.Compression:从下拉列表框中为文件选择一种压缩类型.“Store revisions as deltas”:
18、将文件存为delta类型.,更改文件创建新视图,StarTeam工具支持两种修改模式：,第一步，输出和锁定文件,1、在上窗格，选择一个你想要修改的文件;接着从File菜单项或右健快捷菜单选择File-Check Out,弹出Check Out对话框.Lock status选项：Unlocked:仅仅复制文件到你的工作文件夹中Exclusive:表示你想要更改文件并阻目其他人对其进行修改.Non- Exclusive:表示你正在对文件夹进行操作并可能进行更改.Keep current:保持当前的锁定状态.Advanced选项：Checkout Location:Default Working f
19、ile location是默认选定的工作文件夹，如果你想要把文件输出到另一个文件夹而不是指定的文件夹你可以选择Other输入或查看新文件夹的名称.Eol conversion:None:默认选项CR-LF:WindowsLF:UNIXCR:mACINTOSH,2、相关信息输入完毕后，单击”OK”.返回项目视图窗口.你可以看见文件的Status处于Current;如果你有对文件进行锁定，你的用户名会在显示在Locked By栏上，另外，前面打开书的图标代表着文件被锁定.,第二步，编辑器中更改文件夹,1、选中你刚刚输出的文件.2、从File菜单栏、快捷菜单选择Edit或双击选中的文件，文件将显示在
20、你计算机指定的编辑器.3、对文件进行相应的修改，保存，退出.4、确认StarTeam窗口是激活的，选中修改的文件,从Files菜单项中或快捷菜单中选择“Update status”进行文件状态更新,此时文件的状态变为Modified.(或者按快捷健F5进行刷新) .,第三步，输入新版本,1、选择文件，从Files菜单项或右键快捷菜单选择Check In，弹出Check In对话框. Comment:对文件所做的更改进行描述。如果输入多个文件，可以选中Prompt for a comment（check-in reason） for each file选项，为每个文件做独立的注释. Compar
21、e:可以比较输入的文件与文件库中文件的区别，这一选项会启动Visual Diff工具（后面会进行说明） Lock status:输入文件，可根据自己的需要选择相应的选项. Force check-in:任选，选中它将输入一个比提示版更老的版本. Link and pin process item：要使用文件与具体的对象相连，可以选中该选项.如果文本框中出现了活动的对象，则接受它;如果没有，详情参照Select Process option对话框. Advance:高级选项，详情参照Advanced Options对话框.2、确定信息后，单击“OK”按钮返回窗口.3、从Files菜单项或快捷菜单
22、中选择update status或按F5更新文件的状态。将由Modify转公为Current.如果你有解除了文件的锁定，那么这时候组内的成员就可以进行想要的修改了.,在select process item对话框中选择具体地对象，点击OK返回Add files 对话框Advanced Options对话框：Delete working files:该选项将从你的工作文件夹中删除文件，建议不要选中。Revision label：可从该下拉列表中选择一个标签或输入名称创建一个新的标签.选中底下的选项将使用你的标签与以前的一个版本相连.Override default storage options
23、:该选项用于压缩存储在StarTeam中的的文件.Compression：从下拉列表框中为文件选择一种压缩类型，Store revisions as deltas：将文件存为deltas类型。Show change requests:查看与文件相关的变更请求.,操作与Status的对应关系,查看更改历史,当你需要返回到文件以前的旧版本时，可以查看文件历史并选择你需要的版本.1、在上窗格选择你输入的文件2、选中下窗格的History选项卡.你可以看到下窗格显示了历史列表从最近的版本开始显示存储在StarTeam中的选中的文件的修改版本.它也打开了关于每一个更改版本的信息，包括项目视图、版本号、更
24、改的用户等.,比较文件的版本,当我们查看文件的历史后，我们有可能想知道两个版本有哪些不同.StarTeam提供了Visual Diff工具，该工具可以对文件进行比较并找出不同之处的内容.1、在下窗格中，选中文件的两个版本.2、单击工具栏上的Compare Contents图标.显示了Visual Diff工具的界面同时显示了两个文件的内容并对不同之处以不同的颜色进行标记. Black:匹配的文本块以黑色显示 Red:被删除的文本以红色显示并且文本的前面有划线.删除的文本只显示在左面. Green:插入的文本以绿色显示.插入的文本只在右面显示. Blue:更改的文本以蓝色显示3、比较结束后，选择
25、File-Exit，返回StarTeam.注：如果文件之间没有不同， Visual Diff会显示文件相同的说明信息.,输出以前的版本,1、在下窗格中，选择一个早期版本的文件2、选择File菜单项或快捷菜单中的Check out3、选择了Check out时，修改版本将被制到你的计算机中.4、通过File菜单项或快捷菜单中选择Update status来更新文件的状态(也可以按F5来刷新)，变为 Out of Date.如图5、你可以查看文件是不是早期版本，从菜单栏或快捷菜单选择Edit,系统将弹出一个提示对话框.如图6、单击否按钮，打开文件的早期版本，它不包含最近的更改.,删除文件夹,1、在
26、StarTeam左面 的窗格中，选中要删除的文件夹.2、从Folder菜单项或快捷菜单中选择Dele,弹出让你确认删除的信息.3、单击“是”即可.,变更请求的操作,1、变更请求可能是对改进产品提出的建议或是一个解决产品问题的要求.2、变更请求可以放在任何一个文件夹下，但最初时还是把它们放在项目视图的根文件夹内.一段时间以后，对变更请求可以进行查看并存储在合适的文件夹中.3、了解变更请求的界面信息：Synopsis面板：Status:选择相应的状态Type:选择变更请求的类型Severity:指明变更请求的重要性.Platfor:选择相应的平台Component: 用于区分基于一般原则的更改要求
27、.Category:根据附加标准对变更请求分类.Responsibility:选择要处理变更请求的负责人.Synopsis:在该文本框中输入对变更请求的概要.Description面板 在Description and steps to 文本框中输入对变更请求的描述并列出现此问题的步骤.Solution面板该面板是响应变更请求后，相关负人员对所做的工作进行描述及对解决的结果输入一个合适的评价.Attachments 可以添加变更请求相关的附件内容，比如插入错误信息的图片.,创建变更请求,1、选中StarTeam文件夹分级中的根文件夹.2、选择上窗格中的Change Request选项卡.3、从
28、Change Request菜单栏或快捷菜单中选择New,弹出New Change Request对话框.（下面以一个实列来说明如何新建一个新的变更请求）从Status选择New选项，表示新变更请求.从Prioriy选择Yes，作为优先解决的问题.选择Type选项的Defect，指定更改请求是缺陷的.选择Severity中的Medium选择所有平台，platform为All.Responsibility 中选择了处理该变更的负责人，这里选择管理员.Component ：输入相应的组件信息Category ：对变更请求分类在Synopsis文本框中输入对变更请求的总结.接着在Descriptio
29、n面板中的Description and steps to 文本框中输入对变更请求的描述并列出出现此问题的操作步骤.,解决变更请求,1、双击上窗格的变更请求，弹出Change Request对话框.2、选择Status下的Fixed,表明已更正问题.此操作会出现如下两个变化：Responsibilit会自动变为创建变更请求的人的名称.Addressed in build显示Next Build的值把Priority改为N04、选择Solution面板，在Fix文本框中输入一个适当的说明，比如：test文件现已存在.5、单击OK解决变更请求.,主题的创建及响应,你可以使用主题组件在StarTea
30、m文件目录的文件夹中添加线性对话.主题及响应可以被标记到自身或使用此项目的其他人的讨论.他们可以提出一般性的问题也可以讨论具体关于项目的具体问题.主题组件：在主题或响应中查找具体的字或句字对主题或响应进行分类对主题或响应进行过滤查看主题及其响应间的关系移动和主题共享（以树的格式）你可以在文件夹中添加一个主题，对主题的响应变为主题的子文件夹，形成主题树，对主题的相应的次级响应变为响应的子文件夹等等.,创建主题,1、首先选中窗格中的根文件夹2、选择上窗格中的Topic选项卡3、从Topic菜单项或快捷菜单中选择New选项,弹出New Topic对话框4、输入的信息如下介绍Topict 在Title
31、的文本框中输入主题标题 在Connent文本框中输入问题Options（任选的）如果你想添加这一主题的相关成员，你可以单击Add按钮，通过弹出的“Select Topic recipients”对话框来添加.另，你可以为主题设置优先权及状态，对应的选项priorit、status.Attachments 该选项可以在发送信息的同时发送一张图片或附加信息.5、信息确定后，单击“OK”，返回窗口，界面如下：,可以看见主题前面有一个电灯泡的图标,响应主题,1、在主题树中，选中新的主题2、从Topic或快捷菜单中选择Respond3、 在Title文本框中输入你的响应的标题.4 、在Content文本
32、框中输入你所作出响应.5 、点击OK，该响应将作为主题的一个子文件出现在项目视图窗口上面的窗格中,需求的操作,使用需求作为开发向导，公司可以防止对需求的误解及可以缩短花在市场上的时间.下面，我们先来了解一下创建需求的一些信息：RequirementName:为需求输入一个名称.Type:选择需求类型.Owner:选择一个负责人.Priority:选择该需求的优先权.Status:选择该需求所处的状态.Description:输入该需求的初始描述.Responsibilities使用该面板添加需求涉及的成员.Attachments 使用Attachments面板添加需求的附加文件 Comment
33、 使用该面板说明为什么要创建此需求.在Comment for new revision文本框中输入你的原因.,创建需求,1、选中上窗格中的Requirement选项卡.2、从Requirement菜单项或快捷菜单中选择New，弹出New Requirement对话框.3、输入相应的信息.4、单击“OK”按钮.,响应的主题前面出现一个信封的图标.,说明,主题的前面有一个灯泡图标，响应前面有一个信封图标.主题和响应都存在初始视图的根文件夹中.以黑体子显示的主题及响应是已读的，未读的主题及响应以红旗进行标记.,创建连接,在starTeam中，对象就是文件、需求、变更请求、任务及主题.连接就是两个文件
34、夹之间、两个对象之间或一个文件夹与一个对象之间的连接.例如：当你输入编辑后的文件，文件与变更请求的连接使你可以将其标记为修复.要查看一个选定对象的连接，可以使用下窗格的Link选项卡.要查看一个选定文件夹的连接，可以选择Folder菜单项中的Properties，然后选Link选项卡.下面将以主题与变更请求连接为例教你如何创建连接：1、在上窗格中的Topic选项卡上，选择你创建的主题.2、从Topic菜单项或快捷菜单中选择Link-Create Link或单击工具栏上的Create/Complet按钮，此时鼠标指针看起来向一条打结了的蝇子.3、在Change Request选项卡上，选择相应的
35、变更请求.4、从Change Request菜单项或快捷菜单中选择Link-Complete Link或单击工具栏上的Create/Complet按钮，鼠标指针恢愎原先状态.此时一个连接已被创建.5、要想查看连接的结果，可以选择一个相互连接的结果，然后选中下窗格中的Link选项卡，对象的连接信息将在下窗格中显示.,说明,如果你要将同一类型的几个对象与某一个不同类型的对象相连接，你可以同时创建所有的连接.只要在上窗格中选中同类型的对象，然后使用Link图标将它们连接到具体的文件中.提示： 要使一个文件夹作为连接的开始，选择Folder-Links-Create Link. 要使一个文件夹作为连接
36、的末尾，选择Folder-Links-Complete Link. 要删除一个连接，从任何一个组件的菜单项或从相应的快捷菜单中选择Links-Cancel Link;如果你使用的是工具栏上的Link按钮，则按下Esc键.,从项目中删除对象,删除连接删除变更请求删除主题及响应主题,删除连接,1、选择下窗格中的Links选项卡.2、在下窗格选中连接信息并右击，选择Delete Link选项（你也可以按键盘上的Delete键）.3、在弹出删除提示信息对话框，单击“确定”按钮即可.,删除变更请求,1、选择Change Request选项卡.2、在上窗格中选择你想删除的变更请求.3、从Change Re
37、quest菜单项或快捷菜单中选择Change RequestDelete.4、在弹出的删除提示信息的对话框中单击“Yes”即可.,删除主题及响应,1、从上窗格中选择Toptic选项卡.2、在上窗格里选择要删除的主题.3、从Toptic菜单项或快捷菜单中选择Delete.4、在弹出的删除提示信息对话框中，单击“Yes”即可.,创建报表,利用StarTeam,你可以为文件、变更请求、需求、主题及任务和日志登录创建图表.图表是基于上窗格中显示的数据.因此，在创建之前，你必须根据绘图的目的调整上窗格中显示的内容，然后选择你要创建图表的对象.你可以创建各种各样的图形：为所有的或选中的对象创建文件大小或内
38、容版本图形.创建内容版本为X坐标，文件大小为Y坐标的关系图.使用本地时间标记信息，创建某一具体日期的对象和时间队列的时间序列图.你在文件列表中已经进行分组和分类的对象的分布图.下面创建一个表示文件大小的图：,1、从StarTeam左面板的窗口中选择根文件夹2、选择File选项卡3、单击工具栏上的All Desecendents按钮，显示所有文件.4、从File菜单项或快捷菜单中选择Chars-simple,弹出Simple Chart对话框.Chart Name:在该文本框中输入图形的名称.Series:在该列表框中选择Size.Create chart for：在该组选择Select all
39、.Printer page orentation：在该组选择Landscape.5、单击“OK”，显示文件大小的图形.,创建报告,利用StarTeam可以创建关于文件、变更请求、主题、任务及日志的报告.它借助Web浏览器创建Html格式的报告.下面创建一个文件细节报告例子：,1、从StarTeam左面板的窗口中选择根文件夹.2、选择File选项卡.3、单击工具栏上的All Desecendents按钮，显示所有文件.4、在上窗格中选择一个文件夹或几个文件.5、从File菜单项或快捷菜单中选择Reports,出现Reports对话框. Avalable reports:在该列表框中选择Detail. Create report for:在该组选择Current selection. Output file name:输入或选择一个你想要存储的位置，确保扩名为Htm或Html. Report title:在该文本框中输入报告的名称.6、执行下列操作之一： 单击“Generate”可以查看报告.web将会打开和显示你的报告. 单击“Print”可以打印你的报告.提示：你可以通过从File, Change Request, Requirement, Task, Topic或 Audit菜单中选择Print打印一个Detail Report（详细报告）.,结束！,
