Codelijsten

Codelijsten zijn herbruikbare sets van { code, label }-waarden voor gecontroleerde keuzes zoals taal, land, documenttype of organisatiespecifieke categorieën. De code is de stabiele waarde die in gegevens wordt opgeslagen en door integraties wordt verstuurd; het label is de leesbare tekst die auteurs zien.

Kies de juiste waardebron

Een attribuut kan een van drie modellen voor waardevalidatie gebruiken:

Vrij formaat — Elke waarde wordt geaccepteerd. Gebruik dit voor open waarden.
Inline waarden — Een korte lijst die rechtstreeks op het attribuut wordt beheerd. Gebruik dit voor een kleine, attribuutspecifieke set, zoals acme en rocket.
Codelijst — Een benoemde lijst die door meerdere attributen kan worden gedeeld of vanuit een externe bron kan worden beheerd. Gebruik dit voor grotere of centraal beheerde lijsten, zoals BCP-47-talen of ISO-landcodes.

Maak een codelijst aan

Open Codelijsten voor de tenant en kies Nieuwe codelijst. Selecteer een brontype:

Inline — Vul elke code en elk label in de invoereditor in. Waarden verschijnen in keuzelijsten in de volgorde waarin je ze toevoegt.
URL — Vul een URL in die een JSON-array met waarden teruggeeft. Vernieuw de lijst vanaf de detailpagina wanneer de bron is gewijzigd; optionele sortOrder-waarden bepalen de volgorde in keuzelijsten.

URL-items gebruiken deze vorm:

[
  { "code": "en-US", "label": "English (United States)", "sortOrder": 1 },
  { "code": "nl-NL", "label": "Dutch (Netherlands)", "sortOrder": 2 }
]

Als het vernieuwen van een URL mislukt, bewaart Epistola de laatst succesvolle waarden en registreert het de fout. Bestaande keuzelijsten blijven daardoor werken terwijl je de bron herstelt.

Koppel een codelijst aan een attribuut

Bewerk een attribuut en kies de codelijst als Waardebeperking. Een attribuut kan een codelijst óf inline waarden gebruiken, nooit beide. Bij gebruik op een variant zien auteurs de zichtbare waarden in een keuzelijst. De keuzelijst toont code — label wanneer deze verschillen; integraties blijven de code gebruiken.

Beheer waarden

Open een codelijst om de waarden te bekijken. Inline waarden behouden de volgorde waarin je ze toevoegt; URL-bronnen kunnen sortOrder-waarden meegeven. Met Verbergen haal je een waarde uit nieuwe selecties, terwijl de code geldig blijft voor bestaande varianten. Zo kun je een waarde veilig uitfaseren. Gebruik Verborgen waarden tonen om een waarde te bekijken of opnieuw zichtbaar te maken.

Catalogi en delen

Een codelijst hoort bij een catalogus binnen een tenant. Authored catalogs kunnen codelijsten samen releasen met templates, attributen, themes, fonts en afbeeldingen. Codelijsten uit subscribed catalogs zijn beschikbaar voor gebruik, maar alleen-lezen in de consumerende tenant.

Epistola levert ook systeemcodelijsten, zoals lijsten voor locale, taal en land, via de systeemcatalogus.