認證的Power BI 視覺效果

認證的Power BI視覺效果是AppSource中的Power BI 視覺效果,符合 Microsoft Power BI 小組程式代碼需求和測試。 執行的測試是設計來檢查視覺效果是否無法存取外部服務或資源。 不過,Microsoft 不是第三方自定義視覺效果的作者,我們建議客戶直接連絡作者,以確認這些視覺效果的功能。

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

認證程式是選擇性的。 開發人員必須決定他們是否要經過視覺認證。 未通過認證的 Power BI 視覺效果不一定不安全。 某些 Power BI 視覺效果未通過認證,因為它們不符合一或多個 認證需求。 例如,無法認證連線到外部服務的地圖 Power BI 視覺效果,或使用商業連結庫的 Power BI 視覺效果。

拿掉認證

Microsoft 會自行保留從認證清單中移除視覺效果的權利。

認證需求

若要獲得 Power BI 視覺效果認證,它必須符合本節所列的需求。

一般需求

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

提交 Power BI 視覺效果以進行認證之前,請確認:

程序代碼存放庫需求

雖然您不需要在 GitHub 中公開共享程式代碼,但程式代碼存放庫必須可供 Power BI 小組檢閱。 最好的方法是在 GitHub 中提供原始程式碼 (JavaScript 或 TypeScript)。

存放函庫必須包含:

  • 只有一個Power BI視覺效果的程式代碼。 它不能包含多個 Power BI 視覺效果的程式代碼,或不相關的程式碼。
  • 名為 certification 的分支(必要小寫)。 此分支中的原始程式碼必須符合提交的套件。 如果您重新提交Power BI 視覺效果,則只能在下一個提交程式期間更新此程式代碼。

如果您的 Power BI 視覺效果使用私人 npm 套件或 git 子模組,您也必須提供包含此程式碼的存放庫存取權。

若要瞭解 Power BI 視覺效果存放庫的外觀,請檢閱 Power BI 視覺效果範例條形圖GitHub 存放庫。

檔案需求

使用最新版本的 API 來撰寫 Power BI 視覺效果。

存放庫必須包含下列檔案:

  • .gitignore - 將 、 .tmpdist 新增node_modules至此檔案。 程序代碼不能包含 node_modules.tmpdist 資料夾。
  • capabilities.json - 如果您要提交具有此檔案中屬性變更的現有 Power BI 視覺效果較新版本,請確認它們不會中斷現有使用者的報表。
  • pbiviz.json
  • package.json。 視覺效果必須已安裝下列套件:
  • 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()、 和使用者輸入或用戶數據不安全的使用requestAnimationFrame()settimeout()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 certified Power BI visual

  • 在 AppSource 中按兩下 Power BI 視覺效果卡片時,標題為 PBI 認證的 黃色徽章表示此 Power BI 視覺效果已通過認證。

    App page certified Power BI visual

Power BI 介面中認證的 Power BI 視覺效果

  • 從 Power BI (Desktop 或服務) 匯入 Power BI 視覺效果時,藍色徽章表示 Power BI 視覺效果已通過認證。

    Power BI interface certified Power BI visual

  • 您可以選取 [Power BI 認證 篩選] 選項,只顯示經過認證的 Power BI 視覺效果。

發行集時程表

部署至 AppSource 的程式可能需要一點時間。 當您完成此程式時,Power BI 視覺效果將可從 AppSource 下載。

使用者何時能夠下載我的視覺效果?

  • 如果您提交新的Power BI 視覺效果,使用者在收到AppSource的電子郵件後數小時就能下載。

  • 如果您已提交現有Power BI視覺效果的更新,使用者就能夠在提交后的兩周內下載。

    注意

    AppSource 中的版本字段將會隨著您 Power BI 在提交視覺效果大約一周後核准的一天更新。 使用者將能夠下載更新的視覺效果,但更新的功能將不會生效。 視覺效果的新功能會在大約兩周後影響用戶的報表。

我的 Power BI 視覺效果何時會顯示認證徽章?

認證徽章應在提交核准后的三周內顯示。

更多問題嗎? 請嘗試 Power BI 社群。