Update of mapping to adjust punctuation handling for 1xx/7xx contributors and $e/$j relator terms

MODDICORE-355 - Getting issue details... STATUS

Overview

Scripts were created to adjust mandatory MARC-to-instance mapping rules updates for Poppy release (see MODDICORE-347 - Getting issue details... STATUS )

Note that this 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 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

Script executable for POPPY: folio-contributors-field-mapping-rules-update-poppy.jar

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

In order to run the script, 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 script is located.
Run Script with configuration file path parameter (just file name if the script is located in the same folder)
• example of an executed script - java -jar folio-contributors-field-mapping-rules-update-poppy.jar configuration.json (Should be executed with java 17)

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

Configuration File

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

Example:

Json

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