Creare pacchetti di contenuto modello in Power BIAuthor template content packs in Power BI

La creazione di un pacchetto di contenuto modello usa Power BI Desktop e PowerBI.com. Per il pacchetto di contenuto esistono quattro componenti:Authoring a template content pack uses the Power BI Desktop and PowerBI.com. There are four components to your content pack:

Ogni elemento potrebbe essere noto come funzionalità di Power BI esistente.You may be familiar with each piece as existing Power BI features. Quando si compila un pacchetto di contenuto, esistono altri fattori da considerare per ogni aspetto; vedere le singole sezioni di seguito per maggiori informazioni.When building a content pack, there are additional things to consider for each aspect, see each section below for more details.

QueryQueries

Per i pacchetti di contenuto modello, le query sviluppate in Power BI Desktop vengono usate per connettersi all'origine dati e importare i dati.For template content packs, queries developed in the Power BI Desktop are used to connect to your data source and import data. Queste query sono necessarie per restituire uno schema coerente e sono supportate per l'aggiornamento dati pianificato (la query diretta non è supportata).These queries are required to return a consistent schema and are supported for Scheduled Data refresh (direct query is not supported).

I pacchetti di contenuto modello supportano una sola origine dati per ogni pacchetto di contenuto, quindi definire le query con attenzione.Template content packs only support one data source per content pack so define your queries carefully. Una singola origine dati è definita come un'origine che richiede la stessa autenticazione.A single data source is defined as a source that requires the same authentication. Se tutte le chiamate vengono eseguite allo stesso endpoint API e usano la stessa autenticazione, è possibile effettuare più chiamate API in query diverse.You can make multiple API calls in different queries if all the calls are to the same API endpoint and use the same authentication. I pacchetti di contenuto di Power BI non supportano più origini che richiedono criteri di autenticazione diversi.Power BI content packs do not support multiple sources that require different authentications.

Connettersi all'APIConnect to your API

Per iniziare, è necessario connettersi all'API da Power BI Desktop per avviare la compilazione di query.To get started, you will need to connect to your API from Power BI Desktop to start building your queries.

È possibile usare i connettori di dati che sono disponibili per impostazione predefinita in Power BI Desktop per connettersi all'API.You can use the Data Connectors that are available out of the box in Power BI Desktop to connect to your API. È possibile usare il connettore dati Web (Recupera dati -> Web) per connettersi all'API Rest oppure il connettore OData (Recupera dati -> Feed OData) per connettersi al proprio feed OData.You can use the Web Data Connector (Get Data -> Web) to connect to your Rest API or the OData connector (Get Data -> OData feed) to connect to your OData feed. Si noti che questi connettori funzioneranno automaticamente solo se l'API supporta l'autenticazione di base.Please note that these connectors will work out of the box only if your API supports Basic Authentication.

Nota

Se l'API usa altri tipi di autenticazione, ad esempio OAuth 2.0 o la chiave API Web, sarà necessario sviluppare il proprio connettore dati per consentire a Power BI Desktop di connettersi correttamente e autenticarsi nell'API.If your API uses any other authentication types, like OAuth 2.0 or Web API Key, then you will need to develop your own Data Connector to allow Power BI Desktop to successfully connects and authenticates to your API. Per informazioni dettagliate su come sviluppare il proprio connettore dati per il pacchetto di contenuto, vedere la documentazione sui connettori dati qui.For details on how to develop your own Data Connector for your Content Pack, check the Data Connectors documentation here.

Considerare l'origineConsider the source

Le query definiscono i dati che verranno inclusi nel modello di dati.The queries define the data that will be included in the data model. A seconda delle dimensioni del sistema, le query devono includere anche i filtri per garantire che i clienti usino una dimensione gestibile, idonea allo scenario aziendale.Depending on the size of your system, these queries should also include filters to ensure your customers are dealing with a manageable size that fits your business scenario.

I pacchetti di contenuto di Power BI possono eseguire più query in parallelo e per più utenti contemporaneamente.Power BI content packs can execute multiple queries in parallel and for multiple users concurrently. Pianificare in anticipo la strategia di concorrenza e limitazione delle richieste e rivolgersi a Microsoft per informazioni su come rendere il pacchetto di contenuto a tolleranza d'errore.Plan ahead your throttling and concurrency strategy and ask us how to make your content pack fault tolerant.

