REDCapCAST/reference/read_redcap_tables.md

Download REDCap data

Implementation of passed on to REDCap_split with a focused data acquisition approach using passed on to redcap_read and only downloading specified fields, forms and/or events using the built-in focused_metadata including some clean-up. Works with classical and longitudinal projects with or without repeating instruments. Will preserve metadata in the data.frames as labels.

Usage

read_redcap_tables(
  uri,
  token,
  records = NULL,
  fields = NULL,
  events = NULL,
  forms = NULL,
  raw_or_label = c("raw", "label", "both"),
  split_forms = c("all", "repeating", "none"),
  ...
)

Arguments

• uri:

  REDCap database API uri

• token:

  API token

• records:

  records to download

• fields:

  fields to download

• events:

  events to download

• forms:

  forms to download

• raw_or_label:

  raw or label tags. Can be "raw", "label" or "both".

  * "raw": Standard redcap_read method to get raw values. * "label": Standard redcap_read method to get label values. * "both": Get raw values with REDCap labels applied as labels. Use as_factor to format factors with original labels and use the `gtsummary` package functions like tbl_summary to easily get beautiful tables with original labels from REDCap. Use fct_drop to drop empty levels.

• split_forms:

  Whether to split "repeating" or "all" forms, default is all. Give "none" to export native semi-long REDCap format

• ...:

  passed on to redcap_read

Value

list of instruments

Examples

# Examples will be provided later