Messages

Purpose
Some of the Form Runner actions display messages to users. For instance, when a form is saved, a message is displayed to confirm that the form was saved successfully. The Messages dialog allows you to customize those messages directly in Form Builder, instead of using properties such as oxf.fr.resource.*.*.en.detail.messages.save-success
.
Usage
You can open the Messages dialog by clicking on the "Messages" button, under the "Advanced" tab, in the toolbox.
Each message must have a language, a name, and a value.
The message name can be one of the pre-defined names present in Form Runner's resources.xml
(e.g. save-success
or upload-error
) or a custom name, which can be entered by selecting "Other".
When a message is defined in the Messages dialog, it overrides any message defined in a property.
Supported actions
The following Form Runner actions take a message as parameter:
For example, you can reference the pre-defined message save-success
by calling the following action:
success-message(resource = "save-success")
Or simply:
success-message("save-success")
Custom messages
When overriding existing processes or introducing custom processes in the properties, you can also reference custom messages that are not used internally by Form Runner. You can do so by selecting "Other" in the name dropdown and entering a custom name.
For example, you might want to define a custom email-and-save
process to email and save your form, and display a custom sent-and-saved
message (defined via the Messages dialog) upon success. This allows you to use a more specific message than the pre-defined save-success
message.
<property as="xs:string" name="oxf.fr.detail.buttons.acme.foo">
summary clear pdf review email-and-save
</property>
<property as="xs:string" name="oxf.fr.detail.process.email-and-save.acme.foo">
email(template = "email-template-name")
then save
then success-message("sent-and-saved")
</property>
<property
as="xs:string"
name="oxf.fr.resource.*.*.en.buttons.email-and-save"
value="Email & save"/>
See also
Last updated