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:
4. Name — unieke berichtcode (gebruik de naamgevingsconventie)
5. Type — kies LABEL of ULTIMO
6. Content — de berichttekst
7. 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

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.

Zie ookbewerken

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