Så här migrerar du innehåll från Power BI-arbetsytesamlingar till Power BI EmbeddedHow to migrate Power BI Workspace Collection content to Power BI Embedded

Lär dig hur du migrerar från Power BI-arbetsytesamling till Power BI Embedded och utnyttjar nyheterna för inbäddning i appar.Learn how to migrate from Power BI Workspace Collection to Power BI Embedded and leverage advances for embedding in apps.

Microsoft presenterade nyligen Power BI Embedded, en ny kapacitetsbaserad licensieringsmodell som ökar flexibiliteten för hur användare får åtkomst till innehåll, och hur de kan dela och distribuera det.Microsoft recently announced Power BI Embedded, a new capacity-based licensing model that increases flexibility for how users access, share and distribute content. Erbjudandet ger också ytterligare skalbarhet och prestanda.The offering also delivers additional scalability and performance.

Med Power BI Embedded kommer du att ha en API-yta, en konsekvent uppsättning funktioner och tillgång till de senaste funktionerna i Power BI när du bäddar in innehåll, till exempel instrumentpaneler, gatewayer och apparbetsytor.With Power BI Embedded, 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. Framöver kommer du att kunna börja med Power BI Desktop och gå vidare till distribution med Power BI Embedded.Moving forward you’ll be able to start with Power BI Desktop and move to deployment with Power BI Embedded.

Nuvarande Power BI-arbetsytesamling fortsätter att vara tillgänglig under en begränsad tid.The current Power BI Workspace Collection will continue to be available for a limited time. Kunder med ett Enterprise-avtal har åtkomst till dess att deras befintliga avtal förfaller. Kunder som anskaffat Power BI-arbetsytesamling genom direkt- eller CSP-kanaler har åtkomst i ett år efter den allmänt tillgängliga versionen av Power BI Embedded.Customers under an Enterprise Agreement will have access through the expiration of their existing agreements; customers that acquired Power BI Workspace Collection through Direct or CSP channels will maintain access for one year from the General Availability release of Power BI Embedded. Den här artikeln ger dig anvisningar om hur du migrerar från Power BI-arbetsytesamling till den nya Power BI Embedded-miljön, och information om vilka förändringar du kan förvänta dig i ditt program.This article will provide some guidance for migrating from Power BI Workspace Collection to the new Power BI Embedded experience and what to expect for changes in your application.

Viktigt

Medan migreringen har ett beroende i förhållande till Power BI Embedded, så finns det inget beroende gentemot Power BI för ditt programs användare när en inbäddningstoken används.While the migration will take a dependency on Power BI Embedded, there is not a dependency on Power BI for the users of your application when using an embed token. De behöver inte registrera sig för Power BI om du vill visa ditt programs inbäddade innehåll.They do not need to sign up for Power BI to view the embedded content in your application. Du kan använda den här inbäddningsmetoden för Embedded-användare som inte använder Power BI.You can use this embedding approach to Embedded non-Power BI users.

Innan du börjar migrera till nya Power BI Embedded kan du titta på en snabb genomgång som beskriver hur du konfigurerar den nya Power BI Embedded-miljön med hjälp av konfigurationsverktyget för inbäddning.Before you get started migrating to the new Power BI Embedded, you can quickly go through a walkthrough that helps you set up your new Power BI Embedded environment using the Embedding setup tool.

Välj den lösning som passar dig:Choose the solution that is right for you:

Förbereda för migreringPrepare for the migration

Det finns några saker du behöver göra för att förbereda migreringen från Power BI-arbetsytesamling till Power BI Embedded.There are a few things you need to do to prepare for migrating from Power BI Workspace Collection to Power BI Embedded. Du behöver en tillgänglig klient och en användare med en Power BI Pro-licens.You will need a tenant available, along with a user that has a Power BI Pro license.

  1. Kontrollera att du har åtkomst till en Azure Active Directory (Azure AD)-klient.Make sure you have access to an Azure Active Directory (Azure AD) tenant.

    Du måste fastställa vilken klientkonfiguration som ska användas.You need to determine which tenant setup to use.

  2. Skapa en användare i den nya klienten som ska fungera som ditt programs ”huvudkonto”.Create a user within this new tenant that will act as your application "master" account. Detta konto måste registreras för Power BI och måste ha tilldelats en Power BI Pro-licens.That account needs to sign up for Power BI and needs to have a Power BI Pro license assigned to it.

