TextTemplate (E-mailtemplate)
De TextTemplate-entiteit beheert e-mail- en berichttemplates in de Ultimo-database. Templates worden gebruikt voor automatische notificaties bij statusovergangen (progress-status), workflows en andere systeemgebeurtenissen.
Entiteitsnaam: TextTemplate
Databasetabel: TextTemplate
Primaire sleutel: TXTTID + TXTTCOU (composiet: ID + landcode)
Belangrijkste propertiesbewerken
| Property | Type | Kolom | Omschrijving |
|---|---|---|---|
| Id.Id | UltimoString(11) | TXTTID | Template-code |
| Id.CountryCode | UltimoString(5) | TXTTCOU | Landcode (taalversie) |
| Subject | UltimoString(625) | TXTTSUBJECT | Onderwerpregel |
| Body | UltimoString | TXTTBODY | Berichttekst |
| BodyType | TextTemplateBodyType | TXTTBODYTYPE | Type: PlainText (0) of Html (1) |
| CustomSubject | UltimoString(625) | TXTTCUSTOMSUBJECT | Aangepast onderwerp |
| CustomBody | UltimoString | TXTTCUSTOMBODY | Aangepaste tekst |
| CustomBodyType | TextTemplateBodyType | TXTTCUSTOMBODYTYPE | Type custom body |
Contextsbewerken
| Value | Naam | Beschrijving |
|---|---|---|
| 0 | TextTemplateContext.None | Standaard |
| 1 | TextTemplateContext.Standard | Standaard |
Relatie met workflows en statusovergangenbewerken
TextTemplates worden op meerdere plaatsen ingezet:
-
ProgressStatusFlow: De velden
EmployeeTextTemplateCode,ManagerTextTemplateCode,ReporterTextTemplateCode,OwnerTextTemplateCodeenRequesterTextTemplateCodeop ProgressStatusFlow verwijzen naar TextTemplate-codes. -
Notification-velden: Op
ProgressStatusFlowzijn ook notification-varianten beschikbaar:NotificationEmployeeTextTemplateCode,NotificationManagerTextTemplateCode, etc. -
Workflows: Via de
<Email>workflow-instructie kan eenEmailTemplateCodeworden opgegeven die verwijst naar een TextTemplate.
Standaard vs. Custombewerken
Ultimo levert standaard templates mee. Klant-aanpassingen worden opgeslagen in de Custom-velden:
- Subject/Body: Standaard Ultimo-teksten (niet wijzigen, worden overschreven bij updates)
- CustomSubject/CustomBody: Klant-specifieke aanpassingen (blijven behouden bij updates)
Het systeem gebruikt CustomBody als deze gevuld is, anders valt het terug op Body.
Tips voor consultantsbewerken
- Meertalig: Templates bestaan per landcode (CountryCode). Maak voor elke taal een apart record aan met dezelfde ID maar een andere landcode.
- HTML-templates: Gebruik
BodyType = 1(Html) voor opgemaakte e-mails. Bij PlainText (0) wordt de tekst als platte tekst verstuurd. - Custom-velden gebruiken: Wijzig altijd
CustomBody/CustomSubject, niet de standaardBody/Subject. Dit voorkomt dat aanpassingen verloren gaan bij een Ultimo-upgrade. - Placeholders: Templates ondersteunen placeholders zoals
#{Job.Id},#{Job.Description},#{Employee.Description}die bij verzending worden gevuld met actuele waarden. - Testen: Test templates via het verwerken van een statusovergang op een testrecord. Controleer de verzonden e-mail in het EmailSubject-log.
Zie ookbewerken
- progress-status - Statusovergangen met templates
- job - Werkorders (veelgebruikt voor notificaties)
- employee - Ontvangers van notificaties