vandelay copy overlay : release notes 1docs/RELEASE_NOTES_NEXT/vandelay-copy-overlay.txt

Signed-off-by: Bill Erickson <berick@esilibrary.com>

diff --git a/docs/RELEASE_NOTES_NEXT/vandelay-copy-overlay.txt b/docs/RELEASE_NOTES_NEXT/vandelay-copy-overlay.txt
new file mode 100644 (file)
index 0000000..0c07254
--- /dev/null
+++ b/docs/RELEASE_NOTES_NEXT/vandelay-copy-overlay.txt
@@ -0,0 +1,30 @@
+Vandelay (MARC Import/Export) Copy Overlay
+------------------------------------------
+
+Vandelay Item Attributes (Cataloging -> MARC Import / 
+Export -> Import Item Attribute Definitions) contains 
+a new field called "Overlay Match ID".  The presence of data 
+in this field indicates to the Vandelay import process that a 
+copy overlay is requested instead of new copy creation.  The 
+value for the field is the copy id for bib record queues and the
+ACQ lineitem_detail ID for Acquisitions Queues.  For either type 
+of queue, however, overlay occurs against a real copy (asset.copy).
+In the ACQ queue case, we use the lineitem_detail ID because this 
+is the data ACQ providers have access to.
+
+When a value is a set and a matching copy is found, the values 
+extracted from the inbound copy data are used to replace values
+on the existing found copy.  Any fields on the inbound copy
+that are empty are ignored.
+
+Permission
+~~~~~~~~~~
+
+This adds a new permission called IMPORT_OVERLAY_COPY which is 
+to perform the copy overlay step.
+
+Regardless of permission, it is not possible to overlay values on
+a copy unless the imported bib record links to (creates/overlays/merges)
+the owning bib record for the copy to be overlaid.  This is both
+for security and removal of a potentially potent foot-gun.
+