👨‍💻 Developer Guidelines

← Terug naar Develop

Developer Guidelines (richtlijnen) beschrijven de algemene ontwikkelprincipes en werkwijzen die worden toegepast bij het realiseren van Power Platform-oplossingen.

Deze richtlijnen vormen de basis voor alle ontwikkelactiviteiten, ongeacht de gebruikte techniek, component of implementatievorm.

Build once. Maintain for years.

🎯 Doel

Developer Guidelines helpen teams bij:

het maken van consistente technische keuzes
het toepassen van Power Platform best practices
het beperken van onnodig maatwerk
het verhogen van onderhoudbaarheid
het stimuleren van hergebruik
het realiseren van schaalbare oplossingen

De richtlijnen ondersteunen:

consistente implementaties
onderhoudbare oplossingen
schaalbare architecturen
voorspelbare ontwikkelresultaten
beheersbare Application Lifecycle Management (ALM)

🧠 Wat zijn Developer Guidelines?

Developer Guidelines beschrijven de algemene uitgangspunten die gelden voor alle ontwikkelactiviteiten binnen Power Platform.

Waar specifieke richtlijnen (zoals JavaScript, Cloud Flows of Plugins) beschrijven hoe een component wordt ontwikkeld, beschrijven Developer Guidelines welke principes en keuzes daarbij gehanteerd worden.

Deze pagina vormt daarmee de basis voor alle onderliggende ontwikkelrichtlijnen.

🏛️ Algemene Ontwikkelprincipes

Binnen Power Platform worden de volgende uitgangspunten gehanteerd.

✅ Standard First

Gebruik standaard Power Platform-functionaliteit waar mogelijk.

Richtlijnen

Gebruik standaardcomponenten voordat maatwerk wordt overwogen
Gebruik bestaande platformmogelijkheden optimaal
Beperk custom development tot situaties waarin standaardfunctionaliteit onvoldoende is

Voordelen

Minder onderhoud
Lagere complexiteit
Snellere implementatie
Betere upgradebaarheid

Vermijd

🚫 Maatwerk terwijl standaardfunctionaliteit beschikbaar is

✅ Configuration Before Code

Configuratie heeft altijd de voorkeur boven maatwerkcode.

Voorkeursvolgorde

Configuratie
    ↓
Business Rules
    ↓
Cloud Flows
    ↓
JavaScript
    ↓
Plugins / Custom API's

Doel

Het beperken van complexiteit en onderhoudslast.

Vermijd

🚫 Direct maatwerk ontwikkelen zonder alternatieven te onderzoeken

✅ Simplicity Before Complexity

Oplossingen moeten zo eenvoudig mogelijk blijven.

Richtlijnen

Houd ontwerpen begrijpelijk
Voorkom over-engineering
Implementeer alleen wat daadwerkelijk nodig is
Minimaliseer afhankelijkheden

Vermijd

🚫 Complexe oplossingen voor eenvoudige problemen

🚫 Techniek zonder duidelijke businesswaarde

✅ Reuse Before Rebuild

Hergebruik bestaande componenten waar mogelijk.

Richtlijnen

Gebruik bestaande libraries
Gebruik bestaande integratiecomponenten
Gebruik centrale oplossingen en standaarden
Onderzoek bestaande functionaliteit voordat nieuwe componenten worden ontwikkeld

Voorbeelden

Unica Core Library
Shared Components
Herbruikbare Cloud Flows
Generieke Plug-ins

Vermijd

🚫 Dubbele implementaties

🚫 Functionaliteit opnieuw bouwen zonder noodzaak

🏗️ Scheiding van Verantwoordelijkheden

Binnen Power Platform wordt een duidelijke scheiding aangebracht tussen verschillende lagen.

Laag	Voorbeelden
Data	Tables, Columns, Relationships
Configuration	Apps, Forms, Views, Choices, Environment Variables
User Experience	JavaScript, Form Scripting, Ribbon Customization
Business Logic	Business Rules, JavaScript, Plugins, Custom API's
Automation	Cloud Flows, Approval Flows, Scheduled Processing
Integration	Connectors, Custom Connectors, API's

Richtlijnen

Houd verantwoordelijkheden gescheiden
Plaats componenten in de juiste Solution
Voorkom overlap tussen lagen
Maak eigenaarschap expliciet

📦 Solution First Development

Ontwikkeling vindt altijd plaats binnen Solutions.

Richtlijnen

✅ Werk altijd binnen een Solution

✅ Gebruik een Publisher

✅ Gebruik de afgesproken Solutionstructuur

✅ Beheer afhankelijkheden actief

Vermijd

🚫 Ontwikkelen in de Default Solution

🚫 Componenten zonder Publisher Prefix

🚫 Onduidelijke Solutionindeling

🏷️ Consistentie & Uniformiteit

Consistentie is essentieel voor samenwerking en onderhoudbaarheid.

Richtlijnen

Volg Naming Conventions
Gebruik standaardsjablonen
Gebruik consistente componentstructuren
Gebruik uniforme implementatiepatronen

