Local Fields Best Practices, FAQ, and Tables

This page includes:

Best Practices

  • Use local fields for the uses defined in the table of Local Fields in Alma & Primo (below). If a local field is needed for a new use, submit a description of the new requirement to the Program Manager for Technical Services, who will work with the community and Cataloging Standing Group to approve and implement the necessary changes.
  • Most local fields in Alma are designed to mimic a specific non-local MARC 21 field. The local and non-local field equivalencies are shown in the table of Local Fields in Alma & Primo (below). It is essential that local fields that are designed to mimic regular MARC 21 fields must be formatted in the same way as those MARC 21 fields, including indicators and use of subfields, as the Primo normalization rules that control display and searchability are designed based on the assumption that the local fields will be formatted the same as the relevant non-local field.
  • Institutions should include their institution name in headings where it makes sense (for example, ‘Associated Students Collections (Western Washington University)’ rather than ‘Associated Students Collections’). Using institution names in local headings will not cause any problem in Primo and will assist patrons in other institutions in knowing which institution a heading is associated with. However, making changes to existing local headings is not required.
    • Note: The 2016 Local Fields Review Group identified a problem in Primo where using an Ex Libris customer institution code (often, but not always, the same as the normal abbreviation for an institution) causes a problem with the search, even if the abbreviation is present in the heading or in the field containing the heading. This problem was reported in April 2016 in Alliance Salesforce Case #00217673.
  • Be aware that until this bug is fixed, using an abbreviation (for example, ‘Associated Students Collections (WWU)’ may cause a problem in Primo (as described in the working group’s report) if both a) your institution abbreviation and your Ex Libris customer code are the same, and b) a patron uses that abbreviation as a term in a Primo search. Until this bug is fixed, it is recommended institutions not add an additional field (for example, a subfield $5) containing the institution’s abbreviated name to headings or notes, unless it is a practice already in place at your institution. As soon as Ex Libris fixes this Primo software bug, these best practices will be reviewed and modified as appropriate.

Adding Local Fields

Single Records (IZ-only or NZ-linked)

To add local fields to single records, open the record in the Metadata Editor and use the Edit > Add Local Field (CTRL+L) command to add a Local Bib Extension to the record. Although this subfield “$9local” is not displayed in Alma (the local field building icon is displayed instead), it is present in local fields when bib records are exported. Do not use the regular “Add Field” (F8) command, as this will not create a properly localized field.

Record Batches (mix of IZ-only and NZ-linked)

To add local fields to record groups that contain both IZ-only and NZ-linked bib records, you can use an Alma normalization rule to add the desired Local Bib Extension(s). The normalization rule must include the addSubfield command as shown below:

then
addField "590.a.Gift of Julie Andrews."
addSubField "590.9.local" if (not exists "590.9.local")
end

Record Batches (IZ-only)

When working with batches of records that are not linked to the NZ, it is also possible to use an import profile to add Local Bib Extensions to the records. Before running your import, make sure that any local fields in the input .mrc file contain the $9local (or $9LOCAL) to indicate to Alma that they should be created as Local Bib Extensions and not regular fields. For example:

picture showing MARC metadata fields with subfield 9 local
subfield 9 in MARC binary input data

Record Batches (NZ-linked)

If all of the records in your batch are already linked to the Network Zone, you have a couple of different options for adding Local Bib Extensions:

Method 1: Normalization Rules Follow the guidance above for using Normalization rules to add Local Bib Extensions to the set of NZ-linked records.

Method 2: Import Profile Create a set of the desired records and run the “Unlink a set of records from the Network” job on the set. Export the set in MARC binary format and use MarcEdit to add the local fields with the $9local subfield as shown above. Save and compile this file as your input file. Then use an Alma import profile to import the data, choosing to “Merge” the records on match with the “OCA Overlay” merge method. Once you’ve reviewed the records in the IZ to ensure that the house icon appears on the local fields, you can run the “Link a set of records to the Network” job on the set.

