🏷️ Naming Conventions

Deze pagina beschrijft de standaard naamgevingsconventies voor alle Power Platform componenten binnen oplossingen.

Deze richtlijnen gelden voor alle componenten binnen Dataverse, Power Apps, Power Automate en gerelateerde Power Platform-oplossingen.

Consistent naming improves maintainability, discoverability and deployment reliability.

🎯 Doel

Het doel van deze pagina is om:

uniforme naamgeving toe te passen
componenten eenvoudig herkenbaar te maken
onderhoudbaarheid te verhogen
hergebruik te stimuleren
deployment- en integratierisico's te verminderen

Consistente naamgeving ondersteunt:

leesbaarheid
onderhoudbaarheid
hergebruik
voorspelbare deployments
samenwerking binnen teams
Application Lifecycle Management (ALM)

📋 Algemene Richtlijnen

Doe

✅ Gebruik consistente naamgeving binnen het gehele platform

✅ Gebruik beschrijvende namen

✅ Gebruik duidelijke Engelse termen voor technische namen

✅ Gebruik dezelfde structuur binnen alle oplossingen

✅ Gebruik één publisher per oplossingsdomein

✅ Gebruik lowercase voor technische namen

Vermijd

🚫 Omgevingsnamen (DEV / TST / ACC / PRD)

🚫 Onduidelijke afkortingen

🚫 Generieke namen zoals Test, New of Temp

🚫 Inconsistente naamgeving

🚫 Meerdere naamgevingsstandaarden binnen één oplossing

🏢 Publishers

Iedere Power Platform oplossing maakt gebruik van een Publisher.

De Publisher bepaalt:

Prefix van componenten
Schema Names
Solution Names
Ownership van maatwerk
Herleidbaarheid van componenten

Richtlijnen

Gebruik altijd een eigen Publisher
Gebruik nooit de standaard Publisher voor maatwerk
Gebruik een consistente publisher prefix
Gebruik dezelfde Publisher binnen één oplossingsdomein

Voorbeelden

Publisher	Prefix
BRENKE	unc
Contoso	cts
Fabrikam	fab

Vermijd

🚫 Default Publisher

🚫 Verschillende prefixes binnen dezelfde oplossing

🚫 Publisherwissels tijdens de lifecycle

📦 Solutions

Display Name

Formaat

<Customer> | <Scope>

Componenttype-structuur

BRENKE | 01 Configuration
BRENKE | 02 Core
BRENKE | 03 Programming UI
BRENKE | 04 Programming Logic
BRENKE | 05 Automation

Richtlijnen

Begin met de klant- of organisatienaam
Gebruik nummering voor deploymentvolgorde
Gebruik vaste solution scopes

Doel

Ondersteunen van gecontroleerde deployments en dependency management.

Technical Name

Formaat

<publisher>_<scope>

Voorbeelden

brenke_configuration
brenke_core
brenke_programming_ui
brenke_programming_logic
brenke_automation

Richtlijnen

Lowercase
Geen spaties
Underscore als scheiding
Publisher prefix verplicht

🧱 Tables

Display Name

Formaat

<Name>

Voorbeelden

Account
Order
Subscription
Project

Richtlijnen

Enkelvoud
Begrijpelijk voor eindgebruikers
Vermijd technische termen

Schema Name

Formaat

<publisher>_<name>

Voorbeelden

brenke_subscription
brenke_project
brenke_registration

Richtlijnen

Prefix verplicht
Beschrijvend
Technisch compact

🔗 Relationships

Relaties bepalen hoe gegevens met elkaar verbonden zijn.

Formaat

<publisher>_<bron>_<doel>

Voorbeelden

brenke_account_contact
brenke_contact_account
brenke_account_opportunity

Lookup Columns

Formaat

<publisher>_<naam>Id

Voorbeelden

brenke_primaryContactId
brenke_parentAccountId
brenke_customerId

Vermijd

brenke_contactId

(Te generiek)

🔤 Columns

Display Name

Richtlijnen

Beschrijvend
Begrijpelijk
Geen technische afkortingen

Voorbeelden

Email Address
Phone Number
Primary Contact
Order Date

Schema Name

Formaat

<publisher>_<functionalName>

Richtlijnen

Prefix verplicht
lowerCamelCase na prefix
Geen spaties

Tekstvelden

Voorbeelden

brenke_name
brenke_firstName
brenke_lastName
brenke_description

Boolean

Gebruik:

is
has

Voorbeelden

brenke_isActive
brenke_hasContract
brenke_isCustomer

Choice

Voorbeelden

brenke_status
brenke_category
brenke_type

