Inserción de paneles, informes e iconos de Power BIEmbed your Power BI dashboards, reports and tiles

Obtenga información sobre los pasos necesarios para insertar contenido de Power BI en su aplicación.Learn about the steps you need to take to embed Power BI content within your application.

Microsoft presentó Power BI Premium, un nuevo modelo de licencias basado en la capacidad que aumenta la flexibilidad con la que los usuarios acceden al contenido, lo comparten y lo distribuyen.Microsoft announced Power BI Premium, a new capacity-based licensing model that increases flexibility for how users access, share and distribute content. La oferta también incluye mayor rendimiento y escalabilidad para el servicio Power BI.The offering also delivers additional scalability and performance to the Power BI service. También se presentó Power BI Embedded que permite la creación de capacidad en Microsoft Azure.Power BI Embedded was also announced that allows for creating capacity within Microsoft Azure. Power BI Embedded se centra en sus aplicaciones y clientes.Power BI Embedded is focused on your application and your customers.

En este artículo se explica cómo insertar contenido de Power BI para la organización y los usuarios.This article will look at embedding your Power BI content for both your organization and your customers. Los pasos son similares en ambos casos.The steps are similar between the two scenarios. Se resaltará el texto cuando un paso de inserción sea específico para el cliente.Callouts will be made when a step is specific to embedding for your customer.

Hay que realizar algunos pasos con la aplicación para hacer esto posible.There are a few steps you have to do with your application to make this possible. Revisaremos los pasos necesarios para poder crear y utilizar contenido insertado en la aplicación.We will go through the steps needed to allow you to create and use embedded content within your application.

Nota

Las API de Power BI siguen haciendo referencia a las áreas de trabajo de la aplicación como grupos.The Power BI APIs still refer to app workspaces as groups. Todas las referencias a grupos significan que está trabajando con áreas de trabajo de la aplicación.Any references to groups mean that you are working with app workspaces.

Paso 1: Configurar el entorno de desarrollo de análisis insertadosStep 1: Setup your embedded analytics development environment

Antes de empezar a insertar paneles e informes en la aplicación, debe asegurarse de que su entorno está configurado para permitir la inserción.Before you start embedding dashboards and reports into your application, you need to make sure your environment is setup to allow for embedding. Como parte de la configuración, debe hacer lo siguiente.As part of the setup, you will need to do the following.

Nota

La capacidad de Power BI no es necesaria para el desarrollo de la aplicación.Power BI capacity is not required for development of your application. Los desarrolladores de la aplicación deberán tener una licencia de Power BI Pro.The developers of the application will need to have a Power BI Pro license.

Inquilino de Azure Active DirectoryAzure Active Directory tenant

Necesitará un inquilino de Azure Active Directory (Azure AD) para insertar elementos de Power BI.You will need an Azure Active Directory (Azure AD) tenant in order to embed items from Power BI. Este inquilino debe tener al menos un usuario de Power BI Pro.This tenant must have at least one Power BI Pro user. También debe definir una aplicación de Azure AD en el inquilino.You will also need to define an Azure AD app within the tenant. Puede hacer uso de un inquilino de Azure AD existente o crear uno nuevo específicamente para fines de inserción.You can make use of an existing Azure AD tenant or create a new one specifically for embedding purposes.

Debe determinar qué configuración de inquilino usará si va a insertar contenido para los clientes.You will need to determine what tenant setup to use if you are embedding for your customers.

  • ¿Se usa el inquilino de Power BI corporativo actual?Use your existing corporate Power BI tenant?
  • ¿Se usa un inquilino independiente para la aplicación?Use a separate tenant for your application?
  • ¿Se usa un inquilino independiente para cada cliente?Use a separate tenant for each customer?

Si no desea usar un inquilino existente, puede decidir crear uno nuevo para la aplicación o uno para cada cliente, consulte Crear un inquilino de Azure Active Directory u Obtención de un inquilino de Azure Active Directory.If you do not want to use an existing tenant, you can decide to create a new tenant for your application, or one for each customer, see Create an Azure Active Directory tenant or How to get an Azure Active Directory tenant.

