Troubleshoot
============

Add-In still running the old version
------------------------------------

.. note:: Manual Version update for App is needed

Usually when a update is being pushed to the cloud, since outlook implements a caching system it might take
awhile for our add-in to be updated in your outlook system. You can manually clear the cache for the update
to the latest updates.

Outlook
~~~~~~~~

.. raw:: html

   <p>Instructions referenced from <a href="https://learn.microsoft.com/en-us/office/dev/add-ins/testing/clear-cache#manually-clear-the-cache-in-outlook" target="_blank" rel="noopener noreferrer">Manually clear the cache in Outlook</a>.</p>

Outlook (Classic)
^^^^^^^^^^^^^^^^^

.. note:: Copy the file directory below into your File Explorer to navigate

1. Delete the cache files in the following folder on your machine

.. code-block:: bash

   %LOCALAPPDATA%\Microsoft\Office\16.0\Wef\

2. If the following folder exists, delete its contents, too.

.. code-block:: bash

   %userprofile%\AppData\Local\Packages\Microsoft.Win32WebViewHost_cw5n1h2txyewy\AC\#!123\INetCache\

3. If your Outlook add-in uses the unified manifest for Microsoft 365, also delete the following folder.

.. code-block:: bash

   %userprofile%\AppData\Local\Microsoft\Outlook\HubAppFileCache

Outlook (NEW)
^^^^^^^^^^^^^

1. Search and open Command Prompt on you Desktop
2. Run the follow code in your command prompt and it will open outlook in debugger mode.

.. code-block:: bash

    olk.exe --devtools

1. Nagivate to the Network tab in DevTools, "Right Click" on any of the network request
2. Click on "Clear browser cache"

   .. image:: ./images_outlook/Debug.png

3. The Add-In should be running the latest version after restarting the App.

For Outlook On the Web (Browser)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

1. Nagivate to the outlook on the web pages.
2. Turn on developer tools with F12 (Mac: Cmd+Opt+I)
3. Nagivate to the Network tab in DevTools, "Right Click" on any of the network request
4. Click on "Clear browser cache"

   .. image:: ./images_outlook/DevModeF12.png
   .. image:: ./images_outlook/WebCache.png

5. The Add-In should be running the latest version after refreshing the page.

Gmail
~~~~~

Chrome Extension
^^^^^^^^^^^^^^^^^

1. Open the Extension Page on your Google Chrome by clicking on "Manage extensions"

2. Turn on Developer mode and click on "Update"

   .. image:: ./images_gmail/viewChromeExt.png
      :width: 48%

   .. image:: ./images_gmail/ChromeDevMode.png
      :width: 41%

.. raw:: html

   <p>3. Double check if the version number matches the one on the <a href="https://chromewebstore.google.com/detail/nhncgfleellpcjpmiljlcehgflmifabo?utm_source=item-share-cb" target="_blank" rel="noopener noreferrer">Extension Store</a>.</p>

Users from organisations could not give permissions
---------------------------------------------------

If you are using an email account provided by your organisation, it is possible that your IT administrator has set up restrictions on third-party applications,
which may prevent you from granting the necessary permissions to the SafeQuard Outlook Add-in. In this case, you will need to contact your IT administrator to request access for the extension.

Steps to change default permissions for Office Outlook Add-in (Admin access required)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. raw:: html

   <p>Navigate to the <a href="https://entra.microsoft.com/#view/Microsoft_AAD_IAM/ConsentPoliciesMenuBlade/~/UserSettings" target="_blank" rel="noopener noreferrer">User Consent Settings</a> to change the default permissions for users.</p>

1. Select "Allow users consent for apps from verified publishers, for selected permissions" to allow users to give permissions to the add-in.

   .. image:: ./faq_images/entra-permission1.png

2. Add the permission classification to "Low Impact" for the permissions listed below.

   .. image:: ./faq_images/entra-permission2.png