基于协同软件Groove Virtual Office 的网络投票插件EasyVote用户需求说明书

1、基于协同软件 Groove Virtual Office 的网络投票插件 EasyVote 用户需求说明书 目目目 录录录 0.0. 文档介绍文档介绍 .2 2 0.10.1 文档目的文档目的.2 2 0.20.2 文档范围文档范围.2 2 0.30.3 读者对象读者对象.2 2 0.40.4 参考文档参考文档.2 2 0.50.5 术语与缩写解释术语与缩写解释.2 2 1.1. 产品介绍产品介绍 .4 4 2.2. 产品面向的用户群体产品面向的用户群体 .4 4 3.3. 产品应当遵循的标准或规范产品应当遵循的标准或规范 .4 4 4.4. 产品的功能性需求产品的功能性需求 .5 5 4.0

2、 功能性需求分类.6 6 5.5. 产品的非功能性需求产品的非功能性需求 .1616 5.15.1 用户界面用户界面需需求求.1616 5.25.2 软硬件环境需求软硬件环境需求.1919 5.35.3 产品质量需求产品质量需求.1919 附录附录 A A：用户需求调查报告：用户需求调查报告.2020 0.0.文档介绍文档介绍 0.10.1文档目的文档目的 本文档根据获取客户的产品功能要求，了解用户的任务和目标以及这些任务 所支持的业务需求，分析源于用户的信息区别用户任务的各种要求，来确保对 用户需求达到共同的理解和认识，并在整个开发阶段以前，确定产品的功能和 用户业务的需求及其质量属性。 0

3、.20.2文档范围文档范围 由用户的不同层次的需求，分别分析和介绍产品针对的用户群体、产品规范 质量规格以及相应的产品功能性需求和非功能性需求，并对客户群进行调查， 了解市场的价值和开发的风险。 0.30.3读者对象读者对象 本说明书的主要读者是公司经理、相关负责人和参加开发的技术人员。针对 用户的需求确定，帮助用户准确其要求，商讨实施优先级的划分，达到用户与 开发人员一致的理解和认识，并保证软件质量的有效性。同时为开发人员提供 了开发的方向，严格按照功能需求和非功能需求完成项目，并保证软件的质量 属性。 0.40.4参考文档参考文档 0.50.5 术语与缩写解释术语与缩写解释 词汇解释 Gr

4、oove一款基于 P2P 的协同办公软件 APIApplication Programming Interface 应用编程接口 title index话题索引 deadline截止时间 static图表显示 1. 产品介绍产品介绍 EasyVote 是在协同软件 Groove 下开发的供小组投票的插件工具。 EasyVote 将作为多种工具中的一种而整合在 Groove 的工作空间中。该投票工 具为满足客户需求而提供了多种的投票方式：OPEN, BLIND, PRIVATE, SECRET，不同方式下的用户权限也将受到限制；小组中的投票发起人和投票参 与者也将在简单、便捷而友好的用户提示下完

5、成创建投票，进行投票，查看结 果等一系列活动。 作为 IT 产业中迅速发展的协同软件中的一员，Groove Virtual Office 给在虚 拟环境中的工作者带来了极大的便利。在其中工作空间里集成的各个工具组件 使提供给用户的不同功能得以实现，如讨论，画图，幻灯片浏览等。具有投票 功能的 FlexiVote 也使其中之一，但其界面过于凌乱，部分功能也并不完善， 在用户的使用过程中带来很多不便。也正是出于这个原因，新版本的 EasyVote 将弥补这些缺陷，给用户提供一个完善功能强大的投票工具。 2. 产品面向的用户群体产品面向的用户群体 任何一组在虚拟环境下工作的团队即采用 Groove

6、协同软件进行工作辅助的团队， 都有可能会在工作中用到此投票工具。由于此投票工具是作为插件的形式整合 在 Groove 的工作空间里，所以当用户有投票需求的时候可以很方便的调用。而 EasyVote 简单便捷的操作方法可以使用户在很短时间里掌握，高效的可响应模 式也可以很快得反馈给投票发起人所需要得信息从而完成一次投票，这些都在 很大程度上提高了用户的工作效率，给团队间的协作带来了便捷和效益。 3. 产品应当遵循的标准或规范产品应当遵循的标准或规范 由于该投票工具 EasyVote 是在开发平台 Groove 下进行开发的，所以要采用 Groove 所提供的一些编程接口（API）来进行编写。且完

