在「JIRA 問題報告追蹤系統」建立問題作為問題報告

選取問題，並將問題提交給 Atlassian Pty Limited JIRA 作為問題報告以進一步追蹤。

開始之前

  1. 這個作業會使用 REST API 呼叫 (GET /issues/details_v2) 以建置附件的內容。
  2. 請確定已設定 JIRA 接受附件。
    1. 在 JIRA 中，移至設定 > 系統頁面。
      註： 您必須具有管理者專用權才能完成這個步驟。
    2. 從功能表中，選取進階 > 附件。
    3. 編輯設定，使得Allow Attachments設定為「ON」。
  3. 當您提交問題報告給 JIRA 時會建立「外部 ID」。「外部 ID」直欄會指出已提交問題的專案區域，以便您判斷它們是否需要提交到其他專案區域。移至清單功能表 > 選擇直欄 > 外部 ID。移動網格中「問題」或「狀態」直欄旁邊的直欄，讓您可以快速查看哪些問題已經提交。按一下直欄標頭，然後使用鍵盤的 Ctrl+（左或右箭頭），將直欄移至新的目的地。
  4. AppScan® Enterprise 不支援「必要工作」欄位。
  5. 除了在問題報告提交程序期間所自動新增的鏈結和附件之外，可以自訂標準的 JIRA 欄位。
  6. 當您提交多個問題報告給 JIRA 時，無法變更說明和摘要欄位。
    註： 「說明」會列出具有值的所有問題屬性，包括從 XML 匯入問題時所建立的 IssueXML 問題屬性。

執行這項作業的原因和時機

以下是說明基本工作流程的 Java™ Script 範例：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 中，移至清單功能表 > 重新整理，或按一下資訊看板中的重新整理圖示來更新問題清單以顯示「外部 ID」。

結果

  1. 如果在 JIRA 中順利建立單一問題報告，您會在「監視」視圖的上方看到訊息（否則，建立成功和失敗會顯示在「建立問題報告」對話框中）。按一下問題報告鏈結可移至 JIRA 以取得其他詳細資料。這個程序會將 .zip 檔附加到包含問題相關資訊的 JIRA 中的問題報告記錄。
    • <issue_number>.htm （問題概觀）
    • <issue_number>_details.htm （無法使用於第三方匯入問題）。此檔案可包括諮詢與修正建議，並只顯示第一個變式。
    從 JIRA 記錄中，也可以鏈結回到 AppScan Enterprise 中的問題 ID。
  2. 您也可以在「關於此問題」對話框中看到特定問題的External ID 屬性。
  3. 如果已在「管理」視圖中啟用記載，可以在 <install-dir>\Liberty\usr\servers\ase\logs\console.log 中找到 JIRA 問題報告建立和錯誤訊息。