Mantis - 快速指南

---

---

Mantis - 简介

Mantis Bug Tracker 是一款开源的基于 Web 的应用程序工具。它用于在整个缺陷生命周期中跟踪 Bug。除了 Bug 跟踪外，Mantis 还支持发布功能以管理项目的各种版本或软件。

Mantis 也称为 MantisBT，代表 Mantis Bug Tracker。Mantis 的名称和徽标指的是昆虫螳螂科。在软件中，它被称为 Bug。

Mantis 提供了演示、下载（设置自己的 Mantis）和托管版本的工具。它支持各种用于问题跟踪和生命周期的功能以及发布管理。

Mantis 的开发始于 2000 年，由伊藤健三郎发起。后来在 2002 年，其他团队成员（Jeroen Latour、Victor Boctor 和 Julian Fitzell）加入。Mantis 的基本版本 1.0.0 于 2006 年 2 月发布。

2012 年，GitHub 成为 Mantis 项目源代码的官方存储库。

许可证和免费试用

• 它是一个开源软件。使用其基本版本不需要许可证。

• 它免费提供演示和托管版本进行试用。

• 它支持下载功能以设置您自己的 Mantis 软件。用户可以使用电子邮件 ID 注册。

• Mantis 根据添加的功能提供不同的价格报价，可以在 https://www.mantishub.com/pricing 查看。

用法

• 跟踪整个缺陷生命周期中的所有 Bug/问题。

• 在发布级别进行管理。

• 支持分析和报告功能。

• 支持与其他软件和 IDE 的插件，使其更强大和有效。

规格

Mantis - 功能

Mantis 支持广泛的功能来吸引质量保证人员和其他利益相关者进行 Bug 跟踪。以下是 Mantis 的核心功能。

核心功能

Mantis - 安装

Mantis 是一个 Web 应用程序，为属于同一公司/项目的个人或一组请求的用户提供私有网站。

Mantis 可以在服务器端运行。它是一个基于 PHP 的应用程序，并支持所有操作系统平台，例如不同版本的 Windows、Linux、MAC 等。它还在移动视图中支持移动浏览器。

系统要求

由于 Mantis 是一个 Web 应用程序，因此它遵循客户端/服务器的概念。这意味着，Mantis 可以集中安装在服务器上，用户可以通过任何计算机上的网站使用 Web 浏览器与之交互。

• Web 服务器 - Mantis 已在 Microsoft IIS 和 Apache 上进行了测试。但是，它可以与任何最新的 Web 服务器软件一起使用。Mantis 仅使用.php 文件。仅使用.php 扩展名配置 Web 服务器。

• PHP - Web 服务器应支持 PHP。它可以作为 CGI 或任何其他集成技术进行安装。

• 必需的 PHP 扩展 - RDBMS 的扩展是 mysqli、pgsql、oci8、sqlsrv，mbstring 是 Unicode - UTF-8 支持所必需的。

• 可选扩展 - Curl、GD、Fileinfo。

• 数据库 - Mantis 需要数据库来存储其数据。MySQL 和 PostgreSQL 是受支持的 RDBMS。

• 客户端要求 - Firefox 45 及更高版本、IE 10 及更高版本、Chrome、Safari 和 Opera。

用户可以单独手动或自动安装所有需求以使用 Mantis。

系统需求的安装

如果用户对安装过程有足够的了解，则可以在继续安装 Mantis 之前单独逐一安装所有需求。

或者，有许多一体化软件包可用，其中包含所有需求，并且可以通过 exe 文件自动安装到系统中。在这里，我们将借助 XAMPP 来轻松安装先决条件。

步骤 1 - 访问 https://www.apachefriends.org/index.html 并单击 Windows 版 XAMPP，如下面的屏幕截图所示。

步骤 2 - 将显示一个弹出窗口以保存文件。单击“保存文件”。它将开始下载文件。

步骤 3 - 运行.exe 文件以运行安装向导。单击.exe 文件后，将显示 XAMPP 设置向导。单击“下一步”。

以下屏幕截图显示了 XAMPP 设置向导。

步骤 4 - 下一个向导显示将安装的所有组件文件，如下面的屏幕截图所示。选择组件后，单击“下一步”。

步骤 5 - 提供一个文件夹名称，XAMPP 将安装到该文件夹中，然后单击“下一步”。

将显示“准备安装”向导。

步骤 6 - 单击“下一步”开始安装。

步骤 7 - 安装成功后，它将要求启动控制面板。选中复选框并单击“完成”。它将打开 XAMPP 控制面板，如下面的屏幕截图所示。

步骤 8 - 单击 Apache 和 MySQL 的“启动”按钮，Mantis 需要这两个按钮，如上面的屏幕截图所示。

步骤 9 - 要验证 Apache、PHP 和 MySQL 等所有先决条件是否已正确安装，请导航到任何浏览器，键入https://127.0.0.1 并按 Enter 键。它将显示 XAMPP 的仪表板。单击右上角的 phpAdmin，如下面的屏幕截图所示。

下一个屏幕截图将显示常规设置、应用程序设置、数据库、Web 服务器和 phpMyAdmin 的详细信息。