Konton i Azure ADAccounts within Azure AD

Följande konton måste finnas i din klient.The following accounts will need to exist within your tenant.

Anteckning

Dessa konton måste ha Power BI Pro-licenser för att kunna använda appens arbetsytor.These accounts will need to have Power BI Pro licenses in order to use App workspaces.

  1. En klientadministratörsanvändare.A tenant admin user.

    Den här användaren bör vara medlem i alla apparbetsytor som har skapats för inbäddning.It is recommended that this user be a member of all App workspaces created for the purpose of embedding.

  2. Konton för analytiker som skapar innehåll.Accounts for analysts that will create content.

    Dessa användare ska tilldelas apparbetsytor vid behov.These users should be assigned to App workspaces as needed.

  3. Ett programs huvudanvändarkonto eller Embedded-konto.An application master user account, or Embedded account.

    Programmets serverdel sparar kontots autentiseringsuppgifter och använder dem för att skaffa en Azure AD-token som kan användas med Power BI REST-API:er.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. Det här kontot används för att generera programmets inbäddningstoken.This account will be used to generate the embed token for the application. Kontot måste också vara administratör för de apparbetsytor som skapats för inbäddning.This account also needs to be an admin of the App workspaces created for embedding.

Anteckning

Detta är helt enkelt ett vanligt användarkonto i din organisation som används i inbäddningssyfte.This is just a regular user account in your organziation that will be used for the purposes of embedding.

Appregistrering och behörigheterApp registration and permissions

Du måste registrera ett program i Azure AD och bevilja det vissa behörigheter.You will need to register an application within Azure AD and grant certain permissions.

Registrera ett programRegister an application

Du måste registrera ditt program med Azure AD för att kunna göra REST API-anrop.You will need to register your application with Azure AD in order to make REST API calls. Detta inkluderar att gå till Azure Portal så att du kan göra ytterligare konfiguration utöver Power BI-appens registreringssida.This includes going to the Azure portal to apply additional configuration in addition to the Power BI app registration page. Mer information finns i Registrera en Azure AD-app för att bädda in Power BI-innehåll.For more information, see Register an Azure AD app to embed Power BI content.

Du bör registrera programmet med programmets huvudkonto.You should register the application using the application master account.

Skapa apparbetsytor (obligatoriskt)Create App workspaces (Required)

Du kan använda apparbetsytor för att få bättre isolering om programmet betjänar flera kunder.You can take advantage of App workspaces to provide better isolation if your application is servicing multiple customers. Instrumentpaneler och rapporter skulle isoleras mellan kunderna.Dashboards and reports would be isolated between your customers. Du kan sedan använda ett Power BI-konto per apparbetsyta och därmed isolera programanvändandet ytterligare mellan dina kunder.You could then use a Power BI account per App workspace to further isolate application experiences between your customers.

Viktigt

Du kan inte använda en personlig arbetsyta för att utnyttja inbäddningsmöjligheten för användare som inte är Power BI-användare.You cannot use a personal workspace to take advantage of embedding to non-Power BI users.

Du behöver en användare som har en Pro-licens för att kunna skapa en apparbetsyta i Power BI.You will need a user that has a Pro license in order to create an app workspace within Power BI. Den Power BI-användare som skapar apparbetsytan blir som standard arbetsytans administratör.The Power BI user that creates the App workspace will be an admin of that workspace by default.

Anteckning

Programmets huvudkonto måste vara arbetsytans administratör.The application master account needs to be an admin of the workspace.

InnehållsmigreringContent migration

Migrering av innehållet från dina samlingar med arbetsytor till Power BI Embedded kan ske parallellt med din aktuella lösning och kräver inget driftstopp.Migrating your content from your workspace collections to Power BI Embedded can be done in parallel to your current solution and doesn’t require any downtime.

Det finns ett tillgängligt migreringsverktyg som du kan använda för att kopiera innehåll från Power BI-arbetsytesamling till Power BI Embedded.A migration tool is available for you to use in order to assist with copying content from Power BI Workspace Collection to Power BI Embedded. Särskilt om du har mycket innehåll.Especially if you have a lot of content. Mer information finns i Migreringsverktyget för Power BI Embedded.For more information, see Power BI Embedded migration tool.

