Comment migrer le contenu d’une collection d’espaces de travail Power BI Embedded vers Power BIHow to migrate Power BI Embedded workspace collection content to Power BI

Découvrez comment migrer de Power BI Embedded vers le service Power BI, et tirez parti des progrès réalisés sur le plan de l’incorporation dans les applications.Learn how to migrate from Power BI Embedded to the Power BI service and leverage advances for embedding in apps.

Microsoft a récemment annoncé Power BI Premium, un nouveau modèle de gestion des licences basé sur la capacité, qui augmente la flexibilité en ce qui concerne la manière dont les utilisateurs consultent, partagent et distribuent du contenu.Microsoft recently announced Power BI Premium, a new capacity-based licensing model that increases flexibility for how users access, share and distribute content. L’offre renforce également l’extensibilité et les performances du service Power BI.The offering also delivers additional scalability and performance to the Power BI service.

Avec l’introduction de Power BI Premium, Power BI Embedded et le service Power BI convergent pour faire progresser la manière dont le contenu Power BI est incorporé dans les applications.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. Cela signifie que vous disposez d’une surface d’API, d’un ensemble cohérent de fonctionnalités et de l’accès aux dernières fonctionnalités de Power BI telles que des tableaux de bord, des passerelles et des espaces de travail d’application lors de l’incorporation de votre contenu.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. Plus tard, vous pourrez commencer à utiliser Power BI Desktop et passer au déploiement avec Power BI Premium qui sera généralement disponible à la fin du deuxième trimestre 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.

Le service Power BI Embedded actuel restera disponible pendant une période limitée après la mise à disposition générale de l’offre convergée. Les clients sous Contrat Entreprise auront accès jusqu’à l’expiration de leur contrat. Les clients ayant acquis Power BI Embedded via des canaux directs ou CSP bénéficieront d’un accès pendant un an à partir de la mise à la disposition générale 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. Cet article fournit quelques conseils pour la migration du service Azure vers le service Power BI et explique ce à quoi il faut s’attendre concernant les modifications dans votre application.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.

Important

Si la migration dépend du service Power BI, les utilisateurs de votre application ne dépendent pas de Power BI lorsque vous utilisez un jeton incorporé.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. Ils n’ont pas besoin de s’inscrire à Power BI pour afficher le contenu incorporé dans votre application.They do not need to sign up for Power BI to view the embedded content in your application. Vous pouvez utiliser cette approche d’incorporation pour les utilisateurs non-Power BI.You can use this embedding approach to service non-Power BI users.

Préparer la migrationPrepare for the migration

Pour préparer la migration du service Power BI Embedded Azure vers le service Power BI, vous devez effectuer quelques opérations.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. Vous allez avoir besoin d’un client disponible ainsi que d’un utilisateur détenteur d’une licence Power BI Pro.You will need a tenant available, along with a user that has a Power BI Pro license.

  1. Assurez-vous que vous avez accès à un client Azure Active Directory (Azure AD).Make sure you have access to an Azure Active Directory (Azure AD) tenant.

    Vous devez déterminer quel locataire utiliser.You will need to determine what tenant setup to use.

  2. Dans ce nouveau locataire, créez un utilisateur correspondant à votre compte d’application « principal ».Create a user within this new tenant that will act as your application "master" account. Ce compte doit s’inscrire à Power BI et disposer d’une licence Power BI Pro.That account needs to sign up for Power BI and needs to have a Power BI Pro license assigned to it.

Comptes dans Azure ADAccounts within Azure AD

Les comptes suivants doivent exister au sein de votre client.The following accounts will need to exist within your tenant.

Note