如果安装不正确，则不会显示此页面。到目前为止，所有先决条件已成功安装到系统中。

安装并启动 Mantis

步骤 1 − 要下载 Mantis，请访问 https://www.mantisbt.org/ 并点击“下载”。

步骤 2 − 在下一页点击“下载”，如下图所示。

步骤 3 − 再次点击“下载”，如下图所示，并保存 **.zip** 文件。

步骤 4 − 进入 XAMPP 安装文件夹，并导航到 htdocs 文件夹。解压缩下载的 Mantis 文件夹并将其放置在如下图所示的位置。

步骤 5 − 将文件夹名称 mantis 2.5.1 重命名为 mantis，以便获得更好的 URL。

步骤 6 − 现在打开浏览器，在导航栏中输入 **https://127.0.0.1/mantis** 并按 Enter 键。它将显示 Mantis 的索引页面，如下图所示。点击 mantis-2.5.1。

它将显示安装前的页面，如下图所示。

步骤 7 − 进入“安装”部分，根据需要进行更改。然后，点击“安装/升级数据库”按钮。

安装完成后，它将显示“检查安装”页面，并标记为“良好”，即 Mantis 已正确安装。

步骤 8 − 要启动 Mantis，请使用 URL **https://127.0.0.1/mantis 并点击 mantis-2.5.1**。它将显示 Mantis 的登录页面，如下图所示。

注意 − 在使用 URL 之前，请确保 Web 服务器和数据库都已启动，否则将显示“页面加载错误”。

步骤 9 − 使用“管理员”作为用户名并点击“登录”。它将要求输入密码。使用“root”作为密码并点击“登录”。

登录成功后，它将显示 Mantis 的仪表板。

Mantis - 试用设置

Mantis 是一款开源工具。但是，Mantis 支持演示版和托管版，用户可以在下载工具之前体验其功能。

演示试用设置

以下是设置演示试用的步骤。

步骤 1 − 访问 https://www.mantisbt.org/ 并点击“演示”，如下图所示。

步骤 2 − 在下一页，点击“开始免费试用”。

步骤 3 − 在注册页面填写所有详细信息，然后点击“注册我”按钮，如下图所示。

设置 URL 和 30 天免费试用需要 1-2 分钟。设置成功后，用户将能够看到 Mantis 的仪表板/我的视图页面。

以下屏幕截图显示了 Mantis 的“我的视图”页面。

Mantis - 登录

步骤 1 − 要登录 Mantis，请访问您的示例演示网站。它将打开一个登录页面。

步骤 2 − 填写您注册的电子邮件地址/用户名并点击“登录”。

步骤 3 − 成功验证用户名后，它将要求输入密码。输入密码并点击“登录”按钮。

以下屏幕截图显示了如何使用凭据登录 Mantis。

错误情况

由于登录失败，将显示错误页面，用户将返回到用户名页面。以下屏幕截图显示了如果密码错误，用户收到的错误消息。

点击“忘记密码？”

提供用户名和电子邮件地址以获取密码重置链接。点击“提交”，如下图所示。

用户将收到一封包含密码重置 URL 的电子邮件。

登录成功

登录成功后，系统仪表板将显示该帐户是否与管理员关联的任何项目，或者用户可以创建一个示例项目，这将在后续章节中讨论。

以下屏幕截图显示了 Mantis 登录成功后的仪表板/我的视图页面。

Mantis - 我的视图

登录 Mantis 后，“我的视图”是第一个显示的页面。“我的视图”由管理员自定义。根据角色，管理员可以设置对 Mantis 的访问权限。管理员甚至有权更改徽标、名称以及基于角色/个人的信息访问权限。

位于 Mantis 页面顶部的导航栏在 Mantis 的所有页面/屏幕中都相同。“报告问题”、“邀请用户”、“管理员”和“帮助”是导航栏的主要链接。

菜单栏（左侧从上到下）包含多个部分。这些部分是 Mantis 的核心，涵盖了所有主要功能。菜单栏包含以下部分：我的视图、查看问题、报告问题、更改日志、路线图、摘要和管理。

除了菜单栏和导航栏之外，主要的资讯部分属于“我的视图”页面。除了此部分之外，页面的所有其他部分都是静态的，并且在所有页面中保持不变。

在左侧（菜单栏之后），用户可以在不同的部分查看已登录的问题，例如“分配给我”、“未分配”、“我报告的”、“已解决”、“最近修改”和“我监控的”。

用户可以通过点击问题 ID 和名称导航到特定问题。

在页面右侧，用户可以看到入门指南。在这里，新用户可以了解基本功能以开始使用 Mantis。有一个几分钟的教程让用户了解如何维护项目结构。

以下屏幕截图显示了 Mantis“我的视图”页面的概述。

在“入门”部分下方，还有一个名为“时间线”的部分。

在这里，用户可以看到在一周或给定时间范围内执行了哪些活动，例如谁创建了问题、创建了多少问题、谁最近选择了哪个问题等等。

以下屏幕截图显示了“我的视图”页面的“时间线”部分。

Mantis - 项目管理

要执行项目管理活动，用户必须拥有管理员权限。

创建项目

