Troubleshoot WebView2

This article explains how to resolve WebView2 issues in Bp Premier.

What is WebView2?

WebView2 is Microsoft’s new embedded web control, built on Microsoft Edge. Web controls allow web-related technology to be embedded in software. Visit the Microsoft website to find out more about WebView2.

Why does Bp Premier use WebView2?

Bp Premier uses WebView2 to display web content and documents directly within Best Practice. WebView2 was introduced in Saffron SP2, and uses less memory than previous web content and document display methods.

WebView2 troubleshooting

You may require assistance from your IT provider to complete the below troubleshooting steps.

WebView2 Runtime error

If you experience the below WebView2 error, this means that WebView2 has failed to download during your install of Bp Premier.

This is likely due to the computer not being connected to the internet at the time of installation.

To resolve this error:

  1. Click here to download the Microsoft WebView2 runtime.
  2. Once the download has finished, navigate to the Downloads folder on your computer and locate the file MicrosoftEdgeWebview2Setup.exe.
  3. Right-click on MicrosoftEdgeWebview2Setup.exe and select Run as administrator. If the User Account Control alert appears, click Yes.

    4. The WebView2 runtime download screen will appear.

    Once the download is complete, the screen will close.

  4. Restart Bp Premier to run it with WebView2.

Documents appearing blank

If the document viewer displays a blank screen when you attempt to view a document, try the following solutions.

Run Bp Premier as an administrator

  1. Close Bp Premier.
  2. Right-click the Bp Premier desktop item and select Run as administrator.
  3. Access the file you are having issues viewing.
  4. Close Bp Premier.
  5. Re-open Bp Premier as a normal user.
  6. Navigate to the file again and see if you can access it.

Change the Best Practice Software folder permissions

  1. In your computer's file browser, navigate to C:\Program Files, right-click Best Practice Software and select Properties. The Best Practice software Properties screen will appear.
  2. Select the Security tab, and click Edit > Add. The Select Users or Groups screen will appear.

  3. In the Enter the object names to select field, type Everyone and click OK.
  4. Select the new Everyone group in the Group or user names section and tick Allow for the Full control permission.
  5. Click Apply.

Change the Edge Web View Application folder permissions

  1. In your computer's file browser, navigate to C:\Program Files (x86)\Microsoft\EdgeWebView, right click Application and select Properties. The Application Properties screen will appear.
  2. Follow steps 2-5 in the Best Practice Software folder section above.

Change Temp folder permissions

  1. In your computer's file browser, navigate to C:\Users\%Userprofile%\AppData\Local, right click Temp and select Properties. The Temp Properties screen will appear.
  2. Follow steps 2-5 in the Best Practice Software folder section above.
  3. Repeat for all user profiles in C:\Users.

Change Registry key permissions

  1. Search for 'registry editor' or 'regedit' in the Windows search bar and click on the search result. The Windows Registry Editor will appear.
  2. Navigate to Computer\HKEY_CURRENT_USER\SOFTWARE\Best Practice Software\Best Practice.

  3. Right-click on the Best Practice folder and select Permissions. The Permissions for Best Practice screen will appear.
  4. Click Add. The Select Users or Groups screen will appear.
  5. In the Enter the object names to select field, type Everyone and click OK.
  6. Select the new Everyone group in the Group or user names section and tick Allow for the Full control permission.
  7. Click Apply, then click OK.
  8. Navigate to Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Best Practice Software.
  9. Repeat steps 3-7 for the Best Practice Software folder.

Add exceptions in Anti-virus software

In your practice's anti-virus software, set up exceptions for each user profile's Temp folder (e.g. C:\Users\%Userprofile%\AppData\Local\Temp).

An exception will also need to be set up in your anti-virus software for msedgewebview2.exe.

Clear the temp directory

Navigate to C:\Users\%Userprofile%\AppData\Local\Temp and remove all contents from this folder.

Sites using a Citrix Environment

If your site uses a Citrix environment, your IT provider may need to disable Citrix API hooks.

See How to Disable Citrix API Hooks on a Per-application Basis for more information.

Sites using FSLogix

If your practice uses the latest version of FSLogix and has a file redirection in place for the temp directory (C:\Users\%Userprofile%\AppData\Local\Temp), disable the redirection

Update the following registry key:

  1. Search for 'registry editor' or 'regedit' in the Windows search bar and click on the search result. The Windows Registry Editor will appear.
  2. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\FSLogix\Profiles.
  3. On the right side of the screen, there will be an entry called SetTempToLocalPath. Right-click SetTempToLocalPath and select Modify. The Edit DWORD (32-bit) Value screen will appear.
  4. Update the Value data field to 2 and Click OK.

Last updated 21 December 2021