Pubblicare oggetti visivi personalizzati in AppSourcePublish custom visuals to AppSource

Informazioni su come pubblicare l'oggetto visivo personalizzato in AppSource in modo che altri utenti possano individuarlo e usarlo.Learn how you can publish your custom visual to AppSource for others to discover and use. officeoffice

Dopo aver creato l'oggetto visivo personalizzato può essere utile pubblicarlo in AppSource in modo che altri utenti possano individuarlo e usarlo.Once you have created your custom visual, you may want to publish it AppSource for others to discover and use. A tale scopo, sono necessarie alcune operazioni preliminari.There is some preperation that needs to be done before you can do that. Per altre informazioni su come creare un oggetto visivo personalizzato, vedere Usare gli strumenti di sviluppo per la creazione di oggetti visivi personalizzati.For more information on how to create a custom visual, see Use developer tools to create custom visuals.

Informazioni su AppSourceWhat is AppSource? In breve, è il posto in cui è possibile trovare app SaaS e componenti aggiuntivi per i prodotti e i servizi Microsoft.Simply put, it is the place to find SaaS apps and add-ins for your Microsoft products and service. AppSource connette milioni di utenti di Office 365, Dynamics 365, Cortana Intelligence e altro ancora a soluzioni che li aiutano a lavorare in modo più efficiente, più intelligente o migliore rispetto a prima.AppSource connects millions of users of Office 365, Dynamics 365, Cortana Intelligence, and others, to solutions that help them get work done more efficiently, more insightfully or more beautifully than before.

Preparazione per l'invio dell'oggetto visivo personalizzatoPreparing to submit your custom visual

Dopo aver terminato le operazioni di codifica e test dell'oggetto visivo personalizzato e averlo inserito in un pacchetto PBIVIZ, è necessario che quanto segue sia pronto per l'invio.One you're done coding and testing your custom visual and have packaged it into a pbiviz file, you should also have the following ready for your submission.

ElementoItem ObbligatorioRequired DescrizioneDescription
Pacchetto PBIVIZ contenente tutti i metadati richiestiPbiviz package contains all the required metadata Yes Nome oggetto visivoVisual name
Nome visualizzatoDisplay name
GUIDGUID
VersioneVersion
DescrizioneDescription
Nome e indirizzo di posta elettronica dell'autoreAuthor name and email
File di report PBIX di esempioSample .pbix report file Yes Per presentare l'oggetto visivo, aiutare gli utenti ad acquisire familiarità con lo stesso.To showcase your visual, you should help users to get acquainted with the visual. Sottolineare il valore che l'oggetto visivo conferisce all'utente e fornire esempi di utilizzo, opzioni di formattazione, ecc. È anche possibile aggiungere una pagina "suggerimenti" alla fine con alcuni suggerimenti e trucchi, cose da evitare e simili.You should emphasize on the value the visual brings to the user and give examples of usage, formatting options, etc. You can also add a "hints" page at the end with some tips and tricks, things to avoid and the like.
IconaIcon Yes È necessario includere il logo dell'oggetto visivo personalizzato che verrà visualizzato nella pagina principale dello store.You should include the custom visual logo that will appear in the store front. Il formato può essere PNG, JPG, JPEG o GIF.The format can be .png, .jpg, .jpeg or .gif. Deve essere esattamente 300 px (larghezza) per 300 px (altezza).It must be exactly 300px (width) x 300px (height). Non può essere superiore a 512 KB per le dimensioni del file.It can be no larger than 512kb for the file size.
SchermateScreenshots Yes È necessario fornire almeno una schermata.You must provide at least one screenshot. Il formato può essere PNG, JPG, JPEG o GIF.The format can be .png, .jpg, .jpeg or .gif. Deve essere esattamente 1366 px (larghezza) per 768 px (altezza).It must be exactly 1366px (width) x 768px (height). Le dimensioni del file non possono superare 1024 KB.It can be no larger than 1024kb for the file size. Per un migliore utilizzo, aggiungere fumetti di testo per descrivere la proposta di valore delle caratteristiche basilari in ogni schermata.For greater usage, add text bubbles to articulate the value proposition of key features shown in each screenshot.
Collegamento per il download di supportoSupport download link Yes Fornire l'URL per supportare i clienti che hanno problemi con l'oggetto visivo.Provide the URL to support customers who have issues with your visual. Il formato dell'URL deve includere https:// o http://.The format of your URL should include https:// or http://.
Collegamento al documento sulla privacyPrivacy document link Yes Fornire un collegamento all'informativa sulla privacy per i clienti che usano l'oggetto visivo.Provide a link to the privacy policy for customers who use your visual. Il formato del collegamento deve includere https:// o http://.The format of your link should include https:// or http://.
Contratto di licenza con l'utente finale (EULA)End user license agreement (EULA) Yes È necessario caricare un file del contratto di licenza.You must upload a EULA file. Può trattarsi del proprio contratto di licenza oppure si può usare il contratto di licenza predefinito in Office Store per oggetti visivi personalizzati di Power BI.This can be either your own EULA or use the default EULA within the Office store for Power BI custom visuals. Per usare il contratto di licenza predefinito, incollare il seguente URL nella finestra di dialogo del file "Contratto di licenza con l'utente finale" del dashboard del venditore: https://visuals.azureedge.net/app-store/Power BI - Default Custom Visual EULA.pdf.To use the default EULA, paste the following URL in the seller dashboard's "End User License Agreement" file upload dialog: https://visuals.azureedge.net/app-store/Power BI - Default Custom Visual EULA.pdf.
Collegamento videoVideo link NoNo Per aumentare l'interesse degli utenti per l'oggetto visivo personalizzato, è consigliabile fornire un collegamento a un video sull'oggetto visivo.To increase the interest of users for your custom visual, it is advised to provide a link to a video about your visual. Il formato dell'URL deve includere https:// o http://.The format of your URL should include https:// or http://.
Repository GitHubGitHub repository NoNo È preferibile avere un collegamento valido e pubblico a un repository GitHub contenente le origini dell'oggetto visivo e dati di esempio per consentire ad altri sviluppatori di fornire commenti e suggerimenti e proporre miglioramenti al codice.It is preferred to have a valid and public link to a GitHub repository with sources of your visual and sample data in it to allow other developers to provide feedback and propose improvements to your code.

Invio a Power BISubmitting to Power BI

L'invio inizia con l'invio di un messaggio di posta elettronica al team di invio degli oggetti visivi personalizzati di Power BI.Submission starts with sending an email to the Power BI custom visuals submission team. È possibile inviare il messaggio a pbivizsubmit@microsoft.com.You can email pbivizsubmit@microsoft.com.

Allegare il file PBIVIZ e il file PBIX del report di esempio al messaggio.Attach the .pbiviz file and the sample report .pbix file in your email. Il team di Power BI risponderà con le istruzioni e un file XML del pacchetto dell'app da caricare.The Power BI team will reply back with instructions and a app package XML file to upload. Questo pacchetto dell'app XML è necessario per inviare l'oggetto visivo attraverso il centro per sviluppatori Office.This XML app package is required in order to submit your visual through the Office developer center.

Nota

Per migliorare la qualità e garantire che i report esistenti non subiscano danni, gli aggiornamenti agli oggetti visivi esistenti richiederanno due settimane in più per raggiungere l'ambiente di produzione dopo l'approvazione nello store.To improve quality and assure that existing reports are not breaking, updates to existing visuals will take an additional two weeks to reach production environment after approval in the store.

Invio ad AppSourceSubmitting to AppSource

Dopo aver ottenuto il file XML del pacchetto dell'app dal team di Power BI, passare al centro per sviluppatori per inviare l'oggetto visivo ad AppSource.Once you get the app package XML from the Power BI team, navigate to the developer center to submit your visual to AppSource.

Nota

Per accedere al centro per sviluppatori Office occorre avere un account sviluppatore di Office valido,You must have a valid Office developer account to log in to the Office developer center. che deve essere un account Microsoft (Live ID, ad esempio hotmail.com o outlook.com).An Office developer account must be a Microsoft Account (Live ID, e.g. hotmail.com or outlook.com).

Importante

È necessario inviare un messaggio di posta elettronica con allegati il file PBIVIZ e il file PBIX al team di Power BI prima dell'invio ad AppSource.You must send an email with the .pbiviz file and the .pbix file to the Power BI team before submitting to AppSource. Ciò consente al team di Power BI di caricare i file nel server di condivisione pubblico.This allows the Power BI team to upload the files to the public share server. In caso contrario, lo Store non potrà recuperare i file.Otherwise, the store will not be able to retrieve the files. È necessario inviare i file con ogni nuovo invio di oggetti visivi, eseguire l'aggiornamento agli oggetti visivi esistenti e correzioni degli invii rifiutati.You must send the files with each new visual submission, update to existing visual, and fixes to rejected submissions.

Procedura di invio oggetti visiviProcess to submit visual

