Power BI Desktop-projecten (PREVIEW)

  • Artikel

Belangrijk

Power BI Desktop-projecten zijn momenteel beschikbaar als preview-versie.

Power BI Desktop introduceert een nieuwe manier om uw projecten te ontwerpen, samen te werken en op te slaan. Wanneer u uw werk opslaat als een Power BI-project (PBIP), worden rapport- en semantische modelitemdefinities opgeslagen als afzonderlijke tekstbestanden zonder opmaak in een eenvoudige, intuïtieve mapstructuur.

Het opslaan van uw werk als project heeft de volgende voordelen:

  • Ondersteuning voor teksteditor : itemdefinitiebestanden zijn tekstbestanden met JSON-indeling die semantische model- en rapportmetagegevens bevatten. Ze zijn openbaar gedocumenteerd en kunnen door mensen worden gelezen. Hoewel projectbestanden eenvoudige hulpprogramma's voor tekstbewerking ondersteunen, zoals Kladblok, is het beter om een code-editor zoals Visual Studio Code (VS Code) te gebruiken, die een uitgebreide bewerkingservaring biedt, waaronder intellisense, validatie en Git-integratie.

  • Programmatische itemdefinities genereren en bewerken: u kunt scripts maken met behulp van de populaire en gebruiksvriendelijke TMSL (Tabular Model Scripting Language) of uw eigen aangepaste toepassingen maken om wijzigingen aan te brengen in uw itemdefinities. Toepassingen kunnen worden gebaseerd op openbare documentatie van de itemdefinitieschema's en/of clientbibliotheken.

  • Broncodebeheer : semantische Power BI-model- en rapportitemdefinities kunnen worden opgeslagen in een broncodebeheersysteem, zoals Git. Met Git kunt u versiegeschiedenis bijhouden, revisies (diff) vergelijken en terugkeren naar eerdere versies. Broncodebeheer kan de samenwerking ook deblokkeren wanneer u Power BI Desktop gebruikt met behulp van vertrouwde samenwerkingsmechanismen voor het oplossen van conflicten (samenvoegen) en het controleren van wijzigingen (pull-aanvragen). Zie Versiebeheer in Git voor meer informatie.

  • Continue integratie en continue levering (CI/CD): u kunt systemen gebruiken waarin ontwikkelaars in uw organisatie een voorgestelde wijziging indienen in het CI/CD-systeem. Het systeem valideert vervolgens de wijziging met een reeks kwaliteitspoorten voordat de wijziging wordt toegepast op het productiesysteem. Deze kwaliteitspoorten kunnen codebeoordelingen bevatten door andere ontwikkelaars, geautomatiseerde tests en geautomatiseerde build om de integriteit van de wijzigingen te valideren. CI/CD-systemen worden doorgaans gebouwd op bestaande broncodebeheersystemen. Zie DevOps - Continue integratie en DevOps - Continue levering voor meer informatie.

Video

Zie Power BI Desktop-projecten en andere functies voor ontwikkelaarsmodus die worden geïntroduceerd in Microsoft Build 2023.

Previewfuncties inschakelen

Opslaan als een project in Power BI Desktop is momenteel in preview. Als u deze functie wilt gebruiken, hebt u een Premuim-licentie nodig en moet u deze inschakelen in preview-functies.

Als u dit wilt inschakelen, schakelt u in de preview-functies van Power BI Desktop-bestandsopties >>en -instellingen>>het selectievakje in voor het opslaan van Power BI Project (.pbip).

Opslaan als een project

Als u aan een nieuw project werkt of als u een bestaand Power BI Desktop-bestand (pbix) hebt geopend, kunt u uw werk opslaan als een Power BI-projectbestand (pbip):

Schermopname waarin het bestand opslaan als Power BI-project wordt weergegeven

Wanneer u opslaat als een project, worden rapport- en semantische modelitems in Power BI Desktop opgeslagen als mappen, elk met tekstbestanden die het item definiëren. U ziet het volgende:

Schermopname met Power BI Project-bestanden

Nadat u het project hebt opgeslagen, kunt u zien wanneer u aan een project werkt door naar de titelbalk te kijken:

Schermopname met de titel van Power BI Desktop bij het opslaan in project.

Als u op de titelbalk klikt, wordt er een flyout weergegeven die specifiek is voor Power BI Project. Hiermee kunt u de projectbestanden en de weergavenaaminstellingen voor het rapport en het semantische model vinden. U kunt de map ook openen in verkenner door op de paden te klikken.

Schermopname met flyout power BI Desktop-titel.

Laten we eens kijken wat u ziet in de hoofdmap van uw project:

<projectnaam>. SemanticModel

Een verzameling bestanden en mappen die een semantisch Power BI-model vertegenwoordigen. Het bevat enkele van de belangrijkste bestanden waaraan u waarschijnlijk werkt, zoals model.bim. Zie de map Project Semantic Model voor meer informatie over de bestanden en submappen en bestanden hier.

<projectnaam>. Verslag

