Creare un'app modello in Power BI

Questo articolo contiene istruzioni dettagliate per la creazione di un'app modello di Power BI. Le app modello di Power BI consentono ai partner di Power BI di creare app Power BI con poco o nessuna codifica e distribuirle a qualsiasi cliente di Power BI.

Se è possibile creare report e dashboard di Power BI, è possibile diventare un generatore di app modello e creare e creare un pacchetto di contenuto analitico in un'app. È quindi possibile distribuire l'app in altri tenant di Power BI tramite qualsiasi piattaforma disponibile, ad esempio AppSource o il proprio servizio Web. Se si distribuisce l'app modello tramite il proprio servizio Web, è possibile automatizzare parte del processo di installazione per semplificare le operazioni per i clienti.

Gli amministratori di Power BI regolano e controllano chi nell'organizzazione può creare app modello e chi può installarle. Gli utenti autorizzati possono installare l'app modello, modificarla e distribuirla ai consumer di Power BI nelle organizzazioni.

Prerequisiti

Ecco i requisiti per la creazione di un'app modello:

Creare l'area di lavoro modello

Per creare un'app modello che è possibile distribuire ad altri tenant di Power BI, è necessario crearla in un'area di lavoro.

  1. Nella servizio Power BI creare un'area di lavoro come descritto in Creare un'area di lavoro in Power BI. Nella sezione Avanzate selezionare Sviluppare un'app modello.

    Screenshot that shows Develop a template app.

    Importante

    La capacità assegnata all'area di lavoro di Generatore app non determina l'assegnazione della capacità delle aree di lavoro in cui i programmi di installazione dell'app installano l'app. Ciò significa che un'app sviluppata in un'area di lavoro di capacità Premium non verrà necessariamente installata in un'area di lavoro per la capacità Premium. Non è pertanto consigliabile usare la capacità Premium per l'area di lavoro del generatore, perché le aree di lavoro del programma di installazione potrebbero non essere capacità Premium e la funzionalità che si basa sulla capacità Premium non funzionerà a meno che il programma di installazione riassegna manualmente l'area di lavoro installata alla capacità Premium.

  2. Al termine della creazione dell'area di lavoro, selezionare Salva.

Nota

Sono necessarie autorizzazioni dall'amministratore di Power BI per promuovere le app modello.

Aggiungere contenuto all'area di lavoro per le app modello

Come per una normale area di lavoro di Power BI, il passaggio successivo consiste nell'aggiungere contenuto all'area di lavoro. Se si usano parametri in Power Query, assicurarsi che abbiano tipi ben definiti, ad esempio Text. I tipi Any e Binary non sono supportati.

Per suggerimenti da considerare quando si creano report e dashboard per l'app modello, vedere Suggerimenti per la creazione di app modello in Power BI.

Definire le proprietà dell'app modello