Crear una cuenta de usuario de Power BI ProCreate a Power BI Pro user account

Solo necesita una única cuenta de Power BI Pro para insertar contenido.You only need a single Power BI Pro account to embed content. No obstante, puede que desee tener algunos usuarios diferentes con acceso específico a los elementos.However, you may want to have a few different users that have specific access to items. Aquí se indican los posibles usuarios que debe tener en cuenta en el inquilino.Here is a look at possible users to consider within your tenant.

Las siguientes cuentas deberán existir dentro de su inquilino y tener una licencia de Power BI asignada.The following accounts will need to exist within your tenant and have a Power BI Pro license assigned to them. Se requiere una licencia de Power BI Pro para trabajar con áreas de trabajo de la aplicación dentro de Power BI.A Power BI Pro license is required to work with app workspaces within Power BI.

Un usuario administrador de la organización o el inquilino.An organization/tenant admin user

Se recomienda no utilizar el usuario administrador global de la organización o el inquilino como la cuenta que utiliza la aplicación si inserta contenido para los clientes.It is recommended that your organization/tenant Global Admin user should not be used as account your application uses if embedding for your customers. Con esto se pretende minimizar el acceso que la cuenta de la aplicación tiene dentro del inquilino.This is to minimize access that the application account has within your tenant. Se recomienda que el usuario administrador sea un administrador de todas las áreas de trabajo de la aplicación creadas para la inserción.It is recommended that the admin user be an admin of all app workspaces created for the purpose of embedding.

Cuentas para los analistas que van a crear contenido.Accounts for analysts that will create content

Puede tener varios usuarios que crean contenido para Power BI.You may have multiple users that create content for Power BI. Necesitará una cuenta de Power BI Pro para cada analista que crea e implementa contenido en Power BI.You will need a Power BI Pro account for each analyst that is creating and deploying content to Power BI.

Una cuenta de usuario maestro de aplicación para insertar contenido para los clientesAn application master user account for embedding for your customers

Se trata de la cuenta maestra que la aplicación usará para insertar contenido para los clientes.The master account is the account your application will use when embedding content for your customers. Este escenario se usa habitualmente para las aplicaciones de ISV.The scenario is typically for ISV applications. La cuenta maestra es realmente la única cuenta necesaria dentro de la organización.The master account is really the only required account you need within your organization. También se puede utilizar como cuenta de administrador o de analista, pero no se recomienda.It can also be used as the admin and analyst account, but it is not recommended. El back-end de la aplicación almacenará las credenciales para esta cuenta y las usará para adquirir un token de autenticación de Azure AD para usarlo con las API de Power BI.Your application's backend will store the credentials for this account and use it for acquiring an Azure AD auth token for use with the Power BI APIs. Se usará esta cuenta para generar el token de inserción para que la aplicación lo use para los clientes.This account will be used to generate an embed token for the application to use for your customers.

La cuenta maestra es solo un usuario normal con una licencia de Power BI Pro que usa con su aplicación.The master account is just a regular user with a Power BI Pro license that you use with your application. Debe tratarse de la cuenta de un administrador del área de trabajo de la aplicación que se va a usar para la inserción.The account must be an admin of the app workspace that is being used for embedding.

Registro y permisos de la aplicaciónApp registration and permissions

Para realizar llamadas a la API de REST será preciso registrar la aplicación en Azure AD.You will need to register your application with Azure AD in order to make REST API calls. Para más información, consulte Registro de una aplicación de Azure AD para insertar contenido de Power BI.For more information, see Register an Azure AD app to embed Power BI content.

Creación de áreas de trabajo de la aplicaciónCreate app workspaces

