Freigeben über

Aktivieren von beständigen Filtern

  • Artikel

In Berichten, die Sie für Ihre Organisation einbetten, behalten Berichte ihren Status bei, wenn das Feature für persistente Filter aktiviert ist, einschließlich Filter, Datenschnitten und anderen Datenansichtsänderungen. Wenn der Benutzer einen Bericht öffnet, wird der gespeicherte Benutzerstatus in den Bericht geladen. Außerdem erhält der Benutzer denselben Benutzerstatus in den verschiedenen Szenarien, wenn persistente Filter aktiviert sind.

Um die persistenten Filter in einem Einbettungsszenario zurückzusetzen, müssen Sie eine Schaltfläche implementieren und die resetPersistentFilters-API verwenden oder die Aktionsleiste anzeigen, um die Power BI-Auf die Standardschaltfläche zurücksetzen auf der Aktionsleiste abzurufen.

So aktivieren Sie persistente Filter

Beständige Filter sind standardmäßig deaktiviert. Führen Sie die Schritte in diesem Abschnitt aus, um persistente Filter zu aktivieren.

  1. Überprüfen Sie, ob persistente Filter in den Berichtseinstellungen im Power BI-Dienst oder Desktop aktiviert sind.

  2. Stellen Sie sicher, dass Ihre Azure Active Directory (Azure AD)-App über UserState.ReadWrite.All Berechtigungen verfügt.

  3. Legen Sie die persistentFiltersEnabled-Eigenschaft auf truefest.

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

Der Bericht wird mit dem Status des aktuellen Benutzers geladen, wenn der Status vorhanden ist. Der Berichtsstatus des Benutzers wird automatisch nach 60 Sekunden ohne Änderung gespeichert.

Anmerkung

Es werden nur Aktualisierungen vorhandener Filter gespeichert. Neue Filter, die von der setFilters-API hinzugefügt werden, werden nicht gespeichert.

ApIs für persistente Filter

Persistente Filter zurücksetzen

Setzen Sie die Filter, Datenschnitte und andere Datenansichtsänderungen eines Benutzers auf den Standardzustand des Berichts zurück.

    resetPersistentFilters(): Promise<void>

Speichern persistenter Filter

Speichern Sie die Berichtsfilter, Datenschnitte und andere Datenansichtsänderungen des Benutzers.

    savePersistentFilters(): Promise<void>

Angewendete persistente Filter

Gibt die Filter, Datenschnitte oder andere Datenansichtsänderungen eines Benutzers zurück, die auf den Bericht angewendet wurden, sofern vorhanden. Wenn persistente Filter deaktiviert sind, gibt dies "false" zurück.

Sie können diese API verwenden, um den Zustand der Zurücksetzungsschaltfläche zu bestimmen.

    arePersistentFiltersApplied(): Promise<boolean>

Überlegungen und Einschränkungen

Persistente Filter werden nur für die Einbettung für Ihre Organisation (Benutzer besitzen Daten) Lösung unterstützt.

Verwandte Inhalte