Learn R Programming

redcapAPI (version 2.8.0)

exportLogging: Export Logging Records

Description

These methods enable to user to export the logging (audit trail) of all changes made to a project, including data exports, data changes, project metadata changes, modification of user rights, etc.

Usage

exportLogging(
  rcon,
  logtype = character(0),
  user = character(0),
  record = character(0),
  dag = character(0),
  beginTime = .POSIXct(character(0)),
  endTime = .POSIXct(character(0)),
  ...
)

# S3 method for redcapApiConnection exportLogging( rcon, logtype = character(0), user = character(0), record = character(0), dag = character(0), beginTime = as.POSIXct(character(0)), endTime = as.POSIXct(character(0)), ..., error_handling = getOption("redcap_error_handling"), config = list(), api_param = list() )

Value

Returns a data frame with columns

timestampThe date/time of the logging record.
usernameThe user name of the user that performed the action being logged.
actionThe classification of action being logged.
detailsDetails of the action being logged.
recordThe record ID associated with the action being logged. When not related to a record, this will be NA

Arguments

rcon

A redcapConnection object.

logtype

character(0/1). The log event types to export. When the length is zero, all event types are exported. Otherwise, it must be one of c("export", "manage", "user", "record", "record_add", "record_edit", "record_delete", "lock_record", "page_view")

user

character(0/1). Users for whom to return logs. By default logs for all users are returned.

record

character(0/1). Record ID for which logs are to be returned. By default, logs are returned for all records.

dag

character(0/1). Data access group ID for which to return logs. By default, logs are returned for all data access groups.

beginTime

POSIXct(0/1). When given, only logs recorded after this time will be returned.

endTime

POSIXct(0/1). When given, only logs recorded before this time will be returned.

...

Arguments to pass to other methods

error_handling

character(1). One of c("error", "null"). An option for how to handle errors returned by the API. see redcapError().

config

A named list. Additional configuration parameters to pass to httr::POST(). These are appended to any parameters in rcon$config.

api_param

A named 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.

Examples

Run this code
if (FALSE) {
unlockREDCap(connections = c(rcon = "project_alias"), 
             url = "your_redcap_url", 
             keyring = "API_KEYs", 
             envir = globalenv())
                    
# Export all of the logging events       
exportLogging(rcon)
  
# Export all of the events for record '2'
exportLogging(rcon, 
              record = "2")
                
# Export all of the events where a record was deleted
exportLoging(rcon, 
             logtype = "record_delete")
}

Run the code above in your browser using DataLab