打包 Power BI 视觉对象

在将自定义视觉对象加载到 Power BI Desktop 或与 Power BI 视觉对象库中的社区共享之前,需要将其打包。 使用本教程,你将:

输入属性值

  1. PowerShell 中,如果视觉对象正在运行,请停止该视觉对象。

  2. VS Code 中,导航到视觉对象的根文件夹并打开 pbiviz.json 文件。

  3. visual 对象中,将 displayName 的值设置为您想要的视觉对象显示名称。

    VS Code 的屏幕截图,其中显示显示名称值被设置为 Circle Card。

    将光标悬停在视觉对象图标上时,视觉对象的显示名称将显示在 Power BI 的 “可视化效果 ”窗格中。

  4. 填写或修改 pbiviz.json 文件中的以下字段:

    • visualClassName
    • description

    visualClassName 是可选的,但 description 必须填充包命令才能运行。

  5. 请在supportUrlgitHubUrl中填入用户可以访问的 URL,以获取支持并查看可视化项目的 GitHub 项目。

    以下代码演示 supportUrlgitHubUrl 示例:

    {
        "supportUrl": "https://community.powerbi.com",
        "gitHubUrl": "https://github.com/microsoft/PowerBI-visuals-circlecard"
    }
    
  6. 您可以在对象author中输入您的姓名和电子邮件。

  7. 保存 pbiviz.json 文件。

更新图标(可选)

  1. pbiviz.json 文件中,请注意,文档定义对象中 assets 图标的路径。 图标是 Power BI 的 “可视化效果 ”窗格中显示的图像。 它必须是 PNG 格式化文件和 20 x 20 像素。

  2. Windows 资源管理器中,复制要使用的 icon.png 文件,然后将其粘贴以替换资产文件夹中的默认 icon.png 文件。

  3. VS Code 的资源管理器窗格中,展开 资产 文件夹,然后选择 icon.png 文件。

  4. 查看图标。

打包视觉对象

  1. VS Code 中,确保保存所有文件。

  2. PowerShell 中,输入以下命令以生成 pbiviz 文件:

    pbiviz package
    

    此命令在视觉对象的 /dist/ 目录中创建 pbiviz 文件,并覆盖可能存在的任何以前的 pbiviz 文件。

    Windows 资源管理器的屏幕截图,其中显示了 Power BI 视觉对象项目的文件夹层次结构。dist 文件夹突出显示。

包输出到项目的 /dist/ 文件夹。 该包包含将自定义视觉对象导入 Power BI 服务或 Power BI Desktop 报表所需的所有内容。 你打包了自定义视觉对象,它已可供使用。