Change ArcGIS API for JavaScript version

This chapter describes a quick guide to change the ArcGIS API for JavaScript version within the WebOffice application. The version change requires an adjustment to 5 files within the WebOffice application.

Deployment of ArcGIS API for JavaScript 4.18 with WebOffice 10.8 SP2 is then recommended so that systems that have issues with ArcGIS API for JavaScript 4.17 and no longer require support for Microsoft Internet Explorer 11 as well as Edge (legacy) can optionally deploy the newer version.

Notes:

• With ArcGIS API for JavaScript version 4.18, the JavaScript-based WebOffice clients WebOffice core and WebOffice flex no longer work in the Internet Explorer 11 and Edge (Legacy) browsers, as support for these browsers has been discontinued as of version 4.18! 
• This guide refers to the change of version ArcGIS API for JavaScript 4.17 to version 4.18 from the release of WebOffice 10.8 SP2.
• For more information about the versions, see also Release Notes of the current ArcGIS API for JavaScript version as well as version 4.17.

The following steps must be taken to change the ArcGIS API for JavaScript version used:

Note:

Do not perform these steps during productive times and create a backup of the WebOffice application first.

1. Stop Apache Tomcat service.

2. Browse to your WebOffice application path (e.g. C:\Tomcat\webapps\WebOffice\).

Note:

The precondition is the availability of the ArcGIS API for JavaScript 4.18 environment, which can be found in the .\arcgis_js_api\library\4.18 subdirectory of the WebOffice application as of WebOffice 10.8 SP2.

3. Modify the .\client_corejs\wo_gui.jsp file to use API version 4.18 for the WebOffice core client as follows, and then save the file. Instead of esriApiVersion "4.17", enter the value "4.18":

Change API version number in wo_gui.jsp file for WebOffice core client

4. Modify the .\client_flexjs\wo_gui.jsp file to use API version 4.18 for the WebOffice flex client as follows, and then save the file. Instead of esriApiVersion "4.17", enter the value "4.18":

Change API version number in wo_gui.jsp file for WebOffice flex client

5. Modify the .\client_mapwidget\default.jsp file to use API version 4.18 for WebOffice map widget as follows, and then save the file. Instead of esriApiURL "4.17", enter the value "4.18":

Change the API version number in wo_gui.jsp file for WebOffice map widget

6. Modify the .\pub\admin_pages\jsapi_service_preview.jsp file to use API version 4.18 as follows, and then save the file. Instead of esriAPI "4.17", enter the value "4.18":

Modify the jsapi_service_preview.jsp file

7. Modify the .\pub\custom_tools\ArcGIS_WebScene.htm file to use API version 4.18 for the ArcGIS Web Scene custom tool as follows, and then save the file. Enter the value "4.18" instead of version "4.17" in several places:

Change the API version number in the ArcGIS_WebScene.htm file for the ArcGIS Webscene custom tool

8. Then start the Apache Tomcat service again.

Notes:

It is recommended to Delete Browser Cache after this adjustment.

After a patch update, these adjustments might have to be made again, since the adjusted files might be overwritten by the update. Please check accordingly after an update.

For further details please contact the corresponding WebOffice Support Team.