Choices (voorheen Option Sets) worden gebruikt om gebruikers te laten kiezen uit een vooraf gedefinieerde lijst met waarden.

Door gebruik te maken van Choices wordt invoer gestandaardiseerd, verbetert de datakwaliteit en wordt de werking van businesslogica, rapportages en integraties voorspelbaar.

Choices vormen een belangrijk onderdeel van een goed ontworpen Dataverse datamodel.

Consistent data starts with controlled data entry.

---

🎯 Doel

Deze richtlijnen ondersteunen teams bij:

• het standaardiseren van gegevensinvoer
• het verbeteren van datakwaliteit
• het stimuleren van hergebruik
• het ondersteunen van rapportages en integraties
• het voorkomen van dubbele definities
• het beheersbaar houden van wijzigingen

---

🧠 Wat is een Choice?

Een Choice is een kolomtype waarbij gebruikers kunnen kiezen uit een vooraf gedefinieerde lijst met waarden.

Voorbeelden

Status
- Actief
- Inactief

Type
- Intern
- Extern

Categorie
- Standard
- Premium
- Custom

Voordelen

✅ Consistente gegevensinvoer

✅ Ondersteuning van businesslogica

✅ Betere rapportages

✅ Minder invoerfouten

✅ Herbruikbare definities

---

🌍 Lokale versus Globale Choices

Binnen Dataverse bestaan twee typen Choices.

---

Lokale Choice

Een lokale Choice behoort uitsluitend toe aan één kolom.

Kenmerken

• Alleen beschikbaar binnen één tabel
• Alleen bruikbaar voor één specifieke situatie
• Wordt samen met de kolom beheerd

Wanneer gebruiken?

✅ Waarden zijn uniek voor één tabel

✅ Hergebruik is niet nodig

Voorbeeld

Project
    ↓
Projecttype

- Intern
- Extern
- Innovatie

---

Globale Choice

Een globale Choice kan door meerdere kolommen en tabellen worden gebruikt.

Kenmerken

• Centraal beheerd
• Herbruikbaar
• Consistent over meerdere oplossingen

Wanneer gebruiken?

✅ Dezelfde waarden worden op meerdere plekken gebruikt

✅ Rapportages moeten dezelfde definities gebruiken

✅ Consistente businesslogica is gewenst

Voorbeelden

Status

- Actief
- Inactief

Prioriteit

- Laag
- Normaal
- Hoog

Richtlijn

Gebruik een globale Choice zodra dezelfde definitie op meerdere plaatsen kan worden gebruikt.

---

✅ Keuze: Lokaal of Globaal?

Richtlijn

Bij twijfel heeft een globale Choice meestal de voorkeur.

---

🏷️ Naamgeving

Display Name

Gebruik een functionele en begrijpelijke naam.

Voorbeelden

Status
Category
Type
Priority

Richtlijnen

✅ Beschrijvend

✅ Begrijpelijk voor eindgebruikers

✅ Enkelvoud

✅ Functioneel

---

Schema Name

Formaat

<publisher>_<name>

Voorbeelden

unc_status
unc_category
unc_type
unc_priority

Richtlijnen

✅ Publisher prefix verplicht

✅ Lowercase

✅ Underscores gebruiken

✅ Geen spaties

---

🧩 Waarden (Options)

Iedere Choice bestaat uit één of meerdere waarden.

Richtlijnen

✅ Gebruik duidelijke labels

✅ Vermijd afkortingen

✅ Gebruik consistente terminologie

✅ Gebruik dezelfde taal binnen de gehele oplossing

✅ Houd waarden stabiel

---

Voorbeeld

Belangrijk

De numerieke Value wordt technisch gebruikt door:

• Dataverse
• Cloud Flows
• JavaScript
• Plug-ins
• Integraties

Wijzig deze waarden nooit handmatig nadat ze in gebruik zijn genomen.

---

🔄 Lifecycle van Choices

Choices ontwikkelen zich vaak gedurende de levensduur van een oplossing.

Toegestaan

✅ Nieuwe opties toevoegen

✅ Labels aanpassen wanneer noodzakelijk

✅ Opties deactiveren

Vermijd

🚫 Verwijderen van gebruikte opties

🚫 Hergebruik van bestaande waarden voor een andere betekenis

🚫 Wijzigen van option values

---

⚠️ Impact op Business Logic

Choices worden vaak gebruikt binnen:

• Business Rules
• Cloud Flows
• JavaScript
• Plug-ins
• Custom API's
• Integraties

Hierdoor kunnen wijzigingen grote impact hebben.

Voorbeeld

Status = Actief

wordt mogelijk gebruikt in:

• Flows
• Dashboards
• Rapportages
• Integraties
• Validaties

Richtlijn

Analyseer altijd de impact voordat een Choice wordt gewijzigd.

---

🌐 Choices en Integraties

Choices worden in integraties meestal opgeslagen als een numerieke waarde.

Voorbeeld

Label: Active
Value: 420550000

Richtlijnen

✅ Houd option values stabiel

✅ Documenteer mappings naar externe systemen

✅ Gebruik consistente keuzes over meerdere oplossingen

Vermijd

🚫 Hardcoded waarden in integraties

🚫 Onbekende betekenis van option values

---

📊 Datakwaliteit

Choices dragen direct bij aan datakwaliteit.

Voordelen

✅ Minder vrije tekstvelden

✅ Minder spelfouten

✅ Consistente rapportages

✅ Betere zoekresultaten

✅ Eenvoudigere validaties

Richtlijn

Gebruik waar mogelijk een Choice in plaats van vrije invoer.

---

🔍 Checklist

Ontwerp

• ☐ Is een Choice noodzakelijk?
• ☐ Is vrije tekst echt nodig?
• ☐ Bestaat er al een globale Choice?
• ☐ Is hergebruik mogelijk?

Naamgeving

• ☐ Display Name gecontroleerd
• ☐ Schema Name gecontroleerd
• ☐ Publisher Prefix toegepast

Waarden

• ☐ Duidelijke labels gebruikt
• ☐ Consistente terminologie toegepast
• ☐ Impact op integraties beoordeeld
• ☐ Toekomstige uitbreidbaarheid beoordeeld

---

✅ Best Practices

Doe

✔ Gebruik globale Choices voor herbruikbare definities

✔ Gebruik duidelijke labels

✔ Houd waarden stabiel

✔ Documenteer de betekenis van keuzes

✔ Analyseer de impact van wijzigingen

✔ Gebruik Choices in plaats van vrije invoer waar mogelijk

---

Vermijd

✘ Duplicatie van vergelijkbare Choices

✘ Hardcoded option values in code

✘ Verwijderen van gebruikte opties

✘ Wijzigen van bestaande option values

✘ Onduidelijke afkortingen

✘ Vrije tekst wanneer een Choice mogelijk is

---

🔗 Relatie met andere onderwerpen

---

📌 Samenvatting

Choices helpen bij:

• consistente gegevensinvoer
• betere datakwaliteit
• herbruikbare definities
• voorspelbare businesslogica
• betrouwbare rapportages
• stabiele integraties

👉 Gebruik lokale Choices voor specifieke situaties en globale Choices zodra hergebruik, rapportages of consistente definities belangrijk worden binnen de oplossing.