Aktivieren von beständigen Filtern
In Berichten, die Sie für Ihre Organisation einbetten, behalten Berichte ihren Status, einschließlich Filter, Datenschnitten und anderen Datenansichtsänderungen, wenn das Feature für beständige Filter aktiviert ist. Wenn Ihr Benutzer einen Bericht öffnet, wird der gespeicherte Benutzerzustand in den Bericht geladen. Außerdem erhält der Benutzer denselben Benutzerstatus in den verschiedenen Szenarien, wenn beständige Filter aktiviert sind.
Um die beständigen Filter in einem Einbettungsszenario zurückzusetzen, müssen Sie eine Schaltfläche implementieren und die API verwenden resetPersistentFilters
oder die Aktionsleiste anzeigen, um die Power BI-Standardschaltfläche auf der Aktionsleiste abzurufen.
Aktivieren von beständigen Filtern
Beständige Filter sind standardmäßig deaktiviert. Führen Sie die Schritte in diesem Abschnitt aus, um beständige Filter zu aktivieren.
Überprüfen Sie, ob beständige Filter in den Berichtseinstellungen im Power BI-Dienst oder Desktop aktiviert sind.
Überprüfen Sie, ob Ihre Azure Active Directory -App (Azure AD) Berechtigungen hat
UserState.ReadWrite.All
.Setzen Sie die
persistentFiltersEnabled
-Eigenschaft auftrue
.
let config = {
type: 'report',
...
settings: {
persistentFiltersEnabled: true
}
};
Der Bericht wird mit dem Status des neuesten Benutzers geladen, wenn der Zustand vorhanden ist. Der Berichtstatus des Benutzers wird automatisch nach 60 Sekunden gespeichert, ohne dass sich dies ändert.
Hinweis
Nur Updates für vorhandene Filter werden gespeichert. Neue Filter, die von der setFilters
API hinzugefügt werden, werden nicht gespeichert.
ApIs für beständige Filter
Zurücksetzen von beständigen Filtern
Setzen Sie die Filter, Datenschnitte und andere Datenansichtsänderungen des Berichts auf den Standardzustand des Berichts zurück.
resetPersistentFilters(): Promise<void>
Speichern von beständigen Filtern
Speichern Sie die Berichtsfilter, Datenschnitte und andere Datenansichtsänderungen des Benutzers.
savePersistentFilters(): Promise<void>
Angewendete beständige Filter
Gibt die Filter, Datenschnitte oder andere Datenansichtsänderungen eines Benutzers zurück, die auf den Bericht angewendet werden, sofern vorhanden. Wenn beständige Filter deaktiviert sind, gibt dies false zurück.
Sie können diese API verwenden, um den Status der Zurücksetzenschaltfläche zu bestimmen.
arePersistentFiltersApplied(): Promise<boolean>
Einschränkungen
Beständige Filter werden nur für die Einbettung ihrer Organisation unterstützt (Benutzer besitzt Daten) Lösung.