Pubblicare sul Web da Power BIPublish to web from Power BI

Con l'opzione Pubblica sul Web di Power BI è possibile incorporare con facilità contenuti interattivi di Power BI in post di blog, siti Web, messaggi di posta elettronica o social media.With the Power BI Publish to web option, you can easily embed interactive Power BI content in blog posts, websites, emails, or social media. È anche possibile modificare, aggiornare o interrompere facilmente la condivisione degli oggetti visivi pubblicati.You can also easily edit, update, refresh, or stop sharing your published visuals.

Avviso

Quando si usa Pubblica sul Web, chiunque su Internet può visualizzare il report o l'oggetto visivo pubblicato.When you use Publish to web, anyone on the Internet can view your published report or visual. Per la visualizzazione non è necessaria alcuna autenticazione,Viewing requires no authentication. nemmeno per i dati di livello dettagliato aggregati nei report.It includes viewing detail-level data that your reports aggregate. Prima di pubblicare un report, verificare che sia opportuno condividere pubblicamente i dati e le visualizzazioni.Before publishing a report, make sure it's okay for you to share the data and visualizations publicly. Evitare di pubblicare informazioni riservate o di proprietà.Don't publish confidential or proprietary information. In caso di dubbio, prima di procedere alla pubblicazione verificare i criteri dell'organizzazione.If in doubt, check your organization's policies before publishing.

Nota

È possibile incorporare i contenuti in modo sicuro in un portale o un sito Web interno.You can embed your content securely in an internal portal or website. Usare l'opzione Incorpora o Incorpora in SharePoint Online.Use the Embed or Embed in SharePoint Online options. Queste opzioni assicurano che vengano applicate tutte le autorizzazioni e la sicurezza dei dati quando gli utenti visualizzano i dati interni.These options ensure that all permissions and data security are enforced when your users view your internal data.

Creare codice di incorporamento con Pubblica sul WebCreate embed codes with Publish to web

La funzionalità Pubblica sul Web è disponibile per i report che si possono modificare nelle aree di lavoro personali e di gruppo.Publish to web is available for reports you can edit in your personal and group workspaces. Non è disponibile per i report condivisi con l'utente o quelli in cui la protezione dei dati è basata sulla sicurezza a livello di riga.It isn't available for reports shared with you, or ones relying on row-level security to secure data. Vedere la sezione Limitazioni più avanti per un elenco completo di casi in cui la funzionalità Pubblica sul Web non è supportata.See the Limitations section below for a complete list of cases where Publish to web isn't supported. Prima di usare Pubblica sul Web esaminare l'avviso riportato in precedenza in questo articoloReview the Warning earlier in this article before using Publish to web.

La procedura seguente illustra come usare la funzionalità Pubblica sul Web.The following steps describe how to use Publish to web.

  1. Aprire un report modificabile in un'area di lavoro e selezionare Altre opzioni (...) > Incorpora > Pubblica sul Web (pubblico) .Open a report in a workspace that you can edit, and select More options (...) > Embed > Publish to web (public).

    Pubblica sul Web in Altre opzioni

  2. Se l'amministratore di Power BI non ha autorizzato la creazione di codice di incorporamento, potrebbe essere necessario contattarlo.If your Power BI admin hasn't allowed you to create embed codes, you may need to contact them.

    Contattare l'amministratore di Power BI

    Per informazioni su come trovare la persona che possa abilitare la funzionalità Pubblica sul Web all'interno dell'organizzazione, vedere Trovare l'amministratore di Power BI più avanti in questo articolo.For help finding the person who can enable Publish to web in your organization, see How to find your Power BI administrator later in this article.

  3. Esaminare il contenuto della finestra di dialogo e selezionare Crea codice di incorporamento.Review the dialog content and select Create embed code.

    Verifica del codice di incorporamento in un sito Web pubblico

  4. Esaminare l'avviso, come indicato qui, e verificare che i dati si possano incorporare in un sito Web pubblico.Review the warning, as shown here, and confirm that the data is okay to embed in a public website. In caso affermativo, selezionare Pubblica.If it is, select Publish.

    Esaminare l'avviso

  5. Nella finestra di dialogo Operazione completata viene visualizzata un'anteprima dell'aspetto del report.In the Success dialog, you see a preview of how the report will look. Selezionare Dimensioni e Pagina predefinita.Select the Size and Default page.

    È anche possibile aggiungere un'immagine Segnaposto, per velocizzare il caricamento della pagina Web.You can also add a Placeholder image, to make the web page load faster. Con un'immagine segnaposto, per gli utenti che visualizzano il report sul Web è disponibile un pulsante View interactive content (Visualizza contenuto interattivo) selezionabile per visualizzare il report stesso.With a placeholder image, people viewing your report on the web see a View interactive content button they can select to view the report itself.

    Apportare prima queste modifiche.Make those changes first. Copiare quindi il collegamento per inviarlo tramite posta elettronica o copiare il codice HTML per incollarlo in un sito Web.Then copy the link to send it in email, or copy the HTML to paste into a website. È possibile incorporarlo nel codice, ad esempio un iFrame, o incollarlo direttamente in una pagina Web o un blog.You can embed it in code such as an iFrame, or paste it directly into a web page or blog.

    Operazione riuscita: collegamento e codice HTML

  6. Se in precedenza si è creato un codice di incorporamento per un report e si seleziona Pubblica sul web, le finestre di dialogo dei passaggi da 2 a 4 non vengono visualizzate.If you previously created an embed code for a report and you select Publish to web, you won't see the dialogs in steps 2-4. Viene invece visualizzata la finestra di dialogo Codice di incorporamento.Instead, you see the Embed code dialog.

    Finestra di dialogo Codice di incorporamento

    È possibile creare solo un codice di incorporamento per ogni report.You can only create one embed code for each report.

