download_jira_issues_by_date: Download JIRA Issues and/or Comments by Date Range

View source: R/jira.R

download_jira_issues_by_dateR Documentation

Download JIRA Issues and/or Comments by Date Range

Description

Wraps around download_jira_issues providing JQL query parameters for specifying date ranges. Only issues created in the specified date range will be downloaded.

Usage

download_jira_issues_by_date(
  domain,
  jql_query,
  fields,
  username = NULL,
  password = NULL,
  save_folder_path,
  max_results,
  max_total_downloads,
  date_lower_bound = NULL,
  date_upper_bound = NULL,
  verbose
)

Arguments

domain

Custom JIRA domain URL

jql_query

Specific query string to specify criteria for fetching

fields

List of fields that are downloaded in each issue

username

the JIRA username

password

the JIRA password/API token

save_folder_path

Path that files will be saved in .json format

max_results

(optional) the [maximum number of results](https://confluence.atlassian.com/jirakb/how-to-use-the-maxresults-api-parameter-for-jira-issue-search-rest-api-1251999998.html) to download per page. Default is 50.

max_total_downloads

Maximum downloads per function call. This parameter specifies how many issues should be downloaded. Subsequent API calls will stop if they reach or surpass this value. See download_jira_issues_by_date and download_jira_issues_by_issue_key source code for examples.

date_lower_bound

Optional. Specify the lower bound date time (e.g. 2023/11/16 21:00)

date_upper_bound

Optional. Specify the upper bound date time (e.g. 2023/11/17 21:00)

verbose

Set verbose=TRUE to print execution details.

Details

Acceptable formats for 'date_lower_bound' and 'date_upper_bound' are:

* "yyyy/MM/dd HH:mm" * "yyyy-MM-dd HH:mm" * "yyyy/MM/dd" * "yyyy-MM-dd"

For example: 'date_lower_bound=2023/11/16 21:00' (an issue ocurring at the exact specified time will also be downloaded).

For further details on the 'created' JQL Query see [the associated JIRA API documentation](https://support.atlassian.com/jira-software-cloud/docs/jql-fields/#Created).

See Also

download_jira_issues_by_issue_key to download JIRA issues and/or comments by issue key range

download_jira_issues for more flexibility in specifying the JQL query

parse_jira to parse jira data with or without comments

refresh_jira_issues to obtain more recent data from any of the downloader functions

Other jira: download_jira_issues_by_issue_key(), download_jira_issues(), refresh_jira_issues()

Other downloaders: download_jira_issues_by_issue_key(), download_jira_issues(), refresh_jira_issues()


sailuh/kaiaulu documentation built on April 17, 2024, 2:21 a.m.