提交 Power BI 自訂視覺效果以供發行前先測試

將視覺效果發佈至 AppSource 之前，它必須通過本文所列的測試。 在提交視覺效果之前，請務必先測試視覺效果。 如果您的視覺效果未通過必要的測試案例，將會遭到拒絕。

如需發佈程式的詳細資訊，請參閱 將 Power BI 視覺效果發佈至合作夥伴中心 。

測試已發佈視覺效果的新版本

根據預設，Power BI 會從 AppSource 載入最新發佈的視覺效果版本，即使您從本機檔案匯入視覺效果也一樣。 版本號碼由下列格式的四位陣列成： X.X.X.X 。

測試或更新已發佈的視覺效果時，請確定您使用的是正確的視覺效果 版本，而不需變更 GUID 。 若要使用本機檔案版本覆寫 AppSource 版本，請在 Power BI Desktop 或 Power BI 服務中啟用開發人員模式。

重要

測試或偵錯 AppSource 中可用的新版視覺效果時， 請勿變更視覺效果 的 GUID。 請改用開發人員模式。

在 Power BI Desktop 中啟用開發人員模式

在 Power BI Desktop 中，開發人員模式僅適用于一個會話。 如果您開啟新的 Power BI Desktop 實例進行測試，您必須再次啟用開發人員模式。

若要啟用開發人員模式，請遵循下列步驟：

1. 開啟 Power BI Desktop。
2. 選取 [ 檔案 > 選項和設定]。
3. 選取選項。
4. 在 [選項] 視窗中，從 [目前檔案] 清單中，選取 [ 報表設定 ]。
5. 在 [開發人員模式] 中，選取 [開啟此會話 的開發人員模式] 選項。

在 Power BI 服務 中啟用開發人員模式

在Power BI 服務中，開發人員模式會保留每個使用者帳戶。 每當使用者從本機檔案載入套件時，Power BI 就會忽略視覺效果的 AppSource 版本。

若要在 Power BI 服務 中啟用開發人員模式，請遵循設定Power BI 服務中的指示 來開發視覺效果 。

一般測試案例

確認您的視覺效果通過一般測試案例。

測試案例	預期的結果
建立 具有 Category 和 Value 的 堆疊直條圖 。 將它轉換成視覺效果，然後回到直條圖。	這些轉換之後不會顯示任何錯誤。
建立具有三個 量值的量測計 。 將它轉換成您的視覺效果，然後轉換回 量測計 。	這些轉換之後不會顯示任何錯誤。
在視覺效果中選取專案。	其他視覺效果會反映選取專案。
選取其他視覺效果中的元素。	您的視覺效果會根據其他視覺效果中的選取專案顯示已篩選的資料。
檢查 min/max dataViewMapping 條件。	欄位貯體可以接受多個欄位、單一欄位，或是由其他貯體決定。 視覺效果的功能中必須正確設定 min/max dataViewMapping 條件。
依不同順序移除所有欄位。	視覺效果會適當地清除，因為欄位會依任意順序移除。 主控台或瀏覽器沒有錯誤。
使用每個可能的貯體組態開啟 [ 格式] 窗格。	此測試不會觸發 Null 參考例外狀況。
使用視覺效果、頁面和報表層級的 [ 篩選 ] 窗格來篩選資料。	套用篩選之後，工具提示是正確的。 工具提示會顯示篩選的值。
使用 交叉分析篩選器 篩選資料。	套用篩選之後，工具提示是正確的。 工具提示會顯示篩選的值。
使用已發佈的視覺效果篩選資料。 例如，選取圓形圖配量或資料行。	套用篩選之後，工具提示是正確的。 工具提示會顯示篩選的值。
如果支援交叉篩選，請確認篩選正常運作。	已套用的選取範圍會篩選報表的這個頁面上的其他視覺效果。
選取 Ctrl 、 Alt 和 Shift 鍵。	沒有未預期的行為出現。
將 [ 檢視模式 ] 變更為 [實際大小 ]、 [調整為頁面 ]，以及 [調整為寬度 ]。	滑鼠座標正確無誤。
調整視覺效果的大小。	視覺效果會正確回應調整大小。
將報表大小設定為最小值。	沒有顯示錯誤。
確定捲軸正常運作。	如有必要，捲軸應該存在。 檢查捲軸大小。 捲軸不應該太寬或高。 捲軸的位置和大小必須與視覺效果的其他元素一致。 確認視覺效果的不同大小需要捲軸。
將視覺效果釘選 到儀表板 。	視覺效果會正確顯示。
將多個版本的視覺效果新增至單一報表頁面。	所有版本的視覺效果顯示並正常運作。
將多個視覺效果版本新增至多個報表頁面。	所有版本的視覺效果顯示並正常運作。
在報表頁面之間切換。	視覺效果會正確顯示。
測試視覺效果的 [閱讀檢視] 和 [編輯] 檢視。	所有函式都能正常運作。
如果您的視覺效果使用動畫，請新增、變更和刪除視覺效果的元素。	視覺元素的動畫正常運作。
開啟 [ 屬性 ] 窗格。 開啟和關閉屬性、輸入自訂文字、強調可用的選項，以及輸入不正確的資料。	視覺效果會正確回應。
儲存報表並重新開啟。	所有屬性設定都會保存。
切換報表中的頁面，然後切換回 。	所有屬性設定都會保存。
測試視覺效果的所有功能，包括視覺效果提供的不同選項。	所有顯示和功能都正常運作。
測試所有數值、日期和字元資料類型，如下列測試所示。	所有資料的格式都正確。
使用格式檢閱工具提示值、軸標籤、資料標籤和其他視覺元素的格式設定。	所有元素的格式都正確。
確認資料標籤使用格式字串。	所有資料標籤的格式都正確。
在工具提示中開啟和關閉數值的自動格式化。	工具提示會正確顯示值。
使用不同類型的資料來測試資料項目目，包括來自模型的數值、文字、日期時間，以及不同的格式字串。 測試不同的資料磁片區，例如數千個數據列、一列和兩個數據列。	所有顯示和功能都正常運作。
為視覺效果提供不正確的資料，例如 Null、無限大、負值，以及錯誤的實數值型別。	所有顯示和功能都正常運作。

