如何在Oracle Apex 22.1中用JavaScript获取交互式报表排序顺序

虽然Oracle Apex官方JavaScript API没有直接提供获取交互式报表排序顺序的公开方法，但可以通过访问报表组件的内部模型来实现，以下是针对两种常见报表类型的解决方案：

针对交互式网格（Interactive Grid） #

如果你的报表是交互式网格，可通过以下代码获取排序规则：

// 替换为你的交互式网格静态ID
const reportStaticId = "YOUR_REPORT_STATIC_ID";
const report = apex.region(reportStaticId).widget();
const sortDetails = report.interactiveGrid("getViews", "grid").model.getSort();

// 遍历解析排序信息
sortDetails.forEach(item => {
    const column = item.columnName;
    const direction = item.direction === "asc" ? "升序" : "降序";
    console.log(`列名: ${column}, 排序方向: ${direction}`);
    // 这里可以将信息存储，用于后续传递给BI Publisher
});

针对传统交互式报表（Interactive Report） #

如果是传统的交互式报表，使用以下代码：

// 替换为你的交互式报表静态ID
const reportStaticId = "YOUR_REPORT_STATIC_ID";
const report = apex.region(reportStaticId).widget();
const sortInfo = report.report("option", "sort");

if (sortInfo) {
    const column = sortInfo.column;
    const direction = sortInfo.direction === "ASC" ? "升序" : "降序";
    console.log(`排序列: ${column}, 排序方向: ${direction}`);
    // 存储或传递排序信息到BI Publisher
}

注意事项 #

• 确保代码在报表渲染完成后执行：可将代码放在apex.event.globals.documentReady事件中，或者报表的After Refresh动态动作内
• 必须设置报表的静态ID：在报表属性的"高级"选项卡中指定静态ID，确保代码能准确定位报表组件
• 该方法依赖Apex内部实现：虽然在22.1版本中稳定，但后续版本可能有变更，升级时需测试验证

传递排序规则到BI Publisher #

获取到排序信息后，可通过以下方式传递给BI Publisher：

• 将排序信息拼接为URL参数，在调用BI Publisher报表时附加到请求链接中
• 通过AJAX将排序信息发送到后端存储过程，再由存储过程传递给BI Publisher
• 在BI Publisher模板中，根据接收的参数配置Excel的排序规则，实现与前端一致的排序效果

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