Bug 34648 - Update MARC21 frameworks to Update 31 (December 2020)
Summary: Update MARC21 frameworks to Update 31 (December 2020)
Status: CLOSED FIXED
Alias: None
Product: Koha
Classification: Unclassified
Component: MARC Bibliographic data support (show other bugs)
Version: unspecified
Hardware: All All
: P5 - low enhancement
Assignee: Caroline Cyr La Rose
QA Contact: Katrin Fischer
URL:
Keywords:
Depends on:
Blocks: 34649
  Show dependency tree / graph
 
Reported: 2023-08-29 20:12 UTC by Caroline Cyr La Rose
Modified: 2024-07-04 20:37 UTC (History)
3 users (show)

See Also:
Change sponsored?: ---
Patch complexity: Small patch
Documentation contact:
Documentation submission:
Text to go in the release notes:
This enhancement updates the default MARC21 bibliographic framework to reflect changes brought to the format by Update 31 (Dec. 2020). Note that this only affects new installations. For existing installations, you can modify your MARC frameworks in Administration > MARC bibliographic framework. Details of Update 31 are on the Library of Congress Website: https://www.loc.gov/marc/up31bibliographic/bdapndxg.html
Version(s) released in:
23.11.00
Circulation function:

Attachments
Bug 34648: Update MARC21 frameworks to Update 31 (December 2020) (24.37 KB, patch)
2023-08-29 21:04 UTC, Caroline Cyr La Rose 		Details | Diff | Splinter Review
Bug 34648: (follow up) updated comment (1.07 KB, patch)
2023-08-29 21:12 UTC, Caroline Cyr La Rose 		Details | Diff | Splinter Review
Bug 34648: (fixup) Update MARC21 frameworks to Update 31 (December 2020) (1.48 KB, patch)
2023-08-31 13:04 UTC, Caroline Cyr La Rose 		Details | Diff | Splinter Review
Bug 34648: Update MARC21 frameworks to Update 31 (December 2020) (24.42 KB, patch)
2023-08-31 19:29 UTC, David Nind 		Details | Diff | Splinter Review
Bug 34648: (follow up) updated comment (1.11 KB, patch)
2023-08-31 19:29 UTC, David Nind 		Details | Diff | Splinter Review
Bug 34648: (fixup) Update MARC21 frameworks to Update 31 (December 2020) (1.53 KB, patch)
2023-08-31 19:30 UTC, David Nind 		Details | Diff | Splinter Review
Bug 34648: Update MARC21 frameworks to Update 31 (December 2020) (24.47 KB, patch)
2023-10-06 11:35 UTC, Katrin Fischer 		Details | Diff | Splinter Review
Bug 34648: (follow up) updated comment (1.17 KB, patch)
2023-10-06 11:35 UTC, Katrin Fischer 		Details | Diff | Splinter Review
Bug 34648: (fixup) Update MARC21 frameworks to Update 31 (December 2020) (1.58 KB, patch)
2023-10-06 11:36 UTC, Katrin Fischer 		Details | Diff | Splinter Review
Show Obsolete (6) View All Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Caroline Cyr La Rose 2023-08-29 20:12:22 UTC 
https://www.loc.gov/marc/up31bibliographic/bdapndxg.html

UPDATE 31 CHANGES
■ New content designators:
Fields
335Extension Plan (R)
881Manifestation Statements (R)
Subfields
$c Aspect ratio value (R) in 345 (Moving Image Characteristics)
$d Aspect ratio designator (R) in 345 (Moving Image Characteristics)
$p Illustrative content (R) in 340 (Physical Medium)

■ Obsolete content designators:
Subfields
The following subfields were made obsolete in field 856 (Electronic Location and Access):

$bAccess number (R)
$hProcessor of Request (NR)
$i Instruction (R)
$j Bits per second (NR)
$kPassword (NR)
$l Logon (NR)
$nName of location of host (NR)
$rSettings (NR)
$tTerminal emulation (R)

■ Changes in content designator names and definitions:
Fields
345Projection Characteristics of Moving Image renamed Moving Image Characteristics

■ Fast-track changes:
Field
043Geographic Area Code changed to repeatable
New Subfields
$0 Authority record control number or standard number (R) in 384 (Key)
$1 Real World Object URI (R) in 384 (Key)
Comment 1 Caroline Cyr La Rose 2023-08-29 21:04:11 UTC Comment hidden (obsolete)
Comment 2 Caroline Cyr La Rose 2023-08-29 21:06:05 UTC 
Commit message should say Update 31...
Comment 3 Caroline Cyr La Rose 2023-08-29 21:12:21 UTC Comment hidden (obsolete)
Comment 4 David Nind 2023-08-30 22:21:02 UTC 
Nice work Caroline!

