Zoho BugTracker 用户使用手册 2013-08 产品经理 : 李航
目录 一 Bug Tracker 简介... 3 1 什么是 Bug Tracker... 3 2 Bug 追踪软件的优点... 3 二 Bug 视图和 Bug 集成... 3 1 提交问题... 3 2 查看问题... 6 3 Zoho Support 集成 ( 遇到 ZSC key 问题, 未完成 )... 10 4 Github 集成... 16 三 Bugs 的自动化操作... 23 1 状态和工作流... 23 2 模块... 28 3 业务规则... 31 4 Web 提交 Bug 表单... 37 四 分类 过滤器和导入 Bugs... 40 1 通知... 40 2 严重性等级分类... 42 3 过滤器... 44 4 导入问题... 48 五 价格和版本比较... 52
一 Bug Tracker 简介 1 什么是 Bug Tracker Bug Tracker 是与 Zoho Projects 集成的一款强大的 Bug 追踪工具, 您可以通过它来 定义一个结构, 以管理并组织 Bug 的处理过程 通过定义不同阶段的形式来清晰地分 析 Bug 的生命周期, 以激发项目团队成员积极解决 Bug 和问题 2 Bug 追踪软件的优点 通过严重等级 分类等过滤的视图, 可视化地查看未解决问题 通过基于阶段定义的 Bug 生命周期可以结构化地说明 Bug 处理的流程, 也可以自定义此过程 通过访问每个问题的解决方案 历史 评论, 激发团队成员解决问题 通过设置通知来自动化提醒和通知负责解决问题的成员 通过精确了解什么 Bug 在什么级别可重现, 提高生产率 二 Bug 视图和 Bug 集成 Bugs 视图提供了一个报告给您或分配给您的 Bug 的统一视图 通过此视图, 您可以 了解到需要解决的 Bug 有哪些, 而不用费力去记忆所有的 Bug 1 提交问题 您可以通过提交 Bug 选项来添加 Bug 到您的项目中 BugTracker 插件只在 Projects
的付费版本中可用 通过表单提交 Bug 1. 点击提交一个 Bug 按钮, 将打开提交 Bug 的表单窗口 ; 2. 输入问题的标题 ; 3. 在文本框中输入问题描述 ; 4. 指定问题的详细信息 : 模块 问题所涉及的项目模块 严重性等级 问题的严重程度 问题对您的项目所造成的影响, 以及其他相关信息 ; 5. 添加任何需要的附件或截图等, 点击添加 Bug 图标, 这样就可以创建问题记录了 在表单的下面还有其他信息部分, 在这里可以选择模块 优先级 严重性等级等 :
通过 Web 表单提交 Bug 1. 打开 Bug 设置, 点击 Web 提交 Bug 表单 ; 2. 点击这里创建 Web Bug 表单 ; 3. 输入表单名称名称 返回 URL 域名等必填信息; 4. 点击 生成 iframe 代码 按钮 ; 5. 复制并粘贴生成的 iframe 代码到您的网站或博客中 ; 6. 通过嵌入的表单提交 Bug 下面是创建 Web 提交 Bug 表单的界面 :
2 查看问题 在问题追踪页面, 将显示系统中提交的问题列表 首先是标题 评论以及添加的附件, 还有报告者 时间等信息 点击问题标题打开之后, 将在右侧面板中显示 Bug 的详细属性信息, 如状态 严重性等级 里程碑 模块等 您可以修改这些属性信息, 或者可以通过 Bug 描述下面的编辑链接来修改一个 Bug 的描述信息
查看解决方案 1. 点击问题标题, 将打开问题的详细信息页面 ; 2. 在解决方案部分将会列出针对此问题提出的所有解决方案, 或者可以点击新建解决方案来添加一个新的解决方案 : 查看评论 1. 在 Bug 的详细信息视图中, 在评论部分的输入框中可以输入评论内容 ; 2. 选择要通知的用户并点击 添加评论 按钮 这样就为此 Bug 添加了一条评论 ;
3. 可以通过评论后面的删除链接删除评论 查看附件 1. 在 Bug 的详细信息视图中, 转到附件部分 ; 2. 您可以拖放文件到此部分, 或点击添加附件链接, 选择要添加的附件 您可以添加任意个数的附件到一个 Bug 中 添加任务时间
1. 在 Bug 详细信息页面中, 打开登记小时数部分 ; 2. 点击其中的 添加任务时间 链接将打开一个弹出窗口 ; 3. 输入工作小时数 ; 4. 指定支付状态, 点击 添加日志时间 按钮 ; 您在这里添加的任务时间将会更新到时间表中 最新的活动 1. 在 Bug 详细信息页面, 转到页面底部 ; 2. 在这里您可以看到针对此 Bug 所作操作的最新活动流
3 Zoho Support 集成 ( 遇到 ZSC key 问题, 未完成 ) Zoho BugTracker 与 Zoho Support 的集成允许您在 Zoho Support 内部提交问题 如果您同时使用 Zoho Support 和 Zoho BugTracker 处理您的业务, 您就可以快速添加 Bug 或问题并追踪他们的状态直到关闭 备注 : 订购 Zoho BugTracker 的企业版 订购 Zoho Support 的企业版 在 Zoho Support 的设置页面激活 Zoho BugTracker 插件 只有门户所有者可以激活 Zoho Support 的 BugTracker 集成在 Zoho Support 中激活 BugTracker 要执行此设置操作, 您需要获取到 Zoho Projects 的管理员邮件地址和相关的 ZSC key ZSC key 用于 Zoho Support 与 Zoho Projects 之间的交互 您可以通过下面的步骤来执行同样的操作 以管理员身份登录到您的 Zoho Projects http://www.zoho.com/projects/ 帐号 打开设置 开发者空间, 您将在此页面中看到 Zoho Service Communication (ZSC) Key 和邮件地址,
复制邮件地址及其相关的 ZSC key, 在 Zoho Support 集成 BugTracker 时提供 备注 : 您还可以点击重新生成 Key 来获取一个新的 ZSC key, 从而在集成到 Zoho Support 时提供 从 Zoho Projects 中获取 ZSC Key 之后, 您需要在 Zoho Support 的设置页面中提供此信息 要配置 BugTracker 集成, 请执行下面的操作 : 以管理员身份登录到 Zoho Support http://www.zoho.com/support/, 从右上角菜单面板中点击设置 将打开设置页面 在这里点击集成 & 插件 Zoho 插件,
选择 Zoho BugTracker 插件后将打开激活向导 点击 Activate BugTracker Integration 按钮将打开 Bugtracker 的激活表单, 提供 BugTracker 管理员的邮件地址及其相关的 ZSC key 并点击 Next 按钮, 在 BugTracker 与 Zoho Support 的映射页面, 从下拉列表中选择一个 BugTracker 门户 已选门户下的所有项目都将在 Zoho Support 中列出在您的部门旁边
您可以将 Zoho Support 中的部门映射到 Zoho BugTracker 的相关项目以追踪和管 理 Bugs 您不能将一个部门关联到多个项目 点击保存以完成映射 在 Zoho Support 中提交问题到 BugTracker 要为请求提交一个 Bug, 请执行下面的操作 : 1. 点击请求以打开详细信息页面 ;
2. 点击显示在右边的提交一个 Bug 选项 在提交 Bug 页面中, 您可以看到之前选择的要将 Bug 提交到的 BugTracker 项目 您 可以通过从下拉列表中选择来更改 BugTracker 项目 请求的标题和内容会自动填充 为 Bug 标题和描述 点击保存 Support 中的请求就将作为 Bug 提交到 Zoho BugTracker 的项目中
要了解关于 Bug 的更多信息, 您可以点击 Zoho Support 中的 Bug 详细信息部分 另外, 您可以使用 BugTracker 中相应业务规则的更新 Support 选项来为提交的 Bug 设置自己的业务规则 例如 : 如果当 BugTracker 中的 Bug 关闭时, 您想添加一个评论, 您可以使用更新 Support 选项设置一个业务规则来实现此功能
当您在 BugTracker 中关闭 Bug 时会触发此业务规则, 并且将自动更新一个评论到 Zoho Support 的相应请求上 4 Github 集成 Github ( 在线版本控制系统 ) Git 对于协作开发软件来说是一个非常快速 高效的分布式版本控制系统 现在您可以在 Zoho Projects 中查看在您的 GitHub 资源库中所做的所有更改 1. 为 Zoho Projects 创建 Github 资源库登录到 GitHub, 点击 New Repository 链接
将打开新建资源库的表单页面 在这里输入您的项目名称 描述和主页 URL( 如果有 的话 ) 点击 Create Repository 链接以在 GitHub 中创建一个新的资源库 2. 在 Zoho Projects 中为项目设置服务 hooks 要在 Zoho Projects 中访问 GitHub 资源库中的变更集, 您需要更新服务 HOOK 要 执行此操作, 点击设置 服务 HOOK 选项,
将打开设置服务 HOOK 的页面, 在这里复制配置 Zoho Projects 所需要的项目编号和 已占用 Value 登录到 GitHub, 点击 Admin 链接 将打开管理员面板, 复制并粘贴 Zoho Projects 中的项目编号和已占用 Value, 点击服务 HOOK 链接, 在这里将显示使用 GitHub 资源库的所有服务 在这里点击 Zoho Projects, 将打开 Zoho Projects 的服务 HOOK 页面,
粘贴从 Zoho Projects 获取的项目编号和已占用 Value 粘贴之前请确保选中 Active 复选框, 这样就可以允许更改内容自动更新, 点击 Update Settings 以保存更改 3. 在 Zoho Projects 中查看资源库的变更内容
打开 Bugs 页签, 点击变更链接, 将打开变更集页面, 这里显示了在资源库中所做的 变更内容 在这里按照日期排序, 列出了对于选中项目文件所执行的源文件变更 点击某个特定的日志消息, 将显示消息的详细信息页面, 包括作者 日期 分支 主 页 URL 日志消息和文件更改路径等
另外, 如果当您在 GitHub 中提交变更时指定了 Bug ID, 则此提交的消息将自动链接到 BugTracker 中特定的 Bug 要关联变更到 Zoho BugTracker 中的特定 Bug, 您需要在提交的消息中提供 Bug ID 语法 :OPEN SQUARE BRACKET #BUGID CLOSE SQUARE BRACKET, 随后再加上要提交的消息内容例如 :[#EPI19] 解决了内存泄露问题 此操作将变更关联到 ID 为 EPI19 的 Bug 对于多个 Bug, 需要使用英文逗号分隔多个 Bug IDs 例如 :[#EPI19,#EPI20] 更改了数据库名称
4. 在 GitHub 资源库中提交的源代码 打开 Bugs 页签 变更 将列出项目中所有的变更集, 其中有到 GitHub 的链接 点击 commit 链接, 将打开 GitHub 资源库, 您将在这里看到与之前版本相比而实际 完成的修改内容 点击 Source 链接, 将看到签入到此资源库中的文件列表
点击 Commit 链接, 您可以看到项目资源库的提交历史 三 Bugs 的自动化操作 问题追踪器的复杂工作流模式可以让您未不同的项目定义个性化的工作流 在 Zoho Projects 中配置工作流以满足您公司的独特需求 1 状态和工作流 配置状态设置, 如打开 已关闭 已分配 已解决 已验证 重新打开和处理中 另外, 您可以添加自定义的状态, 因此您可以自定义 添加 编辑和删除您的状态 问题状态每个问题都有一个状态字段, 代表问题处理的阶段 下面列出了默认的状态 : 1. 打开 - 所有新提交的问题默认情况下都会分配一个打开状态 2. 已分析 - 已经分析了此问题 3. 已关闭 解决并测试过的问题, 已进入运行时修复 4. 已分配 问题已分配给用户 5. 已解决 - 问题已解决 测试完成之后就可以移动到已关闭或重新打开状态
6. 已验证 问题已经通过测试人员的验证, 可以关闭了 7. 重新打开 已关闭的 / 测试失败的问题重新打开 问题可以从重新打开状态移动到处理中或已解决或已关闭 8. 处理中 - 问题责任人正在解决问题您可以根据自己的需求来修改状态 如果您想更改默认状态, 点击您想要设置为默认状态的相应编辑链接 您还可以通过显示在底部的 添加状态 链接来添加您自己的状态 另外, 您可以通过拖拽选项来根据自己的需要排序状态 您还可以删除已有的状态 ( 默认状态不能被删除 )
添加问题状态 1. 以管理员身份登录到项目门户 ; 2. 选择 Bug 设置页签 ; 3. 点击状态 & 工作流链接 ; 4. 点击显示在底部的添加状态链接, 将打开一个添加弹出窗口 ; 5. 输入您的状态名称并点击添加按钮 ; 编辑 / 删除问题状态您不能编辑默认状态, 可以编辑由您自己添加的问题状态 1. 点击想要修改状态信息的相应编辑链接, 将弹出如下所示的界面 ; 2. 修改状态名称并点击更新 ; 3. 状态信息将被更新 ;
您可以通过点击显示在状态下面的删除链接来删除您不需要的状态 另外, 您可以使用拖拽选项并基于项目工作流来重新排序状态
自定义视图为您的 Bug 创建自定义视图 下面是需要执行的步骤 : 1. 打开 Bugs 页签, 点击视图链接, 将打开自定义视图的表单 ; 2. 指定 Bug 条件 ;
通过更多条件选项为您的 Bug 添加更多过滤条件 在保存视图之前, 您可以基于选定的条件预览 Bug 点击保存以保存自定义视图 打开 Bug 视图, 在自定义视图菜单下您将看到自定义的视图列表 选择您想要查看的 视图并访问 2 模块 您可以将项目分成不同的模块 默认情况下, 一个项目将创建一个模块 您可以添加 /
更新模块 添加模块 1. 以管理员身份登录到项目门户 ; 2. 选择 Bug 设置页签 ; 3. 点击字段 编辑数据值链接; 4. 点击显示在底部的添加数据值链接 将打开如下所示的窗口 : 编辑模块 1. 点击模块数据值旁边的 " 编辑 " 链 2. 修改模块名称并单击保存图标 ; 3. 新的模块名称将更新到系统中
删除模块 您可以通过点击模块数据值后面的删除图标来删除不需要的模块 在删除模块之前, 您需要将其中的 Bug 移动 / 更新到其他模块中, 然后才能删除此模块
3 业务规则 业务规则是一种可以应用到所有 Bugs 的过滤器 您可以定义业务规则, 以组织并管理您的 Bugs, 执行操作如更改严重性等级 更改状态 分类以及分配 Bug 给用户 业务规则在 Bug 创建或 Bug 更新时被触发 设置新的业务规则 1. 以门户管理员 / 联合管理员的身份登录到 Zoho Projects 门户中 打开 Bugs 页签, 点击 Bug 设置链接 ; 2. 在这里您可以看到业务规则选项 点击此链接, 打开业务规则表单 ; 3. 您还可以看到关于业务规则的帮助描述, 以帮助您快速理解并为您的项目创建业务 规则 ; 4. 点击右上角的添加规则按钮将打开添加规则的表单页面 提供基本信息如规则名和 描述, 点击下一步按钮 ;
5. 将转到执行时间页面 您需要选择一个执行业务规则所基于的操作 下面是提供的一些操作选项 : 1. 创建 在创建记录时执行业务规则 2. 编辑 在编辑已有记录时执行业务规则 3. 创建或编辑 创建新记录或编辑已有记录时执行业务规则 4. 字段更新 更新指定字段数据时执行工作流规则在选择合适的选项之后点击下一步, 将打开指定条件的页面
6. 在这里为上述的业务规则指定需要的条件, 使用更多标准选项, 为您的业务规则提 供更多的条件和标准, 点击下一步按钮 7. 打开操作页面 对于每个业务规则的每个操作, 您可以最多指定 7 个字段更新 当 触发业务规则时, 将基于为相应字段指定的值自动更新 Bug 字段
例如 : 如果您在操作页面设置严重性等级为严重, 那么无论何时执行业务规则时, 都 会将 Bug 的严重性等级字段设置为严重 8. 如果您使用的是企业版并启用了 Support 与 BugTracker 的集成 您可以使用 BugTracker 中的业务规则更新 Support 选项, 为那些从 Zoho Support 中提交的 Bugs 设置您自己的业务规则 例如 : 如果您想在 BugTracker 关闭 Bug 时添加一条评论, 您可以通过 BugTracker 中的更新 Support 选项实现此操作 当您在 BugTracker 中关闭 Bug 时将触发此操作, 一条评论信息将自动更新到 Zoho Support 中的相关记录上
编辑 删除和重新排序业务规则编辑已有业务规则您可以在 BugTracker 中使用编辑和删除链接来随时编辑或删除业务规则 点击业务规则旁边的编辑链接, 将弹出编辑对话框 : 对业务规则做一些修改, 如更改条件 描述 添加更多操作等, 点击保存规则按钮以 更新您的业务规则
删除业务规则 您可以通过显示在业务规则旁边的删除链接来删除那些不需要的规则 另外, 在删除 之前, 您需要将其中的 Bugs 移动或更新到其它规则中, 然后才能删除 您还可以根据自己的需求来重新排序业务规则 要执行此操作, 可以点击显示在业务 规则标题旁边的上下双箭头 接下来将重定向到重新排序视图
在重新排序视图中, 您可以通过简单的拖拽来排序您的业务规则 点击保存规则顺序 按钮来保存最新的顺序 4 Web 提交 Bug 表单 如何设置并使用 web 提交 Bug 的表单来提交问题? 打开 Bugs 页签 点击 Bug 设置链接, 将打开设置面板 在这里点击 Web 提交 Bug 表单选项, 将打开 Web 提交 Bug 表单 在这个表单中, 输入表单名 返回 URL 域名, 并选择 / 取消选择默认字段, 点击生成 iframe 代码按钮 您可以在域名字段中输入 * 号, 从其它 / 多个域名中获取详细信息
在接下来的页面中将显示生成的 iframe 代码, 复制并粘贴此代码到您的网 站或博客中
将在您的网站或博客中创建一个提交 Bug 表单, 您就可以在不登陆 Zoho Projects 的情况下, 在从外部站点提交 Bug 了
登录到您的 Zoho Projects 帐号 打开 Bug 页签, 从操作菜单中点击 Bugs 视图, 列出截止目前提交的所有 Bugs 在这里就可以看到从外部站点中通过 web 表单提交的 Bug 您可以在需要的时候通过编辑和删除表单选项来编辑和删除表单的详细信息 另外, 可以使用休眠的表单选项随时禁用嵌入到外部站点的表单 四 分类 过滤器和导入 Bugs 严重性等级是衡量问题严重程度的标尺 您可以将 Bugs 按照不同的分类来组织, 也 可以导入外部的 Bugs 到 Zoho BugTracker 系统中 1 通知 项目中的通知模式就是一个配置列表, 用来配置当 Bug 创建 更新或关闭时, 应该发送通知给谁 您可以基于通知规则将通知发送给请求者 开发人员和客户 通知模式就是指定当 Bug 创建 更新或删除时要通知给谁 通过通知规则, 您可以将通知发送给报告者 所有者 项目用户和客户 要启用通知模式, 请执行下列操作 :
打开 Bugs 设置页签 ; 点击通知模式连接 ; 在打开的通知模式页面中, 选择您想要启用的通知选项 ; 页面的第三部分列出了, 当哪些成员有什么操作时可以通知我 可以在弹出的成员列表 中选择成员 :
2 严重性等级分类 严重性等级用来区分问题的严重程度, 即问题对整个项目造成了什么程度的影响 可以自定义严重性等级, 添加 编辑 删除严重性等级 添加严重性等级 1. 以管理员身份登录到项目门户 ; 2. 选择 Bug 设置 字段页签; 3. 点击严重性等级下面的编辑数据值链接 ; 4. 在这个界面中点击显示在底部的添加数据值链接 如下图所示 :
编辑严重性等级 1. 点击严重性等级后面的 " 编辑 " 链接 ; 2. 修改严重性等级名称并点击更新 ; 3. 严重性等级的值将被更新 ; 您可以使用显示在严重性等级后面的删除图标来删除那些不需要的严重性等级 另外, 在删除之前, 您需要将其中的 Bugs 移动 / 更新到新的严重性等级中, 然后才能删除它
3 过滤器 过滤器选项可以帮助您基于状态 严重性等级 里程碑 时间周期 模块和受托人来过滤并浏览您的 Bug 基于状态过滤 打开 Bugs 页签 在顶部的过滤器菜单头中, 您可以看到一系列的选项 在这里点击状态链接将显示 Bug 所有可用的状态 选择一个或多个状态选项并点击查找按钮, 将基于选择的状态来查找并显示 Bugs
基于受托人过滤 打开 Bugs 页签 在顶部的过滤器菜单头部您将看到一系列选项 在这里点击受托人链接将显示 Bug 所有可用的受托人 选择一个或多个受托人并点击查找按钮, 将基于选择的受托人查找并显示 Bugs 基于严重性等级过滤
打开 Bugs 页签 在顶部的过滤器菜单头部, 您将看到一系列选项 在这里点击严重性等级链接将显示 Bug 的所有严重性等级 选择一种或多种严重性等级类型并点击查找按钮, 将基于选择的严重性等级类型查找并显示 Bugs 基于时间过滤 打开 Bugs 页签 在顶部的过滤器菜单头部, 您将看到一系列选项 在这里点击时间链接将显示 Bugs 的所有可用的时间周期选项 选择时间周期如过期 今天过期等并点击查找按钮, 将基于选择的时间周期查找并显示 Bugs
基于模块过滤 打开 Bugs 页签 在过滤器顶部菜单中您将看到一系列选项 在这里点击模块链接将显示 Bug 的所有可用模块 选择一个或多个模块并点击查找按钮, 将基于每个选择的模块查找并显示 Bugs 基于里程碑过滤
打开 Bugs 页签 在顶部的过滤器菜单您将看到一系列选项 在这里点击里程碑链接将显示 Bug 的所有可用模块 选择一个或多个里程碑并点击查找按钮, 将基于选择的里程碑查找并显示 Bugs 4 导入问题 从其它 Bug 追踪系统中导入问题如果您正在使用其它的 Bug 追踪系统并且希望迁移到 Zoho BugTracker, 您可以通过简单的导入 Bugs 操作来实现此功能 从其它 Bug 追踪系统中获取的 Bug 生成一个 CSV 格式的文件, 可以轻松导入到 Zoho BugTracker 中 下面是需要执行的一些操作 : 1. 打开 Bugs 页签, 点击 Bug 设置链接, 将打开设置面板并选择导入 Bug 选项 接下来打开导入 Bug 的表单, 浏览并选择要导入的 CSV 文件后点击继续按钮
2. 为了快速无误地导入, 我们建议您根据帮助摘要部分的说明来创建并导入 CSV 文 件到 Zoho Projects 中
3. 接下来将打开导入 Bugs 向导, 在这里映射 CSV 文件与 Zoho BugTracker 中的每 个字段 映射之后, 通过选择日期格式选项选择合适的日期格式并点击继续
4. 映射字段之后会出现告警信息为 告警 : 一旦导入完成, 操作将不可逆 5. 您的操作已安排, 可能需要花费几分钟的时间才能完成 一条告警信息为 : Yo 您 的文件导入已安排 Bugs 导入完成之后将发送通知邮件给您 安排的导入会显示在 Bug 的设置视图中 : 导入完成之后, 将有一封通知邮件发送到您的邮件地址中 打开 Bugs 视图, 您可在 这里看到导入的 Bugs 并开始使用 Zoho BugTracker 来处理它们
五 价格和版本比较 Zoho BugTracker 是作为 Zoho Projects 的一个插件提供的, 它的价格与 Zoho projects 是相互独立的 请查看下面的 BugTracker 的不同版本和价格信息 : 企业版 专业版 快捷版 价格 $599/ 年 $299/ 年 $199/ 年 通过邮件提交 Bug 自定义视图 通知 导入 Bugs( 只允许 CSV 文件 ) 业务规则 - GitHub 集成 - 自定义字段 - - Web 提交 Bug 表单 - - 邮件设置 - - Zoho Support 集成 - - 备注 : 要使用 Zoho Support 集成, 需要同时购买 Zoho BugTracker 和 Zoho Support 的企业版