Learn R Programming

redcapAPI (version 2.7.4)

exportMetaData: Export Meta Data from a REDCap Database

Description

Retrieves the meta data for a REDcap database, including field names, labels, types, formulas, etc. This file can be used to parse levels of factors, apply labels, and other data management tasks once the data are retrieved

Usage

exportMetaData(rcon, ...)

# S3 method for redcapApiConnection exportMetaData( rcon, fields = character(0), forms = character(0), ..., drop_utf8 = FALSE, error_handling = getOption("redcap_error_handling"), config = list(), api_param = list() )

Arguments

rcon

A REDCap connection object as generated by redcapConnection.

...

Arguments to be passed to other methods.

fields

A character vector of field names for which the metadata is to be retrieved.

forms

A character vector of forms for which the metadata is to be retrieved. Note that if a form name is given, all of the fields on that form will be returned, regardless of whether it is included in fields or not. Be careful to use the form names in the second column of the data dictionary, and not the display names shown on the webpage.

drop_utf8

logical(1). In some cases, UTF-8 characters can pose problems for exporting the data dictionary. Set this to TRUE to replace any UTF-8 characters with empty characters.

error_handling

An option for how to handle errors returned by the API. see redcap_error

config

list Additional configuration parameters to pass to POST. These are appended to any parameters in rcon$config.

api_param

list Additional API parameters to pass into the body of the API call. This provides users to execute calls with options that may not otherwise be supported by redcapAPI.

REDCap API Documentation

This function allows you to export the metadata for a project

REDCap Version

5.8.2+ (and earlier, but we don't know how much earlier)

Author

Jeffrey Horner

Details

A record of this export is placed in the REDCap logging page, but the file that is exported is not stored in the database.