Imposizione dello schemaSchema enforcement

Verificare che le query siano resilienti alle modifiche nel sistema perché le modifiche dello schema al momento dell'aggiornamento possono causare interruzioni del modello.Ensure your queries are resilient to changes in your system, changes in schema on refresh can break the model. Se l'origine può restituire uno schema null o mancante per alcune query, provare a restituire una tabella vuota o a generare messaggi di errore personalizzati che siano significativi per l'utente.If the source could return null/missing schema result for some queries, consider returning an empty table or throw a custom error messages that is meaningful to your user.

ParametriParameters

I parametri in Power BI Desktop consentono agli utenti di fornire i valori di input che consentono di personalizzare i dati recuperati dall'utente.Parameters in Power BI Desktop allow your users to provide input values that customize the data retrieved by the user. Considerare subito i parametri per evitare di dover effettuare rielaborazioni dopo aver dedicato molto tempo alla creazione di query o report dettagliati.Think of the parameters upfront to avoid rework after investing time to build detailed queries or reports.

Nota

Attualmente i pacchetti di contenuto modello supportano solo i parametri di testo.Template content packs only support text parameters currently. Durante lo sviluppo è possibile usare altri tipi di parametri, ma durante la parte di test tutti i valori forniti dagli utenti saranno letterali.Other parameter types can be used during development but during the testing portion all values provided by the users will be literal.

Suggerimenti aggiuntivi per le queryAdditional query tips

  • Verificare che tutte le colonne siano tipizzate in modo appropriatoEnsure all columns are typed appropriately
  • Le colonne presentano nomi descrittivi (vedere domande e risposte)Columns have informative names (see Q&A)
  • Per la logica condivisa, è consigliabile usare le funzioni o le queryFor shared logic, consider using functions or queries
  • I livelli di privacy non sono attualmente supportati nel servizio; se viene visualizzato un prompt dei comandi sui livelli di privacy, potrebbe essere necessario riscrivere la query per usare i percorsi relativiPrivacy levels are not currently supported in the service - if you get a prompt about privacy levels, you may need to re-write the query to use relative paths

Modello di datiData Model

Un modello di dati ben definito assicura che i clienti possano interagire in modo facile e intuitivo con il pacchetto di contenuto.A well-defined data model will ensure your customers can easily and intuitively interact with the content pack. Creare il modello di dati in Power BI Desktop.Create the data model in the Power BI Desktop.

Nota

La maggior parte della modellazione di base (tipizzazione, nomi di colonna) deve essere eseguita nelle query.Much of the basic modelling (typing, column names) should be done in the queries.

Domande e risposteQ&A

La modellazione avrà effetto anche sul modo in cui le domande e risposte possono fornire risultati per i clienti.The modelling will also affect how well Q&A can provide results for your customers. Assicurarsi di aggiungere sinonimi alle colonne usate di frequente e che le colonne siano denominate in modo corretto nelle query.Ensure you add synonyms to commonly used columns and that your columns are properly named in the queries.

Suggerimenti aggiuntivi per il modello di datiAdditional data model tips

  • A tutte le colonne di valore è applicata la formattazioneAll value columns have formatting applied >[!NOTE] >I tipi devono essere applicati nella query.Types should be applied in the query.
  • La formattazione è applicata tutte le misureAll measures have formatting applied
  • Il riepilogo predefinito è impostato,Default Summarization is set. in particolare "Non riepilogare", se applicabile (ad esempio, per i valori univoci)Especially "Do Not Summarize", when applicable (for unique values for example)
  • La categoria di dati è stata impostata, se applicabileData Category has been set, when applicable
  • Le relazioni sono impostate, in base alle esigenzeRelationships are set, as necessary

RelazioniReports

Le pagine del report offrono maggiori informazioni sui dati inclusi nel pacchetto di contenuto.The report pages offer additional insight into the data included in your content pack. Usare le pagine dei report per rispondere alle principali domande aziendali che il pacchetto di contenuto cerca di risolvere.Use the pages of the reports to answer the key business questions your content pack is trying to address. Creare il report usando Power BI Desktop.Create the report using the Power BI Desktop.

Nota

È possibile includere un solo report in un pacchetto di contenuto; sfruttare le diverse pagine per richiamare sezioni specifiche dello scenario.Only one report may be included in a content pack, take advantage of the different pages to call out particular sections of your scenario.

