通过SQL脚本修改Oracle APEX中的自定义替换字符串

完全可以通过SQL脚本更新自定义替换字符串，将其集成到Visual Builder Studio的构建作业中，解决部署后替换值被重置为dev环境的问题。以下是两种可靠的实现方式：

1. 使用APEX官方API（推荐） #

Oracle APEX提供了APEX_APPLICATION_INSTALL.SET_SUBSTITUTION_VALUE内置API，专门用于管理应用安装/部署阶段的替换字符串，兼容性和安全性更有保障。

示例代码 #

BEGIN
  -- 替换字符串名称：MY_CUSTOM_SUBST，应用ID：100（替换为你的实际应用ID）
  APEX_APPLICATION_INSTALL.SET_SUBSTITUTION_VALUE(
    p_name  => 'MY_CUSTOM_SUBST',
    p_value => '&ENV_SPECIFIC_VALUE.' -- 通过环境变量传递对应环境的取值
  );
  -- 多个替换字符串可重复调用上述API
END;
/
COMMIT;

在Visual Builder Studio构建作业中，可根据部署环境（dev/test/prod）设置对应的环境变量ENV_SPECIFIC_VALUE：

• dev环境：设为https://dev.example.com/api
• test环境：设为https://test.example.com/api
• prod环境：设为https://prod.example.com/api

2. 直接更新APEX系统视图（备选） #

若无法使用API，也可直接更新APEX的APEX_APPLICATION_SUBSTITUTIONS视图（对应底层表WWV_FLOW_SUBSTITUTIONS），但需注意APEX版本兼容性，且执行用户需具备足够权限。

示例代码 #

UPDATE APEX_APPLICATION_SUBSTITUTIONS
SET SUBSTITUTION_VALUE = '&ENV_SPECIFIC_VALUE.'
WHERE APPLICATION_ID = 100 -- 替换为你的应用ID
  AND SUBSTITUTION_NAME = 'MY_CUSTOM_SUBST'; -- 替换为你的替换字符串名称
COMMIT;

集成到构建作业的步骤 #

1. 将上述SQL脚本保存为独立文件（如update_substitutions.sql）
2. 在Visual Builder Studio的部署作业中，添加「执行SQL脚本」步骤，放在应用安装/导入步骤之后
3. 根据部署环境配置对应变量值，确保脚本执行时能获取当前环境的正确替换值

注意事项 #

• 执行脚本的数据库用户需拥有APEX_ADMINISTRATOR_ROLE，或具备修改APEX_APPLICATION_SUBSTITUTIONS视图的权限
• 确保应用ID和替换字符串名称与实际环境一致
• 建议先在测试环境验证脚本效果，再推广到生产环境

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