评论

Requirements Portal 支持在需求项目中添加评论。评论是用户添加的备注，可关联到特定的需求、规格、章节、V&V 活动或模块，其他用户可以对其进行回复。评论由工作区独立于共享数据存储，因此能够促进用户协作，而不会更改共享数据本身。您可以在评论中提及一个或多个人员或群组，也可以将评论指派给工作区成员。

您可以通过上下文评论窗口，直接在需求表格和项目树中发布、回复和管理评论。评论也会显示在右侧的 Comments and Tasks 面板中，该面板主要用于概览和导航，而非具体操作。 使用右上角的  控件可显示或隐藏 Comments and Tasks 面板。

添加评论

您可以通过以下任一方式进入评论放置模式：

• 单击 Comments and Tasks 面板顶部的  按钮，然后使用出现的放置光标 ()，在表格中选择需求行，或在左侧项目树中选择规格、章节、V&V 活动或模块，以添加评论 ()。

• 单击需求所在行中的  按钮，然后从弹出的菜单中选择 Comment 命令 ()。

• 右键单击左侧项目树中的规格、章节、V&V 活动或模块条目，然后从上下文菜单中选择 Comment 命令 ()。

无论采用哪种方式，都会显示评论窗口，供您针对所选实体添加评论。在提供的字段中输入评论。您可以在评论中提及一个或多个人员或群组。在评论字段中输入 @ 字符，即可快速访问工作区成员列表。您还可以将评论指派给某位成员。有关这些附加功能的更多信息，请参阅 使用上下文评论窗口部分。

输入评论、添加提及对象并根据需要完成指派后，单击下方的  按钮。评论将被提交，并同时显示在上下文评论窗口和 Comments and Tasks 面板中。 对于已添加评论的需求，其 Identifier 列中会显示评论标记 ()。

以下系列图片展示了如何为需求添加示例评论，同时提及一位团队成员并向其指派任务（详情见下文）。

使用上下文评论窗口

以下要点介绍了如何使用评论及界面中的上下文评论窗口：

• 单击 Comments and Tasks 面板中的评论条目，即可打开评论窗口。

  

• 单击并拖动窗口顶部栏，可自由移动窗口。

• 使用评论窗口左上角的 按钮，可分别依次切换到上一条和下一条评论。

  您也可以使用 Shift+Left Arrow 和 Shift+Right Arrow 分别切换到上一条和下一条评论。

• 发布首条评论后，再次打开评论窗口时，即可直接输入回复。在提供的字段中输入文本，然后单击 按钮提交。 若要退出而不回复，请按 Esc。

• 您可以在评论中提及人员或群组。输入 @ 字符，即可弹出工作区团队所有成员的列表。您也可以输入 @ 后再输入一个或多个字符，来搜索群组或人员（人员可按姓名或电子邮件地址搜索）。随后会显示匹配的群组、团队成员以及团队外部（但属于您所在组织）的人员列表，供您选择。您可以单击条目进行添加，也可以使用 Up Arrow / Down Arrow 键选择后按 Enter 添加。

  被提及的人员（团队成员或被提及群组的成员）会收到有关该评论的电子邮件通知。

  

  您可以在评论中提及任何人员或群组。输入 @ 字符，即可访问所有工作区成员和群组的列表。

  

  您也可以输入 @，然后开始键入内容，以搜索群组或人员。动态列表中包含工作区成员、组织内的其他人员以及为工作区定义的群组。

  

  回复评论时，您还可以向新提及的人员指派任务。

  

  所需的人员或群组将作为提及对象显示在评论文本中（尽可能显示其名称）。

   

• 您可以向被提及的人员指派任务。启用 Assign a Task to 选项即可；默认指派给第一个被提及的人员，如果未提及任何人，则指派给您自己 (Me)。您也可以使用下拉菜单选择其他工作区成员来指派任务。被指派人员会在 Comments and Tasks 面板条目中以其用户头像或姓名首字母显示，同时显示关联的任务编号。编辑评论时，可以更改或移除任务指派。

  

  如果评论关联了任务，其窗口的顶部边框会包含：

  • 一个图标（图片/字母），用于指示被指派处理该评论任务的成员。选择该图标，即可从下拉列表中将任务重新指派给其他工作区成员。

  • 任务的字母数字编号，由实体标识符 和任务编号后缀组成。单击该编号，即可交叉定位到工作区任务页面中的相应任务条目。

    在工作区的 Tasks 页面中，您还可以查看和更改任务优先级（默认为 Medium）。

  • 任务的当前活动状态（To Do、In Progress、Resolved），可通过相应的下拉菜单 （）进行更改。

  