7、成后的工具应符合 Groove 整体的一些特性，如：简单性，透明性，安全性，可靠性，易管理性和 可响应性。因为 Groove 开发平台下已经将于底层的接口进行了封装和合并，这 在给基于 Groove 的包括 EasyVote 在内的各种工具插件进行的开发过程中带来 了极大的便利。 4. 产品的功能性需求产品的功能性需求 Create Index Outcome Submit V- Setting V-Num Title TYPE TitleStatistic PercentC-name Option Cancel V-namePre/Next 话题索引 结果查看投票发起 选票设置 4.0 功能

8、性需求分类功能性需求分类 功能类别功能类别子功能子功能 话题目录 title index 发起新话题 create new 查询已建话题 historical title 话题索引 (title index) 查看统计结果 outcome 投票话题名称 title 投票种类设置 vote style 选票数目 vote num 话题描述 title description 选票设置 vote setting 投票截止时间 deadline 提交投票事件 submit 投票发起 (vote start) 返回主题索引 return 候选人名称设置 candidate name 候选人描述 can

9、didate description 选项设置 option setting 选票切换 N&P 提交投票事件 submit 单张选票应用 apply 选票取消 cancel 选票设置 (vote setting) 投票截止时间 deadline 话题显示 title 话题描述显示 title description 候选人显示 candidate name 候选人支持率显示 percent 其他候选人查看 others 其他候选人支持率 percent 候选人支持率的甘特图显示 Gannet 查看结果 (outcome) 图表显示 static 4.1 话题索引话题索引 话题索引这一功能模块是

10、整个 Groove 投票插件系统的主界面，提供给投 票发起人和投票人话题的总体视图。它从高角度上完整地显示了已存在并 完成了的(历史上)的投票主题，以及当前正在进行的投票话题，直观明了， 可以点击便于选择和浏览。 4.1.14.1.1 话题目录话题目录 (title(title index)index) 话题目录中逐个列出了由投票发起人提交并发起的所有话题的主标题 Title。经授权的用户可以浏览所有主题，并通过鼠标点击来选定当前有 效的投票话题，进行投票。每次选定某一话题后，都将会弹出特定的选 票窗口，供投票人使用。这些选票都是由投票发起人进行设置和管理的， 具体细节会在稍后的章节中提到。

11、4.1.24.1.2 发起新话题发起新话题 (create(create new)new) 在开始具体的功能描述前，有必要将四种不同类型的投票方式进行说明： （1）Open 投票是完全公开的，投票人在进行投票前可以看到其他 投票人的投票情况，再决定自己的选票。 （2）Blind 投票人只有在完成自己的投票以后才能看到其他人的 投票情况。 （3）Private 必须先进行投票，然后才能看到最新的投票结果统计， 但投票人看不到其他人的具体投票情况。 （4）Secret 只有投票管理员（默认为投票发起人）可以看到总的 投票结果，以及投票人的具体选票。投票人无权查看。 发起新话题，也就是投票人按照需要

12、,创建一个新的投票话题，并将新 的话题提交到话题索引中。这包括投票话题的具体描述，以及话题内容 的设定。这些细节将在发起人选择新建话题的按钮之后，直接进入投票 发起 功能中进行具体设置。话题提交后，将直接对投票人可见，系统 将会发送一条 Message(一般情况是，Groove 自动提示工作空间内成员 有未读的数据)给工作组空间内所有成员，即投票人。还需指明的是， 接到了其他发起人的投票信息，投票人将无权在这个界面上使用 create new 这项功能。 4.1.34.1.3 查询已建话题查询已建话题 (historical(historical title)title) 这一功能是指，访问者

13、（投票人或发起人）访问者（投票人或发起人）可以对话题索引界面中已经 存在的话题进行点击浏览查看。这些话题是逐一按日期顺序列出的，最 上面的也就是最新的投票话题。此项功能对于投票人和发起人都是有权 访问的。 4.1.44.1.4 查看统计结果查看统计结果 此功能支持访问者访问者对已经完成的投票话题进行查看并对最终选票结果 进行统计，或查看当前正在进行（尚未完成的）的投票主题的最新的 动态的选票统计。具体结果查看的显示内容将会在查看结果 功能中进 行描述。 值得注意的是，不同的访问者能进行结果查看的权限是不同的，也就 是说在此功能界面，有些投票人是不能点击查看投票结果的(secret)。 对于投票

14、发起人来说，他并不受任何限制。而对于投票者，他对结果 是否有查看的权利，将由发起人在设置投票种类时所选定的上述四种 不同类型的投票模式中的某一种直接进行约束。我们以美国总统大选 为例，比如说，如果选举发起人将投票类型设定为 private，则所有 的投票人都只有权查看当前的总体票数统计结果，即每个候选人当前 的票数统计（支持率） ，而无权查看某个议员（投票人）所选定的是那 个候选人。 4.24.2 投票发起投票发起 投票发起是指投票发起人具体地创建新的选票话题，包括对投票的题目 设置(title)与描述(description)，设置投票方式的种类(vote style)， 投票截止日期及每个

