2023.02.00-RC2-geOrchestra

What's Changed

This Release Candidate contains updates developed as part of MOM MS4 - Phase II. The MapStore git sub-module revision has been also updated to point to the latest MapStore where the most part of involved updates has been contributed (the official release for all of them is expected for the next MapStore major release 2023.02.00).

• #583 [Share plugin - Permalink] Add a permalink functionality by @dsuren1 in #634
• #584 [Context Manager ] Ability to import/export an application context by @dsuren1 in #634
• #415 Better handle of context access restriction by @dsuren1 in #634
• #634: Update MS to latest version to include Phase II issues by @dsuren1 in #635

Relevant fixes and enhancements

• geosolutions-it/MapStore2#9254 Add parametric image parsing to template viewer
• geosolutions-it/MapStore2#9248 Import/export an application context
• geosolutions-it/MapStore2#9279 add icelandic and danish locale support
• geosolutions-it/MapStore2#9272 Fix - fork me on github plugin restored
• geosolutions-it/MapStore2#9287 Fix terser dependency
• geosolutions-it/MapStore2#8969 Update cesium to version 1.106.1
• geosolutions-it/MapStore2#9241 fixed longitudinal profile
• geosolutions-it/MapStore2#9250 Share plugin - Permalink functionality
• geosolutions-it/MapStore2#8927 can import geojson files as layer with query params
• geosolutions-it/MapStore2#9293 Update OpenLayers version 7.4.0
• geosolutions-it/MapStore2#8999 Included missing reducer in search plugin
• geosolutions-it/MapStore2#9001 Made project branch parametric
• geosolutions-it/MapStore2#9250 Save permalink description as metadata
• geosolutions-it/MapStore2#9303 Support for Generic geometry type recognition
• geosolutions-it/MapStore2#9287 Update Node/npm suggested version
• geosolutions-it/MapStore2#9285 support for CQL function parsing and XML conversion
• geosolutions-it/MapStore2#9306 Support for CQL_FILTER in LayerDownload plugin
• geosolutions-it/MapStore2#9251: Better handle of context access restriction
• geosolutions-it/MapStore2#9250: Error handler updated for missing category
• geosolutions-it/MapStore2#9314: Fix - Enhance show/hide attribute edit option on Layer
• geosolutions-it/MapStore2#9326 Fixed propertyName override
• geosolutions-it/MapStore2#8913 fix - commit link in projects

Documentation update

• geosolutions-it/MapStore2#9284 Update User Guide - Add parametric image parsing to template viewer
• geosolutions-it/MapStore2#9283 Update User Guide - import/export an application context
• geosolutions-it/MapStore2#9281 Update User Guide - Longitudinal profile plugin
• geosolutions-it/MapStore2#9328 Update User Guide - Add Permalink tool

MapStore documentation

MapStore latest documentation to use as a reference:

• https://docs.mapstore.geosolutionsgroup.com/en/latest/

Involved migration guidelines for this RC:

• Migration from 2023.01.xx to 2023.02.00

Docker Image

https://hub.docker.com/r/geosolutionsit/mapstore2-georchestra/tags?page=1&name=2023.02.00-RC2-geOrchestra

Configuration changes

localConfig.json changes

If the localConfig.json has been customized:

• To enable import and export on Context. Please add the following to context-creator

{
 "context-creator": {
     ...
+    "ContextImport",
+   "ContextExport"
     ...
}

• To activate the permalink and support redirection functionality, you must add a new permalink section to plugins root object of localConfig.json, as shown below

{
"monitorState": [
...
+ {"name": "userrole", "path": "security.user.role"},
...
],
...
+    "permalink": [
+        "Permalink",
+        "FeedbackMask"
+    ]
...
}

• To make Permalink tab visible on the Share panel, the following changes has to be made on the respective modes

{
    "desktop": [
        ...
+      "Permalink",
        ...
    ],
    "dashboard": [
        ...
+     "Permalink",
        ...
    ],
    "geostory": [
        ...
+     "Permalink",
        ...
    ]
}

pluginConfig.json changes

• Add Permalink plugin configuration to the root and modify Share plugin as shown below to allow Permalink in context-creator plugin configuration

{
...
   {
      "name": "Share",
      "glyph": "share",
      "title": "plugins.Share.title",
      "description": "plugins.Share.description",
      "dependencies": [
        "SidebarMenu"
      ],
+    "children": [
+       "Permalink"
+     ],
+    "autoEnableChildren": [
+       "Permalink"
+     ]
    },
+   {
+      "name": "Permalink",
+      "glyph": "link",
+      "title": "plugins.Permalink.title",
+      "description": "plugins.Permalink.description"
+   }
...
}

app.jsx changes

• The app pages must be updated with a new entry to allow permalink handling and redirection

+ import Permalink from '@mapstore/product/pages/Permalink';
const appConfig = {
    ...
    pages: [
        // my custom pages ...,
+        {
+           name: "permalink",
+           path: "/permalink/:pid",
+           component: Permalink
+       }
    ]
};

Database Update

Add new category PERMALINK to gs_category table. To update your database you need to apply this SQL scripts to your database

Note: If the category is missing, MapStore will attempt to create Permalink category when creating the first permalink on the application

PostgreSQL

-- New PERMALINK category
INSERT INTO geostore.gs_category(id, name) VALUES (nextval('geostore.hibernate_sequence'), 'PERMALINK') ON CONFLICT DO NOTHING;

H2

-- New PERMALINK category
INSERT INTO gs_category(name) VALUES ('PERMALINK');

Oracle

-- New PERMALINK category
INSERT INTO gs_category(id, name) VALUES (hibernate_sequence.nextval, ‘PERMALINK');

Full Changelog: 2023.02.00-RC1-geOrchestra...2023.02.00-RC2-geOrchestra