redcap_data {REDCapDM}

Read REDCap data

Description

This function allows users to read datasets from a REDCap project into R for analysis, either via export of the data or via an API connection.

The REDCap API is an interface that allows communication with REDCap and server without going through the interactive REDCap interface.

Usage

redcap_data(
  data_path = NA,
  dic_path = NA,
  event_path = NA,
  uri = NA,
  token = NA,
  filter_field = NA
)

Arguments

data_path

Character string with the pathname of the R file to read the dataset from.

dic_path

Character string with the pathname of the dictionary.

event_path

Character string with the pathname of the file containing the correspondence between each event and each form (it can be downloaded through the 'Designate Instruments for My Events' tab inside the 'Project Setup' section of REDCap)

uri

The URI (Uniform Resource Identification) of the REDCap project.

token

Character vector with the generated token.

filter_field

Character vector with the fields of the REDCap project desired to import into R (API connection only)<.

Value

List containing the dataset and the dictionary of the REDCap project. If the event_path is specified, it will also contain a third element with the correspondence of the events & forms of the project.

Note

If you will give further use to the package, we advise you to use the argument 'dic_path' to read your dictionary, as all other functions need it in order to run properly.

To read exported data, you must first use REDCap's 'Export Data' function and select the 'R Statistical Software' format. It will then generate a CSV file with all the observations and an R file with the necessary code to complete each variable's information.

Examples

## Not run: 
# Exported files from REDCap

dataset <- redcap_data(data_path = "C:/Users/username/example.r",
                       dic_path = "C:/Users/username/example_dictionary.csv",
                       event_path = "C:/Users/username/events.csv")

# API connection

dataset_api <- redcap_data(uri = "https://redcap.idibell.cat/api/",
                           token = "55E5C3D1E83213ADA2182A4BFDEA") # This token is fictitious


## End(Not run)