- 03 Oct 2024
- 4 minute read
- Print
- DarkLight
- PDF
Troubleshooting Microsoft Outlook Add-In (Legacy)
- Updated 03 Oct 2024
- 4 minute read
- Print
- DarkLight
- PDF
The Slate Outlook Add-In is a legacy tool and is provided on an as-is basis.
Technolutions no longer develops or supports this tool, and no additional updates will be made.
Due to significant changes to the Windows operating system and Outlook, the Microsoft Outlook Add-in is unlikely to work.
For universal support across operating systems and cloud-based email services, use the Inbox Gateway.
Below are outlined a list of common problems and their solutions. These solutions are not guaranteed, nor is the Microsoft Outlook Add-In supported by Technolutions.
✨ Inbox Gateway provides universal support across operating systems and cloud-based email services.
Technical Specification
The Slate Outlook Add-In operates using Microsoft Outlook's built-in browser which operates as a "lite" version of Internet Explorer, regardless of the main/default system browser configuration. As a IE-lite version, it uses the system configurations for Internet Explorer and some of these will become relevant below.
When operating normally, the Slate Outlook Add-In's workflow starts by navigating to https://slate.technolutions.net/manage/service/outlook, which prompts for the domain of your Slate instance (e.g. admission.school.edu) and then redirects the Slate Outlook Add-In to that specific database's outlook service (e.g. https://slate.school.edu/manage/service/outlook), along with the data from the selected email. At this point, the user will need to authenticate with Slate in the same way that would be experienced when accessing Slate through a normal browser.
While the Slate Outlook Add-In remains loaded as part of the current Outlook session, the chosen domain and user's Slate session values are stored; however once Outlook is closed the cache is cleared forcing the user to login next time.
Specific Error Messages
The following feature couldn't be installed: .NET Framework 3.5
The Slate Outlook Add-In is based on Microsoft's .NET Framework 3.5 and when running the setup file it will attempt to install the prerequisite software. When this fails you may need to be enable the Feature manually via the computer's Control Panel. (https://docs.microsoft.com/en-us/dotnet/framework/install/dotnet-35-windows-10)
Should this not resolve your problem, uncheck the Feature from the Control Panel and deploying .NET Framework 3.5 by using Deployment Image Service and Management (DISM).
(https://docs.microsoft.com/en-us/windows-hardware/manufacture/desktop/deploy-net-framework-35-by-using-deployment-image-servicing-and-management--dism)
The login page doesn't show after entering the domain name
Sometimes this might present as a simple white screen, while other times you might see a "Navigation to the webpage was canceled" message. This is indicative of a failure by Outlook's browser to cleanly handle the redirection to the authentication service. We can start by adding the various domains used as Trusted Sites list. In some cases this might cause the SSO to try and use a browser popup to prompt for credentials which isn't supported by the Outlook browser, and will require a modification to the Security User Authentication.
Add Slate Domains as Trusted Sites
Close Outlook and any Internet Explorer windows you might have open
Open the Control Panel
Open the Internet Options tool
Change to the Security Tab
Select the Trusted sites zone
Click on the Sites button
Enter https://slate.technolutions.net as URL
Enter your Slate domain name (e.g. https://slate.school.edu)
Enter your SSO domain name (e.g. https://adfs.school.edu)
Configure User Authentication
Close Outlook and any Internet Explorer windows you might have open
Open the Control Panel
Open the Internet Options tool
Change to the Security Tab
Select the Trusted sites zone
Click on the Custom level... button
Scroll to the bottom of the list and locate the User Authentication section
Within this selection select the Automatically log-on with current username and password option (Note: This option is selected by default within the Intranet zone, and as such you might want to add the Trusted Sites from above to the Intranet zone list instead.)
Reset Internet Explorer
Close Outlook and any Internet Explorer windows you might have open
Open the Control Panel
Open the Internet Options tool
Change to the Advanced Tab (figure 1 below) and click the Reset... button
Check the Delete personal settings and click on "Reset" (figure 2).
Figure 1: Advanced Tab
Figure 2: Reset example
An error occurred trying to download 'https://technolutions.com/slate/service/outlook/Slate.Outlook.vsto'
This error can occur during the installation of the Slate Outlook Add-In tool, the corrective actions for which are to start by uninstalling the Slate Outlook Add-In followed by a reset of Visual Studio Tools for Office (VSTO). You can then attempt an automatic installation of the Add-In using the setup file, however we've seen the best results by manually installing and registering the Slate Outlook Add-In.
Reset Visual Studio Tools for Office (VSTO) Configuration
In Windows Explorer, navigate to the VSTO 10.0 folder which is the path specified in the error message, e.g., C:\Program Files (x86)\Common Files\Microsoft Shared\VSTO\10.0
Locate the file VSTOInstaller.exe.config and, if present, rename it to VSTOInstaller.exe.config.old (Ignoring the warning from Windows about the file becoming unusable)
Visit https://www.microsoft.com/en-us/download/details.aspx?id=48217
Download the installation file
Execute the downloaded file to start the installation process
Manually Install the Slate Outlook Add-In
As an administrator, open a command prompt
Navigate to the VSTO install folder "C:\Program Files (x86)\Common Files\Microsoft Shared\VSTO\10.0"
Execute the following command "vstoinstaller /i https://technolutions.com/slate/service/outlook/Slate.Outlook.vsto"
Manually Register the Slate Outlook Add-In
Create a new Registry Key of “Slate.Outlook” in the following location:
Computer\HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\Addins\
Add the following values within the new Key:
(String Value) "Description" = "Slate.Outlook"
(String Value) "FriendlyName" = "Technolutions Slate"
(DWORD Value) "LoadBehavior" = dword:00000003
(String Value) "Manifest" = "https://technolutions.com/slate/service/outlook/Slate.Outlook.vsto"
Specified argument was out of the range of valid values.
This can often be caused by a corruption of the local ClickOnce application cache (ClickOnce being the technology Slate uses to install the Slate Outlook Add-In), and if so the solution would be as follows:
Open a command prompt and run the command: rundll32 dfshim CleanOnlineAppCache rmdir /s %localappdata%\apps\2.0
If an "Access is denied" message appears, reboot the computer and then open a command prompt immediately upon restarting (prior to accessing Slate) to ensure that there are no files actively in use.
Please note that this action might require a local Administrator depending upon your campus' security and Group Policy configuration.