Plume

Sending emails in ARender

Sending email is possible using an application named “plume” which must be placed in an application server in the same way as ARender.

ARender Setup

A configuration is required on the ARender side:

arenderjs.startupScript=scripts/plume.js
plume.enabled=true
plume.url=/plume

The plume.url property can be changed to match the url of the plume app deployed.

Plume configuration

Various properties can be activated in plume, corresponding to several functionalities. These properties must be placed in the application.properties file whose path is : server/webapps/plume/WEB-INF/classes/application.properties

The arender.enabled property must be enabled for plume usage in ARender.

arender.enabled=true

SMTP

For sending mail via the SMTP protocol, the properties to assign are as follows :

smtp.enabled=true
smtp.host=
smtp.port=
smtp.username=
smtp.password=
smtp.parameters.socketFactory.port=587
smtp.parameters.socketFactory.class=javax.net.ssl.SSLSocketFactory
smtp.parameters.starttls.enable=true
smtp.parameters.ssl.trust=*
smtp.parameters.ssl.protocols=TLSv1.2

Rest

Activating the Rest API allows you to retrieve the current document in ARender and use it as an attachment.

It is also possible to retrieve a contact list from an url via a Rest call, this list can be used as a means of pre-filling contact fields.

rest.enabled=true
rest.contacts.url=

FS

Enabling the file system allows recovery of local files which can then be used as attachments, email templates and contact list.

Sent emails can also be saved locally.

fs.enabled=true
fs.attachment.dir=/attachments
fs.template.dir=/templates
fs.outgoing.dir=

To define a contact list as a means of pre-filling contact fields, it is possible to define its contacts directly in the property file in the following form :

fs.contacts[0].firstName=firstName1
fs.contacts[0].lastName=lastName1
fs.contacts[0].email=firstName1.lastName1@test.com

fs.contacts[1].firstName=firstName2
fs.contacts[1].lastName=lastName2
fs.contacts[1].email=firstName2.lastName2@test.com

...

LDAP

A contact list can also be retrieved from the LDAP protocol. For this, the properties are as follows :

ldap.enabled=true
ldap.server=
ldap.username=
ldap.password=
ldap.base=