跳转到主要内容

错误报告附件

在提交缺陷报告时需要附加什么?

Nikola Jonic avatar
作者:Nikola Jonic
更新于今天

每个缺陷都必须至少附加一个附件。通过您的附件,您提供了缺陷发生在您的设备、操作系统和/或浏览器上的证据。

注意:附件不能替代报告中的书面信息。附件仅用于直观展示问题并作为证明。

截图还是录屏?

通常,功能性错误需要通过录屏来进行正确且有效的展示。除非指引或团队领导要求特定附件,否则可遵循以下经验法则来判断您的错误需要截图还是录屏:

  • 触发错误需要操作或流程需要展示时,请上传录屏。静态截图只是快照,无法展示根本原因。功能性错误总是需要录屏。

  • 错误性质为静态时(例如静态界面问题),截图即可,并且比视频更直观。内容或视觉问题通常截图就够。

附件的一般要求

  • 每个错误报告或复现都必须创建新的附件。

  • 禁止复制其他错误报告或复现中的附件。

  • 附件必须展示所有相关的错误信息,作为证明。

  • 所有相关信息必须以英文显示(若错误报告语言为德语,可选德语),例如日期、时间、系统信息和错误信息。

  • 报告错误时应只选择一个设备或浏览器,并上传该设备或浏览器的附件。如能在其他设备或浏览器复现,请在“实际结果”中说明。

  • 不得展示任何可能关联到其他 Test IO 客户的信息(如邀请邮件或浏览器标签名)。允许展示其他客户安装的应用。

  • 不得显示个人信息或不专业的数据,例如图片、视频或自动更正的脏词建议。请记住,您的附件将对其他测试者、Test IO 员工及客户可见,因此请谨慎显示内容。

  • 网站测试中,附件中必须显示 URL 字段。

  • 分辨率必须足够高,以便文本和元素清晰可辨。

  • 请务必录制整个屏幕。

  • 应用程序崩溃的错误报告和有效复现必须附带崩溃日志。记录崩溃的视频必须与附件的崩溃日志对应,即时间一致。

日期和时间相关规则

  • 附件中必须显示当前日期和时间。

  • 在移动设备截图证明错误时,需上传第二张截图显示日期和时间(电量和时间需与第一张截图一致)。

  • 日期格式可为常见格式,如 DD/MM 或 MM/DD,使用英文(若报告语言为德语,可选德语)。

  • 时间应为24小时制,若使用12小时制,请使用 AM/PM 格式。

  • 显示当前日期即证明您在该日期记录了附件。常用方法包括:

    • **Windows:**显示任务栏或日历

    • **Mac:**显示 Dock 或菜单栏的日历图标

    • **iOS & Android:**在录屏开始时下拉通知中心

  • 更多信息请参考:How-to-Geek

截图应包含哪些内容?

截图特定规则:

  • 截图必须以JPG或PNG文件格式保存。

  • 在您的截图上突出显示缺陷。

我们建议查看以下文章以了解录制工具和最佳实践:截图

截图需要包含的内容

截图规则:

录屏需要包含的内容

录屏应尽量简短,但必须完整,即省略不会触发错误的步骤。例如,当电商网站产品详情页的“加入购物车”按钮有问题时,如何浏览网站到达该页面通常不相关。最后一步导航、触发错误的步骤及错误本身才是关键。

示例 1:网站错误,桌面设备测试
录屏步骤:

  1. 访问出现错误的页面

  2. 开始录制

  3. 刷新页面

  4. 执行触发错误的操作

  5. 等待错误发生

  6. 停止录制

示例 2:应用错误,移动设备测试
录屏步骤:

  1. 打开应用并进入只需一步操作即可到达错误页面

  2. 开始录制

  3. 下拉通知中心显示当前日期几秒

  4. 执行最后一步导航到目标页面

  5. 执行触发错误的操作

  6. 等待错误发生

  7. 停止录制

团队领导可能会要求您提供额外录制,以便更好地理解错误或在错误无法复现时获取更多信息。

录屏规则

  • 录屏必须为 MP4 格式

  • 附件最大为 25 MB

  • 错误报告录屏最长 60 秒(如需展示加载过程或手动操作,可适当延长)

  • 复现和用户故事附件最长 15 秒,仅展示触发错误的最后操作

  • 点击/触摸动作及鼠标图标必须可见(仅 Android 和桌面录屏要求)

  • 录制应一次完成,不可中途暂停或剪辑;如需剪辑,仅可裁掉开头或结尾

  • 不允许加速录屏

  • 不录制噪音(婴儿哭声、谈话、电视、音乐、宠物等)

  • 推荐使用以下文章中的录制工具和最佳实践:Screencasts

  • 常见错误示例请参考:Common mistakes in the Attachments

流媒体设备录屏规则

  • 始终录制整个电视屏幕

  • 录屏需高分辨率且清晰

  • 环境光线不能太暗

  • 电视遥控器必须清晰可见

  • 当前日期和时间必须显示,可在电视或外部设备(PC、手机、平板)上显示

  • 错误报告录屏最长 60 秒;复现和用户故事附件最长 15 秒

  • 不录制噪音

  • 录屏应保持专业,不拍摄腿、凌乱的电视柜或类似物品

键盘操作错误录屏

当使用计算机键盘与网站交互产生错误时:

示例:创建展示键盘输入的录屏方法(文章原示例可参考原文)

所有设备的录屏附件规范

在附件中模糊私人信息

为了保护您的私人信息(例如书签、账户名或存储的电子邮件)不在浏览器标签中被看到,您可以使用简单的模糊处理方法来遮挡这些信息。不过,为了提高错误报告的效率,建议使用专用浏览器窗口进行测试,如下示例所示,确保没有打开不必要的浏览器标签或可见书签。

如果您需要在附件中包含私人信息,但又不希望其被看到,可以参考此示例进行专业遮挡;请注意,可能显示电子邮件地址、用户名或书签的浏览器标签名称已被隐藏。

需要注意的是,URL 必须保持可见,网站元素不得被遮挡。

出于专业考虑,在附件上遮挡信息时,务必避免使用手绘或粗糙的方法,如下例所示:

这是否解答了您的问题?