Introduction

You can also use the Email Tool in Post Form Submission Processing to send out an email when the user submits the form on:

• Data creation, or
• Data update or
• Both Data creation and Data update.
  
  

Email Tool Properties

Configure Email Tool

Image Added

Figure 1: Email Tool Properties

...

Image Added

Figure 2: SMTP Settings

Screens (Click to view)Image RemovedFigure 2: SMTP Settings

Name	Description
From	Sender email address. Info title Example no-reply@your-company-name.com
SMTP Host	Email Server SMTP Host Info title Example smtp.gmail.com
SMTP Port	Email Server SMTP Port Info Typically, port 465 for SSL security option and 587 for TLS
Security	None TLS SSL Alternatively, you can click on the "hash" symbol to allow the input of hash variables.
SMTP Username	Email Server Account Username Info On Google email account, use your full email address.
SMTP Password	Email Server Account Password Info Password submitted will be encrypted for security reason.

...

Configure Email Attachments

...

Image Added

Figure 3: Attachments

Image Modified

Figure 4: ICS Attachment

Image RemovedFigure 5: Sample .ics File Opened using Microsoft Outlook

Image RemovedFigure 6: Sample .ics File Opened using Gmail

Name	Description
Form	File attachment source form.
Form Upload Fields	Field ID: File attachment field ID(s) in the Form selected above. Embed: Click the checkbox to embed the image attachment in the email and display the image using HTML, for example: <img src="cid:#form.table.FileUpload?url#" />
Files	This attribute allows one to define the file attachment freely by defining a system path or absolute URL. Name Description Path Source file path & filename. Type System Path URL File Name File name to be used in Email attachment. Embed Click the checkbox to embed the image attachment in the email and display the image using HTML, for example: <img src="cid:cat.jpg" /> See Send Datalist as attachment in Email Tool for more information.
Attach ICS File	Check this option to prepare an event and attach as an ICS file in the email. When this attribute is checked, one will need to populate the details for the calendar ICS file in the fields below. Event Name Start Date Time End Date Time Date Format Timezone (e.g. America/Los_Angeles) (Reference: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) All Day? Event Description Location Organizer Email Attendees Important: The organizer or sender email must not be the same as your destination/recipient email. If sender and recipient emails are the same, you will not see the "Add to calendar" box in your email.

Image Added

Figure 5: Sample .ics File Opened using Microsoft Outlook

Image Added

Figure 6: Sample .ics File Opened using Gmail

Images In Email Tool

In Joget DX, we introduced a new ?img2base64 hash variable escape char to convert images tag src in Rich text editor field to base64 data string so that Email Tool can display the image. The syntax is: #form.tableName.richTextFieldId?img2base64#

Note: Google Gmail will not allow images having base64 data.

Alternatively, starting from Joget DX v7.0.7, we can now easily embed images via the "Embed" option in the "Files" property.
See this section: Configure Email Attachments
Sample app available below.

Download Demo App

• APP_email_tool_with_ics_attachment_dx_kb.jwa
  
• APP_embed_image_email_dx.jwa ^{(Requires Joget DX v7.0.7 or higher)}
  

Related Tutorials

• Sending Email
• User Notification Plugin Plugin
• User Notifications Tutorial Tutorial
• Export Form Email Tool
• Send JasperReports PDF in Email Tool
• Add Signature Form Element as Image into Email Content
• Send Datalist as attachment in Email Tool

...