Power BI Desktop-projekter (PRØVEVERSION)

  • Artikel

Vigtigt

Power BI Desktop-projekter er i øjeblikket en prøveversion.

Power BI Desktop introducerer en ny måde at oprette, samarbejde og gemme dine projekter på. Når du gemmer dit arbejde som et Power BI-projekt (PBIP), gemmes definitioner af rapport- og semantiske modelelementer som individuelle filer i almindelig tekst i en enkel, intuitiv mappestruktur.

Der er følgende fordele ved at gemme dit arbejde som et projekt:

  • Understøttelse af teksteditor – Elementdefinitionsfiler er JSON-formaterede tekstfiler, der indeholder semantiske model- og rapportmetadata. De er offentligt dokumenterede og kan læses af mennesker. Mens projektfiler understøtter enkle tekstredigeringsværktøjer som Notesblok, er det bedre at bruge en kodeeditor, f.eks. Visual Studio Code (VS Code), som giver en omfattende redigeringsoplevelse, herunder intellisense, validering og Git-integration.

  • Programmatisk generering og redigering af elementdefinitioner – Du kan oprette scripts ved hjælp af det populære og nemme at bruge TMSL (Tabular Model Scripting Language) eller oprette dine egne brugerdefinerede programmer for at foretage ændringer af elementdefinitionerne. Programmer kan være baseret på offentlig dokumentation af elementdefinitionsskemaer og/eller klientbiblioteker.

  • Versionsstyring – Definitioner af semantiske Power BI-modeller og rapportelementer kan gemmes i et kildekontrolsystem, f.eks. Git. Med Git kan du spore versionshistorik, sammenligne ændringer (diff) og vende tilbage til tidligere versioner. Kontrolelementet Source kan også fjerne blokeringen af samarbejde, når du bruger Power BI Desktop, ved hjælp af velkendte samarbejdsmekanismer til løsning af konflikter (fletning) og gennemsyn af ændringer (pullanmodninger). Du kan få mere at vide under Versionsstyring i Git.

  • Kontinuerlig integration og kontinuerlig levering (CI/CD) – Du kan bruge systemer, hvor udviklere i din organisation indsender en foreslået ændring til CI/CD-systemet. Systemet validerer derefter ændringen med en række kvalitetsporte , før ændringen anvendes på produktionssystemet. Disse kvalitetsporte kan omfatte kodegennemgange foretaget af andre udviklere, automatiseret test og automatiseret build for at validere ændringernes integritet. CI/CD-systemer er typisk bygget oven på eksisterende kildekontrolsystemer. Du kan få mere at vide under DevOps – Kontinuerlig integration og DevOps – Kontinuerlig levering.

Video

Se Power BI Desktop-projekter og andre funktioner i udviklertilstand, der introduceres i Microsoft Build 2023.

Aktivér forhåndsversionsfunktioner

Lagring som et projekt i Power BI Desktop er i øjeblikket en prøveversion. Hvis du vil bruge denne funktion, skal du have en Premuim-licens , og du skal aktivere den i prøveversionsfunktioner.

Hvis du vil aktivere, skal du markere afkrydsningsfeltet for lagring af Power BI Project (.pbip) i Power BI Desktop >Filindstillinger>>Funktioner>til eksempelvisning.

Gem som et projekt

Hvis du arbejder på et nyt projekt, eller du har åbnet en eksisterende Power BI Desktop-fil (pbix), kan du gemme dit arbejde som en Power BI-projektfil (pbip):

Skærmbillede, der viser gem fil som Power BI-projekt

Når du gemmer som et projekt, gemmer Power BI Desktop rapport- og semantiske modelelementer som mapper, der hver især indeholder tekstfiler, der definerer elementet. Du kan se følgende:

Skærmbillede, der viser Power BI Project-filer

Når du har gemt som et projekt, kan du se, hvornår du arbejder på et projekt, ved at se på titellinjen:

Skærmbillede, der viser Power BI Desktop-titel, når du gemmer i projektet.

Hvis du klikker på titellinjen, vises der et pop op-vindue, der er specifikt for Power BI Project. Dette giver dig mulighed for at finde projektfilerne samt indstillingerne for vist navn for rapporten og den semantiske model. Du kan også åbne mappen i Stifinder ved at klikke på stierne.

Skærmbillede, der viser titel i Power BI Desktop-pop op-vindue.

Lad os se nærmere på, hvad du ser i projektets rodmappe:

<projektnavn>. Semantisk model

En samling filer og mapper, der repræsenterer en semantisk Power BI-model. Den indeholder nogle af de vigtigste filer, du sandsynligvis vil arbejde med, f.eks. model.bim. Hvis du vil vide mere om filerne og undermapperne og filerne her, skal du se mappen Project Semantic Model.

<projektnavn>. Rapport

