Condividi tramite

Nascondere o visualizzare le intestazioni degli oggetti visivi

  • Articolo

I report di Power BI incorporati nelle app contengono oggetti visivi, ad esempio grafici, mappe termiche e misuratori. Questi oggetti visivi hanno intestazioni che rendono disponibili azioni agli utenti. Quando si usa Power BI, è possibile nascondere o visualizzare l'intestazione di ogni oggetto visivo in un report. Ogni oggetto visivo include una scheda nella sezione Formattazione del riquadro visualizzazioni denominata intestazione visuale. È possibile usare tale scheda per attivare e disattivare l'intestazione dell'oggetto visivo. Altre informazioni sulle intestazioni degli oggetti visivi in intestazioni visuali.

Esempi di azioni nelle intestazioni visive includono:

  • Apertura dell'oggetto visivo in modalità messa a fuoco.
  • Drill-down o up.
  • Visualizzazione dei filtri e dei filtri dei dati attualmente applicati all'oggetto visivo.
  • Apertura del menu delle opzioni dell'oggetto visivo.

A volte è utile nascondere queste azioni. Ad esempio, quando due oggetti visivi si sovrappongono, potrebbe non essere necessario visualizzare entrambe le intestazioni degli oggetti visivi.

Questa API consente di nascondere o visualizzare le intestazioni di tutti gli oggetti visivi in un report o solo di quelle specifiche. È possibile configurare la visibilità sul carico del report oppure chiamare il metodo Report updateSettings per modificare la visibilità dopo il caricamento di un report, vedere Aggiornare le impostazioni del report in fase di esecuzione.

È possibile usare l'API in molti scenari, inclusi i casi d'uso seguenti:

  • Nascondere solo alcune intestazioni visive in un report.
  • Usare la logica di business in un'app, ad esempio un clic su un pulsante, per nascondere o visualizzare un'intestazione dopo il caricamento di un report.

Come nascondere o visualizzare intestazioni visive

Per nascondere o visualizzare le intestazioni visive nell'API, configurare determinati parametri nelle impostazioni di un report. Per informazioni generali sulla configurazione delle opzioni nei report incorporati, vedere Configurare le impostazioni del report.

Impostazioni intestazione visiva

Con le intestazioni visive, la visibilità è attualmente l'unica impostazione che è possibile configurare. Per nascondere o visualizzare le intestazioni, specificare un elenco di oggetti di configurazione dell'intestazione visiva. Ognuno contiene un oggetto impostazioni e può includere anche un selettore. selettori identificare gli oggetti visivi a cui si stanno applicando le impostazioni. Altre informazioni sui selettori in selettori.

Il tipo dell'oggetto di configurazione fornito all'API è IVisualSettings. Più avanti in questo articolo sono disponibili esempi che illustrano come usare questa interfaccia nel codice. modelli di Power BI elenca tutte le definizioni di interfaccia usate dagli esempi.

Si notino i punti seguenti:

  • Il selettore è facoltativo in queste impostazioni. Quando non si elencano selettori, l'API applica le impostazioni a tutti gli oggetti visivi del report.
  • Quando si usano selettori, è possibile specificare gli oggetti visivi in base al nome o al tipo. Per ottenere i nomi e i tipi degli oggetti visivi in una determinata pagina, usare il metodo page getVisuals.

Regole di precedenza

L'API applica le impostazioni di configurazione nell'ordine seguente:

  • Impostazioni salvate nel report.
  • Impostazioni definite nell'oggetto di configurazione di incorporamento, che l'API viene applicata al caricamento.
  • Impostazioni fornite all'API updateSettings.

Se più impostazioni possono essere applicate a un oggetto visivo, l'API usa l'ultima impostazione applicabile. Il Nascondere tutte le intestazioni visive esempio nella sezione successiva illustra questo punto.

Esempi

Questi esempi illustrano diversi modi di usare l'API per nascondere o visualizzare le intestazioni visive.

Nascondere tutte le intestazioni visive

Questo semplice scenario offre ai clienti una visualizzazione report pulita nascondendo tutte le intestazioni visive in un report:

let embedConfig = {
    ...
    settings: {
        ...
        visualSettings: {
            visualHeaders: [
                {
                    settings: {
                        visible: false
                    }
                    /* No selector is listed. The API hides the headers of all the visuals in the report. */
                }
            ]
        }
    }
};
...
let report = powerbi.embed(embedContainer, embedConfig);

Nascondere l'intestazione di un oggetto visivo specifico

Questo esempio usa un selettore per applicare un'impostazione di visibilità a un singolo oggetto visivo. Questo scenario si presenta quando si vuole nascondere funzionalità che non hanno senso per un oggetto visivo. Usare questo codice in questo caso:

let embedConfig = {
    ...
    settings: {
        ...
        visualSettings: {
            visualHeaders: [
                {
                    settings: {
                        visible: false
                    },
                    selector: {
                        $schema: "http://powerbi.com/product/schema#visualSelector",
                        visualName: <The name of the visual>  // You can retrieve the name by using getVisuals.
                    }
                }
            ]
        }
    }
};
...
let report = powerbi.embed(embedContainer, embedConfig);

Nascondi tutto ma un'intestazione visiva

Usare questo codice per nascondere tutte le intestazioni visive in un report, ad eccezione dell'intestazione di un oggetto visivo specifico:

let embedConfig = {
    ...
    settings: {
        ...
        visualSettings: {
            visualHeaders: [
                {
                    settings: {
                        visible: false
                    }
                    /* No selector is listed. The API hides the headers of all the visuals in the report. */
                },
                {
                    settings: {
                        visible: true
                    },
                    selector: {
                        $schema: "http://powerbi.com/product/schema#visualSelector",
                        visualName: <The name of the visual> // You can retrieve the name by using getVisuals.
                    }
                }
            ]
        }
    }
};
...
let report = powerbi.embed(embedContainer, embedConfig);

Se vuoi rendere visibili più intestazioni, puoi estendere questo codice. Configurare istanze aggiuntive di IVisualHeader con il parametro visible in settings impostato su true. Per ogni oggetto visivo che deve avere un'intestazione visibile, aggiungere un'istanza IVisualHeader all'elenco.

Considerazioni e limitazioni

  • È possibile controllare la visibilità delle intestazioni visive solo se il report incorporato è in modalità di visualizzazione.
  • È possibile nascondere o visualizzare solo l'intera intestazione di un oggetto visivo. Non è possibile configurare la visibilità di elementi specifici nel menu di intestazione.
  • Quando si usa un selettore per specificare il nome o il tipo di un oggetto visivo, usare il metodo page getVisuals per ottenere il nome dell'oggetto visivo, ovvero un identificatore univoco. Non configurare il selettore con il titolo dell'oggetto visivo.
  • Se un utente salva un report che si incorpora con l'API, le impostazioni visive definite verranno salvate nel report. È possibile evitare questa situazione configurando il report con un livello di autorizzazione di View anziché Edit o Save.

Contenuto correlato