Adopción de una metodología de desarrollo para insertar contenido de Power BI
En los pasos siguientes se describe la metodología general que los desarrolladores pueden seguir para insertar contenido de Power BI mediante programación en una aplicación nueva o existente.
- Prepare contenido de Power BI para la inserción.
- Cree un registro de aplicación de Microsoft Entra ID.
- Desarrolle la incrustación de código de la aplicación.
- Mejore la experiencia del usuario mediante las funcionalidades de la API de cliente.
Primero, debe tener el contenido de Power BI listo para insertar. La preparación del contenido implica la creación de áreas de trabajo Power BI y la publicación de contenido en ellas. Puede crear y administrar contenido de maneras convencionales mediante Power BI Desktop y el servicio Power BI. El proceso de preparación del contenido de Power BI para la inserción se describe en la unidad siguiente.
En segundo lugar, debe crear un registro de aplicación en Microsoft Entra. El registro de aplicación permite a Microsoft Entra saber cómo emitir tokens, lo que concede acceso a los servicios y recursos. Puede que sea necesaria otra configuración de Microsoft Entra en función de la identidad de inserción de la aplicación.
Nota
Para obtener información sobre la inserción de identidades y la configuración de seguridad de la aplicación, consulte el módulo Configuración de permisos para la inserción de contenido de Power BI.
Después, desarrollará o ampliará la solución de la aplicación con incrustación de código. Este proceso implica la importación de paquetes específicos de NuGet. Los paquetes de NuGet ayudan a que los requisitos del lado servidor se autentiquen con Microsoft Entra ID, a generar tokens y a descubrir contenido de Power BI. La inserción real de contenido de Power BI se produce en el lado cliente. Una operación de API de cliente inserta un elemento de contenido de Power BI específico dentro de un elemento div.
Nota
Para obtener información sobre el desarrollo de la lógica de inserción, consulte el módulo Inserción de contenido de Power BI.
Las API de cliente hacen mucho más que insertar contenido de Power BI. Admiten muchas operaciones para ayudarle a integrar y mejorar el contenido sin problemas. Entre las capacidades se incluyen:
- Interacción mediante programación: por ejemplo, la aplicación puede aplicar nuevos filtros a un informe insertado.
- Eventos que admiten subscripción: los elementos de gráfico, como la columna de un objeto visual de gráfico de columnas, las extensiones de menú y los botones, pueden desencadenar eventos a los que la aplicación puede responder. Por ejemplo, cuando el usuario de la aplicación selecciona un botón dentro de un informe de Power BI, la aplicación puede abrir una ventana de diálogo para introducir y reescribir datos en la base de datos de la aplicación.
- Diseños de informes dinámicos: por ejemplo, el usuario de la aplicación puede elegir informes con tema claro u oscuro.
- Interacción de marcadores: la aplicación puede aplicar marcadores de informe existentes o crear (y conservar) marcadores personales.
- Creación de objeto visual del informe: la aplicación puede permitir a los usuarios crear objetos visuales de informe o personalizar los objetos visuales de informe existentes.
Nota
Para obtener información sobre las API de cliente de Power BI, consulte el módulo Integración de contenido con las API de cliente de Power BI.