Obtención de un objeto visual de Power BI certificadoGet a Power BI visual certified

Los objetos visuales de Power BI certificados son objetos visuales de Power BI de AppSource que cumplen los requisitos de código del equipo de Microsoft Power BI.Certified Power BI visuals are Power BI visuals in AppSource that meet the Microsoft Power BI team code requirements. Estos objetos visuales se prueban para confirmar que no acceden a recursos o servicios externos y que siguen patrones y directrices de codificación seguros.These visuals are tested to verify that they don't access external services or resources, and that they follow secure coding patterns and guidelines.

Una vez que un objeto visual de Power BI está certificado, ofrece más características.Once a Power BI visual is certified, it offers more features. Por ejemplo, puede exportar el objeto visual a PowerPoint o mostrarlo en los correos electrónicos recibidos, cuando un usuario se suscribe a páginas del informe.For example, you can export to PowerPoint, or display the visual in received emails, when a user subscribes to report pages.

El proceso de certificación es opcional.The certification process is optional. Que un objeto visual de Power BI no esté certificado no significa necesariamente que sea poco seguro.Power BI visuals that are not certified, are not necessarily unsafe Power BI visuals. Algunos objetos visuales de Power BI no están certificados porque no cumplen uno o varios de los requisitos de certificación.Some Power BI visuals aren't certified because they don't comply with one or more of the certification requirements. Por ejemplo, un objeto visual de Power BI de mapa que conecta con un servicio externo o un objeto visual de Power BI que usa bibliotecas comerciales.For example, a map Power BI visual connecting to an external service, or a Power BI visual using commercial libraries.

Nota

Microsoft no es autor de los objetos visuales de Power BI de terceros.Microsoft is not the author of third-party Power BI visuals. Para comprobar la funcionalidad de objetos visuales de terceros, póngase en contacto directamente con el autor del objeto visual.To verify the functionality of third-party visuals, contact the author of the visual directly.

Requisitos de certificaciónCertification requirements

Para certificar un objeto visual de Power BI, este debe cumplir los requisitos indicados en esta sección.To get your Power BI visual certified, your Power BI visual must comply with the requirements listed in this section.

Requisitos generalesGeneral requirements

El Centro de partners debe aprobar el objeto visual de Power BI.Your Power BI visual has to be approved by Partner Center. Se recomienda que el objeto visual de Power BI ya esté en AppSource.We recommend that your Power BI visual is already in AppSource. Para aprender a publicar un objeto visual de Power BI en AppSource, consulte Publicación de objetos visuales de Power BI en el Centro de partners.To learn how to publish a Power BI visual to AppSource, see Publish Power BI visuals to Partner Center.

Antes de enviar el objeto visual de Power BI para que se certifique, compruebe que cumple las directrices de los objetos visuales de Power BI.Before submitting your Power BI visual to be certified, verify that it complies with the guidelines for Power BI visuals.

Al enviar el objeto visual de Power BI, asegúrese de que el paquete compilado coincida exactamente con el paquete enviado.When submitting the Power BI visual, make sure that the compiled package exactly matches the submitted package.

Requisitos del repositorio de códigoCode repository requirements

Aunque no tiene que compartir el código públicamente en GitHub, el repositorio de código tiene que estar disponible para que lo revise el equipo de Power BI.Although you don't have to publicly share your code in GitHub, the code repository has to be available for a review by the Power BI team. La mejor manera de hacerlo consiste en proporcionar el código fuente (JavaScript o TypeScript) en GitHub.The best way to do this, is by providing the source code (JavaScript or TypeScript) in GitHub.