15、话题相应的选票数目的确定等等。投票发起功能主 要是面对发起人对本次选票话题进行具体的设置，而投票人(或用户)是 无权对此功能界面进行访问的。 4.2.14.2.1 投票种类设置投票种类设置 (vote(vote style)style) 投票发起人发起某一个投票话题时就应该对这一话题的投票所采用的种 类进行设定。投票的种类，是指上文在 4.1.2 中提到的四种不同的投票 方式。发起人可在四种方式中选定一种，作为此次投票中所设定的种类。 投票种类一经设定，投票人在投票过程中的中的权利与限制也将随之被 设定。投票种类的默认值为 open。 4.2.24.2.2 选票数目选票数目 (vote(vot

16、e num)num) 选票数目是指发起人在发起某一个投票话题之后，将会设定有几个不同 的选票。此处设定的选票数目将会限制选票设置中的选票切换设置 功能 及选票提交 功能。仍以本文中美国大选为例，如果总统候选人由两个， 分别为布什与克里。则选票数目将会被设定为 2。并在设置选票时，会 提供给发起人两张空选票，要求发起人分别对将两者设置成两张不同的 选票。只有发起人将两张选票都完成设置后，发起的话题才会在话题索 引中添加。选票数目的默认值为 1，就是说当发起人只发起新话题，并 未对选票进行设计，就进行提交，那么该话题被自动默认为一张选票的 设置，出现在话题索引中。 4.2.34.2.3 话题描述话

17、题描述 (title(title description)description) 发起人需要对所发起的投票话题的目的、背景、以及题目的具体内容进 行描述，使投票人能对发起投票的目的有一个较详细的了解，从而能做 出更加有效和正确的选择。 4.2.44.2.4 投票截止时间投票截止时间 (deadline(deadline ) ) 每个投票话题的投票活动都有一定的有效期，超过这一时间后选票将不 再进行提交，当然也不再能将所选的选票计入统计结果。因此，投票人 必须在投票活动截止日期以前对选定并提交选票，否则过期将会无效。 4.2.54.2.5 具体选票设置具体选票设置 (vote(vote set

18、ting)setting) 这一功能允许发起人进入下一菜单，即完成选票题目的设定后进入下级 选票设置 功能页面，以便对将提交给投票人的选票进行具体细节上的 设计。 4.2.64.2.6 提交投票话题提交投票话题 (submit)(submit) 此处如果发起人省略对选票的设置，而直接将投票话题向上级菜单提 交，则选票情况就会被默认为, 本话题只有一种选票，而这张选票提供 给投票人三个选项：agree, disagree, dont know. 显而易见的是， 如果发起人设定的选票数目大于一，则他必须将所有指定数目的选票都 完成后，才能点 submit 提交，否则系统报错。因此，本功能只针对仅

19、有一种选票的话题才可用。 4.2.74.2.7 返回主题索引返回主题索引 returnreturn return 选项返回主题索引页面。 4.34.3 选票设置选票设置 选票设置是位于话题设置之后的关键一个用户功能，发起人通过这个功 能模块对选票进行设计，将其提交，投票人在选举时将参照在发起方设 计的选票进行选举，并最终提交。发起人和投票人在用到此功能时，将 会看到相同界面，区别是在发起人对选票设计，和投票人对选票查看是 由于其主要目的不同，将会在某些功能的使用上有很大区别，这一部分 将一一叙述。 在经过上一级功能模块（话题设置之后） ，发起人进入了选票设置功能模 块并看到一张空选票。系统将依

20、据上一级菜单中所设置的选票数，确定 了这个功能中有多少张空选票需要被设计。 4.3.14.3.1 候选人名称候选人名称 (candidate(candidate name)name) 发起方将在空白文本框中输入候选人名称（可修改的） 。当投票设计完 成发送到投票方后，候选人名称不能被修改。默认值为空，如果提交则 会有错误提示。 4.3.24.3.2 候选人描述候选人描述 (description)(description) 同 candidate name 一样，发起方将在空白文本框内输入描述的主要内容， 候选人的情况、背景、年龄等，供投票人在选举时使用，description 在投票方不能被