Voorbeelden

Naming Conventions
Solution Development
Environment Variables
Cloud Flow Guidelines

Doel

Oplossingen begrijpelijk houden voor andere consultants en developers.

⚙️ Technologiekeuze

Voor iedere functionele behoefte wordt bewust gekozen welke techniek wordt toegepast.

Voorkeursvolgorde

Situatie	Voorkeur
Eenvoudige validatie	Business Rule
Procesautomatisering	Cloud Flow
UI-interactie	JavaScript
Server-side logica	Plugin
Externe aanroep	Custom API

Richtlijnen

Kies de eenvoudigste techniek die voldoet
Gebruik niet meerdere technieken voor dezelfde logica
Zorg voor duidelijke verantwoordelijkheden

🧩 Herbruikbaarheid

Herbruikbaarheid voorkomt duplicatie en versnelt ontwikkeling.

Richtlijnen

Gebruik generieke componenten
Gebruik centrale libraries
Maak componenten onafhankelijk waar mogelijk
Documenteer herbruikbare oplossingen

Voorbeelden

Unica Core Library
Shared Components
Herbruikbare Custom API's
Generieke Flows

🔧 Onderhoudbaarheid

Oplossingen moeten eenvoudig kunnen worden aangepast en uitgebreid.

Richtlijnen

Schrijf leesbare code
Documenteer complexe logica
Gebruik logging waar relevant
Beperk afhankelijkheden
Houd componenten klein en beheersbaar

Belangrijke vraag

Kan een andere consultant deze oplossing eenvoudig begrijpen en onderhouden?

🔄 Samenwerking & Werkwijze

Ontwikkeling gebeurt binnen projectteams en volgens afgesproken ALM-processen.

Richtlijnen

Werk via Azure DevOps
Gebruik Source Control
Volg de Branching Strategy
Documenteer belangrijke keuzes
Pas Code Reviews toe
Werk volgens de Definition of Ready en Definition of Done

Doel

Kwaliteit en voorspelbaarheid verhogen.

📈 Technical Debt Awareness

Technical Debt ontstaat vaak tijdens ontwikkeling.

Richtlijnen

Registreer tijdelijke oplossingen
Maak technische risico's zichtbaar
Plan refactoring waar nodig
Accepteer Technical Debt alleen bewust

Vermijd

🚫 Tijdelijke oplossingen permanent laten bestaan

🚫 Technical Debt verbergen

🔗 Relatie met andere onderwerpen

Developer Guidelines beschrijven de algemene ontwikkelprincipes die gelden voor alle Power Platform componenten.

De onderstaande onderwerpen werken deze principes verder uit voor specifieke onderdelen van het platform.

Onderwerp	Relatie
Solution Development	Beschrijft hoe oplossingen worden gestructureerd, opgesplitst en beheerd.
Naming Conventions	Beschrijft de standaarden voor consistente naamgeving van componenten.
Entity Guidelines	Werkt de richtlijnen uit voor datamodellering en tabelontwerp.
Environment Variables	Beschrijft het beheer van omgevingsspecifieke configuratie.
Model-Driven Apps	Richtlijnen voor het ontwerpen en configureren van gebruikersapplicaties.
Business Rules	Richtlijnen voor configuratiegedreven businesslogica.
JavaScript	Richtlijnen voor client-side ontwikkeling en gebruikersinteractie.
Cloud Flows	Richtlijnen voor procesautomatisering met Power Automate.
Plugins & Custom API's	Richtlijnen voor server-side maatwerkontwikkeling.
Integrations	Richtlijnen voor koppelingen met externe systemen en diensten.
Reusable Components	Richtlijnen voor hergebruik en standaardisatie van componenten.

👉 Developer Guidelines vormen het fundament waarop alle specifieke ontwikkelrichtlijnen binnen Power Platform zijn gebaseerd.

✅ Best Practices

Doe

✔ Gebruik standaardfunctionaliteit waar mogelijk

✔ Kies configuratie boven maatwerkcode

✔ Houd oplossingen eenvoudig

✔ Pas hergebruik toe

✔ Werk altijd binnen Solutions

✔ Volg Naming Conventions

✔ Gebruik Source Control en Branching

✔ Documenteer uitzonderingen

Vermijd

✘ Ontwikkelen in de Default Solution

✘ Onnodig maatwerk

✘ Dubbele implementaties

✘ Over-engineering

✘ Hardcoded configuratie

✘ Onduidelijke eigenaarschap

✘ Inconsistente naamgeving

📌 Samenvatting

Developer Guidelines vormen de basis voor alle ontwikkelactiviteiten binnen Power Platform.

De belangrijkste uitgangspunten zijn:

standaard vóór maatwerk
configuratie vóór code
eenvoud vóór complexiteit
hergebruik vóór duplicatie
onderhoudbaarheid boven korte termijn oplossingen

👉 Door deze richtlijnen consequent toe te passen ontstaan Power Platform-oplossingen die schaalbaar, onderhoudbaar, begrijpelijk en toekomstbestendig zijn.