啟用永續性篩選

在您為組織內嵌的報表中，啟用持續性篩選功能時，報表會保留其狀態，包括篩選、交叉分析篩選器和其他數據檢視變更。當用戶開啟報表時，儲存的用戶狀態會載入報表中。此外，如果已啟用持續性篩選，則使用者在不同的案例中取得相同的用戶狀態。

若要在內嵌案例中重設持續性篩選，您必須實作按鈕並使用 resetPersistentFilters API，或顯示動作列，以取得 Power BI 重設為動作列上預設 按鈕。

如何啟用永續性篩選

持續性篩選預設為停用。若要啟用永續性篩選，請遵循本節中的步驟。

    let config = {
        type: 'report',
        ...
        settings: {
            persistentFiltersEnabled: true
        }
    };

如果狀態存在，報表會以最新的用戶報表狀態載入。用戶的報告狀態會在 60 秒後自動儲存，而不會有任何變更。

注意

只會儲存現有篩選條件的更新。不會儲存 setFilters API 新增的新篩選。

將使用者的篩選、交叉分析篩選器和其他數據檢視變更重設為報表的默認狀態。

    resetPersistentFilters(): Promise<void>

儲存使用者的報表篩選、交叉分析篩選器和其他數據檢視變更。

    savePersistentFilters(): Promise<void>

如果報表上已套用篩選、交叉分析篩選器或其他數據檢視變更，則傳回使用者的篩選條件、交叉分析篩選器或其他數據檢視變更。如果停用持續性篩選，這會傳回 false。

您可以使用此 API 來判斷重設按鈕狀態。

    arePersistentFiltersApplied(): Promise<boolean>

持續性篩選只支援組織內嵌（用戶擁有數據）解決方案。