Innehållsmigreringen förlitar sig i huvudsak på två API:er.Content migration relies mainly on two APIs.

  1. Hämta PBIX – detta API kan hämta PBIX-filer som har överförts till Power BI efter oktober 2016.Download PBIX - this API can download PBIX files which were uploaded to Power BI after October 2016.
  2. Importera PBIX – detta API överför valfri PBIX till Power BI.Import PBIX - this API uploads any PBIX to Power BI.

Relaterade kodfragment beskrivs i Kodfragment för migrering av innehåll från Power BI-arbetsytesamling.For some related code snippets, see Code snippets for migrating content from Power BI Workspace Collection.

RapporttyperReport types

Det finns flera typer av rapporter, som var och en kräver ett något annorlunda migreringsflöde.There are several types of reports, each requiring a somewhat different migration flow.

Cachelagrad datauppsättning och rapportCached dataset & report

Med cachelagrade datauppsättningar avses PBIX-filer som har importerade data istället för en live-anslutning eller DirectQuery-anslutning.Cached datasets refer to PBIX files that had imported data as opposed to a live connection or DirectQuery connection.

FlowFlow

  1. Anropshämta PBIX API från PaaS-arbetsytan.Call Download PBIX API from PaaS workspace.
  2. Spara PBIX.Save PBIX.
  3. Anropsimportera PBIX till SaaS-arbetsytan.Call Import PBIX to SaaS workspace.

DirectQuery-datauppsättning och -rapportDirectQuery dataset & report

FlowFlow

  1. Anropa GET https://api.powerbi.com/v1.0/collections/{collection_id}/workspaces/{wid}/datasets/{dataset_id}/Default.GetBoundGatewayDataSources och spara anslutningssträngen som tagits emot.Call GET https://api.powerbi.com/v1.0/collections/{collection_id}/workspaces/{wid}/datasets/{dataset_id}/Default.GetBoundGatewayDataSources and save connection string received.
  2. Anropshämta PBIX API från PaaS-arbetsytan.Call Download PBIX API from PaaS workspace.
  3. Spara PBIX.Save PBIX.
  4. Anropsimportera PBIX till SaaS-arbetsytan.Call Import PBIX to SaaS workspace.
  5. Uppdatera anslutningssträngen genom att anropa – 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. Hämta GW-ID och datakällans ID genom att anropa – 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. Uppdatera användarens autentiseringsuppgifter genom att anropa – 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}

Gammal datauppsättning och rapporterOld dataset & reports

Dessa är datauppsättningar/rapporter som skapats före oktober 2016.These are datasets/reports created before October 2016. PBIX-hämtningen stöder inte PBIX:er som hämtades före oktober 2016Download PBIX doesn't support PBIXs which were uploaded before October 2016

FlowFlow

  1. Hämta PBIX från din utvecklingsmiljö (din interna källkontroll).Get PBIX from your development environment (your internal source control).
  2. Anropsimportera PBIX till SaaS-arbetsytan.Call Import PBIX to SaaS workspace.

Push-överför datauppsättning och rapportPush Dataset & report

PBIX-hämtning stöder inte Push API-datauppsättningar.Download PBIX doesn't support Push API datasets. API-datauppsättningsdata för push-överföring API kan inte porteras från PaaS till SaaS.Push API dataset data can't be ported from PaaS to SaaS.

FlowFlow

  1. Anropa API:et för att skapa datauppsättning med datauppsättnings-JSON för att skapa datauppsättningar på SaaS-arbetsytan.Call "Create dataset" API with dataset Json to create dataset in SaaS workspace.
  2. Återskapa rapporten för den skapade datauppsättningen *.Rebuild report for the created dataset*.

Du kan använda vissa lösningar för att migrera push-API-rapporten från PaaS till SaaS genom att göra på följande sätt.It is possible, using some workarounds, to migrate the push api report from PaaS to SaaS by trying the following.

  1. Ladda upp några dummy-PBIX:er till PaaS-arbetsytan.Uploading some dummy PBIX to PaaS workspace.
  2. Klona push-API-rapporten och bind den till dummy-PBIX:en från steg 1.Clone the push api report and bind it to the dummy PBIX from step 1.
  3. Hämta push-API-rapporten med dummy-PBIX:en.Download push API report with the dummy PBIX.
  4. Överför dummy-PBIX:en till SaaS-arbetsytan.Upload dummy PBIX to your SaaS workspace.
  5. Skapa push-datauppsättning på din SaaS-arbetsyta.Create push dataset in your SaaS workspace.
  6. Bind om rapporten till push-API-datauppsättningen.Rebind report to push api dataset.

