提交 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 實例進行測試,您必須再次啟用開發人員模式。
若要啟用開發人員模式,請遵循下列步驟:
- 開啟 Power BI Desktop。
- 選取 [ 檔案 > 選項和設定]。
- 選取選項。
- 在 [選項] 視窗中,從 [目前檔案] 清單中,選取 [ 報表設定 ]。
- 在 [開發人員模式] 中,選取 [開啟此會話 的開發人員模式] 選項。
在 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 社群 。
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應