Suggerimenti per le modalità di visualizzazioneTips for view modes

Quando si incorpora contenuto in un post di blog, è in genere necessario adattarlo alle dimensioni specifiche dello schermo.When you embed content within a blog post, you typically need to fit it within a specific screen size. È possibile modificare l'altezza e la larghezza nel tag iFrame in base alle esigenze.You can adjust the height and the width in the iFrame tag as needed. Tuttavia, è necessario assicurarsi che il report si adatti all'area dell'iFrame specificata, quindi impostare una modalità di visualizzazione appropriata quando si modifica il report.However, you need to ensure your report fits within the given iFrame area, so set an appropriate View Mode when you're editing the report.

La tabella seguente include indicazioni sulla modalità di visualizzazione e sul rispettivo aspetto in caso di incorporamento.The following table provides guidance about the View Mode, and how it will appear when embedded.

Modalità di visualizzazioneView Mode Aspetto dopo l'incorporamentoHow it looks when embedded
PtW6b Adatta alla pagina rispetta l'altezza e la larghezza della pagina del report.Fit to page respects your report's page height and width. Se si imposta la pagina su proporzioni dinamiche, ad esempio 16:9 o 4:3, il contenuto viene ridimensionato in modo da adattarsi all'interno dell'iFrame.If you set your page to dynamic ratios like 16:9 or 4:3, your content scales to fit within the iFrame. Se si incorpora il report in un iFrame, usando Adatta alla pagina si può ottenere il letterboxing con il quale viene visualizzato uno sfondo grigio nelle aree dell'iFrame dopo che il contenuto viene ridimensionato in modo che si adatti all'interno dell'iFrame.When embedded in an iFrame, using Fit to page can result in letterboxing: a gray background is shown in iFrame areas after the content scales to fit within the iFrame. Per ridurre il letterboxing, impostare l'altezza e la larghezza dell'iFrame in modo appropriato.To minimize letterboxing, set the height and width of the iFrame appropriately.
PtW6d La modalità Dimensioni effettive garantisce che vengano mantenute le dimensioni definite nella pagina del report.Actual size ensures the report preserves its size as set on the report page. È quindi possibile che nell'iFrame siano visualizzate barre di scorrimento.This can result in scrollbars appearing in your iFrame. Impostare l'altezza e la larghezza dell'iFrame per evitare le barre di scorrimento.Set the iFrame height and width to avoid scrollbars.
PtW6c La modalità Adatta in larghezza assicura che i contenuti occupino l'area orizzontale dell'iFrame.Fit to width ensures the content fills the horizontal area of the iFrame. Viene comunque visualizzato un bordo, ma il contenuto viene ridimensionato in modo da usare tutto lo spazio orizzontale disponibile.A border is still shown, but the content scales to use all the horizontal space available.