Suggerimenti aggiuntivi per i reportAdditional report tips

  • Usare più di un elemento visivo per ogni pagina per il filtro incrociatoUse more than one visual per page for cross-filtering
  • Allineare attentamente gli elementi visivi (evitare la sovrapposizione)Align the visuals carefully (no overlapping)
  • Impostare la pagina sulla modalità di layout "4:3" o "16:9"Page is set to "4:3" or "16:9" mode for layout
  • Tutte le aggregazioni presentate devono essere significative dal punto di vista numerico (medie, valori univoci)All of the aggregations presented make numeric sense (averages, unique values)
  • Il sezionamento deve produrre risultati razionaliSlicing produces rational results
  • Il logo deve essere presente almeno nel report principaleLogo is present on at least the top report
  • Gli elementi devono essere resi, per quanto possibile, nella combinazione di colori del clienteElements are in the client's color scheme to the extent possible

DashboardDashboard

Il dashboard è il principale punto di interazione con il pacchetto di contenuto per i clienti.The dashboard is the main point of interaction with your content pack for your customers. Deve includere una panoramica del contenuto, in particolare le metriche importanti per lo scenario aziendale.It should include an overview of the content included, especially the important metrics for your business scenario.

Per creare un dashboard per il pacchetto di contenuto modello, è sufficiente caricare il PBIX usando Recupera dati > File o la pubblicazione diretta da Power BI Desktop.To create a dashboard for your template content pack, simply upload your PBIX through Get Data > Files or publish directly from the Power BI Desktop.

Nota

I pacchetti di contenuto modello richiedono un singolo report e set di dati per ogni pacchetto di contenuto.Template content packs currently require a single report and dataset per content pack. Non aggiungere contenuto di più report o set di dati al dashboard usato nel pacchetto di contenuto.Do not pin content from multiple reports/datasets onto the dashboard used in the content pack.

Suggerimenti aggiuntivi per il dashboardAdditional dashboard tips

  • Mantenere lo stesso tema durante l'aggiunta per garantire la coerenza dei riquadri nel dashboardMaintain the same theme when pinning so that the tiles on your dashboard are consistent
  • Aggiungere un logo al tema in modo che i clienti conoscano l'origine del pacchettoPin a logo to the theme so consumers know where the pack is from
  • Il layout consigliato per la maggior parte delle risoluzioni dello schermo prevede la presenza di 5-6 riquadri di piccole dimensioniSuggested layout to work with most screen resolutions is 5-6 small tiles wide
  • Tutti i riquadri del dashboard devono avere titoli o sottotitoli appropriatiAll dashboard tiles should have appropriate titles/subtitles
  • Prendere in considerazione i raggruppamenti nel dashboard per diversi scenari, verticalmente oppure orizzontalmenteConsider groupings in the dashboard for different scenarios, either vertically or horizontally

Riepilogo delle restrizioniSummary of restrictions

Come indicato nelle sezioni precedenti, i pacchetti di contenuto modello presentano una serie di restrizioni:As listed in the above sections, currently the template content packs have a set of restrictions:

SupportatoSupported Non supportatoNot Supported
Set di dati integrati in PB DesktopDatasets built in PBI Desktop Set di dati di altri pacchetti di contenuto o input, ad esempio i file ExcelDatasets from other content packs or inputs such as Excel files
Origine dati supportata per l'aggiornamento nel cloud di dati pianificatiData source supported for cloud Scheduled Data refresh La query diretta o la connettività locale non è supportataDirect query or on-prem connecitivty is not supported
Query che restituiscono uno schema coerente o errori laddove appropriatoQueries returning consistent schema or errors where appropriate Schemi dinamici o personalizzatiDynamic or custom schemas
Una sola origine dati per ogni set di datiOne data source per dataset Più origini dati, ad esempio mashup o URL che vengono rilevati come più origini datiMultiple data sources such as mashups or URLs that are detected as mutliple data sources
Parametri di tipo testoParameters of type text Altri tipi di parametro (ad esempio la data) o "elenco consentito di valori"Other parameter types (such as date) or "list allowed of values"
Un solo dashboard, report e set di datiOne dashboard, report and dataset Più dashboard, report o set di datiMultiple dashboards, reports or datasets

Passaggio successivoNext step

Test e invio dei pacchetti di contenutoContent Pack Testing and Submission