【小技巧】在Cognos+RS页面嵌入JS功能方法

在Cognos Report Studio开发设计页面中，可以友善兼容HTML、JS脚本。往往在开发报表，很少去嵌入JS程序片段，自身工具很多功能基本满足报表需要。但事实上，用户在使用过程中，希望报表需求能与网站网页、企业应用系统页面，功能更多更强大。此时，对Cognos工具设计师开发要求更高，更全面的编程技巧。 ### 在Cognos Report Studio页面嵌入JS功能详解 #### 一、引言 Cognos Report Studio（简称RS）是一款强大的商业智能工具，能够帮助用户设计和开发复杂的报表。通常情况下，Cognos自带的功能已经能满足大多数报表设计的需求。然而，随着用户对报表功能的期待不断提高，单纯依赖Cognos内置功能已无法满足所有需求。因此，开发者开始探索如何在Cognos Report Studio中嵌入JavaScript（简称JS）来增强报表的功能性和灵活性。 #### 二、基础知识介绍 在Cognos Report Studio中嵌入JS涉及到以下关键概念和技术： 1. **HTML项目**：Cognos RS允许开发者通过添加HTML项目来嵌入自定义的HTML和JS代码。 2. **JavaScript**：一种广泛使用的脚本语言，可以在客户端执行，用于实现各种交互效果。 3. **Form Warp Request**：这是Cognos内部的一个对象，用于获取当前报表中的表单数据。 #### 三、具体应用场景 ##### 1. 解决下拉选项框中的“--------------”条目问题 在实际应用中，我们经常会在下拉选项框中看到一条横线，这通常是用来表示无选择或者分隔符。这种默认设置有时候并不符合用户需求。通过嵌入JS代码，可以轻松移除这些不必要的选项。 ```javascript var form = getFormWarpRequest(); var dropDown = form._oLstChoices_user; dropDown.remove(1); // 去掉'--------' dropDown.remove(0); // 去掉参数名称 dropDown.removeAttribute("hasLabel"); // 默认值不可选 ``` ##### 2. 获取用户名称并设置背景，禁用右键弹出菜单不能复制功能 为了提供更加个性化的用户体验，可以使用JS代码来获取用户的登录名称，并根据名称来调整报表的显示风格，例如设置背景色或背景图片。同时还可以通过JS来禁用右键菜单中的复制功能，保护报表数据的安全性。 ```javascript function getvalues(str) { var divdata = document.getElementById(str).getElementsByTagName("option"); for (var i = 0; i < divdata.length; i++) { if (divdata[i].selected) { return divdata[i].value; } } } // 设置背景 var tab = document.getElementById('tab'); tab.style.background = "url('http://127.1.1.1/images/" + getvalues('userDIV') + "')"; // 禁用右键菜单复制功能 document.oncontextmenu = new Function("event.returnValue = false;"); ``` ##### 3. 实现打印功能 通过JS可以为报表添加打印功能，方便用户将报表数据打印出来。这通常涉及到对浏览器打印API的调用。 ```javascript function printPage() { window.print(); } ``` ##### 4. 支持下载Excel、PDF等格式 除了打印功能外，用户还可能希望将报表导出为Excel或PDF格式进行保存。这需要利用到Cognos提供的导出功能接口。 ```javascript function exportToExcel() { // 调用Cognos API导出为Excel window.location.href = 'export?format=xls'; } function exportToPDF() { // 调用Cognos API导出为PDF window.location.href = 'export?format=pdf'; } ``` ##### 5. 解决下拉选项框参数名替换 在某些情况下，需要更改下拉选项框的默认参数名，使其更加符合用户的理解。 ```javascript var form = getFormWarpRequest(); var dropDown = form._oLstChoices_data; dropDown.remove(1); // 去掉'--------' //dropDown.remove(0); // 可选择是否去掉参数名称 dropDown.removeAttribute("hasLabel"); // 默认值不可选 ``` ##### 6. 获取默认值并自动提交参数 有时候为了简化用户的操作流程，可以通过JS来预先设置某些参数的默认值，并在加载报表时自动提交这些参数。 ```javascript var form = getFormWarpRequest(); var dropDown = form._oLstChoices_default; dropDown.value = 'defaultValue'; // 设置默认值 form.submit(); // 提交参数 ``` #### 四、总结 通过以上介绍可以看出，在Cognos Report Studio中嵌入JS可以极大地扩展报表的功能，提升用户体验。当然，这需要开发者具备一定的JavaScript编程基础，以及对Cognos内部API有一定的了解。在实际开发过程中，还需要不断地学习和实践，才能更好地利用这一技术手段来优化报表的设计。