Ces comptes doivent disposer de licences Power BI Pro pour utiliser les espaces de travail d’applications.These accounts will need to have Power BI Pro licenses in order to use App workspaces.

  1. Un utilisateur administrateur du client.A tenant admin user.

    Il est recommandé que cet utilisateur soit membre de tous les espaces de travail d’application créés à des fins d’incorporation.It is recommended that this user be a member of all App workspaces created for the purpose of embedding.

  2. Des comptes pour les analystes devant créer du contenu.Accounts for analysts that will create content.

    Ces utilisateurs doivent être affectés aux espaces de travail d’application en fonction des besoins.These users should be assigned to App workspaces as needed.

  3. Un compte d’utilisateur principal d’applications, ou compte de service.An application master user account, or service account.

    Le serveur principal d’applications stocke les informations d’identification de ce compte et les utilise pour se procurer le jeton Azure AD à utiliser avec les API REST 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. Ce compte est utilisé pour générer le jeton incorporé pour l’application.This account will be used to generate the embed token for the application. Ce compte doit également être l’administrateur des espaces de travail d’applications créés pour l’incorporation.This account also needs to be an admin of the App workspaces created for embedding.

    Note

    Il s’agit simplement d’un compte d’utilisateur ordinaire de votre organisation qui sera utilisé à des fins d’incorporation.This is just a regular user account in your organziation that will be used for the purposes of embedding.

Inscription et autorisations d’applicationApp registration and permissions

Vous devez inscrire une application dans Azure AD et accorder certaines autorisations.You will need to register an application within Azure AD and grant certain permissions.

Inscrire une applicationRegister an application

Vous devez inscrire votre application avec Azure AD afin d’effectuer des appels d’API REST.You will need to register your application with Azure AD in order to make REST API calls. Cela inclut l’accès au portail Azure pour appliquer une configuration supplémentaire en plus de la page d’inscription de l’application Power BI.This includes going to the Azure portal to apply additional configuration in addition to the Power BI app registration page. Pour plus d’informations, consultez Inscrire une application Azure AD pour incorporer du contenu Power BI.For more information, see Register an Azure AD app to embed Power BI content.

Vous devez inscrire l’application à l’aide du compte principal d’application.You should register the application using the application master account.

Créer des espaces de travail d’application (facultatif)Create App workspaces (Required)

Vous pouvez tirer parti des espaces de travail d’application pour mettre en place une meilleure isolation si votre application sert plusieurs clients.You can take advantage of App workspaces to provide better isoliation if your application is servicing multiple customers. Les tableaux de bord et rapports sont ainsi isolés entre vos clients.Dashboards and reports would be isolated between your customers. Vous pouvez ensuite utiliser un compte Power BI par espace de travail d’application afin d’isoler davantage les expériences d’application entre vos clients.You could then use a Power BI account per App workspace to further isolate application experiences between your customers.

Important

Vous ne pouvez pas utiliser un espace de travail personnel pour tirer parti de l’incorporation à des utilisateurs non-Power BI.You cannot use a personal workspace to take advantage of embedding to non-Power BI users.

Pour créer un espace de travail d’applications dans Power BI, un utilisateur détenteur d’une licence Pro est requis.You will need a user that has a Pro license in order to create an app workspace within Power BI. Par défaut, l’utilisateur de Power BI qui crée l’espace de travail de l’application est un administrateur de cet espace de travail.The Power BI user that creates the App workspace will be an admin of that workspace by default.

Note

Le compte principal d’application doit être un administrateur de l’espace de travail.The application master account needs to be an admin of the workspace.

Migration de contenuContent migration

La migration du contenu de vos collections d’espaces de travail vers le service Power BI peut être effectuée parallèlement à votre solution actuelle et ne requiert aucun temps d’arrêt.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.

Un outil de migration est à votre disposition pour vous aider à copier le contenu de Power BI Embedded vers le service 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. Celui-ci est particulièrement utile si votre contenu est volumineux.Especially if you have a lot of content. Pour plus d’informations, consultez Outil de migration Power BI Embedded.For more information, see Power BI Embedded migration tool.

La migration de contenu repose principalement sur deux API.Content migration relies mainly on two APIs.

  1. Download PBIX (Télécharger PBIX) : cette API permet de télécharger les fichiers PBIX qui ont été chargés dans Power BI après octobre 2016.Download PBIX - this API can download PBIX files which were uploaded to Power BI after October 2016.
  2. Import PBIX (Importer PBIX) : cette API charge n’importe quel fichier PBIX dans Power BI.Import PBIX - this API uploads any PBIX to Power BI.

Pour certains extraits de code associés, consultez Extraits de code pour migrer du contenu à partir de Power BI Embedded.For some related code snippets, see Code snippets for migrating content from Power BI Embedded.

Types de rapportsReport types

Il existe différents types de rapports, chacun nécessitant un flux de migration différent.There are several types of reports, each requiring a somewhat different migration flow.

