Skip to contents

Fetch event names and labels for a REDCap project

Source: R/meta_events.R
meta_events.Rd

Execute an "Export Events" API request to fetch a tibble-style data frame containing event names and labels. Note that this request type is not available for 'classic projects', from which event details cannot be exported.

Usage

meta_events(conn, on_error = "fail")

Arguments

conn

A REDCap API connection object (created with rconn)

on_error

How to handle errors returned by the API (e.g. events cannot be exported for classic projects). Set to "fail" to halt execution and return the API error message, or "null" to ignore the error and return NULL. Defaults to "fail".

Value

A tibble-style data frame with 7 columns:

  • event_name

  • arm_num

  • day_offset

  • offset_min

  • offset_max

  • unique_event_name

  • custom_event_label

Examples

if (FALSE) { # \dontrun{
conn <- rconn(
  url = "https://redcap.msf.fr/api/",
  token = Sys.getenv("MY_REDCAP_TOKEN")
)

meta_events(conn)
} # }