GeoNetwork UI and microservices codesprint December 2020

When & Where?

• 14th to 18th November
• The sprint will be remote

Who?

• Francois - full week
• Florent - 2 days
• Laure-Hélène - 2 days
• Jose - about 2 days
• Paul - about 2 days
• Michel - about 2 days

Sponsors

• EEA https://sdi.eea.europa.eu/

Agenda

The main idea of this sprint is to define a common approach for UI apps and set up the building blocks to have a consistent experience when using GN-UI and GN-Cloud.

We have 2 types of apps:

• GN-UI - JS app https://github.com/geonetwork/geonetwork-ui
• API producing HTML page - mainly OGC-API record focusing on landing page for catalogue(+portals) (named collections) and records (named items). https://github.com/geonetwork/geonetwork-microservices/pull/23

Can we share resources?

Templates that can be used in services producing HTML (eg. OGC API Record) and GN-UI components (https://github.com/geonetwork/geonetwork-microservices/issues/17)

• Can we share HTML?
  • What to share? https://github.com/geonetwork/geonetwork-ui/blob/master/apps/search/src/index.html
  • Header
  • Top toolbar
  • Footer
  • How?
• How to share styles or tailwind rules?
• How to share translations? (https://github.com/geonetwork/geonetwork-microservices/issues/25)
  • Common translation key scheme
  • Transifex setup?

Themes

Can we create a theme? How?

Theme is composed of:

• Header
• Footer
• CSS variables?

Resources:

• https://github.com/geonetwork/geonetwork-microservices/blob/ogcapirecords/modules/library/common-view/src/main/resources/xslt/core/themes/default/theme.xsl

UI Configuration

GN-UI will allow developers to more easily create custom apps. Anyway, with portals and custom UI config in v3 and 4, quite some projects are using it to easily customized the main app.

• Should we reuse part/all of GN UI config in GN-UI main app? (we already use the facet config)
  • + can allow adoption of GN-UI for simple use case at early stage
  • + will help transitionning from GN to GN-UI
  • - GN UI config is maybe not perfect - "too complicated", "too many things", "not enough"
  • If we use it, webcomponents should also be configurable directly with simple parameter

How to use GN-UI in GN-Cloud?

Service producing HTML may want to embed GN-UI component. How to do?

Use cases:

• in the landing page a component rendering the bounding box of the record in a map, the data (eg. WMS) of the record in a map => Create a record-data-viewer component ?
• in results, display humanized date based on UI configuration?

GN-UI

• Discussion on current status?
  • https://github.com/geonetwork/geonetwork-ui/discussions
• Tasks
  • Web components / gn-results-list / Fix duplicates on results and make it work if more than one component in a page ie. support multiple search states (Florent)
  • Web components / gn-results-list / Listen to attribute change and trigger events?
  • CSS variables / illustrate with a examples ?
  • • to be defined based on discussion - ...

GN-Cloud

• Discussion on current status?
• Tasks
  • Clean up exception and use multilingual error
  • Fix log in tests (make travis fails)
  • HATEOAS ?

GN4 Tasks

• GN4 Add API Languages https://github.com/geonetwork/core-geonetwork/blob/master/domain/src/main/java/org/fao/geonet/domain/Language.java

Summary