El repositorio debe cumplir con los siguientes requisitos:The repository must contain the following:

  • Código para un solo objeto visual de Power BI.Code for only one Power BI visual. No puede contener código de varios objetos visuales de Power BI o código no relacionado.It can't contain code for multiple Power BI visuals, or unrelated code.
  • Una rama llamada certificación (en minúscula).A branch named certification (lowercase required). El código fuente de esta rama tiene que coincidir con el del paquete enviado.The source code in this branch has to match the submitted package. Este código solo se puede actualizar durante el siguiente proceso de envío, si va a volver a enviar el objeto visual de Power BI.This code can only be updated during the next submission process, if you're resubmitting your Power BI visual.

Si el objeto visual de Power BI usa paquetes NPM privados o submódulos de Git, debe proporcionar acceso a los repositorios adicionales que contienen este código.If your Power BI visual uses private npm packages, or git submodules, you must provide access to the additional repositories containing this code.

Para saber cuál es el aspecto de un repositorio de objetos visuales de Power BI, revise el repositorio de GitHub para obtener el gráfico de barras de ejemplo de objetos visuales de Power BI.To understand how a Power BI visual repository looks, review the GitHub repository for the Power BI visuals sample bar chart.

Requisitos de archivosFile requirements

Use la versión más reciente de la API para escribir el objeto visual de Power BI.Use the latest version of the API to write the Power BI visual.

El repositorio debe incluir los siguientes archivos:The repository must include the following files:

  • .gitignore: agregue node_modules, .tmp y dist a este archivo..gitignore - Add node_modules, .tmp and dist to this file. El código no puede incluir las carpetas node_modules, .tmp o dist.The code cannot include the node_modules, .tmp or dist folders.
  • capabilities.json: si va a enviar una versión más reciente del objeto visual de Power BI con cambios en las propiedades de este archivo, compruebe que no interrumpe los informes de los usuarios existentes.capabilities.json - If you are submitting newer version of your Power BI visual with changes to the properties in this file, verify that they do not break reports for existing users.
  • pbiviz.jsonpbiviz.json
  • package.json.package.json. El objeto visual debe tener instalados el siguiente paquete:The visual must have the following package installed:
    • "tslint": versión 5.18.0 o superior"tslint" - Version 5.18.0 or higher
    • "typescript": versión 3.0.0 o superior"typescript" - Version 3.0.0 or higher
    • "tslint-microsoftcontrib": versión 6.2.0 o superior"tslint-microsoftcontrib" - Version 6.2.0 or higher
    • El archivo debe contener un comando para ejecutar linter: "lint": "tslint -c tslint.json -p tsconfig.json"The file must contain a command for running linter - "lint": "tslint -c tslint.json -p tsconfig.json"
  • package-lock.jsonpackage-lock.json
  • tsconfig.jsontsconfig.json

Requisitos de comandosCommand requirements

Asegúrese de que los siguientes comandos no devuelven errores.Make sure that the following commands don't return any errors.

Requisitos de compilaciónCompiling requirements

Use la versión más reciente de powerbi-visuals-tools para escribir el objeto visual de Power BI.Use the latest version of powerbi-visuals-tools to write the Power BI visual.

Debe compilar el objeto visual de Power BI con pbiviz package.You must compile your Power BI visual with pbiviz package. Si va a usar sus propios scripts de compilación, proporcione un comando de compilación npm run package personalizado.If you're using your own build scripts, provide a npm run package custom build command.

Requisitos del código fuenteSource code requirements

Compruebe que sigue la lista de directivas de certificación adicional de objetos visuales de Power BI.Verify that you follow the Power BI visuals additional certification policy list. Si el envío no sigue estas directrices, el correo electrónico de rechazo del Centro de partners incluirá los números de la directiva que aparecen en este vínculo.If your submission doesn't follow these guidelines, the rejection email from Partner Center will include the policy numbers listed in this link.

Siga los requisitos de código que se enumeran a continuación para asegurarse de que el código está en línea con las directivas de certificación de Power BI.Follow the code requirements listed below to make sure that your code is in line with the Power BI certification policies.

