docs/RELEASE_NOTES_NEXT/vandelay-copy-overlay.txt

   1 Vandelay (MARC Import/Export) Copy Overlay
   2 ------------------------------------------
   3
   4 Vandelay Item Attributes (Cataloging -> MARC Import /
   5 Export -> Import Item Attribute Definitions) contains
   6 a new field called "Overlay Match ID".  The presence of data
   7 in this field extracted from an import-item copy indicates
   8 to the Vandelay import process that a copy overlay is requested
   9 instead of new copy creation.  The value for the field is the
  10 copy id for bib record queues and the ACQ lineitem_detail ID for
  11 Acquisitions Queues.  For either type of queue, however, overlay
  12 occurs against a real copy (asset.copy).  In the ACQ queue case,
  13 we use the lineitem_detail ID because this is the data ACQ
  14 providers and sub-systems will have access to.
  15
  16 When a match point ID value is a set and a matching copy is found,
  17 the values extracted from the inbound copy data are used to replace
  18 values on the existing found copy, including the call-number label.
  19 Any fields on the inbound copy that are empty are ignored.
  20
  21 One use case for this feature are shelf-ready items produced by a
  22 3rd-party (e.g. ACQ provider) and delivered to the library via MARC
  23 file for upload.  The file might contain improved MARC bibliographic
  24 data as well as real barcodes (i.e. not temporary ACQ generated
  25 barcodes) for the copies already purchased through the vendor.
  26
  27 Permission
  28 ~~~~~~~~~~
  29
  30 This adds a new permission called IMPORT_OVERLAY_COPY which is
  31 required to perform the copy overlay step.
  32
  33 Regardless of permission, it is not possible to overlay values on
  34 a copy unless the imported bib record links (creates/overlays/merges)
  35 to/with the owning bib record for the copy to be overlaid.  This is
  36 both for security and removal of a potent foot-gun.
  37