Numeriek

Voorbeelden

brenke_amount
brenke_quantity
brenke_creditLimit

Datum

Gebruik:

Date
DateTime

Voorbeelden

brenke_birthDate
brenke_startDateTime

Lookup

Gebruik altijd:

Id

Voorbeelden

brenke_customerId
brenke_accountManagerId
brenke_primaryContactId

Percentage

Gebruik:

Percentage
Rate

Voorbeelden

brenke_discountPercentage
brenke_interestRate

Integratievelden

Gebruik:

Id
Key
Reference

Voorbeelden

brenke_externalId
brenke_integrationKey
brenke_erpReference

📱 Forms, Tabs & Sections

Forms

Richtlijnen

Gebruik een beschrijvende naam
Maak duidelijk voor welke gebruikersgroep het formulier bedoeld is
Vermijd Main Form 1 of Custom Form

Voorbeelden

Account - Main
Account - Service
Case - Service Desk
Contract - Backoffice

Tabs

Formaat

tab_<tabname>

Voorbeelden

tab_general
tab_details

Sections

Formaat

tab_<tabname>_sec_<sectionname>

Voorbeelden

tab_general_sec_general
tab_general_sec_contacts
tab_details_sec_general

🗂️ Web Resources

JavaScript

Formaat

<publisher>_scripts/<entity>.js

Of:

<publisher>_scripts/<entity>/<entity>.js

Voorbeelden

brenke_scripts/account.js
brenke_scripts/contact.js
brenke_scripts/account/account.js

Richtlijnen

Eén script per tabel als standaard
Gebruik folders bij grotere oplossingen
Gebruik lowercase

Afbeeldingen

Formaat

<publisher>_images/<entity>/<image>

Voorbeelden

brenke_images/account/chamberofcommerce.png
brenke_images/icons/sync.svg

🔄 Cloud Flows

Structuur

<Applicatie> - <Entiteit> - <Trigger> - <Actie>

Voorbeelden

Sales - Opportunity - CUD - Create Notification
Service - Case - CUD - Send Status Update
Account - CUD - Validate IBAN

Richtlijnen

Beschrijvend
Compact
Werkwoord gebruiken voor acties

👉 Zie ook de pagina Cloud Flow Guidelines.

🔌 Connection References

Display Name

Formaat

<Connector> - <Context> - <Type>

Voorbeelden

Dataverse - BRENKE - Service Principal
SharePoint - BRENKE - Service Account

Technical Name

Formaat

<publisher>_<connector>_<type>

Voorbeelden

brenke_dataverse_sp
brenke_sharepoint_sa

⚙️ Environment Variables

Display Name

Voorbeelden

API Endpoint
SharePoint Site URL
Tenant ID

Technical Name

Formaat

<publisher>_<name>_<type>

Voorbeelden

brenke_api_endpoint
brenke_sharepoint_url
brenke_tenant_id

Richtlijnen

Lowercase
Underscores gebruiken
Publisher prefix verplicht

🔢 Choices

Display Name

Voorbeelden

Status
Type
Category

Technical Name

Formaat

<publisher>_<name>

Voorbeelden

brenke_status
brenke_category
brenke_type

🔌 Custom APIs

Technical Name

Formaat

<publisher>_<verb><Noun>

Voorbeelden

brenke_validateIban
brenke_createProject
brenke_generateContract

Richtlijnen

Gebruik een werkwoord
Beschrijf één verantwoordelijkheid
Gebruik duidelijke Engelse namen

✅ Best Practices

Doe

✔ Gebruik altijd een eigen Publisher

✔ Gebruik consistente prefixes

✔ Gebruik beschrijvende namen

✔ Gebruik vaste structuren per componenttype

✔ Documenteer uitzonderingen

✔ Gebruik één naamgevingsstandaard binnen de gehele oplossing

Vermijd

✘ Gebruik van de standaard Publisher

✘ Omgevingsnamen in technische namen

✘ Afkortingen zonder betekenis

✘ Inconsistente naamgeving

✘ Dubbele of verwarrende namen

📌 Samenvatting

Consistente naamgeving ondersteunt:

leesbaarheid
onderhoudbaarheid
governance
hergebruik
deployment automation
traceability

Belangrijkste uitgangspunten:

Gebruik altijd een Publisher
Gebruik consistente prefixes
Gebruik beschrijvende namen
Gebruik vaste structuren per componenttype
Vermijd omgeving-specifieke namen

👉 Naming Conventions vormen een essentieel onderdeel van professionele Power Platform ontwikkeling en ondersteunen schaalbare, onderhoudbare en beheersbare oplossingen.