REDCapR 1.1.0

Version 1.1.0 (released 2022-08-10)

New Features

• New redcap_delete() function. It deletes a vector of records. (Thanks @joundso, #372, #373)
• New redcap_arm_export() function. It retrieves a list of REDCap project arms. (#375)
• redcap_read() and redcap_read_oneshot() accept a new locale parameter that specifies date, time, and number formats, like using a comma as the decimal separator. It is a readr::locale object. (#377, suggested by @joundso)
• New redcap_instruments() function exports a list of the data collection instruments for a project. (#381, @vcastro)
• New redcap_event_instruments() function exports the instrument-event mappings for a project (i.e., how the data collection instruments are designated for certain events in a longitudinal project).. (#381, @vcastro)
• New redcap_dag_read() function returns the Data Access Groups for a project (#382, @joundso)
• New detection when REDCap has trouble with a large request and drops records. (#400 w/ @TimMonahan)

Minor Enhancements

• sanitize_token() now allows lowercase characters --in addition to uppercase characters & digits. (#347, @jmbarbone)
• redcap_metadata_read() now uses json (instead of csv) to transfer the dictionary between server & client. This accommodates super-wide dictionaries with 35k+ variables. The user shouldn't notice a difference, and still will receive a data.frame. (#335, @januz & @datalorax)
• Include a few more testthat::skip_on_cran() calls to comply with CRAN's "fail gracefully" policy. Similarly, skip remaining examples that depend on external resources. (#352)
• retrieve_credential_local() can now user username to identify the desired credential row (#364)
• redcap_read() and redcap_read_oneshot() gain the http_response_encoding parameter that's passed to httr::content(). The default value remains "UTF-8". (#354, @lrasmus)
• Accommodate single-character REDCap variable names (#367 & #368, @daynefiler)
• Modify redcap_users_export() (which calls REDCap's user export). The API dropped the data_export variable and added the forms_export variable. (#396)
• For redcap_read_oneshot_eav(): if the project isn't longitudinal, a dummy value for event_id is used internally (#396)
• For the testing server & projects, the http errors are a little different, so the testing code was adjusted (#396)
• Set httr::user_agent, following the advice of httr's vignette (#397)

Test Suite

• Added two more dictionaries that are super wide -5k & 35k variables (#335 & #360, @januz & @datalorax)
• Read, modify, & read projects with DAGs (#353, daniela.wolkersdorfer, #353)