在 Power BI 中创建模板应用

本文包含创建 Power BI 模板应用的分步说明。 Power BI 模板应用使 Power BI 合作伙伴能够在极少编码或没有编码的情况下生成 Power BI 应用,并将它们部署到任何 Power BI 客户。

如果可以创建 Power BI 报表和仪表板,那么你可成为模板应用构建者,可以生成分析内容并将其打包到应用中。 然后,可通过任何可用平台(例如 AppSource)或自己的 Web 服务,将应用部署其他 Power BI 租户。 如果要通过自己的 Web 服务分发模板应用,可将安装过程的部分操作自动化,使客户操作更加简单。

Power BI 管理员管理和控制组织中谁可以创建模板应用,以及谁可以安装它们。 获得授权的用户可以安装模板应用,对其进行修改并将其分发给组织中的 Power BI 用户。

先决条件

下面是生成模板应用的要求:

创建模板工作区

若要创建可以分发给其他 Power BI 租户的模板应用,需要在工作区中创建它。

  1. 在 Power BI 服务中,按照在 Power BI 中创建工作区中所述创建工作区。 在“高级”部分,选择“开发模板应用”。

    Screenshot that shows Develop a template app.

    重要

    应用构建者工作区分配到的容量不能决定应用安装者在其中安装应用的工作区的容量分配。 这意味着在高级容量工作区中开发的应用不一定安装在高级容量工作区中。 因此,不建议对构建者工作区使用高级容量,因为安装者工作区可能不是高级容量,依赖高级容量的功能将不起作用,除非安装者将安装的工作区手动重新分配到高级容量。

  2. 创建完工作区后,选择“保存”。

注意

需要 Power BI 管理员授权才能提升模板应用。

向模板应用工作区添加内容

与常规 Power BI 工作区一样,下一步是向工作区添加内容。 如果在 Power Query 中使用参数,请确保这些参数具有明确定义的类型,例如 Text。 不支持 AnyBinary 类型。

有关为模板应用创建报表和仪表板时要考虑的建议,请参阅在 Power BI 中创作模板应用的提示

定义模板应用的属性

现在工作区中已有内容,即可将其打包到模板应用中。 第一步是创建一个测试模板应用,只能从租户的组织内部访问。

  1. 在模板应用工作区中,选择“创建应用”

    Screenshot that shows Create app.

    接下来,在六个选项卡中为模板应用填写更多选项。

  2. 在“品牌打造”选项卡上,填写以下字段:

    • 应用名称
    • 说明
    • 支持站点。 将模板应用重新分发为组织应用后,支持链接将显示在应用信息下。
    • 应用徽标。 徽标的文件大小限制为 45K,纵横比必须为 1:1,文件格式必须为 .png、.jpg 或 .jpeg。
    • 应用主题颜色

    Screenshot that shows the Branding tab.

  3. 在“导航”选项卡上,可打开“新建导航生成器”来定义应用的导航窗格。

    Screenshot that shows the Navigation tab.

    如果未打开“新建导航生成器”,可选择应用登陆页面。 将报表或仪表板定义为应用的登陆页面。 使用一个能给人留下你希望的印象的登陆页面。

  4. 在“控制”选项卡上,对应用用户设置有关应用内容的限制。 可以使用此控件来保护应用中的知识产权。

    Screenshot that shows the Control tab.

    注意

    若要保护数据,请禁用“将报表下载到文件”选项,然后根据需要配置其他两个选项。

    原因:

    此选项卡上的“查看”、“编辑”和“导出”控件仅适用于 Power BI 服务。 下载 .pbix 文件后,该文件将不再在该服务中。 它会将不受保护的数据副本放在用户选择的位置中。 你将无法再控制用户可以对该文件执行的操作。

    如果要限制对查询和度量值的访问权限,同时仍允许用户添加他们自己的数据源,请仅选中“导出或在外部连接到数据”选项。 这样,用户就可添加自己的数据源,但不能编辑你的语义模型。 有关详细信息,请参阅在 Power BI Desktop 中使用复合模型

  5. 在原始 .pbix 文件中创建参数(了解有关创建查询参数的详细信息)。 可使用此选项卡上的功能帮助应用安装程序在应用安装后并且连接到其数据时对应用进行配置。

    Screenshot that shows the Parameters tab.

    每个参数都有一个名称(来自查询)和一个“值”字段。 可通过三种方式在安装期间获取参数的值:

    • 可要求安装应用的用户输入值。

      在这种情况下,你将提供一个用户将替换的示例。 要以这种方式配置参数,请选中“必需”复选框,然后在文本框中提供一个向用户显示所需值类型的示例,如下例所示。

      Screenshot of a parameter value required from the user.

    • 可以提供一个安装应用的用户无法更改的预填充值。

      通过此方式配置的参数对安装应用的用户隐藏。 仅当确定预填充的值对所有用户均有效时,才应使用此方法。 否则,请使用第一种需要用户输入的方法。

      要以这种方式配置参数,请在“值”文本框中输入值,然后选择锁定图标,使该值无法更改。 以下示例显示此选项:

      Screenshot of an absolute parameter value.

    • 可以提供用户在安装期间可更改的默认值。

      要以这种方式配置参数,请在“值”文本框中输入所需的默认值,并解锁锁定图标,如下例所示:

      Screenshot of a changeable default parameter value.

    此选项卡中还提供了指向应用文档的链接。

  6. 在“身份验证”选项卡上,选择要使用的身份验证方法。 可用选项取决于所使用的数据源类型。

    Screenshot that shows the Authentication tab.

    系统会自动配置隐私级别:

    • 单一数据源自动配置为专用。
    • 多匿名数据源自动配置为公共。
  7. 在测试阶段,在“访问”选项卡上决定组织中还有谁可以安装和测试应用。 稍后将返回并更改这些设置。 该设置不影响分布式模板应用的访问权限。

    Screenshot of the Access tab.

  8. 选择“创建应用”。

    你会看到测试应用已就绪的消息,其中包含可复制并与应用测试人员共享的链接。

    Screenshot of the message that the test app is ready.

    你还完成了以下发布管理过程的第一步。

