๐Ÿ”ข Choices - Option Sets

Globale en lokale choices, standaardisatie en hergebruik.

โ† Terug naar Develop

Introduction

Deze pagina beschrijft richtlijnen voor het ontwerpen en beheren van choices (option sets) binnen Dataverse.

Choices worden gebruikt om een vooraf gedefinieerde lijst met waarden aan te bieden voor een veld.

๐Ÿ‘‰ Choices zorgen voor consistente invoer en ondersteunen datakwaliteit binnen het platform.


๐Ÿ“Œ Doel

Het doel van deze richtlijnen is:

  • consistente waarde-invoer

  • betere datakwaliteit

  • voorspelbare werking van business logic

  • herbruikbare configuratie binnen solutions


๐Ÿงพ 1. Wat is een Choice?

Een choice (option set) is een veldtype waarbij gebruikers kunnen kiezen uit vaste waarden.

Voorbeelden:

  • Status (Active / Inactive)

  • Type (Internal / External)

  • Categorie (Standard / Premium / Custom)

๐Ÿ‘‰ De waarden worden centraal beheerd en zijn niet vrij invoerbaar. 1


๐Ÿ—‚๏ธ 2. Lokale vs globale choices

Binnen Dataverse zijn er twee typen:

2.1 Lokale choice

  • gekoppeld aan รฉรฉn veld

  • alleen bruikbaar binnen รฉรฉn entiteit

๐Ÿ‘‰ Gebruik bij specifieke, entiteit-afhankelijke waarden


2.2 Globale choice (Global Option Set)

  • herbruikbaar over meerdere velden en entiteiten

  • centraal beheerd

๐Ÿ‘‰ Gebruik bij gedeelde definities (bijv. status, type, categorie)


๐Ÿ”ค 3. Naamgeving

Display name

Formaat

<name>

Richtlijnen

  • beschrijvend en begrijpelijk

  • enkelvoud

  • functionele naam

Voorbeelden

  • Status

  • Type

  • Category


Technical name

Formaat

<publisher>_<name>

Richtlijnen

  • publisher prefix verplicht

  • lowercase + underscore

  • geen spaties

Voorbeelden

  • brenke_status

  • brenke_category

  • brenke_type


๐Ÿงฉ 4. Waarden (Options)

Elke choice bestaat uit afzonderlijke waarden (options).

Richtlijnen

  • gebruik duidelijke, consistente labels

  • vermijd afkortingen

  • gebruik Engels als standaard

  • houd waarden stabiel (vermijd wijzigen van bestaande opties)


Voorbeelden

Label Value
Director 420550000
CEO 420550001
Management 420550002
Advisor 420550003

๐Ÿ‘‰ De numerieke value is technisch en mag niet wijzigen na gebruik.


โš ๏ธ 5. Belangrijke aandachtspunten

  • wijzig bestaande waarden niet (impact op data en integraties)

  • hergebruik globale keuzes waar mogelijk

  • verwijder geen waarden die al gebruikt zijn

  • gebruik consistente volgorde

๐Ÿ‘‰ Wijzigingen aan choices kunnen impact hebben op bestaande data en processen.


๐Ÿ”„ 6. Gebruik in oplossingen

Choices worden gebruikt binnen:

  • formulieren (dropdowns)

  • business rules

  • cloud flows

  • JavaScript

  • plugins / APIโ€™s

๐Ÿ‘‰ Zorg dat naamgeving en waarden consistent blijven over alle lagen.


โœ… Best practices

Aanbevolen

โœ” gebruik globale choices voor hergebruik

โœ” gebruik consistente naamgeving

โœ” houd waarden stabiel

โœ” documenteer betekenis van opties

โœ” gebruik duidelijke labels


Vermijden

โœ˜ hardcoded waardes (bijv. integer checks in code)

โœ˜ duplicatie van vergelijkbare choices

โœ˜ wijzigen van bestaande option values

โœ˜ onduidelijke of afgekorte labels


๐Ÿ“Š Samenvatting

Choices zorgen voor:

  • consistente invoer van gegevens

  • betere datakwaliteit

  • herbruikbare definities

  • voorspelbare verwerking in business logic

๐Ÿ‘‰ Correct gebruik van choices is essentieel voor een stabiel en onderhoudbaar datamodel binnen Dataverse.