• 使用评论窗口的  菜单中提供的 Convert to Task 选项，可以为现有评论添加任务。新任务最初会指派给您；单击左上角的受派人头像打开下拉列表，再选择其他工作区成员，即可更改受派人。

  

• 评论窗口还支持粘贴 Windows 剪贴板中的图像文件或截取的屏幕截图。您可以将屏幕截图（或复制的图像文件）粘贴到评论字段中，放在任何文字备注和用户提及内容之前或之后。图像会显示在评论窗口的正文中，单击图像即可打开并以原始大小查看。已发布评论在 Comment and Tasks 面板中的条目将包含一条相关的 includes images 备注。

  

• 只能通过评论窗口，分别使用 Edit 和 Delete 命令编辑或删除评论。这些命令位于  控件的关联菜单中。请注意，这些命令仅适用于您自己发表的评论，您无法编辑或删除其他用户的评论。编辑现有评论时，请完成修改，然后单击  按钮提交。若要退出而不应用任何更改，请按 Esc。

  请注意，删除评论时，其所有相关回复也会一并删除。

  

• 打开评论窗口时，仅显示线程中的首条和最新评论。要查看线程中的所有评论，请单击这两条评论之间的控件。使用滚动条可浏览所有评论。

  

• 通过切换评论窗口顶部的 控件，可以将评论标记为已解决（或重新激活）。如果评论有已指派的任务，则可以从状态下拉菜单中将其当前状态更改为 Resolved（或其他状态）。默认情况下，已解决的评论不会显示在 Comments and Tasks 面板中，但可以通过其显示/隐藏标记选项将其显示出来，有关更多信息，请参阅下一节。

  

使用评论面板

以下要点介绍如何使用评论以及界面中的 Comments and Tasks 面板：

• Comments and Tasks 面板用于概览和浏览整个项目中的评论，而不是用于发表评论、编辑评论和回复。这些操作只能在上下文评论窗口中进行。

• 单击主查看区域中的评论标记，也可以打开 Comments and Tasks 面板，同时还会打开上下文评论窗口。

• 使用面板右上角的控件，可以在需求表中显示评论标记（）或将其隐藏（）。

  

  

   

• Comments and Tasks 面板顶部的控件可用于访问线程筛选设置，从而决定面板中显示的内容。基本上可以定义两个级别的筛选。第一级（主筛选）用于控制显示哪些用户的评论。

  

  面板的筛选选项可将评论条目限定为：

  • Tasks only – 仅显示已被指派为用户任务的评论，这些任务也会出现在任务页面的流程中。

  • Assigned to – 仅显示已指派给下方所选用户的评论。选中某个用户的复选框后，面板（以及显示的文档）中将仅包含任务已指派给该用户的评论。请注意，无论是否有评论任务指派给当前登录用户，该用户都会显示在列表顶部。

  第二级筛选与主筛选配合使用，提供两个选项，可用于隐藏所有已解决的评论或任务（启用 Unresolved only），和/或仅显示当前所选上下文（即文件夹、规格说明、章节、V&V 活动或模块）的评论，而不是整个项目的评论（启用 Current context only）。

  

• 单击上述选项窗口底部的 Notification Settings 条目，可打开一个窗口，配置您希望接收项目中哪些评论的电子邮件通知。您可以选择接收所有评论线程的通知、不接收任何评论线程的通知，或仅接收您参与的评论线程（由您发起、您回复过或提及了您的线程）的通知。

  

• 面板中的评论线程同样按两个级别排序。首先，按评论所属的实体排序，其顺序与左侧树中项目结构的顺序一致。其次，在每个实体内，按评论的创建日期降序排列。

• 单击面板中的评论线程条目后，该评论将在上下文评论窗口中打开。Comments and Tasks 面板中的相应评论条目也会以蓝色高亮显示。 如果单击的评论不属于当前查看的实体，则会跳转到该评论所属的实体。

  

• 面板中的每个评论条目都会汇总显示该评论的关键信息，如下方示例所示。