Functionele uitbreiding
In DCB is de mogelijkheid toegevoegd om defaultwaarden op te nemen bij rubrieken. Diverse WebAPI’s zijn uitgebreid zodat defaults expliciet kunnen worden meegegeven. Het zetten van defaults is losgetrokken van waardebeperkingen, waardoor dit nu apart beheerd kan worden. Aanpassingen in DCB zorgen ervoor dat defaults consistent worden opgehaald en gebruikt.

Levering via WebAPI
De rubriekgegevens bij productdefinities en eigengegevens zijn uitgebreid met een veld Defaultwaarde. Defaultwaarden worden geleverd in het type dat past bij de rubriek.

• Als een waarde in de waardeslijst als IsDefault = true is gemarkeerd, wordt deze ook als defaultwaarde teruggegeven.
• Als er een defaultwaarde is opgegeven, wordt deze opgenomen en getransformeerd naar het juiste type.
• Wanneer er geen defaultwaarde ingericht is én er geen waardes zijn, wordt Defaultwaarde niet geretourneerd.
• Wanneer er wel een defaultwaarde is ingericht én er geen waardes zijn, wordt de defaultwaarde geretourneerd in het juiste type (string, int, decimal, boolean, etc.).
• Wanneer er wel een defaultwaarde én waardes zijn, dan wordt Defaultwaarde alleen geretourneerd als er geen waarde met IsDefault = true is én er een waarde aanwezig is met een Code die exact overeenkomt met de defaultwaarde. Zo niet, dan volgt een foutmelding.
• Wanneer er geen defaultwaarde is ingericht maar er wel waardes zijn, bevat Defaultwaarde de Code van de waarde waarvan IsDefault = true. Als er geen waarde met IsDefault = true is, wordt Defaultwaarde niet geretourneerd.

Voorbeeld uitvoer

"Waardes": [

{

"Code": {},

"CodeAFD": "string",

"Omschrijving": "string",

"IsDefault": true,

"IsHistorisch": true

}

],

"Defaultwaarde": {}

• Validatieregels en foutafhandeling
  Als er zowel een waarde met IsDefault = true als een opgegeven default bestaat, wordt een foutmelding geleverd.
• Ongeldige of niet‑converteerbare defaults leiden tot een foutmelding.
• Als een defaultwaarde niet voorkomt in de lijst van toegestane waardes, wordt eveneens een foutmelding geleverd.
• Bij pakket‑productdefinities en eigengegevens worden defaultwaarden niet geleverd, omdat de inrichting dit nog niet ondersteunt. 

Impact
Je kunt nu defaultwaarden centraal vastleggen bij rubrieken en uitleveren via de WebAPI. Dit zorgt voor meer consistentie, minder afhankelijkheid van waardebeperkingen en een robuuster beheer van rubrieken. 

Breaking change
De uitbreiding van de uitvoer van de WebAPI met de property Defaultwaarde kan worden beschouwd als een breaking change. Bestaande integraties die rubriekgegevens verwerken moeten hierop worden aangepast. 

Gerelateerd onderwerp
Nieuw tabblad Defaults voor rubrieken zonder waardebeperking (4.1.3.3)