21、修改。默认值为空，可选填写。 4.3.34.3.3 选项设置选项设置 optionoption settingsetting 选项设置，方便发起人设计选票,选票选项具有规定的模式, 选项 1. Agree 同意此候选人 2. Disagree 不同意此候选人 3. I dont know 不做出选择， 选项的模式是固定的，在发起人方也就是选项设计一方，不能够对选票选 项进行修改，如增加一个选项，或将上面所列的固定选项的内容、次序、 题目进行修改，所以这一点对于发起人设计选票时是很重要的，它需要通 过选票切换来切换这几张选票，设计不同候选人选票，而不是设计一个话 题后，以候选人的名称做选项来设计

22、。 4.3.44.3.4 选票切换选票切换 N&PN&P（NEXT&PRIVIOUSNEXT&PRIVIOUS） 选票切换设置简称切换，这是跟上级功能模块选票数目相关的一项，通 过上级功能模块话题设置将话题数目锁定之后，系统将根据话题设置中话 题数目的数量，产生几张空的选票，这样在发起人功能模块，如果需要设 置不同的候选人，则通过 NEXT 和 PRIVIOUS 切换几张选票，进行设计，第 一张选票不存在 PRIVIOUS,所以 PRIVIOUS 不能点击，同理最后一张选票 NEXT 不能被点击。 4.3.54.3.5 选票应用选票应用 applyapply 每张选票完成后将点击 apply，

23、保存已设计的选票。 4.3.64.3.6 选票提交选票提交 submitsubmit 选票被全部设计完成之后，选票可以提交。发起人在话题设置功能模块已 经将话题数目固定，所以没有完成足够数目（全部）的选票设计工作前， submit 是不能被点击的，只能通过切换，来完成所有投票设计工作。 4.3.74.3.7 选票取消选票取消 cancelcancel 如果对在设计过程中话题不满意，可以在设计中点击 cancel,返回到话题 设置功能模块，重新设计话题和选票数目。 4.3.84.3.8 选票重置选票重置 resetreset 发起人将候选人名称或描述写错，但已经提交，可以通过 reset，重新设

24、 计该张选票，系统将此张选票的信息删除，选票被重置为空。 4.3.94.3.9 选举期限选举期限 deadlinedeadline 投票人应用流程：投票人应用流程： 投票人接受到选举信息， 首先，打开第一级功能模块，话题索引。通过点击某个话题进行投票，将 直接进入第三功能模块-选票设置功能模块。 第二步，进入后该功能模块系统讲提示给用户候选人选票数量，候选人名 称，描述等信息，以供候选人参考，N&P 键切换候选人。如果在这些选票 中选出候选人，只需在选项中点击 Agree 就可以选择，在多选一的情况下， 假如选择了 BUSH 作为美国总统，点击 Agree 后，其他候选人将不能被同 时被选择，

25、如果你在看到 TERRY 的信息后想重新选择，会被对话框提示， 为你是否愿意更改已有选择BUSH为TERRY可选择是被替换，否不被替换。 4.44.4 查看结果查看结果 总体描述：投票人发起投票到投票人完成投票之后，具有查看功能的用 户将进入这一级功能模块（open 与 private 只是在投票和查看结果先后 顺序存在差异，但是对于此功能模块的功能不存在影响） 。通过在第一级 功能模块的连接，每一个 title 名字的旁边都有一个，到查看功能模块的 连接，点击后就能查看某个话题的投票结果。 4.4.14.4.1 话题显示话题显示(title)(title) 将显示在第二级功能模块话题设置中设

26、置的选举话题。 4.4.34.4.3 话题描述显示话题描述显示 (description)(description) 将显示在第二级功能模块话题设置中设置的话题描述。 4.4.44.4.4 候选人显示候选人显示 (candidate(candidate name)name) 显示此次选举中支持率（同意率）排名前三位的用户（少于三个将显示全 部） 。 4.4.54.4.5 候选人支持率候选人支持率 (x(x 人人/y/y 人人) ) (percent)(percent) 对应列出前三名候选人支持率的百分数。还有总人数中的多少人支持。 4.4.64.4.6 其他候选人查看其他候选人查看 (othe

27、rs)(others) 通过下拉菜单查看全部第三级功能模块选票设计中出现的前三名用户之外 的其他用户名称（少于三名候选人无此功能显示） ，点击选中某个候选人后， 能看到他的支持率显示。 4.4.74.4.7 其他候选人支持率其他候选人支持率 (x(x 人人/y/y 人人) ) (percent)(percent) 对应列出除前三名候选人之外的其他候选人的支持率的百分数。还有总人 数中的多少人支持。 4.4.84.4.8 候选人支持率的甘特图显示候选人支持率的甘特图显示 (Gannet)(Gannet) 前三名将在对应位置给出甘特图显示，直观的表述前三名候选人的支持率 情况。 4.4.94.4.

