About this article
This article holds all the release notes releases related to the Templafy Desktop Client. You can use the index below to jump to the relevant section.
Technical information
|
|
Templafy Hive
Released to Insider in May 2022
Templafy Desktop Client 3.4.27
Enable Nullable Reference Types in Templafy Desktop
This is a technical release to enable nullable reference types in our code.
Templafy Desktop Client 3.4.26
Disable Login in Templafy Desktop
This release allows disabling the automatic login process (without user interaction) in Templafy Desktop by means of the registry string value DisableAutomaticLogin under the registry key HKEY_CURRENT_USER\SOFTWARE\Templafy\Desktop. In order to disable the automatic login the registry value should be set to "true".
Templafy Desktop Client 3.4.25
Use http headers to send Templafy Desktop tracking instead of passing the values through the query string
This is an internal technical release with no user-facing changes
Released to Insider in April 2022
Templafy Desktop Client 3.4.23
Unhandled exceptions from plugin should be displayed correctly in the Templafy.Desktop log
Implemented correct handling of unhandled exception that can happen in the plugin, so that the user see the necessary information in the log.
Templafy Desktop Client 3.4.22
Use Translator in Templafy.Desktop UI
This release contains adding translation support to Templafy Desktop and using it instead of hard-coded texts.
Templafy Desktop Client 3.4.21
Templafy Desktop settings UI in ServerMode is not responsive
This release fixes an issue with Templafy Desktop buttons in the UI not working in servermode
Templafy Desktop Client 3.4.17
.NET Framework version lookup
Templafy desktop client only looked in the 64bit registry when looking for the .NET Framework version. This release ensures we are looking up the version of the dot net framework both in the root path and in the WOW6432Node part of the registry.
Released to Insider in March 2022
Templafy Desktop Client 3.4.9
Fix ClientCertificateRequested in Templafy Desktop
This release ensures the WebView2 browser will automatically pick the certificate if only one certificate is available when the site requests a certificate from the browser.
Why: Templafy Desktop previously did not support an event in WebView2 that would query the respective certificate on behalf of the user and therefore prevent the certificate selection dialog prompt.
How: By handling the respective event in WebView2, login can succeed without user's interaction (quietly).
Released to Insider in February 2022
Templafy Desktop Client 3.4.7
Add unit test for TrackingUploader
Technical release that adds unit test for Tracking Uploader to Templafy Desktop. This release does not introduce any user facing changes.
Templafy Desktop Client 3.4.6
Verify the plugin dlls are signed
Before loading the plugin Templafy Desktop is now verifying that the plugin DLLs are correctly signed
Released to Insider in January 2022
Templafy Desktop Client 3.3.2
Fixing an issue in Templafy Desktop uninstaller not removing all the files installed by the client
Templafy Desktop Uninstaller was not removing all installed files because of missing assemblies. This release fixes that problem.
Released to Stable in December 2021
Templafy Desktop Client 3.3.0
Introduce retry mechanism in seamless SSO flow in Templafy Desktop
This release adds a resilience mechanism to Templafy Desktop's SSO login flow by retrying the SSO login request in case of failure.
This feature has been added in the attempt to address issues that have been reported in different tenants, where some of their users would be presented with the 'Access Templafy' login dialog due to SSO login failure. The tenants that reported the issue, would in most cases have some network infrastructure component (VPN, DNS proxies, ...) that could impact network access during user session startup which can consequentially impact the SSO operation.
The number of retry attempts (defaults to 5) and the interval between retry attempts (defaults to 2 minutes) used in the retry mechanism are configurable under the registry key HKEY_CURRENT_USER\SOFTWARE\Templafy\Desktop with the following entries:
AuthenticationFailureRetryAttempts: Integer - the number of retry attempts
AuthenticationFailureRetryInterval: Integer - the number of minutes between retry attempts.
Please note that these keys are not automatically created and have to be added manually in order to change the default settings.
Released to Insider in November 2021
Templafy Desktop Client 3.3.0
Introduce retry mechanism in seamless SSO flow in Templafy Desktop
This release adds a resilience mechanism to Templafy Desktop's SSO login flow by retrying the SSO login request in case of failure.
This feature has been added in the attempt to address issues that have been reported in different tenants, where some of their users would be presented with the 'Access Templafy' login dialog due to SSO login failure. The tenants that reported the issue, would in most cases have some network infrastructure component (VPN, DNS proxies, ...) that could impact network access during user session startup which can consequentially impact the SSO operation.
The number of retry attempts (defaults to 5) and the interval between retry attempts (defaults to 2 minutes) used in the retry mechanism are configurable under the registry key HKEY_CURRENT_USER\SOFTWARE\Templafy\Desktop with the following entries:
AuthenticationFailureRetryAttempts: Integer - the number of retry attempts
AuthenticationFailureRetryInterval: Integer - the number of minutes between retry attempts.
Please note that these keys are not automatically created and have to be added manually in order to change the default settings.
Released to Insider in October 2021
Templafy Desktop Client 3.2.7
Add workaround for issue related to WebView2 runtime in Hive and One
This release adds a workaround for WebView 2 95.x runtime issue as suggested by Microsoft. https://github.com/MicrosoftEdge/WebView2Feedback/issues/1860. In a similar manner, the same workaround has been added for Templafy One Desktop Client 2.5.93
Templafy Desktop Client 3.2.6
Update WebApp and CompositeUI to react 17 for Templafy Desktop
This release updates React and react-related packages in Templafy Desktop UI to version 17.
Templafy Desktop Client 3.2.5
Serialisation issue in Templafy Desktop logs
This release fixes an issue with returning incorrect response messages on unauthenticated requests.
Templafy Desktop Client 3.2.4
Implement the POC
This release allows Templafy Desktop Client to install packages from disk, effectively allowing an offline installation. This installation mode is triggered by setting HKEY_LOCAL_MACHINE\SOFTWARE\Templafy\OfflineInstallationEnabled = true. The packages and necessary registry entries are packaged into an offline MSI which is currently created manuallyy.
Released to Stable in December 2021
Templafy Desktop Client 3.3.0
Templafy Desktop Client promoted to version 3.3.0
Released to Stable in November 2021
Templafy Desktop Client 3.2.4
Introduce retry mechanism in seamless SSO flow in Templafy Desktop
This release adds a resilience mechanism to Templafy Desktop's SSO login flow by retrying the SSO login request in case of failure.
This feature has been added in the attempt to address issues that have been reported in different tenants, where some of their users would be presented with the 'Access Templafy' login dialog due to SSO login failure. The tenants that reported the issue, would in most cases have some network infrastructure component (VPN, DNS proxies, ...) that could impact network access during user session startup which can consequentially impact the SSO operation.
The number of retry attempts (defaults to 5) and the interval between retry attempts (defaults to 2 minutes) used in the retry mechanism are configurable under the registry key HKEY_CURRENT_USER\SOFTWARE\Templafy\Desktop with the following entries:
AuthenticationFailureRetryAttempts: Integer - the number of retry attempts
AuthenticationFailureRetryInterval: Integer - the number of minutes between retry attempts
Released to Stable in August 2021
Templafy Desktop Client 3.2.3
Seamless SSO fails sporadically
We have reports of seamless single sign-on failing in Templafy Desktop. Unable to reproduce this problem this release changes the order of execution for the browser navigation which will hopefully make the flow more reliable.
Templafy Desktop Client 3.2.2
Add and delete autocorrect terms for all the languages
Autocorrect terms from ProductivityManagement will now be added to all languages present on the users machine, when Templafy Desktop checks for updates.
Released to Stable in July 2021
Templafy Desktop Client 3.2.1
Desktop Uninstall taking a long time to complete
This release reduces Templafy Desktop uninstallation duration from more than 10 minutes to +- 1 minute when files to be deleted by the uninstall (Webview2 temporary files) are locked by an Office application, which caused the uninstallation process to span for a long time. This is due to the number of files (around 100 files) being locked by an Office application using Webview2 for which the uninstall process tries to delete.
Templafy Desktop Client 3.2.0
Network Throttling for package download
This release adds network throttling support to Templafy desktop updates by requiring the Templafy desktop client to first acquire a download slot before performing the update process. This ensures every tenant to have a maximum number of simultaneous Templafy desktop update operations (250 per tenant and 50 per IP Address).
Templafy Desktop Client 3.1.40
Update Templafy Desktop
Only the terms that have enable autocorrect activated will be added to the auto correct dictionary
Templafy Desktop Client 3.1.37
Startup files not being distributed via Templafy Desktop 3.x (same problem as for 2.5.x)
We identified a problem on client version 3.1.x that resulted in failures installing packages that contain the WordStartUp or ExcelStartUp entry. This releases fixes that problem
Released in June 2021
Templafy Desktop Client 3.1.36
Error on decoding jwt in Templafy Desktop
We identified an issue authenticating users for Templafy Desktop with specific claim values. Certain claim values resulted in an encoded authentication token that can not be directly decoded from base64 because in addition the token itself is also url encoded.
Templafy Desktop Client 3.1.35
Handle the new format of Corporate terminology with reasons in TemplafyDesktop
ProductivityUpdater in the TemplafyDesktop can now read the new format of the corporate terminology.
Templafy Desktop Client 3.1.34
Add terms to the MS Office Autocorrect
We have now implemented support of AutoCorrect. The Update handler for the Productivity writes terms to the AutoCorrect by using MS Word Interop API.
Templafy Desktop Client 3.1.33
Handle the deletion of custom terminology correctly
Implemented correct deletion of the terminology from the local user dictionary when some or all of the terms are deleted from the registry. Also making sure that we completely delete the local configuration file when it's empty.
Templafy Desktop Client 3.1.32
Implement post-update runners in Templafy Desktop
This version adds support for Admin configured corporate terms in Productivity area to be synced to Office applications dictionary when updates are synced to Templafy Desktop.
Released in May 2021
Templafy Desktop Client 3.1.31
Templafy Desktop Client 3.1.26 doesn't show installed modules after install
This release fixes the issue introduced in version 3.1.26 where on a new Templafy Desktop Host installation after updates are downloaded the downloaded modules would not be presented under the Modules tab.
Templafy Desktop Client 3.1.30
Multiple instances of Templafy Desktop login page
We identified an issue where a new login window would show on the next check for updates even when an active login window was still open.
This problem has been resolved by adding a check to look for the active login window and show the active window instead of creating a new window.
Templafy Desktop Client 3.1.29
Fix SonarCloud Failing, Security Hotspots and Code Smells Templafy Desktop
We added a security update to guarantee the uninstall process uses the cmd.exe from specific directory instead of relying on PATH environment variable.
Templafy Desktop Client 3.1.27
Copy the ClientVersion registry key from HKLM to HKCU in server mode
Templafy desktop now copies the ClientVersion from HKLM to HKCU to support the check for hive in the office add-ins. This will enable the office add-ins to work on hive in server mode
Templafy Desktop Client 3.1.26
Install server mode packages
Show installed server modules in the modules tab
Closed
Templafy Desktop is able to install packages when installed by administrators using ServerMode installation parameter.
When installed in server mode, Templafy Desktop converts enabled add-ins and installs them into %ProgramData%. In a similar manner as in Templafy One, HKCU keys will be converted to HKLM.
Server mode currently supports installation of the following add-ins: Library, Check&ProductivityPlus and EmailSignature.
Once the installation completes, installed packages will be displayed under the Modules tab of Templafy Desktop.
Templafy Desktop Client 3.1.25
Use the endpoint to install the package
Templafy Desktop is now able to retrieve and install ServerMode packages.
Templafy Desktop Client 3.1.24
Add-ins installed in server mode are being entered under incorrect registry key
Templafy Desktop will now configure the add-ins correctly in Windows registry when running in server mode, allowing the add-ins to be opened successfully in Office.
Released in April 2021
Templafy Desktop Client 3.1.23
Make Templafy Desktop download Delta packages when available (Hive)
Templafy Desktop Client will now correctly use the delta package URL to download updates instead of always using the full package URL.
Templafy Desktop Client 3.1.22
Templafy Desktop does not parse the multiline string correctly
Templafy Desktop will now format multi-string registry values correctly when updating the Windows registry.
Templafy Desktop Client 3.1.21
Templafy Desktop will never update Add-ins if Outlook is configured to auto-start
We identified an issue where the package update for Templafy Desktop could fail if any Office Application was running with a recent version of the Templafy Add-ins installed. This happened because the Add-ins were locking certain files that Templafy Desktop was trying to update.
This problem has been resolved by automatically renaming the files that are locked and adding them to the list of files installed during the update. The file will get a random suffix in the name and the extension of the file gets renamed to ".bak". If the Office Application restarts it will release the lock on this renamed file and then it will get removed on the next package update for Templafy Desktop.
Released in March 2021
Templafy Desktop Client 3.1.18
Templafy Desktop fails to update when package has Office startup files
This release fixes the issue where a Desktop Client update containing packages with Office applications' files would fail. New updates containing Office applications' files will complete successfully.
Templafy Desktop Client 3.1.17
Templafy Desktop fails to update when Office is running
This release fixes the issue of Templafy Desktop failing to update when Office is running. The user will now be notified of applications that need to be closed in order for the update to succeed.
Templafy Desktop Client 3.1.15 + 3.1.16
415 (Unsupported Media Type) when uploading tracking data from Templafy Desktop (Hive)
This release removes the sending of tracking data from Templafy Desktop, which is currently unsupported in Templafy Hive.
Templafy Desktop Client 3.1.14
NullReferenceException when Templafy Desktop 3.1.13 updates
This release fixes an issue introduced in the previous release for Templafy Desktop.
Templafy Desktop Client 3.1.13
Implement proxy bypass list from registry
This release makes it possible to configure a proxy server and proxy bypass list to be used by the browser component that is embedded in Templafy Desktop.
The following registry key entries are now optional:
- HKEY_LOCAL_MACHINE\SOFTWARE\Templafy\ProxyIsEnabled
Type: REG_SZ
Default: false
"( false | true )"
When this is set to 'true' it enables configuring a proxy server. Without configuring any other related registry keys the proxy server will be resolved from the Operating System by checking what proxy server is used for the tenant url configured for Templafy Desktop. This however does not support a proxy bypass list.
- HKEY_LOCAL_MACHINE\SOFTWARE\Templafy\ProxyServer
Type: REG_SZ
Format: "<domain/ip>:<port>"
When ProxyIsEnabled is set to true, this setting overrides the system configured proxy settings and use this proxy server on all requests issued by the embedded browser component (WebView2).
- HKEY_LOCAL_MACHINE\SOFTWARE\Templafy\ProxyBypassList
Type: REG_MULTI_SZ
Format: "<domain/ip1>;<domain/ip2>"
Domain/IP range must follow Java's convention by using the wildcard characters '*' as suffix or prefix.
Example: "192.168.202.* ;*.yourdomain.com"
When ProxyIsEnabled is set to true the resolved Proxy Server will not be used for these addresses.
Released in February 2021
Templafy Desktop Client 3.1.11
Add support for font distribution in server mode for hive
We added a fix for font distribution in server mode when server mode and third-party-add-ins are available in hive
Templafy Desktop Client 3.1.10
Templafy Desktop 3.1: Unable to fetch the update
When building the new package for Templafy Desktop to download and install we will now ignore the casing of file paths inside the package.
Templafy Desktop Client 3.1.9
Blank titles for installed modules in Templafy Desktop UI after update
We solved an issue where clicking "Check for updates" in the settings UI would clear the list of installed add-ins.
Templafy Desktop Client 3.1.8
Templafy Desktop Client 3.1 does not refresh entire settings UI after update completes
We identified an issue where the settings UI was not properly refreshed after package update. This has now been resolved, and all the settings should now reflect the correct state after the update is completed.
Templafy Desktop Client 3.1.7
Update Templafy Desktop Client 3.1 to WebView2 1.0.705.50
We have updated the WebView2 library to version 1.0.705.50, which includes a new native cookie manager.
This made it possible for us to remove some custom workarounds from the previous versions, where native cookie support was not available.
Templafy Desktop Client 3.1.5
Templafy Desktop Client 3.1 defaults to TLS 1.0 on Windows 7
We have identified an issue when Templafy Desktop runs on Windows 7.
By default Templafy Desktop will use the system default TLS version, which on Windows 8, 8.1 and 10, will automatically select TLS 1.2 or greater.
On Windows 7 the system default is TLS 1.0, in which case we are now explicitly enabling TLS 1.2.
Templafy Desktop Client 3.1.4
Missing information in the log when starting client 3.1 if WebView2 in not installed
We fixed an issue where a missing WebView2 Runtime version was logged as an empty string.
Also, when no authentication method is explicitly set in the registry, we no longer write the redundant log entry "Authentication method: not set".
Released in January 2021
Templafy Desktop Client 3.1.3
Templafy Desktop Client 3.1 not able to connect to websiteWhen Templafy Desktop Client 3.1 is started from Host 2.2, the default TLS protocols are insufficient for accessing Templafy Hive.
To solve this, we now make sure, if the client is started from a host version below 3.0, the default TLS version is set to TLS 1.2.
Templafy Desktop Client 3.1.2
Templafy Desktop Client 3.1.1 seamless SSO never times out
An issue with Seamless Single Sign-On caused the process to be stuck and never time out.
This would affect users that didn't authenticate using SSO or where the seamless SSO couldn't complete (e.g. email authentication).
Templafy Desktop Client 3.1.1
Templafy Desktop Client 3.1
This release contains all the same features as released for Templafy Desktop Client 2.5 for Templafy One:
Replaced all instances of Internet Explorer with WebView2
Removed support for Office versions below 2016
Added proxy support
In order to run Templafy Desktop Client 3.1, the following prerequisites needs to be installed:
- Templafy Desktop Host 2.0 or above
- .NET Framework 4.7.2 or above
- WebView2 Runtime
Templafy Desktop Client 3.1.0 runs as x86
The new Desktop Client 3.1.0 was incorrectly targeting a wrong platform (x86) making it incompatible with Host 2.x (AnyCPU).
This resulted in the Host not being able to load the client and display an error dialog.
This is now resolved and the client is now targeting AnyCPU making it compatible with both Host 2.x and 3.x
Templafy Desktop Client 3.1.0
- Revoked for issues with Host 2.2
Templafy One
Templafy Desktop Client 2.5.95
.NET Framework version lookup
Templafy desktop client only looked in the 64bit registry when looking for the .NET Framework version. This release ensures we are looking up the version of the dot net framework both in the root path and in the WOW6432Node part of the registry.
Templafy Desktop Client 2.5.92
Startup files not being distributed via Templafy Desktop 2.5.x (same bug as for 3.x)
We identified a problem on client version 2.5.x that resulted in failures installing packages that contain the WordStartUp or ExcelStartUp entry. This releases fixes that problem.
Templafy Desktop Client 2.5.90
Add-ins installed in server mode are being entered under incorrect registry key
This releases fixes an issue introduced in version 2.5.87, where when installing Templafy Desktop in Server Mode, registry entries for HK_LOCAL_MACHINE would be added under the wrong registry key which resulted in Office applications not loading Templafy Add-ins.
Templafy Desktop Client 2.5.89
Templafy Desktop will never update Add-ins if Outlook is configured to auto-start
We identified an issue where the package update for Templafy Desktop could fail if any Office Application was running with a recent version of the Templafy Add-ins installed. This happened because the Add-ins were locking certain files that Templafy Desktop was trying to update.
This problem has been resolved by automatically renaming the files that are locked and adding them to the list of files installed during the update. The file will get a random suffix in the name and the extension of the file gets renamed to ".bak". If the Office Application restarts it will release the lock on this renamed file and then it will get removed on the next package update for Templafy Desktop.
Templafy Desktop Client 2.5.87
Templafy Desktop fails to update when package has Office startup files
This release fixes the issue where a Desktop Client update containing packages with Office applications' files would fail. New updates containing Office applications' files will complete successfully.
Templafy Desktop Client 2.5.86
Templafy Desktop fails to update when Office is running
This release fixes the issue of Templafy Desktop failing to update when Office is running. The user will now be notified of applications that need to be closed in order for the update to succeed.
Templafy Desktop Client 2.5.85
Font distribution not working in Server mode v2.5
We have added support for fonts in server mode.
Templafy Desktop Client 2.5.84
Update Templafy Desktop Client 2.5 to WebView2 1.0.705.50
We have updated the WebView2 library to version 1.0.705.50, which includes a new native cookie manager.
This made it possible for us to remove some custom workarounds from the previous versions, where native cookie support was not available.
Templafy Desktop Client 2.5 interactive flow is not authenticated
During the authentication of Templafy Desktop, in case the interaction screen (onboarding or missing user profile fields) was shown, the user would not be automatically authenticated on the website. This was due to a bug where the authentication cookie was not set.
This is now resolved, and when the interaction screen is shown, the user will be automatically authenticated.
Templafy Desktop Client 2.5 does not refresh entire settings UI after update completes
We fixed an issue where the settings UI did not correctly refresh after the packages was downloaded.
Templafy Desktop Client 2.5.81
Enable proxy support in WebView2 (Templafy Desktop 2.5)
This release fixes an issue where requests from the WebView2 browser control were bypassing the configured system proxy server.
Requests made from WebView2 will now use the same proxy server as configured by the system.
If a proxy requires authentication, WebView2 will prompt for credentials. This is a known limitation in the current version of the WebView2 control.
Templafy Desktop Client 2.5.80
Uninstalling Templafy Desktop 2.5.78 leaves behind WebViewLoader.dll
We have found an issue where the WebView2 loader could not be deleted when uninstalling Templafy Desktop.
Because of this, when reinstalling Templafy Desktop, a warning would pop up, showing that the WebView2Loader.dll already existed.
We are now making sure the file can be deleted when uninstalling.
Additionally, the user data folder, used by WebView2, was not shared between all instances of the browser, which has now been aligned and is stored in the users temporary folder. Upon uninstall, this temporary data will also be removed.
Templafy Desktop 2.5.78 does not clear cookies on log out
We identified an issue related to the latest Templafy Desktop client 2.5, where cookies were being preserved across sessions. This would cause a user to be unable to sign out. We have fixed this issue and cookies are now always cleared before sign in.
Templafy Desktop Client 2.5.78
Templafy Desktop Client 2.5
This release of Templafy Desktop Client defines new prerequisites and uses exclusively the WebView2 browser component (Microsoft Edge Chromium). In addition, Office versions below 2016 are no longer supported and will not be detected.
To run Templafy Desktop Client version 2.5, the following prerequisites needs to be installed:
- Templafy Desktop Host 2.0 or above
- .NET Framework 4.7.2 or above
- WebView2 Runtime
If the above mentioned prerequisites are not in place, the user will see a dialog describing what is missing and the client will exit and will fail the installation process.
To support our admins, we introduced a warning in the Desktop Settings Page on the admin center. When the new 2.5 client is selected, a warning is shown to summarize the required prerequisites.
Templafy Desktop Client 2.4.76
Templafy Desktop Client 2.4
To prepare for customers to migrate to Hive, we've added some additional logging to help us get a better picture of customer installations.
We are now logging the following:
- The installed version(s) of Office
- The installed .NET Framework 4.x version
- The installed WebView2 version
Templafy Desktop Client 2.3.0.1165
Templafy Desktop fails-safe delete
As preparation for VSTO Loader, Templafy Deskop is now more resilient against files that can not be deleted during an update. This change improves handling of locked files by deferring the deletion to the next update.
Templafy Desktop Copyright is Hardcoded
The Copyright statement in the Templafy Desktop UI showed "Copyright (c) 2019 Templafy ApS" (wrong year). In this release we removed the year from the information, so it just says "Copyright (c) Templafy ApS".
Templafy Desktop Client 2.3.0.1158
Modules Tab shows "no packages installed" on Templafy Desktop
The Modules tab was not showing any installed modules because the location for the different add-ins were not correctly identified causing the message "no packages installed" to be shown.
This has now been resolved and Templafy Desktop will now correctly show the "SlideProof", "Email Signature" and "Office VSTO Add-ins" packages including their version number, if they are installed through Templafy Desktop.
The logic behind package identification has been changed to now use the "installed.xml" file to detect the installed packages and their location.
Templafy Desktop Client 2.3.0.1130
FileWatcher events raised twice
We identified an issue where opening Templafy Desktop from the start menu would trigger the client to start twice, if another version was configured in the admin center.
This is now fixed and the client is only triggered once.
Templafy Desktop Client 2.3.0.1121
Templafy Desktop UI - react app
Currently, the only interface to Templafy Desktop is a tray icon with three functionalities: “Check for updates”, “About”, and “Hide”. For the better user experience and to have the possibility to add new features to the product, Templafy Desktop now includes a user interface.
Running Templafy Desktop
While the icon and its menu from the system tray were removed, when Templafy Desktop is manually started from the Start Menu, a new window (the Templafy Desktop UI) is shown to the user. Templafy Desktop still runs automatically at the Windows start, but without showing any user interface, as it does today.
Closing the Templafy Desktop UI is only closing the user interface, without stopping Templafy Desktop from running in background.
In the initial version of Templafy Desktop UI the following features will be available. The features are organized on multiple tabs, each having different functionality.
Overview tab
The "General” section shows when the last update was performed and whether it was successful or not. There is also a “Check for updates” button for manually starting the update. Lastly, an option toggling for notifications has been added, which will, when enabled, show notifications for all updates that are manually triggered. The notifications will only be shown when the settings UI is open and are disabled by default. The “Login details” section shows the email address of the current user, the URL and the authentication method configured. Now there is also an option to log the user out, which will clear any authentication information currently stored. It is not possible to log out while an update is in progress. The log out feature will also allow the user to log in manually afterwards. This button will not perform a hidden login, so a login screen will always be shown.
Modules tab
All the installed modules are listed in this area. The name of the package, the version and an option to open the log files folder are available here. In this version of the settings UI, only the Templafy Add-ins and SlideProof packages are supported.
Troubleshooting tab
This area provides options to show the Templafy Desktop log files folder, a link to the Templafy Knowledge Base page and a button to quit Templafy Desktop. Quitting Templafy Desktop will immediately exit the process as would usually be done from the Task Manager in Windows.
About Tab
This area displays the installed version of Templafy Desktop Host and Client, a link to the Templafy.com website, and information about copyright.
Templafy Desktop Client version 2.2.1.1044
Run TemplafyDesktopUninstaller Silently
The uninstaller is changed to run as a Windows Application, so that when it runs at user login, we prevent the brief appearance of a console window on the user's desktop.
Ensure only a single download slot is acquired per update
When Templafy Desktop downloads packages and offline content, it acquires a download slot. The download of the packages and offline content is done in two separate phases. Until now, for each phase it was acquired one download slot, resulting in unnecessary requests. The logic has now been modified to only acquire a single download slot if there are any files to download. If there are no files, no download slot will be requested.
Remove browser emulation setting on uninstall
We identified a registry entry which was not removed when uninstalling Templafy Desktop. The entry for Internet Explorer that changes the emulated version within Templafy Desktop was still present after an uninstall. This entry is now also removed when Templafy Desktop is uninstalled.
Reduce version retrieval overhead on client HTTP requests
When Templafy Desktop Client performs an HTTP request to the Templafy web-servers, it adds the versions of the host, client, operating system and browser. All these version numbers are retrieved for each request, although they cannot change. These version numbers are now cached and will be reused within the lifetime of the client process, thus reducing unnecessary overhead and reducing the request time.
Set browser emulation to latest available version of Internet Explorer
The browser version reported by the API calls would in many circumstances be different from the document mode the web browser used by Templafy Desktop. Templafy Desktop had a hardcoded document compatibility mode set to Internet Explorer 10.0, but the reported browser version for API requests would be the actual version installed. This has now been corrected and the document compatibility mode is now set to the same version as installed on the computer.
FileWatcher events raised twice
We identified an issue where opening Templafy Desktop from the start menu would trigger the client to start twice, if another version was configured in the admin center. This is now fixed and the client is only triggered once.
Slot renewal logic - Download of package never completes
An issue in the download slot renewal logic has been identified. When a download slot is acquired, it has a default lifetime of 5 minutes. Within these 5 minutes, data is expected to be downloaded, but if not, the client is considered being in a faulted state and will be restarted, however, download progress reporting is only happening when the download is throttled. Some customers with poor download speeds to Azure blob storage experienced that Templafy Desktop was restarted even though data was indeed being downloaded. The reason behind this was that the download was never throttled (it was already sort of throttled), thus the reporting of data download never took place.
To solve this problem, a download stream monitor is added to Templafy Desktop, responsible for determining whether the file size is, in fact, increasing, regardless of throttling being performed or not.
Right-click is available when viewing Templafy Desktop Interactive pages
In the web browser shown in Templafy Desktop, it was possible to navigate using the context menu, which in some cases could end up in an invalid state. This context menu is now blocked and navigation can only happen by using the links and buttons available on the pages shown. Alt+Home can be used to get back to the initial page, this can be useful in case the web browser ends up on a page with no navigation links available.
Access denied when multiple users go through onboarding flow of Templafy Desktop on a Windows Server Infrastructure
When multiple users are downloading the same package at the exact same time, in a Local Machine installation, the second one that tries to access the package file will fail to update - because the file was already moved by the first user. We fixed that by now checking if the package was already moved.
Changing URL results makes the interactive state API fail
A minor issue has been identified when changing the URL registry key for Templafy Desktop. When the URL is manually changed, the potential existing JSON Web Token present is issued to a different tenant. This causes the wrong login screen to be displayed when starting Templafy Desktop. This has been fixed and in case the JSON Web Token is not valid for the tenant URL, the correct login screen will be displayed.
Templafy Desktop Client version 2.2.0.1002
Allow downloading client and packages from custom URL
Templafy Desktop now supports downloading clients and packages from a custom location (custom storage that supports downloading files over https). This custom location is specified as an optional installation parameter (SourceUrl)
Templafy Desktop Client version 2.1.0.96
Templafy Desktop 2.1 host requires a client with the same or higher version.
Support offline uninstall of Templafy Desktop Host
We have added a new parameter to the uninstall command. It must only be used if the automatic detection of the offline status is not successful due to the tenant's specific network configurations.
Templafy Desktop Client version 2.1.0.909
Filter Check and ProductivityPlus by User group
Templafy Desktop Client now supports “configuration packages” that are installed after the main active packages. These configuration packages have the same structure of the existing ones but are composed dynamically from Templafy based on the authenticated user. They only contain configurations (e.g. registry keys) and have the goal to enable further configuration of the modules by user group while avoiding code duplication. This feature opens the possibility to centrally distribute our modules and create their specific configurations by user group on demand.
SlideProof Check and ProductivityPlus example: A user in the HR or Marketing department can get both Check and ProductivityPlus, while a user in the Sales or Development department can simply get Check).
Templafy Desktop Client version 2.0.0.896
Minimize memory footprint after update When Templafy Desktop runs it loads some resources which will stay in memory until the .NET Runtime no longer finds it needed. This could take minutes or hours, which to the user might look like Templafy Desktop has a high impact on memory consumption. Since Templafy Desktop usually only runs once a day we now manually release any resources loaded by the .NET Runtime right after the update is complete.
Templafy Desktop uninstaller doesn't run if the HKLM\Software\Templafy registry key is present
When Templafy Desktop is installed for all users the MSI installer will create three registry values under the HKLM\SOFTWARE\Templafy key: Url, Token, Options (and AuthenticationMethod if provided). Uninstalling the MSI will automatically remove any registry values that was created on installation, but it will not remove any values or keys created after installation, which in some cases would leave the Templafy key behind. When the "all users" user uninstaller runs, it used the Templafy key to determine if Templafy Desktop was installed, which didn't work as expected in case the AuthenticationMethod was manually set after installation. In such cases the uninstaller would simply just exit with a message that Templafy Desktop was currently installed. The "all users" user uninstaller will now instead use the Url registry value to detect if Templafy Desktop is installed, which will be removed automatically when uninstalling for all users. Templafy Desktop Uninstaller incorrectly checks if Templafy is installed. When uninstalling Templafy Desktop for all users it will be uninstalled for each user when he/she logs in. If the admin reinstalls Templafy Desktop for all users before a user has logged in, it should not be uninstalled for that user. An error caused the uninstaller to still run when the user logged in, even though Templafy Desktop had been reinstalled. This has now been corrected so the uninstaller will only run if Templafy Desktop has not been reinstalled.
Templafy Desktop Client version 2.0.0.851
Templafy Desktop Onboarding refinement
Before this version When a new user gets Templafy Desktop on their PC, they see an onboarding flow the first time Templafy Desktop updates. The onboarding is currently targeted to introduce library and email signature modules. As we are now having tenants with only ProductivityPlus and Check distributed through Templafy Desktop, it is no longer relevant for all users to see this onboarding flow. These tenants do not use User Profiles and therefore we do not need to validate them.
What's new?
Onboarding flow is now separated from the login flow. Templafy need to know who the user is before being able to tell a user should have access to. Therefore, in any situation in which we cannot authenticate the user silently (quiet login with seamless single sign on), users will be presented with a new pre-login screen before the user is redirected to their chosen login method. This is a simple screen introducing Templafy and explaining that the user is required to Access Templafy. This screen has replaced the current welcome screen which is no longer relevant for all users. This welcome screen page has been moved to after authentication, when relevant for a given user. The authentication screen will close immediately after a successful login.
Once the authentication is successful, we decide to show the onboarding flow or not. To avoid showing the onboarding flow to users of tenants that do not use User Profiles, it is now possible to specify if the tenant uses User Profiles on a tenant level. If a tenant is set to not use User Profiles the users connected to that tenant will not see any steps of the onboarding flow.
In Sysop, there is an option under tenant details called “User profiles enabled”. Disabling this indicates that the tenant does not have any features that require the use of User Profiles. For the time being, this flag will not disable anything other than the onboarding flow for Templafy Desktop users.
This is the only change to what triggers Templafy Desktop onboarding. The previous behaviour is preserved. The change on its behaviour will be addressed in a later story, when we will know more about the module available to the end-user.
Technical information
The architecture of the onboarding flow has changed so it is now possible to control which users see which pages purely from the website. This means it is possible to change which users see an onboarding flow and which pages they see without having to release a new version of Templafy desktop.
Logging improvements
It is now also possible to modify the LogLevel registry entry in Templafy Desktop and use the new log level without requiring a restart of Templafy Desktop.
Templafy Desktop Client version 2.0.0.820
Templafy desktop handling internal server error better
When an error occurred on the web server we logged this as an exception in Templafy Desktop. Because of this, it could look like Templafy Desktop was the cause of the error, which was not the case. To make it clear that the error happens on the server side, we now log the operation ID and response error message in the Templafy Desktop log file. Also, because the error was not caused by Templafy Desktop, a stack trace is not logged either
Templafy Desktop onboarding flow throws scripterror for Google Authentication
When authenticating with Google authentication, one page contains a syntax error according to the browser, and this will cause a popup asking if the web browser should continue despite the error. We will now use a customized browser for authentication and onboarding in Templafy Desktop which will not show these types of errors. The customized browser is used by default, but to avoid using it for debugging purposes it is possible to disable with the reg key
Error when synchronizing offline content if folders are filtered
When empty offline content folders was removed, Templafy Desktop would log an error, which was incorrect. The cleanup of offline content has now been fixed and the error will no longer occur.
Desktop notification when all is up to date is still 'Update completed successfully
When offline content was disabled, the user would continue to see the "Update completed successfully" even though nothing was actually modified. This is now fixed and only if the offline content folder is removed or changed, will the user be notified about a change.
Templafy Desktop Client version 2.0.0.749
TLS 1.2 support
TLS 1.2 support (Templafy Desktop host version 2.0 pre-requisite)
Include information about reasons for showing the onboarding flow
It was previously not possible to see why the Templafy onboarding flow was shown. Templafy Desktop now logs the reason(s) why the onboarding flow is being displayed.
Improved logging Improved and fixed logging and added additional logging when installing and uninstalling fonts.
December 2018
Templafy Desktop Client version 1.9.0.704
Originating registry key for OfficeUserTemplates folder in Templafy Desktop Client event logs Previously, the only log output provided, when Templafy Desktop started, was the final Office directories identified (i.e. the directories for OfficeUserTemplates WordStartup, ExcelStartup etc.). To improve the troubleshooting experience, Templafy Desktop now also output logs during the process of identifying these directories from the registry. If a directory is found to be configured in multiple locations for a single Office version, a Warning is output to the log and the first found location is used as always. This could be that the Office 2016 User Templates directory was found in both HKCU\SOFTWARE\Microsoft\Office\16.0\Common\General and HKCU\SOFTWARE\Policies\Microsoft\Office\16.0\Common\General, in which case, it previously would be difficult to determine which one was actually used.
Improved logging configuration
Support for configuring the log level at HKEY_LOCAL_MACHINE\SOFTWARE\Templafy\Desktop\LogLevel has been added. This should make it easier to get logs at the configured level when uninstalling/reinstalling Templafy Desktop, as this value is preserved across installations. This will also affect all installations in a multiuser setup.
The log level is evaluated in the following order:
- Command-line (running Templafy Desktop from the command line using TemplafyDesktop.exe /loglevel=...)
- HKEY_CURRENT_USER\SOFTWARE\Templafy\Desktop\LogLevel
- HKEY_LOCAL_MACHINE\SOFTWARE\Templafy\Desktop\LogLevel
The following log levels are supported:
- Information (default and equal to not setting the level at all)
- Debug (useful for general troubleshooting)
- Verbose (noisiest - contains a lot of information about network requests etc.).
Add support for SlideProof
Latest version of SlideProof is deployed with a managed DLL instead of a native shim. This change required the replacement of file paths to also work for managed DLL's codebase.
November 2018 and earlier versions
Templafy Desktop Client version 1.9.0.629
Improved uninstaller
Previously uninstalling Templafy Desktop would in edge cases leave certain files on the PC where it was installed.
Templafy Desktop Client version 1.8.0.534
Don't show Templafy Desktop On-boarding flow if a user already exists with valid User Profile. Templafy onboarding flow is now only shown to users who have a new user profile.
Templafy Desktop Client version 1.7.0.511
Fixed an issue where Templafy Desktop fails to download/update addins with /forceupdate. Templafy Desktop now ensures the user is running in interactive mode.
Templafy Desktop Updating issue - corrupt XML file Some customers experience invalid installation and package snapshot XML files, which caused Templafy Desktop to fail package updates. This is now fixed, and in case Templafy Desktop is unable to load (de-serialize) any of the XML files, it now logs a warning (including the exception) and continues as if the files were new.
Templafy Desktop Client version 1.7.0.505
Fixed an issue where claims were not consistently updated on login. Claims will now be updated at least once every 24 hours.
Templafy Desktop Client version 1.7.0.501
Unable to Fetch Update Some zip packages contained entries with encoding, which was not handled properly in Templafy Desktop. This has now been fixed by preserving the original entry encoding in the packages.
This bugfix also adds integrity check for all files downloaded from blob storage by comparing the MD5 checksum and file size, provided by blob storage, with the actual data downloaded to disk. This should make it easier to detect file corruption caused by different factors (e.g. proxy server caching).
Templafy Desktop Client version 1.7.0.489
Unable to Fetch Update. The specified blob does not exists In rare situations, a file could be missing in blob storage. Templafy Desktop now logs a warning, if a file is missing when downloading.
There is an error in XML document (0, 0). ---> System.Xml.XmlException: Root element is missing. Sometimes the packages.xml file could be empty for unknown reasons. In such cases Templafy Desktop now assumes a clean installation and ignores any packages already downloaded.
Upgrading Offline throws Access denied when synchronizing offline content, the ~OfflineContent folder could sometimes be locked by a different process. In this case, the synchronization would fail, as moving the folder could not be completed.
Templafy Desktop installed.xml file contains invalid user profile path
Check for updates available while update is running in the background
Templafy Desktop Client version 1.7.0.463
Performance improvement by supporting JWT authentication that speeds up loading of Add-ins.
Templafy Desktop Client version 1.6.0.416
OfflineContent is now download to LocalAppData%/Templafy/OfflineContentSync.
Templafy Desktop Client version 1.6.0.409
Support for user authentication in either current user or local machine context
Templafy Desktop Client version 1.6.0.402
Network throttling enabled
Templafy Desktop Client version 1.5.0.361
Support for font distribution without requirement of admin rights.
Templafy Desktop Client version 1.5.0.338
Fixed an issue where multiple instances where running simultaneously
Tweaked Offline Synchronization so "updated completed successfully" will not be shown wrongly.
Added support for HKLM AuthenticationMethod Fixed an issue with fetching ServerMode-Packages
Templafy Desktop Client version 1.5.0.314
Fixed an issue with the on-boarding flow appearing twice.
Minor bug fixes
Templafy Desktop Client version 1.5.0.302
Offline support User on-boarding flow trigger moved to Client from VSTS
Templafy Desktop Client version 1.3.0.175
Citrix environment support
Comments
0 comments
Article is closed for comments.