Tip #716: Conditional values in Word templates

Flying pig thumbnailWord templates introduced in CRM Online and CRM 2016 are not the easiest contraptions to edit. One of the questions that popped up in a recent conversation was how to use conditional IF in the document generation.

tl;dr

To refer to the control values after the document has been generated, wrap content controls using bookmarks defined at the control container level.

Longer

CRM fields are defined as Content Controls and in theory we could have written some simple VBA using ContentControl object. Except that CRM does not play nice when generating the document and simply replaces all content controls with the record values.

The solution is to wrap the content controls using the bookmarks defined at the container level, i.e. cell, row, paragraph, etc. Then this bookmark can be used as a reference in a conditional expression of the IF field.

For example, to insert conditional text depending on the total invoice value:

  1. Extract the Invoice template that comes with the sample data and save it under a different name.
  2. Open the template, find total amount, select the entire table cell and click Insert > Bookmark.
  3. Type totalbookmark as a bookmark name, click Add.
    Insert bookmark
  4. Delete the words “Thank you for your business” and click Insert > Quick Part > Field.
  5. Select IF field and type the following field code:
    IF totalbookmark > 100 “Thank you for you business!” “Thanks for nothing!”
  6. Click OK. Hint: to see and edit field codes in the document, press Alt-F9.
  7. Save the file and upload to CRM as a new template.
  8. Create an invoice and generate the invoice document.
  9. Enable document for editing, press Ctrl-A to select the entire content and press F9 to refresh the field content
  10. Depending on the total value of the invoice, the document will say “Thank you for your business!” or “Thanks for nothing!”
    Conditional values in the template

It’s not a full automation that potentially could be improved with some VBA (I’m not 100% sure if it will work) but it’s a step in the right direction and a cheap way to add some pizazz to your documents.

Tweet about this on TwitterShare on Facebook7Share on Google+2

3 thoughts on “Tip #716: Conditional values in Word templates

  1. Edwin says:

    Has anyone gotten this to work without having to execute step 9

    “Enable document for editing, press Ctrl-A to select the entire content and press F9 to refresh the field content”

    This is a great tip, but the functionality would be complete if conditional text can be presented in a document if you did not have to refresh the field content.

    Thanks!

    • Edwin,

      that would indeed complete the functionality, however, automatic field updating requires macros. Latest versions of Word do not support saving macros in docx files, only docm and you will not be able to upload this type of files to CRM. And, in general, macros are evil 🙂

      Cheers
      George

  2. I guess the real tip of the day here would be to look for a good third-party add-on if you want to insert conditional content in a Word template. XperiDo probably has the most user-friendly template design add-in for Word to set conditions.

Leave a Reply

Your email address will not be published. Required fields are marked *