ObligatorioRequired

  • Use solo componentes públicos de OSS que se puedan revisar, como bibliotecas JavaScript o TypeScript públicas.Only use public reviewable OSS components such as public JavaScript or TypeScript libraries.
  • El código debe admitir la API de representación de eventos.The code must support the Rendering Events API.
  • Asegúrese de que DOM se manipule de forma segura.Ensure DOM is manipulated safely. Use el saneamiento de los datos de usuario o de entrada de usuario antes de agregarlos a DOM.Use sanitization for user input or user data, before adding it to DOM.
  • Use el informe de ejemplo como conjunto de datos de prueba.Use the sample report as a test dataset.

No permitidoNot allowed

  • Acceder a recursos o servicios externos.Accessing external services or resources. Por ejemplo, ninguna solicitud HTTP/S ni WebSocket puede salir de Power BI a ningún servicio.For example, no HTTP/S or WebSocket requests can go out of Power BI to any services.
  • Usar innerHTML o D3.html(user data or user input).Using innerHTML, or D3.html(user data or user input).
  • Errores o excepciones de JavaScript en la consola del explorador, en los datos de entrada.JavaScript errors or exceptions in the browser console, for any input data.
  • Código arbitrario o dinámico como eval(), uso no seguro de settimeout(), requestAnimationFrame(), setinterval(user input function) y datos de usuarios o de entrada de usuario.Arbitrary or dynamic code such as eval(), unsafe use of settimeout(), requestAnimationFrame(), setinterval(user input function), and user input or user data.
  • Archivos o proyectos de JavaScript reducidos.Minified JavaScript files or projects.

Envío de un objeto visual de Power BI para certificaciónSubmitting a Power BI visual for certification

Puede solicitar que el equipo de Power BI certifique su objeto visual de Power BI mediante el Centro de partners.You can request to have your Power BI visual certified by the Power BI team via Partner Center.

Sugerencia

El proceso de certificación de Power BI puede tardar un tiempo.The Power BI certification process might take time. Si va a crear un objeto visual de Power BI, se recomienda publicarlo a través del Centro de partners antes de solicitar la certificación de Power BI.If you're creating a new Power BI visual, we recommend that you publish your Power BI visual via the Partner Center before you request Power BI certification. Esto garantiza que la publicación del objeto visual no se retrase.This ensures that the publishing of your visual is not delayed.

Para solicitar la certificación de Power BI:To request Power BI certification:

  1. Inicie sesión en el Centro de datos.Sign in to Partner Center.
  2. En la página Información general, elija su objeto visual de Power BI y vaya a la página de configuración del producto.On the Overview page, choose your Power BI visual, and go to the Product setup page.
  3. Active la casilla Request Power BI certification (Solicitar la certificación de Power BI).Select the Request Power BI certification check box.
  4. En la página Revisar y publicar, en el cuadro de texto Notas para la certificación, proporcione un vínculo al código fuente y las credenciales necesarias para acceder a él.On the Review and publish page, in the Notes for certification text box, provide a link to the source code and the credentials required to access it.

Proceso de envío de un repositorio privadoPrivate repository submission process

Si utiliza un repositorio privado como GitHub para enviar el objeto visual de Power BI para su certificación, siga las instrucciones de esta sección.If you're using a private repository such as GitHub to submit your Power BI visual for certification, follow the instructions in this section.

  1. Cree una cuenta para el equipo de validación.Create a new account for the validation team.
  2. Configure la autenticación en dos fases para la cuenta.Configure two-factor authentication for your account.
  3. Genere un nuevo conjunto de códigos de recuperación.Generate a new set of recovery codes.
  4. Al enviar el objeto visual de Power BI, proporcione lo siguiente:When submitting your Power BI visual, provide the following:
    • Un vínculo al repositorioA link to the repository
    • Las credenciales de inicio de sesión (incluida una contraseña)Login credentials (including a password)
    • Los códigos de recuperaciónRecovery codes
    • Los permisos de solo lectura para nuestra cuenta (pbicvsupport)Read-only permissions to our account (pbicvsupport)

