read_redcap(raw_or_label = "haven") now correctly casts categorical data values to character when their type is not character or numeric.read_redcap() now supports instruments that follow a mixed repeating/non-repeating structure with the allow_mixed_structure parameterallow_mixed_structure to TRUE or getOption("redcaptidier.allow.mixed.structure", FALSE).
NA in yesno, truefalse, and checkbox fields with a warning.
options(redcaptidier.allow.mdc = TRUE).raw_or_label now accepts "haven" as an option, converting categorical fields to haven_labelled vectors instead of factors.form_complete_pct, is now available when viewing the supertibble showing the percentage of a given instrument that has a form status marked as “Complete” (green)This package has been considered stable for months now with no new issues reported, and so should be reflected in the major version number.
openxlsx2 API calls to coincide with v1.0pkgdown site updatesadd_skimr_metadata() and write_redcap_xlsx() with supporting documentationread_redcap() now supports Data Access Groups (DAGs)
read_redcap(): export_data_access_groupsread_redcap() now supports projects with repeating events which introduced a breaking change to data tibble column names
redcap_repeat_instance is now redcap_form_instanceredcap_event_instance has been added to denote repeating eventsselect_choices_and_calculations exported by the REDCap API to redcap_metadata tibblehttptest mockssuppress_redcapr_messages argument for read_redcap() was not working appropriatelyread_redcap() would fail when select_choices_and_calculations was missing whitespace after commas (discovered by @camcaan)read_redcap() would fail for projects with a multiple choice field having duplicate values with the same label
forms specification in read_redcap() may lead to incorrect removal of data for databases with repeating eventsread_redcap_tidy() is now read_redcap()extract_table() is now extract_tibble()extract_tables() is now extract_tibbles()bind_table() is now bind_tibbles()
redcap_form_label: The instrument’s human-readable labelredcap_metadata: REDCap metadata associated with the instrument (derived from REDCapR::redcap_metadata_read())redcap_events: Events and arms associated with this instrument (for longitudinal projects only)data_rows, data_cols: Row and column counts of redcap_datadata_size: Size of the redcap_data tibble in memorydata_na_pct: The percentage of missing data in the redcap_data tibblemake_labelled() function that attaches variable labels using the labelled packageread_redcap():
forms: Allows reading specific instruments instead of the whole projectexport_survey_fields: Allows for export of redcap_survey_timestamp and redcap_survey_identifier columns from survey-enabled REDCap instruments (TRUE by default)check_repeat_and_nonrepeat(), distill_*_table_long(), and multi_choice_to_labels().data pronoun in tidyselect expressionsextract_*() functions under some circumstances returned NULL instead of the expected tibblesclean_redcap() may not correctly assign variables across instruments to their appropriate tables in cases of similar prefixesREADME and DESCRIPTION filesDESCRIPTION file fixes for undirected quotation marks (e.g. REDCap to ‘REDCap’)@examples tags for bind_tables and extract_tablepkgdown siteDESCRIPTION file fixes for spell check notesroxygen2 examples updatedread_redcap_tidy(), bind_tables(), extract_table(), and extract_tables() with documentationGitHub Commits and Releases