Si va a insertar paneles e informes para los clientes, estos deben haberse colocado en un área de trabajo de la aplicación.If you are embedding dashboards and reports for your customers, those dashboards and reports have to be placed within an app workspace. La cuenta maestra mencionada anteriormente debe corresponder a un administrador del área de trabajo de la aplicación.The master account, that was mentioned above, must be an admin of the app workspace.

  1. Comience por crear el área de trabajo.Start by creating the workspace. Seleccione Áreas de trabajo > Crear área de trabajo de la aplicación.Select Workspaces > Create app workspace.

    Crear área de trabajo de la aplicación

    Este será el lugar para colocar el contenido en el que está colaborando con sus compañeros.This will be the place to put content that you and your colleagues collaborate on.

  2. Asigne un nombre al área de trabajo.Give the workspace a name. Si el Id. de área de trabajo correspondiente no está disponible, puede editarlo para tener un identificador único.If the corresponding Workspace ID isn't available, edit it to come up with a unique ID.

    Este será también el nombre de la aplicación.This will be the name of the app, too.

    Asignar un nombre al área de trabajo

  3. Tiene que establecer algunas opciones.You have a few options to set. Si elige Pública, cualquier persona de la organización puede ver el contenido del área de trabajo.If you choose Public, anyone in your organization can see what’s in the workspace. Privada, por otro lado, significa que solo los miembros del área de trabajo pueden ver su contenido.Private, on the other hand, means only members of the workspace can see its contents.

    Establecer privado o público

    No puede cambiar la configuración pública o privada una vez creado el grupo.You can't change the Public/Private setting after you've created the group.

  4. También puede elegir si los miembros pueden editar o tener acceso de solo lectura.You can also choose if members can edit or have view-only access.

    Establecer edición o solo lectura

    Solo debe agregar personas al área de trabajo de aplicación para que puedan modificar el contenido.Only add people to the app workspace so they can edit the content. Si solo van a ver el contenido, no las agregue al área de trabajo.If they're only going to view the content, don't add them to the workspace. Puede incluirlas cuando publique la aplicación.You can include them when you publish the app.

  5. Agregue las direcciones de correo electrónico de las personas que desea que tengan acceso al área de trabajo y seleccione Agregar.Add email addresses of people you want to have access to the workspace, and select Add. No se pueden agregar alias de grupo, solo individuales.You can’t add group aliases, just individuals.

  6. Decida si cada persona es un miembro o un administrador.Decide whether each person is a member or an admin.

    Establecer miembro o administrador

    Los administradores pueden editar el área de trabajo y agregar otros miembros.Admins can edit the workspace itself, including adding other members. Los miembros pueden editar el contenido del área de trabajo, a menos que tengan acceso de solo lectura.Members can edit the content in the workspace, unless they have view-only access. Los administradores y los miembros pueden publicar la aplicación.Both admins and members can publish the app.

  7. Seleccione Guardar.Select Save.

Power BI crea el área de trabajo y la abre.Power BI creates the workspace and opens it. Aparece en la lista de áreas de trabajo de las que es miembro.It appears in the list of workspaces you’re a member of. Dado que es un administrador, puede seleccionar los puntos suspensivos (...) para volver atrás y realizar cambios, agregar nuevos miembros o cambiar sus permisos.Because you’re an admin, you can select the ellipsis (…) to go back and make changes to it, adding new members or changing their permissions.

Editar área de trabajo

Crear y cargar los informesCreate and upload your reports

Puede crear sus propios informes y conjuntos de datos mediante Power BI Desktop y publicar esos informes en un área de trabajo de la aplicación.You can create your reports and datasets using Power BI Desktop and then publish those reports to an app workspace. El usuario final que publique los informes deberá tener una licencia de Power BI Pro para publicar en un área de trabajo de la aplicación.The end user publishing the reports need to have a Power BI Pro license in order to publish to an app workspace.

Paso 2: Insertar el contenidoStep 2: Embed your content

Dentro de la aplicación, debe autenticarse con Power BI.Within your application, you will need to authenticate with Power BI. Si va a insertar contenido para los clientes, es necesario que almacene las credenciales de la cuenta maestra en la aplicación.If you are embedding content for your customers, you will store the credentials for the master account within your application. Para más información, consulte Authenticate users and get an Azure AD access token for your Power BI app (Autenticación de usuarios y obtención de un token de acceso de Azure AD para su aplicación de Power BI).For more information, see Authenticate users and get an Azure AD access token for your Power BI app.

