如何从R导出含个人ID的数据集至REDCap？

你可能误解了REDCapR的功能——它其实支持双向数据操作，既能从REDCap导入数据到R，也能把R中的数据集写入REDCap。下面是具体实现步骤：

1. 确保REDCapR为最新版本 #

旧版本的REDCapR可能缺失写入功能，先更新包：

install.packages("REDCapR")
library(REDCapR)

2. 配置REDCap连接信息 #

需要你的REDCap项目API密钥和服务器地址，不要把API密钥硬编码在脚本里，建议用环境变量或本地文件读取：

# 从环境变量读取API密钥（推荐）
api_key <- Sys.getenv("REDCAP_PROJECT_KEY")
# 替换为你的REDCap服务器API地址
redcap_url <- "https://your-redcap-domain/api/"

3. 预处理待写入的数据集 #

• 数据集的列名必须和REDCap项目中的字段名完全匹配（包括大小写），尤其是个人ID字段（通常是record_id，要和REDCap的记录ID字段一致）。
• 数据类型要对应：比如REDCap的数值字段对应R的数值型，日期字段需格式化为YYYY-MM-DD，单选/多选字段要和REDCap的选项编码一致（比如用1/0或选项文本，取决于项目设置）。

4. 执行写入操作 #

使用redcap_write()函数完成数据上传：

# 替换your_data为你的数据集名称
write_result <- redcap_write(
  data = your_data,
  redcap_uri = redcap_url,
  token = api_key,
  overwrite = TRUE # 可选：TRUE表示覆盖已有记录，FALSE则跳过已存在的record_id
)

5. 验证写入结果 #

redcap_write()会返回一个包含操作详情的列表，你可以检查执行状态：

if (write_result$success) {
  cat("数据写入成功，共更新/新增", write_result$records_affected, "条记录\n")
} else {
  cat("写入失败，错误信息：", write_result$errors, "\n")
}

额外注意事项 #

• 权限检查：你的API密钥必须拥有REDCap项目的数据写入/修改权限，否则会返回权限错误。
• 批量处理：如果数据集过大，建议分批次写入（比如按100条/批拆分），避免API请求超时。
• 元数据核对：可以用redcap_metadata_read()获取REDCap项目的字段元数据，提前核对字段名和规则：

metadata <- redcap_metadata_read(redcap_uri = redcap_url, token = api_key)
head(metadata$data) # 查看字段信息

内容的提问来源于stack exchange，提问作者hklovs