Skip to main content
ExLibris

Knowledge Assistant

BETA
 
  • Subscribe by RSS
  • Back
    Voyager

     

    Ex Libris Knowledge Center
    1. Search site
      Go back to previous article
      1. Sign in
        • Sign in
        • Forgot password
    1. Home
    2. Voyager
    3. Knowledge Articles
    4. Explanation of the overlayAction element in Voyager patron XML import

    Explanation of the overlayAction element in Voyager patron XML import

    1. Last updated
    2. Save as PDF
    3. Share
      1. Share
      2. Tweet
      3. Share
    1. Question
    2. Answer
    3. Additional Information
    • Product: Voyager
    • Relevant for Installation Type: Multi-Tenant Direct, Dedicated-Direct, Local, TotalCare

     

    Question

    How does the <overlayAction> tag (element) work in the patron XML import file?

    Answer

    For a specific set1 of individual elements of the patron record (such as temp addresses or notes), there are two options: Add or Overlay.

    When Add is selected, existing elements are left in the database for this particular type, and the new ones are added.

    When Overlay is selected, all existing elements of the specified type are removed and then the new ones are added.

    1Add/Overlay works with Addresses, Email addresses, notes, and statistics.

    This ONLY applies to the Add and Update options in the <action> element.

    Example (replaces all existing patron statistical categories with "ADM"):

        <patronStatList>
          <overlayAction>Overlay</overlayAction>
          <patronStat>ADM</patronStat>
        </patronStatList>

    Additional Information

    So, for example, for patron notes, when Overlay is specified, all notes are removed and then whatever is in the file is added in its place.

    You can not batch delete overlay elements.  For an example see Can use Voyager patron XML utilities to batch update or delete patron notes

    If you don't want to update patron notes, you can remove the <noteList> element and then the patron notes will not be updated.

    See Chapter 5 of the Technical User's Guide for further details.


    • Article last edited: 04-Mar-2021
    View article in the Exlibris Knowledge Center
    1. Back to top
      • Expiring patron records in Voyager
      • Export File of MARC Records with GDC
    • Was this article helpful?

    Recommended articles

    1. Article type
      Topic
      Language
      English
      Product
      Voyager
    2. Tags
      This page has no tags.
    1. © Copyright 2025 Ex Libris Knowledge Center
    2. Powered by CXone Expert ®
    • Term of Use
    • Privacy Policy
    • Contact Us
    2025 Ex Libris. All rights reserved