Una vez autenticado, en la aplicación, utilice las API de REST de Power BI y JavaScript para insertar paneles e informes en la aplicación.Once authenticated, within your application, use the Power BI REST APIs and JavaScript APIs to embed dashboards and reports into your application.

Para insertar contenido para su organización, consulte los siguientes tutoriales:For embedding for your organization, see the following walkthroughs:

Para insertar contenido para sus clientes, lo cual es habitual con aplicaciones de ISV, consulte lo siguiente:For embeding with your customers, which is typical for ISVs, see the following:

Se necesitará un token de inserción en el caso de que las inserciones sean para los clientes.When embedding for your customers, an embed token is required. Para obtener más información, vea GenerateToken.To learn more see, GenerateToken.

Paso 3: Promover la solución a producciónStep 3: Promote your solution to production

Pasar a producción requiere algunos pasos adicionales.Moving to production requires a few extra steps.

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

Si va a realizar inserciones para la organización, solo necesita que los demás sepan cómo acceder a la aplicación.If you are embedding for your organization, you only need to let people know how to get to your application.

Los usuarios con acceso gratuito pueden consumir contenido insertado desde un área de trabajo de la aplicación (grupo), si esa área de trabajo está respaldada por una capacidad.Free users can consume content that is embedded from an app workspace (group), if that workspace is backed by capacity. Haga que el usuario con acceso gratuito aparezca como un miembro del área de trabajo de la aplicación (grupo); en caso contrario, recibirá un error 401 No autorizado.List the Free user as a member of app workspace (group), otherwise you receive a 401 unauthorized error. En la tabla siguiente se enumeran las SKU disponibles de Power BI Premium en Office 365.The following table lists the available Power BI Premium SKUs available within Office 365.

Nodo de capacidadCapacity Node Núcleos totalesTotal cores
(Back-end y front-end)(Backend + frontend)
Núcleos de back-endBackend Cores Núcleos de front-endFrontend Cores Límites de conexiones dinámicas/DirectQueryDirectQuery/live connection limits Representaciones de páginas máximas en horas puntaMax page renders at peak hour
EM3EM3 4 núcleos V4 v-cores 2 núcleos, 10 GB de RAM2 cores, 10GB RAM 2 núcleos2 cores 601-1200601-1,200
P1P1 8 núcleos V8 v-cores 4 núcleos, 25 GB de RAM4 cores, 25GB RAM 4 núcleos4 cores 30 por segundo30 per second 1201-24001,201-2,400
P2P2 16 núcleos V16 v-cores 8 núcleos, 50 GB de RAM8 cores, 50GB RAM 8 núcleos8 cores 60 por segundo60 per second 2401-48002,401-4,800
P3P3 32 núcleos V32 v-cores 16 núcleos, 100 GB de RAM16 cores, 100GB RAM 16 núcleos16 cores 120 por segundo120 per second 4,801-96004,801-9600

Nota

Debe ser un administrador global o de facturación dentro del inquilino para poder comprar Power BI Premium.You must be a Global or Billing Admin, within your tenant, in order to purchase Power BI Premium. Para más información sobre cómo adquirir Power BI Premium, consulte Adquisición de Power BI Premium.For information on how to purchase Power BI Premium, see How to purchase Power BI Premium.

Inserción de contenido para los clientesEmbedding for your customers