Suggerimenti per l'altezza e la larghezza dell'iFrameTips for iFrame height and width

Un codice di incorporamento di Pubblica sul Web è simile all'esempio seguente:A Publish to web embed code looks like the following example:

PtW7

È possibile modificare manualmente la larghezza e l'altezza per assicurarsi di ottenere esattamente il risultato desiderato nella pagina in cui si incorpora il report.You can edit the width and height manually to ensure it's precisely how you want it to fit in the page where you're embedding it.

Per perfezionare ulteriormente il risultato, provare ad aggiungere 56 pixel all'altezza dell'iFrame per adattarla alla dimensione corrente della barra inferiore.To achieve a more perfect fit, you can try adding 56 pixels to the height of the iFrame to accommodate the current size of the bottom bar. Se la pagina del report usa dimensioni dinamiche, la tabella seguente specifica alcune dimensioni che è possibile usare per adattare gli oggetti senza letterboxing.If your report page uses the dynamic size, the table below provides some sizes you can use to achieve a fit without letterboxing.

ProporzioniRatio DimensioneSize Dimensione (larghezza x altezza)Dimension (width x height)
16:916:9 PiccolaSmall 640 x 416 px640 x 416 px
16:916:9 MediaMedium 800 x 506 px800 x 506 px
16:916:9 GrandeLarge 960 x 596 px960 x 596 px
4:34:3 PiccolaSmall 640 x 536 px640 x 536 px
4:34:3 MediaMedium 800 x 656 px800 x 656 px
4:34:3 GrandeLarge 960 x 776 px960 x 776 px

Gestisci codici di incorporamentoManage embed codes

Dopo avere creato un codice di incorporamento di Pubblica sul Web, è possibile gestire i codici dal menu Impostazioni di Power BI.Once you create a Publish to web embed code, you can manage your codes from the Settings menu in Power BI. La gestione dei codici di incorporamento include la possibilità di rimuovere l'oggetto visivo o il report di destinazione per un codice, rendendo inutilizzabile il codice di incorporamento, o di ottenere il codice di incorporamento.Managing embed codes includes the ability to remove the destination visual or report for a code (rendering the embed code unusable), or getting the embed code.

  1. Per gestire i codici di incorporamento Pubblica sul Web , aprire l'opzione Impostazioni , con icona a forma di ingranaggio, e selezionare Gestisci codici di incorporamento.To manage your Publish to web embed codes, open the Settings gear and select Manage embed codes.

    Gestisci codici di incorporamento

  2. Vengono visualizzati i codici di incorporamento.Your embed codes appear.

    PtW9

  3. È possibile recuperare o eliminare un codice di incorporamento.You can either retrieve or delete an embed code. L'eliminazione disabilita tutti i collegamenti a quel report o oggetto visivo.Deleting it disables any links to that report or visual.

    PtW10

  4. Se si seleziona Elimina, viene richiesta una conferma.If you select Delete, you're asked for a confirmation.

    PtW11

Aggiornamenti ai report e aggiornamenti dei datiUpdates to reports, and data refresh

Dopo la creazione e la condivisione del codice di incorporamento di Pubblica sul Web, il report viene aggiornato con le eventuali modifiche apportate.After you create your Publish to web embed code and share it, the report updates with any changes you make. Il collegamento del codice di incorporamento è immediatamente attivo.The embed code link is immediately active. Gli utenti che aprono il collegamento possono visualizzarlo.Anyone who opens the link can view it. I dati vengono memorizzati nella cache per un'ora dal momento in cui vengono recuperati.The data is cached for one hour from the time it is retrieved. Non è consigliabile usare Pubblica sul Web per i dati che devono essere aggiornati di frequente.We don’t recommend using Publish to web for data that needs to refresh frequently. Per altre informazioni, vedere la sezione Come funziona più avanti in questo articolo.To learn more, see the How it works section later in this article.

Aggiornamento dei datiData refresh

Gli aggiornamenti dei dati vengono applicati automaticamente nel report o nell'oggetto visivo incorporato.Data refreshes are automatically reflected in your embedded report or visual. Quando i dati vengono aggiornati per un modello di dati di importazione nel servizio Power BI, il servizio cancella la cache dei dati, con conseguente aggiornamento rapido dei dati.When data is refreshed for an import data model in the Power BI service, the service clears the data cache, making data update quickly. Per disabilitare l'aggiornamento automatico, selezionare Non aggiornare nella pianificazione per il set di dati usato dal report.To disable automatic refresh, select don't refresh on the schedule for the dataset the report uses.