以下是创建项目的步骤。

步骤 1 − 以管理员身份登录。

步骤 2 − 进入左侧菜单栏中的“管理”部分。

步骤 3 − 点击“管理项目”选项卡。

步骤 4 − 要创建新项目，请点击“创建新项目”按钮。要编辑现有项目，请点击项目名称。这里，“我的项目”是现有的默认项目。

以下屏幕截图显示了如何创建新项目。

步骤 5 − 点击“创建项目”/“项目名称”后，将打开“创建项目”表单。

步骤 6 − 在创建之前输入以下字段：

• 名称 − 输入项目名称。

• 描述 − 项目的简要描述或摘要。

• 状态 − 项目的成熟度或开发状态。这是一个信息字段，不会影响 Mantis。

• 查看状态 − 它确定谁可以访问项目，对于公共项目，项目是否可以被所有已登录的用户查看。私有项目仅对分配给项目的用户或管理员可见。

步骤 7 − 现在，点击“添加项目”按钮。

以下屏幕截图显示了要输入/编辑以添加/更新新项目的字段。

成功创建项目后，用户可以在项目部分看到一个新条目，如下图所示。

选择项目

要选择项目，可以在页面右上角使用导航功能。要查看此选项，用户必须有权查看至少 2 个项目。用户有权查看的项目列在“所有项目”选项下。

如果用户从列表中选择“所有项目”选项，它将显示用户有权查看的所有列出的项目。

要查看单个项目，用户应从列表中选择特定项目。

以下屏幕截图显示了如何选择项目。

归档项目

如果用户希望从可用项目列表中隐藏某个项目，从顶部下拉列表中，归档项目是解决此问题的方案。

归档项目后，用户将无法查看相应项目的 issue。

可以根据需要取消归档项目。

步骤 1 − 进入“管理”→“管理项目”。

步骤 2 − 点击需要归档/取消归档的项目名称。

步骤 3 − 选中/取消选中“启用”字段以取消归档/归档。

步骤 4 − 点击“更新项目”。

以下屏幕截图显示了如何归档/取消归档项目。

Mantis - 管理类别

创建项目后，用户应分类类别。类别允许将 issue 分为不同的领域，例如“用户界面”、“后端”、“数据库”、“服务”等。它基于 issue 的类型、软件的功能领域或各个开发团队的专业知识。

用户可以创建特定于项目的类别或在所有项目中全局定义它。Mantis 支持一个称为“常规”的预定义全局类别。这在将 issue 在项目之间移动时用作默认类别，并且目标项目中没有源类别。

创建类别

步骤 1 − 进入“管理”→“管理项目”选项卡。

步骤 2 − 在文本框中输入类别名称，然后点击“添加类别”。

以下屏幕截图显示了如何添加全局类别。

添加成功后，用户将在“全局类别”部分看到类别名称。用户可以通过点击“操作”列下的“编辑”按钮随时编辑类别。

以下屏幕截图显示了添加的类别和“编辑”按钮。

配置类别

可以将类别配置为默认分配者。

在此类别下记录的所有 issue 将自动分配给团队成员。

步骤 1 − 要配置类别，请进入“管理”→“管理项目”→“全局类别”。

步骤 2 − 点击“编辑”以配置特定类别，如上一屏幕截图所示。

步骤 3 − 在“编辑项目类别”中，从下拉列表中选择“分配给”。

步骤 4 − 点击“更新类别”。

在这里，用户也可以编辑类别名称。

以下屏幕截图显示了如何配置类别。

删除类别

步骤 1 − 要删除类别，请进入“管理”→“管理项目”。

步骤 2 − 点击要删除的特定类别。然后，从“操作”列中点击“删除”按钮，如下图所示。

步骤 3 − 点击“删除”后，Mantis 将显示一条警告消息并要求确认，用户是否要删除特定类别。点击“删除类别”按钮，如下图所示。

如果 issue 列在已删除的类别下，删除后，issue 将自动更新并显示为“无类别”。

用户可以手动筛选问题并更新其所属类别。

Mantis - 版本

版本也称为发布版。它们是一系列用于达成/解决问题的目标。这些目标可以维护在版本中。

项目更新和开发被组织成多个发布版或版本。版本可以命名为 1.0、1.1，或者基于功能的发布日期，例如“20171020”。

版本用于问题中所有与版本相关的字段。只有当项目拥有版本时，版本才会显示在问题中。用户需要在项目中创建版本才能使用此功能。

在问题表单中，有 3 个与版本相关的字段：产品版本、目标版本和修复版本。

产品版本记录了用户发现并记录问题的版本。

目标版本是未来或当前的版本，用于显示计划在哪个版本中修复问题。这会自动填充项目路线图。

修复版本显示了实际修复或实现问题所在的版本。这会自动填充项目变更日志。

更新或添加版本

步骤 1 - 要添加或更新项目的版本，请转到“管理”→“管理项目”选项卡。

步骤 2 - 点击要添加版本的项目名称。

步骤 3 - 向下滚动到“版本”部分。

以下屏幕截图显示了如何导航到“版本”。

以下屏幕截图显示了如何通过输入版本名称并点击“添加版本”来添加版本。