The only one thing I noted is that 881$a is missing.

Is there a general rule about where a tag and subfields should be visible in the editor or not?

Testing notes (using KTD):

1. After the patch is applied, I used reset_all to make the changes to the default framework visible. flush_memcached and restart_all with a fresh browser wasn't sufficient.
Comment 5 Caroline Cyr La Rose 2023-08-31 13:04:59 UTC Comment hidden (obsolete)
Comment 6 Caroline Cyr La Rose 2023-08-31 13:14:22 UTC 
Thanks David!

I knew I could count on your eagle eye :)

I don't know of any standard way of determining visibility for new fields. This is my first time doing a MARC update this way... I admit I mostly copy-pasted other fields and didn't really look at visibility other than when it was "Non public note" or something similar.

I was hoping for feedback, so if you think it should be something else, don't hesitate to let me know.

Caroline
Comment 7 David Nind 2023-08-31 19:29:57 UTC 
Created attachment 155040 [details] [review]
Bug 34648: Update MARC21 frameworks to Update 31 (December 2020)

This patch updates the default MARC21 framework to reflect the changes brought by Update 30 (Dec. 2020).

To test:
1. Apply patch and restart
2. Go to Administration > MARC bibliographic framework
3. Click "Actions" next to the default framework and choose "MARC structure"
4. Check for the changes detailed in the update https://www.loc.gov/marc/up31bibliographic/bdapndxg.html

- Field 043 should now be repeatable

- There should be a new field 335, named EXTENSION PLAN
  - This field should be repeatable
  - Subfields:
    - 0 Authority record control number or standard number (R)
    - 1 Real World Object URI (R)
    - 2 Source (NR)
    - 3 Materials specified (NR)
    - 6 Linkage (NR)
    - 8 Field link and sequence number (R)
    - a Extension plan term (NR)
    - b Extension plan code (NR)
    **Note that subfield 7 was added in a later update and is therefore not included in this patch

- Field 345 should now be named MOVING IMAGE CHARACTERISTICS
  - There should be two new subfields
    - c Aspect ratio value (R)
    - d Aspect ratio designator (R)

- There should be two new subfields in field 384
  - 0 Authority record control number or standard number (R)
  - 1 Real World Object URI (R)

- The following subfields of field 856 should have an [OBSOLETE] mention and be hidden (shown in OPAC and intranet, but not editor)
  - b Access number [OBSOLETE]
  - h Processor of Request [OBSOLETE]
  - i Instruction [OBSOLETE]
  - j Bits per second [OBSOLETE]
  - k Password [OBSOLETE]
  - l Logon [OBSOLETE]
  - n Name of location of host [OBSOLETE]
  - r Settings [OBSOLETE]
  - t Terminal emulation [OBSOLETE]

- There should be a new field 881, named MANIFESTATION STATEMENTS
  - This field should be repeatable
  - Subfields:
    - 3 Materials specified (NR)
    - 6 Linkage (NR)
    - 8 Field link and sequence number (R)
    - a Manifestation statement, high-level/general (R)
    - b Manifestation identifier statement (R)
    - c Manifestation title and responsibility statement (R)
    - d Manifestation edition statement (R)
    - e Manifestation production statement (R)
    - f Manifestation publication statement (R)
    - g Manifestation distribution statement (R)
    - h Manifestation manufacture statement (R)
    - i Manifestation copyright statement (R)
    - j Manifestation frequency statement (R)
    - k Manifestation designation of sequence statement (R)
    - l Manifestation series statement (R)
    - m Manifestation dissertation statement (R)
    - n Manifestation regional encoding statement (R)

Signed-off-by: David Nind <david@davidnind.com>
Comment 8 David Nind 2023-08-31 19:29:59 UTC 
Created attachment 155041 [details] [review]
Bug 34648: (follow up) updated comment

Signed-off-by: David Nind <david@davidnind.com>
Comment 9 David Nind 2023-08-31 19:30:02 UTC 
Created attachment 155042 [details] [review]
Bug 34648: (fixup) Update MARC21 frameworks to Update 31 (December 2020)

Added missing 881$a subfield.

