redcap import record

(redcap-import-record host token record data . xargs)

redcap-import-record imports a record into REDCap.

Parameter	Description
host	Server hostname
token	Authentication token (project and user specific!)
record	Record primary id, e.g. study_id or participant_id
data	list of lists with data to be imported
xargs	Optional parameters; see below

Optional parameters must come in pairs of 'symbol "string".

Optional Parameter	Description
'event "[event]"	Sets the event for the record in longitudinal projects.
'instrument "[instr]"	Sets the instrument for the record in projects with repeatable instruments. The instance parameters must also be present.
'instance "[instn]"	Sets the instance for the record in projects with repeatable instruments or events.
'type "[type]"	Declares the format of the data parameter. "[type]" may be "eav" (one data point per row) or "flat" (one record per row). Default is "eav".
'overwrite "[over]"	Declares the overwrite behaviour for blank or empty values. "[over]" may be "normal" (no overwriting) or "overwrite". Default is "overwrite".

Example

Example 1: Importing records to a project, where the first study is longitudinal and has an event_1_arm_1 event.

> (define redcap:token "54CC....CC10")
> (define redcap:hostname "redcap.INSTITUTIONNAME.ca")
> (redcap-import-record redcap:hostname redcap:token 
  "1" (list (list "study_id" "1") 
  (list "comments" (number->string ##now)) 
  (list "last_name" "Smith") (list "first_name" "John")) 
  'event "event_1_arm_1")
#t
> (redcap-import-record redcap:hostname redcap:token  
   "2" (list (list "test2" "Jones")))
#t