28、9 图表显示图表显示 (statistics)(statistics) 是一种视图，由于发起人所设定的投票种类（权限不同） ，投票人可以部 分的或整体的查看投票的所有信息，如下格式： 投票人全体姓名对投票人可见： 1. wolfgang choose agree to BUSH at 2004. 12.17 2:00 2. wolfgang choose dont know to KERRY at 2004 12.18 14:10 3. someone choose agree to Basker at 2004. 12.17 2:00 投票人姓名对投票人不可见： 1. choose agre

29、e to BUSH at 2004. 12.17 2:00 2. choose dont know to KERRY at 2004 12.18 14:10 3. choose agree to Basker at 2004. 12.17 2:00 5.5. 产品的非功能性需求产品的非功能性需求 5.1 用户界面需求用户界面需求 Vote 这一插件共有 4 个界面，第一个是主页：Index 图 1 在图 1 中，title1/title2/都是链接标签的形式，对于用户来说，可以通过 点击相应的 title 进入选举话题。每一个 title 后面跟着一个 combo box，用 来注明该投票是哪

30、一类型（open、blind、private、secret） ，在这之后跟着的 是查看按钮 outcome，用户和发起人都可以通过点击该按钮来查看投票情况及 结果（后面详述） 。在界面右下方的 Create New Title 是用来发起一轮新的投 票的，发起人通过点击该处进入到下一个 Title 设计界面。 如图 2 所示： 首先发起人在 Title 文本框中写下该投票活动的名字，并选择该轮投票的类型 （Open , Blind, Private, Secret）,由 candidate 设定候选人数，便于以后 统计选票数，Description 中发起人可以大致解释此次选举的相关内容。 D

31、eadline 设定了选举的截至日期。Vote setting 按钮使发起人进入到选票的设 计界面，而 Exit 则使取消退出。 图 3 发起人通过图 2 中的 Vote setting 进入图 3 界面。发起者在 Candidate 中填入 一位候选人的名字，在 Description 中介绍该候选人。右边三个选项就是对该 候选人的态度：支持/ 不支持/弃权。Deadline 同样是截至日期，由于该界面 是两用的，所以对于发起人和投票人来说具有两种不同的情况。 对于发起人来说，对候选人的三种态度选项对其无效。而对投票人则是整个投 票的关键。他们只可以选其一。Previous 和 Next 分

32、别是用来向前/后翻选票的。 Return 则是返回，发起人是返回到图 2 的界面，投票人则是回到图 1 的界面。 对于 Submit 按钮两者也不一样。发起人只有所有候选人都设定好了才能提交选 票，而投票人只要投了票就可以提交，不管选了几张。 图 4 这个便是结果的界面了。对应于某一 title，name1 name2 name3 分别将得票最 多得前三位显示出来，用百分比表示。如果查看者要了解所有候选人得票数就 可以在 Others 中下拉菜单，选择自己要查看的名字，随后显示的就是该候选人 的得票率。如果想要查看详细的选举情况就可以点击 statistics，显示的是一 张电子表格，统计了每

33、一位投票人的选择记录。当然，对应不同的选举类型， 用户不一定能查看这一选项。Return 按钮返回。 5.25.2 软硬件环境需求软硬件环境需求 需求名称需求名称详细要求详细要求 主机拥有至少 256MB 内存，至少 10GB 的空余硬盘空间的 PC 机 网络与 Internet 相连的物理网络连接（包括局域网和拨号网络 连接） 操作系统Windows 2000, Windows XP 及 Windows Server 2003 浏览器Internet Explorer 6.0 及以上版本 基本软件协作软件 Groove Virtual Office v3.0 5.35.3 产品质量需求产品质

34、量需求 主要质量属性主要质量属性详细要求详细要求 正确性用户在选择了一定的投票类型后，相应的权限即被设定，确保 投票顺利进行。 健壮性1 在投票 Deadline 以后投票将会被告知不能投过期票。 2 已投过票的用户不能再次投票。 可靠性不存在内存泄漏，每一个投票在投票有效期内可以顺利运行。 性能，效率1 投票一旦发起，所有成员即被告知有新的投票。 2 用户在投票过后即可看到在他的权限允许范围内的投票结果。 易用性按钮的设计必须有逻辑关系，如：previous 按钮和 next 按钮 应放在一起。 清晰性1 界面的主要元素问题应放置于醒目的位置。 2 每项操作按钮都给用户以明确的意思表达。 、 附录附录 A A：用户需求调查报告：用户需求调查报告 A.1A.1 同类软件中提取的需求同类软件中提取的需求 需求标题 1同类软件中提取的需求 调查方式查找 Internet 上相关资料 调查人吴晓烁