步骤 4 - 要更新版本，请点击上面显示的“编辑”按钮。

步骤 5 - 用户可以根据需要更新所有字段。点击以下屏幕截图中显示的“更新版本”。

Mantis - 问题生命周期

生命周期表示问题的不同阶段或状态。生命周期从报告问题开始，到问题解决或关闭结束。问题主要可以有 3 个阶段：打开、解决和关闭。但是，Mantis 支持更多状态，将在后面进一步解释。

状态

新建 - 这是用户报告新问题时的初始状态。下一个状态可能是“反馈”、“已确认”、“已确认”、“已分配”或“已解决”。

反馈 - 此状态用于审查目的。在分配给团队成员之前，会进行审查流程以确定问题的有效性和相关团队。下一个状态可能是“新建”、“已分配”或“已解决”。

已确认 - 开发团队使用此状态来确认已收到问题或同意报告者的意见。但是，他们可能尚未重现问题。下一个状态是“已分配”或“已确认”。

已确认 - 此状态通常由开发团队使用，以反映他们已确认并重现了问题。下一个状态是“已分配”。

已分配 - 此状态用于反映问题已分配给团队成员之一，并且该团队成员负责修复它并积极处理它。下一个状态是“已解决”。

已解决 - 此状态用于反映问题已修复或解决。问题可以在以下任何解决方案中得到解决。例如，可以将问题称为已解决，因为“已修复”、“重复”、“不会修复”、“无需更改”或其他原因。下一个状态是“已关闭”，或者如果问题被重新打开，则为“反馈”。

已关闭 - 此状态反映问题已关闭并已成功验证。无需对其进行进一步操作。问题关闭后，它会将其从“查看问题”页面隐藏。

Mantis - 报告问题

定义项目和类别后，用户可以针对不同类别的项目报告问题，以跟踪进度。

以下是报告问题的步骤：

步骤 1 - 如果用户可以访问多个项目，则首先在屏幕右上角选择要报告问题的项目。

有两种方法可以进入“报告问题”表单：

步骤 2 - 点击项目筛选器旁边的顶部“报告问题”链接，或点击左侧菜单栏中的“报告问题”部分。

以下屏幕截图显示了如何设置项目筛选器以及“报告问题”的可用选项。

步骤 3 - 点击“报告问题”后，它会打开“输入问题详细信息”页面，其中包含必填字段和可选字段。

步骤 4 - 正确输入所有详细信息。这些字段如下：

• 类别 - 定义它属于项目的哪个领域，例如开发、数据库和服务，以便相关团队可以开始调查。

• 摘要 - 问题的简短标题，提供有关问题的概览信息。

• 描述 - 问题的详细信息。它应包含所有相关的详细信息，从次要到主要，以便相关团队成员分析所有方面。

除了必填字段外，还有诸如设置严重性、优先级、标签和查看状态等有用的可选字段。

用户还可以将其分配给特定用户以及上传文件作为附件。

步骤 5 - 如果用户想要报告多个问题，请选中“保持报告”复选框，这将在提交问题后返回到报告问题页面。

步骤 6 - 现在，点击页面底部的“提交问题”按钮。

以下屏幕截图显示了不同的字段和“提交”按钮。

步骤 7 - 成功创建后，用户会导航到“查看问题”页面，在那里可以看到新报告的问题。

Mantis - 导入问题

用户可以使用 CSV 文件一次创建多个问题。CSV 文件是逗号分隔的文件。

CSV 文件规则

创建 CSV 文件时，必须考虑以下几点：

• 每个项目应使用单独的 CSV 文件。

• CSV 文件应保存为 CSV（逗号分隔）。

• 用户应在开始 CSV 导入步骤之前切换到该项目。

• 所有条目都应在记事本应用程序中创建。每个条目都应以逗号“，”分隔。

• 文件应保存为 filename.csv，文件类型为所有文件。

• 不要将 ID 字段与 CSV 中的任何字段映射。系统会自动生成问题 ID。

• 对于多行，可以使用“\n”。

• 对于时间戳字段（例如问题提交和上次更新时间戳），建议使用 ISO 8601。但是，PHP 接受任何 strtotime() 方法。如果提供整数作为值，则将其视为自 Unix 纪元（1970 年 1 月 1 日 00:00:00 GMT）以来的秒数。

示例文件如下所示：

导入 CSV

要导入 CSV 文件，用户应执行以下步骤：

步骤 1 - 转到“管理”→“管理插件”。

步骤 2 - 检查 CSV 导入器插件是否已安装。

步骤 3 - 如果未安装，请点击以下屏幕截图中显示的“安装”。

步骤 4 - 由于“已安装插件”中没有 CSV 导入器，请转到“可用插件”部分并找到 CSV 导入器。点击以下屏幕截图中显示的“安装”。

步骤 5 - 安装后，用户可以在“已安装插件”部分看到 CSV 导入器。“导入 CSV 文件”部分也存在。点击以下屏幕截图中显示的“导入 CSV 文件”。

步骤 6 - 点击“导入 CSV 文件”后，会打开从 CSV 文件导入问题的窗口。根据文件和需求选择各种选项，如以下屏幕截图所示。之后，点击“选择文件”浏览文件，然后点击“上传文件”。

