Abilitare filtri persistenti
Nei report incorporati per l'organizzazione, quando la funzionalità filtri persistenti è abilitata, i report mantengono lo stato, inclusi filtri, filtri dei dati e altre modifiche alla visualizzazione dati. Quando l'utente apre un report, lo stato utente salvato viene caricato nel report. Inoltre, l'utente ottiene lo stesso stato utente nei diversi scenari se i filtri persistenti sono abilitati.
Per reimpostare i filtri persistenti in uno scenario di incorporamento, è necessario implementare un pulsante e usare l'API resetPersistentFilters oppure visualizzare la barra delle azioni per ottenere il pulsante Reimpostazione di Power BI per impostazione predefinita sulla barra delle azioni.
Come abilitare filtri persistenti
I filtri persistenti sono disabilitati per impostazione predefinita. Per abilitare i filtri persistenti, seguire la procedura descritta in questa sezione.
Verificare che i filtri persistenti siano abilitati nelle impostazioni del report nel servizio Power BI o desktop.
Verificare che l'app Azure Active Directory (Azure AD) disponga
UserState.ReadWrite.Alldelle autorizzazioni.Impostare la proprietà
persistentFiltersEnabledsutrue.
let config = {
type: 'report',
...
settings: {
persistentFiltersEnabled: true
}
};
Il report viene caricato con lo stato del report dell'utente più recente, se lo stato esiste. Lo stato del report dell'utente viene salvato automaticamente dopo 60 secondi, senza alcuna modifica.
Nota
Vengono salvati solo gli aggiornamenti ai filtri esistenti. Non verranno salvati nuovi filtri aggiunti dall'API setFilters .
API filtri persistenti
Reimpostare i filtri persistenti
Reimpostare i filtri, i filtri dei dati e altri filtri dei dati di un utente cambiano allo stato predefinito del report.
resetPersistentFilters(): Promise<void>
Salvare filtri persistenti
Salvare i filtri dei report, i filtri dei dati e altre modifiche della visualizzazione dati dell'utente.
savePersistentFilters(): Promise<void>
Filtri persistenti applicati
Restituisce i filtri, i filtri dei dati o altre modifiche della visualizzazione dati applicate al report, se presenti. Se i filtri persistenti sono disabilitati, restituisce false.
È possibile usare questa API per determinare lo stato del pulsante di reimpostazione.
arePersistentFiltersApplied(): Promise<boolean>
Limitazioni
I filtri persistenti sono supportati solo per la soluzione incorporamento per l'organizzazione (dati proprietari dell'utente ).