Distintivos de objetos visuales de Power BI certificadosCertified Power BI visual badges

Una vez certificado un objeto visual de Power BI, obtiene un distintivo designado que indica que está certificado.Once a Power BI visual is certified, it gets a designated badge that indicates that it's certified.

Objetos visuales de Power BI certificados en AppSourceCertified Power BI visuals in AppSource

  • Al buscar en línea objetos visuales de Power BI en AppSource, un pequeño distintivo amarillo en la tarjeta del objeto visual indica que se trata de un objeto visual de Power BI certificado.When searching online for Power BI visuals in AppSource, a small yellow badge on the visual's card indicates that it's a certified Power BI visual.

    Objeto visual de Power BI certificado de AppSource

  • Después de hacer clic en la tarjeta del objeto visual de Power BI, un distintivo amarillo titulado PBI Certified indica que este objeto visual de Power BI está certificado.After clicking the Power BI visual card in AppSource, a yellow badge titled PBI Certified indicates that this Power BI visual is certified.

    Objeto visual de Power BI certificado de la página de la aplicación

Objetos visuales de Power BI certificados en la interfaz de Power BICertified Power BI visuals in the Power BI interface

  • Al importar un objeto visual de Power BI desde dentro de Power BI (escritorio o servicio), un distintivo azul indica que el objeto visual de Power BI está certificado.When importing a Power BI visual from within Power BI (Desktop or service), a blue badge indicates that the Power BI visual is certified.

    Objeto visual de Power BI certificado de la interfaz de Power BI

  • Puede mostrar solo los objetos visuales de Power BI certificados seleccionando la opción de filtro Certificado por Power BI.You can display only certified Power BI visuals, by selecting the Power BI Certified filter option.

Plazos de publicaciónPublication timeline

La implementación en AppSource es un proceso que puede tardar cierto tiempo.Deploying to AppSource is a process that may take some time. El objeto visual de Power BI estará disponible para su descarga en AppSource cuando este proceso haya finalizado.Your Power BI visual will be available to download from AppSource when this process is complete.

¿Cuándo podrán los usuarios descargar el objeto visual?When will users be able to download my visual?

  • Si es la primera vez que envía un objeto visual de Power BI, estará listo para descargarlo unas horas después de que reciba un correo electrónico de AppSource.If you submitted a Power BI visual for the first time, users will be able to download it a few hours after you receive an email from AppSource.

  • Si ha enviado una actualización de un objeto visual de Power BI existente, los usuarios podrán descargarla en el plazo de un mes desde su envío.If you submitted an update to an existing Power BI visual, users will be able to download it within a month of your submission.

    Nota

    El campo versión de AppSource se actualizará con el día en que AppSource aprobó el objeto visual de Power BI, aproximadamente una semana después de haber enviado el objeto visual.The version field in AppSource will be updated with the day your Power BI was approved by AppSource, approximately a week after you submitted your visual. Los usuarios podrán descargar el objeto visual actualizado, pero las características actualizadas no surtirán efecto.Users will be able to download the updated visual but the updated capabilities will not take effect. Las nuevas capacidades del objeto visual afectarán a los informes de los usuarios transcurrido un mes aproximadamente.Your visual's new capabilities will affect the user's reports after about a month.

¿Cuándo mostrará el objeto visual de Power BI un distintivo de certificación?When will my Power BI visual display a certification badge?

  • Si ha enviado un objeto visual de Power BI por primera vez, el distintivo de certificación aparecerá en el plazo de un día desde que reciba el correo electrónico de aprobación de AppSource.If you submitted a Power BI visual for the first time, the certification badge will appear within a day of receiving the approval email from AppSource.

  • Si está solicitando la certificación de un objeto visual de Power BI, el distintivo de certificación estará visible en el plazo de un mes de su envío.If you're requesting certification for an existing Power BI visual, the certification badge will be visible within a month of your submission.

Pasos siguientesNext steps