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

Aprenda a migrar de Power BI Embedded al servicio Power BI y aproveche los avances para insertar en aplicaciones.Learn how to migrate from Power BI Embedded to the Power BI service and leverage advances for embedding in apps.

Recientemente, 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 recently 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.

Con la incorporación de Power BI Premium, Power BI Embedded y el servicio Power BI convergen para hacer mejorar la inserción de contenido de Power BI en las aplicaciones.With the introduction of Power BI Premium, Power BI Embedded and the Power BI service are converging to advance how Power BI content is embedded in apps. Esto significa que al insertar el contenido tendrá una superficie de API, 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).This means you will have one API surface, a consistent set of capabilities and access to the latest Power BI features – such as dashboards, gateways and app workspaces – when embedding your content. Más adelante, podrá empezar con Power BI Desktop y pasar a implementar con Power BI Premium, que estará disponible con carácter general en el segundo trimestre de 2017.Moving forward you’ll be able to start with Power BI Desktop and move to deployment with Power BI Premium, which will be generally available late in the second quarter of 2017.

El servicio Power BI Embedded actual continuará estando disponible durante un tiempo limitado tras la disponibilidad general de la oferta convergente: los clientes con un Contrato Enterprise tendrán acceso hasta que expiren los contratos existentes; los clientes que adquieran Power BI Embedded en un canal directo o de CSP disfrutarán de acceso durante un año a partir del comienzo de la disponibilidad general de Power BI Premium.The current Power BI Embedded service will continue to be available for a limited time following general availability of the converged offering: customers under an Enterprise Agreement will have access to through the expiration of their existing agreements; customers that acquired Power BI Embedded through Direct or CSP channels will enjoy access for one year from General Availability of Power BI Premium. En este artículo se ofrecen pautas para migrar del servicio de Azure al servicio Power BI e indicaciones de qué cambios esperar en la aplicación.This article will provide some guidance for migrating from the Azure service to the Power BI service and what to expect for changes in your application.

Importante

Aunque la migración adoptará una dependencia del servicio Power BI, no existe ninguna dependencia de Power BI para los usuarios de la aplicación cuando usen un token de inserción.While the migration will take a dependency on the Power BI service, there is not a dependency on Power BI for the users of your application when using an embed token. 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. Puede utilizar esta estrategia de inserción para los usuarios que no usen Power BI.You can use this embedding approach to service non-Power BI users.

Prepararse para la migraciónPrepare for the migration

Hay algunas cosas que debe hacer para preparar la migración del servicio de Azure Power BI Embedded al servicio Power BI.There are a few things you need to do to prepare for migrating from Power BI Embedded Azure service over to the Power BI service. Necesitará un inquilino, así como un usuario que tenga una licencia de Power BI Pro.You will need a tenant available, along with a user that has a Power BI Pro license.

  1. Asegúrese de tener acceso a un inquilino de Azure Active Directory (Azure AD).Make sure you have access to an Azure Active Directory (Azure AD) tenant.

    Debe determinar qué configuración de inquilinos se usará.You will need to determine what tenant setup to use.

  2. Dentro de este nuevo inquilino, cree un usuario que actuará como su cuenta "maestra" de la aplicación.Create a user within this new tenant that will act as your application "master" account. Esa cuenta debe registrarse en Power BI y debe tener asignada una licencia de Power BI Pro.That account needs to sign up for Power BI and needs to have a Power BI Pro license assigned to it.

Cuentas en Azure ADAccounts within Azure AD

Las siguientes cuentas deberán existir dentro de su inquilino.The following accounts will need to exist within your tenant.

Nota