Signed-off-by: David Nind <david@davidnind.com>
Comment 10 David Nind 2023-08-31 19:32:40 UTC 
(In reply to Caroline Cyr La Rose from comment #6)
> Thanks David!
> 
> I knew I could count on your eagle eye :)
> 
> I don't know of any standard way of determining visibility for new fields.
> This is my first time doing a MARC update this way... I admit I mostly
> copy-pasted other fields and didn't really look at visibility other than
> when it was "Non public note" or something similar.
> 
> I was hoping for feedback, so if you think it should be something else,
> don't hesitate to let me know.
> 
> Caroline

Thanks for updating Caroline!

I don't have any particular feedback on visibility, so I guess we will see if there is any other feedback.
Comment 11 Katrin Fischer 2023-10-06 11:35:57 UTC 
Created attachment 156609 [details] [review]
Bug 34648: Update MARC21 frameworks to Update 31 (December 2020)

This patch updates the default MARC21 framework to reflect the changes brought by Update 30 (Dec. 2020).

To test:
1. Apply patch and restart
2. Go to Administration > MARC bibliographic framework
3. Click "Actions" next to the default framework and choose "MARC structure"
4. Check for the changes detailed in the update https://www.loc.gov/marc/up31bibliographic/bdapndxg.html

- Field 043 should now be repeatable

- There should be a new field 335, named EXTENSION PLAN
  - This field should be repeatable
  - Subfields:
    - 0 Authority record control number or standard number (R)
    - 1 Real World Object URI (R)
    - 2 Source (NR)
    - 3 Materials specified (NR)
    - 6 Linkage (NR)
    - 8 Field link and sequence number (R)
    - a Extension plan term (NR)
    - b Extension plan code (NR)
    **Note that subfield 7 was added in a later update and is therefore not included in this patch

- Field 345 should now be named MOVING IMAGE CHARACTERISTICS
  - There should be two new subfields
    - c Aspect ratio value (R)
    - d Aspect ratio designator (R)

- There should be two new subfields in field 384
  - 0 Authority record control number or standard number (R)
  - 1 Real World Object URI (R)

- The following subfields of field 856 should have an [OBSOLETE] mention and be hidden (shown in OPAC and intranet, but not editor)
  - b Access number [OBSOLETE]
  - h Processor of Request [OBSOLETE]
  - i Instruction [OBSOLETE]
  - j Bits per second [OBSOLETE]
  - k Password [OBSOLETE]
  - l Logon [OBSOLETE]
  - n Name of location of host [OBSOLETE]
  - r Settings [OBSOLETE]
  - t Terminal emulation [OBSOLETE]

- There should be a new field 881, named MANIFESTATION STATEMENTS
  - This field should be repeatable
  - Subfields:
    - 3 Materials specified (NR)
    - 6 Linkage (NR)
    - 8 Field link and sequence number (R)
    - a Manifestation statement, high-level/general (R)
    - b Manifestation identifier statement (R)
    - c Manifestation title and responsibility statement (R)
    - d Manifestation edition statement (R)
    - e Manifestation production statement (R)
    - f Manifestation publication statement (R)
    - g Manifestation distribution statement (R)
    - h Manifestation manufacture statement (R)
    - i Manifestation copyright statement (R)
    - j Manifestation frequency statement (R)
    - k Manifestation designation of sequence statement (R)
    - l Manifestation series statement (R)
    - m Manifestation dissertation statement (R)
    - n Manifestation regional encoding statement (R)

Signed-off-by: David Nind <david@davidnind.com>
Signed-off-by: Katrin Fischer <katrin.fischer@bsz-bw.de>
Comment 12 Katrin Fischer 2023-10-06 11:35:59 UTC 
Created attachment 156610 [details] [review]
Bug 34648: (follow up) updated comment

Signed-off-by: David Nind <david@davidnind.com>
Signed-off-by: Katrin Fischer <katrin.fischer@bsz-bw.de>
Comment 13 Katrin Fischer 2023-10-06 11:36:02 UTC 
Created attachment 156611 [details] [review]
Bug 34648: (fixup) Update MARC21 frameworks to Update 31 (December 2020)

Added missing 881$a subfield.

Signed-off-by: David Nind <david@davidnind.com>
Signed-off-by: Katrin Fischer <katrin.fischer@bsz-bw.de>
Comment 14 Katrin Fischer 2023-10-06 11:36:37 UTC 
A lot of fiddly work - thank you!
Comment 15 Tomás Cohen Arazi (tcohen) 2023-10-09 14:43:30 UTC 
Pushed to master for 23.11.

Nice work everyone, thanks!
Comment 16 Fridolin Somers 2023-10-09 19:48:32 UTC 
Enhancement not pushed to 23.05.x
Comment 17 Aude Charillon 2023-11-27 15:09:55 UTC 
Checked Koha Manual - no update needed.