步骤 7 - 成功上传后，用户可以按列查看数据。在下方，用户需要将这些列与问题表单的不同字段进行映射，如以下屏幕截图所示。

步骤 8 - 映射完成后，点击“导入文件”按钮。

导入完成后，用户可以看到成功和失败条目的计数。

系统会自动导航到“查看问题”选项卡下的“查看问题”部分，如以下屏幕截图所示。

Mantis - 查看问题

在“查看问题”部分，用户可以查看项目的所有已报告错误。用户可以筛选以缩小搜索范围，并导出所有问题和打印报告。所有主要的问题功能都可以通过“查看问题”访问。

我们将在不同的章节中讨论所有这些功能。在本节中，我们将讨论筛选器、导出和打印报告。

筛选器

要在“查看问题”中使用筛选器，应执行以下步骤：

步骤 1 - 从左侧菜单点击“查看问题”。

在前半部分，显示筛选器部分，用户可以在其中设置各种筛选器。

步骤 2 - 要设置筛选器，请点击字段名称。例如：在本例中为“报告人”。它将显示可用的下拉列表以供选择。

步骤 3 - 选择其他筛选器后，点击“应用筛选器”以搜索结果，如以下屏幕截图所示。

步骤 4 - 点击“应用筛选器”按钮后，问题将显示在屏幕底部的“查看问题”部分，如以下屏幕截图所示。

步骤 5 - 点击“保存当前筛选器”，用户可以保存筛选器并在需要时使用。

步骤 6 - 点击“保存当前筛选器”按钮后，将打开以下表单以输入筛选器名称。输入名称并选中“设为公开”、“应用于所有项目”。点击“保存当前筛选器”。

步骤 7 - 在“保存筛选器”按钮旁边将显示一个下拉菜单，用户可以在其中看到当前保存的筛选器名称并从中选择筛选器。此下拉列表显示所有可用的筛选器列表，如以下屏幕截图所示。

打印报告

在“查看问题”→“查看问题”部分，用户可以打印问题的记录和基本详细信息。筛选出问题后，用户可以将其打印成不同的格式。

要打印报告，应执行以下步骤：

步骤 1 - 从菜单转到“查看问题”，设置筛选器并点击“应用筛选器”。

步骤 2 - 现在，转到“查看问题”部分并确保显示了问题。

步骤 3 - 选择要打印的问题并点击“打印报告”，如以下屏幕截图所示。

问题将显示为浏览器页面，并且屏幕左上角具有 Word 和 HTML（Internet Explorer）符号，如以下屏幕截图所示。

步骤 4 - 点击 Word 符号，它将下载包含错误详细信息的 Word 文件。示例 Word 文件如下所示：文件名将为<项目名称>.doc，其中包含每个问题的完整详细信息。

步骤 5 - 点击 HTML 符号，将打开一个新浏览器，其中包含每个问题的完整详细信息，如以下屏幕截图所示。

CSV/Excel 导出

要导出为 CSV/Excel 文件，应执行以下步骤：

步骤 1 - 从菜单转到“查看问题”，设置筛选器并点击“应用筛选器”。

步骤 2 − 进入页面底部的“查看问题”部分，并确保问题已显示。

步骤 3 − 选择要导出的问题，然后点击“CSV/Excel 导出”，如下图所示。

相应的包含错误详细信息的文件将被下载。

示例 CSV 文件的格式如下图所示。

示例 Excel 文件的格式如下图所示。

Mantis - 编辑问题

用户可以随时编辑问题的详细信息。要编辑问题，用户应从“我的视图”页面或左侧菜单选项中的“查看问题”页面打开问题。

编辑问题时应执行以下步骤。

步骤 1 − 通过点击问题 ID 在“查看”页面打开问题。

用户将能够看到“查看问题详细信息”页面的各个部分 -

• 查看问题详细信息
• 关系
• 监视此问题的用户
• 活动
• 添加备注
• 问题历史记录

以下屏幕截图显示了“查看问题”页面中的所有部分。

步骤 2 − 打开“查看问题详细信息”页面后，点击“编辑”按钮，如下图所示。

“更新问题信息”页面将打开，显示可编辑字段，如下图所示。

步骤 3 − 编辑完信息后，点击“更新信息”按钮，如下图所示。

更新的信息和日志详细信息可以在“问题历史记录”部分看到，如下图所示。

Mantis - 克隆问题

克隆指的是复制。克隆问题意味着在同一项目中快速创建一个重复的问题。克隆的问题可以被视为一个新问题，并像其他问题一样进行编辑。

克隆的问题与原始问题是完全独立的。在原始问题上执行的任何操作或操作都不会影响克隆问题，反之亦然。原始问题和克隆问题之间唯一的联系是创建的链接。

以下信息从原始问题复制到克隆问题。

• 摘要
• 描述
• 指派给
• 环境
• 优先级
• 类别
• 版本
• 报告者
• 目标版本
• 修复版本
• 问题链接
• 附件
• 项目
• 自定义字段的内容

以下信息不会被克隆 -

• 时间跟踪
• 评论
• 问题历史记录

