经认证的 Power BI 视觉对象

已认证的 Power BI 视觉对象是 AppSource 中满足 Microsoft Power BI 团队代码要求和测试要求的视觉对象。 执行的测试旨在检查视觉对象是否会访问外部服务或资源。 但 Microsoft 不是第三方自定义视觉对象的作者，建议客户直接与作者联系，验证这些视觉对象的功能。

经认证的 Power BI 视觉对象可以像任何其他 Power BI 视觉对象一样使用。 它们提供比未经认证的视觉效果更多的功能。 例如，可将视觉对象导出到 PowerPoint，或者，如果用户订阅了报表页，则可在收到的电子邮件中的显示视觉对象。

认证过程是可选的。 由开发人员决定是否要对其视觉对象进行认证。 未经认证的 Power BI 视觉对象不一定是不安全的。 某些 Power BI 视觉对象未通过认证，因为它们不符合一项或多项认证要求。 例如，连接到外部服务的 Power BI 地图视觉对象，或使用商业库的 Power BI 视觉对象，均无法进行认证。

删除认证

Microsoft 保留自行决定是否从经认证的列表中删除视觉对象的权利。

认证要求

若要使 Power BI 视觉对象通过认证，那么它必须满足本节中所列的要求。

一般要求

Power BI 视觉对象必须由合作伙伴中心批准。 建议先在 AppSource 中发布 Power BI 视觉对象，然后请求进行认证。 若要了解如何将 Power BI 视觉对象发布到 AppSource，请参阅将 Power BI 视觉对象发布到合作伙伴中心。

在提交 Power BI 视觉对象进行认证前，请确认：

• 视觉对象符合 Power BI 视觉对象指南
• 视觉对象通过所有必需的测试
• 编译后的包与提交的包完全匹配

代码存储库要求

尽管你无需在 GitHub 中公开共享代码，但代码存储库必须可供 Power BI 团队审阅。 实现此目的的最佳方式是在 GitHub 中提供源代码（JavaScript 或 TypeScript）。

存储库必须包含：

• 仅适用于一个 Power BI 视觉对象的代码。 它不能包含多个 Power BI 视觉对象的代码或不相关的代码。
• 名为 certification（需小写）的分支 。 此分支中的源代码必须与提交的包匹配。 如果正在重新提交 Power BI 视觉对象，则只能在下一次提交过程中更新此代码。

如果 Power BI 视觉对象使用专用 npm 包或 git 子模块，你还必须提供对包含此代码的存储库的访问权限。

若要了解 Power BI 视觉对象存储库的外观，请查看 GitHub 存储库中的 Power BI 视觉对象示例条形图。

文件要求

使用最新版本的 API 编写 Power BI 视觉对象。

存储库必须包含以下文件：

• .gitignore - 将 node_modules、.tmp 和 dist 添加到此文件。 代码不得包含 node_modules、.tmp 或 dist 文件夹。
• capabilities.json - 如果你提交的是现有 Power BI 视觉对象的较新版本，并对该文件中的属性进行了更改，请验证它们不会中断现有用户的报表。
• pbiviz.json
• package.json： 视觉对象必须已安装以下包：
  • "typescript"
  • "eslint"
  • "eslint-plugin-powerbi-visuals"
  • 文件必须包含用于运行 Linter 的命令 - "eslint": "npx eslint . --ext .js,.jsx,.ts,.tsx"
• package-lock.json
• tsconfig.json

命令要求

请确保以下命令不会返回任何错误。

• npm install

• pbiviz package

• npm audit - 不得返回任何具有高级别或中等级别的警告。

• 具有所需配置的 ESlint。 此命令不得返回任何 Lint 错误。

  注意

  我们正在从 TSlint 迁移到 ESLint。 使用 TSlint 的视觉对象将在 2023 年 3 月之前接受认证。 之后，将需要 ESlint。

编译要求

使用最新版本的 powerbi-visuals-tools 编写 Power BI 视觉对象。

请用 pbiviz package 编译 Power BI 视觉对象。 如果你使用自己的生成脚本，请提供 npm run package 自定义生成命令。

源代码要求

确保遵循 Power BI 视觉对象的其他认证策略列表。 如果提交未遵循这些指导原则，你将收到合作伙伴中心的拒绝电子邮件，其中包含此链接中列出的策略编号。

