Views:



MAIL MERGE DOCUMENTS

 

INTRODUCTION

One of the benefits of akoyaGO being built in Microsoft Dynamics 365 is how easily it integrates with other Microsoft 365 products. This document will walk you through how to create views that can be used to extract your data for use with mail merges in Microsoft Word.
NOTE: In past versions of Microsoft Dynamics 365, there was a built-in mail merge capability. This is no longer available as Microsoft has deprecated this feature.
In this document, you will be guided through:
 

CREATING A MAIL MERGE DOCUMENT

Start with a view.


We recommend creating a view for each Mail Merge document or letter that you will be sending. This step will only need to be done once for each letter. After the initial view is created, you can save it and use it again and again.

NOTE: Remember to create the view (or use an existing view) on the correct Entity so you can select all the data that you may need. For example, if you are sending gift thank you letters, and you want to include the Fund Name, you will need to build that view from the Gift Payments entity. If you started on the Gift entity, you won’t have access to the information that is only on the Gift Payment record.

Once you’ve decided which Entity you will create the view on, you will need to decide on the criteria to pull the records needed for your letters. Remember, you can always start from a saved view that already has some or most of the criteria that you will be needing.

If there isn’t a saved view with the criteria that you need, you will have to build your own. Remember that criteria are used to filter your data for the specific records that you will need for your letters. You’ll Edit Columns to select the fields you will want to merge into your letter or document.

Once you have the view created, we recommend naming it the same name as the letter or document you will be merging the information to in Microsoft Word, for example – Gift Thank You Letters or Scholarship Award Letters. This will save your view as a personal view.


Next, you will want to Edit Columns in your view to add the fields you will need to merge, and to remove those that you won’t be using. You can also reorder them if you like to make it easier for viewing and selecting merge fields when working in Microsoft Word. Columns can be moved by clicking and dragging to the order needed.



(For more information on personalizing views, please see our “Managing Views” knowledge article, found on the GOsupport portal.)


Since the view you just created is a personal view, you may also want to share it with team members who will be may also be working on the merged documents or letters.

 

EXPORT YOUR VIEW


You can start here if your view has already been created.

Locate the view in akoyaGO for the letter or document you want to create and then click on ‘Export to Excel.’ This should give you the data you need to merge into a Microsoft Word document. If you do use the drop-down arrow to select your export option, please use the ‘Static Worksheet’ selection. The spreadsheet will then download into the folder that you have set up for downloads on your computer.

A few key things to remember which will make your merge process easier.
  • Once the Excel document is downloaded to your device. Open it and make sure you take it out of the “Read Only” format and save it. It will not merge into Word if you don’t complete this step. You may receive the following error when you open it. If so, press ‘OK.’

(You may need to "allow macros," which can be done through MS Word's Trust Center)




 
  • Save the Excel spreadsheet with the same name as your view, for example, “GiftThankYouLetter.xlxs.” By keeping the Excel spreadsheet name the same each time you create it, the data source will remain the same in your related Word mail merge document, so you won’t have to select a data source each time you create letters or documents.
  • It is also best practice to keep your Word and Excel documents in the same location on your device each time you run the mail merge so that it processes quickly and easily without you having to locate where the documents and spreadsheets are stored each time you run them.



 

CREATING YOUR MAIL MERGE DOCUMENT IN WORD


If this is the first time you are pulling the data down from akoyaGO, you will need to set up your Word document to pull in the fields correctly. For instructions on how best to configure your mail merge, please see this Microsoft Support article.
You will also need to insert Switch Formatting for two key fields: Date and Currency. The formulas for what that should look like are listed in the Appendix: Insert Switch Formatting of this white paper.
If you have already completed this step, you can go to the next section.

 

RUNNING YOUR LETTERS


After you have everything set up: created a view in akoyaGO, exported the data to Excel, and configured your letter or document, you can complete your Mail Merge. Please see this Microsoft Support article if you need any assistance on the mail merge process.

APPENDIX: INSERT SWITCH FORMATTING


The SWITCH function in Microsoft allows you to find a value and convert it to the format that you would like to show in your documents and letters. For example, if your Excel value for currency shows as 1000, it will automatically convert it to $1,000.00 in the letter or document on merge when you insert specific code. When merging data created in akoyaGO from Excel to Word, you will need to add Switch Formatting to two key fields: dates and currency.


The formulas to use are:

Data TypeSwitch StatementExample 
Currency with decimal{ MERGEFIELD FieldName \# $#,##0.00 }$1,000.00
Short date{ MERGEFIELD FieldName \@ “MM/d/yyyy” }12/25/2005
Long date{ MERGEFIELD FieldName \@ “MMMM d, yyyy” }December 25, 2005
     

The following example shows how to format the Decision Date field to use Short Date to convert the values which are contained in your Excel spreadsheet.
                                               

If necessary, here are a few other Switch Format codes that you could use.

 
Data TypeSwitch StatementExample
Capitalize first letter of each word{ MERGEFIELD FieldName \* Caps }Capital Campaign
Capitalize first letter of first word{ MERGEFIELD FieldName \* FirstCap }Capital campaign
All Caps{ MERGEFIELD FieldName \* Upper }CAPITAL CAMPAIGN
All lower case{ MERGEFIELD FieldName \* Lower }capital campaign
Currency without decimal{ MERGEFIELD FieldName \# $#,##0 }$1,000
Currency with decimal{ MERGEFIELD FieldName \# $#,##0.00 }$1,000.00
Short date{ MERGEFIELD FieldName \@ “MM/d/yyyy” }12/25/2005
Long date{ MERGEFIELD FieldName \@ “MMMM d, yyyy” }December 25, 2005
Month only{ MERGEFIELD FieldName \@ “MMMM” }December
Long date with time{ MERGEFIELD FieldName \@ "MMMM d, yyyy', at' h:mm" }December 25, 2005m
at 11:30