Articles in this section

Troubleshooting Templafy web add-ins

Updated
Follow

About this article

This article is targeted towards client IT trying to troubleshoot issues regarding the Templafy web add-ins.

Please ensure that all of the following steps have been completed before escalating the issue.

 

Prerequisites

 
  • Successfully deployed Templafy web add-in (can take up to 72 hours)

 

 

 

Step 1: Confirm Requirements are Met

 

 

Step 2: Ensure Correct Library Web Add-in has been Installed by End-User

 

 

Step 3: Check Task Pane Behavior

Make sure to reproduce the error after enabling the settings / completing the reviews below.

 

Enable Mail Log Messages

When troubleshooting, enabling mail log messages will output certain events in the console log. Logging is enabled on a per-user basis. To enable the logging, open the Email Signature Task Pane by clicking on the Templafy Email Signature logo. Then, select Settings under the three dots in the top right corner and enable the setting.

 

Items.png

 

 
  • Mail log messages are only applied to new emails after the setting is enabled, so make sure to close the current email and start a new one before gathering the logs.

 

Review Console Logs

 
  • The below steps detail investigation into the Email Signature Web add-in. Reviewing the Console Logs and Network Communication should also be performed if there is an issue with Library Web Add-in, however, expect different requests.

From the Email Signature Task Pane, press F12 or right-click and select Inspect. Then, selecting the Console tab at the top will show generic console logs, logs generated by Templafy, and Microsoft Office logs.

For New Outlook, the console can be opened by starting Outlook with the following command:

olk.exe --devtools

 

Review Network Communication

Within the Inspect window, the Network tab contains many requests made by Microsoft, so filtering on the keyword templafy is suggested. Please look for the specific requests below:

  • runtime_settings - should return the list of Internal Domains for the customer. If the wrong domains or no domains are listed, make adjustments in Email Signature Settings section of your Templafy tenant.

Items.png

 

 

  • manifest.json - should return the list of all signatures that were synchronized (can be found under emailSignatureDescriptors). If nothing is returned, ensure the user has been assigned to a signature and trigger a new synchronization.

Items.png

 

If the issue cannot be resolved after the above steps are completed, please share the files gathered with Templafy Support.

 

Changing the User Profile Does Not Change the Signature

In this scenario, open the Email Signature Task Pane and review the Network communication requests:

  • manifest.json - should return the list of all signatures that were synchronized (can be found under emailSignatureDescriptors)
  • referencedImages.json - should return a series of images with base64 content. If some images are not visible in the signature, check the base64 content property. If the base64 cannot be converted to an image using an online tool, check the image in the tenant.
  • signature.html - should return the signature without rendered images. Check for the Preview and verify the signature.

 

Blank Templafy Task Pane

If a blank task pane appears, please refer to Step 1: Confirm Requirements are Met to ensure WebView2 was correctly installed/repaired. If that did not solve the issue, please continue with the following:

  1. In the affected Office application, click File --> Options
  2. Click Trust Center --> Trust Center Settings
  3. Click Trusted Add-in Catalogs and enable Next time Office starts, clear all previously-started web add-ins cache.
  4. Click Ok

 

Related articles

 

Related articles

Comments

0 comments

Article is closed for comments.