Per completare l'invio, seguire questa procedura.Follow the below steps to complete the submission.

  1. Selezionare Aggiungi una nuova app.Select Add a new app.

  2. Selezionare Oggetto visivo personalizzato di Microsoft Power BI e quindi Avanti.Select Power BI custom visual and then Next.
  3. Selezionare il segno + sotto Pacchetto dell'app e selezionare il file XML del pacchetto dell'app ricevuto dal team di Power BI dalla finestra di dialogo Apri file.Select the + under App package and select the app package XML file that you received from the Power BI team from the open file dialog.

  4. Si dovrebbe ricevere la conferma della validità del pacchetto dell'app di Power BI.You should receive an approval that this is a valid Power BI app package.

  5. Compilare i dettagli in Informazioni generiche.Fill out the General info details.

    • Titolo invio: il modo in cui verrà denominato l'invio nel centro sviluppatoriSubmission title: How your submission will be named in the developer center
    • Versione: il numero di versione viene compilato automaticamente dal pacchetto dell'app del componente aggiuntivo.Version: Your version number is auto-populated from your add-in app package.
    • Data di rilascio (UTC): selezionare una data per il rilascio della versione nello store.Release Date (UTC): Select a date for your app to release to the store. Se si sceglie una data futura, l'app non sarà disponibile nello store fino al raggiungimento di tale data.If a future date is chosen, your app will not be available in the store until that date is reached.
    • Categoria: la prima categoria verrà automaticamente compilata come "Visualizzazione dati + BI".Category: The first category will be auto populated as "Data Visualization + BI". Ecco come verranno contrassegnati tutti gli oggetti visivi personalizzati di Power BI. È possibile fornire fino a due altre categorie, per aiutare gli utenti a cercare facilmente l'oggetto visivoThat's how all Power BI custom visuals will be tagged.You may provide up to 2 additional categories, for help users easily search for your visual
    • Note per i test: facoltativo, se si vogliono fornire istruzioni per i tester di MicrosoftTesting notes: optional, if you'd like to provide some instructions for the testers at Microsoft
    • L'app chiama, supporta, contiene o usa la crittografia: lasciare deselezionatoMy app calls, supports, contains, or uses cryptography or encryption: leave unchecked
    • Rendi disponibile questo componente aggiuntivo nel catalogo dei componenti aggiuntivi per Office per iPad: lasciare deselezionatoMake this add-in available in the Office add-in catalog on iPad: leave unchecked
  6. Caricare il logo dell'oggetto visivo selezionando il segno + sotto Logo dell'app.Upload your visual's logo by selecting the + under App logo. Selezionare quindi il file dell'icona nella finestra di dialogo Apri file.Then select the icon file in the open file dialog. Il file deve essere in formato PNG, JPG, JPEG o GIF.The file must be .png, .jpg, .jpeg or .gif. Deve essere esattamente 300 px (larghezza) x 300 px (altezza) e non può superare le dimensioni di 512 KB.It must be exactly 300px (width) x 300px (height) and no larger than 512kb in size.

  7. Compilare i dettagli in Documenti di supporto.Fill out the Support documents details.

    • Collegamento al documento di supportoSupport document link
    • Collegamento al documento sulla privacyPrivacy document link
    • Collegamento videoVideo link
    • Contratto di licenza con l'utente finale (EULA)End User License Agreement (EULA)

      È necessario caricare un file del contratto di licenza.You must upload a EULA file. Può trattarsi del proprio contratto di licenza oppure si può usare il contratto di licenza predefinito in Office Store per oggetti visivi personalizzati di Power BI.This can be either your own EULA or use the default EULA within the Office store for Power BI custom visuals. Per usare il contratto di licenza predefinito, incollare il seguente URL nella finestra di dialogo del file "Contratto di licenza con l'utente finale" del dashboard del venditore: https://visuals.azureedge.net/app-store/Power BI - Default Custom Visual EULA.pdf.To use the default EULA, paste the following URL in the seller dashboard's "End User License Agreement" file upload dialog: https://visuals.azureedge.net/app-store/Power BI - Default Custom Visual EULA.pdf.

  8. Selezionare Avanti e proseguire alla pagina Dettagli.Select Next to proceed to the Details page.
  9. Selezionare Lingua e scegliere una lingua dall'elenco.Select Language and pick a language from the list.

  10. Immettere le informazioni necessarie in "Descrizione".Fill out the "Description" details.

    • Nome app (per questa lingua): immettere il titolo dell'app così come dovrebbe apparire nella pagina principale dello store.App name (for this language): Enter the title of your app as it should appear in the storefront.
    • Descrizione breve: immettere una breve descrizione dell'app, fino a 100 caratteri, così come dovrebbe apparire nella pagina principale dello store.Short description: Enter the short description of your app, up to 100 characters, as it should appear in the storefront. Questa descrizione verrà visualizzata nelle pagine di livello superiore assieme al logo.This description will show up in the top level pages along with the logo. È possibile usare la descrizione del pacchetto PBIVIZ.You can use the description from the pbiviz package.
    • Descrizione lunga: fornire una descrizione più dettagliata dell'app che i clienti vedranno nella pagina dei dettagli dell'app.Long description: Provide a more detailed description of your app that customers will see on your app details page. Per chiedere alla community di migliorare il proprio oggetto visivo rendendolo open source, fornire qui il collegamento all'archivio pubblico, ad esempio GitHub.If you'd like to let the community improve your visual by making it open source, provide the link to the public repository, such as GitHub, here.
  11. Caricare almeno una schermata.Upload at least one screenshot. Il formato può essere PNG, JPG, JPEG o GIF.The format can be .png, .jpg, .jpeg or .gif. Deve essere esattamente 1366 px (larghezza) per 768 px (altezza).It must be exactly 1366px (width) x 768px (height). Le dimensioni del file non possono superare 1024 KB.It can be no larger than 1024kb for the file size. Per un migliore utilizzo, aggiungere fumetti di testo per descrivere la proposta di valore delle caratteristiche basilari in ogni schermata.For greater usage, add text bubbles to articulate the value proposition of key features shown in each screenshot.
  12. Per aggiungere altre lingue, selezionare Aggiungi una lingua e ripetere i passaggi 10 e 11.If you'd like to add more languages, select Add a language and repeat steps 10 and 11. L'aggiunta di altre lingue consentirà agli utenti di visualizzare i dettagli dell'oggetto visivo personalizzato nella propria lingua.Adding more languages will help your users view the custom visual details in their own language. Per impostazione predefinita, per le lingue non elencate verrà configurata la prima lingua selezionata.Languages that will not be listed will default to the first language selected.
  13. Dopo aver aggiunto le lingue, selezionare Avanti per proseguire alla pagina Blocca accesso.When you are done adding languages, select Next to proceed to the Block access page.
  14. Se si vuole impedire a clienti in paesi specifici di usare o acquistare l'app, selezionare la casella di controllo e selezionare dall'elenco.If you want to prevent customers in specific countries or regions from using or purchasing your app, check the box and select from the list.
  15. Selezionare Avanti e proseguire alla pagina Prezzi.Select Next to proceed to the Pricing page.
  16. Attualmente, sono supportati solo oggetti visivi gratuiti e gli acquisti aggiuntivi all'interno dell'oggetto visivo (acquisto in-app) non sono consentiti.Currently, only free visuals are supported and additional purchases inside the visual (In-App purchase) are not allowed. Selezionare Questa app è gratuita.Select This app is free.

    Nota

    Se si seleziona un'altra opzione diversa da gratuita o se è presente del contenuto acquistato in-app nell'oggetto visivo inviato, l'invio verrà rifiutato.If you select any other option other than free, or have an In-App purchase content in the submitted visual, the submission will be rejected.

  17. È ora possibile selezionare Salva come bozza" e inviare in seguito oppure selezionare **Invia per approvazione per inviare l'oggetto visivo personalizzato a Office Store.You can now select Save as draft" and submit later, or select **Submit for approval to submit the custom visual to the Office store.

