Trillium R1 2026: Updates of default mapping rules

https://folio-org.atlassian.net/browse/MODDICORE-456

For Inventory Format (called instanceFormatIds in the instance schema), assign value based on the 338$b if it exists, otherwise derive from the 338$a if it is recognized; otherwise do not map a Format

Mandatory or Optional: Mandatory

This process should occur automatically during a module upgrade. If the migration log specifies that the targeted rule is customized and not updated, follow the steps below to manually update the rule.

Look for log

"Updated 338 rule in marc-bib mapping rules"

to verify that rules are updated and no additional steps are required

Look for log

"338 rule is customized and was not updated"

or

"Cannot update 338 rule in marc-bib mapping rules"

to proceed with manual update

Steps:

Send GET request to /mapping-rules/marc-bib to retrieve the mapping rules
Update rule for "338" field to add missing elements

  "338": [
    {
      "target": "instanceFormatIds",
      "description": "Instance Format ID",
      "ignoreSubsequentSubfields": true,
      "applyRulesOnConcatenatedData": true,
      "subfield": [
        "a",
        "b"
      ],
      "subFieldDelimiter": [
        {
          "value": "~",
          "subfields": [
            "a",
            "b"
          ]
        }
      ],
      "rules": [
        {
          "conditions": [
            {
              "type": "set_instance_format_id"
            }
          ]
        }
      ]
    }
  ],

Send PUT request to /mapping-rules/marc-bib and put in the body the updated json