Abilitare i filtri permanenti
Nei report incorporati per l'organizzazione, quando la funzionalità filtri permanenti è 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 permanenti sono abilitati.
Per reimpostare i filtri permanenti in uno scenario di incorporamento, è necessario implementare un pulsante e usare l'API
I filtri permanenti sono disabilitati per impostazione predefinita. Per abilitare i filtri permanenti, seguire la procedura descritta in questa sezione.
Verificare che i filtri permanenti siano abilitati nelle impostazioni del report nel servizio Power BI o nel desktop.
Verificare che l'app Azure Active Directory (Azure AD) disponga delle autorizzazioni
UserState.ReadWrite.All
.Impostare la proprietà
persistentFiltersEnabled
sutrue
.
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. I nuovi filtri vengono aggiunti dall'API
setFilters
non vengono salvati. - Non è possibile modificare i filtri permanenti dopo il caricamento del report. Per modificare lo stato dei filtri permanenti, reimpostare l'iframe chiamando
powerbi.reset(element)
e quindi incorporare di nuovo il report.
Reimpostare i filtri, i filtri dei dati e altre modifiche della visualizzazione dati di un utente allo stato predefinito del report.
resetPersistentFilters(): Promise<void>
Salvare i filtri dei report, i filtri dei dati e altre modifiche della visualizzazione dati dell'utente.
savePersistentFilters(): Promise<void>
Restituisce filtri, filtri dei dati o altre modifiche alla visualizzazione dati applicate al report, se presenti. Se i filtri permanenti sono disabilitati, restituisce false.
È possibile usare questa API per determinare lo stato del pulsante di reimpostazione.
arePersistentFiltersApplied(): Promise<boolean>
I filtri permanenti sono supportati solo per l'incorporamento per la soluzione di dell'organizzazione (dati di proprietà dell'utente).