Reform Email for VDP
- 1 Benefits of Using Email Features
- 2 Software & Hardware Requirements
- 3 Installation
- 4 Plug-in Registration and Licensing
- 5 Setting up your First Email Enabled Form
- 6 Descriptions of Setup Wizard Fields
- 7 Descriptions of Designer Email Fields
- 8 Common SMTP settings
- 9 Configure HTML Body
- 10 Reform Email Monitor Service
- 11 Maintenance
- 12 Troubleshooting
- 13 Email Issue Ticket
Benefits of Using Email Features
Reform can send emails by communicating with SMTP, Exchange servers and Office 365. Emails can contain text, html, or attachments. Combining Reform with an email server allows the delivery of documents processed by Reform to various recipients. By sending the information via email, paper costs are reduced while delivery and response delays are decreased.
Software & Hardware Requirements
To install the Email Plug-in to your existing Reform installation, download and run the Reform-Email installation executable.
The installer will launch. There is no pre-configuration required to install the Plug-in, so click Next and the process will begin. It will install SQL Server Express unless another Reform product previously installed it. This typically takes between 10-20 minutes between downloading the application and installing it. If the required Microsoft .NET Framework version is not already installed on your system, it will be automatically downloaded and installed. After the installation is complete, click Finish. The Email Plug-in is now installed.
The default installation directory for Reform and its Plug-ins is C:\Program Files\Reform…\. If you have changed the path during the Reform installation routine, please refer to the appropriate path instead of the default one referenced throughout this documentation.
Plug-in Registration and Licensing
When evaluating Reform, the Plug-ins will also be in an evaluation mode for that period of time. Once Reform has been purchased and licensed, the required Plug-ins must also be licensed in order to continue functioning correctly.
Please see the "Reform Licensing and Registration" section of the Reform User Manual for more information on how to license Reform Plug-ins. After the license is entered, the Reform Spooler will need to be restarted to refresh the licenses. More information regarding the Reform Spooler Service can be found in the Reform User Manual.
Setting up your First Email Enabled Form
Configuring a form to connect with a mail server and send emails is a simple process that utilizes the Workflow Designer, a form creation and configuration tool. The setup will allow you to set static (unchanging) values for various fields, or use mapped text objects for dynamic (changing) values. All basic attributes of an email can be configured this way (email body, recipients, CC/BCC, etc.).
|Note: This tutorial requires the Reform Variable Data Printing (VDP) plugin be installed to edit a form. If you are using this plugin with MOST and not for Variable Data Printing, please follow the instructions in the corresponding manual for MOST integration (this tutorial may be skipped).|
- Open Reform VDP Designer. A shortcut can be found in the desktop folder
\FabSoft Reform PDC\VDP\VDP Designer
- For the example, we will create a new form using a template (a pre-made form). Go to
File > New > New...and select the template named Email.FTM, then click OK.
- When it asks if you would like to open a text file for designing, select No.
- Next, go to
File > Saveto save your form. Name it
- You can now close VDP Designer, since we have made our base form to start with.
- Open Workflow Designer. A shortcut can be found in the desktop folder in
\FabSoft Reform PDC\Base\Workflow Designer.
- Once open, go to
File > New...
- Select Document Automation and click Ok.
- You will now notice that your Inputs, Processes and Outputs have been populated by the various plugins you have installed (Email being one of the outputs).
- We can now start adding the necessary components to the workflow. First, drag and drop a Form and File object from the inputs on the left onto the workflow area (click and hold "Form and File", then drag it onto the workflow area and release).
- A dialog box will open prompting for a description. In the text box, enter a description for the object you just added. For example,
Email Demo. Then click Finish. This will take you back to your workflow.
- Now that the object has been added, we can configure it. To do so, right click on the object and select Configuration….
- You will now be presented with the Input Setup window. First, we want to select the TextFile or data stream that our form will be using. To do so, you can simply begin typing in the box, or you can browse to find it. We want to select the
Email.outfile which is located in the
\Reform\Backupsdirectory. Click the small folder icon to bring up a window which will let us choose that file. Select the file and click
- After choosing the text file, you are taken back to the Input Setup page so that you can now select a form. Click the small folder icon to bring up a window which will let us choose the desired
Email.FOMform file. Select the FOM file and click
- Now that you have both your Input Text File and Reform Form selected, the setup of Form and File is complete. You can quickly double check that the correct files are selected and then click
- You will also be prompted to add a page-break field to the forms. At this point, we want to select
- To finish the Email workflow, we want to add an
Form and File. Take your mouse and drag the
- Once you click
Finish, you are taken back to your workflow. Your
Email Demo. To do so, first select the
Add Connectorbutton from the menu bar. Next, drag your mouse from the small
Email Demoto the small
Email Democaption will turn green.
- You will be prompted to configure
Yes.If you click
No, you can also double click on the Email object or right click on the object and select
Configuration...at a later time. This configuration will step you through all the settings necessary for Email to work with your email server. The first piece of information is the file type you want your email attachment to be. Select
PDF Fileand click
- For the example, we will be using data that is already present on the print stream. Some of the information you will need to enter will be dynamically populated directly from objects mapped on the text layer. The following screen will ask you to enter the address of your
SMTP Email Server Address. Since this is a static value, you can manually enter your Email server information. Click
- You are now prompted for the
SSL Enabled. Please select True if SSL is enabled or False. Click the
Nextbutton to continue.
- You are now prompted for the
Port Number. Please enter the value for the Port Number. Click the
Nextbutton to continue.
- The next screen will ask you for the
Email User Name. If your Email server requires authentication, enter the username now and click
Next. If it does not require authentication, click
- The next screen will ask for the
Email Password. Again, if your Email server requires authentication, enter the password here and click
Next. If it does not, you can click
- The following screen asks for the email address that the email will be sent from. Here we would like to use data that is available in the data stream instead of a static value. To do so, we first must click the
Click here to select variable informationbutton.
- Note: After doing so, we see that a list will appear with the different fields that you can choose for your variable data. If you want to go back to static input mode, you can do so by clicking the appropriate button for static information and then typing it in.
- Now we want to use
Email Fromvalue. Select
ContactPersonEmailfrom the list. You will have to scroll down to see it. Click
- The next screen will ask for the email address that the email should be sent to. Enter an email address that you can check (Ex. your own personal email address). Click
- Note: Multiple Static addresses can be separated by a semicolon
;or a comma
- Next, it will ask you to enter email addresses for
Carbon Copies. Click the
- Next, it will ask you to enter email addresses for
Blind Carbon Copies. Click the
- Next, it will ask you to enter the
Return Email Address. Click the
- Next, it will ask you to enter email addresses for
- Next, it will ask for the email
Subject. Select the object
Remark. To select an object, first click
Click here to select variable dataand then the object list will be shown.
- You will have to scroll down to see
- You will have to scroll down to see
- Next, it will ask for the file name of the attachment. Enter the value
- The last screen will ask for the message body of the email. We want to select the object
BillingNote. To select an object, first click
Click here to select variable dataand then the object list will be shown. Select
BillingNotefrom the list. Click
- You have completed configuring your simple Email workflow. Your 2 objects (Email Demo and Email) should both be green meaning they have been successfully configured and the workflow is ready to be created.
- To make all the appropriate forms and changes, we must execute the workflow. This is done by clicking the
- on the menu bar. After execution, you will be notified of the configuration that has taken place. Click
- You can now close the Workflow Designer. When prompted, you may save your workflow so that you can go back to reconfigure it at a later time. Your form has been saved in your default forms directory. A backup of your original
Email.FOMfile has been copied to the
Workflow Designer Original Formsfolder in your forms directory. Any permanent form changes should be made to this original form as it is used throughout the form configuration process as a template. If any updates or changes are made to this template, you must execute the workflow again for your changes to appear in the forms.</code>
- To test out your settings and make sure that emails can be sent, first the Spooler should be started by clicking
Start > Programs > Reform… > Reform Spooler. Once it is open, press the
- Navigate to your
\Reform…\Backups\directory. Select the
Email.outfile, right click the file, and select
- Navigate to your
\Reform…\Spooler\directory. Paste the file into the Spooler directory. (Pasting the data stream to this folder simulates printing from Windows, AS400, Unix, etc.)
- When the Spooler Application begins processing the file, you will notice the file name change to something similar to the image below.
Once the document is emailed, the demonstration is complete. If you are not getting your output, Reform Spooler might not have the correct permissions to process the file. Please see the Reform manual for more information. You can re-test the document by copying the file from the backup directory to the spooler directory again. You can also create a new form and configure it using the Workflow Designer.
The email should be sent to whichever address you entered for the EmailTo during the configuration with the Workflow Designer. The time it takes for the email to be sent will vary depending on the speed and workload of the email server you are using. If you do not receive an email after a minute or two, verify that the RM_Email_Monitor service is running and has the correct service logon account. For more information about the service, please see the Reform Email Monitor Service section. If the service is running and you’re still not receiving emails please refer to the Troubleshooting section of this manual. This concludes the basic setting up and sending of an email. To experiment with more advanced options such as carbon copies and blind carbon copies, read on to the next section to learn about different fields and how you can work with them to perform more advanced email operations.
Descriptions of Setup Wizard Fields
The setup wizard can be run by going to
File > Page Setup, and then by clicking the
Setup button in the bottom of the window under
Send To Devices. You can also access this setup by using the Workflow Designer to reconfigure the objects you just added.
|Email Server||This is the name or IP address of the email server that emails will be sent from.|
|Email User Name||If your email server requires authentication, the user name to authenticate with is entered here.|
|Email User Password||If your email server requires authentication, the password to authenticate with is entered here.|
|Email From||When a user receives an email, this is who the email will appear to have been sent from.|
|Email To|| The email address that the email will be sent to. If you are entering multiple email addresses, separate them with commas.
|Email CC||In this field, one or several email addresses may be entered to have the email carbon-copied to different email addresses.|
|Email BCC||Same functionality as Email CC, except this will blind carbon copy everyone on the list. Separate multiple email addresses with a comma.|
|Return Email||Specifies the return address when a user replies to an email they received from the Reform Email Plug-in.|
|Subject||Specifies the subject of the email that will be sent out by the Email Plug-in.|
|File Name||Sets the file name of the email attachment.|
|Notes||The message body of the email.|
Descriptions of Designer Email Fields
The following is a list of available email fields. These fields are found under the Special Fields menu.
|EmailTo|| This field is used to capture the email address of the recipient. This can be used on the Text Layer or on the Design Layer. When used on the Text Layer, it will use the email address that this object highlights. When used on the Design Layer, you can supply a static email address, or use the Company Look-up option to fill in the email address. Please see the Reform Manual for more information about Lookups.
EmailTo object on the Text Layer:
EmailTo objects on the Design Layer will show up as special fields with red text.
|EmailFrom||This field is used to supply a specific sender’s email address. This object can be used on both Text and Design Layers.|
|Subject||This field is used to supply a subject for the email.|
|Notes||This field is used to include any information that you may want to add to the body of the email.|
|Company Lookup||This field is used to find an email address and other information in the Lookup Database. This field can be used on the Text or Design Layer. If the EmailTo field is empty, Reform will use the Lookup Database to find the email address. If you wish to use only the Lookup Database, place the EmailTo field in the Design Layer and remove the text information in the object.|
Common SMTP settings
|Provider||Server Address||SSL Enabled||Port|
| For Gmail users:
Configure HTML Body
HTML Body Size Limit
The Email plugin uses the SQL Table
Reform_Email_Trans. This table includes a column named
HTMLBody, which has a
nvarchar(4000) limit by default. If desired, the column may need to be increased to
By default, the Email script checks for a template file in
Reform...\Plugins\Email\Custom_Email_Body.txt. This template can be used to create an email template that is populated with values from the Reform Designer. To create a template, save the body of the email as desired. Anywhere a variable should be inserted, use the syntax:
|VariableName|. Reform will automatically insert the value of the variable into that section of the body.
A Sample Template is below. In this sample, the
_Account variable will appear in the email body.
<HTML> <div>Order Details</div> <div>Account Number: |_Account|</div> <div>...</div> </HTML>
| Note: If multiple templates or email types are required for your environment, it is recommended to create a separate/customized Email send to script to help keep each workflow isolated.
For more information on creating a custom email script, click here.
Custom HTML Scripting
If the email body (the "Notes" field in Reform) begins with
<HTML> and ends with
</HTML>, the script is designed to automatically switch the email to send as HTML instead of Plain Text.
By default, there is a footer that gets attached to all emails created by Reform. This will need to be removed in order for the HTML tags to be recognized. This can be accomplished by doing the following:
- Open the Email SendToscript found in
- Find the following lines
If _EmailPDFFooter <> "" and _EmailPDFFooter <> "0" Then EmailPDFFooter = _EmailPDFFooter Else If _EmailFooter <> "" and _EmailFooter <> "0" Then EmailPDFFooter = _EmailFooter Else String EmailPDFFooter ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |MOSTFooter| Email powered by Reform EndString EndIf EndIf
- and just below, add the following two lines
- The footer will no longer be attached to any emails, and the HTML tags in the "Notes" field will now trigger the email to render as an HTML document.
- Once the script is adjusted to exclude the default footer, the Notes field can be customized to include the HTML content.
Reform Email Monitor Service
The RM_Email_Monitor service is installed by the Email installation routine. This service monitors a database table that is populated by the Email send to script in order send emails. Using this method, a record is kept of all sent emails. Also, emails can be resent automatically if they failed to be sent to the email server.
To change the service logon account, go to Start > Programs > Control Panel > Administrative Tools > Services. Right click on RM_Email_Monitor and select Properties.
Navigate to the Log On tab. Here, you will need to set the local administrative service logon account.
Select the "This account:" option. You can manually enter the account credentials or use the Browse… button to search for one. Once you have entered the correct credentials, click OK to save your changes. If the service is already running, it will need to be restarted by stopping and starting the service. If the service is not started, please start the service after configuring an administrative logon service account. Any issues can be investigated by looking in the windows event log.
There are certain directories and SQL tables that need to be monitored for growth along with the Email Plug-in for Reform. As a system processes more and more jobs, the size of these directories and SQL tables can grow very quickly. Overall system performance can be affected by the large amounts of space that the files may take up. Also, there exists a 10GB database limit if using the Microsoft SQL Server Express supplied with this installation. Obsolete files/database entries should be deleted according to your needs and file retention specifications.
Please see the Reform Health Monitor and Maintenance Utility section in the Reform User Manual for more information and instructions for monitoring and maintaining your server. It is recommended to monitor the following directories and SQL tables for growth:
Q: The SMTP server cannot be reached.
A: The first thing that you should do if you are not receiving emails is test to see if the SMTP server is functioning properly and can be reached from the Reform server. Telnet, which may not be installed by default on all systems, can be used to verify connectivity. If installed, go to Start > Run, enter cmd, and press OK. In the command prompt, type:
telnet <your smtp server here> <your SMTP server’s port>
telnet mail.yourcompany.com 25 (the default SMTP port, used for this example) and press
Enter. You should see a connection established message in the command prompt, similar to the one below:
If you cannot connect to your SMTP server on your SMTP server’s port, then the server is not reachable from the Reform server, and as such, the email will not be able to be sent.
Q: The SMTP server is rejecting my authentication username/password.
A: Be sure that the username and password are entered correctly on the form. To do this, open up your form in the VDP Designer. Click on the
EMAILUSERNAME field. If the text needs to be edited, go to the
object properties section and select the
text property. This will allow you to enter the text value for the field. Enter the correct text. (You can also, right-click on the
EMAILUSERNAME field and select
edit text in the drop down menu.) Follow the same procedure for the
EMAILUSERPASSWORD field. Once done editing save the changes to the form in the VDP Designer.
Q: Where can I view the Exchange 2003 webmail interface?
A: The URL is
http://<EMAILSERVERNAME>/Exchange/. This will prompt you for a username and password. You can also try
http://<EMAILSERVERNAME>/Exchange/ <EMAIL or USERALIAS>/.
- Use the full email address, such as:
Q: Nothing is happening after the form is processed. How can I determine the cause of an issue?
A: Check the Event Log for errors related to Reform or the Reform Email Service. The Event Log can be access by going to
Control Panel > Administrative Tools > Event Log. This will usually give you a good idea about why the emails might be failing.
Q: Emails are not being received; no authentication is required on my SMTP server.
A: Check the relay settings on your SMTP server to ensure the Reform server has the appropriate permissions. Make sure that any fire/anti-virus software is disabled.
Email Issue Ticket
*User’s Name: ___________________________________ *User’s Login Name: ______________________________
*User’s Email Address: ____________________________ User’s Building: _________________________________
User’s Department: ______________________________ Support Contact’s Name: __________________________
Support Contact’s Email: __________________________ Support Contact’s Phone: __________________________
*Severity of Issue (Please check one):
□ 0 - Test environment (non-production)
□ 1 - Users are affected, but able to continue business
□ 2 - Users are affected and it is affecting business, other functionality is working properly
□ 3 - The software is not functioning properly at all – system outage
Number of Users Affected: _____________ List Each Users Login Name and Email ________________________
*Description of Issue: __________________________________________________________________________________________________
*Observations about the issue:
Frequency of Issue: Once / Random / Every Attempt / Other (Please Describe): __________________________________
First Occurrence (Date/Time): _____________________ Latest Occurrence (Date/Time): _________________________
- *Issue is occurring at (Fill in all fields for MFP, Reform Server, Workstation and Email Server):
- Reform Server(s)
Reform Server IP(s): ______________________________________________________________________________
- Email Server
Email Server Name or IP: _______________________ Email Server Type: Exchange 2003 / 2007 / 2010 / SMTP
* Additional Information
*Have any changes been made to the Reform Server or Environment? yes / no If yes, What? When? By Who?
*Is the user able to send emails from their workstation to someone on the Domain? yes / no Off the domain?
yes / no If no, please explain _________________________________________________________________________
*Is the user able to send emails from MOST on an MFP or workstation to someone on the Domain? yes / no Off the
domain? yes / no If no, please explain ______________________________________________________________
If emailing speed is an issue, please list the time it takes for the email to be delivered: _________ seconds / minutes
Additional information when using the MOST Plug-in with Reform
- MFP (If using the MOST Plug-in for Reform from an MFP)
Number of MFPs Affected:_______________________
MFP Java Version:______________________________ MOST Version: __________________________________
MFP Serial #:__________________________________ MFP IP: ________________________________________
MFP Model #: _________________________________ MFP Location: ___________________________________
- Workstation (If using the MOST Desktop Plug-in for Reform from a workstation)
Number of Workstations Affected: ________________ Workstation OS: XP / Vista / 7
Workstation IP: ________________________________ Workstation Name: _____________________________
* Fields are required