Nothing
#' @describeIn fromFileRepositoryMethods Delete a file from the file repository.
#' @order 3
#' @export
deleteFromFileRepository <- function(rcon,
doc_id,
...){
UseMethod("deleteFromFileRepository")
}
#' @rdname fromFileRepositoryMethods
#' @order 6
#' @export
deleteFromFileRepository.redcapApiConnection <- function(rcon,
doc_id,
...,
refresh = TRUE,
error_handling = getOption("redcap_error_handling"),
config = list(),
api_param = list()){
# Argument Validation ---------------------------------------------
coll <- checkmate::makeAssertCollection()
checkmate::assert_class(x = rcon,
classes = "redcapApiConnection",
add = coll)
checkmate::assert_integerish(x = doc_id,
len = 1,
any.missing = FALSE,
add = coll)
checkmate::assert_logical(x = refresh,
len = 1,
add = coll)
error_handling <- checkmate::matchArg(x = error_handling,
choices = c("null", "error"),
.var.name = "error_handling",
add = coll)
checkmate::assert_list(x = config,
names = "named",
add = coll)
checkmate::assert_list(x = api_param,
names = "named",
add = coll)
checkmate::reportAssertions(coll)
FileRepo <- rcon$fileRepository()
if (!doc_id %in% FileRepo$doc_id){
coll$push(sprintf("doc_id (%s) not found in the File Repository",
doc_id))
checkmate::reportAssertions(coll)
}
# Get the file path of the file repository file -------------------
file_path <- fileRepositoryPath(doc_id = doc_id,
fileRepo = FileRepo)
# Build the Body List ---------------------------------------------
body <- list(content = "fileRepository",
action = "delete",
returnFormat = "csv",
doc_id = doc_id)
body <- body[lengths(body) > 0]
# Make the API Call -----------------------------------------------
response <- makeApiCall(rcon,
body = c(body, api_param),
config = config)
if (response$status_code != 200){
redcapError(response,
error_handling = error_handling)
}
message(sprintf("File deleted: %s", file_path))
# Refresh the cached File Repository ------------------------------
if (refresh && rcon$has_fileRepository()){
rcon$refresh_fileRepository()
}
data.frame(directory = dirname(file_path),
filename = basename(file_path),
stringsAsFactors = FALSE)
}
Any scripts or data that you put into this service are public.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.