Rapport et jeu de données en cacheCached dataset & report

Les jeux de données en cache font référence aux fichiers PBIX comportant des données importées, par opposition à une connexion directe ou DirectQuery.Cached datasets refer to PBIX files that had imported data as opposed to a live connection or DirectQuery connection.

FluxFlow

  1. Appelez l’API Download PBIX pour procéder au téléchargement à partir de l’espace de travail PaaS.Call Download PBIX API from PaaS workspace.
  2. Enregistrez le fichier PBIX.Save PBIX.
  3. Appelez l’API Import PBIX pour procéder à l’importation vers l’espace de travail SaaS.Call Import PBIX to SaaS workspace.

Rapport et jeu de données DirectQueryDirectQuery dataset & report

FluxFlow

  1. Appelez GET https://api.powerbi.com/v1.0/collections/{collection_id}/workspaces/{wid}/datasets/{dataset_id}/Default.GetBoundGatewayDataSources et enregistrez la chaîne de connexion reçue.Call GET https://api.powerbi.com/v1.0/collections/{collection_id}/workspaces/{wid}/datasets/{dataset_id}/Default.GetBoundGatewayDataSources and save connection string received.
  2. Appelez l’API Download PBIX pour procéder au téléchargement à partir de l’espace de travail PaaS.Call Download PBIX API from PaaS workspace.
  3. Enregistrez le fichier PBIX.Save PBIX.
  4. Appelez l’API Import PBIX pour procéder à l’importation vers l’espace de travail SaaS.Call Import PBIX to SaaS workspace.
  5. Mettez à jour la chaîne de connexion en appelant : POST https://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. Obtenez l’ID de GW et l’ID de la source de données en appelant : 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. Mettez à jour les informations d’identification de l’utilisateur en appelant : 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}

Jeux de données et rapports obsolètesOld dataset & reports

Il s’agit des jeux de données/rapports créés avant octobre 2016.These are datasets/reports created before October 2016. L’API Download PBIX ne prend pas en charge les fichiers PBIX chargés avant octobre 2016Download PBIX doesn't support PBIXs which were uploaded before October 2016

FluxFlow

  1. Procurez-vous le fichier PBIX à partir de votre environnement de développement (votre contrôle de code source interne).Get PBIX from your development environment (your internal source control).
  2. Appelez l’API Import PBIX pour procéder à l’importation vers l’espace de travail SaaS.Call Import PBIX to SaaS workspace.

Jeu de données et rapport de transmissionPush Dataset & report

L’API Download PBIX ne prend pas en charge les jeux de données API de transmission.Download PBIX doesn't support Push API datasets. Les données des jeux de données API de transmission ne peuvent pas être transférées de PaaS vers SaaS.Push API dataset data can't be ported from PaaS to SaaS.

FluxFlow

  1. Appelez l’API « Create dataset » (Créer un jeu de données) avec le jeu de données Json pour créer un jeu de données dans l’espace de travail SaaS.Call "Create dataset" API with dataset Json to create dataset in SaaS workspace.
  2. Régénérez le rapport pour le jeu de données créé*.Rebuild report for the created dataset*.

Des solutions de contournement peuvent être utilisées pour migrer le rapport de l’API de transmission de PaaS vers SaaS en essayant ce qui suit.It is possible using some workarounds to migrate the push api report from PaaS to SaaS by trying the following.

  1. Chargement de PBIX factices vers l’espace de travail PaaS.Uploading some dummy PBIX to PaaS workspace.
  2. Clonez le rapport de l’API de transmission et liez-le au PBIX factice de l’étape 1.Clone the push api report and bind it to the dummy PBIX from step 1.
  3. Téléchargez le rapport de l’API de transmission avec le PBIX factice.Download push API report with the dummy PBIX.
  4. Chargez le PBIX factice dans votre espace de travail SaaS.Upload dummy PBIX to your SaaS workspace.
  5. Créez le jeu de données de transmission dans votre espace de travail SaaS.Create push dataset in your SaaS workspace.
  6. Reliez le rapport au jeu de données de l’API de transmission.Rebind report to push api dataset.

Créer et charger de nouveaux rapportsCreate and upload new reports

