Inserción con Power BIEmbedding with Power BI

Power BI ofrece API para la inserción de paneles e informes en las aplicaciones.Power BI offers APIs for embedding your dashboards and reports into applications. Al insertar el contenido, las API de Power BI ofrecen un conjunto coherente de funcionalidades y acceso a las últimas características de Power BI (como paneles, puertas de enlace y áreas de trabajo de la aplicación).The Power BI APIs offer a consistent set of capabilities and access to the latest Power BI features – such as dashboards, gateways and app workspaces – when embedding content.

Una sola APIA single API

Hay dos escenarios principales al insertar el contenido de Power BI.There are two main scenarios when embedding Power BI content. Inserción de contenido para usuarios de la organización (con licencia de Power BI) e inserción de contenido para usuarios y clientes sin que necesiten licencia de Power BI.Embedding for users in your organization (who have licenses for Power BI) and embedding for your users and customers without requiring them to have Power BI licenses. La API de REST de Power BI permite ambos escenarios.The Power BI REST API allows for both scenarios.

En el caso de clientes y usuarios que no tengan licencia de Power BI, puede insertar paneles e informes en la aplicación personalizada con las mismas API, tanto para la organización como para los clientes.For customers and users without Power BI licenses, you can embed dashboards and reports into your custom application, using the same API to either service your organization or your customers. Los clientes verán los datos que la aplicación administre.Your customers see the data that is managed by the application. Y, en el caso de los usuarios de Power BI de su organización, tendrán la opción tradicional de ver sus propios datos directamente en Power BI o en el contexto de la aplicación insertada.And for Power BI users in your organization, they'll have the additional options to view their own data directly in Power BI or in the context of the embedded application. Puede aprovechar al máximo las API de REST y de JavaScript para lo que necesite insertar.You can take full advantage of the JavaScript and REST APIs for your embedding needs.

Para ver un ejemplo de cómo funciona la inserción, consulte Ejemplo de inserción de JavaScript.To view a sample of how embedding works, see the JavaScript embed sample.

Inserción de contenido para la organizaciónEmbedding for your organization

La inserción de contenido para la organización le permite ampliar el servicio Power BI.Embedding for your organization allows you to extend the Power BI service. Cuando los usuarios quieran ver el contenido, deberán iniciar sesión en el servicio Power BI.This requires that users of your application sign into the Power BI service when they want to view their content. Cuando los usuarios de la organización inicien sesión, solo tendrán acceso a los paneles e informes que se hayan compartido con ellos en el servicio Power BI.Once someone in your organization signs in, they will only have access to dashboards and reports that they own or that have been shared with them in the Power BI service.

Entre los ejemplos de inserción de contenido para la organización se incluye la inserción de aplicaciones web internas, elementos web de SharePoint Online y las integraciones de Microsoft Teams.Examples of embedding for your organization include internal web application, the SharePoint Online web part and Microsoft Teams integration.

Para insertar contenido para su organización, consulte lo siguiente:For embedding for your organization, see the following:

Al usar la inserción para los usuarios de Power BI, las funcionalidades de autoservicio (como son editar, guardar y otras) están disponibles a través de la API de JavaScript.Self-service capabilities, such as edit, save and more, are available through the JavaScript API when embedding for Power BI users.

Inserción de contenido para los clientesEmbedding for your customers

La inserción de contenido para los clientes permite insertar paneles e informes para los usuarios que no tienen una cuenta de Power BI.Embedding for your customers provides the ability to embed dashboards and reports to users who don't have an account for Power BI. Los clientes no necesitan saber nada acerca de Power BI.Your customers don't need to know anything about Power BI. Se necesita al menos una cuenta de Power BI Pro para crear una aplicación insertada.At least one Power BI Pro account is needed to create an embedded application. Esa cuenta actuará como cuenta maestra de la aplicación.The Power BI Pro account acts as a master account for your application. Considérela como una cuenta de proxy.Think of this as a proxy account. La cuenta de Power BI Pro le permite también generar tokens de inserción que proporcionan acceso a los paneles e informes dentro del servicio Power BI que la aplicación posea o administre.The Power BI Pro account also allows you to generate embed tokens that provide access to dashboards and reports within the Power BI service that are owned/managed by your application.

Un ejemplo de inserción para los clientes es una aplicación de ISV que se quiere vender a otras compañías.An example of embedding for your customers is an ISV application being sold to other companies.

Flujo de inserción para insertar contenido para los clientes

Para insertar paneles, informes e iconos, puede usar las mismas API que se usan para insertar contenido para la organización.To embed dashboards, reports and tiles, you would use the same APIs that you would use for embedding for your organization.

Importante

Aunque la inserción de contenido tiene una dependencia del servicio Power BI, no existe ninguna dependencia de Power BI para los clientes.While embedding has a dependency on the Power BI service, there is not a dependency on Power BI for your customers. No es necesario que se registren en Power BI para ver el contenido insertado en la aplicación.They do not need to sign up for Power BI to view the embedded content in your application.

Cuando esté listo para pasar a producción, se debe asignar una capacidad a su área de trabajo de aplicaciones.When you are ready to move to production, your app workspace must be assigned to a capacity. Power BI Embedded, de Microsoft Azure, ofrece capacidad para usarla con las aplicaciones.Power BI Embedded, within Microsoft Azure, offers capacity to use with your applications.

Para más información acerca de los procedimientos de inserción, consulte Procedimiento para insertar paneles, informes e iconos de Power BI.For details on how to embed, see How to embed your Power BI dashboards, reports and tiles.

Si usó el servicio Colección de áreas de trabajo de Power BI en Azure, consulte Migración de contenido desde el servicio Colección de áreas de trabajo de Power BI para más información sobre cómo migrar el contenido.If you were using the Power BI Workspace Collections service within Azure, see Migrate content from the Power BI Workspace Collections Azure service for information on how to migrate your content over.

Pasos siguientesNext steps

Procedimiento para insertar paneles, informes e iconos de Power BIHow to embed your Power BI dashboards, reports and tiles
Migración de contenido de la colección de áreas de trabajo de Power BI Embedded a Power BIHow to migrate Power BI Embedded workspace collection content to Power BI
¿Qué es Power BI Premium?Power BI Premium - what is it?
Repositorio Git de la API de JavaScriptJavaScript API Git repo
Repositorio Git de C# de Power BIPower BI C# Git repo
Ejemplo de inserción de JavaScriptJavaScript embed sample
Notas del producto sobre el planeamiento de la capacidad de análisis de inserciónEmbedded analytics capacity planning whitepaper
Notas del producto de Power BI PremiumPower BI Premium whitepaper

¿Tiene más preguntas?More questions? Pruebe a preguntar a la comunidad de Power BITry asking the Power BI Community