以下是克隆问题的步骤。

步骤 1 − 通过点击问题 ID 在“查看”页面打开问题。

将显示“查看问题详细信息”页面的以下部分。

• 查看问题详细信息
• 关系
• 监视此问题的用户
• 活动
• 添加备注
• 问题历史记录

步骤 2 − 打开“查看问题详细信息”页面后，点击“克隆”按钮，如下图所示。

它将打开报告页面，并将所有可用详细信息复制到相应的字段中，如下图所示。

步骤 3 − 在页面底部，“与父问题的关联”字段中写有原始问题 ID。选择原始问题和克隆问题的关系，如下图所示。

步骤 4 − “从父问题复制扩展数据”部分有两个复选框 - “复制问题备注”和“复制附件”。如果要复制相同内容，请选中这些复选框。默认情况下，这些复选框未选中。

步骤 5 − 选择后，点击“提交问题”按钮。

提交成功后，将生成一个新的问题 ID，并打开“查看问题”页面。

Mantis - 高级功能

在报告问题时，除了某些常规信息外，Mantis 还支持一些高级功能，使其更具信息性和实用性。在本章中，我们将讨论这些高级功能。

@提及 - 通知

Mantis 支持@提及，以便吸引用户的注意，并发送有关问题或备注的通知，即使他们不在通知列表中。

这是一种简单的方法来引起某人的注意。只需在问题备注或描述中引用一个同事，就会通过电子邮件发送包含备注详细信息以及指向问题详细信息的链接的通知。

要在“描述/备注”部分提及用户，首先写@，然后写上用户的名称，如下图所示。

@提及是用户页面上的超链接，在格式化备注/问题时会突出显示。

在这种情况下，用户会收到常规电子邮件通知和@提及通知。但是，@提及通知的格式更简单，主题也不同。

以下屏幕截图显示了收到的@提及电子邮件。

发送提醒

发送提醒是@提及的替代功能。此功能用于引起特定用户的注意。例如，产品负责人向团队发送提醒，要求他们更新评论。

Mantis 通常建议使用@提及。但是，这是一个可选功能。

转到“查看问题”并点击问题 ID 以打开“查看”页面。

在问题的顶部，将显示“发送提醒”按钮，如下图所示。

点击“发送提醒”按钮后，将出现一个消息框。左侧是用户列表，右侧可以键入消息。选择用户并编写消息后，点击页面底部的“发送”按钮。

以下屏幕截图显示了如何发送提醒。

在“查看问题”→“活动”部分，可以查看提醒信息，如下图所示。

文本格式化

目前，Mantis 支持以下可用于在描述和备注字段中格式化标签的 HTML 标签：p、li、ul、ol、br、pre、I、b、u、em、strong。但是，Mantis 不鼓励格式化文本。

文本电子邮件将包含原始标签，而不是格式化的文本。Mantis 计划转向使用 Markdown 进行格式化，这将弃用 HTML 标签。

除了 Markdown 支持外，Mantis 还计划支持 HTML 电子邮件。这些功能将共同解决现有解决方案的局限性。但是，目前还没有 Markdown 或 HTML 电子邮件支持的具体时间表。

附加文件

Mantis 支持将多个文件附加到问题。用户可以通过点击“选择文件”按钮在报告问题时附加文件。还可以通过点击“上传文件”按钮从“查看问题”中附加文件。另一种方法是在“编辑问题”模式下附加文件。

以下屏幕截图显示了如何在“查看问题”模块中附加文件。

点击上面标记的按钮并浏览要上传的文件。文件上传成功后，将在按钮下方显示。

然后，点击“添加备注”。文件将添加到“活动”部分，如下图所示。

Mantis - 更改状态

状态是问题的属性，有助于跟踪问题的进度，并提供问题的实际当前状态。

Mantis 支持以下状态：新建、反馈、已确认、已确认、已关闭和已解决。用户可以根据完成的工作更改问题的状态。

更改状态应采取以下步骤。

步骤 1 − 转到“查看问题”部分，并点击要更改状态的问题 ID。

步骤 2 − 点击“更改状态为”旁边的下拉菜单，并选择其中一个状态。

步骤 3 − 选择后，点击“查看问题详细信息”部分中的“更改状态为”按钮，如下图所示。

根据状态选择，“<状态>问题”页面将打开，用户可以在其中添加备注、指派给用户，并在需要时将其设为私有。

步骤 4 − 之后点击“<状态>问题”按钮。例如：对于反馈，“请求问题反馈”页面将打开。

以下屏幕截图显示了“反馈”状态页面。

步骤 5 − 点击“请求反馈”按钮，问题状态将更改为反馈，如下图所示。

Mantis - 问题关系

当两个问题之间存在某种类型的依赖关系时，此功能非常有用，例如它们是重复的或彼此相关的，上游下游依赖关系作为父/子问题。

创建指向另一个问题的链接

问题可以在任何时间点链接在一起，在报告问题时使用“查看问题”或“编辑问题”页面。

步骤 1 − 点击“查看问题”页面。

步骤 2 − 导航到“关系”部分。

