1. Installation and Configuration Guide
  2. Installing Smart View
  3. Installation Guidelines
  4. Microsoft Edge WebView2 Support

Microsoft Edge WebView2 Support

Oracle Smart View for Office uses the Microsoft Internet Explorer module to display the authentication page. But certain authentication schemes may require newer controls, such as WebView2, to process a complex login sequence. To use WebView2, Microsoft Edge WebView2 Runtime should be installed and enabled on each Smart View client machine.

During runtime, Smart View detects the presence of Microsoft Edge WebView2 Runtime installed on the machine and launches the WebView2-based dialog to host the login page.

Note:

  • Smart View began supporting WebView2 in release 21.100. Full support for WebView2 is available in release 23.210 and later.

  • WebView2 is supported only on Microsoft Windows 10 and 11.

  • Although WebView2 is supported only on Windows 10 and 11, there may be instances where you are working with Smart View on a Windows Server version, such as Windows Server 2022, with WebView2 installed and enabled. In these cases, after initial login to an Office application, such as Excel, if you attempt to use Smart View in another Office application, you will be required to log in again. For example, if you are copying and pasting data points from Excel to Word, you will be required to log in to Excel, and then log in again to Word.

    This is due to Office applications not sharing the WebView2 data folder. Any functionality that relies on the shared data folder will not work as expected. The result is that users will need to log in and disconnect independently for each Office application on Windows Server.

  • In the Health Check dialog in Smart View, the WebView2 Runtime option is set to Enable for All by default.
  • For two-factor authentication login scenarios, in the Health Check dialog, the WebView2 Runtime option must be set to Enable for UI or Enable for All.

Once WebView2 is installed on Smart View client machines, users can enable or disable it in the Smart View Options section of Health Check (described in Performing a Health Check On Your System in the Oracle® Smart View for Office User's Guide).

Administrators can also enable or disable WebView2 by editing the Smart View properties.xml file (present by default in C:\Oracle\SmartView\cfg) and then distribute this file to users.

These are the configuration settings for enabling and disabling WebView2 in properties.xml:

  • Enable For All (the default setting):

    <disableWebView2>0</disableWebView2>

    <useWebView2forNetworking>1</useWebView2forNetworking>

  • Enable for UI:

    <disableWebView2>0</disableWebView2>

    <useWebView2forNetworking>0</useWebView2forNetworking

  • Disable:

    <disableWebView2>1</disableWebView2>

    <useWebView2forNetworking>0</useWebView2forNetworking>

Administrators: If WebView2 is required to handle the login sequence used by your organization, then you should ensure that Microsoft Edge WebView2 Runtime is installed and enabled on the machines running Smart View. If you are installing Microsoft Edge WebView2 Runtime, Oracle recommends using the Evergreen version.

Once installed, Microsoft distributes WebView2 updates on a regular cadence, unless a fixed version was installed. Administrators can use their own internal procedures to download and distribute Microsoft Edge WebView2 Runtime to Smart View users. The download is here:

https://docs.microsoft.com/en-us/deployoffice/webview2-install#webview2-runtime-installation

For more information, see the WebView2 documentation.