Abilitare i filtri permanenti

  • Articolo

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 oppure visualizzare la barra delle azioni per ottenere il pulsante di predefinito di Power BI Reset to default sulla barra delle azioni.

Come abilitare i filtri permanenti

I filtri permanenti sono disabilitati per impostazione predefinita. Per abilitare i filtri permanenti, seguire la procedura descritta in questa sezione.

  1. Verificare che i filtri permanenti siano abilitati nelle impostazioni del report nel servizio Power BI o nel desktop.

  2. Verificare che l'app Azure Active Directory (Azure AD) disponga delle autorizzazioni UserState.ReadWrite.All.

  3. Impostare la proprietà persistentFiltersEnabled su true.

    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 aggiunti dall'API setFilters non verranno salvati.

API filtri permanenti

Reimpostare i filtri permanenti

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 filtri persistenti

Salvare i filtri dei report, i filtri dei dati e altre modifiche della visualizzazione dati dell'utente.

    savePersistentFilters(): Promise<void>

Filtri permanenti applicati

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>

Considerazioni e limitazioni

I filtri permanenti sono supportati solo per l'incorporamento per la soluzione di dell'organizzazione (dati di proprietà dell'utente).

Contenuto correlato