Power BI嵌入时通过URL传递参数的实现咨询（ASP.Net MVC AppOwnsData模式）

你之前构想的URL传参方式适用于Power BI公开分享的报表场景，AppOwnsData嵌入模式不需要用这种方式，直接通过嵌入配置或者JS SDK传参即可，具体实现步骤如下：

前置准备 #

提前在Power BI Desktop里创建好对应报表参数，记录好参数的准确名称、数据类型，参数需要设置默认值避免报表初始化加载失败。

方案一：后端生成嵌入Token时绑定参数 #

适合参数需要做权限管控、不需要用户实时修改的场景，需要先安装NuGet包Microsoft.PowerBI.Api：

// 构造参数集合，参数名和Power BI中定义的完全一致，大小写敏感
var reportParameters = new List<GenerateTokenRequestParameter>
{
    new GenerateTokenRequestParameter("自定义参数名1", "用户输入的参数值1"),
    new GenerateTokenRequestParameter("自定义参数名2", "用户输入的参数值2")
};

// 生成嵌入Token时传入参数
var generateTokenRequest = new GenerateTokenRequest(
    accessLevel: "View",
    allowSaveAs: false,
    reportParameters: reportParameters
);
var tokenResponse = await pbiClient.Reports.GenerateTokenAsync(工作区ID, 报表ID, generateTokenRequest);
// 把生成的EmbedToken传到前端视图即可
ViewBag.EmbedToken = tokenResponse.Token;

方案二：前端实时传递用户输入的参数 #

适合你当前侧边文本框输入后实时更新报表的场景，需要引入powerbi-client JS SDK：

视图层代码 #

<!-- 侧边输入区域 -->
<div class="sidebar">
    <input type="text" id="customParamInput" placeholder="请输入参数值">
    <button id="updateReportBtn">更新报表</button>
</div>
<!-- 报表容器 -->
<div id="powerbiReportContainer" style="width: 100%; height: 800px;"></div>

JS逻辑代码 #

// 初始化报表嵌入配置
const embedConfig = {
    type: 'report',
    id: '你的Power BI报表ID',
    embedUrl: '你的报表嵌入URL',
    accessToken: '@ViewBag.EmbedToken',
    tokenType: window.powerbi.models.TokenType.Embed,
    settings: {
        panes: {
            filters: { visible: false }
        }
    }
};
// 嵌入报表
const reportContainer = document.getElementById('powerbiReportContainer');
const powerbiReport = powerbi.embed(reportContainer, embedConfig);

// 绑定参数提交事件
document.getElementById('updateReportBtn').addEventListener('click', async () => {
    const inputValue = document.getElementById('customParamInput').value.trim();
    if (!inputValue) return;
    try {
        // 更新报表参数
        await powerbiReport.updateParameters({
            parameters: [{
                name: "Power BI里定义的参数名",
                value: inputValue
            }]
        });
        // 触发报表刷新
        await powerbiReport.refresh();
    } catch (error) {
        console.error("参数更新失败：", error);
    }
});

常见排查点 #

• 参数名大小写敏感，前后端配置的参数名必须和Power BI Desktop中创建的参数完全一致
• 如果你的报表用的是页面筛选器不是全局参数，把updateParameters方法替换为updateFilters即可
• 若参数数据类型为数值、日期类型，需要先把用户输入的字符串做类型转换后再传递

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