Email settings

Last updated 5 months ago

Availability

This feature is available since Orbeon Forms 2018.1.

This is an Orbeon Forms PE feature.

Introduction

The "Email Settings" button under the "Advanced" tab in the toolbox opens the "Email Settings" dialog.

The Email Settings allow you to specify, for the given form:

  • an email subject

  • an email body

In addition, subject and body can optionally be parametrized to fill placeholders with control values or the result of formulas (specified as XPath expressions).

If the form definition has more than one language, subject and body are specified by language.

Email subject

You can specify an email subject by deselecting the "Template from Properties" checkbox. When that checkbox is selected, the subject template comes from a property. This is the default for backward compatibility.

<property
as="xs:string"
name="oxf.fr.resource.*.*.en.email.subject"
value="Here is your confirmation: "/>
Email Subject

Email body

You can specify an email body by deselecting the "Template from Properties" checkbox. When that checkbox is selected, the body template comes from a property. This is the default for backward compatibility.

<property
as="xs:string"
name="oxf.fr.resource.*.*.en.email.body"
value="Hi, here is an email from Orbeon Forms!"/>

The email body can be set in plain text or in rich text (HTML) with the relevant checkbox.

Email Body

Dynamic email subject and body

An email subject or body can be dynamic and include the value of form controls or formulas, as shown in the examples above.

For more, see Template syntax.

Localization

When the form definition has more than one language, a language selector appears and allows switching between languages for setting a subject or body in the given language. Note that template parameters are not localizable.

See also