Power BI Desktop-projekt (förhandsversion)

  • Artikel

Viktigt!

Power BI Desktop-projekt är för närvarande i förhandsversion.

Power BI Desktop introducerar ett nytt sätt att skapa, samarbeta och spara dina projekt. När du sparar ditt arbete som ett Power BI-projekt (PBIP) sparas rapport- och semantiska modellobjektdefinitioner som enskilda oformaterade textfiler i en enkel, intuitiv mappstruktur.

Att spara ditt arbete som ett projekt har följande fördelar:

  • Stöd för textredigeraren – Objektdefinitionsfiler är JSON-formaterade textfiler som innehåller semantisk modell och rapportmetadata. De är offentligt dokumenterade och läsbara. Projektfiler stöder enkla textredigeringsverktyg som Anteckningar, men det är bättre att använda en kodredigerare som Visual Studio Code (VS Code) som ger en omfattande redigeringsupplevelse som intellisense, validering och Git-integrering.

  • Programmatisk generering och redigering av objektdefinitioner – Du kan skapa skript med hjälp av det populära och lätt att använda TMSL (Tabular Model Scripting Language) eller skapa egna anpassade program för att göra ändringar i objektdefinitionerna. Program kan baseras på offentlig dokumentation om objektdefinitionsscheman och/eller klientbibliotek.

  • Källkontroll – Power BI-semantiska modell- och rapportobjektdefinitioner kan lagras i ett källkontrollsystem, till exempel Git. Med Git kan du spåra versionshistorik, jämföra revisioner (diff) och återgå till tidigare versioner. Källkontroll kan också avblockera samarbete när du använder Power BI Desktop med hjälp av välbekanta samarbetsmekanismer för att lösa konflikter (sammanslagning) och granska ändringar (pull-begäranden). Mer information finns i Versionskontroll i Git.

  • Kontinuerlig integrering och kontinuerlig leverans (CI/CD) – Du kan använda system där utvecklare i din organisation skickar en föreslagen ändring till CI/CD-systemet. Systemet validerar sedan ändringen med en serie kvalitetsgrindar innan ändringen tillämpas på produktionssystemet. Dessa kvalitetsgrindar kan innehålla kodgranskningar av andra utvecklare, automatiserad testning och automatiserad version för att verifiera ändringarnas integritet. CI/CD-system bygger vanligtvis på befintliga källkontrollsystem. Mer information finns i DevOps – kontinuerlig integrering och DevOps – kontinuerlig leverans.

Video

Se Power BI Desktop-projekt och andra funktioner för utvecklarläge som introduceras i Microsoft Build 2023.

Aktivera funktioner för förhandsgranskning

Spara som ett projekt i Power BI Desktop är för närvarande i förhandsversion. Om du vill använda den här funktionen behöver du en Premuim-licens och du måste aktivera den i förhandsversionsfunktioner.

Om du vill aktivera i Power BI Desktop-filalternativ >>och inställningar>Alternativ>Förhandsgranskningsfunktioner markerar du kryssrutan för sparande av Power BI-projekt (.pbip).

Spara som ett projekt

Om du arbetar med ett nytt projekt eller om du har öppnat en befintlig Power BI Desktop-fil (pbix) kan du spara ditt arbete som en Power BI-projektfil (pbip):

Skärmdump som visar spara fil som Power BI-projekt

När du sparar som ett projekt sparar Power BI Desktop rapport- och semantiska modellobjekt som mappar, var och en innehåller textfiler som definierar objektet. Du ser följande:

Skärmbild som visar Power BI-projektfiler

När du har sparat som ett projekt kan du se när du arbetar med ett projekt genom att titta på namnlisten:

Skärmbild som visar Power BI Desktop-rubrik när du sparar till projektet.

Om du klickar på namnlisten visas en utfällbar meny som är specifik för Power BI Project. På så sätt kan du hitta projektfilerna samt visningsnamnsinställningarna för rapporten och semantikmodellen. Du kan också öppna mappen i Utforskaren genom att klicka på sökvägarna.

Skärmbild som visar utfällbara Power BI Desktop-rubriker.

Låt oss ta en närmare titt på vad du ser i projektets rotmapp:

<projektnamn>. SemanticModel

En samling filer och mappar som representerar en Power BI-semantisk modell. Den innehåller några av de viktigaste filerna som du förmodligen kommer att arbeta med, till exempel model.bim. Mer information om filer och undermappar och filer här finns i project semantisk modellmapp.

<projektnamn>. Rapport

