REDCapR 0.10.2
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()
andredcap_read_oneshot()
allow the user to specify if all variables
should be returned with thecharacter
data type. The default is to allowreadr::read_csv()
to guess the data type. (#194)redcap_read_oneshot()
allows use to specify how many rows should be considered whenreadr::read_csv()
guesses the data type. (#194)redcap_read()
,redcap_read_oneshot()
, andredcap_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 returnscharacter
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 forredcap_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()
andredcap_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 inredcap_read()
(no longer justredcap_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 ofutils::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 bydplyr::bind_rows()
- the checkmate package inspects most function parameters now (instead of
testit::assert()
andbase:stop()
) (#190 & #208). collapse_vector()
is refactored and tested (#209)- remove dependency on
pkgload
package (#218) - Update Markdown syntax to new formatting problems (#253)