Skip to content

2.17.0

Compare
Choose a tag to compare
@laurenwalker laurenwalker released this 28 Sep 23:18
· 1359 commits to main since this release
da1b6d1

Release Notes

This is a very exciting release of MetacatUI that includes several major new features.

New features 🎉

Custom filter builder for portals!

This long-awaited feature is finally here! You can now build custom filters for the 'Data' page in portals so that portal visitors can filter data in the collection by relevant filters.

For example, the Distributed Biological Observatory project, which is a ship-based research program, may want their community to search for data by vessel or transect.

Screen Shot 2021-09-28 at 5 05 13 PM

These custom filters are now easily creatable in the portal editor. The 70+ metadata fields that are already indexed by Metacat can be used to create a filter.

Four filter types are supported:

  • Free text
  • Date
  • Dropdown menus
  • Toggles

Screen Shot 2021-09-28 at 6 08 50 PM

Create more complex queries in the portal query builder

The capabilities of the portal query builder have been dramatically expanded. It's now easy to create the exact query you need to create a dataset collection.

New capabilities:

  • Group related query rules
  • Select whether to search for ALL or ANY of the rules in the group (i.e. AND or OR), using a dropdown menu.
  • Change whether the search fields and values are ANDed or ORed together by simply clicking the or keyword shown.
  • Exclude specific data from the collection by creating a rule group and selecting the Exclude option.

Screen Shot 2021-09-28 at 5 38 51 PM

Add EML 2.2.0 Measurement Type semantic annotations

EML 2.2.0 semantic annotations for Measurement Type can now be added and edited in the dataset editor. If MetacatUI is configured with a Bioportal API key, an ontology tree widget is displayed in the EML Entity editor (behind the data file Describe button). Researchers can find the relevant measurement type and add an annotation entirely through MetacatUI.

Screen Shot 2021-09-28 at 5 43 43 PM

Note that this feature is disabled by default, since it requires use of the Bioportal service. Set AppConfig.enableMeasurementTypeView to true to enable.

The semantic annotations also have an improved display.

The annotations have separate popovers for the annotation property and value, making annotations easier to understand and read.

Screen Shot 2021-09-28 at 5 47 54 PM

Collections-Portals schema 1.1.0 support

Earlier this year, DataONE released the 1.1.0 version of the collections-portals XML schema, which is used by all portals in the DataONE ecosystem. This new version of the schema is the reason why the two above portal filter features are now available!

All portals created in MetacatUI will now be v1.1.0. 1.0.0 portal documents will still be viewable and editable, but they will automatically be upgraded to 1.1.0 any time they are edited.

Other new features from the 1.1.0 release will be in the future for MetacatUI (e.g. custom icons for dropdown menu items, more complex toggle filters, images for associated parties, etc.)

Bug fixes 🛠️

  • Fixed weird display of Clear all button on the search page #1834
  • JS error after saving a package #1882

Developer notes

  • See the how-to guide for customizing filters in the new query builder and filter builder.

We strongly suggest you upgrade Metacat anytime you upgrade to a minor version of MetacatUI, however to be precise:

  • The new portal features require a Metacat upgrade to Metacat 2.14.1
  • The new semantic annotation display requires an upgrade to Metacat 2.15.1

New configuration options

  • enableMeasurementTypeView - Enable or disable showing the MeasurementTypeView in the Editor's attribute modal dialog. The AppModel#bioportalAPIKey must be set to a valid Bioportal API key for the ontology tree widget to work.
  • portalSearchFiltersInfoURL - The URL for a webpage where people can learn more about custom portal search filters. If no URL is provided, links to more info about portals will be omitted.