Release Notes 4.13

What’s New

Authentication with ArcGIS Enterprise Portal or ArcGIS Online

You can now fully connect a map.apps installation with ArcGIS Enterprise Portal or ArcGIS Online. This allows users to log in to map.apps with their Portal or ArcGIS Online account via the OAuth 2.0 protocol. The assigned portal groups and portal roles are translated into roles for map.apps. These roles can then be used to control access to the map.apps manager, individual apps or specific tools. In addition, non-public content such as webmaps or layers can be used without logging in again (single sign-on).

Authentication with Keycloak (via OpenID Connect)

As an alternative to connecting to ArcGIS, it is now also possible to connect your map.apps installation to Keycloak. Using the roles assigned in Keycloak, you can then control access to the map.apps manager, individual apps or specific tools.

Order of search results

In map.apps 4.12, the ability to display results from multiple search topics simultaneously in a suggestion list was introduced. In this release, a configuration option is now introduced to define the order of search topics. In this way you can ensure that results from particularly important topics appear first.

Hide empty fields in popups

You can now hide fields that do not contain values in a popup. For each feature it is checked individually which fields are filled with values. The display of popups can thus be made much more compact and clearer, especially for map services in which empty values frequently occur.

Automatically expand entries in map content control (TOC)

With the help of a new configuration option, entries in the map content control can now be displayed automatically expanded at startup. This makes it easier for new users to find map content in deeper nested layers.

Accessibility improvements

Several improvements have been made to increase the accessibility of apps. The drawer menu, which is usually located to the left of the search, can now be operated more easily using the keyboard. In addition, so-called aria labels have been added or optimized in various places to improve the usability of screen readers.

New features for developers

New LayerStore implementation

In this release a new class LayerStore is introduced, which will replace the class ct/mapping/store/MapServerLayerStore in the agssearch bundle in the future. The class LayerStore is stored with an ArcGIS FeatureLayer instance and is therefore consistent with the content of the map (for example when using definition queries). The agssearch bundle now creates LayerStore instances by default in the class AGSStoreFactory and the configuration options AutoStoreRegistration and AGSStore.

Further new functions and improvements

  • The ArcGIS API for JavaScript used by map.apps as technical basis is updated to version 4.22 with this release. This results in numerous improvements and bug fixes in the base technology.

  • The use of material design icons as tool icons has been simplified.

  • The Proj4js library has been updated to version 2.7.5.

  • map.apps can now be used under Java 17.

  • The default value of client.config.requestMaxUrlLength has been reduced to "2048".

  • The bundle search-api now informs about the selected search result via the event system.

  • map.apps Proxy now supports bearer token based authorization.

A complete list of all changes can be found in Changelog.

Update Notes

New Database Tables

map.apps requires the new database tables IDENT_EXTSESSIONS, IDENT_SESSIONS, and IDENT_TOKENS.

Starting from this version, map.apps creates those tables when starting Tomcat if they do not exist already and the property db.hibernate.schemaUpdate=update in the appropriate config file is set. If you have not set or changed this setting so far, you do not need to make any changes.

If you wish to create the tables manually, instead, use the appropriate SQL script for your database in use:

Use of ArcGIS roles in map.apps

If you previously used roles derived from ArcGIS Enterprise Portal or ArcGIS Online groups in map.apps, this previously required the following notation: "user@@group". The syntax changes to "group::user" with this release.

Tools in the DockingBar in the Footer

Tools in the DockingBar in the Footer are no longer in a toggle group by default. If they are not to be opened at the same time, they must be assigned to a group.

Discontinued Features

The following features are discontinued with this release:

  • Java 8 — With this version, running map.apps with Java JRE 8 is no longer supported. We recommend using Java 17.

  • Tomcat 8.5 — With this version, running map.apps in Tomcat 8.5 is no longer supported. We recommend using Tomcat 9.0.

  • As of this release, line 3 bundles are no longer included in the rollout folder. For more details on the map.apps line 3 lifecycle, see the lifecycle overview .

  • The Advanced Configuration (Bundles) section has been removed from the live configuration.

  • The eventservice which was needed in line 3 for the Follow Me function has been removed.

  • The font directionsUiFont has been removed.

