Cumulative Update for WebOffice 10.9 R4
=======================================
Build time: 20260510-1032

* This is an add-on patch for WebOffice 10.9 R4. That means, WebOffice 10.9 R4 is a minimum requirement and must be installed! This patch contains all fixes since WebOffice 10.9 R4! 
* Please inform your users to delete the browser cache according our [guideline](https://resources.weboffice.vertigis.com/Documentation/WebOffice/EN/index.html?trouble_delete_browser_cache.htm), before opening WebOffice the first time after applying an upgrade.


Requirements:{#requirement}
---------------------------
- Installation of VertiGIS WebOffice 10.9 R4 (min. build time: 20240912-1151)  

- Installation of [VertiGIS WebOffice author standalone 10.9 R4 - min. Build 109.4.0.8](https://resources.weboffice.vertigis.com/WebOffice109R4/WebOffice_author_Standalone/WebOffice_author_standalone_109_4_0_8.zip)

- Installation of [VertiGIS WebOffice extensions 10.9 R4 - Build 10.9.323](https://resources.weboffice.vertigis.com/Software/)

- Optional: Installation of [VertiGIS Studio Printing Engine (CIM2) -  Build 5.30.2.2 (ArcGIS 10.8.1 - ArcGIS 10.9.1)](https://support.vertigis.com/hc/en-us/articles/10257643887250)
  - Important: For WebOffice the build “v2” is normally required, which is based on the [Cartographic Information Model (CIM)](https://github.com/esri/cim-spec) v.2 and can be used with ArcGIS Pro 2.x and ArcGIS Enterprise 10.8.x and 10.9.x. Version “v3” is based on CIM v.3 and is only compatible with ArcGIS Pro 3.x and ArcGIS Enterprise 11.x. Background information can be found in the [following HelpCenter article](https://support.vertigis.com/hc/en-us/articles/18772434800914).


Installation:{#installation}
----------------------------
1. Backup your entire WebOffice web-application (e.g. `C:\Tomcat\webapps\<WebOffice web-application>`) to a save place
2. Stop Apache Tomcat (Start/Programs/Administrative Tools/Services)
3. Delete the working directory of Apache Tomcat at e.g. `C:\Tomcat\work\Catalina\localhost\<WebOffice web-application>`
4. Update "ArcGIS Server Object Extension for WebOffice" at least to: **109.4.0.202408161602**
  * In ArcGIS Server Manager under "Services" choose to stop the Map Service "SynOutputService" (or all services, where "WebOffice Server Object Extension" is activated) 
  * In ArcGIS Server Manager under "Site/Extensions" choose to edit "WebOffice Server Object Extension" and select "`<Patch>\ArcGIS for Server Object Extension\syn_soe_ao_gateway.soe`" to upload
    * Don't use uninstall and install the extension, because else you have to set the properties for "WebOffice Server Object Extension" again!    
  * Copy the content of `<Patch>\WebOfficeSystem` to `<Drive>\arcgisserver\directories\WebOfficeSystem`
  * In ArcGIS Server Manager under "Services" choose to start the Map Service "SynOutputService" (or all services, where "WebOffice Server Object Extension" is activated) 
5. Copy WO109R4_patch_YYYYMMDD.exe to the directory of your WebOffice web-application (e.g. `C:\Tomcat\webapps\<WebOffice web-application>`)
6. Run WO109R4_patch_YYYYMMDD.exe and choose to overwrite all existing files
7. Delete the file WO109R4_patch_YYYYMMDD.exe
8. Start Apache Tomcat (Start/Programs/Administrative Tools/Services)


Changelog since WebOffice 10.9 R4:{#changelog}
----------------------------------------------
<!--
### [Unreleased]{#unreleased}
- #### Added
- #### Fixed
- #### Changed
- #### Deprecated
- #### Removed
- #### Security
-->

### [2026-05-10]{#patch20260510}
- #### Added
  - **341204**: Flex: Support for configuring animation behavior and animation speed
  - **376820**: VertiGIS Printing: Support for VertiGIS Studio Printing Engine v5.30.2.2   
- #### Fixed
  - **356029**: Core: Map services do not reload in certain scenarios when transparency is applied to map services
  - **361857**: VertiGIS Printing: Print series over selected objects does not work
  - **362159**: Core: Panorama images should not require storage in subdirectories derived from the filename
  - **364181**: VertiGIS Printing: On a rotated map, the label is not correctly aligned
  - **368790**: Flex: An error during identify causes the WebOffice Flex client to freeze   
  - **368851**: General: Certain WFS services cause an error message in the WebOffice log file  
  - **374322**: Core: Error with the "Export Map" and "GeoTIFF export" tool  
  - **378599**: Core: WebOffice projects do not start when WebOffice layer filters with lookups are used and no default value is specified  
- #### Security
  - **370602**: General: After entering an incorrect password during a login process, the WebOffice application server must not send the password to the WebOffice client
  - **370605**: Core: It must be checked whether the EDIT, UPLOAD, PRINT, EXTRACT, and EPAPER tools are enabled for the user in the session and whether the user is authorized for the corresponding tools  


### [2026-02-27]{#patch20260227}
- #### Added
  - **344723**: Core: Support for "generateState" in the ScriptAPI for creating a SaveState
  - **365665**: VertiGIS Printing: Support for VertiGIS Studio Printing Engine v5.29.1.2
- #### Fixed
  - **344667**: Core: Regression from **325600** causes problems with the map overlay tool
  - **361857**: VertiGIS Printing: Print series over selected objects does not work
  - **362499**: General: At WebOffice SOE print with dynamic legend, legend symbols are shifted if the underlying font contains symbols in different sizes


### [2026-01-28]{#patch20260128}
- #### Added
  - **358317**: Core: Support for Maptip on layers of a WMS service that support the Identify operation
  - **363126**: VertiGIS Printing: Support for VertiGIS Studio Printing Engine v5.29.0.13
- #### Fixed
  - **336738**: General: Optimization of layer identifier naming when creating SaveStates. This gives annotations unique IDs so that the layer visibilty state in the TOC is correctly restored when loading a SaveState
  - **344358**: Flex: Extract via popup (Identify/Search) on a GIS object does not work
  - **358540**: General: WebOffice layer filter on layers configured with identical code value domains does not work
- #### Security
  - **360547**: General: Update [Apache Commons Text](https://commons.apache.org/proper/commons-text/) to version [1.15.0](https://commons.apache.org/proper/commons-text/changes.html#a1.15.0)


### [2025-12-03]{#patch20251203}
- #### Added
  - **330704**: VertiGIS Printing: Support for VertiGIS Studio Printing Engine v5.28.0.1
- #### Fixed
  - **338366**: Core: In Mozilla Firefox, clicking on a hyperlink in a maptip does not open a new window
  - **339828**: General: The “token” parameter should be added to the whitelist of allowed OGC parameters
  - **339831**: Core: In the layer filter of a TOC, it is not possible to filter on layers of a preconfigured or temporarily added WMS service
  - **339940**: General: ArcGIS Server 11.5 FeatureServer Services cause many warnings with log level DEBUG in the WebOffice log file
  - **339943**: General: ArcGIS Server 11.5 MapServer services cause many warnings with log level DEBUG in the WebOffice log file
  - **342147**: Core: When uploading local geodata, objects of the type multipoint features are not displayed on the map
  - **343135**: Core: Layer filters with multiple default values in combination with a lookup table do not work
  - **343736**: Map widget: Create (or Link) line objects using crosshairs does not work


### [2025-06-11]{#patch20250611}
- #### Fixed
  - **261304**: VertiGIS Printing: The parameter "Minimum legend changeable?" is not passed to the VertiGIS Studio Printing Engine
  - **300916**: General: Invalid base URL of the WebOffice application if the parameter "URL for secure connection" is configured in the application configuration
  - **323482**: General: Error when editing if a lookup to a GlobalID field is used
  - **325600**: Core: Tiles from secured map services are not displayed in the "Overlay map" tool    
  - **325620**: Core: Extend custom tool "MGRS Identify" to output coordinates in UTM notation
  - **327019**: General: If an invalid value is detected when determining the identifiers of WMS layers, a corresponding warning should be logged  
  - **327027**: Core: Unnecessary notification when editing if the measurement type "geodesic" is used
  - **327208**: VertiGIS Printing: Regression from **320627** causes map services/layers to be duplicated in the printout if Feature Access is activated
  - **329246**: Map Widget: Notifications for m-values that are outside the extent should not be displayed
  - **329562**: Flex: In the maptip, the defined prefix or postfix is added several times to the generated URL on a relate at integration of external application
  - **329884**: General: A NULL value when determining the Coded Value Domain with subtypes must not prevent the initialization of a map service, instead a corresponding warning should be logged  


### [2025-05-05]{#patch20250505}
- #### Added
  - **325041**: WebOffice extensions: Support for WebOffice extensions 10.9 R4 - Build 10.9.323 - with ArcGIS Engine expiration date 31.12.2026
- #### Fixed
  - **257906**: Core: Error during editing when changing a polygon via vertex geometry import to multipart
  - **308278**: General: Requests to retrieve tiles from a secured ArcGIS Server service suddenly no longer contain a token
  - **308619**: SynAdmin: Only an empty project list is displayed in Firefox
  - **321417**: VertiGIS Printing: Layout optimization when the leaderline is flattened to the right in the "Free labeling" tool
  - **324058**: Core: Error when activating/deactivating a WebOffice layer filter in the browser console if no (predefined) search has been configured in the WebOffice project configuration


### [2025-04-14]{#patch20250414}
- #### Fixed
 - **308619**: SynAdmin: Filter of the project list is incorrectly prefilled with browser data
 - **309138**: VertiGIS Printing: The image for the dynamic selection is not included in the printout, although the corresponding parameter is configured
 - **319481**: General: Error during .CSV or .XLSX export of objects of a WFS service with date fields 
 - **321417**: VertiGIS Printing: In the "Free Labeling" tool, the leaderline and the text background are not horizontal if a print projection other than the WebOffice main map service is selected
 - **323547**: SynAdmin: Link to WebOffice 10.9 R4 documentation is not correct


### [2025-03-27]{#patch20250327}
- #### Added
  - **322306**: VertiGIS Printing: Support for VertiGIS Studio Printing Engine v5.26.1.17 
- #### Fixed
  - **321899**: VertiGIS Printing: Regression from **320627** causes map services without layers such as ArcGIS online services, e.g. World Topographic Map, not to be included in the printout
  

### [2025-03-24]{#patch20250324}
- #### Fixed
  - **313146**: VertiGIS Printing: Objects from tool "Free labeling" are missing on the printout if the printout is created in a local projection
  - **320627**: VertiGIS Printing: Error when printing, if FeatureAccess (for layout attribute table) should be applied, although it is not available on the layer, e.g. annotation layer  


### [2025-03-14]{#patch20250314}
- #### Fixed
  - **311286**: General: Tiles of a WMTS service secured with username/password are not displayed
  - **308278**: General: Extension of the log information if requests to retrieve tiles of a secured ArcGIS Server service suddenly do not contain a token
  - **319824**: VertiGIS Printing: The rotation parameter is ignored when printing if a print projection other than the WebOffice main map service is selected


### [2025-03-07]{#patch20250307}
- #### Fixed
  - **297298**: Flex: With a screen width between 544px and 768px, the pop-up is overlaid by the search bar
  - **313899**: Flex: Drawings/Redlinings sent via SaveState are not available after a project start


### [2025-03-06]{#patch20250306}
- #### Fixed
  - **307169**: VertiGIS Printing: Basemaps are not in the correct placed on the printout if the print is created in a print projection that differs from the main WebOffice map service


### [2025-02-19]{#patch20250219}
- #### Added
  - **305249**: Core: Support for hiding editing templates
- #### Fixed
  - **315626**: General: If no exceptions are configured for the activated parameter “Check open redirects?” WebOffice cannot be used 


### [2025-02-13]{#patch20250213}
- #### Fixed
  - **258394**: Core: Error when completing the edit action “CopyFromTemplate”
  - **301608**: Flex: Calling a hyperlink from a Relate does not work
  

### [2024-12-18]{#patch20241218}
- #### Added
  - **304708**: Core: Support for new custom tool "pub/custom_tools/MGRS/MGRS_search.htm" to search for [MGRS](https://en.wikipedia.org/wiki/Military_Grid_Reference_System) coordinates
  - **304709**: Core: Support for new custom tool "pub/custom_tools/MGRS/MGRS_identify.htm" to identify [MGRS](https://en.wikipedia.org/wiki/Military_Grid_Reference_System) coordinates
- #### Fixed
  - **308278**: General: With secured map services, no token is sent with requests to retrieve tiles shortly before the usually one-hour ArcGIS token lifetime expires - this means that tiles are not displayed on the client
  - **309636**: Core: No zipped geodata can be uploaded with the "Add data" tool
  - **309726**: General: Prevent unnecessary warning regarding STATIC_THEMATIC_LAYER in the WebOffice log file 


### [2024-11-27]{#patch20241127}
- #### Fixed
  - **308655**: UserManagement: Access to VertiGIS Printing print templates cannot be restricted via UserManagement database
  - **308711**: Flex: The button "Select feature" in the pop-up / maptip has no function
  - **308849**: VertiGIS Printing: Regression from **302852** causes the tool not to start in the core client if no print fields are configured
  

### [2024-11-18]{#patch20241118}
- #### Fixed
  - **299435**: Core: Error at project start if the function “Set Favorites?” is activated for map views


### [2024-11-14]{#patch20241114}
- #### Fixed
  - **302422**: Core: Regression from **242232** causes that a layer filter can no longer be reset after a filtering search
  - **305780**: VertiGIS Printing: Regression from **237069** causes the creation of a printout to fail after a GeoLocator or WFS search


### [2024-11-12]{#patch20241112}
- #### Fixed
  - **306382**: General: Due to a bug in the ArcGIS Maps SDK for JavaScript 4.x, tiled ImageServer map services cause the memory of a browser instance to grow until it crashes


### [2024-11-11]{#patch20241111}
- #### Added
  - **307705**: WebOffice extensions: Support for WebOffice extensions 10.9 R4 - Build 10.9.321
- #### Fixed
  - **307705**: WebOffice extensions: Printing with dynamic legend causes errors


### [2024-11-06]{#patch20241106}
- #### Fixed
  - **305786**: VertiGIS Printing: Regression from **302852** causes the initial print preview to be missing in the core client
  - **305788**: VertiGIS Printing: Regression from **302852** causes the list of projections not to be displayed in the core client
  - **305821**: VertiGIS Printing: Regression from **302852** causes fields such as "Creator" not to be displayed in the tool form
  

### [2024-10-17]{#patch20241017}
- #### Added
  - **305033**: VertiGIS Printing: Support for VertiGIS Studio Printing Engine v5.25.0.7 
- #### Fixed
  - **297781**: General: In WebOffice SOE printing, the dynamic legend does not contain any legend elements in certain scenarios, but only "all other values" instead
  - **301941**: Core: The custom page "pub/custom_pages/forward_replace_in_param.jsp" should support the pass of multiple edit fields to VertiGIS FM
  - **302756**: General: Optimization of the log message if the initialization of external OGC services fails with an exception
  - **302852**: VertiGIS Printing: The order of the print fields in the tool form should correspond to the configuration
  - **304498**: General: The custom page "pub/custom_pages/xPlanung.jsp" does not work in the reverse proxy scenario  


### [2024-09-26]{#patch20240926}
- #### Fixed
  - **291630**: General: Access to a WebOffice project via landing page is not possible for users with an apostrophe in their user name
  - **302755**: General: ESRI Resource Proxy causes an error of type “NoClassDefFoundError” in the WebOffice log file
  - **303070**: SynAdmin: The stored and expected version of the VertiGIS Printing Tools should be v5.24.2.1


IMPORTANT:
----------
* All fixes have been tested on base of bug reports of our customers.
* Due the high complexity of this product we can't avoid regressions for sure.

##### This changelog was created with [Pandoc](https://pandoc.org/) using [Markdown](https://www.markdownguide.org) according [Keep a Changelog](https://keepachangelog.com/) and [Make a README](https://www.makeareadme.com/).
