JiraReportingInGSheetsaddonfor google sheets –How to?

1. 11
Jira Reporting in
GoogleSheets
www.qaexperts.pro

2. 22
JiraReportingInGSheets
addon for google sheets
– How to?

3. 33
1. Install JiraReportingInGSheets addon into your google sheet.
2. Activate Jira API calls in your JIRA instance:
Go to Jira’s Administration -> General Configuration panel and turn ON
“Allow Remote API Calls” option.
3. Activate “Configure Jira Connection” menu in your google sheet:
STEP 1: Install addon and configure connection to Jira
www.qaexperts.pro

4. 44
4. Specify your Jira instance web-address, your user login/email and
password.
STEP 1: Install addon and configure connection to Jira
www.qaexperts.pro

5. 55
Type “jira…” in any cell of your google sheet and choose anyone
from jira functions:
STEP 2: Start using addons functions
www.qaexperts.pro

6. 66
jiraGetTotalForSearchResults(searchQueue)
Main Functions:
www.qaexperts.pro
Returns a number of issues returned for a specified Jira search query
Parameters:
searchQueue – jira search query*, text
e.g.: =getJiraTotalForSearchResults(“project in (‘ProjectName') and issuetype in (bug)”)
*Use single quotes (‘) inside of a query instead of (“) , when needed

7. 77
jiraGetIssueFieldValuesForSearchResults(searchQueue, searchFor)
Main Functions:
www.qaexperts.pro
Returns a 1-dimensional array of field values for issues returned for a specified Jira search
query
Parameters:
searchQueue – jira search query, text
searchFor* – jira field ID, text
e.g.: =jiraGetIssueFieldValuesForSearchResults("project = RON and status in (open)";"priority")
*if a field has an array type, the function will return JSON text, which you can further parse using
regular expressions or other ways

8. 88
To get “jira field ID”* for “SearchFor” parameter – Please activate “Show
JIRA Field Map” menu -> the corresponding panel will open:
Main Functions:
www.qaexperts.pro
=jiraGetIssueFieldValuesForSearchResults
( "project in (KOK) and issuetype in (bug)";“summary")
Find needed field ID and put it into the function:
*Field IDs are case-sensitive!

9. 99
In the odd case when you cannot find needed “jira field ID” in “Jira Field Map” panel, you can use
jiraGetIssueContentJSON function to get JSON content of any issue and find a path to the needed field.
Main Functions:
www.qaexperts.pro
jiraGetIssueContentJSON(IssueID)
Returns JSON issue content for a specified
issue
Parameters:
IssueID – ID of an issue, text. e.g. RON-100
e.g.: =jiraGetIssueContentJSON(“RON-100")
=jiraGetIssueFieldValuesForSearchResults
( "project in (KOK) and issuetype in (bug)";“fields.customfield_19720")

10. 1010
jiraGetIssueFieldValuesForSearchResultsFirstItemOnly(searchQueue,
searchFor)
Main Functions:
www.qaexperts.pro
Returns a field value for first issue returned for a specified Jira search query
e.g.: If you would like to get an active sprint name - you can use this function specifying
“sprint in openSprints()” jira query and use regularexp parser to get sprint name from the
function results.

11. 1111
jiraGetIssueTypesAvailable()
Other Functions:
www.qaexperts.pro
Returns a 1-dimensional array of issue types available of the current instance of jira.
e.g.: =jiraGetIssueTypesAvailable()

12. 1212
jiraGetIssueTypesAvailableForProject(projectKey)
Other Functions:
www.qaexperts.pro
Returns a 1-dimensional array of issue types available for the specified project of the
current instance of jira.
Parameters:
projectKey – project key from jira, text. e.g. project key for issue “WEB-40540” is “WEB”
e.g.: = jiraGetIssueTypesAvailableForProject(“WEB”)

13. 1313
jiraGetIssuePrioritiesAvailable()
Other Functions:
www.qaexperts.pro
Returns a 1-dimensional array of issue priorities available of the current instance of jira.
e.g.: =jiraGetIssuePrioritiesAvailable()

14. 1414
jiraGetIssuePrioritiesAvailableForProject(projectKey)
Other Functions:
www.qaexperts.pro
Returns a 1-dimensional array of priorities available for the specified project of the current
instance of jira.
Parameters:
projectKey – project key from jira, text. e.g. project key for issue “WEB-40540” is “WEB”
e.g.: jiraGetIssuePrioritiesAvailableForProject(“WEB”)

15. 1515
jiraGetIssueStatusesAvailableForProject(projectKey)
Other Functions:
www.qaexperts.pro
Returns a 1-dimensional array of statuses available for the specified project of the current
instance of jira.
Parameters:
projectKey – project key from jira, text. e.g. project key for issue “WEB-40540” is “WEB”
e.g.: =jiraGetIssueStatusesAvailableForProject("RON")

16. 1616
jiraGetAssigneeKeysAvailableForProject(projectKey)
Other Functions:
www.qaexperts.pro
Returns a 1-dimensional array of assignee keys available for the specified project of the
current instance of jira.
Parameters:
projectKey – project key from jira, text. e.g. project key for issue “WEB-40540” is “WEB”
e.g.: = jiraGetAssigneeKeysAvailableForProject (“WEB”)

17. 1717
jiraGetAssigneeNamesAvailableForProject(projectKey)
Other Functions:
www.qaexperts.pro
Returns a 1-dimensional array of assignee names available for the specified project of the
current instance of jira.
Parameters:
projectKey – project key from jira, text. e.g. project key for issue “WEB-40540” is “WEB”
e.g.: = jiraGetAssigneeNamesAvailableForProject (“WEB”)

18. 1818
jiraGetAssigneeEmailsAvailableForProject(projectKey)
Other Functions:
www.qaexperts.pro
Returns a 1-dimensional array of assignee emails available for the specified project of the
current instance of jira.
Parameters:
projectKey – project key from jira, text. e.g. project key for issue “WEB-40540” is “WEB”
e.g.: = jiraGetAssigneeEmailsAvailableForProject(“WEB”)

19. 1919
Power of Cells’ Referencing and Concatenation
www.qaexperts.pro

20. 2020
Power of “was in on” query type in jira
project in (RON) and status was in ("Ready to Test") on '2015-04-11'
www.qaexperts.pro

21. 2121
Error Handling
www.qaexperts.pro
If you see #ERROR in a cell, hover you mouse over it to get more details
on the problem and fix it:

22. 2222
To get Static copy of the current sheet data please activate
“Duplicate current sheet with STATIC data” menu
STEP 3: Copying sheet with static data
www.qaexperts.pro

23. 2323
FAQ
www.qaexperts.pro
1. Cannot connect to jira:
a. Try to use “user email” instead of “user ID” for “User Name” field or vice versa.
b. Make sure that proper http or https protocol is indicated for Host.
c. Go to your instance of jira, make logout and login there. Got to your google
worksheet and try to connect to jira again – it should work! (usually applicable
for cloud jira)
2. Functions return “Internal Server Error” message – it happens because google
sheets have limitations for custom functions to be calculated not more than 30
seconds, also a lot of custom functions cannot be calculated often for 1 user
account.
a. Make sure that your functions don’t have heavy queries returning many issues
(more then 200-300) and thus taking a lot of time to execute. – Adjust queries
correspondingly.
b. Make sure that there are not many custom functions in your sheet and that you
don’t force them to calculate often. – Decrease number of functions in your
sheet.
3. Sometimes functions don’t show recent information:
a. Activate menu “Recalculate custom functions in active sheet” to force
recalculations of custom functions.

24. 2424
EXAMPLE 1:
www.qaexperts.pro

25. 2525
EXAMPLE 2:
www.qaexperts.pro

26. 2626
EXAMPLE 3:
www.qaexperts.pro

27. 2727
EXAMPLE 4:
www.qaexperts.pro

28. 2828
QA advanced Education and Tools
www.qaexperts.pro
www.qaexperts.pro