应用场景：
在项目中跳转传参，一般都是传编码、ID等值，但是显示给客户的所见的又要是有意义的、最终用户能懂得的名称，所以在创建参数的时候一般会有真实值、与显示值。真实值就是传参中的编码、ID等值；显示值就是最终用户能懂得的名称。
示例说明
从"源_电子表格"报表跳转传参到"目标_灵活分析"报表。 "目标_灵活分析"的参数"产品类别"的真实值为"产品类别编码"、显示值为"产品类别名称"。
只传真实值为"产品类别编码"，如下图：
即传真实值为"产品类别编码"又传显示值为"产品类别名称"，如下图：
设置方法
1、在【资源定制】创建案例类似的页面。
2、选中电子表格，右键选择 编辑宏 进入报表宏界面，右击【编辑宏】>创建【跳转规则向导】。（对面上的电子表格报表进行建跳转规则）
3、在双点打开已创建的跳转规则的link，在该界面中进行修改【跳转规则向导】生成宏代码，如示例上中"源_电子表格"报表的"A4"列是 "产品类别编码"； "B4"列是 "产品类别名称"。如下图：
4、在双点打开已创建的跳转规则的action，在该界面中进行修改【跳转规则向导】生成宏代码，因在第3步中修改了link,在link中添加了参数的显示值"产品类别名称"B4列，所以action中修改参数接收值之后的填充中的参数显示值为params[1]。如下图：
link 宏代码
function main(spreadsheetReport) {
if (!spreadsheetReport) return spreadsheetReport;
var sheet = spreadsheetReport.getSheetByName("Sheet1");
var positions = "C4,D4".split(",");
for (var i = 0; i < positions.length; i++) {
var position = positions[i].trim();
var expandedPositions = sheet.getExpandedPositions(position);
for (var j = 0; j < expandedPositions.length; j++) {
var cell = sheet.getCell(expandedPositions[j]);
if (true) {
addLink(spreadsheetReport, sheet, cell);
}
}
}
}
function addLink(spreadsheetReport, sheet, cell) {
sheet.addRuleLink(cell.cellPosition, "传参", [
getCellValue(cell.getRelativeCells('A4')), getCellValue(cell.getRelativeCells('B4'))]); //修改的代码部份，只需再添加获取参数显示值的语句getCellValue(cell.getRelativeCells('B4'))
}
function getCellValue(cell) {
if (!cell) return null;
if (typeof cell.length == 'number') {
var ret = [];
for (var i = 0; i < cell.length; i++) {
ret.push(cell[i].value);
}
return ret;
} else {
return cell.value;
}
}
function checkValue(v1, v2, op) {
if (v1 && typeof v1.length == 'number') {
for (var i = 0; i < v1.length; i++) {
if (checkValue(v1[i], v2, op)) return true;
}
return false;
}
switch (op) {
case 'EQUAL':
return (v1 == v2) || (v2.match(/^\d+(\.\d+)?$/) && v1 == parseFloat(v2));
case 'GREATER':
return v1 > parseFloat(v2);
case 'LESS':
return v1 < parseFloat(v2);
case 'INCLUDE':
return v1.indexOf(v2) >= 0;
case 'PREFIX':
return v1.indexOf(v2) == 0;
case 'SUFFIX':
return v1.indexOf(v2) == (v1.length - v2.length);
}
}
action宏代码
function paramToString(v) {
return v == null ? null: v.toString();
}
function main(spreadsheetReport, ruleName, params, page, pageContext) {
if (ruleName != "传参") return;
var targetResId = "I4028818a1af1b4c2014ea92deff11cc8";
var newReport = false;
//找到对应的dashlet对象，并刷新它。
var dashlet = page.findDashletByReportId(targetResId);
//dashlet不存在
if (!dashlet) return;
var portlet = dashlet.currentPortlet;
if (!portlet) {
return;
}
if (typeof paramsInfo != "undefined" && paramsInfo) paramsInfo.push({
name: "产品类别_code",
value: paramToString(params[0]),
displayValue: paramToString(params[1]) //修改代码的部份只需求改参数显示值，把displayValue: paramToString(params[0])改成displayValue: paramToString(params[1])
});
var pObj = {
value: paramToString(params[0]),
displayValue: paramToString(params[1]) //修改代码的部份只需求改参数显示值，把displayValue: paramToString(params[0])改成displayValue: paramToString(params[1])
};
if (typeof portlet != "undefined" && portlet) portlet.fillParamValueFromObj("产品类别_code", pObj);
//设置参数值到报表对象
portlet.commitParamValue();
portlet.refreshData();
}
//创建参数信息
function createParamInfo(name, value, disValue, mergeType) {
var paramInfo = new Object();
paramInfo.name = name;
paramInfo.value = value;
paramInfo.displayValue = disValue;
if (mergeType) paramInfo.groupType = mergeType;
return paramInfo;
}
