Word Merge Troubleshooting

From SmartWiki
Jump to: navigation, search

This article outlines some common issues encountered when implementing SmartSimple's Word Merge functionality and their resolutions.


Issue:

  • Clicking the button to generate the MS Word Merge causes a browser window or tab entitled SmartSimple MS Word Merging to open, but does not open (or prompt you to open) the MS Word document.

Solution:

  • Add the following to your list of "Trusted Sites" within your browser:
http://msword.smartsimple.biz/

Cause:

  • Depending on your browser's security settings when you generate a MS Word Merge document it will either open the document, or prompt you before opening document. If you have disabled the warning messages the browser may simply not open the file without prompting you. Adding the above URL to your trusted site list will allow it to open anyway. Alternately, you can reset your browser's security settings.

Issue:

  • The variable name (i.e. @variable@) is displayed on the MS Word document.

Solution:

  • On the MS Word Merge field in the Values section include <!--hideifnotfound--> in front of any variables that may not be present to ensure nothing is displayed, rather than the variable name.

Cause:

  • If a variable is not found, the @variablename@ is not able to be converted to stored data, so is displayed on the MS Word Merge document exactly as written. This can happen if the associated Custom Field is on a different Template or Type.

Issue:

  • Using sslogic within an MS Word Merge custom field results in a missing custom field in the Field List View.

Solution:

  • The following syntax will resolve the issue. You must include an return/enter line at the end, as well as including a duplicate of the variable name immediately following the sslogic condition.
<!--@sslogic(',@client.categoryids@,' regexp ',1853,'>'0')-->
companyName=@client.name@;
companyName=@client.name@;
companyAddress=@client.address@;
<!--@end-->
<!--@sslogic(',@client.categoryids@,' regexp ',1853,'<'0')-->
companyName=@client.parent.name@;
companyName=@client.parent.name@;
companyAddress=@client.parent.address@;
<!--@end-->
<newline at the end>

See Also

To set up a Word merge:

Advanced Word Merge Features Include: