Versions Compared

Old Version 1

changes.mady.by.user Owen Ong

Saved on

compared with

New Version 2

changes.mady.by.user Andrew

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Introduction

...

Export Form Email Tool allows you to send out an email with a form attached in PDF format.

Apart from configuring the normal email plugin, the only other configuration you will need to do would be on the selection of the form to be attached and the desired file name for the attachment.

...

Image RemovedFigure 1:


Export Form Email Tool Properties

Configure Export Email Tool


NameDescription
Form

Form to be used to generate pdf file.

Record row will be matched with current process instance ID.

Image Added
Figure 1: Export Form Email Tool Properties

File NameIntended pdf file name to appear in Email attachment.
Hide fields without valueWhen checked, any field without value keyed in will not appear in the generated pdf file.
Show unselected options for multi options fieldWhen checked, unchecked/unselected options will appear in the generated pdf file in elements like Select Box, Radio Button.

...

Image Removed

...



Email

...

Info

NameDescription
To (Specific email address)Recipient fully qualified address.

Image Added
Figure 2: Email Info

To (Participant ID)

Participant ID(s) according to the process flow it resides in.

Multiple values can be accepted by separating them with semicolons.

Info

When To (Specific email address) and To (Participant ID) are both populated, email will be sent to both.

CC

Fully qualified address is expected.

Multiple values can be accepted by separating them with semicolons.

Info

CC: lets you send a copy of a message to someone who's interested, but is not the primary recipient.

BCC

Fully qualified address is expected.

Multiple values can be accepted by separating them with semicolons.

Info

Both Cc and Bcc forward a copy of the message to everyone you've listed. The main difference between Cc or Carbon copy and Bcc (Blind carbon copy) is that, with the latter, the recipients do not get to know each other.

SubjectEmail Subject.
MessageEmail Message.
HTML Content?Check if "Message" is intended to be a HTML content.

...

Image Removed

...



Email

...

-

...

SMTP Settings


Tip

If no you leave the SMTP settings is configured here, this tool below empty, Joget will read the default SMTP configuration in values from the "General Settings ".You may configure common SMTP settings in "General Settings > SMTP Settings" for your future convenience page.

NameDescription
From

Sender email address.

Info
titleExample

no-reply@your-company-name.com

Image Added
Figure 3: Email SMTP Settings

SMTP Host

Email Server SMTP Host

Info
titleExample

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.

Info
titleQuick Test

Hit on the "Send Test Email" button to quickly validate and test out your email settings.

 

Image Removed

...

Advanced


NameDescription
Formatting (CSS)

CSS to be included when generating pdf file.

The Advanced > Formatting (CSS) field gives you formatting options (font size and color) for the output. 

Available CSS Classes:

 


Code Block
*
- Wildcard. Everything in the form.
 
.form-section
- Container of a section
 
.form-section-title
- Container of section title
 
.form-column
- Container of column
 
.form-cell
- Container of field
 
.label
- Label of field
 
//Sub Form
.subform-container
- Container of a Subform
 
.subform-title
- Container of Subform title
 
.subform-section
- Container of section in Subform
 
.subform-section-title
- Container of section title in Subform
 
.subform-column
- Container of column in Subform
 
.subform-cell
- Container of field in Subform
 
.header
- Container of configured header
 
.footer
- Container of configured footer
 

Image Modified
Figure 5: This figure illustrates the CSS classes used in the form layout.
 

 Code Block
titleExample
//Change all word to blue color
*, .form-cell{
  color:blue;
}
 
//Change all word to smaller size
*, .form-cell{
  font-size:10px;
}
 
//Change all label format to underline
.label{
  text-decoration:underline;
}
 
//Transform all header format to uppercase
.form-section-title{
  text-transform:uppercase;
}
 

Font & Unicode 
There are a few fonts (added by default) that you can use in CSS formatting.  They are:
 

 Code Block
serif, sans-serif, monospace, Courier, TimesRoman
 

For Unicode content, you can use the following fonts for Asian languages (i.e., Chinese, Traditional Chinese, Japanese, Korean):
 

 Code Block
STSong-Light, MSung-Light, HeiseiMin-W3,  HYGoThic-Medium
 

Note : "STSong-Light" gives the best result for Chinese; "MSung-Light" for Traditional Chinese; "HeiseiMin-W3" for Japanese; and "HYGoThic-Medium" for Korean.
 

 Code Block
*{font-family:HYGoThic-Medium;}
 

Example for adding non supported font:
Method 1: Add the following CSS into Export Form Email Tool > "Formatting (CSS)" field:
 

 Code Block
@font-face {
    src: url(http://localhost:8080/THSarabun.ttf);
    -fs-pdf-font-embed: embed;
    -fs-pdf-font-encoding: Identity-H;
}
*{font-family: 'TH SarabunPSK';}
Download the THSarabun.ttf font file and copy it to "[Tomcat Directory]/webapps/ROOT" folder.
Method 2: From Joget v6.0.16, it now supports adding additional font for datalist pdf export and FormPdfUtil by adding the font file to folder "/wflow/fonts" directory and configure the font in "fonts.csv" file in the same directory with format "font family name, file name, encoding". For the sample, kindly refer to the fonts.csv file.
Image Added
Figure 4: Advanced
Header (HTML)Header in HTML to be included when generating pdf file.
Repeat header on every page?If checked, the Header (HTML) will be included in every subsequent pages in the generated pdf file.
Footer (HTML)Footer in HTML to be included when generating pdf file.
Repeat footer on every page?If checked, the Footer (HTML) will be included in every subsequent pages in the generated pdf file.

Related Tutorials