Alma Merge Rules in the NZ Account

"Working with Merge Rules"

"Contributing to the Community Zone - Normalization, Merge, and Indication Rules"

A small number of Alma merge rules have been created in the Alliance's NZ account to use:

• in the import profiles that load the daily bib record update files from OCLC;
  
• in the Alma configuration for Connexion downloads;
  
• other import profiles created in the NZ for loading bib records into the NZ;
  
• in any institutional import profile that loads records into the Alliance NZ (i.e., the import profile has "Use Network Zone = Yes").

This is the primary merge rule used in most import profiles, both those created in the NZ account and in institutional accounts. It is designed to:

• In the existing Alma bib record (i.e., the bib record to be overlaid), retain the:
  
• 001 field containing the MMS ID
• 035 fields which do NOT contain the OCLC "OCoLC" prefix
• Delete all remaining fields in the existing Alma bib record;
  
• Retain all fields from the incoming bib record (i.e., the bib record being imported).

rule "OCA Bib Overlay (Keep 035s)"

when

   merge

then

   replace MARC."LDR"

   remove MARC."0"XX excluding "001,035"

   add MARC."0"XX excluding "001"

   replace MARC."1"XX

   replace MARC."2"XX

   replace MARC."3"XX

   replace MARC."4"XX

   replace MARC."5"XX

   replace MARC."6"XX

   replace MARC."7"XX

   replace MARC."8"XX

   replace MARC."9"XX

   replace MARC."035" when MARC."035"."a" contains "OCoLC" excluding MARC."035"("9","9")

end

This rule is similar to the "OCA Bib Overlay (Keep 035s)" rule except that it retains all 035 fields from the existing Alma bib record including the obsolete OCLC 035 fields. When the "OCA bib Overlay (Keep 035s)" rule was created, staff at some Alliance institutions felt some import profiles were created based on the old "OCA Bib Overlay" merge rule (which is no longer used) and relied on the behavior of that merge rule. The "OCA Bib Overlay (Keep ALL 035s)" rule was created to replicate the behavior of the deprecated "OCA Bib Overlay" merge rule.

rule "OCA Bib Overlay (Keep ALL 035s)"

when

    merge

then

    remove MARC."LDR"

    remove MARC."0"XX excluding "035"

    remove MARC."1"XX

    remove MARC."2"XX

    remove MARC."3"XX

    remove MARC."4"XX

    remove MARC."5"XX

    remove MARC."6"XX

    remove MARC."7"XX

    remove MARC."8"XX

    remove MARC."9"XX

    add MARC."LDR"

    add MARC."0"XX

    add MARC."1"XX

    add MARC."2"XX

    add MARC."3"XX

    add MARC."4"XX

    add MARC."5"XX

    add MARC."6"XX

    add MARC."7"XX

    add MARC."8"XX

    add MARC."9"XX

end

This rule retains the existing Alma bib record and ignores all fields in the incoming bib record (i.e., the bib record being imported). Testing has shown use of this merge rule changes the way some import profiles behave, such as whether Alma obtains the portfolio URL from the existing bib record or from the bib record being imported. The rule was written by Ex Libris and uses a syntax that is not documented in online help.

[rule "Keep only old value"]

#global variable

global MarcRecord targetObj

As of June 28, 2016, the following rules (created during the migration to Alma period) were present in the Alliance's NZ account, but we have requested Ex Libris delete these rules so they should not be used without consultation with the Alliance's NZ Manager or the Collaborative Workforce Program Manager, Cassie Schmitt.

Current phase: NA	Written by: Bob Thomas
Approved by: NA	Last updated: 06/26/2016
Staff Contact: Cassie Schmitt	Nature of last update: NA

Document History: