SuperAPI AI 工具集

Power BI Custom Visuals Development

编程与开发

查看项目

更新于 10-16 07:14

技能介绍

用途:帮助开发者构建、调试、打包并认证 Power BI 自定义可视化。自定义可视化是运行在 iframe 沙箱中的 Web 组件,用 TypeScript 编写,以 D3/SVG/Canvas/HTML 渲染,打包为单个 .pbiviz 文件,在 Power BI Desktop 与服务中运行。本技能为知识插件,可生成和审查源码文件,并驱动本地 pbiviz CLI,无需 MCP 服务器或云凭据。

主要能力:覆盖脚手架→开发→调试→打包→认证全流程。涉及 pbiviz.json、capabilities.json、visual.ts、settings.ts 等核心文件;讲解 dataRoles、dataViewMappings、objects 与功能标志;DataView 的 single、categorical、table、matrix 四种映射解析;IVisual 生命周期(constructor、update、getFormattingModel、destroy)与宿主服务;基于 API 5.1+ 的现代格式窗格;选择与交叉筛选、高亮、工具提示、上下文菜单、下钻、书签、着陆页等交互;以及 ESLint、jasmine/karma 单元测试和安全规则。

必要用法:需 Node.js(当前 LTS)与 npm,全局安装工具链 npm i -g powerbi-visuals-tools@latest 以获得 pbiviz 命令;需 Power BI Pro 或 PPU 账户在服务中测试,并启用开发者模式。脚手架使用 pbiviz new <name>,本地调试使用 pbiviz start,打包使用 pbiviz package 生成 dist/<name>.pbiviz。认证需 Partner Center 账户与可公开审查的 GitHub 仓库。

适用场景:需要生命周期控制、自定义格式窗格、高级交互或 AppSource 分发时选用 pbiviz SDK;若只需 Vega/Vega-Lite 图表,可考虑免构建的 Deneb(已认证)。

限制:认证要求使用最新 API、小写认证 Git 分支、仅开源库、支持渲染事件 API、无外部网络访问、无压缩代码,并通过 pbiviz package --certification-audit。不得用 innerHTML 或 D3.html() 处理用户数据,避免 eval 等动态代码。具体价格与收费信息暂未提供。