请遵循此处列出的代码要求，确保代码符合 Power BI 认证策略。

必须

• 只能使用可供审核的公用 OSS 组件，例如公用 JavaScript 或 TypeScript 库。
• 代码必须支持呈现事件 API。
• 确保已安全操作 DOM。 在将用户输入或用户数据添加到 DOM 之前，对其使用清理。
• 将此示例报表用作测试数据集。

不允许

• 访问外部服务或资源。 例如，任何 HTTP/S 或 WebSocket 请求都不能从 Power BI 外部发送到任何服务。 因此，功能设置中的 WebAccess 权限应为空或省略。
• 使用 innerHTML 或 D3.html(user data or user input)。
• 浏览器控制台中的任何输入数据均没有 JavaScript 错误/异常。
• 任意或动态代码（如 eval()）、不安全使用 settimeout()、requestAnimationFrame()、setinterval(user input function) 及用户输入或用户数据。
• 缩小的 JavaScript 文件或项目。

提交 Power BI 视觉对象进行认证

现在，你已准备好提交请求，让 Power BI 团队对 Power BI 视觉对象进行认证。

提示

Power BI 认证过程可能需要一段时间。 如果要创建新的 Power BI 视觉对象，建议在请求 Power BI 认证之前，通过合作伙伴中心发布 Power BI 视觉对象。 这样可以确保不会延迟视觉对象的发布。

请求 Power BI 认证的步骤：

1. 登录到合作伙伴中心。
2. 在“概述”页 上，选择你的 Power BI 视觉对象，然后转到“产品” 设置页。
3. 选中“请求 Power BI 认证” 复选框。
4. 在“审阅并发布” 页的“认证说明” 文本框中，提供指向源代码的链接以及访问它所需的凭据。

专用存储库提交过程

如果使用的是诸如 GitHub 之类的专用存储库来提交 Power BI 视觉对象进行认证，请按照本节中的说明进行操作。

1. 为验证团队创建一个新帐户。
2. 为帐户配置双因素身份验证。
3. 生成一组新的恢复代码。
4. 提交 Power BI 视觉对象时，请确保提供以下详细信息：
   • 存储库链接
   • 登录凭据（包括密码）
   • 恢复代码
   • 帐户的只读权限 (pbicvsupport)

认证 Power BI 视觉对象徽章

通过认证后，Power BI 视觉对象会获得一个指明 Power BI 视觉对象已通过认证的指定徽章。

AppSource 中的认证 Power BI 视觉对象

• 当某人在 AppSource 中联机搜索 Power BI 视觉对象时，会看到视觉对象的卡上有黄色小徽章，这表明它是经过认证的 Power BI 视觉对象。

  

• 单击 AppSource 中的 Power BI 视觉对象卡后，会显示标题为“经 PBI 认证”的黄色徽章，表明此 Power BI 视觉对象已通过认证。

  

Power BI 接口中的认证 Power BI 视觉对象

• 从 Power BI（Desktop 或服务）中导入 Power BI 视觉对象时，会显示蓝色徽章，表明此 Power BI 视觉对象已通过认证。

  

• 可以通过选择“Power BI 认证” 筛选器选项，只显示认证 Power BI 视觉对象。

发布时间线

部署到 AppSource 的过程可能需要一些时间。 完成此过程后，即可从 AppSource 下载 Power BI 视觉对象。

用户何时才能下载我的视觉对象？

• 如果提交新的 Power BI 视觉对象，则用户将能够在你收到来自 AppSource 的电子邮件后的几个小时内下载视觉对象。

• 如果你提交了现有 Power BI 视觉对象的更新，则用户将能够在你提交之日起的两周内下载该更新。

  注意

  AppSource 中的“版本”字段将更新为 AppSource 批准 Power BI 的当天日期（大约在你提交视觉对象后的一周进行更新） 。 用户将能够下载更新后的视觉对象，但更新后的功能将不会生效。 视觉对象的新功能将在大约两周后才会在用户报表中生效。

我的 Power BI 视觉对象何时显示证书徽章？

认证徽章应会在提交获批后的三周内可见。

相关内容

• 有关认证的视觉对象的常见问题。
• 发布 Power BI 视觉对象的指南

更多问题？ 尝试参与 Power BI 社区。