Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Gli oggetti visivi di Power BI certificati sono oggetti visivi di Power BI in AppSource che soddisfano i requisiti e i test del codice del team di Microsoft Power BI. I test eseguiti sono studiati per verificare che l'oggetto visivo non abbia accesso a risorse o servizi esterni. Microsoft non è tuttavia l'autore di oggetti visivi personalizzati di terze parti. È quindi consigliabile contattare l'autore direttamente per verificare la funzionalità di tali oggetti.
Gli oggetti visivi di Power BI certificati possono essere usati come qualsiasi altro oggetto visivo di Power BI. Offrono più funzionalità rispetto agli oggetti visivi non certificati. Ad esempio, è possibile esportarli in PowerPoint o visualizzare l'oggetto visivo nei messaggi di posta elettronica ricevuti quando un utente sottoscrive le pagine del report.
Il processo di certificazione è facoltativo. Spetta agli sviluppatori decidere se vogliono che il loro oggetto visivo sia certificato. Gli oggetti visivi di Power BI non certificati non sono necessariamente non sicuri. Alcuni oggetti visivi di Power BI non sono certificati perché non sono conformi a uno o più requisiti di certificazione. Ad esempio, una mappa visiva di Power BI che si connette a un servizio esterno o un oggetto visivo di Power BI che utilizza librerie commerciali non può essere certificato.
Rimozione della certificazione
Microsoft si riserva il diritto di rimuovere un oggetto visivo dall'elenco certificato, a sua discrezione.
Requisiti di certificazione
Per ottenere la certificazione della visualizzazione di Power BI, deve soddisfare i requisiti elencati in questa sezione.
Requisiti generali
Il visual di Power BI deve essere approvato dal Partner Center. Prima di richiedere la certificazione, è consigliabile pubblicare l'oggetto visivo di Power BI in AppSource. Per informazioni su come pubblicare un oggetto visivo di Power BI in AppSource, vedere Pubblicare oggetti visivi di Power BI nel Centro per i partner.
Prima di inviare l'elemento visivo di Power BI per la certificazione, verificare che:
- L'immagine non è un oggetto visivo R
- L'oggetto visivo è conforme alle linee guida per gli oggetti visivi di Power BI
- L'oggetto visivo supera tutti i test necessari
- Il pacchetto compilato corrisponde esattamente al pacchetto inviato
Requisiti del repository di codice
Sebbene il codice non debba essere condiviso pubblicamente in GitHub, è necessario che il repository di codice sia disponibile per essere rivisto dal team di Power BI. A tal proposito è consigliabile mettere a disposizione il codice sorgente JavaScript o TypeScript in GitHub.
Il repository deve contenere:
- Codice per un solo oggetto visivo di Power BI. Non può contenere codice per più oggetti visivi di Power BI o codice non correlato.
- Un ramo denominato certification (obbligatorio in lettere minuscole). Il codice sorgente in questo ramo deve corrispondere al pacchetto inviato. Questo codice può essere aggiornato solo durante il processo di invio successivo, se si invia nuovamente l'oggetto visivo di Power BI.
Se l'oggetto visivo di Power BI usa pacchetti npm privati o moduli secondari GIT, è necessario specificare anche l'accesso ai repository che contengono questo codice.
Per comprendere l'aspetto di un repository di visualizzazioni di Power BI, esaminare il repository GitHub per l'esempio di grafico a barre delle visualizzazioni di Power BI.
Requisiti dei file
Usare la versione più recente dell'API per sviluppare la visualizzazione di Power BI.
Il repository deve includere i file seguenti:
-
.gitignore : aggiungere
node_modules
e.tmp
dist
a questo file. Il codice non può includere le cartelle node_modules, .tmp o dist . - capabilities.json : se si invia una versione più recente di un oggetto visivo di Power BI esistente con modifiche alle proprietà in questo file, verificare che non interrompano i report per gli utenti esistenti.
- pbiviz.json
-
package.json. È necessario che nell'oggetto visivo siano installati i pacchetti seguenti:
- "typescript"
- "eslint"
- "eslint-plugin-powerbi-visuals"
- Il file deve contenere un comando per l'esecuzione del linter-
"eslint": "npx eslint . --ext .js,.jsx,.ts,.tsx"
- package-lock.json
- tsconfig.json
Requisiti dei comandi
Verificare che i comandi seguenti non restituiscano errori.
npm install
pbiviz package
-
npm audit
- non deve restituire segnalazioni con livello elevato o moderato. -
ESlint
con la configurazione richiesta. Questo comando non deve restituire alcun errore di lint.
Requisiti di compilazione
Usare la versione più recente di powerbi-visuals-tools per creare l'oggetto visivo di Power BI.
Compila la visualizzazione di Power BI con pbiviz package
. Se si usano script di compilazione personalizzati, specificare un comando di compilazione npm run package
personalizzato.
Suggerimento
A partire da powerbi-visuals-tools versione 6.1.0, è possibile controllare l'oggetto visivo per le chiamate non sicure a fetch
, XMLHttpRequest
e eval
usando il comando seguente:
pbiviz package --certification-audit
Se durante il controllo viene rilevato codice non sicuro, è possibile compilare automaticamente un pacchetto con le correzioni necessarie eseguendo: pbiviz package --certification-fix
Requisiti del codice sorgente
Assicurarsi di seguire l'elenco di criteri di certificazione aggiuntivi degli oggetti visivi di Power BI . Se l'invio non segue queste linee guida, si riceverà un messaggio di posta elettronica di rifiuto dal Centro per i partner con i numeri di criteri elencati in questo collegamento.
Seguire i requisiti di codice elencati di seguito per assicurarsi che il codice sia in linea con i criteri di certificazione di Power BI.
Richiesto
- Usare solo componenti OSS pubblicabili, ad esempio librerie JavaScript o TypeScript pubbliche.
- Il codice deve supportare l'API Eventi di rendering.
- Assicurarsi che il modello DOM venga modificato in modo sicuro. Usare la sanitizzazione per l'input o i dati dell'utente, prima di aggiungerli al DOM.
- Usare il report di esempio come set di dati di test.
Non consentito
- Accesso a servizi o risorse esterni. Nessuna richiesta HTTP/S o WebSocket, ad esempio, può uscire da Power BI verso alcun servizio. Pertanto, i privilegi di WebAccess devono essere vuoti o omessi nelle impostazioni delle funzionalità.
- Uso di
XMLHttpRequest
ofetch
. - Uso di
innerHTML
oD3.html(user data or user input)
. - Errori o eccezioni JavaScript nella console del browser per qualsiasi dato di input.
- Codice arbitrario o dinamico, ad esempio
eval()
, uso non sicuro disettimeout()
,requestAnimationFrame()
,setinterval(user input function)
e dati o input dell'utente. - File o progetti JavaScript minimizzati.
Inviare un oggetto visivo di Power BI per la certificazione
Ora sei pronto per inviare una richiesta per far certificare la tua visualizzazione di Power BI dal team di Power BI.
Suggerimento
Il processo di certificazione di Power BI può richiedere tempo. Se si sta creando un nuovo oggetto visivo di Power BI, è consigliabile pubblicarlo attraverso il Centro per i partner prima di richiedere la certificazione di Power BI. In questo modo si garantisce che la pubblicazione dell'oggetto visivo non subisca ritardi.
Per richiedere la certificazione di Power BI:
- Accedi al Centro Partner.
- Nella pagina Panoramica scegliere l'oggetto visivo di Power BI e passare alla pagina Configurazione del prodotto .
- Selezionare la casella di controllo Richiedi certificazione Power BI .
- Nella casella di testo Note per la certificazione della pagina Rivedi e pubblica specificare un collegamento al codice sorgente e alle credenziali necessarie per accedervi.
Processo di invio di un repository privato
Se si usa un repository privato, ad esempio GitHub, per inviare l'oggetto visivo di Power BI per la certificazione, seguire le istruzioni riportate in questa sezione.
- Creare un nuovo account per il team di convalida.
- Configurare l'autenticazione a due fattori per l'account .
- Generare un nuovo set di codici di ripristino.
- Quando si invia l'oggetto visivo di Power BI, assicurarsi di fornire i dettagli seguenti:
- Collegamento al repository
- Credenziali di accesso (inclusa una password)
- Codici di recupero
- Autorizzazioni di sola lettura per l'account (pbicvsupport)
Badge certificati per le visualizzazioni di Power BI
Dopo aver certificato un oggetto visivo di Power BI, ottiene un badge designato che indica che si tratta di un oggetto visivo di Power BI certificato.
Oggetti visivi di Power BI certificati in AppSource
Quando un utente cerca gli oggetti visivi di Power BI online in AppSource, una piccola notifica gialla nella scheda dell'oggetto visivo indica che si tratta di un oggetto visivo di Power BI certificato.
Quando si fa clic sulla scheda visiva di Power BI in AppSource, una notifica gialla denominata PBI Certified indica che questo oggetto visivo di Power BI è certificato.
Oggetti visivi di Power BI certificati nell'interfaccia di Power BI
Quando si importa un oggetto visivo di Power BI dall'interno di Power BI (Desktop o servizio), un badge blu indica che l'oggetto visivo di Power BI è certificato.
È possibile visualizzare solo gli oggetti visivi di Power BI certificati selezionando l'opzione filtro certificato di Power BI .
Tempistiche per la pubblicazione
Il processo di distribuzione in AppSource può richiedere tempo. Il tuo oggetto visivo di Power BI sarà disponibile per il download da AppSource al termine del processo.
Quando gli utenti potranno scaricare il mio contenuto visivo?
Se è stato inviato un nuovo oggetto visivo di Power BI, sarà disponibile per il download dal collegamento AppSource entro poche ore. Tuttavia, sono necessari altri 10-14 giorni per raggiungere la produzione e diventare disponibili in Power BI Desktop/Service.
Se è stato inviato un aggiornamento a un oggetto visivo di Power BI esistente, la nuova versione verrà visualizzata anche in AppSource, ma richiederà fino a due settimane per essere distribuita nell'ambiente di produzione.
Nota
Il campo della versione in AppSource verrà aggiornato con il giorno in cui Power BI è stato approvato da AppSource, circa una settimana dopo l'invio dell'oggetto visivo. Gli utenti potranno scaricare l'oggetto visivo aggiornato, ma le funzionalità aggiornate non avranno effetto. Le nuove funzionalità dell'oggetto visivo influiranno sui report degli utenti tra circa due settimane.
Quando verrà visualizzato un badge di certificazione per la visualizzazione Power BI?
Il badge di certificazione deve essere visibile entro tre settimane dall'approvazione dell'invio.
Contenuto correlato
- Domande frequenti sugli oggetti visivi certificati.
- Linee guida per la pubblicazione di oggetti visivi di Power BI
Altre domande? Provare la community di Power BI.