Utilizzo intensivoHeavy usage

Un'esperienza di utilizzo intensivo può verificarsi quando un report riceve troppe query in un breve periodo di tempo.A heavy usage experience can occur when a report receives too many queries in a short amount of time. In questi casi, gli utenti non possono visualizzare o interagire con il report fino a quando non trascorre il periodo di utilizzo intensivo.When heavy usage occurs, users can't view or interact with the report until the period of heavy usage passes.

Si consiglia di impostare un'immagine segnaposto per il report.We recommend setting a placeholder image for your report. Nel caso di una condizione di utilizzo intensivo, gli utenti potranno così visualizzare l'immagine segnaposto.If heavy usage occurs, users see the placeholder image.

Per evitare un'esperienza di utilizzo intensivo, limitare il numero di query distinte che possono essere generate dal report e la frequenza di aggiornamento dei dati.To help avoid the heavy usage experience, limit the number of distinct queries your report can generate and the frequency of data refresh. Per suggerimenti sulla semplificazione dei report, vedere la guida all'ottimizzazione di Power BI.See the Power BI optimization guide for tips on streamlining your reports.

Oggetti visivi di Power BIPower BI visuals

Gli oggetti visivi di Power BI sono supportati in Pubblica sul Web.Power BI visuals are supported in Publish to web. Quando si usa Pubblica sul Web, gli utenti con cui si condividono gli oggetti visivi pubblicati non hanno bisogno di abilitare gli oggetti visivi di Power BI per visualizzare i report.When you use Publish to web, users with whom you share your published visual don't need to enable Power BI visuals to view the report.

Informazioni sulla colonna dello stato del codice di incorporamentoUnderstanding the embed code status column

Nota

È necessario esaminare periodicamente i codici di incorporamento pubblicati,Review the embed codes you've published often. rimuovendo quelli che non devono più essere disponibili pubblicamente.Remove any that no longer need to be available publicly.

La pagina Gestisci codici di incorporamento include una colonna di stato.The Manage embed codes page includes a status column. Per impostazione predefinita, lo stato dei codici di incorporamento è Attivo, ma può essere anche uno degli stati elencati di seguito.By default, embed codes are Active, but could also be one of the statuses listed below.

StatoStatus DescrizioneDescription
AttivoActive Il report è disponibile per la visualizzazione e l'interazione da parte degli utenti Internet.The report is available for Internet users to view and interact with.
BloccatoBlocked Il contenuto del report viola le Condizioni d'uso di Power BI.The report content violates the Power BI Terms of Service. Microsoft lo ha bloccato.Microsoft has blocked it. Se si ritiene che il contenuto sia stato bloccato per errore, contattare il supporto tecnico.Contact support if you believe the content was blocked in error.
Non supportatoNot supported Il set di dati del report usa la sicurezza a livello di riga o un'altra configurazione non supportata.The report's dataset is using row-level security, or another unsupported configuration. Vedere la sezione Limitazioni per un elenco completo.See the Limitations section for a complete list.
ViolazioneInfringed Il codice di incorporamento non rientra nei criteri definiti per il tenant.The embed code is outside the defined tenant policy. Questo stato si verifica in genere quando viene creato un codice di incorporamento e successivamente l'impostazione Pubblica sul Web del tenant viene modificata in modo da escludere l'utente proprietario del codice di incorporamento.This status typically occurs when an embed code was created and then the Publish to web tenant setting was changed to exclude the user owning the embed code. Se l'impostazione del tenant è disabilitata o se l'utente non è più autorizzato a creare codici di incorporamento, lo stato dei codici di incorporamento esistenti sarà Violazione.If the tenant setting is disabled, or the user is no longer allowed to create embed codes, existing embed codes show an Infringed status. Per informazioni dettagliate, vedere la sezione Trovare l'amministratore di Power BI in questo articolo.See the Find your Power BI administrator section in this article for details.

Segnalare un problema relativo al contenuto di Pubblica sul WebReport a concern with Publish to web content