Een verzameling bestanden en mappen die een Power BI-rapport vertegenwoordigen. Zie de projectrapportmap voor meer informatie over de bestanden en submappen en bestanden hier.

.gitIgnore

Hiermee geeft u opzettelijk niet-bijgehouden bestanden op die Git moet negeren. Power BI Desktop maakt het .gitignore-bestand in de hoofdmap bij het opslaan als dit nog niet bestaat.

Semantische model- en rapportsubmappen hebben elk standaard door Git genegeerde bestanden die zijn opgegeven in .gitIgnore:

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

Het PBIP-bestand bevat een aanwijzer naar een rapportmap. Als u een PBIP opent, wordt het doelrapport en het model voor ontwerpen geopend.

Raadpleeg het pbip-schemadocument voor meer informatie.

Een Power BI-project openen

U kunt Power BI Desktop openen vanuit de map Power BI Project door het PBIP-bestand of het PBIR-bestand in de rapportmap te openen. Beide opties openen het rapport voor bewerking en het semantische model, als er een relatieve verwijzing naar een semantisch model is.

U kunt meerdere rapporten en semantische modellen opslaan in dezelfde map. Een afzonderlijk PBIP-bestand voor elk rapport is niet vereist omdat u elk rapport rechtstreeks vanuit het PBIR-bestand in de rapportmap kunt openen.

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

Wijzigingen buiten Power BI Desktop

Wanneer u als project bent opgeslagen, hoeft u geen wijzigingen aan te brengen in uw semantische model en rapportdefinities in Power BI Desktop. U kunt andere hulpprogramma's zoals VS Code, opensource-communityhulpprogramma's zoals Tabular Editor of zelfs Kladblok gebruiken. Niet elk bestand of elke wijziging ondersteunt echter bewerken door externe, opensource-hulpprogramma's.

Wijzigingen in bestanden of eigenschappen buiten Power BI Desktop kunnen onverwachte fouten veroorzaken of zelfs voorkomen dat Power BI Desktop wordt geopend. In dergelijke gevallen moet u de problemen in de bestanden oplossen voordat u het project opnieuw probeert te openen in Power BI Desktop.

Indien mogelijk geeft Power BI Desktop het bestand en de locatie van de fout aan:

Schermopname van kan bestandsfout niet openen.

Schemadetails voor de volgende bestanden worden niet gedocumenteerd. Tijdens de preview worden wijzigingen in deze bestanden buiten Power BI Desktop niet ondersteund:

Modelcreatie

U kunt op twee manieren wijzigingen aanbrengen in de definitie van het semantische model met behulp van externe hulpprogramma's:

  • Door verbinding te maken met het Analysis Service-exemplaar (AS) van Power BI Desktop met externe hulpprogramma's.
  • Door JSON-metagegevens te bewerken in het bestand model.bim met behulp van VS Code of een ander extern hulpprogramma.

Niet elk modelobject ondersteunt schrijfbewerkingen. Het toepassen van wijzigingen buiten de ondersteunde wijzigingen kan onverwachte resultaten veroorzaken.

Objecten die schrijfbewerkingen ondersteunen:

Object Verbinding maken naar AS-exemplaar Bestandswijziging
Tabellen Nr. Ja
Kolommen Ja 1, 2 Ja
Berekende tabellen Ja Ja
Berekende kolommen Ja Ja
Hiërarchieën Ja Ja
Relaties Ja Ja
Metingen Ja Ja
Model-KPI's Ja Ja
Berekeningsgroepen Ja Ja
Perspectieven Ja Ja
Taalteksten Ja Ja
Beveiliging op rijniveau (RLS) Ja Ja
Beveiliging op objectniveau (OLS) Ja Ja
Aantekeningen Ja Ja
M-expressies Nee Ja 3, 4

Houd rekening met het volgende:

  • Wijzigingen in het openen van bestanden die buiten Power BI Desktop zijn aangebracht, moeten opnieuw worden opgestart om deze wijzigingen weer te geven in Power BI Desktop. Power BI Desktop is niet op de hoogte van wijzigingen in projectbestanden die door andere hulpprogramma's zijn aangebracht.

  • Power BI Desktop biedt geen ondersteuning voor tabellen met meerdere partities. Er wordt slechts één partitie voor elke tabel ondersteund. Het maken van tabellen met lege partities of meer dan één partitie resulteert in een fout bij het openen van het rapport.

  • Automatische datumtabellen die door Power BI Desktop zijn gemaakt, mogen niet worden gewijzigd met behulp van externe hulpprogramma's.

  • Wanneer u een model wijzigt dat Direct Query gebruikt om een semantisch Power BI-model of Analysis Services-model te verbinden, moet u de ChangeProperties- en PBI_RemovedChildren-verzameling bijwerken om gewijzigde of verwijderde eigenschappen op te nemen voor het gewijzigde object. Als ChangedProperties en/of PBI_RemovedChildren niet wordt bijgewerkt, kan Power BI Desktop wijzigingen overschrijven wanneer de query de volgende keer wordt bewerkt of wordt het model vernieuwd in Power BI Desktop.

  • 1 - Het gegevenstype van een kolom wijzigen wordt ondersteund. Het wijzigen van de naam van kolommen wordt echter niet ondersteund bij het maken van verbinding met het AS-exemplaar.

  • 2 - Als voor het semantische model de functie Automatische datum/tijd is ingeschakeld en u een nieuwe datum/tijd-kolom buiten Power BI Desktop maakt, wordt de lokale datumtabel niet automatisch gegenereerd.

  • 3 - Partition SourceType moet berekend, M, entiteit of CalculationGroup zijn. De partitiemodus moet Import, DirectQuery of Dual zijn.

  • 4 : expressiebewerkingen buiten Power BI Desktop in een project met unappliedChanges.json gaan verloren wanneer deze wijzigingen worden toegepast.

  • Het wijzigen van tabelquery-expressies buiten Power BI Desktop resulteert in het verwijderen van de tabelgegevens bij het opnieuw opstarten van Power BI Desktop.

