Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Prior to Before reporting a Support Bugticket in Jira 

  1. Confirm that the Bug affects an App in ProductionVerify that the issue is a FOLIO software issue.Refer to Bug Reporting Flow Chart for triageIt may be helpful to review Intro to Developer Tools in Google Chrome to help with understanding the bug and reporting specific behavior.can be recreated in the current release FOLIO environment found on https://folio-org.atlassian.net
  2. Verify that the Bug has not already been submitted to the Support SIG
    1. Open Production Bugs 

Reporting 

There are two paths to reporting a production bug

  1. Institutional Support works with Folio PO to create appropriate JIRA
    1. In JIRA - PO assigns the correct epic to the JIRA
    2. In JIRA - PO assigns the Dev Team - using the Team vs module matrix
    3. In JIRA - PO or Institution Support selects institution(s) in the Affected Institution field
    4. In JIRA - PO assigns priority
    5. Image Removed
  2. Institutional Support creates a Support JIRA - if Institutional support is not sure of who PO, or if the issue is multi-app
    1. Create a Support JIRA
    2. Project = Support (SUP)
    3. Affected Institution = all known affected institutions
    4. Assign priority
    5. Using the Team Vs Module Matrix assign the appropriate Dev Team (to the best of your understanding)
    6. Image Removed
    7. If the issue is urgent the reporter should
      1. tag the relevant PO in the issue comments.  If user is unable to determine the correct PO, then tag the FOLIO Lead PO
      2. Assign a "PI" priority - which notifies the Support SIG

Support SIG

  1. Reviews P1s daily
    1. If the issue is urgent the reporter should
      1. tag the relevant PO in the issue comments.  If user is unable to determine the correct PO, then tag the FOLIO Lead PO
      2. Assign a "PI" priority

...

Creating a Jira ticket: 

  1.  Log into Jira https://issues.folio.org
  2.  Click Create in the top navigation 
    1.  A pop-up window will appear
    2.  Project = Support (SUP)
    3.  Issue Type = Bug
    4. Template = Standard Bug Write-Up Format
    5. Summary =  Treat as a Subject line for an email, Sample: "Check-out receipt emails are not sent to library users"
      1. Pro tip: Indicate your level of priority in the summary - /wiki/spaces/DQA/pages/2657909  (P1, P2, P3, P4)
        1. EXAMPLE:  P2 -Check-out receipt emails are not sent to library users
    6. Description: 
      1. create a problem statement
      2. Indicate steps to reproduce 
      3. what is expected to happen 
      4. what is really happening 

A stellar Jira ticket would contain:

  • Library Name of who is impacted and what community environment the issue was recreated in
  • The perceived impact/priority of the issue in the summary line
  • Date/time(please include your time zone) the problem started
  • What you expect to happen
  • What actually happens
  • Steps to replicate the problem
  • Details! Screenshots!

Troubleshooting Tips and tricks: 

  • Which browser am I using? Google Chrome is the only officially supported browser for FOLIO.
  • Can I reproduce the issue with another record?
  • Does this also happen for my colleagues?
  • Do I have sufficient permissions to perform this action?
  • Are my app settings configured to support this action?
  • Can I reproduce the issue in an incognito window?
  • Important: Can I reproduce the issue in a community reference environment on the same FOLIO version?

Looking under the hood

  • Open FOLIO in Chrome
  • Press F12 to open the browser’s Developer Tools
  • Look at the Network and Console panes
  • Any error messages?

Video/tutorial:

Here's a link to a YouTube presentation at WOLFcon 2023 with tips and tricks for both writing up bug tickets and for searching in FOLIO Jira: 

Widget Connector
urlhttp://youtube.com/watch?v=sACkckUJjl4