Test dei pacchetti di contenuto modello per Power BITesting template content packs for Power BI

Esistono diversi modi per testare un pacchetto di contenuto prima di inviarlo per la pubblicazione.There are multiple ways to test your content pack before submitting it for publishing.

Nota

Se il pacchetto di contenuto usa connettore dati personalizzato sviluppato dall'utente, non riuscirà a testare l'aggiornamento dei dati o il pacchetto di contenuto del modello come descritto di seguito.If your content pack uses a custom Data Connector that you developed, you will not be able to test the data refresh or the template content pack as described below. In tal caso, inviare il pacchetto di contenuto da testare al team di Power BI.If that is the case, please proceed to submit your content pack and the Power BI team will work with you on testing your content pack.

Test dell'aggiornamento pianificato dei datiTesting Scheduled Data Refresh

I pacchetti di contenuto dei modelli usano l'aggiornamento in PowerBI.com per creare un'istanza di un pacchetto di contenuto modello con i dati dei clienti quando questi effettuano la connessione.Template content packs leverage Refresh in PowerBI.com to instantiate a content pack with the customer's data when they connect. Prima che il pacchetto di contenuto venga reso disponibile pubblicamente, è possibile testare questo flusso con il file Desktop che è stato creato.Prior to the content pack being publicly available, you can test this flow with the Desktop file you've created.

Dopo aver caricato il file, selezionare "…" accanto al set di dati e selezionare Pianifica aggiornamento.After uploading the file, select the "…" next to the dataset and select Schedule Refresh. Configurare le credenziali per l'origine.Configure credentials for the source. Assicurarsi che l'aggiornamento del set di dati avvenga correttamente. A questo scopo, provare sia "Aggiorna ora" sia "Aggiornamento pianificato".Make sure that your dataset refreshes successfully, try both "Refresh Now" and "Scheduled Refresh". In caso di errori di aggiornamento, controllare il messaggio di errore e convalidare le query e il sistema finale.If your refresh hits any failures, check the error message and validate your queries and your end system.

Suggerimenti aggiuntivi per l'aggiornamentoAdditional refresh tips

  • Quando si prova a pianificare l'aggiornamento deve essere rilevata una sola origine datiOnly one data source should be detected when you try to schedule refresh
  • La connessione di test deve indicare che l'utente riuscirà a caricare il pacchetto di contenuto.Test connection should indicate that your user will be able to load the content pack. Diversamente, verificare che le query gestiscano i casi di errore aggiuntivi.If that's not the case, ensure your queries handle the additional error cases.
  • L'aggiornamento dovrebbe essere completato in un tempo ragionevole, non superiore a 5 minuti circa.Refresh should complete in a reasonable time, ~5mins is suggested

impostazioni

Modelli di testTesting Templates

Un pacchetto di contenuto del modello è simile alle soluzioni esistenti ad eccezione del fatto che non include i dati effettivi nel set di dati.A template content pack is similar to existing solutions except that it does not include the actual data in the dataset. Al contrario, quando un utente utilizza o crea un'istanza di un modello, riceve la richiesta di immettere i parametri e le credenziali per connettersi.Instead, when a user consumes or instantiates a template, they are prompted for parameters and credentials in order to connect. Una volta connesso, noterà i propri dati nel dashboard, nel report e nei set di dati.Once connected, they'll see their own data in the dashboard, report and datasets.

Dopo aver creato un'istanza del pacchetto di contenuto, gli utenti possono accedere alle impostazioni del set di dati, incluso l'aggiornamento pianificato. Tutte le impostazioni della sicurezza a livello di riga nel set di dati non sono pubblicate nel pacchetto di contenuto.After a user instantiates the content pack they have access to the dataset settings including scheduled refresh, any RLS settings on the dataset are not published with the content pack.

Nota

I pacchetti di contenuto di modello possono includere solo 1 dashboard, 1 report e 1 set di dati.Template content packs can only include 1 dashboard, 1 report and 1 dataset. Vedere l'elenco delle restrizioni nella pagina Template Content Pack Authoring (Creazione di pacchetti di contenuto modello).Please see the list of restrictions in the authoring page.

