Questo articolo risponde alle domande comuni sull'invio di app a Microsoft AppSource tramite il Centro per i partner.
Per la versione più recente dei criteri di certificazione, vedere Criteri di certificazione.
Come è possibile evitare errori durante l'invio dell'app a Microsoft AppSource?
Per evitare errori di invio comuni:
Assicurarsi che il numero di versione nel modulo di invio corrisponda al numero di versione nel manifesto dell'app.
Nota
Specificare la versione dell'app usando la sintassi seguente: . b. c . d dove un è un numero intero compreso tra 1 e 9999 e ognuno di b , c , d è un numero intero compreso tra 0 e 9999. Esempi: 1.0.0.0, 6.23.0.1.
Assicurarsi che tutte le posizioni siano protette da SSL (HTTPS).
Assicurarsi di specificare un'icona nel manifesto e che l'icona sia ridimensionata e formattata correttamente.
Assicurarsi che l'ID sia univoco. Ad esempio, non creare un manifesto per un secondo componente aggiuntivo in base a un altro manifesto del componente aggiuntivo inviato senza modificare l'ID nel nuovo manifesto.
Per i componenti aggiuntivi di Office, assicurarsi di usare lo schema del manifesto versione 1.1. Per informazioni sull'aggiornamento del manifesto alla versione 1.1, vedere Aggiornare l'API JavaScript più recente per la libreria di Office e lo schema del manifesto del componente aggiuntivo versione 1.1.
Per i componenti aggiuntivi di Office, assicurarsi di specificare un URL di supporto nel manifesto. Se si usa il manifesto XML, impostare il valore dell'elemento SupportUrl. Se si usa il manifesto unificato per Microsoft 365, usare la proprietà developer.websiteUrl. L'URL del supporto deve essere una pagina Web disponibile pubblicamente e non deve richiedere l'autenticazione. Non è possibile usare pagine di social media personali o repository GitHub per l'URL del supporto. Non è inoltre possibile usare collegamenti a file ospitati online, ad esempio un documento di Word in OneDrive, DropBox o Google Docs.
Per tutte le app, assicurarsi che il manifesto sia valido rispetto allo schema. Per informazioni sulla convalida dello schema, vedere Informazioni di riferimento sullo schema per i manifesti dei componenti aggiuntivi di Office (v1.1) o informazioni di riferimento sullo schema per i manifesti dei componenti aggiuntivi di SharePoint.
Assicurarsi che l'app sia testata e che sia completamente funzionante.
Assicurarsi che i componenti aggiuntivi di SharePoint specifichino le impostazioni locali supportate.
Se non si specificano impostazioni locali supportate, l'app non verrà accettata da Microsoft AppSource. Per informazioni dettagliate, vedere Informazioni sul supporto delle impostazioni locali necessarie per tutti i componenti aggiuntivi.
Assicurarsi che gli ID client OAuth corrispondano.
Se il componente aggiuntivo di SharePoint accede ai servizi tramite OAuth, assicurarsi che l'ID client OAuth creato corrisponda all'ID client nel manifesto dell'app.
Il pacchetto del componente aggiuntivo di SharePoint deve essere conforme alla Convenzione open packaging.
Assicurarsi di inviare un collegamento alla privacy.
Assicurarsi che tutti i collegamenti video inviati vengano effettivamente inviati a un file video o a una pagina che include un video.
Se il componente aggiuntivo di Office è disponibile in iOS, non includere "app" nel titolo del componente aggiuntivo o nella descrizione breve del componente aggiuntivo.
Se si apportano aggiornamenti all'invio, quando è necessario inviarlo di nuovo a Microsoft AppSource?
Se si apportano aggiornamenti al servizio Web per l'app, non è necessario inviarlo di nuovo. Tuttavia, se si apportano modifiche a tutti gli elementi o i dati inviati tramite il Centro per i partner, ad esempio il manifesto, gli screenshot o l'icona, è necessario inviarli di nuovo in modo che Microsoft AppSource possa implementare tali modifiche. È necessario inviare di nuovo le app con un manifesto aggiornato che include un nuovo numero di versione. È inoltre necessario assicurarsi di aggiornare il numero di versione nel modulo di invio in modo che corrisponda al numero di versione del nuovo manifesto.
Cosa accade quando si aggiorna l'app a una nuova versione in Microsoft AppSource?
Di seguito è riportato il processo di aggiornamento per i componenti aggiuntivi di Office.
Inviare il manifesto del componente aggiuntivo e del componente aggiuntivo modificato a Microsoft AppSource tramite il Centro per i partner. Il componente aggiuntivo modificato esegue il processo di convalida e, quando approvato, viene reso disponibile in Microsoft AppSource.
Importante
Se l'invio è un aggiornamento e pianifica la disponibilità dell'app a una data futura, l'app esistente verrà annullata da Microsoft AppSource fino alla data di rilascio specificata.
È possibile scegliere di continuare a offrire la versione precedente dell'app in Microsoft AppSource oppure annullare la pubblicazione della versione precedente.
Quando un cliente esistente avvia l'app aggiornata per la prima volta, viene visualizzata una notifica nel riquadro attività o nel corpo del documento che richiede all'utente di aggiornare l'app. Quando l'utente sceglie Aggiorna, viene avviata la versione più recente dell'app.
Nota
La notifica di aggiornamento si applica solo a Excel, PowerPoint e Word. Non si applica a Outlook.
Se la versione aggiornata include nuove autorizzazioni, l'utente deve fornire il consenso.
Nota
Non è possibile avere due o più versioni della stessa app in Microsoft AppSource contemporaneamente, perché ogni app ha un ID asset univoco. Se si pubblica una versione aggiornata dell'app senza annullare la pubblicazione di una versione precedente, si avranno due presentazioni e si divide potenzialmente la base dei clienti.
Gli aggiornamenti dei componenti aggiuntivi di SharePoint vengono gestiti dagli strumenti di gestione delle licenze che fanno parte del catalogo dei componenti aggiuntivi di SharePoint. Per altre informazioni, vedere Processo di aggiornamento dei componenti aggiuntivi di SharePoint.
È possibile inviare un'app a pagamento a Microsoft AppSource?
Tutte le app inviate a Microsoft AppSource tramite il Centro per i partner sono gratuite. È possibile monetizzare l'app tramite Microsoft Commercial Marketplace; per informazioni dettagliate, vedi Monetizzare il componente aggiuntivo.
Come si riceve una notifica dello stato di pubblicazione o delle azioni necessarie?
Dopo la pubblicazione di un'offerta, il proprietario dell'account sviluppatore riceve una notifica dello stato di pubblicazione e delle azioni necessarie tramite posta elettronica e il Centro notifiche nel Centro per i partner. Per altre informazioni sul Centro notifiche, vedere Panoramica del Centro notifiche.
Ricerca per categorie fare riferimento alle API JavaScript per Office nelle app?
Se l'app usa le API JavaScript per Office, è necessario fare riferimento al file di Office.js ospitato da Microsoft dall'URL della rete CDN. Non includere una copia del file Office.js nell'app o fare riferimento a una copia del file ospitato altrove.
Perché le app devono essere protette con SSL?
Le app che non sono protette da SSL (HTTPS) generano errori e avvisi di contenuto non sicuri durante l'uso. Per questo motivo, tutte le app inviate a Microsoft AppSource devono essere protette tramite SSL.
Ricerca per categorie dichiarare il supporto linguistico?
Due aspetti dell'invio sono correlati alle lingue supportate:
Lingue dichiarate nel pacchetto o nel manifesto dell'app. Dichiarare le lingue supportate dall'app a seconda del tipo:
Per i componenti aggiuntivi di SharePoint, dichiarare il supporto della lingua usando l'elemento SupportedLocales (PropertiesDefinition complexType) (Manifesto del componente aggiuntivo di SharePoint) nel manifesto del componente aggiuntivo all'interno del pacchetto del componente aggiuntivo. Per altre informazioni, vedere Esplorare la struttura del manifesto dell'app e il pacchetto di un componente aggiuntivo di SharePoint.
Per i componenti aggiuntivi di Office che non sono dizionari, dichiarare il supporto per la lingua usando gli elementi DefaultLocale e Override nel manifesto. Per altre informazioni, vedere Localizzazione per i componenti aggiuntivi di Office.
Per i componenti aggiuntivi di Office che sono dizionari, è anche possibile usare l'elemento TargetDialects all'interno del manifesto del componente aggiuntivo.
Nel Centro per i partner è possibile selezionare le lingue nella pagina Presentazioni nello Store.
Nota
Puoi dichiarare più lingue nel pacchetto dell'app rispetto a quelle disponibili per l'invio nel Centro per i partner.
Se l'app è destinata alle aziende, come influisce sull'invio?
Alcuni requisiti sono rinunciati o modificati se l'app o il componente aggiuntivo è destinato solo a organizzazioni e aziende di grandi dimensioni e non è destinato al marketplace commerciale. Si applicano tutti gli altri requisiti dei criteri del marketplace commerciale. Nella tabella seguente vengono descritte le differenze principali.
| Comportamento | App marketplace commerciale | L'app è destinata solo a organizzazioni e aziende di grandi dimensioni | Criteri relativi al marketplace commerciale |
|---|---|---|---|
| Home page di AppSource | Può essere visualizzato nelle home page specifiche dell'applicazione in AppSource e sarà individuabile tramite la ricerca e disponibile per le campagne Web e di posta elettronica. | Non verrà visualizzato nelle home page, ma sarà individuabile tramite la ricerca e sarà disponibile per le campagne Web e di posta elettronica. | Non applicabile. |
| Nome del marchio o del servizio | Il titolo non può includere il nome del marchio o del servizio. | Il titolo può includere il nome del marchio o del servizio, soprattutto se consente di comunicare lo scopo del componente aggiuntivo o dell'app. | 1100.7 |
| Esperienza di prima esecuzione senza problemi | Obbligatorio. Deve offrire un'esperienza di prima esecuzione senza problemi che spiega chiaramente come usarla. Ad esempio, nella schermata start del componente aggiuntivo descrivere le funzionalità e i vantaggi in poche righe. Inoltre, se gli utenti devono iscriversi o accedere per usare l'app, il valore di avere tale account o servizio deve essere reso chiaro prima di iscriversi. | Non obbligatorio, ma deve includere un contatto di posta elettronica o un collegamento al sito Web in modo che gli utenti possano saperne di più sui servizi. | 1100.5 |
| Esperienza di accesso/disconnesso | Solo componenti aggiuntivi: obbligatorio se il componente aggiuntivo richiede account o servizi esterni, nel qual caso deve essere fornito un collegamento di accesso per ognuno e un collegamento di disconnessione quando l'utente ha eseguito l'accesso. In caso contrario, non obbligatorio. | Solo componenti aggiuntivi: obbligatorio, a meno che il componente aggiuntivo non richieda account o servizi esterni in cui le registrazioni vengano gestite dall'azienda all'esterno del componente aggiuntivo e non dal singolo utente. | 1100.5 |
| Esperienza di iscrizione | Solo componenti aggiuntivi: obbligatorio se il componente aggiuntivo richiede account o servizi esterni, nel qual caso deve essere fornito un collegamento di iscrizione per ognuno di essi. In caso contrario, non obbligatorio. | Solo componenti aggiuntivi: obbligatorio, a meno che il componente aggiuntivo non richieda account o servizi esterni in cui le registrazioni vengano gestite dall'azienda all'esterno del componente aggiuntivo e non dal singolo utente. | 1100.5 |
| Proposta di valore | Obbligatorio. Deve fornire una soluzione software utilizzabile e vantaggi significativi, ad esempio efficienza avanzata, funzionalità innovative o vantaggi strategici. Poiché deve essere più di una semplice utilità o di ambito limitato, deve anche giustificare l'investimento necessario per consentire agli utenti di imparare e usare. | Non obbligatorio, ma deve includere un contatto di posta elettronica o un collegamento al sito Web in modo che gli utenti possano saperne di più sui servizi. | 1100.5 |
Se l'app o il componente aggiuntivo è destinato solo a organizzazioni e aziende di grandi dimensioni, è necessario indicare questa opzione nella sezione Note per la certificazione dell'invio di presentazioni nel marketplace, inclusi anche tutti i requisiti che si sceglie di non fornire a causa di tale causa. Si supponga, ad esempio, che il componente aggiuntivo non fornisca un collegamento di iscrizione perché è destinato alle aziende e soddisfa le altre condizioni. Si potrebbe dire qualcosa di simile al seguente: "Questo componente aggiuntivo non fornisce un collegamento di iscrizione perché è destinato all'azienda. Vedere il criterio 1100.5."
In caso contrario, l'app o il componente aggiuntivo verranno considerati come un'app del marketplace commerciale generale.