步骤 3 − 选择问题与链接问题的关联关系。例如：打开的问题是另一个问题的父级/重复项。

步骤 4 − 现在，键入问题 ID 并点击“添加”按钮，如下图所示。

添加后，您可以在“关系”部分看到链接的问题。它是超链接，因此也可以导航到链接的问题。

您可以使用问题 ID 之间的“|”字符一次添加多个问题的关联关系。

以下屏幕截图显示了链接的问题。

删除链接

步骤 1 − 转到包含指向问题的链接的“查看问题详细信息”页面。

步骤 2 − 向下滚动并转到“关系”部分。

步骤 3 − 点击“删除”图标，如下图所示。

步骤 4 − 将显示一个确认弹出窗口，如下图所示。点击“删除”按钮。

Mantis - 移动问题

Mantis 具有将问题从一个项目移动到另一个项目的功能。

一次一个问题

步骤 1 − 转到需要移动到另一个项目的“查看问题详细信息”页面。

步骤 2 − 点击“移动”，如下图所示。

步骤 3 − 在“移动问题”页面中，选择问题将移动到的新项目，然后点击“移动问题”按钮，如下图所示。

一次多个问题

步骤 1 − 转到“查看问题”页面。

步骤 2 − 设置过滤器并导航到“查看问题”部分，您将在其中找到问题列表。

步骤 3 − 选中需要移动的所有问题的复选框。

步骤 4 − 从屏幕底部的下拉菜单中选择“移动”选项，然后点击“确定”。

以下屏幕截图显示了如何一次移动多个问题。

步骤 5 − 在“移动问题到”页面中，选择问题将要移动到的新项目，然后单击“移动问题”按钮，如下图所示。

Mantis - 问题历史记录

历史记录是所有在问题上执行的活动记录，例如 -

• 创建问题
• 更改问题字段
• 附加文件
• 删除评论/工作日志
• 添加/删除链接

在历史记录中，用户可以查看以下信息 -

• 进行更改的用户姓名
• 更改发生的时间
• 如果更改了问题字段，则显示字段的新旧值

以下步骤用于查看问题历史记录。

步骤 1 − 转到“查看问题”→“查看问题详细信息”（点击任意问题 ID）页面以查看历史记录。

步骤 2 − 向下滚动到“问题历史记录”部分，或者单击“问题历史记录”按钮，如下图所示。

历史记录将显示，如下图所示。

Mantis - 其他功能

在“查看问题”页面中还有其他一些有用的功能，例如监视、删除、关闭或固定问题，我们将在本章中讨论这些功能。

监视

Mantis 具有一个名为“监视”的功能，用于接收通知并观察问题的进展。将问题标记为“监视”的用户将在任何其他用户对问题进行任何更改时收到通知。

以下是监视问题的步骤 -

步骤 1 − 转到“查看问题”→“查看问题详细信息”（点击任意问题 ID）页面以查看详细信息。

步骤 2 − 单击屏幕底部显示的“监视”按钮，如下图所示。

一旦用户开始监视，按钮将更改为“结束监视”。也可以从问题历史记录中确认这一点。

步骤 3 − 在一段时间后，当监视完成时，单击“结束监视”按钮，如上图所示。

按钮将再次更改为“监视”。

固定

Mantis 支持“固定”功能，即问题可以显示为“查看问题”页面→“查看问题”部分中的第一个条目。

步骤 1 − 转到“查看问题”→“查看问题”部分，并选择要显示为该表格中第一个条目的任何问题。在这里，我们选择问题 ID 02，如下图所示。

步骤 2 − 单击“查看问题详细信息”页面底部的“固定”按钮。

按钮名称更改为“取消固定”。

步骤 3 − 返回“查看问题”→“查看问题”部分，并观察问题 ID 在表格中的位置。它将显示为第一个条目，如下图所示。

步骤 4 − 要取消固定，请转到“查看问题详细信息”页面，然后单击“取消固定”按钮，如下图所示。

如果多个问题被标记为“固定”，则遵循 LIFO（后进先出）的概念。最近标记为“固定”的问题将显示为第一个条目，然后是第二最近的，依此类推。

关闭问题

Mantis 支持从问题的任何当前状态关闭问题的功能。

以下是关闭问题的步骤。

步骤 1 − 转到“查看问题”→“查看问题”部分，并选择要关闭的任何问题。在这里，我们选择问题 ID 02，如下图所示。

步骤 2 − 单击“查看问题详细信息”页面上的“关闭”按钮，如下图所示。

步骤 3 − 从下拉列表中选择“解决方案”并添加“备注”。单击“关闭问题”按钮。

问题的状态更改为“重新打开”按钮，而不是此问题的“关闭”，如下图所示。

通过单击“重新打开”按钮，您可以随时重新打开问题。

删除问题

Mantis 支持删除功能，以防用户想要删除任何问题。原因可能是重复、错误输入或不再有用。

以下是删除问题的步骤。

步骤 1 − 转到“查看问题”→“查看问题”部分，并选择要删除的任何问题。

步骤 2 − 单击“查看问题详细信息”页面上的“删除”按钮，如下图所示。

步骤 3 − 将显示一个确认页面，询问是否要对所选问题执行删除操作。如果确定，请单击“删除问题”按钮，如下图所示。