Outre le contenu que vous avez migré à partir du service Azure Power BI Embedded, vous pouvez créer vos rapports et jeux de données à l’aide de Power BI Desktop, puis publier ces rapports dans un espace de travail d’applications.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. Pour publier les rapports dans un espace de travail d’applications, l’utilisateur final doit disposer d’une licence Power BI Pro.The end user publishing the reports need to have a Power BI Pro license in order to publish to an app workspace.

Régénérer votre applicationRebuild your application

  1. Pour utiliser les API REST de Power BI et l’emplacement du rapport dans powerbi.com, vous devez modifier application.You will need to modify your application to use the Power BI REST APIs and the report location inside powerbi.com.
  2. Régénérez votre authentification AuthN/AuthZ à Power BI en utilisant le compte principal pour votre application.Rebuild your AuthN/AuthZ authentication using the master account for your application. Vous pouvez tirer parti de l’utilisation d’un jeton incorporé pour autoriser cet utilisateur à agir au nom d’autres utilisateurs.You can take advantage of using an embed token to allow this user to act on behalf of other users.
  3. Incorporez vos rapports de powerbi.com dans votre application.Embed your reports from powerbi.com into your application.

Mapper vos utilisateurs à un utilisateur de Power BIMap your users to a Power BI user

Dans votre application, vous devez mapper les utilisateurs que vous gérez au sein de ce celle-ci aux informations d’identification d’un compte Power BI master pour les besoins de votre application.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. Les informations d’identification de ce compte Power BI master sont stockées dans votre application et utilisées pour créer des jetons incorporés.The credentials for this Power BI master account will be stored within your application and be used to creating embed tokens.

Que faire lorsque vous êtes prêt pour la productionWhat to do when you are ready for production

Lorsque vous êtes prêt à passer à la production, vous devez procéder comme suit.When you are ready to move to production, you will need to do the following.

  • Si vous utilisez un locataire distinct pour le développement, veillez à ce que vos espaces de travail d’applications ainsi que vos tableaux de bord et rapports soient disponibles dans votre environnement de production.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. Vérifiez également que vous avez créé l’application dans Azure AD pour votre locataire de production et attribué les autorisations d’application appropriées comme indiqué à l’étape 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.
  • Achetez une capacité adaptée à vos besoins.Purchase a capacity that fits your needs. Pour mieux comprendre de quelle quantité et de quel type de capacité vous avez besoin, consultez le Livre blanc Planification de la capacité - Analytique incorporée.To better understand how the amount and type of capacity you neeed, see the Embedded analytics capacity planning whitepaper. Vous pouvez acheter de la capacité dans Azure.You can purchase capacity in Azure.
  • Modifiez l’espace de travail d’applications et attribuez-le à une capacité Premium sous Avancé.Edit the App workspace and assign it to a Premium capacity under advanced.

  • Déployez votre application mise à jour en production, puis commencez à incorporer des rapports à partir du service Power BI.Deploy your updated application to production and begin embedding reports from the Power BI service.

Après la migrationAfter migration

Vous devez effectuer un peu de nettoyage dans Azure.You should do some cleanup within Azure.

  • Supprimez tous les espaces de travail de la solution déployée au sein du service Azure de Power BI Embedded.Remove all workspaces off of the deployed solution within the Azure service of Power BI Embedded.
  • Supprimez toutes les collections d’espaces de travail existant dans Azure.Delete any Workspace Collections that exist within Azure.

Étapes suivantesNext steps

Incorporation avec Power BIEmbedding with Power BI
Outil de migration Power BI EmbeddedPower BI Embedded migration tool
Extraits de code pour migrer du contenu à partir de Power BI EmbeddedCode snippets for migrating content from Power BI Embedded
Comment incorporer vos tableaux de bord, rapports et vignettes Power BIHow to embed your Power BI dashboards, reports and tiles
Qu’est-ce que Power BI Premium ?Power BI Premium - what is it?
Dépôt Git d’API JavaScriptJavaScript API Git repo
Dépôt Git de C# pour Power BI Power BI C# Git repo
Exemple de JavaScript incorporéJavaScript embed sample
Livre blanc Planification d’une capacité d’analytique incorporéeEmbedded analytics capacity planning whitepaper
Livre blanc sur Power BI PremiumPower BI Premium whitepaper

D’autres questions ?More questions? Essayez d’interroger la communauté Power BITry asking the Power BI Community