FAQ/Notes

  • Information about Local Fields in Alma Online Help. The main online help page on local fields is Network-Managed Records in a Network Zone > Adding Local Extensions to Bibliographic Records in the Network Zone
  • Changing a Field’s Behavior vs. Using a Different Field. If a library has data in a particular local field and that local field does not have the characteristics that they want for that data in terms of display, searchability, and clickability, rather than requesting changes to that field’s characteristics, consider moving the data to a different local field that has the desired characteristics. This can be done by using a norm rule to change the field tag (using the ChangeField command) and, if not already present, add the subfield $9.
  • Alliance Reserved Fields. Fields 972-986 are reserved for use as Alliance-wide notes. Any use of these local note fields will be added to this table after the use is approved by the SCTS Cataloging Standing Group.
  • Institution Reserved Fields. Fields 962-971 are reserved for local institution-defined internal notes. Any Alliance library is free to define any of these fields for local use. No attempt will be made to coordinate consistent use across Alliance libraries. These local internal note fields do not publish to Primo.
  • OCLC Reserved Fields. Fields 936, 938, 956, 987, 989, and 994 are reserved for OCLC use per information contained in OCLC’s Bibliographic Formats and Standards and are not to be used for Alliance or local use in Alma or Primo.
  • Phrase vs. Keyword Searching. Local fields cannot be made “phrase” or “keyword” searchable in Primo, as the Primo normalization rules only control what metadata is indexed for search. They have no influence on how Primo actually searches the data in those search indexes. Phrase versus keyword functionality is controlled in Primo by the user’s search mode. When using basic search, clicking on a hyperlink executes a keyword search. When using advanced search, clicking on the hyperlink executes a phrase search.

Table – Local Fields in Alma & Primo (Overview)

Note: Fields not included in the Alliance Primo VE NR set may be added to the local Primo display via a locally-customized Display Field.

Local fieldDefinitionFormat as ifIn Alliance Primo NR set?Primo Display Field
(link to NRSG documentation)
09XLocal call number
59XLocal notes index
590-594Local institution-defined public notes500No
595Local source of acquisition541No
596Local access restrictions506YesAccess Restrictions
597Local use/reproduction terms540No
598Local standard numberNo
599Local institution-defined public note500No
69XLocal subjects index
690Local–Topical Term650No
691Local–Geographic Name651No
693Local uncontrolled index term653No
694Local Form/Genre655YesGenre (Local)
695Added Class Number090No
696Local Subject Added Entry–Personal Name600No
697Local Subject Added Entry–Corporate Name610No
698Local Subject Added Entry–Meeting Name611No
699Local Subject Added Entry–Uniform Title630No
9XXAlliance-defined local fields
921Alliance-defined CR_RESTRICTED field for course reserve recordsNo
952Local Added Entry–Personal Name700YesRelated Works and Collections (non-analytic titles),
Included Works (analytic titles),
Series (NRSG)
953Local Added Entry–Corporate Name710YesRelated Works and Collections (non-analytic titles),
Included Works (analytic titles),
Series (NRSG)
954Local Added Entry–Meeting Name711YesRelated Works and Collections (non-analytic titles),
Included Works (analytic titles),
Series (NRSG)
955Local Added Entry–Uniform Title730YesRelated Works and Collections (non-analytic titles),
Included Works (analytic titles),
Series (NRSG)
957Local Hierarchical Place Name752No
958Local Added Entry–Local Journal Titles299Optional codeLocal Titles
959Local Added Entry–Varying Form of Title246Optional codeLocal Titles
960Local Added Entry–Uncontrolled Related/Analytical Title740YesRelated Works and Collections
961Local Series Added Entry–Uniform Title830Optional codeLocal Series
972Alliance-defined internal note: Local resource type (for Primo VE)No
973Alliance-defined internal note: Network-level resource type (for Primo VE)No
974Alliance-defined internal note: Retention commitment(s)No
977Alliance-defined internal note: Database A-Z browse (for Primo normalization rules)No
978Alliance-defined internal note: III .b numberNo
979Alliance-defined internal note: Bound-with marker (protects constituent bibs from deletion in the NZ)No
980Alliance-defined internal note: Order Information (e.g., WCP/PromptCat)No
981Alliance-defined internal note: Order Information (e.g., WCP/PromptCat)No

Nature of last update: Updated procedures for adding local fields, moved to new section.