Source Control Strategy beschrijft hoe wijzigingen aan Power Platform-oplossingen worden beheerd, vastgelegd en gecontroleerd gedurende de volledige lifecycle.

Not everything in Power Platform is code, but everything should be managed.

---

NOTE

Binnen Power Platform maken we onderscheid tussen twee ontwikkelvormen:

• Dataverse Development
• Code Development

Deze twee ontwikkelvormen vereisen een andere aanpak voor versiebeheer, samenwerking en deployments.

---

🎯 Doel

Het doel van Source Control Strategy is om:

• wijzigingen beheersbaar te maken
• samenwerking tussen consultants en developers te ondersteunen
• deployments voorspelbaar te maken
• traceability te waarborgen
• kwaliteit te verhogen
• ongecontroleerde wijzigingen te voorkomen

---

🧠 Twee vormen van ontwikkeling

🏗️ Dataverse Development

Configuratie die rechtstreeks binnen Dataverse wordt ontwikkeld.

Voorbeelden

• Tables
• Columns
• Forms
• Views
• Model-Driven Apps
• Choices
• Business Rules
• Environment Variables
• Security Roles
• Cloud Flows

Kenmerken

• Ontwikkeling vindt plaats in een Dataverse omgeving
• Geen branches mogelijk
• Geen pull requests mogelijk
• Wijzigingen worden opgeslagen binnen Solutions
• Samenwerking gebeurt binnen dezelfde ontwikkelomgeving

---

💻 Code Development

Ontwikkeling van componenten buiten Dataverse.

Voorbeelden

• Plugins
• Custom API's
• JavaScript
• PCF Controls
• Deployment Scripts
• PowerShell Scripts

Kenmerken

• Ontwikkeling gebeurt lokaal of in Visual Studio
• Broncode wordt opgeslagen in Git
• Ondersteunt Branching Strategies
• Ondersteunt Pull Requests
• Ondersteunt Code Reviews

---

🏗️ Dataverse Source Control

Voor Dataverse componenten vormt de Solution de belangrijkste beheereenheid.

Richtlijnen

✅ Werk altijd binnen een Solution

✅ Gebruik nooit de Default Solution

✅ Gebruik een duidelijke Solutionstructuur

✅ Gebruik Publishers en Prefixes

✅ Koppel wijzigingen aan Azure DevOps werkitems

✅ Synchroniseer regelmatig met Source Control

Let op

Omdat Dataverse geen ondersteuning biedt voor branches, werken meerdere consultants vaak binnen dezelfde ontwikkelomgeving.

Daarom zijn goede afspraken noodzakelijk over:

• eigenaarschap
• planning
• componentgebruik
• releasecoördinatie

---

📦 Source Control voor Solutions

Solutions worden periodiek geëxporteerd naar source control.

Doel

• Historie vastleggen
• Wijzigingen inzichtelijk maken
• Back-up van configuratie
• Ondersteunen van deployments

Versiebeheer

Wijzigingen worden gekoppeld aan:

• User Stories
• Tasks
• Bugs
• Technical Debt Items

---

💻 Code Development met Git

Voor code-artifacten wordt Git gebruikt als bron van waarheid.

Componenten

• Plugins
• JavaScript
• Custom API's
• PCF Controls
• Scripts

Richtlijnen

✅ Alle code staat in Git

✅ Iedere wijziging wordt geversioneerd

✅ Iedere wijziging is herleidbaar

✅ Code Reviews zijn verplicht

---

🌿 Branching Strategy

Branching wordt uitsluitend toegepast voor code-artifacten die buiten Dataverse worden ontwikkeld.

Standaard Branch Structuur

main
│
├─ develop
│
├─ feature/12345-new-validation
├─ feature/12346-customer-sync
│
├─ release/2026.07
│
└─ hotfix/12347-production-fix

Toepassing

---

🔀 Pull Requests

Pull Requests zijn alleen van toepassing op code-artifacten.

Doel

• Kwaliteitscontrole
• Kennisdeling
• Traceability

Richtlijnen

✅ Koppelen aan werkitem

✅ Review uitvoeren

✅ Build succesvol

✅ Conflicten oplossen

---

✅ Code Reviews

Code Reviews worden uitgevoerd voor:

• Plugins
• JavaScript
• Custom API's
• PCF Controls
• Scripts

Controlepunten

• Functionaliteit correct
• Naming Conventions gevolgd
• Geen technische risico's
• Onderhoudbaarheid voldoende
• Geen duplicatie

---

🔗 Relatie met Azure DevOps

Alle wijzigingen moeten gekoppeld zijn aan een werkitem.

Voorbeelden

• User Story
• Task
• Bug
• Technical Debt Item

Richtlijnen

✅ Iedere wijziging herleidbaar

✅ Iedere deployment herleidbaar

✅ Volledige traceability

---

⚠️ Veelvoorkomende Valkuilen

Vermijd

🚫 Ontwikkelen in de Default Solution

🚫 Wijzigingen zonder werkitem

🚫 Handmatige wijzigingen in productie

🚫 Geen afspraken over eigenaarschap

🚫 Geen versioning van code

🚫 Direct werken in Main

🚫 Pull Requests overslaan

---

✅ Best Practices

Voor Dataverse

✔ Werk altijd in Solutions

✔ Gebruik een vaste Solutionstructuur

✔ Gebruik consistente Publishers

✔ Beperk gelijktijdige wijzigingen aan dezelfde componenten

✔ Leg eigenaarschap vast

Voor Code

✔ Gebruik Git

✔ Gebruik feature branches

✔ Gebruik Pull Requests

✔ Voer Code Reviews uit

✔ Houd branches klein

---

📌 Samenvatting

Power Platform kent twee vormen van ontwikkeling:

🏗️ Dataverse Development

• Configuratie binnen Dataverse
• Geen branches
• Solution-gebaseerd beheer
• Wijzigingen beheerd via Solutions

💻 Code Development

• Ontwikkeling in Visual Studio of VS Code
• Git als bron van waarheid
• Branching Strategy
• Pull Requests
• Code Reviews

👉 Source Control binnen Power Platform draait niet alleen om Git, maar vooral om het gecontroleerd beheren van zowel Dataverse-configuratie als maatwerkcode gedurende de volledige lifecycle.