Skip to main content
ExLibris
  • Subscribe by RSS
  • Ex Libris Knowledge Center

    Working with Authority Headings Rules

    Translatable
    To work with authority headings rules, you must have the following role:
    • Catalog Administrator
    Authority headings display results for preferred/nonpreferred records (using F3 in the MD Editor) can be expanded to provide greater detail. In some cases, the standard authority headings results display a limited amount of information, as shown in the figure below, making it difficult to determine which record to select, when more than one record appears with the same information in the authority headings results list.
    Standard_Authority_Headings_Results_Display_02_TC.png
    Standard Authority Headings Results Display
    With authority headings rules, the same results can be expanded to display more details, making it easier for the cataloger to determine which record to select:
    Expanded_Authority_Headings_Results_Display_02_TC.png
    Expanded Authority Headings Results Display Configured
    For more information about working with preferred and nonpreferred authority headings, see Managing Authority Records in the MD Editor.
    Authority headings rules use drools-type logic to specify the content and format of the expanded authority headings display. The syntax used for authority headings rules is described in Authority Headings Rules Syntax and Examples.
    For more information, see the Authority Headings Display Options video (4:33 mins).

    Implementing Authority Headings Rules

    In order to work with expanded authority headings display results in the MD Editor, complete the following steps:
    • Create one or more authority headings rules to identify the content and format of the expanded authority headings display. See Creating Authority Headings Rules for more information.
    • Select an authority headings rule for each vocabulary that you want to be able to expand that you have configured on the Metadata Configuration List page (Configuration Menu > Resources > Cataloging > Metadata Configuration) in the Authority Vocabularies section. Since selecting F3 for preferred/nonpreferred headings invokes authority records for a specific vocabulary to be displayed, the authority headings rule needs to be associated with a specific authority vocabulary (managed locally or in the community). Select Set authority heading rule from the list of row actions, select a rule, and select Submit to associate a rule with a specific vocabulary.
      See Configuring Cataloging for more information about the Metadata Configuration List page.

    Creating Authority Headings Rules

    Authority headings rules are created in the MD Editor and appear under the Rules tab in the Authority headings rules folder. Where applicable, you can Duplicate or Copy authority headings rules and modify them to create new rules.
    For Network Zone consortia members, users can control whether to save new rules locally or in a network institution. To make this selection, open the Records or Templates area, and go to New > Placement Options. Note that this selection is per user.
    To create an authority headings rule:
    1. Open the MD Editor page (Resources > Cataloging > Open Metadata Editor).
    2. Select New > Authority headings and enter your authority headings rule properties in the Normalization Rule Properties dialog box.
    3. Select Save. The rules editor opens.
    4. Enter your rule details. For information on the syntax to be used, see Authority Headings Rules Syntax and Examples.
    5. Select Save. The saved authority headings rule appears in the Navigation panel under Rules tab. 
      Authority_Headings_Rules_in_the_MD_Editor_NewUI_02_NL.png
      Saved authority headings rules can be edited, deleted, duplicated (to create new rules), or contributed (to the Community for others to access). You can also modify the rule properties.

    Authority Headings Rules Syntax and Examples

    The authority headings rules follow a specific syntax. See below for an example.
    rule "Expand Headings"
    when
    not preferred
    then
    add to text displayValue
    add to text " | "
    add to text preferredDisplay
    add to text " | "
    add to text from "079.b" if (exists "079.b")
    add to text " | "
    add to text from "035.a" if (exists "035.a.*588*")
    add to text " | "
    add to text from headingSourceField "[9,w]"

    end
    For a description of the authority headings rules syntax, see the table below; and refer to the Conditions Supported for Authority Headings Rules section for the list of supported conditions. Conditions and actions apply to record elements, such as the MARC record, fields (one or more), indicators, subfields (one or more), and field/subfield contents.
    Authority Headings Rules Syntax
    Expression Meaning
    when
    not preferred
    then
    Perform the action only if the heading is the nonpreferred heading.
    when
    preferred
    then
    Perform the action only if the heading is the preferred heading.
    when
    (exists/not exists "<element>")
    then
    Check for fields (exists/non exists) in the authority record (like regular normalization rules).
    Example:
    when
    (not exists "100.d")
    then
    add to text preferredDisplay Add the preferred heading to the display. It shows the preferred heading that matches the format of the record such as MARC 21 or UNIMARC and so forth.
    add to text displayValue Add the displayed headings value.
    add to text "<hard coded value>" Concatenate a hard-coded value to the text such as a pipe character (|).
    Example:
    add to text "|"
    add to text from "<element>" Add a value from the record. This can include field/subfield specifications and conditions. For a list of supported conditions, see the Conditions Supported for Authority Headings Rules section for more information.
    For repeating fields, you can use the first occurrence syntax (onlyfirst) to display only the first instance of the repeating fields.
    For concatenated subfields, you can use the delimited by syntax to add delimiters between subfields.
    Examples:
    add to text from "005" if (not existsControl "005.{0,2}.19")
    add to text from "005" if (existsControl "005.{0,2}.19")
    add to text from "005.{0,4}" if (not existsControl "005.{0,2}.19")
    add to text from "005.{0,4}" if (existsControl "005.{0,2}.19")
    add to text from "005"
    add to text from "005.a"
    add to text from "005.{0,4}"
    add to text from "400.a" if (not exists "400.d.1808*")
    add to text from "400.a" if (exists "400.d.1808*")
    add to text from onlyfirst "035.a" if (not exists "035.a")
    add to text from onlyfirst "035.a" if (exists "035.a.(OCoLC)*")
    add to text from "400.a" delimited by "; "
    add to text from headingSourceField Add the text from the authority headings source field.
    Example:
    add to text from headingSourceField "[a-z]"
    add to text from headingSourceField excluding "<field.subfield>" Add the text from the authority headings source field and excludes the fields specified.
    Example:
    add to text from headingSourceField excluding "[0-9]|e|E"

    Conditions Supported for Authority Headings Rules

    The following conditions are supported for authority headings rules:
    • preferred
    • not preferred
    • existsControl "{element}"
    • not existsControl "{element}"
    • exists "{element}"
    • not exists "{element}"
    • existsMoreThanOnce "{element}"