Поделиться через


Включение постоянных фильтров

В отчетах, внедренных для вашей организации, когда включена функция постоянных фильтров, отчеты сохраняют свое состояние, включая фильтры, срезы и другие изменения представления данных. Когда пользователь открывает отчет, сохраненное состояние пользователя загружается в отчет. Кроме того, пользователь получает одно и то же состояние пользователя в разных сценариях, если включены постоянные фильтры.

Чтобы сбросить постоянные фильтры в сценарии внедрения, необходимо реализовать кнопку и использовать API или отобразить панель действий, чтобы получить кнопку Power BI для сброса до кнопки по умолчанию на панели действий.

Включение постоянных фильтров

По умолчанию постоянные фильтры отключены. Чтобы включить постоянные фильтры, выполните действия, описанные в этом разделе.

  1. Убедитесь, что постоянные фильтры включены в параметрах отчета в службе Power BI или на рабочем столе.

  2. Убедитесь, что приложение Azure Active Directory (Azure AD) имеет UserState.ReadWrite.All разрешения.

  3. Задайте для свойства persistentFiltersEnabled значение true.

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

Отчет загружается с состоянием последнего отчета пользователя, если оно существует. Состояние отчета пользователя автоматически сохраняется через 60 секунд без каких-либо изменений.

Заметка

Сохраняются только обновления существующих фильтров. Новые фильтры, добавленные API setFilters, не будут сохранены.

API-интерфейсы постоянных фильтров

Сброс постоянных фильтров

Сброс фильтров, срезов и других представлений данных пользователя в состояние отчета по умолчанию.

    resetPersistentFilters(): Promise<void>

Сохранение постоянных фильтров

Сохраните фильтры отчетов пользователя, срезы и другие изменения представления данных.

    savePersistentFilters(): Promise<void>

Примененные постоянные фильтры

Возвращает фильтры, срезы или другие изменения представления данных, примененные к отчету, если они существуют. Если постоянные фильтры отключены, это возвращает значение false.

Этот API можно использовать для определения состояния кнопки сброса.

    arePersistentFiltersApplied(): Promise<boolean>

Рекомендации и ограничения

Постоянные фильтры поддерживаются только для решения внедрения для вашей организации (пользователь владеет данными).