En samling filer og mapper, der repræsenterer en Power BI-rapport. Du kan få mere at vide om filerne og undermapperne og filerne her i Project-rapportmappen.

.gitIgnore

Angiver bevidst ikke-sporede filer, som Git skal ignorere. Power BI Desktop opretter .gitignore-filen i rodmappen, når den gemmes, hvis den ikke allerede findes.

Semantiske model- og rapportundermapper har hver især de git-ignorerede standardfiler, der er angivet i .gitIgnore:

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

PBIP-filen indeholder en markør til en rapportmappe. Når du åbner en PBIP, åbnes den målrettede rapport og model til oprettelse.

Du kan finde flere oplysninger i pbip-skemadokumentet.

Åbn et Power BI-projekt

Du kan åbne Power BI Desktop fra Power BI Project-mappen ved enten at åbne pbip-filen eller pbir-filen i rapportmappen. Begge indstillinger åbner rapporten til redigering og den semantiske model, hvis der er en relativ reference til en semantisk model.

Du kan gemme flere rapporter og semantiske modeller i den samme mappe. Det er ikke nødvendigt at have en separat pbip-fil til hver rapport, fordi du kan åbne hver rapport direkte fra .pbir i rapportmappen.

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

Ændringer uden for Power BI Desktop

Når du gemmer som et projekt, tvinges du ikke til kun at foretage ændringer af din semantiske model og rapportdefinitioner i Power BI Desktop. Du kan bruge andre værktøjer, f.eks. VS Code, communityværktøjer med åben kildekode, f.eks. Tabular Editor eller endda Notesblok. Det er dog ikke alle filer eller ændringer, der understøtter redigering af eksterne værktøjer med åben kildekode.

Ændringer af filer eller egenskaber uden for Power BI Desktop kan medføre uventede fejl eller endda forhindre, at Power BI Desktop åbnes. I disse tilfælde skal du løse problemerne i filerne, før du forsøger at åbne projektet igen i Power BI Desktop.

Hvis det er muligt, angiver Power BI Desktop filen og placeringen af fejlen:

Der opstod en fejl under skærmåbningen, da filen ikke kunne åbnes.

Skemadetaljer for følgende filer dokumenteres ikke. Under prøveversionen understøttes ændringer af disse filer uden for Power BI Desktop ikke:

Oprettelse af modeller

Du kan foretage ændringer i definitionen af den semantiske model ved hjælp af eksterne værktøjer på to måder:

  • Ved at oprette forbindelse til Forekomsten af Analysis Service (AS) i Power BI Desktop med eksterne værktøjer.
  • Ved at redigere JSON-metadata i filen model.bim ved hjælp af VS Code eller et andet eksternt værktøj.

Ikke alle modelobjekter understøtter skrivehandlinger. Anvendelse af ændringer uden for de understøttede kan medføre uventede resultater.

Objekter, der understøtter skrivehandlinger:

Object Forbind til AS-forekomst Filændring
Tabeller Nej Ja
Kolonner Ja 1, 2 Ja
Beregnede tabeller Ja Ja
Beregnede kolonner Ja Ja
Hierarkier Ja Ja
Relationer Ja Ja
Målinger Ja Ja
Model-KPI'er Ja Ja
Beregningsgrupper Ja Ja
Perspektiver Ja Ja
Oversættelser Ja Ja
Sikkerhed på rækkeniveau (RLS) Ja Ja
Sikkerhed på objektniveau (OLS) Ja Ja
Anmærkninger Ja Ja
M-udtryk Nr. Ja 3, 4

Vær opmærksom på:

  • Eventuelle ændringer af åbne filer, der er foretaget uden for Power BI Desktop, kræver en genstart, for at disse ændringer kan vises i Power BI Desktop. Power BI Desktop er ikke opmærksom på ændringer af projektfiler, der er foretaget af andre værktøjer.

  • Power BI Desktop understøtter ikke tabeller med flere partitioner. Kun en enkelt partition for hver tabel understøttes. Oprettelse af tabeller med tomme partitioner eller mere end én partition resulterer i en fejl, når rapporten åbnes.

  • Automatiske datotabeller, der er oprettet af Power BI Desktop, bør ikke ændres ved hjælp af eksterne værktøjer.

  • Når du ændrer en model, der bruger Direct Query til at oprette forbindelse til en semantisk Power BI-model eller Analysis Services-model, skal du opdatere samlingen ChangedProperties og PBI_RemovedChildren for det ændrede objekt, så den indeholder eventuelle ændrede eller fjernede egenskaber. Hvis ChangedProperties og/eller PBI_RemovedChildren ikke opdateres, kan Power BI Desktop overskrive eventuelle ændringer, næste gang forespørgslen redigeres, eller modellen opdateres i Power BI Desktop.

  • 1 – Ændring af en kolonnes datatype understøttes. Omdøbning af kolonner understøttes dog ikke, når der oprettes forbindelse til AS-forekomsten.

  • 2 – Hvis funktionen Automatisk dato/klokkeslæt er aktiveret for den semantiske model, og du opretter en ny datetime-kolonne uden for Power BI Desktop, genereres den lokale datotabel ikke automatisk.

  • 3 – Partition SourceType skal beregnes, M, Entity eller CalculationGroup. Partitionstilstand skal være Import, DirectQuery eller Dual.

  • 4 – Alle ændringer af udtryk uden for Power BI Desktop i et projekt med unappliedChanges.json går tabt, når disse ændringer anvendes.

  • Hvis du ændrer tabelforespørgselsudtryk uden for Power BI Desktop, fjernes tabeldataene, når Power BI Desktop genstartes.

