經認證的 Power BI 視覺效果

文章
05/03/2025

經認證的 Power BI 視覺效果是 AppSource 中的 Power BI 視覺效果，符合 Microsoft Power BI 小組程式碼需求和測試。我們執行這些測試的目的是檢查視覺元件不會存取外部服務或資源。不過，Microsoft 並非協力廠商自訂視覺效果的作者，因此我們建議客戶直接和作者連絡，以確認這些視覺效果的功能。

經認證的 Power BI 視覺效果可以像任何其他 Power BI 視覺效果一樣使用。其可提供比非認證視覺效果更多的功能。例如，您可以將其匯出至 PowerPoint，或是在使用者訂閱報表頁面時所收到的電子郵件中顯示視覺效果。

認證程序是選擇性的。概由開發人員決定是否要對其視覺效果進行認證。未經認證的 Power BI 視覺效果不一定就不安全。有些 Power BI 視覺效果未經過認證，因為其不符合一或多個認證需求 $英文$ 。例如，Power BI 視覺效果中包含地圖時，若連接至外部服務，或者使用商業程式庫，都無法獲得認證。

移除認證

Microsoft 保留可自行斟酌是否將視覺效果從認證清單中移除的權利。

認證需求

若要讓您的 Power BI 視覺效果通過認證，其必須符合此節所列的需求。

一般需求

Power BI 視覺效果必須由合作夥伴中心核准。在要求認證之前，建議您在 AppSource 中發佈 Power BI 視覺效果。若要了解如何將 Power BI 視覺效果發佈至 AppSource，請參閱將 Power BI 視覺效果發佈至合作夥伴中心。

提交 Power BI 視覺效果進行認證之前，請先確認：

視覺效果不是 R 視覺效果
視覺效果符合 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 錯誤。

編譯需求

使用最新版本的 powerbi-visuals-tools 來撰寫 Power BI 視覺效果。

使用 pbiviz package 來編譯您的 Power BI 視覺效果。如果您要使用自己的組建指令碼，請提供 npm run package 自訂組建命令。

原始程式碼需求

請確保依照 Power BI 視覺效果其他認證原則清單進行。如果您的提交未遵循這些指導方針，將會收到來自合作夥伴中心的拒絕電子郵件，其中包含此連結中列出的原則號碼。

請遵循在此列出的程式碼需求，以確保您的程式碼符合 Power BI 認證原則。

必要

只能使用公用的可檢閱 OSS 元件，例如公用 JavaScript 或 TypeScript 程式庫。
程式碼必須支援轉譯事件 API。
請確保安全地操作 DOM。請先對使用者輸入或使用者資料使用清理，再將其新增至 DOM。
使用範例報告作為測試資料集。

不允許

存取外部服務或資源。例如，不能從 Power BI 將任何 HTTP/S 或 WebSocket 要求發送到任何服務。因此，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 認證：

登入合作夥伴中心。
在 [概觀] 頁面上選擇您的 Power BI 視覺效果，然後移至 [產品設定] 頁面。
選取 [要求 Power BI 認證] 核取方塊。
在 [檢閱並發佈] 頁面上的 [認證注意事項] 文字方塊中，提供原始程式碼的連結和存取該程式碼所需的認證。

私人存放庫提交程序

如果您使用 GitHub 之類的私人存放庫來提交您的 Power BI 視覺效果進行認證，請遵循此節中的指示。

針對驗證小組建立新的帳戶。
針對您的帳戶設定雙因素驗證 $英文$ 。
產生一組新的復原碼 $英文$ 。
提交 Power BI 視覺效果時，請確保提供下列詳細資料：
- 存儲庫的連結
- 登入認證 (包括密碼)
- 復原程式碼
- 我們帳戶 (pbicvsupport) 的唯讀權限