Rilevamento dello stato e dell'utilizzo dell'invioTracking submission status and usage

È possibile esaminare il criteri di convalida.You can review the validation policies.

Dopo l'invio, sarà possibile visualizzare lo stato di invio nel dashboard dell'app.After submission, you will be able to view the submission status in the app dashboard.

Certificare l'oggetto visivoCertify your visual

Dopo aver creato l'oggetto visivo, è possibile ottenere facoltativamente la certificazione per tale oggetto.Once your visual is created, you can optionally get your visual certified. Per questo motivo, è possibile eseguirlo all'interno del servizio Power BI e usarlo con altre funzionalità del servizio, quali l'esportazione in PowerPoint.This means it can run within the Power BI service and be used with other features of the service such as exporting to PowerPoint. Per altre informazioni, vedere Certificare un oggetto visivo personalizzato.For more information, see Getting a custom visual certified.

Passaggi successiviNext steps

Usare gli strumenti di sviluppo per la creazione di oggetti visivi personalizzatiUse developer tools to create custom visuals
Visualizzazioni in Power BIVisualizations in Power BI
Visualizzazioni personalizzate in Power BICustom Visualizations in Power BI
Certificare un oggetto visivo personalizzatoGetting a custom visual certified

Altre domande?More questions? Provare a rivolgersi alla community di Power BITry asking the Power BI Community