在 JIRA 缺陷跟踪系统中创建问题作为缺陷

选择问题并将其作为缺陷提交到 Atlassian Pty Limited JIRA 以进行进一步跟踪。

开始之前

  1. 此任务使用 REST API 调用 (GET /issues/details_v2) 来生成附件的内容。
  2. 请确保 JIRA 设置为接受附件。
    1. 在 JIRA 中,转至设置 > 系统页面。
      注: 您必须具有管理员特权才能完成此步骤。
    2. 从菜单中,选择高级 > 附件
    3. 编辑设置,以便 Allow Attachments 设置为“开启”。
  3. 将缺陷提交到 JIRA 时将创建外部标识。“外部标识”指示已提交问题的项目区域,因此您可以确定是否需要将这些问题提交到其他项目区域。转至列表菜单 > 列选择 > 外部 ID。将该列移至网格中的“问题”或“状态”列旁边,以便您能够快速地查看已提交哪些问题。单击列表标题然后使用键盘的 Ctrl+(向左或向右箭头)以将列移至其新目标位置。
  4. Perforce 作业字段不受 AppScan® Enterprise 支持。
  5. 标准 JIRA 字段可定制,但缺陷提交过程中自动添加的链接和附件除外。
  6. 将多个缺陷提交到 JIRA 时,无法更改描述摘要字段。
    注: “描述”列出具有值的所有问题属性,包括从 XML 导入问题时创建的 IssueXML 问题属性。

关于此任务

以下是说明了基本工作流程的样本 Java 脚本:SampleJava.zip。此样本中存在一些可能需要您更新的行:
  • private static String ASE_SCHEME = "https";
  • private static String ASE_HOST = "localhost";
  • private static int ASE_PORT = 9443;
  • private static String ASE_CONTEXT_ROOT = "/ase";
  • private static String ASE_USER = "username";
  • private static String ASE_PASS = "password";
  • private static String ASE_FEATURE_KEY = "AppScanEnterpriseUser";
  • private static String DTSWEB_CONTEXT_ROOT = "/dtsweb";
  • private static String JIRA_URL = "http://localhost:8080/";
  • private static String JIRA_PROJECT_ID = "DEMO";
  • private static String JIRA_USERNAME = "username";
  • private static String JIRA_PASSWORD = "password";
  • private static String JIRA_DEFECT_TYPE = "3";
  • private static int MAX_NUMBER_OF_APPLICATIONS_OR_ISSUES = 10000;
注: 要禁用证书验证,请从以下行中移除注释:disableCertificateValidation();

过程

  1. 在“监视器”视图的应用程序中,选择要提交为缺陷的问题。
  2. 单击列表菜单 > 创建缺陷
  3. 创建缺陷页面上,选择 JIRA,填写 URL用户名密码字段,并单击连接以测试与 JIRA 的连接。
    注:
    • 您可以启用忽略 SSL 证书/主机名验证复选框;但是,不建议您这么做。
    • 成功连接后,缺陷跟踪系统 URL、用户名和 SSL 复选框选中将存储为您的用户首选项,并将记住上一个选定缺陷跟踪系统以用于下一个会话。
  4. 创建缺陷页面上显示的字段反映 JIRA 期望从 AppScan® Enterprise 接收的内容。启用显示可选字段复选框以编辑其他字段。
  5. 选择项目区域类型,并单击创建。已成功创建的缺陷将在该页面上列出,并包含指向 JIRA 中缺陷记录的链接。单击关闭
  6. AppScan® Enterprise 中,转至列表菜单 > 刷新或单击侧边栏中的刷新图标来更新问题列表,从而显示外部标识。

结果

  1. 如果在 JIRA 中成功创建了单个缺陷,那么将在“监视器”视图的顶部看到一条消息(否则,将在“创建缺陷”对话框中显示创建成功和失败)。单击缺陷链接可转至 JIRA 以了解更多详细信息。此过程会将 .zip 文件附加到 JIRA 中的包含了问题相关信息的缺陷记录。
    • <issue_number>.htm (问题概述)
    • <issue_number>_details.htm (对于第三方导入问题不可用)。该文件可包含附录和修订建议,并仅显示第一个变体。
    您还可以从 JIRA 记录中链接回 AppScan Enterprise 中的问题标识。
  2. 您还将在特定问题的“关于此问题”对话框中看到 External ID 属性。
  3. 如果在“管理”视图中启用了日志记录,那么可在 <install-dir>\Liberty\usr\servers\ase\logs\console.log 中找到 JIRA 缺陷创建和错误消息。