Current issues - jhu-library-applications/levy-api GitHub Wiki

Fields

Restricted field

As of 2021-12, it appears that the Restricted field does not actually restrict the public viewing of images. In an ideal world, when you click the Restricted box for an image, it should restrict the public from viewing the image. Currently Drupal Levy does not do this.

This may have something to do with the admin/people/permissions Levy Restricted Content that is badly configured, because when I log-in, restricted images do not display, and when I log out, the restricted images do display. Here's an example: https://levy-test.mse.jhu.edu/collection/012/061.

As of 2021-12, there are 2,199 Levy items with at least one restricted image paragraph (a total of 9,570 image paragraphs, which may or may not have actual image files attached to them). I'm not sure if any of those images are actual images of music or not, although I could check.

Is Public Domain field

More investigation into this issue is needed, but it appears clicking the "Public Domain" checkbox as an end-user does not work. It's unclear to me if this is because the Is Public Domain field is not being completed in the metadata (should be checked off if the music is before 1927) or a different issue. However, from a metadata perspective, since the value of this field changes over time it would be better to remove this field entirely and create some sort of searching mechanism that relies on a formula like: if Current Year - Publish Date Year = 95, then Public Domain is True.

Publish Date Year field

This field has not been consistently filled out, which impacts end-user searching. As of 2022, the API Search Forms rely on this field being completed to let end-users search "Published After" and "Published Before." As of 2021-12, there around 200 items where the Publish Date Year field should be added. I wrote a script, getNode_levy_colection_item_withoutField.py, that should allow you to retrieve nodes by any empty/incomplete field.

Taxonomies

Subjects

Normalizing varieties in spelling, capitalization, and plurality would greatly help collocate related items and improve user searching. It would be ideal to associate or base improve subject headings off a controlled vocabulary like FAST.

Creator roles

Normalizing varieties in spelling, capitalization, and plurality would greatly help collocate related items and improve user searching.

Instrumentation Metadata

Normalizing varieties in spelling, capitalization, and plurality would greatly help collocate related items and improve user searching.

Publisher

I would recommend copying the current Publisher information into a free text-field and then normalizing the Publisher names so variations in addresses, abbreviations, and capitalization do not impact searching.

Images and Files

Default image

As of 2021-12, the Default image displayed in Drupal for items that have no image uploaded is an image that says "Image Unavailable." This is confusing to users, as it is unclear if the image is restricted or if they are experiencing a technical error. This default image is currently displayed in the following situations:

  • Pre-1927 songs without images. These are either scanning errors/duplicates that weren’t scanned or irregular image sizes (very large or small sheet music). The latter category represents the songs with no images but PDF files-- assumed the images were left blank because the irregular size wasn’t displayable.

  • Post-1927 songs still in copyright.

It is relatively easy to change the default image to the "Song Under Copyright" Image. The default image can be changed at Home -->Administration-->Structure-->Paragraphs types-->Collection item image-->Manage fields--Edit Item Image field. However, changing this changes the default image for all songs without an image rather than just those under copyright.

Possible solutions:

  1. Create two filler images:

    • A filler image for pre-1927 songs without images. Text would say “Song not displayed due to irregular size. Please download PDF.”
    • A filler image for post-1927 songs and songs that don't fall into previous category. Text would say “Song unavailable or under copyright. Please contact us if you would like a copy for personal research or study.”
  2. Upload a filler image to each pre-1927 songs without images. Text would say “Song not displayed due to irregular size. Please download PDF.” Change default filler image to “Song unavailable or under copyright. Please contact us if you would like a copy for personal research or study."

  3. Upload all files and images for songs to Drupal and set-up a timed-based embargo/restriction for post-1927 items. This would make the images and files available automatically rather than requiring manual upload.