Deprecated Features

The following are deprecated and will be removed in a future release. Also note the additional information in the system requirements.

  • The ct/mapping/store/MapServerLayerStore class is being replaced by a new LayerStore class in the agssearch bundle. LayerStore is backed by an ArcGIS FeatureLayer instance and will therefore be consistent with the view. The agssearch bundle now creates LayerStore instances by default in the AGSStoreFactory class and the AutoStoreRegistration and AGSStore configuration options. The old behavior can be restored using the legacyImplementation option during the transition period.

  • Compatibility mode in map.apps Manager

  • Synchronization of apps and app templates. Use domain bundles instead.

  • The bundle aceeditor will be removed in one of the upcoming releases.

  • There is no further development of the omnisearch bundle. Use the search-ui bundle instead.

  • The use of data-template-window and data-template-window-events in template files will no longer be supported in the future. Make window definitions in manifest.json files instead.

  • The bundle app-uitest-support will be removed.

  • The following classes will be removed in one of the next releases:

Deprecated class Alternative

ct/array

native JavaScript Funktionen

ct/async

apprt-core/async

ct/_when

apprt-core/when

ct/_compare

apprt-core/comparators

ct/mapping/store/MapServerLayerStore

AGSStoreFactory.createStore

ct/store/_RestStore

store-api/rest/BaseWriteableRestStore

ct/store/ComplexMemory

store-api/InMemoryStore

ct/store/ComplexQuery

store-api/ComplexQuery

ct/store/ComplexQueryEngine

store-api/utils.createComplexQueryEngine

ct/store/ComplexQueryToRQL

store-api/rest/RQLStore

ct/store/ComplexQueryToSolrQL

store-api/rest/ComplexQueryToSolrQL

ct/store/ComplexQueryToSQL

store-api/rest/ComplexQueryToSQL

ct/store/Filter.filterMetaData

store-api/utils.mergeMetadata

ct/store/RQLStore

store-api/rest/RQLStore

ct/store/SpatialQuery

store-api/SpatialQuery

ct/store/SQLStore

store-api/rest/SQLStore

ct/store/StoreUtil

store-api/utils

ct/ui/controls/mobile/Drawer

-

Known Limitations

MAPAPPS-5654

[Map] Zoom via mousewheel does not allow to zoom to the full max or min extent in some situations

MAPAPPS-6377

[Printing] Printing of line measurement not possible with PrintTask published from ArcMap

Dependencies

  • Esri ArcGIS API for JavaScript 4.22.2

  • ArcGIS Arcade 1.16

  • Moment.js 2.29.1

  • Vue.js 2.6.14

  • Vuetify.js 1.5.24

Changelog

4.13.1

map.apps was not affected by the vulnerability known as Spring4Shell. However, to be absolutely on the safe side, we have updated the Spring Framework version to 5.3.18 in this version.

MAPAPPS-6325

Update Spring Framework to version 5.3.18

4.13.0

Fixed Security Issues

MAPAPPS-6218

Fix CVE-2021-22060

New Features

MAPAPPS-6144

[Accessibility] Add aria labels to icon buttons

MAPAPPS-6147

[Accessibility] Add aria-disabled to disabled ui elements

MAPAPPS-6129

[agssearch] LayerStore: implement support for feature layers that are not in the map

MAPAPPS-6263

[apprt] Introduce logging API for better control of log output of bundles

MAPAPPS-6228

[Layout] Simplify usage of material design icons as tool-icon

MAPAPPS-6136

[Live Configuration] Remove "Advanced Configuration (Bundles)" section

MAPAPPS-6115

[map.apps Proxy] Support Bearer Token based Authorization

MAPAPPS-6139

[monaco-editor] Update to 0.30.1

MAPAPPS-5903

[Popups] Hide empty values

MAPAPPS-6251

[Portal Integration] Allow custom role mapping via application.properties

MAPAPPS-6164

[Portal Integration] Consume custom services in protected app

MAPAPPS-6163

[Portal Integration] Consume portal items and federated protected services in protected app

MAPAPPS-6243

[Portal Integration] Do not force login when app item is shared with public