Per segnalare un problema relativo a contenuto di Pubblica sul Web incorporato in un sito Web o un blog, selezionare l'icona Flag sulla barra inferiore del report Pubblica sul Web.To report a concern related to Publish to web content embedded in a website or blog, select the Flag icon in the bottom bar of the Publish to web report.

PtW12

Viene chiesto di inviare un messaggio di posta elettronica a Microsoft per illustrare il problema.You're asked to send an email to Microsoft explaining your concern. Microsoft valuta il contenuto in base alle Condizioni per l'utilizzo del servizio Power BI e prende le misure appropriate.Microsoft evaluates the content based on the Power BI Terms of Service and takes appropriate action.

Gestione delle licenzeLicensing

Per usare la funzionalità Pubblica sul Web, è necessario essere utenti di Microsoft Power BI.You need to be a Microsoft Power BI user to use Publish to web. Per visualizzare i report non è invece necessario essere utenti di Power BI.Your report viewers don't need to be Power BI users.

Come funziona (dettagli tecnici)How it works (technical details)

Quando si crea un codice di incorporamento usando Pubblica sul Web, il report viene reso disponibile agli utenti di Internet.When you create an embed code using Publish to web, the report is made visible to Internet users. Essendo disponibile pubblicamente, è probabile che in futuro gli utenti condividano il report attraverso i social media.It's publicly available, so you can expect viewers to easily share the report through social media in the future. Gli utenti visualizzano il report aprendo l'URL pubblico diretto o visualizzandolo incorporato in una pagina Web o un blog.Users view the report either by opening the direct public URL or viewing it embedded in a web page or blog. Nel frattempo, Power BI memorizza nella cache la definizione del report e i risultati delle query necessarie per visualizzare il report.As they do, Power BI caches the report definition and the results of the queries required to view the report. La memorizzazione nella cache garantisce che migliaia di utenti possano visualizzare contemporaneamente il report senza influire sulle prestazioni.This caching ensures that thousands of concurrent users can view the report without impacting performance.

I dati vengono memorizzati nella cache per un'ora dal momento in cui vengono recuperati.The data is cached for one hour from the time it is retrieved. Se si aggiorna la definizione del report, ad esempio se si cambia la modalità di visualizzazione, o si aggiornano i dati del report, la visualizzazione dei cambiamenti nella versione del report visualizzata dagli utenti può richiedere del tempo.If you update the report definition (for example, if you change its View mode) or refresh the report data, it can take some time before changes are reflected in the version of the report that your users view. Quando viene eseguito un aggiornamento dei dati per un modello di dati di importazione, il servizio cancella i dati memorizzati nella cache e recupera i nuovi dati.When a data refresh occurs for an import data model, the service clears the cached data and retrieves new data. Nella maggior parte dei casi, i dati vengono aggiornati quasi in contemporanea con l'importazione dei dati.In most cases, the data is updated nearly simultaneous with the import of the data. Tuttavia, per i report con molte query distinte, l'aggiornamento potrebbe richiedere del tempo.However, for reports with many distinct queries, it may take some time to update. Poiché ogni elemento e valore di dati viene memorizzato nella cache in modo indipendente, quando si verifica un aggiornamento dei dati un utente potrebbe visualizzare una combinazione di valori correnti e precedenti.Since each element and data value is cached independently, when a data update occurs, a user may see a mix of current and previous values. Pertanto, è consigliabile eseguire anticipatamente lo staging del lavoro e creare il codice di incorporamento di Pubblica sul Web solo quando si è soddisfatti delle impostazioni.Therefore, we recommend staging your work ahead of time, and creating the Publish to web embed code only when you're satisfied with the settings. Se i dati vengono aggiornati, ridurre al minimo il numero di aggiornamenti ed eseguirli fuori orario.If your data will refresh, minimize the number of refreshes and perform the refreshes at off hours. Non è consigliabile usare Pubblica sul Web per i dati che devono essere aggiornati di frequente.We don’t recommend using Publish to web for data that needs to refresh frequently.

Trovare l'amministratore di Power BIFind your Power BI administrator

Il portale di amministrazione di Power BI include impostazioni che consentono di specificare chi può pubblicare contenuti sul Web.The Power BI admin portal has settings that control who can publish to the web. Per modificare l'impostazione Pubblica sul Web del tenant nel portale di amministrazione, è necessario collaborare con l'amministratore di Power BI dell'organizzazione.Work with your organization's Power BI administrator to change the Publish to web tenant settings in the admin portal.