Ora che il contenuto è disponibile nell'area di lavoro, è possibile crearne il pacchetto in un'app modello. Il primo passaggio consiste nel creare un'app modello di test, accessibile solo dall'interno dell'organizzazione nel tenant.

  1. Nell'area di lavoro per le app modello selezionare Crea app.

    Screenshot that shows Create app.

    Compilare quindi altre opzioni per l'app modello in sei schede.

  2. Nella scheda Personalizzazione completare i campi seguenti:

    • Nome app
    • Descrizione
    • Sito di supporto. Il collegamento di supporto viene visualizzato sotto le informazioni sull'app dopo aver ridistribuito l'app modello come app aziendale.
    • Logo dell'app. Il logo ha un limite di dimensioni di file di 45.000, deve avere proporzioni 1:1 e deve essere in un formato di file .png, .jpg o .jpeg .
    • Colore del tema dell'app

    Screenshot that shows the Branding tab.

  3. Nella scheda Navigazione è possibile attivare Nuovo generatore di spostamento per definire il riquadro di spostamento dell'app.

    Screenshot that shows the Navigation tab.

    Se non si attiva Nuovo generatore di spostamento, è possibile selezionare una pagina di destinazione dell'app. Definire un report o un dashboard come pagina di destinazione dell'app. Usare una pagina di destinazione che restituisca l'impressione desiderata.

  4. Nella scheda Controllo impostare i limiti e le restrizioni degli utenti dell'app sul contenuto dell'app. Puoi usare questo controllo per proteggere la proprietà intellettuale nella tua app.

    Screenshot that shows the Control tab.

    Nota

    Se si desidera proteggere i dati, disabilitare l'opzione Scarica il report nel file e quindi configurare le altre due opzioni in base alle esigenze.

    Perché?:

    I controlli visualizzazione, modifica ed esportazione in questa scheda si applicano solo alla servizio Power BI. Dopo aver scaricato il file con estensione pbix , non è più presente nel servizio. Inserisce una copia dei dati, non protetta, in una posizione scelta dall'utente. Non si ha più alcun controllo sulle operazioni che l'utente può eseguire con esso.

    Se si vuole limitare l'accesso alle query e alle misure, consentendo comunque agli utenti di aggiungere origini dati personalizzate, è consigliabile controllare solo le opzioni Esporta o connettersi esternamente ai dati . In questo modo gli utenti possono aggiungere origini dati personalizzate senza poter modificare il modello semantico. Per altre informazioni, vedere Usare modelli compositi in Power BI Desktop.

  5. I parametri vengono creati nel file con estensione pbix originale (altre informazioni sulla creazione di parametri di query). Le funzionalità di questa scheda consentono al programma di installazione dell'app di configurare l'app dopo l'installazione quando si connettono ai dati.

    Screenshot that shows the Parameters tab.

    Ogni parametro ha un nome, che deriva dalla query e un campo Valore . Durante l'installazione sono disponibili tre opzioni per ottenere un valore per il parametro:

    • È possibile richiedere all'utente che installa l'app di immettere un valore.

      In questo caso, viene fornito un esempio che l'utente sostituisce. Per configurare un parametro in questo modo, selezionare la casella di controllo Obbligatorio e quindi fornire un esempio nella casella di testo che mostra all'utente il tipo di valore previsto, come illustrato nell'esempio seguente.

      Screenshot of a parameter value required from the user.

    • È possibile specificare un valore prepopolato che l'utente che installa l'app non può modificare.

      Un parametro configurato in questo modo è nascosto all'utente che installa l'app. È consigliabile usare questo metodo solo se si è certi che il valore prepopolato sia valido per tutti gli utenti. In caso contrario, usare il primo metodo che richiede l'input dell'utente.

      Per configurare un parametro in questo modo, immettere il valore nella casella di testo Valore e quindi selezionare l'icona di blocco in modo che il valore non possa essere modificato. L'esempio seguente illustra questa opzione:

      Screenshot of an absolute parameter value.

    • È possibile specificare un valore predefinito che l'utente può modificare durante l'installazione.

      Per configurare un parametro in questo modo, immettere il valore predefinito desiderato nella casella di testo Valore e lasciare sbloccata l'icona di blocco, come nell'esempio seguente:

      Screenshot of a changeable default parameter value.

    In questa scheda viene fornito anche un collegamento alla documentazione dell'app.

  6. Nella scheda Autenticazione selezionare il metodo di autenticazione da usare. Le opzioni disponibili dipendono dai tipi di origine dati usati.

    Screenshot that shows the Authentication tab.

    Il livello di privacy viene configurato automaticamente:

    • Una singola origine dati viene configurata automaticamente come privata.
    • Un'origine dati multi anonima viene configurata automaticamente come pubblica.
  7. Nella fase di test, nella scheda Accesso decidere chi altro nell'organizzazione può installare e testare l'app. Si tornerà e si modificheranno queste impostazioni in un secondo momento. L'impostazione non influisce sull'accesso dell'app modello distribuita.

    Screenshot of the Access tab.

  8. Selezionare Crea app.

    Viene visualizzato un messaggio che informa che l'app di test è pronta, con un collegamento per copiare e condividere con i tester dell'app.

    Screenshot of the message that the test app is ready.

    È stato eseguito anche il primo passaggio del processo di gestione delle versioni seguente.

