1. Email Mail Merge for Lotus Notes and Excel User Guide
Author: Gavin Bollard, 19 May 2011
Reviewed: David Turner, 03 July 2013, for release 1.4
MailMerge Excel to Notes Project (OpenNTF)

2. Contents Part 1: Creating the Mail Merge
Part 2: Sending the Merge Files

3. Part 1: Creating the Mail Merge
To do a merge, you’ll need;
A Lotus Notes template (draft).
An Excel spreadsheet containing merge data.
Based on the template, the Create Mail Merge script will draft new documents for each data row in the chosen Excel spreadsheet.
All standard fields, body, attachments and styling will be copied from the template to the new drafted documents.

4. Creating the Email Template
In Lotus Notes, create a new Mail Memo to use as a Mail Merge Template.
Leave the Address details blank but you can put a Subject in to easily identify it.
The Subject will be overwritten assuming this is provided in the spreadsheet (recommended).
In the body, type a search-replace ‘token’ in uppercase and square brackets (e.g. [SURNAME]) whenever you want to include a field from your spreadsheet.
When finished, click Save as Draft.

5. 1. Sample template including a range of ‘tokens’ to replace in the body. Tokens are typed in square brackets and uppercase (e.g. [SURNAME]).
2. Include any delivery options, flags, or additional mail options, and set any other fields you want to copy to new drafts. Don’t include any recipient addresses. Addresses and the Subject and other standard fields will be overwritten if you provide them in the spreadsheet.
3. Save as Draft only. 3. 2. 1.

6. Creating the Spreadsheet
Start Excel and create a spreadsheet of data with a header row.
Ensure the header row and first column of the spreadsheet do not contain any blank cells.
To customise documents for each recipient, include the recommended special headers:
To – SendTo address field
Subject – Subject field
Cell values under any of the special headers will overwrite the standard fields.

7. Creating the Spreadsheet
Optionally include any other specially supported headers mapped to fields:
Cc – CopyTo address field
Bcc – BlindCopyTo address field
Reply To – ReplyTo address
Attachments – Filenames to attach to the top of the
Attachment files must exist and be readable on file system or a warning will be raised. A file list can be line-feed (char-10) or pipe-separated (|), and it supports wildcards (*).
Multiple-recipients for a field can also be provided, separated by a line-feed (char-10) or pipe (|) character.
And add any extra columns of data you want to include in your body text.
Use any Excel cell formatting (e.g. percentages, dates, currency), but cell fonts, styles, or colours are not copied. You can also use cell formulas.
Save your spreadsheet.

8. 1. 2.
1. Sample spreadsheet includes ‘To’, ‘Subject’ and ‘Attachments’ special headers. Plus a range of custom headers.
2. Includes data relating to each recipient.
3. Also showing sample files to be attached. 3.

9. Creating the Merged Emails
Open your drafts folder and select (click on without opening) your new .
From the Notes Menu, select;
Actions, Mail Merge, Create Mail Merge

10. Create Merge - Intro
A dialog will be displayed, identifying the draft template you selected, release number and a brief User Guide.
Click OK.

11. Create Merge - Spreadsheet
Select your Mail Merge Excel spreadsheet file.
Click OK.

12. Create Merge - Validation
The script will validate the template against the spreadsheet to identify any missing tokens or headers. You will be warned about any missing tokens.
It confirms the number of draft documents which will be generated (corresponding to records in the spreadsheet).
Note the provided Batch ID, you will need this to send the s as a batch later.
If all looks as it should. Click OK again to begin generating files.

13. Create Merge - Progress
The mail merge operation will then go and create draft s. The Notes status bar will update as it proceeds.
Any errors or warnings will be displayed in a dialog. For example, this one relating to an attachment file which could not be found.
An Error prevents a draft from being saved, continuing from the next draft in the batch. A Warning will continue the draft and batch.
If required, your Notes Administrator can assist by viewing the agent log in your mailbox.

14. Create Merge - Complete
The mail merge operation will complete and show a summary processing status, with a reminder of the batch ID number.
You will then want to validate the drafted s.

15. View Your Drafts Your drafts should appear in the drafts folder.
You can view, edit, delete or send them just like normal .

16. Check an or Two
Be sure to do a few checks before sending your s.
You’ll see that your fields have been filled in.

17. Check an or Two
Be sure to do a few checks before sending your s.
You’ll see that your fields have been filled in.
If specified, multiple attachments are appended at the top in a collapsible section.

18. Part 2: Sending the Merge Files
You don’t actually have to do this part.
You can send your drafts individually, just like normal s.
But it’s easier to send in a batch.
You can choose to either:
A: send all drafts, or
B: only selected drafts.

19. A: Send All Process From the Notes Menu, select,
Actions, Mail Merge, Send Mail Merge.

20. B: Send Selected Process
In your Drafts folder, select the mails you want to send (or you can select all).
Drafts which don’t contain the merge ID won’t be sent.
From the Notes Menu, select,
Actions, Mail Merge, Send Selected Mail Merge.

21. Send Mail - Enter Batch ID
The merge will prompt you for the ID number you wrote down earlier.
It will usually guess it right based on your selection or the previously created batch.

22. Send Mail - Confirmation
The last dialog will be displayed telling you how many s it found with the Batch ID you used.
If you are ready to send the s. Click Ok.

23. Send Mail - Completed
Similar to the Create process, the status bar will refresh as sending proceeds.
At the end of the process, a final dialog will confirm how many were sent and whether there were any errors.
Click Ok when done.
Successfully sent docs will move from Drafts, into the Sent folder.

24. What it Looks Like
It looks better through Lotus Notes clients, but otherwise just looks like a normal .
Here’s my Gmail test.
If required, your Domino Admin can support HTML format (see Installation Guide)

25. Credits A big thank you to:
David Turner and Sacha Chua for developing such a great utility.
Niklas Heidloff and others on the OpenNTF team for supporting and hosting this project.
Gavin Bollard for initially writing this User Guide.
Thanks those that rate, review and leave feedback on this project!
MailMerge Excel to Notes (OpenNTF)