How to allow a musical excerpt to be played on bibliographic record on the OPAC

This document will outline how allow a section of a musical score to be playing on the OPAC for bibliographic records that have musical details recorded in the 031 fields. Using this feature depends on working with a framework that includes 031 fields and setting two system preferences.

Navigate to the MARC framework to be edited

Go to Koha administration > Catalog > MARC bibliographic framework

This will take you to a page with a table of the frameworks available on your site. 

The framework with Default framework in the Description column and a blank field in the Code column is the Default framework. This Default framework should never be edited. 

If you require more assistance with editing frameworks, please contact Interleaf Technology with a Changes to Framework form filled out. 

Please note that the Default framework should never be edited. 

Edit the framework

Identify the framework from the table to be edited and click the Actions button to the right hand side of the line the framework is on. This will create a dropdown menu. Select MARC structure from this dropdown menu. 

This will bring up a page with a table of the fields in the framework. 

Across the top of the table there will be a search box, which can be used to limit the table to a specific field.

Use this search box to narrow the table down to the 031 field.

Once the table has been reduced to the specific field to be edited, click the Actions button to the right hand side of the line the tag is on. This will create a dropdown menu. Select Edit subfields from this menu.

This will open a new page where the subfields that make up the tag appear. The subfields will be split into different tabs, based on the alphabetic and numeric representation. 

The fields that should be enabled are:

2 - System Code

For defining how the music has been encoded in field $p.

g - Clef

For defining the clef is the musical score uses.

n - Key signature

For defining the key signature the musical score uses.

o - Time signature

For defining the beats in the musical score.

p - Musical notation

For defining the actual notes contained in the musical score, based on the code defined in field $2.

u - Uniform Resource Identifier

For defining a link to a recording of the full musical score.

For more details on how to use these fields in practice, please check the Library of Congress guide:

Go to the Advanced constraints section.

On the Visibility line, make sure the Editor option is ticked. 

Click Save changes.

Setting the system preferences

There are two system preferences that need to be set for the playing option to appear on the OPAC.

Go to Koha administration > Global System Preferences and search for OPACShowMusicalInscripts.

This will bring up a system preference of the same name. 

Set this system preference to Show musical inscripts on the OPAC record details page and click the Save all OPAC preferences button.

For the second system preference, go to Koha administration > Global System Preferences and search for OPACPlayMusicalInscripts.

This will bring up a system preference of the same name. 

Set this system preference to Play MIDI representation of musical inscripts on the OPAC record details page and click the Save all OPAC preferences button.

Filling in a record with the edited framework

Using the framework the 031 fields were added to previously, create or edit a new bibliographic record. Navigate to the 031 fields.

For more details about the cataloguing process itself, please contact Interleaf Technology directly.

For the best results, fill in all the present fields. Below is an example of a record will all fields filled out.

Display on the OPAC

Once the fields have been filled out successfully, a musical score will appear on the bibliographic record on the OPAC, which will include the option of playing the snippet.

To hear the displayed musical score, click the Play this sample link. 

If the 031$u field is filled out, this display will also include an Audio file link, which will bring the patron to a recording of the music.

Please note, the speed of the music may be difficult to set.

Version	Date	Detail	Author
1.0	04/08/22	Document created	Holly Cooper

• Related Articles

• How to display a musical score on a record on the OPAC

  This document will outline how allow a section of a musical score to appear on the OPAC for bibliographic records that have musical details recorded in the 031 fields. Using this feature depends on working with a framework that includes 031 fields ...

• Options for the OPAC

  Options for the OPAC - Non- JCSP This table of information is intended to outline the various options non-JCSP sites have for manipulating the site to improve student experiences. - Easy and usable search facility that generates returns to students ...

• How to set a bibliographic level item type

  This document will outline how to set Koha to use bibliographic level item types rather than item level items types for circulation. It is possible to provide item level items types on individual item records while at the same time use an overall ...

• How to allow item level holds on the OPAC

  This document will outline the options for using item level holds on the OPAC. An item level hold means students can place a hold on a specific copy of an item, rather than needing to place a hold on the title and take whichever copy the library ...

• How to store record creator and editor information in MARC fields

  It is possible to note information about the record creator and the last user to make an edit in the MARC record. Step 1 - Designate MARC fields to store the information The fields to store information related to the creator and editor of the record ...