Estas cuentas deberán tener licencias de Power BI Pro con el fin de usar áreas de trabajo de la aplicación.These accounts will need to have Power BI Pro licenses in order to use App workspaces.

  1. Un usuario administrador del inquilino.A tenant admin user.

    Se recomienda que este usuario sea miembro de todas las áreas de trabajo de la aplicación creadas para la inserción.It is recommended that this user be a member of all App workspaces created for the purpose of embedding.

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

    Estos usuarios deben asignarse a áreas de trabajo de la aplicación según sea necesario.These users should be assigned to App workspaces as needed.

  3. Una cuenta de usuario maestra de la aplicación, o cuenta de servicio.An application master user account, or service account.

    El back-end de aplicaciones almacenará las credenciales para esta cuenta y las usará para adquirir un token de Azure AD para usarlo con las API REST de Power BI.The applications backend will store the credentials for this account and use it for acquiring an Azure AD token for use with the Power BI REST APIs. Se usará esta cuenta para generar el token de inserción para la aplicación.This account will be used to generate the embed token for the application. Esta cuenta debe ser un administrador de las áreas de trabajo de la aplicación creadas para la inserción.This account also needs to be an admin of the App workspaces created for embedding.

    Nota

    Se trata de una cuenta de usuario normal de su organización que se usará con fines de inclusión.This is just a regular user account in your organziation that will be used for the purposes of embedding.

Registro y permisos de la aplicaciónApp registration and permissions

Tendrá que registrar una aplicación en Azure AD y concederle determinados permisos.You will need to register an application within Azure AD and grant certain permissions.

Registrar una aplicaciónRegister an application

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. Esto incluye ir a Azure Portal para aplicar una configuración adicional además de la proporcionada en la página de registro de la aplicación Power BI.This includes going to the Azure portal to apply additional configuration in addition to the Power BI app registration page. 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.

Debe registrar la aplicación mediante la cuenta maestra de la aplicación.You should register the application using the application master account.

Creación de áreas de trabajo de la aplicación (necesario)Create App workspaces (Required)

Puede aprovechar las áreas de trabajo de la aplicación para proporcionar un mejor aislamiento si la aplicación va a dar servicio a varios clientes.You can take advantage of App workspaces to provide better isoliation if your application is servicing multiple customers. Los paneles e informes deberían permanecer aislados entre sus clientes.Dashboards and reports would be isolated between your customers. Podría utilizar una cuenta de Power BI para cada área de trabajo de la aplicación para aislar aún más el uso de la aplicación entre sus clientes.You could then use a Power BI account per App workspace to further isolate application experiences between your customers.

Importante

No puede utilizar un área de trabajo personal para aprovechar las ventajas de la inserción para los usuarios que no usan Power BI.You cannot use a personal workspace to take advantage of embedding to non-Power BI users.

Necesitará un usuario que tenga licencia de la versión Pro para crear un área de trabajo de la aplicación en Power BI.You will need a user that has a Pro license in order to create an app workspace within Power BI. El usuario de Power BI que crea el área de trabajo de la aplicación será su administrador de forma predeterminada.The Power BI user that creates the App workspace will be an admin of that workspace by default.

Nota

La cuenta maestra de la aplicación debe ser un administrador del área de trabajo.The application master account needs to be an admin of the workspace.

Migración de contenidoContent migration

La migración del contenido de las colecciones de áreas de trabajo al servicio Power BI puede realizarse a la vez que usa su solución actual y no requiere ningún tiempo de inactividad.Migrating your content from your workspace collections to the Power BI service can be done in parallel to your current solution and doesn’t require any downtime.

Puede usar una herramienta de migración con el fin de ayudar a copiar el contenido de Power BI Embedded al servicio Power BI.A migration tool is available for you to use in order to assist with copying content from Power BI Embedded to the Power BI service. Sobre todo, si tiene mucho contenido.Especially if you have a lot of content. Para más información, consulte Herramienta de migración de Power BI Embedded.For more information, see Power BI Embedded migration tool.

La migración de contenido se basa principalmente en dos API.Content migration relies mainly on two APIs.

  1. Download PBIX: esta API puede descargar los archivos PBIX que se cargaron en Power BI después de octubre de 2016.Download PBIX - this API can download PBIX files which were uploaded to Power BI after October 2016.
  2. Import PBIX: esta API carga cualquier PBIX en Power BI.Import PBIX - this API uploads any PBIX to Power BI.

Para ver algunos fragmentos de código relacionados, consulte Fragmentos de código para migrar contenido de Power BI Embedded.For some related code snippets, see Code snippets for migrating content from Power BI Embedded.

Tipos de informesReport types

Hay varios tipos de informes y cada uno requiere un flujo de migración ligeramente distinto.There are several types of reports, each requiring a somewhat different migration flow.

Informe y conjunto de datos almacenados en cachéCached dataset & report