MAPAPPS-6214

[Portal Integration] Prepare Maven Plugins for new authentication

MAPAPPS-6205

[search-api] Provide information about selected result

MAPAPPS-6067

[Search] Define order of search stores

MAPAPPS-6223

[Security] Use Keycloak for user management

MAPAPPS-6085

[System] Support Java 17

MAPAPPS-6162

[System] Update ArcGIS API for JavaScript to version 4.22

MAPAPPS-6313

[System] Update jackson-databind to 2.13.2.1 (CVE-2020-36518)

MAPAPPS-6122

[templatelayout] Change default value of property 'WidgetDefinitions._keepWindowOpenState' to true

MAPAPPS-6142

[Templates] Remove toggleMode from dockingBarBottomLeft

MAPAPPS-5375

[TOC] Allow to expand group on start

MAPAPPS-6224

Allow definition of custom setters for injected '_properties'.

MAPAPPS-5986

Provide a store implementation that directly searches on a layer

MAPAPPS-6311

Reduce default value of client.config.requestMaxUrlLength to 2048

MAPAPPS-6152

Remove event service from mapapps web app

MAPAPPS-6178

Update proj4.js to 2.7.X for nadgrid support

Fixed Issues

MAPAPPS-6210

[app-mgmt-service] app.json cannot be loaded with dynamic bundles

MAPAPPS-6217

[apprt-core/Promise] Unhandled promise rejections are not logged

MAPAPPS-6192

[apprt-core] Observers cannot handle recursive calls to clean()

MAPAPPS-6117

[Authentication] Wrong error handling during activation of AuthenticationWidgetController

MAPAPPS-5931

[AutoStoreRegistration] Changing definitionExpression property of a layer is not observed

MAPAPPS-6155

[AutoStoreRegistration] Stores are registered multiple times in some cases

MAPAPPS-6133

[Bundle documentation] Wrong locateme tool ID

MAPAPPS-5677

[Coordinate Viewer] Wrong scale is shown in web mercator projection

MAPAPPS-6120

[ct-proxy] proxy.allowedSSLDNs not working as expected

MAPAPPS-6211

[jsregistry] Version of bundles mangled and changed when uploaded

MAPAPPS-6239

[Legend] Classes are listed in wrong order

MAPAPPS-6220

[Live Configuration] Editor in custom info bundle is blocked by csp restrictions

MAPAPPS-6292

[LoginUI] Missing Aria-Labels for username and password field

MAPAPPS-5787

[Manager] Portal sharing icon gets lost

MAPAPPS-5139

[Map] Configured ground layer throws error in 2D views

MAPAPPS-6050

[map-init] initInvisibleLayerStrategy: on-visible does not work in firefox

MAPAPPS-6130

[MapNavigation] Initial extent not reset correctly

MAPAPPS-6127

[parametersearch] result items not transformed to map spatial reference system

MAPAPPS-6176

[Popups] Custom popup actions are not added again

MAPAPPS-6282

[Portal Registration] Old oauth client id is used if app is re-registered at portal

MAPAPPS-6149

[Resultcenter] Paging wrong for services with different speed

MAPAPPS-6125

[Search / map-actions] Popups do not resolve domain values / coded values

MAPAPPS-6135

[Selection] Error if multiple selections are started fast in a row

MAPAPPS-6279

[TemplateLayout] Standalone exported app does not start in firefox if no files in cache

MAPAPPS-6285

[Templates] Missing template scope for tocWidget definition in template-seasons

MAPAPPS-5683

[Templates] Unexpected closing of windows on browser resize

MAPAPPS-6141

[TOC] Prevent inlining HTML in description

MAPAPPS-6287

[TOC] StateInfoTooltip disappears in Firefox when placing toc on right side

MAPAPPS-6137

[Tools] Child HTML element of a tool uses the same "id" attribute

MAPAPPS-6190

[Toolset] Drawer toolset is not navigatable by keyboard

MAPAPPS-6180

[Toolsets] Collapsed Toolsets are not navigatable via keyboard focus

MAPAPPS-6207

[Toolsets] Toolsets are not drawn / positioned in uncompressed build