A single file may be attached to a single record. The behavior of this function is consistent with the behavior of the API, which only allows one file to be uploaded at a time
importFiles(rcon, file, record, field, event, overwrite = TRUE, ...,
bundle = NULL)# S3 method for redcapDbConnection
importFiles(rcon, file, record, field, event,
overwrite = TRUE, ..., bundle = NULL)
# S3 method for redcapApiConnection
importFiles(rcon, file, record, field,
event = NULL, overwrite = TRUE, ..., bundle = NULL,
error_handling = getOption("redcap_error_handling"))
A REDCap connection object as generated by redcapConnection
Character string giving the file path to the file to be imported.
The record ID in which the desired file is stored. Must be length 1.
The field name in which the file is stored. Must be length 1.
The event name for the file. Must be length 1. This applies only to longitudinal projects. If the event is not supplied for a longitudinal project, the API will return an error
Logical. When FALSE, the function checks if a
file already exists for that record. If a file exists, the function
terminates to prevent overwriting. When TRUE, no additional
check is performed.
Arguments to be passed to other methods
A redcapBundle object as created by exportBundle.
An option for how to handle errors returned by the API.
see redcap_error
The function may only import a single file