Update of mapping rules for the 050, 060, 082, 090 fields to adjust mapping for the classification field

MODSOURMAN-1052: Create script to update mapping rules for the classification fieldClosed

Overview

This CLI tool has been created to apply MARC-to-Instance mapping rules updates for the instance "classification" filed that were introduced for Poppy release (see MODDICORE-323: Problems with default MARC-Instance mapping when some call number fields are repeated or have repeated subfieldsClosed).

Note that this CLI tool/script does NOT update existing Inventory Instances based on the updated mapping rules. The revised rules will only apply to Source = MARC Instances that are created or updated after the mapping rules changes are made. To refresh all existing instances against the updated rules, libraries will need to run a separate script. This refresh script will take a long time if the library has many instances.

Script execution

CLI tool executable artifact for Poppy:

java -jar folio-mapping-rules-update-poppy.jar configuration.json

CLI tool/script requirements:

Java 17

In order to run the CLI tool you need the following:

Create JSON file with configuration (see: configuration file)
Open terminal (Mac OS or UNIX Systems) or Power shell (Windows)
Go to the folder where the CLI tool executable artifact is located
Run the CLI tool/script with the configuration file path parameter (just file name if the script is located in the same folder)

The CLI tool/script does not update mapping rules for the MARC fields whose mapping has been customized/changed by a user. In this case script will print MARC fields for which mapping rules could not be updated, and will suggest updating rules for such MARC fields manually using this guidance.

Configuration file

okapiUrl - your library okapi url. (Can be seen in the app settings → software versions → okapi services → okapi)
tenant - target tenant
username - admin user name
password - admin user name password

Configuration file example:

{
  "okapiUrl": "https://folio-snapshot-okapi.dev.folio.org",
  "tenant": "diku",
  "username": "admin",
  "password": "secret"
}