Incorporare altri tipi di contenuto di Power BI

Completato

È possibile incorporare altri tipi di contenuto di Power BI, inclusi gli oggetti visivi del report di Power BI, i report impaginati, i dashboard, i riquadri del dashboard e l'esperienza Q&A. A differenza dei report di Power BI, non è possibile modificare o creare questi altri tipi di contenuto.

Incorporare gli oggetti visivi del report di Power BI

È possibile incorporare singoli oggetti visivi del report provenienti da un report di Power BI. Usare un oggetto di configurazione di tipo IVisualLoadConfiguration. Oltre alle proprietà necessarie (descritte nell'unità 1; la proprietà type è impostata su visual), è necessario impostare anche le proprietà seguenti.

  • pageName: obbligatoria. Il nome della pagina contenente l'oggetto visivo incorporato. È possibile usare la funzione getPages del report per ottenere le pagine del report.
  • visualName - Obbligatorio. Nome dell'oggetto visivo incorporato. È possibile usare la funzione getVisuals della pagina per ottenere gli oggetti visivi di una pagina.

L'app può applicare filtri all'oggetto visivo usando la funzione updateFilters.

Suggerimento

Non incorporare troppi oggetti visivi provenienti dalla stessa pagina perché l'operazione potrebbe non funzionare correttamente. Inoltre, se è necessario un maggiore controllo durante l'incorporamento di diversi oggetti visivi dallo stesso report, è possibile eseguire tale operazione in modo più efficiente usando layout personalizzati. Per altre informazioni sui layout personalizzati, vedere Personalizzare un layout del report.

Per una descrizione completa dell'incorporamento di oggetti visivi del report di Power BI, vedere Incorporare un oggetto visivo del report.

Incorporare report impaginati

È possibile incorporare report impaginati usando un oggetto di configurazione di tipo IEmbedConfigurationBase. Oltre alle proprietà necessarie (descritte nell'unità 1; la proprietà type è impostata su report), è necessario impostare anche le proprietà seguenti.

  • id - Obbligatorio. ID area di lavoro (GroupID) che contiene il report impaginato.
  • uniqueId - Obbligatorio. ID report del report impaginato.

Esiste anche la proprietà settings, che è facoltativa. È possibile passare un oggetto di tipo IPaginatedReportSettings per specificare informazioni sull'aspetto del pannello dei parametri del report. L'app può abilitare ed espandere (aprire) il pannello.

Per impostare i parametri del report impaginato, passarli nell'URL di incorporamento. Tuttavia, non è possibile impostare i valori con più parametri. Per altre informazioni, vedere Passare un parametro di report in un URL per un report impaginato in Power BI.

Per una descrizione completa dell'incorporamento di report impaginati, vedere Incorporare un report impaginato.

Incorporare dashboard

È possibile incorporare i dashboard usando un oggetto di configurazione di tipo IDashboardLoadConfiguration. Oltre alle proprietà necessarie (descritte nell'unità 1; la proprietà type è impostata su dashboard), è necessario impostare anche la proprietà pageView. Le opzioni includono:

  • fitToWidth: la larghezza del dashboard incorporato corrisponde alla larghezza dell'elemento div che contiene il dashboard.
  • oneColumn: il dashboard incorporato viene visualizzato in una colonna. Questa opzione è adatta ai dispositivi con fattore di forma ridotto, come un telefono cellulare.
  • actualSize: il dashboard incorporato viene visualizzato a dimensioni complete.

Per una descrizione completa dell'incorporamento di dashboard, vedere Incorporare un dashboard.

Incorporare i riquadri del dashboard

È possibile incorporare i riquadri del dashboard usando un oggetto di configurazione di tipo ITileLoadConfiguration. Oltre alle proprietà necessarie (descritte nell'unità 1; la proprietà type è impostata su tile), è necessario impostare anche le proprietà seguenti.

  • dashboardId - Obbligatorio. DashboardID del dashboard contenente il riquadro.
  • id - Obbligatorio. ID del riquadro del dashboard. È possibile usare l'API REST di Power BI per ottenere riquadri del dashboard e le relative proprietà.

Per una descrizione completa dell'incorporamento dei riquadri del dashboard, vedere Incorporare un riquadro del dashboard.

Incorporare l'esperienza Q&A

È possibile incorporare l'esperienza Q&A usando un oggetto di configurazione di tipo ILoadQnaConfiguration. Oltre alle proprietà necessarie (descritte nell'unità 1; la proprietà type è impostata su qna), è necessario impostare anche le proprietà seguenti.

  • datasetIds - Obbligatorio. Matrice di DatasetID. Tuttavia, attualmente è supportato un solo DatasetID.
  • viewMode - Facoltativo. QnaMode.Interactive, che consente all'utente di inserire domande o QnaMode.ResultOnly, che richiede una domanda fornita.
  • question - Facoltativo. Domanda fornita dall'app. La proprietà viewMode deve essere impostata su QnaMode.ResultOnly.

Suggerimento

Incoraggiare l'uso di Q&A può contribuire a ridurre il numero di report e dashboard che è necessario sviluppare. È anche possibile incorporare un oggetto visivo Q&A da un report di Power BI. Questo approccio offre la possibilità di formattare l'oggetto visivo e l'app può applicarvi i filtri.

Per una descrizione completa dell'incorporamento dell'esperienza Q&A, vedere Incorporare un oggetto visivo Q&A autonomo.