Sdílet prostřednictvím


Povolení trvalých filtrů

Když je funkce trvalých filtrů povolená, v sestavách, které vložíte do organizace, si sestavy zachovají svůj stav, včetně filtrů, průřezů a dalších změn zobrazení dat. Když uživatel otevře sestavu, uložený stav uživatele se do sestavy načte. Uživatel také získá stejný stav uživatele v různých scénářích, pokud jsou povolené trvalé filtry.

Pokud chcete obnovit trvalé filtry ve scénáři vložení, musíte implementovat tlačítko a použít resetPersistentFilters rozhraní API nebo zobrazit panel akcí, abyste získali tlačítko Power BI Obnovit výchozí na panelu akcí.

Jak povolit trvalé filtry

Trvalé filtry jsou ve výchozím nastavení zakázané. Pokud chcete povolit trvalé filtry, postupujte podle kroků v této části.

  1. Ověřte, že jsou v nastavení sestavy ve službě Power BI nebo desktopu povolené trvalé filtry.

  2. Ověřte, že vaše aplikace Azure Active Directory (Azure AD) má UserState.ReadWrite.All oprávnění.

  3. Nastavte vlastnost persistentFiltersEnabled na true.

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

Sestava se načte se stavem sestavy nejnovějšího uživatele, pokud stav existuje. Stav sestavy uživatele se automaticky uloží po 60 sekundách bez jakékoli změny.

Poznámka

Uloží se jenom aktualizace existujících filtrů. Nové filtry přidané rozhraním API setFilters se neuloží.

Rozhraní API trvalých filtrů

Resetování trvalých filtrů

Resetování filtrů, průřezů a dalších zobrazení dat uživatele ve výchozím stavu sestavy

    resetPersistentFilters(): Promise<void>

Uložení trvalých filtrů

Uložte filtry sestavy, průřezy a další změny zobrazení dat uživatele.

    savePersistentFilters(): Promise<void>

Použité trvalé filtry

Vrátí změny uživatelského filtru, průřezů nebo jiných změn zobrazení dat použitých v sestavě, pokud existují. Pokud jsou trvalé filtry zakázané, vrátí se hodnota false.

Toto rozhraní API můžete použít k určení stavu tlačítka resetování.

    arePersistentFiltersApplied(): Promise<boolean>

Důležité informace a omezení

Trvalé filtry se podporují jenom pro vložení pro řešení vaší organizace (uživatel vlastní data).