選擇性瀏覽器測試

AppSource 小組會驗證最新 Windows 版本的 Google Chrome、Microsoft Edge 和 Mozilla Firefox 瀏覽器上的視覺效果。 您可以選擇性地在下列瀏覽器中測試您的視覺效果。

測試案例	預期的結果
Windows
Google Chrome （舊版）	所有顯示和功能都正常運作。
Mozilla Firefox （舊版）	所有顯示和功能都正常運作。
Microsoft Edge （舊版）	所有顯示和功能都正常運作。
Microsoft Internet Explorer 11 （選用）	所有顯示和功能都正常運作。
macOS
Chrome （舊版）	所有顯示和功能都正常運作。
Firefox （舊版）	所有顯示和功能都正常運作。
Safari （舊版）	所有顯示和功能都正常運作。
Linux
Firefox （最新版本和舊版）	所有顯示和功能都正常運作。
行動 iOS
Apple Safari iPad （舊版 Safari）	所有顯示和功能都正常運作。
Chrome iPad （最新 Safari 版本）	所有顯示和功能都正常運作。
行動裝置 Android
Chrome （最新版本和舊版）	所有顯示和功能都正常運作。

桌面測試

在目前版本的 Power BI Desktop 中測試視覺效果。

測試案例	預期的結果
測試視覺效果的所有功能。	所有顯示和功能都正常運作。
使用 Power BI Desktop 中的 [發佈 ] 按鈕，匯入、儲存、開啟檔案，然後發佈至 Power BI Web 服務。	所有顯示和功能都正常運作。
藉由增加或減少精確度，將數值格式字串變更為具有零個小數位數或三個小數位數。	視覺效果會正確顯示。

效能測試

您的視覺效果應該在可接受的層級執行。 使用開發人員工具來驗證其效能。 請勿依賴視覺提示和主控台時間記錄。

測試案例	預期的結果
建立具有許多視覺元素的視覺效果。	視覺效果應該會正常執行，而不會凍結應用程式。 動畫速度、調整大小、篩選和選取等元素應該不會有效能問題。 請查看這些 秘訣以獲得最佳效能 。

相關內容

• 將 Power BI 視覺效果發佈至合作夥伴中心
• 取得 Power BI 視覺效果認證
• 建立品質 Power BI 自訂視覺效果的效能秘訣

其他問題嗎？ 詢問Power BI 社群 。