Reform Email for VDP

From FabSoft
(Redirected from Reform Email)
Jump to: navigation, search

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

Click Here


To install the Email Plug-in to your existing Reform installation, download and run the Reform-Email installation executable.

Reform Email 03.png

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.).

Pictogram voting info.svg.png  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).
  1. Open Reform VDP Designer. A shortcut can be found in the desktop folder \FabSoft Reform PDC\VDP\VDP Designer
  2. 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.
    Reform Email 04.png
  3. When it asks if you would like to open a text file for designing, select No.
  4. Next, go to File > Save to save your form. Name it Email.FOM.
  5. You can now close VDP Designer, since we have made our base form to start with.
  6. Open Workflow Designer. A shortcut can be found in the desktop folder in \FabSoft Reform PDC\Base\Workflow Designer.
  7. Once open, go to File > New...
    2019-07-30 11-32-30.png
  8. Select Document Automation and click Ok.
    Reform Email 06.png
  9. 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).
    Reform Email 07.png
  10. 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).
    Reform Email 08.png
  11. 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.
    Reform Email 09.png
  12. Now that the object has been added, we can configure it. To do so, right click on the object and select Configuration….
    Reform Email 10.png
  13. 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.out file which is located in the \Reform\Backups directory. Click the small folder icon to bring up a window which will let us choose that file. Select the file and click Open.
    Reform Email 11.png
  14. 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.FOM form file. Select the FOM file and click Open.
    Reform Email 12.png
  15. 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 Finish.
    Reform Email 13.png
  16. You will also be prompted to add a page-break field to the forms. At this point, we want to select No.
  17. To finish the Email workflow, we want to add an Email Output. We use the same drag and drop procedure as with the Form and File. Take your mouse and drag the Email object from under Output onto the workflow somewhere below your Input. Once you release your mouse, you will be prompted to describe Email. Type Email in the box and then click Finish.
    Reform Email 14.png
  18. Once you click Finish, you are taken back to your workflow. Your Email will have a red Caption because it is not yet configured. To configure Email, you must first connect the Form and File object titled Email Demo. To do so, first select the Add Connector button from the menu bar. Next, drag your mouse from the small x underneath Email Demo to the small x above Email as pictured below. When the connection is complete, the connecter will turn black (if red, connection has not been made correctly, try again) and the Email Demo caption will turn green.
    Reform Email 15.png
  19. You will be prompted to configure Email upon completing the connection. Click 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 File and click Next.
    Reform Email 16.png
  20. 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 Next.
    2019-08-06 09-03-40.png
  21. You are now prompted for the SSL Enabled. Please select True if SSL is enabled or False. Click the Next button to continue.
    Reform Email 19.png
  22. You are now prompted for the Port Number. Please enter the value for the Port Number. Click the Next button to continue.
    Reform Email 20.png
  23. 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 Skip.
    Reform Email 21.png
  24. 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 Skip.
    Reform Email 22.png
  25. 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 information button.
    Reform Email 23.png
    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.
  26. Now we want to use ContactPersonEmail as our Email From value. Select ContactPersonEmail from the list. You will have to scroll down to see it. Click Next.
    Reform Email 24.png
  27. 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 Next.
    Reform Email 25.png
  28. 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 Skip button.
    • Next, it will ask you to enter email addresses for Blind Carbon Copies. Click the Skip button.
    • Next, it will ask you to enter the Return Email Address. Click the Skip button.
  29. Next, it will ask for the email Subject. Select the object Remark. To select an object, first click Click here to select variable data and then the object list will be shown.
    • You will have to scroll down to see Remark. Click Next.
    Reform Email 26.png
  30. Next, it will ask for the file name of the attachment. Enter the value EmailBill. Click Next.
    Reform Email 27.png
  31. 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 data and then the object list will be shown. Select BillingNote from the list. Click Finish.
    Reform Email 28.png
  32. 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.
    Reform Email 29.png
  33. To make all the appropriate forms and changes, we must execute the workflow. This is done by clicking the Execute button
    Reform Email 30.png
  34. on the menu bar. After execution, you will be notified of the configuration that has taken place. Click OK.
    Reform Email 31.png
  35. 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.FOM file has been copied to the Workflow Designer Original Forms folder 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>
  36. 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 Start button.
  37. Navigate to your \Reform…\Backups\ directory. Select the Email.out file, right click the file, and select Copy.
    Reform Email 33.png
  38. 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.)
    Reform Email 34.png
  39. When the Spooler Application begins processing the file, you will notice the file name change to something similar to the image below.
    Reform Email 35.png

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.

For example:,,

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:

Mstsc 2019-07-30 14-04-06.png

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.
Pictogram voting info.svg.png  System Specific Fields: Some systems have fields that will need to be added manually. To add the fields manually, add a Design/Linked Text Object to the appropriate layer and rename the text object accordingly. For more information on the system specific field, please refer to the email system's respective section.

Common SMTP settings

Provider Server Address SSL Enabled Port
Gmail True 587
Office365 True 587 True 587
Yahoo Mail True 587
Pictogram voting info.svg.png   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 nvarchar(MAX).

Body Templates

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.

  <div>Order Details</div>
  <div>Account Number: |_Account|</div>
Pictogram voting info.svg.png  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 \Reform..\SendToScripts\Email.fbs
  • Find the following lines
If _EmailPDFFooter <> "" and _EmailPDFFooter <> "0" Then
    EmailPDFFooter = _EmailPDFFooter
    If _EmailFooter <> "" and _EmailFooter <> "0" Then
        EmailPDFFooter = _EmailFooter
        String EmailPDFFooter
        Email powered by Reform
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.

Reform Email 37.png

Navigate to the Log On tab. Here, you will need to set the local administrative service logon account.

Reform Email 38.png

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:


C:\Program Files\Reform…\Backups
C:\Program Files\Reform…\Spooler\ImageQueue
C:\Program Files\Reform…\Plug-ins\Email \Attachments

SQL Tables



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> 

Example: telnet 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:

Reform Email 39.png

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: http://server123/Exchange/

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.

Pictogram voting info.svg.png  Note:

Reform Email 40.gif

If the error above occurs, Try the following:
  • Go to Control Panel > Administrative Tools > Services.
  • Find RM_Email_Monitor.
  • Right click on RM_Email_Monitor<code>, then click <code>Properties > Log On and enter a different account (such as your Windows local administrator account).
  • Click Ok and restart the service.
You can also try logging into Windows as same service account.

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