Skapa och ladda upp nya rapporterCreate and upload new reports

Utöver det innehåll som du har migrerat från Power BI-arbetsytesamlingen, så kan du skapa rapporter och datauppsättningar som använder Power BI Desktop och publicera dessa rapporter på en apparbetsyta.In addition to the content you migrated from the Power BI Workspace Collection, you can create your reports and datasets using Power BI Desktop and then publish those reports to an app workspace. Användaren som publicerar rapporterna behöver en Power BI Pro-licens för att publicera till en apparbetsyta.The end user publishing the reports need to have a Power BI Pro license in order to publish to an app workspace.

Återskapa ditt programRebuild your application

  1. Du måste ändra ditt program om du vill kunna använda Power BI REST-API:erna och rapportplatsen på powerbi.com.You will need to modify your application to use the Power BI REST APIs and the report location inside powerbi.com.
  2. Återskapa din AuthN/AuthZ-autentisering med hjälp av ditt programs huvudkonto.Rebuild your AuthN/AuthZ authentication using the master account for your application. Du kan utnyttja möjligheten att använda en inbäddningstoken så att användaren kan agera som ombud för andra användare.You can take advantage of using an embed token to allow this user to act on behalf of other users.
  3. Bädda in dina rapporter från powerbi.com i ditt program.Embed your reports from powerbi.com into your application.

Mappa dina användare till en Power BI-användareMap your users to a Power BI user

I ditt program mappar du användare som du hanterar i programmet till ett Power BI- huvudkontos autentiseringsuppgifter.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. Autentiseringsuppgifterna för det här Power BI-huvudkontot lagras i ditt program och används för att skapa inbäddningstoken.The credentials for this Power BI master account will be stored within your application and be used to creating embed tokens.

Vad du ska göra när det är dags för produktionWhat to do when you are ready for production

När du är redo att gå vidare till produktion måste du göra följande.When you are ready to move to production, you will need to do the following.

  • Om du använder en separat klient för utveckling, så måste du kontrollera att dina apparbetsytor, tillsammans med instrumentpaneler och rapporter, är tillgängliga i din produktionsmiljö.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. Du måste också kontrollera att du har skapat programmet i Azure AD för din produktionsklient och tilldelat rätt appbehörigheter, så som beskrivs i steg 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.

  • Köp en kapacitet som passar dina behov.Purchase a capacity that fits your needs. För att bättre förstå den mängd och typ av kapacitet du behöver, se white paper om kapacitetsplanering för analys i Power BI Embedded.To better understand how the amount and type of capacity you need, see the Power BI Embedded analytics capacity planning whitepaper. Du kan köpa kapacitet i Azure.You can purchase capacity in Azure.

  • Redigera apparbetsytan och tilldela den till en Premium.kapacitet under Avancerat.Edit the App workspace and assign it to a Premium capacity under advanced.

  • Distribuera ditt uppdaterade program till produktion och börja bädda in rapporter från Power BI Embedded.Deploy your updated application to production and begin embedding reports from the Power BI Embedded.

Efter migreringenAfter migration

Rensa i Azure.You should do some cleanup within Azure.

  • Ta bort alla arbetsytor från den distribuerade lösningen i Azure Embedded för Power BI-arbetsytesamling.Remove all workspaces off of the deployed solution within the Azure Embedded of Power BI Workspace Collection.
  • Ta bort eventuella arbetsytesamlingar från Azure.Delete any Workspace Collections that exist within Azure.

Nästa stegNext steps

Bädda in med Power BIEmbedding with Power BI
Migreringsverktyg för Power BI-arbetsytesamlingPower BI Workspace Collection migration tool
Kodfragment för migrering av innehåll från Power BI-arbetsytesamlingCode snippets for migrating content from Power BI Workspace Collection
Så här bäddar du in dina Power BI-instrumentpaneler, -rapporter och -panelerHow to embed your Power BI dashboards, reports and tiles
Power BI Premium – vad är det?Power BI Premium - what is it?
JavaScript API Git RepoJavaScript API Git repo
Power BI C# Git RepoPower BI C# Git repo
JavaScript-inbäddningsexempelJavaScript embed sample
White paper om kapacitetsplanering för analys i arbetsytesamlingWorkspace Collection analytics capacity planning whitepaper
Power BI Premium – white paperPower BI Premium whitepaper

Har du fler frågor?More questions? Fråga Power BI CommunityTry asking the Power BI Community