如何从外部数据源（如SQL）动态填充REDCap下拉菜单？

针对手动输入试验协议名称导致拼写不一致、手动维护下拉菜单不现实的问题，以下是几种可行的实现方式：

方案一：使用REDCap外部模块（推荐） #

如果你的REDCap是企业版或本地部署且启用了**外部模块（External Modules）**功能，这是最便捷的路径：

• 查找并安装现成的动态下拉类模块（如「Dynamic Dropdowns」「External Data Lookup」），这类模块支持直接配置外部数据源填充下拉选项
• 配置步骤：
  1. 进入项目的「External Modules」页面，启用对应模块
  2. 选择需要动态填充的下拉字段，配置数据源连接：
     • 若用SQL：填写OnCore数据库的连接字符串、只读账户信息，编写查询语句（例：SELECT protocol_id, protocol_name FROM oncore_protocols WHERE is_active = 1），指定protocol_id为下拉选项的value（唯一标识），protocol_name为显示label
     • 若用Snowflake/OnCore API：配置对应平台的认证参数（如Snowflake的账户、仓库信息，OnCore API的令牌），设置数据获取规则
  3. 设置同步频率（实时触发或定时同步），确保下拉选项与OnCore数据一致

方案二：API驱动的定时同步脚本 #

如果无法使用外部模块，可通过REDCap API结合定时脚本实现自动同步：

1. 编写数据获取脚本（以Python为例）：

   # 示例：从OnCore SQL数据库获取协议列表
   import pyodbc
   import requests
   
   # 连接OnCore数据库
   conn = pyodbc.connect('DRIVER={SQL Server};SERVER=oncore-db;DATABASE=oncore;UID=readonly-user;PWD=xxx')
   cursor = conn.cursor()
   cursor.execute("SELECT protocol_id, protocol_name FROM oncore_protocols WHERE status = 'ACTIVE'")
   protocols = cursor.fetchall()
   
   # 格式化为REDCap下拉选项格式："value,label"
   dropdown_options = "\n".join([f"{pid},{name}" for pid, name in protocols])
   

2. 调用REDCap API更新字段选项：
   使用REDCap的metadata端点，更新目标字段的select_choices_or_calculations属性，将生成的dropdown_options传入
3. 设置定时任务：
   通过Linux cron、Windows任务计划等工具，定期执行脚本（如每天凌晨同步一次），保证下拉选项实时性

方案三：本地部署的外部数据库集成（仅本地部署REDCap） #

如果你的REDCap是本地部署，且服务器可访问OnCore数据库/Snowflake：

• 在REDCap字段设置中，选择**「SQL Query」类型**的下拉字段
• 直接编写查询语句从外部数据源拉取协议列表（例：SELECT protocol_id, protocol_name FROM oncore_protocols WHERE is_active = 1）
• 配置外部数据库连接信息（需REDCap管理员协助完成），实现下拉选项的实时同步

关键注意事项 #

• 用唯一ID作为下拉值：始终以OnCore中的protocol_id作为下拉选项的value，名称作为显示label，避免名称变更导致历史数据关联失效
• 权限安全：使用只读账户访问OnCore数据源，API调用采用令牌认证，避免数据泄露
• 性能优化：只同步活跃状态的协议，避免下拉选项过多影响用户操作体验
• 测试验证：先在测试环境验证同步逻辑，确认数据无误后再部署到正式环境

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