Script to detect customizations in the marc-to-instance mapping rules for the "classifications" and "contributors" fields

MODSOURMAN-1081 - Getting issue details... STATUS

Overview

This CLI tool has been created to detect mapping rules customizations for the "classifications" (050, 060, 082, 090 MARC fields) and "contributors" (100, 110, 111, 700, 710, 711, 720 MARC fields) instance fields.
The CLI tool/script does not change existing mapping rules on the target host but merely lists MARC fields whose mapping rules have been customized/changed by a user.

Script execution

CLI tool executable artifact for mod-source-record-manager Poppy release: folio-detect-mapping-rules-customizations.jar

java -jar folio-detect-mapping-rules-customizations.jar configuration.json


CLI tool/script requirements: 

  • Java 17


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

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



In case there are no customizations in mapping rules for the  "classifications" (050, 060, 082, 090 MARC fields) and "contributors" (100, 110, 111, 700, 710, 711, 720 MARC fields) instance fields, the CLI tool will print an appropriate message.


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"
}

Related Jira tickets

MODDICORE-347 - Getting issue details... STATUS

MODDICORE-323 - Getting issue details... STATUS