Udostępnij za pośrednictwem

Włączanie filtrów trwałych

  • Artykuł

W raportach osadzanych dla organizacji po włączeniu funkcji filtrów trwałych raporty zachowują ich stan, w tym filtry, fragmentatory i inne zmiany widoku danych. Gdy użytkownik otworzy raport, zapisany stan użytkownika zostanie załadowany do raportu. Ponadto użytkownik otrzymuje ten sam stan użytkownika w różnych scenariuszach, jeśli włączono filtry trwałe.

Aby zresetować filtry trwałe w scenariuszu osadzania, musisz zaimplementować przycisk i użyć interfejsu API resetPersistentFilters lub wyświetlić pasek akcji, aby uzyskać przycisk Resetuj do domyślnych usługi Power BI na pasku akcji.

Jak włączyć filtry trwałe

Filtry trwałe są domyślnie wyłączone. Aby włączyć filtry trwałe, wykonaj kroki opisane w tej sekcji.

  1. Sprawdź, czy filtry trwałe są włączone w ustawieniach raportu w usłudze Power BI lub programie Desktop.

  2. Sprawdź, czy aplikacja usługi Azure Active Directory (Azure AD) ma uprawnienia UserState.ReadWrite.All.

  3. Ustaw właściwość persistentFiltersEnabled na wartość true.

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

Raport jest ładowany ze stanem raportu najnowszego użytkownika, jeśli stan istnieje. Stan raportu użytkownika jest automatycznie zapisywany po 60 sekundach bez żadnej zmiany.

Nuta

  • Zapisywane są tylko aktualizacje istniejących filtrów. Nowe filtry są dodawane przez interfejs API setFilters nie są zapisywane.
  • Nie można zmienić filtrów trwałych po załadowaniu raportu. Aby zmienić stan filtrów trwałych, zresetuj element iframe, wywołując powerbi.reset(element), a następnie ponownie osadzaj raport.

Interfejsy API filtrów trwałych

Resetowanie filtrów trwałych

Zresetuj filtry, fragmentatory i inne zmiany widoku danych w domyślnym stanie raportu.

    resetPersistentFilters(): Promise<void>

Zapisywanie filtrów trwałych

Zapisz filtry, fragmentatory i inne zmiany widoku danych użytkownika.

    savePersistentFilters(): Promise<void>

Zastosowane filtry trwałe

Zwraca filtry, fragmentatory lub inne zmiany widoku danych zastosowane w raporcie, jeśli istnieją. Jeśli filtry trwałe są wyłączone, zwraca wartość false.

Za pomocą tego interfejsu API można określić stan przycisku resetowania.

    arePersistentFiltersApplied(): Promise<boolean>

Zagadnienia i ograniczenia

Filtry trwałe są obsługiwane tylko w przypadku rozwiązania osadzania dla organizacji (użytkownik jest właścicielem danych).

Powiązana zawartość