First iteration created in (find original Jira feature)
Bugfixes required for Iris, so this page has been created to document expected behavior for Protecting MARC field and Overriding MARC field protections.
Current constraints:
- MARC field protections are only invoked if a MARC Update action is included in the job profile.
- Based on feedback from the community, consider changing the behavior so that the field protections are invoked automatically.
- One master list of MARC field protections is maintained in Settings/Data import. Unless/until a use case is identified that necessitates differentiation, this same list of field protections will be used for MARC Bibliographic, Authority, and Holdings record imports.
- MARC field protections are controlled at the tenant level, though field protections can be overridden for a particular action profile/job profile.
- Based on feedback from the community, consider adding the ability to include additional field protections in individual job profiles, for MARC fields that are used infrequently or do not normally need to be protected.
- When evaluating data in a subfield, MARC field protections are not case-sensitive. For example $aNcD, $aNCD, $a Ncd, $a ncd, $a ncD would all be considered equivalent and duplicates of each other.
- After testing and early usage, if the community decides that the field protections must take upper and lower case into account for data in subfields, consider changing the behavior so that the field protections are case-sensitive rather than case-insensitive.
- For data in a subfield, the field protection is based on the entire data string.
- Consider supporting wildcards, begins, ends, contains in the future.
Repeatable and Non-repeatable fields:
MARC field protections work differently for repeatable and non-repeatable fields. Here is a list of those fields (spanning all three MARC record types):
- Non-repeatable: LDR, 001, 003, 005, 008, 010, 018, 036, 038, 040, 042, 044, 045, 066, 073, all 1xx fields, 240, 243, 245, 254, 256, 263, 306, 357, 378, 384, 507, 514, 663, 664, 665, 666, 675, 682, 788, 841, 842, 844, 882, and 999 with indicators = ff
- Repeatable: all other MARC fields
Sample Field Protection Settings
| Field | Ind 1 | Ind 2 | Subfield | Data |
|---|---|---|---|---|
| * | * | * | 5 | NcD |
| 035 | * | * | b | MiAaHDL |
| 050 | 9 | 7 | * | * |
| 590 | * | * | * | * |
| 982 | * | * | * | * |
Field Protection Examples and Expected Actions
| Field | Ind 1 | Ind 2 | Subfield | Data |
|---|---|---|---|---|
| * | * | * | 5 | NcD |
Behavior for repeatable fields: Retain existing field. If incoming record has one or more different fields (varying by field, indicator 1 or 2, subfield, or data), add the incoming field(s); if incoming record has a field that is an exact match to an existing field, do not add a duplicate field (if possible).
Behavior for non-repeatable fields: Retain existing field. Discard incoming field.
- Example 1
- Existing: 950 1 2 $a 325167 $5 NcD
- Incoming: 950 1 2 $a 325168 $5 NcD
- Retain existing 950; add incoming 950 (since the $a data is different)
- Example 2
- Existing: 950 1 2 $a 325167 $5 NcD
- Incoming: 950 3 4 $a 325168
- Retain existing 950; add incoming 950(since the indicators and the $a value are different)
- Example 3
- Existing: 950 12 $a325167 $5NcD
- Incoming:
- 950 1 2 $a 325167 $5 NcD
- 950 1 2 $a 325167 $5 NcA
- 950 1 2 $a 325168
- 950 1 2 $a 325169 $5 NcD
- Retain existing 950; add all incoming 950s except the first one (since the first one duplicates an existing field, and the rest do not)
- NOTE TO DEVELOPERS: if incoming duplicate is hard to identify and exclude, then add all incoming for now; and we'll refine to remove duplicates in the future
- Example 4
- Existing field: 010 $a 12345678 $5 NcD
- Incoming: 010 $a 657453647 $5 NcD
- Retain existing 950 ; discard incoming 950 (since 010 is a non-repeatable field)
- Example 5
- Existing field: 010 $a 12345678 $5 NcD
- Incoming: 010 $a 12345678
- Retain existing 950; discard incoming 950 (since 010 is a non-repeatable field)
- Example 6
- Existing: 950 1 2 $a 325167 $5 NcD
- Incoming: no 950
- Retain existing 950
| Field | Ind 1 | Ind 2 | Subfield | Data |
|---|---|---|---|---|
| 035 | * | * | b | MiAaHDL |
Behavior for repeatable fields: Retain existing 035. If incoming record has one or more different 035s (varying by indicator 1 or 2, subfield, or data), add the incoming 035(s); if incoming record has an 035 that is an exact match to an existing 035, do not add a duplicate 035(if possible).
Behavior for non-repeatable fields: Retain existing field. Discard incoming field.
035 is a repeatable field.
- Example 1
- Existing: 035 $a 12345 $b MiAaHDL
- Incoming: 035 $a 4327842 $b MiAaHDL
- Retain existing 035; add incoming 035 (since the $a value is different)
- Example 2
- Existing: 035 $a 12345 $b MiAaHDL
- Incoming: 035 $a 12345 $b MiBaHDL
- Retain existing 035; add incoming 035 (since the $b value is different)
- Example 3
- Existing: 035 $a 12345 $b MiAaHDL
- Incoming:
- 035 $a 12345 $b MiAaHDL
- 035 $a 12345
- 035 $a 6582634 $b MiAaHDL
- 035 $a (OCoLC)743256132
- Retain existing 035; discard first incoming 035 (since it is a duplicate); add all other incoming 035s
- Example 4
- Existing:
- 035 $a 12345 $b MiAaHDL
- 035 $a 12345
- 035 $a 6582634 $b MiAaHDL
- 035 $a (OCoLC)743256132
- Incoming:
- 035 $a 6582636 $b MiAaHDL
- 035 $a (OCoLC)467815642
- Retain the existing 035s with $b MiAaHDL; discard existing 035s without $b MiAaHDL (since they are not protected); add all incoming 035s.
- Existing:
- Example 5
- Existing:
- 035 $a 12345 $b MiAaHDL
- 035 $a 12345
- 035 $a 6582634 $b MiAaHDL
- 035 $a (OCoLC)743256132
- Incoming: no 035s
- Retain the existing 035s with $b MiAaHDL; discard existing 035s without $b MiAaHDL (since they are not protected)
- Existing:
| Field | Ind 1 | Ind 2 | Subfield | Data |
|---|---|---|---|---|
| 050 | 9 | 7 | * | * |
Behavior for repeatable fields: Retain existing 050. If incoming record has one or more different 050s (varying by indicators 1 or 2, subfield, or data in the subfield), add the incoming 050(s); if incoming record has an 050 that is an exact match to an existing 050, do not add a duplicate 050 (if possible).
Behavior for non-repeatable fields: Retain existing field. Discard incoming field.
050 is a repeatable field.
- Example 1
- Existing: 050 8 6 $a MT123 $b .T68 2021
- Incoming: 050 8 6 $a MT123 $b .T68 2021
- Discard existing 050 (since indicators 8 6 are not protected); add incoming 050
- Example 2
- Existing: 050 9 7 $a MT123 $b .T68 2021
- Incoming: 050 8 6 $a MT123 $b .T68 2021
- Retain existing 050; add incoming 050 (since it is not an exact match to existing 050)
- Example 3
- Existing: 050 9 7 $a MT123 $b .T68 2021
- Incoming: 050 9 7 $a MT123 $b .T68 2022
- Retain existing 050; add incoming 050 (since $b data is different)
- Example 4
- Existing field: 050 9 7 $a MT123 $b .T68 2021
- Incoming: 090 9 7 $a MT123 $b .T68 2021
- Retain existing 050; add incoming 090
- Example 5
- Existing:
- 050 9 7 $a MT123 $b .T68 2021
- 050 0 1 $a MT456
- Incoming:
- 050 0 1 $a MT456 $b .T68 2021
- 050 9 7 $a MT123 $b .T68 2021
- 090 0 1 $a MT456 $b .T68 2021
- Retain existing 050 with indicators 9 7; discard existing 050 with indicators 0 1; add incoming 050 with indicators 0 1; discard incoming 050 with indicators 9 7 (since it duplicates an existing 050); add incoming 090
- Existing:
- Example 6
- Existing:
- 050 9 7 $a MT123 $b .T68 2021
- 050 0 1 $a MT456 $b .T68 2021
- 090 0 1 $a MT456 $b .T68 2021
- Incoming: no 050 or 090
- Retain existing 050 with indicators 9 7; discard existing 050 with indicators 0 1; discard existing 090
- Existing:
| Field | Ind 1 | Ind 2 | Subfield | Data |
|---|---|---|---|---|
| 590 | * | * | * | * |
Behavior for repeatable fields: Retain existing 590. If incoming record has one or more 590s (varying by indicators 1 or 2, subfield, or data in the subfield), add the incoming field(s); if incoming record has a 590 that is an exact match to an existing 590, do not add a duplicate 590 (if possible).
Behavior for non-repeatable fields: Retain existing field. Discard incoming field.
590 is a repeatable field.
- Example 1
- Existing: 590 1 1 $a Some important note
- Incoming: 590 2 2 $a Another important note
- Retain existing 590; add incoming 590
- NOTE TO DEVELOPERS: Existing 590s would always be retained, and incoming 590s would always be added, since the indicators, subfields, and data do not matter. An incoming 590 would only be discarded if it duplicates an existing 590.
- Example 2
- Existing:
- 590 1 1 $a Some important note
- 590 2 2 $a Another important note
- Incoming: 590 1 1 $b Some other kind of note
- Retain all existing 590s; add incoming 590
- Existing:
- Example 3
- Existing:
- 590 1 1 $a Some important note
- 590 2 2 $a Another important note
- 590 1 1 $b Some other kind of note
- Incoming:
- 590 1 1 $a Some important note
- 590 2 1 $c Some important note
- 590 1 1 $d Some important note
- Retain all existing 590s; discard first incoming 590 (since it duplicates an existing one); add all other incoming 590s
- Existing:
- Example 4
- Existing:
- 590 1 1 $a Some important note
- 590 2 2 $a Another important note
- 590 1 1 $b Some other kind of note
- 590 2 1 $c Some important note
- 590 1 1 $d Some important note
- 591 1 1 $a Some important note
- Incoming: no 590s
- Retain all existing 590s; discard the existing 591 (since it is not protected)
- Existing:
| Field | Ind 1 | Ind 2 | Subfield | Data |
|---|---|---|---|---|
| 982 | * | * | * | * |
Behavior for repeatable fields: Retain existing 982. If incoming record has one or more different 982s (varying by indicators 1 or 2, subfield, or data in the subfield), add the incoming 982(s); if incoming record has a 982 that is an exact match to an existing 982, do not add a duplicate 982 (if possible).
Behavior for non-repeatable fields: Retain existing field. Discard incoming field.
982 is a repeatable field.
- Example 1
- Existing: 982 $a 20210531
- Incoming: 982 $a 20210531 $a 20210602
- Retain existing 982; add incoming 982
- Example 2
- Existing: 982 $a 20210531 $a 20210602
- Incoming: 982 1 1 $a 20210531 $a 20210602
- Retain existing 982; add incoming 982 (since indicators are different)
- Example 3
- Existing: 982 $a 20210531 $a 20210602
- Incoming:
- 982 $a 20210531 $a 20210602
- 982 2 2 $z 20210531
- Retain existing 982; discard the first incoming 982 (since it duplicates an existing one); retain the second incoming 982
- Example 4
- Existing:
- 982 $a 20210531 $a 20210602
- 982 2 2 $z 20210531
- Incoming: no 982s
- Retain existing 982s
- Existing:
| Field | Ind 1 | Ind 2 | Subfield | Data |
|---|---|---|---|---|
| * | * | * | 5 | NcD |
| 982 | * | * | * | * |
- Example 1
- Existing: 982 $a 20210531 $a 20210602 $5 NcD
- Incoming: 982 1 1 $a 20210531 $a 20210602
- Retain existing 982; add incoming 982 (since indicators are different)
- Example 2
- Existing:
- 050 $a MT123 $b .T68 2021 $5 NcD
- 050 $a MT123 $b .T68 2022
- 982 $a 20210531 $a 20210602 $5 NcD
- 982 2 2 $z 20210531
- Incoming: no 050 or 982
- Retain existing 050 with $5 NcD; discard existing 050 without $5 NcD; retain both 982s
- Existing: