Usare la barra delle azioni per migliorare l'esperienza utente

Quando si incorpora un report per l'organizzazione, è necessario che gli utenti dell'applicazione accedono a Power BI per visualizzare il contenuto incorporato. Dopo aver eseguito l'accesso agli utenti, hanno accesso ai report che sono proprietari o che altri membri dell'organizzazione condividono con loro.

I consumer di report incorporati per l'organizzazione possono sfruttare le funzionalità self-service, ad esempio barre delle azioni, segnalibri personali e filtri persistenti tramite le API client.

Barra delle azioni

Quando si incorpora un report di Power BI per l'organizzazione, i consumer di report possono usare la barra delle azioni del report per esportare, condividere, modificare le visualizzazioni o eseguire diverse altre azioni.

È possibile abilitare la funzionalità completa della barra delle azioni per consentire agli utenti:

• Aggiungere il report a Preferiti
• Usare filtri persistenti
• Usare segnalibri personali

Importante

Per fornire funzionalità complete della barra delle azioni, è necessario concedere agli utenti l'autorizzazione UserState.ReadWrite.All per l'applicazione in Azure Active Directory (Azure AD).

Per visualizzare la barra delle azioni ai consumer di report, aggiungere l'impostazione bars alla configurazione di incorporamento e impostare la actionBar visibilità su true.

let embedConfig = {
   ...
   settings: {
      bars: {
         actionBar: {
            visible: true
         }
      }
   }
};

La barra delle azioni visualizza un elenco verticale di pagine del report, la stessa esperienza di in servizio Power BI. Gli utenti possono comprimere il riquadro di spostamento della pagina per assegnare più spazio al report.

Filtri permanenti

I filtri persistenti mantengono i filtri dei dati, i filtri dei dati e altri stati del report nelle sessioni. I consumer di report possono accedere rapidamente alle informazioni dettagliate senza ripetere gli stessi passaggi di filtro ogni volta che tornano al report. Gli utenti possono condividere lo stesso stato di report persistente tra scenari di servizio Power BI, per dispositivi mobili e incorporare.

Per abilitare filtri persistenti nei report incorporati per l'organizzazione:

1. Abilitare filtri persistenti nelle impostazioni del report servizio Power BI o desktop.

2. Assicurarsi che l'app consenta UserState.ReadWrite.All le autorizzazioni in Azure AD.

3. Impostare la persistentFiltersEnabled proprietà nelle impostazioni loadConfiguration incorporate su true:

      let config = {
         type: 'report',
         ...
         settings: {
            persistentFiltersEnabled: true
         }
      };
   

Il report viene caricato con lo stato del report più recente dell'utente, se presente. Nel report incorporato i consumer possono usare il pulsante Reimposta per impostazione predefinita nella barra delle azioni per applicare i filtri persistenti.

Per altre informazioni sui filtri persistenti e sulle API pertinenti, vedere Filtri persistenti.

Segnalibri personali

Nei report incorporati per l'organizzazione, i consumer di report possono creare segnalibri personali acquisiscendo gli stati della pagina del report, inclusi filtri, filtri dei dati e stati visivi e assegnandoli nomi descrittivi. Gli utenti possono quindi tornare rapidamente a questi stati selezionando i segnalibri. I segnalibri personali sono disponibili solo per i loro creatori e la loro creazione non richiede autorizzazioni di scrittura per il report.

I consumer di report possono usare gli stessi segnalibri personali nei report incorporati e nella servizio Power BI. Gli utenti possono rendere qualsiasi segnalibro personale la visualizzazione predefinita, quindi visualizzano la visualizzazione preferita del report ogni volta che lo aprono.

Per abilitare i segnalibri personali nei report incorporati per l'organizzazione:

1. Assicurarsi che l'app consenta UserState.ReadWrite.All le autorizzazioni in Azure AD.

2. Impostare la personalBookmarksEnabled proprietà nelle impostazioni loadConfiguration incorporate su true:

      let config = {
         type: 'report',
         ...
         settings: {
            personalBookmarksEnabled: true
         }
      };
   

3. Rendere visibile il riquadro segnalibro nel report.

È possibile rendere visibile il riquadro segnalibro nel report in due modi. La prima opzione consiste nel visualizzare la barra delle azioni del report, che include un pulsante Segnalibri per gli utenti per aprire e chiudere il riquadro segnalibri .

La seconda opzione consiste nel visualizzare e nascondere il riquadro segnalibri a livello di codice usando l'oggetto riquadri nelle impostazioni del report.

let embedConfig = {
   ...
   settings: {
      panes: {
         bookmarks: {
            visible: true
         }
      }
   }
};

È possibile aggiornare le impostazioni del report in fase di esecuzione usando il updateSettings metodo, vedere Aggiornare le impostazioni del report in fase di esecuzione.

Per altre informazioni sui segnalibri personali, vedere Segnalibri personali.

Limitazioni

• Nell'analisi incorporata di Power BI i filtri persistenti e le funzionalità dei segnalibri personali sono disabilitate per impostazione predefinita. Queste funzionalità sono supportate solo quando si incorporano report per l'organizzazione, non quando si incorporano per i clienti.

• Quando si mostra la barra delle azioni, non è più possibile controllare a livello di codice se lo spostamento di pagina viene visualizzato come riquadro a sinistra o come schede nella parte inferiore. La modifica del percorso dell'elenco delle pagine del report è disponibile solo tramite le impostazioni del report servizio Power BI, non tramite l'oggetto panes .

• Le azioni dei segnalibri personali non sono supportate dall'API. Per informazioni sui segnalibri del report, vedere Segnalibri del report.

Passaggi successivi

Migliorare l'esperienza degli utenti con i segnalibri

Abilitare filtri persistenti