Makes a request to JIRA's latest REST API to retrieve all projects and their basic project information (Name, Key, Id, Description, etc.).

get_jira_projects(
  domain = NULL,
  username = NULL,
  password = NULL,
  expand = NULL,
  verbose = FALSE
)

Arguments

domain

Custom JIRA domain URL as for example https://bugreports.qt.io. Can be passed as a parameter or can be previously defined through the save_jira_credentials() function.

username

Username used to authenticate the access to the JIRA domain. If both username and password are not passed no authentication is made and only public domains can bet accessed. Optional parameter.

password

Password used to authenticate the access to the JIRA domain. If both username and password are not passed no authentication is made and only public domains can bet accessed. Optional parameter.

expand

Specific JIRA fields the user wants to obtain for a specific field. Optional parameter.

verbose

Explicitly informs the user of the JIRA API request process.

Value

Returns a data.frame with a list of projects for which the user has the BROWSE, ADMINISTER or PROJECT_ADMIN project permission.

Warning

The function works with the latest JIRA REST API and to work you need to have a internet connection. Calling the function too many times might block your access, you will receive a 403 error code. To unblock your access you will have to access interactively through your browser, signing out and signing in again, and might even have to enter a CAPTCHA at https://jira.yourdomain.com/secure/Dashboard.jspa. This only happens if the API is called upon multiple times in a short period of time.

See also

For more information about Atlassians JIRA API go to JIRA API Documentation

Examples

if (FALSE) { get_jira_projects("https://bugreports.qt.io") }