Mantis - 搜索问题

Mantis 支持基本的搜索功能。用户可以使用问题号跨项目搜索问题。除了搜索文本框外，Mantis 还提供了最近访问的问题号链接，以便用户可以直接跳转到特定问题。

搜索

在屏幕的右上角，所有页面上都存在一个搜索文本框，文本为“问题号”。

以下屏幕截图显示了搜索文本框的位置。

输入问题 ID 并按 Enter 键。它使用模糊搜索概念并查找唯一的问题。之后，它会打开“查看问题详细信息”页面，如下图所示。

最近访问

在搜索文本框旁边，有一个“最近访问”字段，其中包含最近访问的问题 ID 列表（以链接形式显示）。

以下屏幕截图显示了“最近访问”字段的位置。

单击任何问题链接以打开“查看问题详细信息”页面。“最近访问”字段在所有页面上都是静态的，可以随时跳转到任何问题。

Mantis - 更改日志

Mantis 将问题与版本关联起来，并且可以在更改日志中看到这种关联。根据问题中的修复版本，更改日志会将问题分开，并提供在哪个版本/版本的特性中包含的功能的详细信息。

更改日志信息用于包含软件版本信息。它帮助用户确定新版本中的规范。它回答了一些常见问题，例如：“有什么新功能？”、“修复了什么问题？”以及“是否存在安全修复？”

每个项目可以有多个版本。用户针对已发布的版本报告问题，开发人员通常会在即将发布的版本中修复问题。

为了使问题记录在更改日志中，必须满足以下条件。问题必须具有 -

• “已解决”或“已关闭”状态。
• “已修复”解决方案。
• 在“修复的版本”字段中指定版本。

以下屏幕截图显示了在详细信息页面中满足上述条件。

以下屏幕截图显示了相同的问题在更改日志部分中的显示方式。在屏幕的右上角，它还显示了版本和项目名称。

单击“查看问题”将显示问题的详细信息。

Mantis - 路线图

路线图页面包含有关即将发布的版本以及目标在这些版本中修复的问题的信息。这是向团队、用户和其他利益相关者提供非常有用的信息。

它还有助于优先安排问题分配。它跟踪问题的进度，例如有多少问题已解决/关闭，有多少问题仍需解决等。

一旦将问题分配到“目标版本”，路线图页面就会自动填充。

以下屏幕截图显示了问题详细信息页面中目标版本字段的位置。

将目标版本添加到问题后，它将显示在路线图页面中。路线图信息显示所有问题的最新进度。

用户可以看到需要解决的问题数量、已解决/关闭的问题数量以及完成的百分比。

以下屏幕截图显示了路线图页面，其中包含完成百分比和问题列表。

如果问题未分配到目标版本，则不会显示在路线图中。

已解决的问题将以删除线显示。

如果设置了“修复的版本”字段，它也将显示在更改日志页面中。

Mantis - 总结

摘要页面是 Mantis 的核心。它以表格形式显示问题的记录。Mantis 支持摘要页面作为表格形式的报表文档。

摘要页面根据以下字段显示表格记录 -

• 按状态
• 按严重性
• 按类别
• 已解决问题的时长统计（天）
• 开发人员状态
• 按解决方案分类的报告人
• 按解决方案分类的开发人员
• 按日期
• 最活跃
• 最长时间打开
• 按解决方案
• 按优先级
• 报告人状态
• 报告人效率

在每个部分中，它都会显示有多少问题处于打开、已解决和已关闭状态。它还会显示在特定类别上报告的总问题数。

以下屏幕截图显示了摘要页面及其不同的类别。

Mantis - 添加自定义字段

添加自定义字段的过程包括首先定义自定义字段，然后将其链接到相应的项目。

步骤 1 − 转到“管理”→“管理自定义字段”部分。

步骤 2 − 在文本框中输入字段名称。

步骤 3 − 单击“新建自定义字段”按钮，如下图所示。

步骤 4 − 单击“新建自定义字段”后，将打开“编辑自定义字段”页面，用户必须在其中定义自定义字段规范。

步骤 5 − 从下拉列表中选择字段的“类型”（日期、字符串、列表等）。

对于自定义字段类型，您可以编写“可能的值”。使用“|”字符分隔不同的值。预期此类列表的自定义字段类型包括：枚举、复选框、列表、多选列表和单选按钮。

“默认值”定义允许自定义字段根据字段类型具有默认值。在大多数情况下，它是一个简单值，例如字符串、数字或可能值列表中的值。但是，对于“日期”类型，可能的值可以包括以下值：{today}、{tomorrow}、{+3 days}、{-7 days}、{next week}、{15 December 2013} 等。

步骤 6 − 选中指定自定义字段应显示在哪些页面上以及是否为必填项的复选框。

定义自定义字段后，应将其链接到相应的项目。

步骤 7 − 滚动到“编辑自定义字段”页面底部的“将自定义字段链接到项目”部分。从显示的列表中选择项目，然后单击“链接自定义字段”，如下图所示。

序列号用于确定自定义字段彼此之间的相对顺序。较小的序列号会首先显示。