Oracle Visual Builder获取ATP数据动态下载OCI对象存储文件

核心踩坑说明 #

别单独创建SDP类型变量提取File URL字段值——SDP是绑定服务端分页数据源的集合变量，根本没法直接映射到表格当前渲染行的对应数据，这就是之前取值失败的核心原因。行内按钮可直接通过组件原生上下文拿到当前行全量数据，完全不需要额外建中间变量绕路。

具体实现步骤 #

• 配置动作链入参，传递当前行数据
  选中「First File」列内的下载按钮，在右侧属性面板找到已绑定的ojAction事件对应动作链；给动作链新增自定义入参（参数名可自定义，比如叫currentRow），参数映射值直接选组件上下文下的$current.data——这个值是表格渲染每行时自动注入的当前行全量业务对象，和ATP返回的字段完全对应，不需要额外做数据转换。

• 替换filename固定值为动态字段映射
  打开动作链里之前配好的OCI对象存储下载动作节点，找到之前写死固定文件名的filename入参，把映射值替换成刚传进来的动作链入参下的currentRow['File URL']就行。优先用编辑器的点选器选字段，别手敲，容易因为字段名空格、大小写问题匹配失败。

• 按需适配全路径场景
  如果「File URL」列存的不是OCI里的纯文件名，是带目录前缀的全路径，直接在页面JS模块里加个截取文件名的工具函数：

  // 从OCI文件全路径中截取纯文件名
  PageModule.prototype.getOciFileName = function(filePath) {
    if (!filePath) return '';
    return filePath.split('/').pop();
  }
  

  这时候把filename入参映射成函数调用即可：
  {{ $page.functions.getOciFileName($chain.variables.currentRow['File URL']) }}

• 可选前置校验避免报错
  调用下载动作前加个判断节点，校验$chain.variables.currentRow['File URL']是否为空：空值就弹个提示说当前行没关联文件，直接终止动作，别调OCI接口出报错。

验证注意点 #

• 开预览模式的调试面板，点任意行下载的时候看动作链执行日志，确认filename入参拿的就是当前行File URL的值，不是之前的固定值就对了
• 之前单文件下载配的OCI鉴权、REST连接权限都不用改，只要入参对了就能直接复用
• 表格做分页、排序、筛选之后，$current.data会自动匹配对应行的数据，不用额外处理行索引偏移的问题

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