Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Code Block
languagexml
titleChanges to the *_clientConfig.xml (SA example)
<?xml version="1.0" encoding="UTF-8"?>
<clientConfiguration xmlns="http://www.wldelft.nl/fews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.wldelft.nl/fews
http https://fewsfewsdocs.wldelftdeltares.nl/schemas/version1.0/clientConfig.xsd">
	<clientType>Stand alone</clientType>
	<autoExportModuleDataSet name="jcef" exportDir="Modules"/>
</clientConfiguration>

...

Code Block
xml
xml
<?xml version="1.0" encoding="UTF-8"?>
<webBrowserDisplay xmlns="http://www.wldelft.nl/fews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.wldelft.nl/fews httphttps://fewsfewsdocs.wldelftdeltares.nl/schemas/version1.0/webBrowserDisplay.xsd">
    <defaultBrowser>true</defaultBrowser>
	<bringToFront>true</bringToFront>
	<domainWhiteList>
		<access origin="deltares.nl" />
		<access origin="*.deltares.nl" />
	</domainWhiteList>
	<downloadDir>%REGION_HOME%/downloads</downloadDir>
</webBrowserDisplay>

...

To display content in the Web Browser Display, topology nodes can be extended with optional URLs. In the following example, a SA test application (FEWS-Swiss was used) to show the potential variety.

An optional The <mainPanel> element has been added in this example is not necessary to give the browser window the focus if it was hidden by some other content window .because the <url> element automatically gets the focus regardless of the <mainPanel> element being present. In the following example, both node1 and node2 will give the focus to the browser window.

Code Block
xml
xml
Code Block
xmlxml
<nodes id="Web" name="Web">
		<node id="node1" name="FOEN Swiss">
			<mainPanel>web browser display</mainPanel>
			<url>https://www.bafu.admin.ch/bafu/en/home.html</url>
		</node>
		<node id="node2" name="Meteo Swiss">
			<mainPanel>web browser display</mainPanel>
			<url>https://www.meteoswiss.admin.ch/home.html?tab=overview</url>
		</node>
		<node id="node3" name="Energy SFOE Swiss">
			<mainPanel>web browser display</mainPanel>
			<url>https://www.bfe.admin.ch/themen/00490/00491/00494/index.html?lang=en</url>
		</node>
		<node id="node4" name="YouTube (to test movies)">
			<mainPanel>web browser display</mainPanel>
			<url>https://www.youtube.com/</url>
		</node>	
		<node id="node5" name="Deltares">
			<mainPanel>web browser display</mainPanel>
			<url>https://<url>https://www.deltares.nl/en/</url>
		</node>
		<node id="node6" name="Rijksoverheid (to test certificates) and redirect to https">
			<mainPanel>web browser display</mainPanel>
			<url>https://www.rijksoverheid.nl/</url>
		</node>
		<node id="node7" name="local html">
			<mainPanel>web browser display</mainPanel>
			<url>file:///PATH_TO_LOCAL_FILE.html</url>
		</node>		
	</nodes>

...

  • copy the URL in the address bar and try to open this in a stand-alone Chrome browser
  • go to the FEWS temp/session folder and investigate the cef.log file, which contains detailed logging information from the Chromium embedded web browser.

Developer Tools (debugging)

  • The Web Browser can not be used anymore for viewing pdf files. This was possible in older versions of JCEF, not supported anymore in recent version.

On Linux, some distributions may require that you install specific dependencies for your system, most of this will be provided when you install the chromium standalone browser, for RedHat 8 compatible systems use:

  • sudo dnf install epel-release-latest-8.noarch
  • sudo dnf install chromium
  • sudo dnf install dbus-x11

Developer Tools (debugging)

A new feature which is A new feature which is available in FEWS 2020.02 and later versions is the use of the Chrome Developer Tools which can be very helpful if a specific web application does not function properly in the embedded web browser. To use this, you need to run FEWS in debug mode (-Dlog.debug=true) and it will support remote debugging, to use this you open a separate Chrome browser window and enter the url "http://localhost:9222" to connect to the debugging session.

...

For FEWS branches older than 2020.01 you need the most recent FEWS patch to be able to use this package. The JCEF package is tested by Deltares on Windows 10 and CentOS7CentOS8 / RHEL8, it is expected to work on more recent operating system versions.

CEF / Chromium versionWindowsLinux
109122.0.1.116261.112 (march 2024)jcef.zipjcef.zip