Oggetti visivi certificati di Power BI

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 progettati per verificare che l'oggetto visivo non accunga a servizi o risorse esterni. Tuttavia, Microsoft non è l'autore di oggetti visivi personalizzati di terze parti e consigliamo ai clienti di contattare direttamente l'autore per verificare la funzionalità di questi oggetti visivi.

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, un oggetto visivo di Power BI mappa che si connette a un servizio esterno o un oggetto visivo di Power BI che usa 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 dell'oggetto visivo di Power BI, deve soddisfare i requisiti elencati in questa sezione.

Requisiti generali

L'oggetto visivo di Power BI deve essere approvato dal Centro per i partner. 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'oggetto visivo di Power BI per la certificazione, verificare che:

• 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

Anche se non è necessario condividere pubblicamente il codice in GitHub, il repository di codice deve essere disponibile per una revisione da parte del team di Power BI. Il modo migliore per eseguire questa operazione consiste nel fornire 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 sta inviando l'oggetto visivo di Power BI.

Se l'oggetto visivo di Power BI usa pacchetti npm privati o moduli secondari Git, è necessario fornire anche l'accesso ai repository contenenti questo codice.

Per comprendere l'aspetto di un repository visivo di Power BI, esaminare il repository GitHub per il grafico a barre di esempio degli oggetti visivi di Power BI.

Requisiti dei file

Usare la versione più recente dell'API per scrivere l'oggetto visivo di Power BI.

Il repository deve includere i file seguenti:

• .gitignore : aggiungere node_modulese .tmpdist 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. L'oggetto visivo deve avere installato il pacchetto seguente:
  • "typescript"
  • "eslint"
  • "eslint-plugin-powerbi-visuals"
  • Il file deve contenere un comando per l'esecuzione di linter - "eslint": "npx eslint . --ext .js,.jsx,.ts,.tsx"
• package-lock.json
• tsconfig.json

Requisiti dei comandi

Assicurarsi che i comandi seguenti non restituisca errori.

• npm install

• pbiviz package

• npm audit - Non deve restituire avvisi con livello elevato o moderato.

• ESlint con la configurazione richiesta. Questo comando non deve restituire errori lint.

  Nota

  È in corso la migrazione da TSlint a ESLint. Gli oggetti visivi che usano TSlint verranno accettati per la certificazione fino a marzo 2023. Successivamente, sarà necessario ESlint.

Requisiti di compilazione

Usare la versione più recente di powerbi-visuals-tools per scrivere l'oggetto visivo di Power BI.

Compilare l'oggetto visivo di Power BI con pbiviz package. Se si usano script di compilazione personalizzati, specificare un npm run package comando di compilazione personalizzato.

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, riceverai un messaggio di posta elettronica di rifiuto dal Centro per i partner con i numeri di criteri elencati in questo collegamento.

Seguire i requisiti del codice elencati qui per assicurarsi che il codice sia in linea con i criteri di certificazione di Power BI.

Richiesto

• Usare solo componenti OSS verificabili pubblici, ad esempio librerie JavaScript pubbliche o TypeScript.
• Il codice deve supportare l'API Eventi di rendering.
• Verificare che DOM sia modificato in modo sicuro. Usare la purificazione per l'input dell'utente o i dati dell'utente, prima di aggiungerli a DOM.
• Usare il report di esempio come set di dati di test.

Non consentito

• Accesso a servizi o risorse esterni. Ad esempio, nessuna richiesta HTTP/S o WebSocket può uscire da Power BI a qualsiasi servizio. Pertanto, i privilegi di WebAccess devono essere vuoti o omessi nelle impostazioni delle funzionalità.
• Uso di innerHTMLo D3.html(user data or user input).
• Errori o eccezioni JavaScript nella console del browser, per tutti i dati di input.
• Codice arbitrario o dinamico, ad eval()esempio , uso non sicuro di settimeout()dati requestAnimationFrame()setinterval(user input function)utente o input utente , , e .
• File o progetti JavaScript minimizzati.

Inviare un oggetto visivo di Power BI per la certificazione

A questo momento è possibile inviare una richiesta per ottenere la certificazione dell'oggetto visivo di Power BI dal team di Power BI.

Per richiedere la certificazione di Power BI:

1. Accedere al Centro per i partner.
2. Nella pagina Panoramica scegliere l'oggetto visivo di Power BI e passare alla pagina Configurazione del prodotto.
3. Selezionare la casella di controllo Richiedi certificazione Power BI.
4. 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 del repository privato

Se si usa un repository privato come GitHub per inviare l'oggetto visivo di Power BI per la certificazione, seguire le istruzioni riportate in questa sezione.

1. Creare un nuovo account per il team di convalida.
2. Configurare l'autenticazione a due fattori per l'account .
3. Generare un nuovo set di codici di ripristino.
4. 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 ripristino
   • Autorizzazioni di sola lettura per l'account (pbicvsupport)

Badge per gli oggetti visivi di Power BI certificati

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 un oggetto visivo di Power BI viene importato dall'interno di Power BI (Desktop o servizio), una notifica 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.

Sequenza temporale della pubblicazione

Il processo di distribuzione in AppSource può richiedere tempo. Al termine del processo, l'oggetto visivo di Power BI sarà disponibile per il download da AppSource.

Quando gli utenti potranno scaricare l'oggetto visivo?

• Se è stato inviato un nuovo oggetto visivo di Power BI, gli utenti potranno scaricarlo alcune ore dopo aver ricevuto un messaggio di posta elettronica da AppSource.

• Se è stato inviato un aggiornamento a un oggetto visivo di Power BI esistente, gli utenti potranno scaricarlo entro due settimane dall'invio.

  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 dell'utente dopo circa due settimane.

Quando l'oggetto visivo di Power BI visualizza una notifica di certificazione?

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 il Community di Power BI.