Delen via

Power BI Desktop-projecten (PREVIEW)

Belangrijk

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

Aanbeveling

Zie de planning van de Power BI-implementatie voor hulp bij het plannen van een Power BI-ontwikkeling.

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 : PBIP-bestanden zijn opgemaakte tekstbestanden met semantische model- en rapportmetagegevens. Deze bestanden worden 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.

  • Transparantie van mapstructuur : afzonderlijke mappen voor het semantische model en rapport, waardoor krachtige maar eenvoudige taken mogelijk zijn, zoals het kopiëren van semantische modeltabellen tussen projecten of het hergebruiken van rapportpagina's. Een uitstekende keuze voor het maken en hergebruiken van ontwikkelsjablonen.

  • Broncodebeheer gereed - Tekstbestanden openen, ontworpen voor naadloze integratie met Git, waardoor versiegeschiedenis en teamsamenwerking mogelijk zijn. Zie Versiebeheer in Git voor meer informatie.

  • Ondersteuning voor continue integratie en continue levering (CI/CD): pas CI/CD-procedures toe op uw bestaande broncodebeheersystemen met behulp van PBIP-bestanden, waarbij kwaliteitspoorten worden opgenomen en implementatie in productieomgevingen wordt geautomatiseerd. Voor meer informatie over CI/CD in Fabric, zie Fabric CI/CD-werkstromen.

  • programmatische itemdefinities genereren en bewerken: u kunt programmatisch tekstbestanden voor itemdefinities genereren en wijzigen, waardoor batchbewerkingen mogelijk zijn, zoals het bijwerken van alle visuals van rapportpagina's of het toevoegen van een set metingen aan elke tabel. Voor semantische modellen kunt u de Tabular Object Model (TOM) clientbibliotheek gebruiken om de metagegevens van het semantische model te deserialiseren, programmatische wijzigingen aan te brengen en deze terug te serialiseren naar de bestanden.

Previewfuncties inschakelen

Opslaan als Een Power BI-project in Power BI Desktop is momenteel in preview en u moet het inschakelen in preview-functies.

Ga naar > en >> schakel het selectievakje naast de optie opslaan van Power BI Project (.pbip) in.

Opslaan als een project

Als u aan een nieuw project werkt of 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 als project opslaat, worden rapport- en semantische modelitems als mappen opgeslagen in Power BI Desktop, elk met tekstbestanden die het item definiëren:

Project/
├── AdventureWorks.Report/
├── AdventureWorks.SemanticModel/
├── .gitignore
└── AdventureWorks.pbip

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. Zie de map Project Semantic Model voor meer informatie over de bestanden en submappen en bestanden hier.

<projectnaam>. Rapport

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 die Git moet negeren voor Power BI Project-bestanden, zoals de cache.abf en localSettings.json.

Power BI Desktop maakt het .gitignore-bestand alleen als er nog geen bestaat in de gekozen opslagmap of bovenliggende Git-opslagplaats.

Standaardinhoud van .gitignore bij het opslaan als PBIP:

**/.pbi/localSettings.json
**/.pbi/cache.abf
<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.

Zie 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/
│   └── definition.pbism
├── .gitignore
└── AdventureWorks.pbip

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 selecteert, wordt er een flyout weergegeven die specifiek is voor Power BI Project. Met deze flyout 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.

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 gebruiken, zoals VS Code, opensource-communityhulpprogramma's zoals Tabular Editor of zelfs Kladblok. 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:

Implementeren in Fabric-werkruimte

Wanneer u met Power BI-projectbestanden werkt, kunt u uw inhoud implementeren in een Infrastructuurwerkruimte met behulp van de volgende publicatiemechanismen:

Notitie

Publiceren via Power BI Desktop publiceren maakt gebruik van een tijdelijk PBIX-bestand dat naar de service wordt gepubliceerd, vergelijkbaar met het opslaan en publiceren van een PBIX-bestand. In tegenstelling tot andere PBIP-implementatieopties die alleen metagegevens implementeren, implementeert deze publicatiemethode zowel de metagegevens als de lokale gegevenscache van het semantische model dat wordt bewerkt.

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 TMDL-metagegevens in de /definition map te bewerken met behulp van VS Code of een ander extern hulpprogramma.

Alle semantische modelmetagegevens zijn toegankelijk om te lezen. Schrijfbewerkingen worden echter volledig ondersteund, maar houd er rekening mee dat het wijzigen van de metagegevens buiten Power BI Desktop kan leiden tot onverwacht gedrag of in zeldzame gevallen tot inconsistenties binnen het model. Wees voorzichtig bij het aanbrengen van wijzigingen via externe hulpprogramma's.

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.

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

  • 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.

  • Semantische modellen, zoals samengestelde modellen of Direct Lake , kunnen objecten en eigenschappen bevatten die afkomstig zijn van andere modellen of gegevensbronnen. Bij het aanpassen van deze eigenschappen of het verwijderen van gesynchroniseerde objecten moet in Power BI de changedProperties eigenschap en de PBI_RemovedChildren aantekening worden ingesteld. Deze indicatoren markeren de wijzigingen als gebruikersaanpassingen, zodat ze behouden blijven tijdens de volgende schemasynchronisatie met de gegevensbron. Zie Herkomsttags voor semantische modellen van Power BI voor meer informatie.

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

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 json-schema's.

Overwegingen en beperkingen

  • 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.
  • Wanneer u een PBIP opslaat, moet u er rekening mee houden dat de maximale padlengte voor projectbestanden standaard is beperkt tot 260 tekens in Windows. Omdat PBIP-bestanden worden opgeslagen als submappen en bestanden, kunnen lange objectnamen, zoals tabelnamen, ertoe leiden dat de totale padlengte deze limiet overschrijdt, wat resulteert in fouten tijdens het opslaan. Als u dit risico wilt beperken, gebruikt u een kort mappad als de hoofdlocatie voor uw PBIP.
  • In Power BI Desktop kunt u niet rechtstreeks als PBIP opslaan in OneDrive en SharePoint. U kunt Opslaan als gebruiken om bestanden op te slaan in een lokaal gesynchroniseerde OneDrive-map; Dit kan echter leiden tot problemen met bestandssynchronisatie, wat kan leiden tot mislukte opslagbewerkingen in Power BI Desktop.
  • Wanneer u PBIP-bestanden buiten Power BI Desktop bewerkt, moeten ze worden opgeslagen met UTF-8 zonder bomcodering.
  • Taalkundig rapportschema (synoniemen voor rapportpagina's) 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-versie die is geoptimaliseerd voor Power BI Report Server.
  • Het is niet mogelijk om leden van de beveiligingsrol op rijniveau op rijniveau op te halen en in te stellen met behulp van de Fabric REST API
  • Het is niet mogelijk om incrementele vernieuwingspartities op te halen en in te stellen met behulp van fabric REST API. Er wordt echter één partitie geëxporteerd met behulp van de query die is gedefinieerd in het vernieuwingsbeleid.

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

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.

Vraag: Waarom is er geen *.pbip-bestand wanneer ik mijn Fabric-werkruimte aan Git koppel? Hoe kan ik mijn rapport en semantisch model bewerken in Power BI Desktop?

Antwoord: Het PBIP-bestand is optioneel en fungeert als een snelkoppeling naar de rapportmap. U kunt zowel het rapport als het semantische model openen voor bewerking in Power BI Desktop door het bestand definition.pbir in de rapportmap te openen.

Gerelateerde inhoud

  • Last updated on