Version 0.11 (Released 2020-04-20) Unreleased

Breaking Changes (possible, but unlikely)

  • kernel_api() defaults to “text/csv” and UTF-8 encoding. Formerly, the function would decide on the content-type and encoding. More details are below in the ‘Stability Features’ subsection.

  • constant() no longer accepts simplify as an options. An integer vector is always returned. (#280)

New Features

Stability Features

  • httr::content() (which is inside kernel_api()) now processes the returned value as “text/csv”, by default. This should prevent strange characters from tricking the process as the internal variable raw_text is being formed. See the [httr::content()](https://httr.r-lib.org/reference/content.html) documentation for a list of possible values for thecontent_type` parameter. (Thanks to great debugging by @vortexing #269, @sybandrew #272, & @begavett, #290)

  • Similarly, kernel_api() now has an encoding parameter, which defaults to “UTF-8”. (#270)

Minor Enhancements

  • check for bad field names passed to the read records functions (#288)

Corrections

  • ‘checkmate’ package is now imported, not suggested (Thanks @dtenenba, #255)

Version 0.10 (Released 2019-09-22) Unreleased

Minor New Features

Modified Internals

Deprecated Features

Version 0.9.8 (Released 2017-05-18) 2017-05-18

New Features

Bug Fixes

  • Adapted to new 2.4 version of curl (see #154)

Versions 0.9.7 (Released 2017-09-09) 2016-09-09

New Features

Minor Updates

Versions 0.9.3 (Released 2015-08-25) 2015-08-26

Minor Updates

  • The retrieve-token() tests now account for the (OS X) builds where the RODBC package isn’t available.

Versions 0.9.0 (Released 2015-08-14) 2015-08-15

New Features

  • Adapted for version 1.0.0 of httr (which is now based on the curl package, instead of RCurl).

Minor Updates

  • Uses requireNamespace() instead of require().
  • By default, uses the SSL cert files used by httr, which by default, uses those packaged with R.
  • Added warning if it appears readcap_read() is being used without ‘Full Data Set’ export privileges. The problem involves the record IDs are hashed.
  • Reconnected code that reads only the id_position in the first stage of batching. The metadata needed to be read before that, after the updates for REDCap Version 6.0.x.
  • retrieve_token_mssql() uses regexes to validate parameters

Version 0.7-1 (Released 2014-12-17) 2014-12-18

New Features

  • Updated for Version 6.0.x of REDCap (which introduced a lot of improvements to API behavior).

Version 0.6 (Released 2014-11-03) Unreleased

New Features

Version 0.5 (Released 2014-10-19) Unreleased

New Features

Minor Updates

  • Test suite now uses testthat::skip_on_cran() before any call involving OUHSC’s REDCap server.
  • Vignette example of subsetting, conditioned on a 2nd variable’s value.

Version 0.4-28 (Released 2014-09-20) 2014-09-20

New Features

Breaking Changes

  • The records_collapsed default empty value is now an empty string (i.e., "") instead of NULL. This applies when records_collapsed is either a parameter, or a returned value.

Updates

  • By default, the SSL certs come from the httr package. However, REDCapR will continue to maintain a copy in case httr’s version on CRAN gets out of date.
  • The tests are split into two collections: one that’s run by the CRAN checks, and the other run manually. Thanks, Gabor Csardi. Any test with a dependency outside the package code (especially the REDCap test projects) is run manually so changes to the test databases won’t affect the success of building the previous version on CRAN.
  • Corrected typo in redcap_download_file_oneshot() documentation, thanks to Andrew Peters (@ARPeters #45).

Version 0.3 (Released 2014-09-01) Unreleased

New Features

Updates

  • Renamed the former status_message to outcome_message. This is because the message associated with http code returned is conventionally called the ‘status messages’ (eg, OK, Forbidden, Not Found).
  • If an operation is successful, the raw_text value (which was formerly called raw_csv) is returned as an empty string to save RAM. It’s not really necessary with httr’s status message exposed.

Bug Fixes

  • Correct batch reads with longitudinal schema #27

Version 0.2 (Released 2014-07-02) Unreleased

New Features

Updates

Version 0.1 (Released 2014-01-14) Unreleased

New Features

  • Introduces redcap_read() and redcap_read_batch() with documentation
  • SSL verify peer by default, using cert file included in package
  • Initial submission to GitHub

Enhancements