Feature: #90919 - Skip translation of overridden form finisher options
See forge#90919
Description
If form finisher options are overridden via FlexForm, they must not be translated
by the Translation
. Otherwise, they would probably be overridden
again by a localization from a translation file.
To address this issue, a new translation option properties
has been introduced. The option allows skipping all those finisher options whose
option value has been changed within a FlexForm. The translation option is only
respected in Translation
.
The following example excludes three properties (subject, recipients and format).
That way, the options can only be overridden within a FlexForm but not by
Translation
. The option is automatically generated as soon as
FlexForm overrides are in place. The following syntax is only documented for
completeness. Nonetheless, it can also be written manually into a form definition.
finishers:
-
options:
identifier: EmailToSender
subject: 'Email to sender'
recipients:
recipient@sender.de: 'recipient@sender name'
translation:
propertiesExcludedFromTranslation:
- subject
- recipients
- format
Impact
The translation order is as follows:
- Default value from form definition
- Overridden value within a FlexForm (if any)
- Localized value provided by translation files (if any)
With the new translation option, the last (third) step can be skipped. That way, the FlexForm value will be preferred.