REDCapDM 0.6-0

2023-03-31

Changes to functions

Fixed a bug in the rd_transform() function in the branching logic evaluation of checkboxes from non longitudinal projects.

2023-03-24

New function rd_export() to export the identified queries to an excel file.
The redcap_data() function can read the relative path to the working directory in the path arguments.
Now rd_transform() will keep all the labels of the variables in the transformed data. Therefore, the keep_labels argument has been removed.
rd_transform() now will also return the event_form element in the output.
New argument exclude_recalc added to the rd_transform() function to exclude specified calculated fields from being recalculated. It may reduce the execution time in projects with complex calculated fields.
The filter argument in the rd_query() and rd_event() functions now works as a vector so a different filter can be applied to each variable.
Minor changes to the rd_query() function.

Fixed bugs in several functions resulting from testing in special project structures of REDCap.

2023-03-03

New link argument of the functions rd_query() and rd_event() to generate the link where the query can be found in REDCap. [Solves Issue #2 in github]

Bug resolved in the summary of queries, when the data did not present events (non-longitudinal projects).

2023-02-24

The redcap_data() function, when used to read data through an API connection, will automatically read the event-form mapping without specifying the event_path argument. This will only be applied on longitudinal REDCap projects (more than one event).
Adaption of the rd_transform() function to non-longitudinal REDCap projects which only contain one event.
The rd_transform() function will now also delete, by default, variables with the pattern “_timestamp” in addition to the “_complete” pattern.
Change in the names of the categories of the different queries when comparing two reports using the check_queries().
Creation of a new category of query in the check_queries() output (“Miscorrected”) that represents those queries that are different but belong to the same variable of the same record identifier in both the old and new reports.
Adaptation of the summary of the check_queries() and rd_event() functions to the RStudio viewer tab.
Customization of the title of the summary of queries returned by the check_queries() function.

Bug resolved in the redcap_data() function when trying to read the dictionary of a specific structure of a REDCap project.

2023-02-17

New event_path argument of the function redcap_data() to read the event-form mapping of the REDCap project.
For all functions except redcap_data() we can now pass a list with the data, dictionary and event in the first argument of the function.
rd_transform() will now take into account the different events that might be present in the variables of the logic for the recalculation of calculated fields and the evaluation of branching logics. This also applies for rd_rlogic().
As a consequence of this last improvement that applies in longitudinal REDCap projects (with more than one event) now we have to specify not only the data and dictionary but also the event-form mapping.
New checkbox_na argument in rd_transform() to specify if the values of the checkbox will be converted to missing not only when the branching logic is missing but also when it’s not fullfilled (if TRUE).
New by_dag argument in rd_query() to filter the output by each Data Access Group (DAG).
Summary of the generated queries ( $results ) will now include the event and the type of query and will be displayed in the RStudio viewer tab.

The output of the redcap_data() function was not consistent if we read the data using the files exported from REDCap or the API connection. [Solves Issue #1 in github]
We changed the use of the subset() function by the filter() function because of undesired behaviours of this function when applying a non-existent expression.

2023-01-30

2022-12-20