Skip to content

REDCapR 0.10.2

Compare
Choose a tag to compare
@wibeasley wibeasley released this 22 Sep 23:47
1f3c24b

Released 2019-09-22

Minor New Features

  • export survey time-stamps optionally (Issue #159)
  • redcap_next_free_record_name(): API call for 'Generate Next Record Name', which returns the next available record ID (Issue #237)
  • redcap_read() and redcap_read_oneshot() allow the user to specify if all variables
    should be returned with the character data type. The default is to allow readr::read_csv() to guess the data type. (#194)
  • redcap_read_oneshot() allows use to specify how many rows should be considered when readr::read_csv() guesses the data type. (#194)
  • redcap_read(), redcap_read_oneshot(), and redcap_read_oneshot_eav() always return Linux-style line endings (ie \n) instead of Windows style line endings (ie, \r\n) on all OSes. (#198)
  • read_metadata() always returns character vectors for all variables. With readr 1.2.0, some column were returned differently than before. (#193)
  • 'raw_or_label_headers' now supported (Thanks Hatem Hosny - hatemhosny, #183 & #203)
  • 'export_checkbox_labels' now supported (#186)
  • redcap_users_export() now included (#163)
  • 'forms' now supported for redcap_read(), redcap_read_oneshot(), & redcap_read_oneshot_eav()(#206). It was already implemented for redcap_metadata_read().
  • If no records are affected, a zero-length character vector is returned (instead of sometimes a zero-length numeric vector) (#212)
  • New function (called constants()) easily exposes REDCap-specific constants. (#217)
  • id_position allows user to specify if the record_id isn't in the first position (#207). However, we recommend that all REDCap projects keep this important variable first in the data dictionary.
  • Link to new secure Zenodo DOI resolver (@katrinleinweber #191)
  • parameters in redcap_read() and redcap_read_oneshot() are more consistent with the order in raw REDCap API. (#204)
  • When the verbose parameter is NULL, then the value from getOption("verbose") is used. (#215)
  • guess_max parameter provided in redcap_read() (no longer just redcap_read_oneshot()). Suggested by @isaactpetersen in #245.
  • Documentation website constructed with pkgdown (#224).
  • redcap_variables() now throws an error when passed a bad URI (commit e542155).

Modified Internals

  • All interaction with the REDCap server goes through the new kernal_api() function, which uses the 'httr' and 'curl' packages underneath. Until now, each function called those packages directly. (#213)
  • When converting REDCap's CSV to R's data.frame, readr::read_csv() is used instead of utils::read.csv() (Issue #127).
  • updated to readr 1.2.0 (#200). This changed how some data variables were assigned a data types.
  • uses odbc package to retrieve credentials from the token server. Remove RODBC and RODBCext (#188). Thanks to @krlmlr for error checking advice in https://stackoverflow.com/a/50419403/1082435.
  • data.table::rbindlist() replaced by dplyr::bind_rows()
  • the checkmate package inspects most function parameters now (instead of testit::assert() and base:stop() ) (#190 & #208).
  • collapse_vector() is refactored and tested (#209)
  • remove dependency on pkgload package (#218)
  • Update Markdown syntax to new formatting problems (#253)