管理模板应用版本

在公开发布模板应用之前,需要确保它已准备就绪。 在 Power BI 发布管理窗格中,可关注并检查完整的应用发布路径。 还可以触发阶段间的转换。 常见的阶段包括:

  • 生成测试应用,仅在组织内进行测试。
  • 将测试包提升到预生产阶段,并在组织外进行测试。
  • 将预生产包提升到生产中的生产版本。
  • 删除任何包或从上一阶段重新开始。

在发布阶段之间转移时,URL 不会更改。 提升不影响 URL 本身。

完成发布阶段:

  1. 在模板工作区中,选择“发布管理”

    Screenshot that shows Release Management in the template workspace.

  2. 如果按照本文中的步骤创建了测试应用,则“测试”旁边的点已填充。 选择“获取链接”

    如果尚未创建应用,请选择“创建应用”以启动模板应用创建过程。

    Screenshot of the Release Management pane with Get link highlighted.

  3. 要测试应用安装体验,请复制窗口中的链接并将其粘贴到新的浏览器窗口中。

    从这里开始,需要按照应用安装者所遵循的相同过程进行操作。 有关详细信息,请参阅在组织中安装和分发模板应用

  4. 在对话框中,选择“安装”

  5. 安装成功后,在“应用”列表中选择该应用将其打开。

  6. 验证测试应用是否具有示例数据。 若要进行任何更改,请返回到原始工作区中的应用。 更新测试应用,直到满意为止。

  7. 准备好将应用提升到预生产以在租户之外进行测试时,请返回“发布管理”窗格,然后选择“提升应用”。

    Screenshot of the Release Management pane with Promote app highlighted.

    注意

    应用提升后,将在组织外部变得公开可用。

    如果没有看到“提升应用”选项,请与你的 Power BI 管理员联系,让其在管理门户中授予模板应用开发权限

  8. 在对话框中,选择“提升”。

  9. 复制新 URL 以在租户外共享以供测试。 通过提交此链接,你还可以开启通过创建新的合作伙伴中心产品/服务在 AppSource 上分发应用的流程。

    仅向合作伙伴中心提交预生产链接。 在应用获得批准且你收到应用已在 AppSource 中发布的通知后,可在 Power BI 中将此包提升到生产。

  10. 当应用准备好通过 AppSource 进行生产或共享时,请返回“发布管理”窗格,然后选择“预生产”旁边的“提升应用”

  11. 选择“提升”。

    现在应用已投入生产,并已准备好分发。

    Screenshot of the Release Management pane with the app in production.

要让全球的 Power BI 用户广泛使用该应用,请将其提交到 AppSource。 有关详细信息,请参阅创建 Power BI 应用产品/服务

在安装期间自动配置参数

如果你是独立软件供应商并通过 Web 服务分发模板应用,那么可创建自动化,这样当客户在 Power BI 中安装应用时,会自动配置模板应用参数。 自动化配置可简化客户的操作并增加成功安装的可能性,因为客户不必提供自己可能不知道的详细信息。 有关详细信息,请参阅模板应用安装的自动化配置