Si las inserciones están destinadas para los clientes, debe hacer lo siguiente.If you are embedding for your customers, do the following.

  • Si usa un inquilino independiente para el desarrollo, tendrá que asegurarse de que las áreas de trabajo de la aplicación, junto con los paneles e informes, estén disponibles en el entorno de producción.If you are using a separate tenant for development, then you must make sure your app workspaces, along with dashboards and reports, are available in your production environment. Asegúrese de que creó la aplicación en Azure AD para el inquilino de producción y de que se le asignaron los permisos de aplicación adecuados, tal como se indica en el paso 1.Make sure that you create the application in Azure AD for your production tenant and assign the proper app permissions as indicated in Step 1.
  • Adquiera la capacidad que se adapte a sus necesidades.Purchase a capacity that fits your needs. Puede usar la tabla siguiente para saber qué SKU de la capacidad de Power BI Embedded puede necesitar.You can use the table below to understand which Power BI Embedded capacity SKU you may need. Para obtener más información, vea Embedded analytics capacity planning whitepaper (Notas del producto sobre el planeamiento de la capacidad de análisis de inserción).For more details, see Embedded analytics capacity planning whitepaper. Cuando esté listo para comprar, vaya a Microsoft Azure Portal.When you are ready to purchase, you can do so within the Microsoft Azure portal. Para más información acerca de cómo crear la capacidad de Power BI Embedded, consulte Create Power BI Embedded capacity in the Azure portal (Creación de capacidad de Power BI Embedded en Azure Portal).For details on how to create Power BI Embedded capacity, see Create Power BI Embedded capacity in the Azure portal.

Importante

Dado que la inserción de tokens está pensada solo para propósitos de pruebas, el número de tokens que puede generar una cuenta maestra de Power BI es limitado.Because embed tokens are intended for development testing only, the number of embed tokens a Power BI master account can generate is limited. Debe adquirirse capacidad para escenarios de inserción para producción.A capacity must be purchased for production embedding scenarios. No hay ningún límite en la generación de tokens de inserción cuando se compra una capacidad.There is no limit to embed token generation when a capacity is purchased.

Nodo de capacidadCapacity Node Núcleos totalesTotal cores
(Back-end y front-end)(Backend + frontend)
Núcleos de back-endBackend Cores Núcleos de front-endFrontend Cores Límites de conexiones dinámicas/DirectQueryDirectQuery/live connection limits Representaciones de páginas máximas en horas puntaMax page renders at peak hour
A1A1 1 núcleo V1 v-cores .5 núcleos, 3 GB de RAM.5 cores, 3GB RAM 5 núcleos.5 cores 5 por segundo5 per second 1-3001-300
A2A2 2 núcleos V2 v-cores 1 núcleo, 5 GB de RAM1 core, 5GB RAM 1 núcleo1 core 10 por segundo10 per second 301-600301-600
A3A3 4 núcleos V4 v-cores 2 núcleos, 10 GB de RAM2 cores, 10GB RAM 2 núcleos2 cores 15 por segundo15 per second 601-1200601-1,200
A4A4 8 núcleos V8 v-cores 4 núcleos, 25 GB de RAM4 cores, 25GB RAM 4 núcleos4 cores 30 por segundo30 per second 1201-24001,201-2,400
A5A5 16 núcleos V16 v-cores 8 núcleos, 50 GB de RAM8 cores, 50GB RAM 8 núcleos8 cores 60 por segundo60 per second 2401-48002,401-4,800
A6A6 32 núcleos V32 v-cores 16 núcleos, 100 GB de RAM16 cores, 100GB RAM 16 núcleos16 cores 120 por segundo120 per second 4,801-96004,801-9600
  • Edite el área de trabajo de la aplicación y asígnele una capacidad en las opciones avanzadas.Edit the app workspace and assign it to a capacity under advanced.

    Asignación de un área de trabajo de la aplicación a una capacidad

  • Implemente la aplicación actualizada en producción y empiece a insertar paneles e informes de Power BI.Deploy your updated application to production and begin embedding Power BI dashboards and reports.

Configuración de administraciónAdmin settings

Los administradores globales, o los administradores de servicios de Power BI, pueden activar o desactivar la capacidad para usar las API de REST de un inquilino.Global Admins, or Power BI service administrators, can turn the ability to use the REST APIs, on or off for a tenant. Los administradores de Power BI pueden establecer esta opción de configuración para toda la organización o para grupos de seguridad individuales.Power BI admins can set this setting for the entire organization, or for individual security groups. De forma predeterminada, está habilitada para toda la organización.It is enabled for the entire organization by default. Esto se hace mediante el portal de administración de Power BI.This is done through the Power BI admin portal.

Pasos siguientesNext steps

Inserción con Power BIEmbedding with Power BI
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?
Adquisición de Power BI PremiumHow to purchase Power BI Premium
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