MODSOURMAN-1052 - Getting issue details... STATUS
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 - Getting issue details... STATUS ).
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: folio-mapping-rules-update-poppy.jar
java -jar folio-mapping-rules-update-poppy.jar configuration.json
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)
CLI tool/script requirements:
- Java 17
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"
}