Los conjuntos de datos almacenados en caché hacen referencia a los archivos PBIX que hayan importado datos en lugar de una conexión dinámica o una conexión DirectQuery.Cached datasets refer to PBIX files that had imported data as opposed to a live connection or DirectQuery connection.

FlujoFlow

  1. Llame a la API Download PBIX para descargar los archivos PBIX desde el área de trabajo de PaaS.Call Download PBIX API from PaaS workspace.
  2. Guarde los archivos PBIX.Save PBIX.
  3. Llame a Import PBIX para importar los archivos PBIX al área de trabajo de SaaS.Call Import PBIX to SaaS workspace.

Informe y conjunto de datos DirectQueryDirectQuery dataset & report

FlujoFlow

  1. Llame a GET https://api.powerbi.com/v1.0/collections/{collection_id}/workspaces/{wid}/datasets/{dataset_id}/Default.GetBoundGatewayDataSources y guarde la cadena de conexión recibida.Call GET https://api.powerbi.com/v1.0/collections/{collection_id}/workspaces/{wid}/datasets/{dataset_id}/Default.GetBoundGatewayDataSources and save connection string received.
  2. Llame a la API Download PBIX para descargar los archivos PBIX desde el área de trabajo de PaaS.Call Download PBIX API from PaaS workspace.
  3. Guarde los archivos PBIX.Save PBIX.
  4. Llame a Import PBIX para importar los archivos PBIX al área de trabajo de SaaS.Call Import PBIX to SaaS workspace.
  5. Actualice la cadena de conexión mediante una llamada a POST htps://api.powerbi.com/v1.0/myorg/datasets/{dataset_id}/Default.SetAllConnectionsUpdate connection string by calling - POST https://api.powerbi.com/v1.0/myorg/datasets/{dataset_id}/Default.SetAllConnections
  6. Obtenga el identificador de GW y el identificador del origen de datos mediante una llamada a GET https://api.powerbi.com/v1.0/myorg/datasets/{dataset_id}/Default.GetBoundGatewayDataSourcesGet GW id and datasource id by calling - GET https://api.powerbi.com/v1.0/myorg/datasets/{dataset_id}/Default.GetBoundGatewayDataSources
  7. Actualice las credenciales del usuario mediante una llamada a PATCH https://api.powerbi.com/v1.0/myorg/gateways/{gateway_id}/datasources/{datasource_id}Update user's credentials by calling - PATCH https://api.powerbi.com/v1.0/myorg/gateways/{gateway_id}/datasources/{datasource_id}

Informes y conjuntos de datos antiguosOld dataset & reports

Se trata de conjuntos de datos e informes creados antes de octubre de 2016.These are datasets/reports created before October 2016. Download PBIX no admite PBIX que se hayan cargado antes de octubre de 2016Download PBIX doesn't support PBIXs which were uploaded before October 2016

FlujoFlow

  1. Obtenga PBIX desde su entorno de desarrollo (su control de código fuente interno).Get PBIX from your development environment (your internal source control).
  2. Llame a Import PBIX para importar los archivos PBIX al área de trabajo de SaaS.Call Import PBIX to SaaS workspace.

Informe y conjunto de datos de inserciónPush Dataset & report

Download PBIX no admite conjuntos de datos Push API.Download PBIX doesn't support Push API datasets. No se pueden migrar datos de conjuntos de datos Push API desde PaaS a SaaS.Push API dataset data can't be ported from PaaS to SaaS.

FlujoFlow

  1. Llame a la API "Create dataset" con el conjunto de datos JSON para crear el conjunto de datos en el área de trabajo de SaaS.Call "Create dataset" API with dataset Json to create dataset in SaaS workspace.
  2. Vuelva a generar el informe para el conjunto de datos creado.Rebuild report for the created dataset.

