REDCapR 1.0.0
Version 1.0 (released 2021-07-21)
The package has been stable for years and should be reflected in the major version number.
Minor Enhancements
- When writing records to the server, the functions
redcap_write()
andredcap_write_oneshot()
have a new parameter that converts R'slogical
/boolean columns to integers. This meshes well with T/F and Y/N items that are coded as 1/0 underneath. The default will be FALSE (ie, the integers are not converted by default), so it doesn't break existing code. (#305) - When writing records to the server, the functions
redcap_write()
andredcap_write_oneshot()
can toggle the ability to overwrite with blank/NA cells (suggested by @Auricap, #315) - The functions
redcap_read_oneshot()
,redcap_read()
, &redcap_read_oneshot_eav()
now support the parametersdatetime_range_begin
anddatetime_range_end
. The are passed to the REDCap parametersdateRangeBegin
anddateRangeEnd
, which restricts records returned, based on their last modified date in the server. (Thanks @pbchase, #321 & #323.) - Better documentation about the
export_survey_fields
parameter in the functionsredcap_read()
&redcap_read_oneshot()
. (Thanks @isaactpetersen, #333) - New function
redcap_report()
export records that populate a REDCap report. (#326.) - New vignette Typical REDCap Workflow for a Data Analyst developed to support a workshop for the 2021 R/Medicine Conference (#332, with @higgi13425, @kamclean, & Amanda Miller)
- New function
create_credential_local()
starts a well-formed csv file that can contain tokens. (#340, after conversations with @higgi13425 & @kamclean.)
Stability Features
- update for newer version of testthat -v3.0.0 (#312)
- update for newer version of readr 2.0.0 (#343)
- update for newer version of readr 1.4.0 (#313)
- update for newer version of REDCap on test server (#310)
- save expected datasets as files -instead of included in the actual test code (#308)
Corrections & Bug Fixes
- Accepts more than one
config_option
element. (Proposed by @BastienRance, #307) - Fixed calculation of
success
value returned byredcap_read()
andredcap_write()
when the parametercontinue_on_error
is true. (Bug found by @llrs, #317)