Obtención de un objeto visual de Power BI certificado

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. 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.

Una vez que un objeto visual de Power BI está certificado, ofrece más características. 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.

El proceso de certificación es opcional. Que un objeto visual de Power BI no esté certificado no significa necesariamente que sea poco seguro. Algunos objetos visuales de Power BI no están certificados porque no cumplen uno o varios de los requisitos de certificación. 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.

Requisitos de certificación

Para certificar un objeto visual de Power BI, este debe cumplir los requisitos indicados en esta sección.

Requisitos generales

El Centro de partners debe aprobar el objeto visual de Power BI. Se recomienda que el objeto visual de Power BI ya esté en 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.

Antes de enviar el objeto visual de Power BI para que se certifique, compruebe lo siguiente:

• Que el objeto visual cumple las instrucciones de los objetos visuales de Power BI
• Que el objeto visual pasa todas las pruebas necesarias
• Que el paquete compilado coincide exactamente con el paquete enviado

Requisitos del repositorio de código

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. La mejor manera de hacerlo consiste en proporcionar el código fuente (JavaScript o TypeScript) en GitHub.

El repositorio debe cumplir con los siguientes requisitos:

• Código para un solo objeto visual de Power BI. No puede contener código de varios objetos visuales de Power BI o código no relacionado.
• Una rama llamada certificación (en minúscula). El código fuente de esta rama tiene que coincidir con el del paquete enviado. 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.

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.

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.

Requisitos de archivos

Use la versión más reciente de la API para escribir el objeto visual de Power BI.

El repositorio debe incluir los siguientes archivos:

• .gitignore: agregue node_modules, .tmp y dist a este archivo. El código no puede incluir las carpetas node_modules, .tmp o dist.
• 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.
• pbiviz.json
• package.json. El objeto visual debe tener instalados el siguiente paquete:
  • "tslint": versión 5.18.0 o superior
  • "typescript": versión 3.0.0 o superior
  • "tslint-microsoftcontrib": versión 6.2.0 o superior
  • El archivo debe contener un comando para ejecutar linter: "lint": "tslint -c tslint.json -p tsconfig.json"
• package-lock.json
• tsconfig.json

Requisitos de comandos

Asegúrese de que los siguientes comandos no devuelven errores.

• npm install
• pbiviz package
• npm audit: no debe devolver ninguna advertencia de nivel alto o moderado.
• TSlint de Microsoft con la configuración requerida. Este comando no debe devolver ningún error de lint.

Requisitos de compilación

Use la versión más reciente de powerbi-visuals-tools para escribir el objeto visual de Power BI.

Debe compilar el objeto visual de Power BI con pbiviz package. Si va a usar sus propios scripts de compilación, proporcione un comando de compilación npm run package personalizado.

Requisitos del código fuente

Compruebe que sigue la lista de directivas de certificación adicional de objetos visuales de Power BI. 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.

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.

Lo siguiente es obligatorio:

• Use solo componentes públicos de OSS que se puedan revisar, como bibliotecas JavaScript o TypeScript públicas.
• El código debe admitir la API de representación de eventos.
• Asegúrese de que DOM se manipule de forma segura. Use el saneamiento de los datos de usuario o de entrada de usuario antes de agregarlos a DOM.
• Use el informe de ejemplo como conjunto de datos de prueba.

No se permite lo siguiente:

• Acceder a recursos o servicios externos. Por ejemplo, ninguna solicitud HTTP/S ni WebSocket puede salir de Power BI a ningún servicio.
• Usar innerHTML o D3.html(user data or user input).
• Errores o excepciones de JavaScript en la consola del explorador, en los datos de entrada.
• 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.
• Archivos o proyectos de JavaScript reducidos.

Envío de un objeto visual de Power BI para certificación

Puede solicitar que el equipo de Power BI certifique su objeto visual de Power BI mediante el Centro de partners.

Para solicitar la certificación de Power BI:

1. Inicie sesión en el Centro de datos.
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.
3. Active la casilla Request Power BI certification (Solicitar la certificación de Power BI).
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.

Proceso de envío de un repositorio privado

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.

1. Cree una cuenta para el equipo de validación.
2. Configure la autenticación en dos fases para la cuenta.
3. Genere un nuevo conjunto de códigos de recuperación.
4. Al enviar el objeto visual de Power BI, asegúrese de proporcionar lo siguiente:
   • Un vínculo al repositorio
   • Las credenciales de inicio de sesión (incluida una contraseña)
   • Los códigos de recuperación
   • Los permisos de solo lectura para nuestra cuenta (pbicvsupport)

Distintivos de objetos visuales de Power BI certificados

Una vez certificado un objeto visual de Power BI, obtiene un distintivo designado que indica que está certificado.

Objetos visuales de Power BI certificados en 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.

  

• 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.

  

Objetos visuales de Power BI certificados en la interfaz de Power BI

• 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.

  

• Puede mostrar solo los objetos visuales de Power BI certificados seleccionando la opción de filtro Certificado por Power BI.

Plazos de publicación

La implementación en AppSource es un proceso que puede tardar cierto tiempo. El objeto visual de Power BI estará disponible para su descarga en AppSource cuando este proceso haya finalizado.

¿Cuándo podrán los usuarios descargar el objeto 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.

• Si envió una actualización de un objeto visual de Power BI existente, los usuarios podrán descargarla en el plazo de dos semanas desde su envío.

  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. Los usuarios podrán descargar el objeto visual actualizado, pero las características actualizadas no surtirán efecto. Las nuevas funcionalidades del objeto visual afectarán a los informes de los usuarios transcurridas unas dos semanas.

¿Cuándo mostrará el objeto visual de Power BI un distintivo de certificación?

• 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.

• Si está solicitando la certificación de un objeto visual de Power BI, el distintivo de certificación estará visible en el plazo de dos semanas de su envío.

Pasos siguientes