Es posible usar algunas soluciones alternativas para migrar el informe de Push API desde PaaS a SaaS haciendo lo siguiente.It is possible using some workarounds to migrate the push api report from PaaS to SaaS by trying the following.

  1. Cargue algunos archivos PBIX ficticios en el área de trabajo de PaaS.Uploading some dummy PBIX to PaaS workspace.
  2. Clone el informe de Push API y enlácelo al PBIX ficticio del paso 1.Clone the push api report and bind it to the dummy PBIX from step 1.
  3. Descargue el informe de Push API con el PBIX ficticio.Download push API report with the dummy PBIX.
  4. Cargue el PBIX ficticio en el área de trabajo de SaaS.Upload dummy PBIX to your SaaS workspace.
  5. Cree el conjunto de datos de inserción en el área de trabajo de SaaS.Create push dataset in your SaaS workspace.
  6. Vuelva a enlazar el informe con el conjunto de datos Push API.Rebind report to push api dataset.

Cree y cargue los nuevos informesCreate and upload new reports

Además del contenido que ha migrado desde el servicio Azure Power BI Embedded, puede crear sus propios informes y conjuntos de datos mediante Power BI Desktop y, a continuación, publicar estos informes en un área de trabajo de la aplicación.In addition to the content you migrated from the Power BI Embedded Azure service, 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.

Recompilar la aplicaciónRebuild your application

  1. Debe modificar la aplicación para que use las API de REST de Power BI y la ubicación del informe en powerbi.com.You will need to modify your application to use the Power BI REST APIs and the report location inside powerbi.com.
  2. Recompile su autenticación AuthN/AuthZ mediante la cuenta maestra para la aplicación.Rebuild your AuthN/AuthZ authentication using the master account for your application. Puede usar un token de inserción para permitir que este usuario actúe en nombre de otros usuarios.You can take advantage of using an embed token to allow this user to act on behalf of other users.
  3. Inserte los informes de powerbi.com en su aplicación.Embed your reports from powerbi.com into your application.

Asignar los usuarios a un usuario de Power BIMap your users to a Power BI user

En la aplicación, asignará los usuarios que administra dentro de la aplicación a unas credenciales maestras de Power BI que se usarán con su aplicación.Within your application, you will map users that you manage within the application to a master Power BI credential for the purposes of your application. Las credenciales para esta cuenta maestra de Power BI se almacenan en la aplicación y se pueden usar para crear tokens de inserción.The credentials for this Power BI master account will be stored within your application and be used to creating embed tokens.

Qué hacer cuando esté listo para la producciónWhat to do when you are ready for production

Cuando esté listo para pasar a producción, debe hacer lo siguiente.When you are ready to move to production, you will need to 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 will need to make sure your app workspaces, along with dashboards and reports, are available in your production environment. También deberá asegurarse 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.You will also need to make sure that you created the application in Azure AD for your production tenant and assigned 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 las notas del producto sobre el planeamiento de la capacidad de análisis de inserción como ayuda para saber lo que podría necesitar.You can use the Embedded analytics capacity planning whitepaper to help understand what you may need. Cuando esté listo para comprar, vaya al Centro de administración de Office 365.When you are ready to purchase, you can do so within the Office 365 admin center.

    [AZURE.INFORMATION] Para más información sobre cómo adquirir Power BI Premium, consulte How to purchase Power BI Premium (Cómo comprar Power BI Premium).[AZURE.INFORMATION] For information on how to purchase Power BI Premium, see How to purchase Power BI Premium.

  • Edite el área de trabajo de la aplicación y asígnele una capacidad Premium en las opciones avanzadas.Edit the App workspace and assign it to a Premium capacity under advanced.

  • Implemente la aplicación actualizada en producción y empiece a insertar informes desde el servicio Power BI.Deploy your updated application to production and begin embedding reports from the Power BI service.

Después de la migraciónAfter migration

Debería hacer una limpieza dentro de Azure.You should do some cleanup within Azure.

  • Quite todas las áreas de trabajo de la solución implementada en el servicio de Azure Power BI Embedded.Remove all workspaces off of the deployed solution within the Azure service of Power BI Embedded.
  • Elimine las colecciones de áreas de trabajo que existan dentro de Azure.Delete any Workspace Collections that exist within Azure.

Pasos siguientesNext steps

Inserción con Power BIEmbedding with Power BI
Herramienta de migración de Power BI EmbeddedPower BI Embedded migration tool
Fragmentos de código para migrar contenido de Power BI EmbeddedCode snippets for migrating content from Power BI Embedded
Procedimiento para insertar paneles, informes e iconos de Power BIHow to embed your Power BI dashboards, reports and tiles
¿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