Per abilitare la creazione del modello per il tenant, rivolgersi all'amministratore di Power BI per abilitare l'opzione della funzionalità riportata di seguito.To enable template creation for your tenant, please work with your Power BI admin to enable the feature switch below.

opzionefunzionalità

Una volta abilitata, viene visualizzata una casella di controllo nella parte inferiore della finestra "Crea pacchetto di contenuto", che consente di pubblicare un pacchetto di contenuto del modello per l'organizzazione.Once enabled, you'll see a checkbox at the bottom of "Create content pack", allowing you to publish a template content pack to your organization.

casellacontrollo

DenominazioneNaming

Si consiglia di denominare il dashboard, il report e il set di dati in modo coerente nel pacchetto di contenuto.We suggest naming your dashboard, report and dataset consistently across your content pack. Tali nomi sono hardcoded e saranno uguali per tutti gli utenti, quindi l'uso del nome del prodotto/dello scenario può aiutare i clienti a trovarli.These names are hardcoded and will be the same for all users, so using your product/scenario name can make it easier for your customers to locate.

Suggerimenti aggiuntivi sui modelliAdditional template tips

  • Verificare che i parametri specificati nelle query sono significativi per gli utenti finaliEnsure the parameters you specified in the queries are meaningful to your end users
  • Valutare per quanto tempo l'utente finale dovrà attendere il completamento dell'aggiornamento pianificatoConsider how long your end user will be waiting for scheduled refresh to complete

creare

InvioSubmission

Il processo di invio attraverso Microsoft AppSource consente di pubblicare il pacchetto di contenuto modello nella raccolta di pacchetti di contenuto del servizio in PowerBI.com, nonché di elencare il pacchetto di contenuto in Microsoft AppSource.The submission process through Microsoft AppSource will allow you to publish your template content pack in the service content packs gallery in PowerBI.com as well as list your content pack in Microsoft AppSource.

Prima dell'invioBefore submission

  • Esaminare i suggerimenti di creazione per ciascuno degli elementi all'interno del pacchetto di contenutoReview the authoring tips for each of the artifacts within the content pack
  • Testare e connettersi con vari account e condizioni di datiTest and connect with various accounts and data conditions. (ignorare questo passaggio se è stato sviluppato un connettore dati personalizzato).(Skip this step if you developed your own custom Data Connector)
  • Esaminare tutti gli elementi visivi, controllare con attenzione la presenza di eventuali errori di ortografiaReview all visuals, look carefully for misspelled items
  • Verificare che il pacchetto di contenuto risponda correttamente alle domande e risposte; si consiglia di testare almeno 30 domande diverse nel modello di datiEnsure the content pack responds well to Q&A, we suggest testing at least 30 varied questions across the data model. (ignorare questo passaggio se è stato sviluppato un connettore dati personalizzato).(Skip this step if you developed your own custom Data Connector)

InvioSubmission

Quando si è pronti per l'invio, visitare la pagina di invio di app su AppSource e inviare le informazioni.Once ready to submit, visit the Apps submission page on AppSource and submit your information. Assicurarsi di selezionare Power BI dall'elenco dei prodotti disponibiliPlease make sure to select Power BI from the available list of products

Il team di Power BI esaminerà l'invio e contatterà l'utente per verificare che tutti gli elementi soddisfino i requisiti di invio.The Power BI team will review your submission and will reach out to you to ensure all the artifacts meets the submission requirements. Oltre a verificarne la completezza, verrà anche convalidata la qualità del dashboard e dei report forniti, assicurandosi che soddisfino lo scenario aziendale descritto nell'applicazione.In addition to being complete, we'll also validate the quality of the dashboard and reports provided ensuring they meet the business scenario described in the application.

AggiornamentiUpdates

L'aggiornamento del pacchetto di contenuto segue un flusso simile a quello dell'invio originale.Updating your content pack follows a similar flow to the original submission.