En samling filer och mappar som representerar en Power BI-rapport. Mer information om filer och undermappar och filer här finns i Project-rapportmappen.

.gitIgnore

Anger avsiktligt ospårade filer som Git ska ignorera. Power BI Desktop skapar .gitignore-filen i rotmappen när den sparas om den inte redan finns.

Semantisk modell och rapportundermappar har alla git-standardfiler som anges i .gitIgnore:

├── project
│   ├── *.SemanticModel
│   │   ├── .pbi
│   │   │   ├── localSettings.json
│   │   │   └── cache.abf
│   ├── *.Report
│   │   ├── .pbi
│   │   │   └── localSettings.json
<project name.pbip>

PBIP-filen innehåller en pekare till en rapportmapp. Om du öppnar en PBIP öppnas målrapporten och modellen för redigering.

Mer information finns i pbip-schemadokumentet.

Öppna ett Power BI-projekt

Du kan öppna Power BI Desktop från Power BI Project-mappen genom att antingen öppna pbip-filen eller pbir-filen i rapportmappen. Båda alternativen öppnar rapporten för redigering och den semantiska modellen om det finns en relativ referens till en semantisk modell.

Du kan spara flera rapporter och semantiska modeller i samma mapp. Det krävs ingen separat pbip-fil för varje rapport eftersom du kan öppna varje rapport direkt från .pbir i rapportmappen.

├── project
│   ├── AdventureWorks-Sales.Report
│   │   └── definition.pbir
│   ├── AdventureWorks-Stocks.Report
│   │   └── definition.pbir
│   ├── AdventureWorks.SemanticModel
|   |   └── *.*
│   .gitignore
└──  AdventureWorks.pbip

Ändringar utanför Power BI Desktop

När du sparas som ett projekt tvingas du inte att göra ändringar i din semantiska modell och rapportdefinitioner endast i Power BI Desktop. Du kan använda andra verktyg som VS Code, communityverktyg med öppen källkod som Tabular Editor eller till och med Anteckningar. Men inte alla filer eller ändringar stöder redigering av externa verktyg med öppen källkod.

Ändringar av filer eller egenskaper utanför Power BI Desktop kan orsaka oväntade fel eller till och med förhindra att Power BI Desktop öppnas. I sådana fall måste du lösa problemen i filerna innan du försöker öppna projektet igen i Power BI Desktop.

Om möjligt anger Power BI Desktop filen och platsen för felet:

Skärmgrepp för att det inte går att öppna filfelet.

Schemainformation för följande filer dokumenteras inte. Under förhandsversionen stöds inte ändringar av dessa filer utanför Power BI Desktop:

Modellredigering

Du kan göra ändringar i den semantiska modelldefinitionen med hjälp av externa verktyg på två sätt:

  • Genom att ansluta till Power BI Desktops Analysis Service-instans (AS) med externa verktyg.
  • Genom att redigera JSON-metadata i filen model.bim med VS Code eller ett annat externt verktyg.

Alla modellobjekt har inte stöd för skrivåtgärder. Att tillämpa ändringar utanför de som stöds kan orsaka oväntade resultat.

Objekt som stöder skrivåtgärder:

Objekt Anslut till AS-instans Filändring
Tabeller Nej Ja
Kolumner Ja 1, 2 Ja
Beräknade tabeller Ja Ja
Beräknade kolumner Ja Ja
Hierarkier Ja Ja
Relationer Ja Ja
Mått Ja Ja
Modell-KPI:er Ja Ja
Beräkningsgrupper Ja Ja
Perspektiv Ja Ja
Översättningar Ja Ja
Säkerhet på radnivå (RLS) Ja Ja
Säkerhet på objektnivå (OLS) Ja Ja
Kommentarer Ja Ja
M-uttryck Nej Ja 3, 4

