• Reference Guide


This tool allows you to create a large number of e-mails and send them out to addresses stored in a table. The content of the e-mail can be based on a template and consequently made receiver-specific. E-mails are sent out by the installed e-mail client (Outlook etc). Depending on the e‑mail client configuration, the e-mails may not be sent immediately: they may be saved to an outbox and you will need to synchronize your e-mail in order to accomplish the sending. The tool is opened by the Tools|Mail Merge|E-Mail menu command.

Data Source for E-mails

The data source is a table. The template is applied to every row of the table, so the final number of sent e-mails is equal to the number of rows in the table.
Use active table
The table that was active when the tool was opened is used as the data source. If no table was active, you can activate it afterwards. If there is no active table, e-mails cannot be created.
Select table manually
The table is selected manually using the Object name of table and Data reference of table fields.
Active row/Selected rows
The tool produces only one e-mail based on the active row or e-mails based on the selected rows if there are some selected rows.
All rows
One e-mail is produced for every row in the table.
Object name of table
If the Select table manually option is selected, you can specify here the name of the object in which the table is located. Typically you will need to select the master identifier referencing the document affected by the tool (i.e. the document that was active when the tool was activated).
If the Use active table option is selected, information about the used table is displayed.
Data reference of table
Reference to a table within the specified Object name of table.

Message Header

Receiver type
You can specify whether the receiver is defined in the table (address from table) or whether there is one fixed receiver (fixed address).
The latter choice is useful if you wish to send only one e-mail (see the Active row option above).
If the receiver type is set to address from table, you can select a column where the e-mail address is stored. The listbox includes all String type columns of the selected table.
If the receiver type is set to fixed address, you have to type the address manually.
This text is used as the subject of the e-mails.

Message Template

The template in which you insert the text of the e-mail and fields that are replaced by data from the source table. You can use the buttons from the Table columns list to insert these fields. If necessary, all Enkidu language constructs are available. The message template is specified in a rich text editor. Although the Enkidu language producing formatted text is used, text formatting is not applied to the e-mail. The e-mail is sent as plain text.

Table Columns

If a table is correctly selected, a list of the table columns is displayed to the right of the message template. Every column is represented by a button. If you click a particular button, a field is inserted into the message template. The field will be replaced by data from the respective source table column.
Fields referencing table columns must be formatted as hidden, that is, their background is cross-hatched. If this format is accidentally applied to other text during editing, you can remove the formatting by the Ctrl+H keyboard shortcut; or you can remove all applied formatting by the Ctrl+spacebar keyboard shortcut.

Sending Mail and Saving Settings

Use the Send mails button to create the e-mails and send them out. The Save settings button allows you to create a new tool in the current document based on this general mail merge tool, but its definition reflects the current settings. This way you can create a specific tool allowing you to repeatedly produce bulk e-mails based on the same template.