JSON-bestandsschema's

De meeste projectbestanden bevatten metagegevens in JSON-indeling. Bijbehorende JSON-schema's kunnen worden gebruikt voor validatie en documentatie.

Met JSON-schema's kunt u het volgende doen:

  • Meer informatie over configureerbare eigenschappen.
  • Gebruik inline JSON-validatie die wordt geleverd door de code-editor.
  • Ontwerp verbeteren met syntaxismarkering, knopinfo en automatisch aanvullen.
  • Gebruik externe hulpprogramma's met kennis van ondersteunde eigenschappen binnen projectmetagegevens.

Gebruik VS Code om JSON-schema's toe te wijzen aan de bestanden die worden gemaakt. JSON-schema's voor projectbestanden worden geleverd in de Git-opslagplaats met Power BI Desktop-voorbeelden.

Overwegingen en beperkingen

  • Voor deze functie is een Premium-licentie vereist.
  • Power BI Desktop is niet op de hoogte van wijzigingen die zijn aangebracht met andere hulpprogramma's of toepassingen. Als u wijzigingen hebt aangebracht met behulp van externe hulpprogramma's, moet u Power BI Desktop opnieuw starten voordat deze wijzigingen worden weergegeven.
  • Vertrouwelijkheidslabels worden niet ondersteund bij Power BI-projecten.
  • De diagramweergave wordt genegeerd bij het bewerken van modellen in de service.
  • Bij het opslaan als Een Power BI-project is de maximale lengte van het pad naar projectbestanden 260 tekens.
  • In Power BI Desktop kunt u niet rechtstreeks als PBIP opslaan in OneDrive en SharePoint.
  • Wanneer u PBIP-bestanden buiten Power BI Desktop bewerkt, moeten ze worden opgeslagen met UTF-8 zonder bomcodering.
  • Het taalkundige rapportschema wordt niet ondersteund met Power BI-projecten.
  • Power BI Desktop maakt gebruik van CRLF als end-of-line. Als u problemen in uw verschillen wilt voorkomen, configureert u Git voor het afhandelen van regeleinden door autocrlf in te schakelen.
  • Power BI Projects wordt momenteel niet ondersteund in Microsoft Power BI Desktop (geoptimaliseerd voor Power BI Report Server).

Veelgestelde vragen

Vraag: Als ik semantische model- en rapportitemmapdefinities bekijk, worden slechts enkele bestanden gemarkeerd als vereist. Wat gebeurt er als ik ze verwijder?

Antwoord: Power BI Desktop maakt deze automatisch wanneer u opslaat als een project (PBIP).

Vraag: Is Power BI Desktop op de hoogte van wijzigingen die ik in de Power BI Project-bestanden aanbrengt vanuit een extern hulpprogramma of een externe toepassing?

Antwoord: Nee. Voor elke wijziging in de bestanden moet Power BI Desktop opnieuw worden gestart om deze wijzigingen weer te geven.

Vraag: Als ik een PBIX converteer naar een PBIP, kan ik deze weer converteren naar PBIX?

Antwoord: Ja. U kunt een PBIX opslaan als PBIP of een PBIP opslaan als PBIX.

Vraag: Kan ik PBIX programmatisch converteren naar PBIP en vice versa?

Antwoord: Nee. U kunt een PBIX alleen converteren naar een PBIP en vice versa met behulp van het bestand>opslaan van Power BI Desktop als.

Vraag: Kan ik een Power BI Desktop-project implementeren in Azure Analysis Services (AAS) of SQL Server Analysis Services (SSAS)?

Antwoord: Nee. Power BI Desktop-projectrapportdefinities worden niet ondersteund in AAS en SSAS. En modeldefinities maken gebruik van een verbeterde metagegevens die uniek zijn voor Power BI. Voor AAS- en SSAS-projecten gebruikt u Microsoft Visual Studio voor modelcreatie, Git en Azure DevOps-integratie.

Gerelateerde inhoud