Tänk på följande:

  • Ändringar för att öppna filer som görs utanför Power BI Desktop kräver en omstart för att ändringarna ska visas i Power BI Desktop. Power BI Desktop känner inte till ändringar i projektfiler som gjorts av andra verktyg.

  • Power BI Desktop stöder inte tabeller med flera partitioner. Endast en enskild partition för varje tabell stöds. Om du skapar tabeller med tomma partitioner eller mer än en partition uppstår ett fel när rapporten öppnas.

  • Automatiska datumtabeller som skapats av Power BI Desktop bör inte ändras med hjälp av externa verktyg.

  • När du ändrar en modell som använder Direct Query för att ansluta en Power BI-semantisk modell eller Analysis Services-modell måste du uppdatera samlingen ChangedProperties och PBI_RemovedChildren för det ändrade objektet så att de innehåller eventuella ändrade eller borttagna egenskaper. Om ChangedProperties och/eller PBI_RemovedChildren inte uppdateras kan Power BI Desktop skriva över eventuella ändringar nästa gång frågan redigeras eller modellen uppdateras i Power BI Desktop.

  • 1 – Det finns stöd för att ändra en kolumns datatyp. Det går dock inte att byta namn på kolumner när du ansluter till AS-instansen.

  • 2 – Om semantikmodellen har funktionen Automatisk datum/tid aktiverad och du skapar en ny datetime-kolumn utanför Power BI Desktop genereras inte den lokala datumtabellen automatiskt.

  • 3 – Partition SourceType måste beräknas, M, entitet eller CalculationGroup. Partitionsläget måste vara Import, DirectQuery eller Dual.

  • 4 – Alla uttrycksredigeringar utanför Power BI Desktop i ett projekt med unappliedChanges.json går förlorade när ändringarna tillämpas.

  • Om du ändrar tabellfrågeuttryck utanför Power BI Desktop tas tabelldata bort när Power BI Desktop startas om.

JSON-filscheman

De flesta projektfiler innehåller metadata i JSON-format. Motsvarande JSON-scheman kan användas för validering och dokumentation.

Med JSON-scheman kan du:

  • Läs mer om konfigurerbara egenskaper.
  • Använd infogad JSON-validering som tillhandahålls av kodredigeraren.
  • Förbättra redigeringen med syntaxmarkering, knappbeskrivningar och automatisk komplettering.
  • Använd externa verktyg med kunskap om egenskaper som stöds i projektmetadata.

Använd VS Code för att mappa JSON-scheman till de filer som skapas. JSON-scheman för projektfiler finns i Git-lagringsplatsen för Power BI Desktop-exempel.

Beaktanden och begränsningar

  • Den här funktionen kräver en Premium-licens.
  • Power BI Desktop känner inte till ändringar som gjorts med andra verktyg eller program. Ändringar som görs med hjälp av externa verktyg kräver att du startar om Power BI Desktop innan ändringarna visas.
  • Känslighetsetiketter stöds inte med Power BI-projekt.
  • Diagramvyn ignoreras när modeller i tjänsten redigeras.
  • När du sparar som ett Power BI-projekt är den maximala längden på sökvägen för projektfiler 260 tecken.
  • I Power BI Desktop kan du inte spara som en PBIP direkt till OneDrive och SharePoint.
  • När du redigerar PBIP-filer utanför Power BI Desktop bör de sparas med UTF-8 utan BOM-kodning.
  • Rapportens språkschema stöds inte med Power BI-projekt.
  • Power BI Desktop använder CRLF som slutpunkt. För att undvika problem i dina diffs konfigurerar du Git för att hantera radslut genom att aktivera autocrlf.
  • Power BI Projects stöds för närvarande inte i Microsoft Power BI Desktop (optimerat för Power BI-rapportserver).

Vanliga frågor och svar

Fråga: Om du tittar på semantisk modell och mappdefinitioner för rapportobjekt markeras bara ett fåtal filer efter behov, vad händer om jag tar bort dem?

Svar: Power BI Desktop skapar dem automatiskt när du sparar dem som ett projekt (PBIP).

Fråga: Känner Power BI Desktop till de ändringar jag gör i Power BI-projektfilerna från ett externt verktyg eller program?

Svar: Nej. Alla ändringar som görs i filerna kräver att Power BI Desktop startas om för att återspegla dessa ändringar.

Fråga: Om jag konverterar en PBIX till en PBIP, kan jag konvertera tillbaka den till PBIX?

Svar: Ja. Du kan spara en PBIX som en PBIP eller spara en PBIP som PBIX.

Fråga: Kan jag konvertera PBIX till PBIP och vice versa programmatiskt?

Svar: Nej. Du kan bara konvertera en PBIX till en PBIP och vice versa med hjälp av Filspara som i Power BI Desktop.>

Fråga: Kan jag distribuera ett Power BI Desktop-projekt till Azure Analysis Services (AAS) eller SQL Server Analysis Services (SSAS)?

Svar: Nej. Power BI Desktop-projektrapportdefinitioner stöds inte i AAS och SSAS. Och modelldefinitioner använder en förbättrad metadata som är unik för Power BI. För AAS- och SSAS-projekt använder du Microsoft Visual Studio för modellredigering, Git och Azure DevOps-integrering.

Relaterat innehåll