Leggere in inglese

Condividi tramite


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 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 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.

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).