JSON-filskemaer

De fleste projektfiler indeholder metadata i JSON-format. Tilsvarende JSON-skemaer kan bruges til validering og dokumentation.

Med JSON-skemaer kan du:

  • Få mere at vide om egenskaber, der kan konfigureres.
  • Brug indbygget JSON-validering, der leveres af kodeeditoren.
  • Gør oprettelse bedre med syntaksfremhævning, værktøjstip og autofuldførelse.
  • Brug eksterne værktøjer med viden om understøttede egenskaber i projektmetadata.

Brug VS Code til at knytte JSON-skemaer til de filer, der oprettes. JSON-skemaer til projektfiler findes i Git-lageret med Power BI Desktop-eksempler.

Overvejelser og begrænsninger

  • Denne funktion kræver en Premium-licens.
  • Power BI Desktop er ikke opmærksom på ændringer, der er foretaget med andre værktøjer eller programmer. Ændringer, der foretages ved hjælp af eksterne værktøjer, kræver, at du genstarter Power BI Desktop, før disse ændringer vises.
  • Følsomhedsmærkater understøttes ikke i Power BI-projekter.
  • Diagramvisning ignoreres, når du redigerer modeller i tjenesten.
  • Når du gemmer som et Power BI-projekt, er den maksimale længde på stien til projektfilerne 260 tegn.
  • I Power BI Desktop kan du ikke gemme som PBIP direkte på OneDrive og SharePoint.
  • Når du redigerer PBIP-filer uden for Power BI Desktop, skal de gemmes ved hjælp af UTF-8 uden BOM-kodning.
  • Rapportsprogligt skema understøttes ikke i Power BI-projekter.
  • Power BI Desktop bruger CRLF som end-of-line. Hvis du vil undgå problemer i dine sammenligninger, skal du konfigurere Git til at håndtere linjeafslutninger ved at aktivere autocrlf.
  • Power BI-projekter understøttes i øjeblikket ikke i Microsoft Power BI Desktop (optimeret til Power BI-rapportserver).

Ofte stillede spørgsmål

Spørgsmål: Hvis du ser på definitioner af semantiske modeller og rapportelementer, er det kun nogle få filer, der er markeret som påkrævet. Hvad sker der, hvis jeg sletter dem?

Svar: Power BI Desktop opretter dem automatisk, når du gemmer som et projekt (PBIP).

Spørgsmål: Er Power BI Desktop opmærksom på de ændringer, jeg foretager i Power BI Project-filerne fra et eksternt værktøj eller program?

Svar: Nej. Alle ændringer af filerne kræver, at Power BI Desktop genstartes for at afspejle disse ændringer.

Spørgsmål: Hvis jeg konverterer en PBIX til en PBIP, kan jeg så konvertere den tilbage til PBIX?

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

Spørgsmål: Kan jeg konvertere PBIX til PBIP og omvendt programmatisk?

Svar: Nej. Du kan kun konvertere en PBIX til et PBIP og omvendt ved hjælp af Filen>Gem som i Power BI Desktop.

Spørgsmål: Kan jeg udrulle et Power BI Desktop-projekt til Azure Analysis Services (AAS) eller SQL Server Analysis Services (SSAS)?

Svar: Nej. Power BI Desktop-projektrapportdefinitioner understøttes ikke i AAS og SSAS. Og modeldefinitioner bruger en forbedret metadata, der er entydig for Power BI. I forbindelse med AAS- og SSAS-projekter skal du bruge Microsoft Visual Studio til oprettelse af modeller, Git og Azure DevOps-integration.

Spørgsmål: Hvorfor findes der ikke en *.pbip-fil, når jeg forbinder mit Fabric-arbejdsområde til Git? Hvordan kan jeg redigere min rapport og semantiske model i Power BI Desktop?

Svar: PBIP-filen er valgfri og fungerer blot som en genvej til rapportmappen. Du kan åbne både rapporten og den semantiske model til redigering i Power BI Desktop ved at åbne filen definition.pbir, der er placeret i rapportmappen.

Relateret indhold