Per le organizzazioni più piccole o gli utenti singoli iscritti a Power BI, potrebbe non essere ancora presente un amministratore di Power BI.For smaller organizations or individuals who signed up for Power BI, you may not have a Power BI administrator yet. Seguire la procedura per l'acquisizione del ruolo di amministratore.Follow our process for admin takeover. Dopo essere stato individuato, l'amministratore di Power BI può abilitare la creazione dei codici incorporati.Once you have a Power BI administrator, they can enable creating embed codes for you.

Le organizzazioni avviate in genere hanno già un amministratore di Power BI.Established organizations usually already have a Power BI administrator. Le persone in possesso di uno qualsiasi dei ruoli seguenti possono agire come amministratori di Power BI:People in any of the following roles can act as a Power BI administrator:

  • Amministratori globaliGlobal administrators
  • Utenti con il ruolo di amministratore del servizio Power BI in Azure Active DirectoryUsers with the Power BI service admin role in Azure Active Directory

È necessario trovare una di queste persone all'interno dell'organizzazione e chiederle di aggiornare le impostazioni di Pubblica sul Web per il tenant nel portale di amministrazione.You need to find one of these people in your organization and ask them to update the Publish to web tenant settings in the admin portal.

LimitazioniLimitations

La funzionalità Pubblica sul Web è supportata per la maggior parte delle origini dati e dei report nel servizio Power BI,Publish to web is supported for the vast majority of data sources and reports in the Power BI service. tuttavia i tipi di report seguenti non sono attualmente supportati o disponibili con Pubblica sul Web:However, the following kinds of reports aren't currently supported or available with Publish to web:

  • Report che usano la sicurezza a livello di riga.Reports using row-level security.
  • Report che usano le origini dati della connessione dinamica, inclusi Analysis Services in modalità tabulare ospitato in locale, Analysis Service in modalità multidimensionale e Azure Analysis Services.Reports using any Live Connection data source, including Analysis Services Tabular hosted on-premises, Analysis Services Multidimensional, and Azure Analysis Services.
  • Report che usano un set di dati condiviso archiviato in un'area di lavoro diversa dal report.Reports using a shared dataset that is stored in a different workspace from the report.
  • Set di dati certificati e condivisi.Shared and certified datasets.
  • Report condivisi direttamente o tramite un'app.Reports shared to you directly or through an app.
  • Report in un'area di lavoro in cui non si è un membro a cui sono consentite modifiche.Reports in a workspace in which you aren't an edit member.
  • Gli oggetti visivi "R" e Python non sono attualmente supportati nei report di Pubblica sul Web."R" and Python visuals aren't currently supported in Publish to web reports.
  • Esportazione di dati da oggetti visivi in un report pubblicato sul Web.Exporting data from visuals in a report that has been published to the web.
  • Oggetti visivi ArcGIS Maps for Power BI.ArcGIS Maps for Power BI visuals.
  • Domande e risposte sugli oggetti visivi di Power BI.Q&A for Power BI visuals.
  • Report che contengono misure DAX a livello di report.Reports containing report-level DAX measures.
  • Modelli di query di dati Single Sign-On.Single sign-on data query models.
  • Proteggere le informazioni riservate o di proprietà.Secure confidential or proprietary information.
  • La funzionalità di autenticazione automatica fornita con l'opzione Incorpora non funziona con l'API JavaScript di Power BI.The automatic authentication capability provided with the Embed option doesn't work with the Power BI JavaScript API. Per l'API JavaScript di Power BI, usare l'approccio all'incorporamento dati di proprietà dell'utente.For the Power BI JavaScript API, use the user owns data approach to embedding.
  • Gli amministratori possono bloccare l'accesso a Internet pubblico, come descritto in Collegamenti privati per l'accesso a Power BI.Admins can block public internet access, as described in Private links for accessing Power BI. In tal caso, l'opzione Pubblica sul Web è disabilitata per il tenant nel portale di amministrazione di Power BI.In that case, the Publish to Web option is grayed out for your tenant in the Power BI admin portal.

Passaggi successiviNext steps

Altre domande?More questions? Provare la community di Power BITry the Power BI Community