Gestire la versione dell'app modello

Prima di rilasciare pubblicamente l'app modello, assicurarsi che sia pronta. Nel riquadro di gestione delle versioni di Power BI è possibile seguire e controllare il percorso completo della versione dell'app. È anche possibile attivare la transizione dalla fase alla fase. Le fasi comuni sono:

  • Generare un'app di test solo per i test all'interno dell'organizzazione.
  • Alzare di livello il pacchetto di test alla fase di pre-produzione e testare all'esterno dell'organizzazione.
  • Alzare di livello il pacchetto di pre-produzione alla versione di produzione in Produzione.
  • Eliminare qualsiasi pacchetto o ricominciare da una fase precedente.

L'URL non cambia man mano che ci si sposta tra le fasi di rilascio. L'innalzamento di livello non influisce sull'URL stesso.

Per scorrere le fasi di rilascio:

  1. Nell'area di lavoro modello selezionare Gestione versioni.

    Screenshot that shows Release Management in the template workspace.

  2. Se sono stati seguiti i passaggi descritti in questo articolo per creare l'app di test, il punto accanto a Testing sarà già compilato. Selezionare Recupera collegamento.

    Se l'app non è ancora stata creata, selezionare Crea app per avviare il processo di creazione dell'app modello.

    Screenshot of the Release Management pane with Get link highlighted.

  3. Per testare l'esperienza di installazione dell'app, copiare il collegamento nella finestra e incollarlo in una nuova finestra del browser.

    Da qui, segui la stessa procedura che seguirai i programmi di installazione dell'app. Per altre informazioni, vedere Installare e distribuire app modello nell'organizzazione.

  4. Nella finestra di dialogo selezionare Installa.

  5. Al termine dell'installazione, selezionare l'app nell'elenco App per aprirla.

  6. Verificare che l'app di test disponga dei dati di esempio. Per apportare modifiche, tornare all'app nell'area di lavoro originale. Aggiornare l'app di test fino a quando non si è soddisfatti.

  7. Quando si è pronti per alzare di livello l'app alla pre-produzione per i test all'esterno del tenant, tornare al riquadro Gestione versioni e selezionare Alza di livello l'app.

    Screenshot of the Release Management pane with Promote app highlighted.

    Nota

    Quando si alza di livello l'app, diventa disponibile pubblicamente all'esterno dell'organizzazione.

    Se l'opzione Alza di livello app non è visibile, contattare l'amministratore di Power BI per concedere le autorizzazioni per lo sviluppo di app modello nel portale di amministrazione.

  8. Nella finestra di dialogo selezionare Alza di livello.

  9. Copiare il nuovo URL da condividere all'esterno del tenant per il test. Questo collegamento è anche quello che invii per iniziare il processo di distribuzione dell'app in AppSource creando una nuova offerta del Centro per i partner.

    Inviare solo collegamenti di pre-produzione al Centro per i partner. Dopo l'approvazione dell'app e la notifica che viene pubblicata in AppSource, è possibile promuovere il pacchetto in produzione in Power BI.

  10. Quando l'app è pronta per la produzione o la condivisione tramite AppSource, tornare al riquadro Gestione versioni e selezionare Alza di livello l'app accanto a Pre-produzione.

  11. Selezionare Alza di livello.

    Ora l'app è in produzione e pronta per la distribuzione.

    Screenshot of the Release Management pane with the app in production.

Per rendere l'app ampiamente disponibile agli utenti di Power BI in tutto il mondo, inviarla ad AppSource. Per altre informazioni, vedere l'offerta Creare un'app Power BI.

Automatizzare la configurazione dei parametri durante l'installazione

Se si è un fornitore di software indipendente e si distribuisce l'app modello tramite il servizio Web, è possibile creare automaticamente automazione che configura i parametri dell'app modello quando i clienti installano l'app in Power BI. La configurazione automatica semplifica le operazioni per i clienti e aumenta la probabilità di un'installazione corretta, perché i clienti non devono fornire dettagli che potrebbero non conoscere. Per altre informazioni, vedere Configurazione automatica di un'installazione di un'app modello.