recordsManagementMethods: Export Next Record Name or Rename a Record

In redcapAPI: Interface to 'REDCap'

Export Next Record Name or Rename a Record

Description

These methods enable the user to get the next record name (when auto numbering is enabled) or rename and existing record.

Usage

exportNextRecordName(rcon, ...)

renameRecord(rcon, record_name, new_record_name, arm = NULL, ...)

## S3 method for class 'redcapApiConnection'
exportNextRecordName(rcon, ...)

## S3 method for class 'redcapApiConnection'
renameRecord(rcon, record_name, new_record_name, arm = NULL, ...)

Arguments

rcon	A redcapConnection object.
record_name	character or integerish. The name of an existing record in the project.
new_record_name	character or integerish. The new name to give to the record. Must have the same length as record_name.
arm	character or NULL, an optional arm number. If NULL, then all records with same name across all arms on which it exists (if longitudinal with multiple arms) will be renamed to new record name, otherwise it will rename the record only in the specified arm. When not NULL, it must have the same length as record_name.
...	Arguments to pass to other methods

Value

exportNextRecordName returns an integerish value. The value is determined by looking up the highest record ID number in the project and incrementing it by 1.

renameRecord invisibly returns a logical vector that indicates if the operation was successful. Otherwise, an error is thrown.

Functions

• exportNextRecordName(): Get the ID number for the next record to be created.

• renameRecord(): Rename an existing record.

See Also

exportRecords(),
exportReports(),
importRecords(),
deleteRecords(),
exportRecordsTyped(),
exportReportsTyped()

Examples

## Not run: 
unlockREDCap(connections = c(rcon = "project_alias"), 
             url = "your_redcap_url", 
             keyring = "API_KEYs", 
             envir = globalenv())
             
# Get the next record name
exportNextRecordName(rcon)

# Rename an existing record
renameRecord(rcon, 
             record_name = "1", 
             new_record_name = "42")

## End(Not run)

redcapAPI documentation built on June 8, 2025, 1:49 p.m.