Messages (Systeemberichten)

Messages zijn alle systeem- en gebruikersberichten die in de Ultimo-applicatie worden gebruikt. Dit omvat bevestigingsmeldingen, validatieberichten, knoplabels, dialoogteksten en foutmeldingen. Via de Messages-configuratie in UCT kun je bestaande berichten aanpassen en nieuwe berichten aanmaken.

Gerelateerd: text-templates, screens, screen-rules, ../concepts/uct-overzicht

Waar vind je Messages?bewerken

UCT > User Interface > Messages

De lijstweergave toont kolommen voor:

• Berichtnummer — uniek nummer
• Name — de berichtcode (bijv. ACCEPTALL_COMMENT, ACCEPT_JOB)
• Type — het berichttype (LABEL of ULTIMO)
• Content — de berichttekst
• Validation — of het bericht een validatiebericht is

Het detailpaneel bevat de tabbladen Basic en Card.

Berichttypenbewerken

Message codes: naamgevingsconventiebewerken

Ultimo hanteert een consistente naamgeving voor message codes:

Veelgebruikte message codesbewerken

Acceptatie en goedkeuring:

• ACCEPT_JOB — Bericht bij accepteren van een job
• ACCEPTALL_COMMENT — Bericht bij accepteren van alle items met opmerking
• APPROVE_CONFIRM — Bevestiging goedkeuring

Activering en status:

• ACTIVATE_ACTION — Bericht bij activeren van een actie
• STATUS_CHANGE_CONFIRM — Bevestiging statuswijziging

Toevoegen en verwijderen:

• ADD_COMPLAINT — Klacht toevoegen
• DELETE_CONFIRM — Bevestiging verwijderen

Een nieuw bericht aanmakenbewerken

1. Ga naar UCT > User Interface > Messages
2. Klik op Toevoegen
3. Vul de velden in:
   • Name — unieke berichtcode (gebruik de naamgevingsconventie)
   • Type — kies LABEL of ULTIMO
   • Content — de berichttekst
4. Voeg eventueel vertalingen toe via het Card-tabblad

Meertalige berichtenbewerken

Messages ondersteunen meerdere talen via het Translations-mechanisme in UCT. De vertaling wordt automatisch getoond op basis van de taalinstelling van de ingelogde gebruiker.

Vertalingen beheer je via:

UCT > User Interface > Translations

Vertaalsleutels die beginnen met # zijn speciale systeemsleutels. Wijzig deze alleen als je zeker weet wat het effect is.

Messages en workflowsbewerken

Workflows kunnen messages gebruiken voor:

• Validatieberichten — tonen aan de gebruiker wanneer een actie niet is toegestaan
• Bevestigingsmeldingen — vragen om bevestiging voor een actie
• Dialoogteksten — tekst in dialoogvensters

Voorbeeld: message in een workflowbewerken

<Dialog MessageCode="DELETE_CONFIRM" 
        Title="Bevestiging"
        Buttons="YesNo" />

Waar worden Messages gebruikt?bewerken

Met de "Used in"-functionaliteit in UCT kun je opzoeken waar een specifieke message code wordt gebruikt:

Dit is handig om te controleren welke impact een wijziging heeft voordat je een bericht aanpast.

Best practicesbewerken

1. Consistente naamgeving — gebruik het patroon ENTITY_ACTION of ENTITY_ACTION_DETAIL
2. Hergebruik — berichten die op meerdere plekken worden gebruikt, hoeven slechts eenmaal aangepast te worden
3. Meertalig — voeg altijd vertalingen toe voor alle actieve talen in de omgeving
4. Test — controleer of het bericht correct wordt getoond in de juiste context
5. Documenteer — leg vast waarvoor custom messages worden gebruikt
6. Standaard berichten niet verwijderen — pas ze aan indien nodig, maar verwijder ze niet

Expressies in berichtenbewerken

Messages kunnen dynamische expressies bevatten om contextgevoelige teksten te genereren. De expressies worden geëvalueerd op het moment dat het bericht wordt getoond.

Enkelvoud/meervoudbewerken

Gebruik een if-expressie om te schakelen tussen enkelvoud en meervoud op basis van een teller:

if(${count} == 1, "1 equipment", "${count} equipments")

Dit voorkomt grammaticaal incorrecte teksten zoals "1 equipments".

Entity beschrijvingenbewerken

Gebruik altijd de .Description property van een entiteit in een bericht. Zonder .Description wordt alleen het interne ID getoond, wat voor eindgebruikers nietszeggend is:

${employee.Description}   →  "Jan de Vries"     (correct)
${employee}               →  "EMP00042"          (alleen ID, vermijd dit)

Parameters laden in workflow Message actionbewerken

In de Workflow Designer: voeg een Message action toe aan de workflow en klik op de Load knop om de parameters automatisch uit het geselecteerde bericht te laden. Hiermee worden alle placeholders (bijv. ${count}, ${employee.Description}) als invulvelden zichtbaar in de actie, zodat je ze direct kunt koppelen aan workflow properties.

Message types in contextbewerken

Voorbeeldcodes uit trainingspraktijkbewerken

De volgende berichtcodes zijn veelgebruikt in consultantprojecten:

Consultant tip: Houd een projectspecifieke nummering bij voor custom messages (bijv. 9000-9999) om conflicten met standaard Ultimo messages te voorkomen. Documenteer elke code met gebruik en context.

Relatie met Text Templatesbewerken

Messages en Text Templates zijn complementair:

• Messages = korte berichten, labels en validatieteksten in de UI
• Text Templates = langere sjablonen voor e-mails en notificaties met dynamische placeholders

Text Templates verwijzen soms naar messages voor standaardteksten, en beide worden aangestuurd vanuit workflows.

Brondatabewerken

Dit artikel is consultant-synthese. Voor ground-truth data over specifieke Ultimo-objecten gebruik de onderstaande tools.

• Entiteit-data — lookup_entity("<Name>") · lookup_table_schema("<Name>") Alle properties, DB-kolomnamen, triggers en computed columns. Bronnen: Entities.xml, database-schema.json.
• Workflows per entiteit — find_workflows("", entity="<Name>") Alle Before/After Save events en andere ActionFields voor een entiteit. Bron: workflows.xml.
• Schermen — lookup_screen("<ScreenName>") · Schermen index Schermdefinities incl. tabel, autorisatielevel, screen-level. Bron: ultimo_screens_names.xml.
• AET-settings / feature toggles — find_aet_settings(query) · AET index Feature toggles en systeem-configuratie. Bron: ApplicationElementTreeData.json.
• Kennisbank-breed zoeken — search(query) Doorzoekt alle wiki-artikelen, entities, workflows, schermen, templates en ActionFields tegelijk.

Zie ookbewerken

• text-templates — Tekstsjablonen voor e-mails en notificaties
• screens — Schermconfiguratie
• screen-rules — Schermregels
• ../concepts/uct-overzicht — UCT configuratie overzicht