MODSOURMAN-924 - Getting issue details... STATUS

Updates to the default MARC Bib-to-Inventory Instance MAP:

These changes are required to support the Authority control feature

Mandatory or Optional: Mandatory

Steps:

  1. If no changes were made to default mapping rules then call PUT  /mapping-rules/marc-bib/restore
  2. If changes were made to default mapping rules then follow next steps:
    1. Send a GET request to /mapping-rules/marc-bib to retrieve the mapping rules

    2. Update rules for alternativeTitles. Under fields 130, and 240 add a new "target":

      {
  "target": "alternativeTitles.authorityId",
  "description": "Authority ID that controlling the alternative title",
  "subfield": [
    "9"
  ]
}

      Result example: 

      "130": [
    {
      "entity": [
        {
          "target": "alternativeTitles.alternativeTitleTypeId",
          "description": "Alternative Title id",
          "subfield": [
            "a",
            "n",
            "p",
            "d",
            "f",
            "g",
            "h",
            "k",
            "l",
            "m",
            "o",
            "r",
            "s",
            "t"
          ],
          "applyRulesOnConcatenatedData": true,
          "rules": [
            {
              "conditions": [
                {
                  "type": "set_alternative_title_type_id",
                  "parameter": {
                    "name": "Uniform title"
                  }
                }
              ]
            }
          ]
        },
        {
          "target": "alternativeTitles.alternativeTitle",
          "description": "Alternative Title",
          "subfield": [
            "a",
            "n",
            "p",
            "d",
            "f",
            "g",
            "h",
            "k",
            "l",
            "m",
            "o",
            "r",
            "s",
            "t"
          ],
          "applyRulesOnConcatenatedData": true,
          "rules": [
            {
              "conditions": [
                {
                  "type": "remove_ending_punc, trim"
                }
              ]
            }
          ]
        },
        {
          "target": "alternativeTitles.authorityId",
          "description": "Authority ID that controlling the alternative title",
          "subfield": [
            "9"
          ]
        }
      ]
    }
  ]

    3. Update rules for contributors. Under fields 100, 110, 111, 700, 710, and 711 add a new "target":

              {
          "target": "contributors.authorityId",
          "description": "Authority ID that controlling the contributor",
          "applyRulesOnConcatenatedData": true,
          "subfield": [
            "9"
          ]
        }

      Result example: 

      "700": [
    {
      "entity": [
        {
          "target": "contributors.authorityId",
          "description": "Authority ID that controlling the contributor",
          "applyRulesOnConcatenatedData": true,
          "subfield": [
            "9"
          ]
        },
        {
          "target": "contributors.contributorNameTypeId",
          "description": "Type for Personal Name",
          "applyRulesOnConcatenatedData": true,
          "subfield": [
          ],
          "rules": [
            {
              "conditions": [
                {
                  "type": "set_contributor_name_type_id",
                  "parameter": {
                    "name": "Personal name"
                  }
                }
              ]
            }
          ]
        },
        {
          "rules": [
            {
              "conditions": [
                {
                  "type": "set_contributor_type_id_by_code_or_name",
                  "parameter": {
                    "contributorCodeSubfield": "4",
                    "contributorNameSubfield": "e"
                  }
                }
              ]
            }
          ],
          "target": "contributors.contributorTypeId",
          "subfield": [
            "4",
            "e"
          ],
          "description": "Type of contributor",
          "alternativeMapping": {
            "target": "contributors.contributorTypeText",
            "subfield": [
              "e"
            ],
            "ignoreSubsequentSubfields": true
          },
          "applyRulesOnConcatenatedData": true
        },
        {
          "target": "contributors.primary",
          "description": "Primary contributor",
          "applyRulesOnConcatenatedData": true,
          "subfield": [
          ],
          "rules": [
            {
              "conditions": [],
              "value": "false"
            }
          ]
        },
        {
          "target": "contributors.name",
          "description": "Personal Name",
          "subfield": [
            "a",
            "b",
            "c",
            "d",
            "f",
            "g",
            "j",
            "k",
            "l",
            "n",
            "p",
            "q",
            "t",
            "u"
          ],
          "applyRulesOnConcatenatedData": true,
          "rules": [
            {
              "conditions": [
                {
                  "type": "trim_period, trim"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
    4. Update rules for series. Under fields 800, 810, 811, 830 do:
      1. Surround it with "entity"
      2. Change target from series to series.value

      3. add a new target:

                {
          "target": "series.authorityId",
          "description": "Authority ID that controlling the series",
          "subfield": [
            "9"
          ]
        }

        Result example: 

        "800": [
    {
      "entity": [
        {
          "target": "series.value",
          "description": "Series Statement",
          "applyRulesOnConcatenatedData": true,
          "subfield": [
            "a",
            "b",
            "c",
            "d",
            "e",
            "f",
            "g",
            "h",
            "j",
            "k",
            "l",
            "m",
            "n",
            "o",
            "p",
            "q",
            "r",
            "s",
            "t",
            "u",
            "v",
            "w",
            "x",
            "3",
            "5"
          ],
          "rules": [
            {
              "conditions": [
                {
                  "type": "remove_ending_punc, trim"
                }
              ]
            }
          ]
        },
        {
          "target": "series.authorityId",
          "description": "Authority ID that controlling the series",
          "subfield": [
            "9"
          ]
        }
      ]
    }
  ]
    5. Update rules for subjects. Under fields 600, 610, 611, 630, 650, 651, 655 do:
      1. Surround it with "entity"
      2. Change target from subjects to subjects.value

      3. add a new target:

                {
          "target": "subjects.authorityId",
          "description": "Authority ID that controlling the subject",
          "subfield": [
            "9"
          ]
        }

        Result example: 

        "600": [
    {
      "entity": [
        {
          "target": "subjects.value",
          "description": "Subject Headings",
          "applyRulesOnConcatenatedData": true,
          "subfield": [
            "a",
            "b",
            "c",
            "d",
            "e",
            "f",
            "g",
            "h",
            "j",
            "k",
            "l",
            "m",
            "n",
            "o",
            "p",
            "q",
            "r",
            "s",
            "t",
            "u",
            "v",
            "x",
            "y",
            "z"
          ],
          "rules": [
            {
              "conditions": [
                {
                  "type": "trim_period, trim"
                }
              ]
            }
          ],
          "subFieldDelimiter": [
            {
              "value": " ",
              "subfields": [
                "a",
                "b",
                "c",
                "d",
                "j",
                "q",
                "t",
                "f",
                "g",
                "k",
                "l",
                "m",
                "n",
                "o",
                "p",
                "r",
                "s"
              ]
            },
            {
              "value": "--",
              "subfields": [
                "x",
                "y",
                "z",
                "v"
              ]
            },
            {
              "value": "--",
              "subfields": []
            }
          ]
        },
        {
          "target": "subjects.authorityId",
          "description": "Authority ID that controlling the subject",
          "subfield": [
            "9"
          ]
        }
      ]
    }
  ]

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



  • No labels

4 Comments

  1. Sobha Duvvuri

    Thank you Pavlo Smahin . Is there a reason why the above cannot be done in code during migration from one release version of the module to another?

  2. Pavlo Smahin

    Sobha Duvvuri , we follow the process for updating mapping rules that the Folijet team as the owner of the module ask us to follow.

  3. Sobha Duvvuri

    Kateryna Senchenko : Thank you for updating the documentation with steps. Assuming the library is not using default mapping rules, can we get a script to make the adjustments above?

  4. Sobha Duvvuri

    Meeting Summary: This is a mandatory mapping rule change that impacts all libraries and needs to be done as part of the upgrade from Nolana to Orchid.

    TODO: A script will be provided by Spitfire to automate this process. Thanks Pavlo Smahin . 

    Nice to have: For future releases, Folijet to think about how to automate these as part of the module upgrade itself if its a mandatory mapping rule change that affects all libraries