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
write_redcap_xlsx() could fail on REDCap forms with long form labels (discovered and fix suggested by @pbchase)read_redcap() failed with raw_or_label = "haven" when a form contains no data (discovered by @mrkskk).col_types param from REDCapR to allow for manual specification of expected data type outputsdatetime_range_begin and datetime_range_end params from REDCapR in read_redcap() to support date-bounded record exportscombine_checkboxes() to concatenate checkbox values when multiple are selected. (#225)read_redcap() to incorrectly report categorical variables with data values that don't match any options in the metadata.read_redcap() to fail with an unhelpful error when attempting to export DAG information for a user with insufficient DAG export privileges.raw_or_label = "label" and requesting DAGs, only raw values for DAGs would be retrievedform_complete_pct, event_name, and repeat_type when make_labelled() is calledredcap_events column has been updated to give REDCap event factor levels and order for the redcap_event and event_name columnsread_redcap() would fail for projects containing a stand-alone record ID instrumentcombine_checkboxes() analytics function
combine_checkboxes() to consolidate multiple checkbox fields in a REDCap data tibble under a single columnevent_name added as a column to the redcap_event column of longitudinal supertibblesguess_max parameter in read_redcap() default updated to Inf