Hyrax Stack Walkthrough

This guide assumes you are staring with a template generated instance of Hyrax.

Goals:

• Understand the way an item in Hyrax
  • is displayed in the User Interface,
  • is represented in the application Code
  • is stored in Fedora Commons
  • is indexed in Solr

Lesson Setup

• If you're running in a VM, change to the /vagrant directory
  cd /vagrant
• Clone this repository and check out the lesson:
  git clone -b walkthrough https://github.com/RepoCamp/ohsu2018.git && cd ohsu2018
• Update dependencies:
  bundle install
• Run migrations:
  rails db:migrate
• Sart the development environment servers:
  rails hydra:server
  This launches development instances of Solr, Fedora, and your web application server
• Create the default Admin Set:
  rails hyrax:default_admin_set:create

Steps

1. Inspect an empty repository
   You rarely see this in the real world...

   • User Interface: go to http://localhost:3000, click on the search icon
     you should see a message like "No results found for your search"
   • Code: in a new terminal window, rails console, then enter Work.count, then Collection.count
     both should return 0
   • Fedora: go to http://localhost:8984/rest/
     check the number of children
   • Solr: go to http://localhost:8983/solr/#/hydra-development
     note the document counts under "Statistics"

2. Set up a user and create a work using the User Interface

   1. Go to go to http://localhost:3000, click on the Login link in the upper right hand corner
   2. If you haven't created a user yet, click the Sign up link just below the login button
   3. Enter your chosen e-mail and password
   4. If you're not already there, click on the Dashboard link to go to your user dashboard
   5. Click on the Create Work link to add a new item to the repository
      Notice the Requirements section in the SAVE WORK panel
   6. Fill out the fields marked with blue required labels
      Notice the Requirements section in the SAVE WORK panel
   7. Click on the Files tab
   8. Click on the + Add Files button and select a file to upload
      NOTE: there are sample files to use in your tutorial/samples folder
      Notice the Requirements section in the SAVE WORK panel
   9. Click the checkbox for the deposit agreement and click the SAVE button
   10. Wait a second and take a look at your new Work!

3. Now that you have something in your repository, let's take a look at it

   • User Interface: go to http://localhost:3000, click on the search icon
     you should see your new item listed in the results along with a facet list to the left
   • Code: check Work.count, then Collection.count again
     you now have 1 work and no collections
   • Fedora: go to http://localhost:8984/rest/ and you'll see a new child container.
     Click on the link to http://localhost:8984/rest/dev and take a look
     note the number of children in this container
   • Solr: go to http://localhost:8983/solr/#/hydra-development
     check whether the document counts under "Statistics" has changed

4. Find a work by it's ID

   • User Interface: go to http://localhost:3000/concerns/works/**ID**
   • Code: w = Work.find(id)
   • Fedora: First find the work using the rails console, the get a link to it using w.uri
   • Solr: go to http://localhost:8983/solr/#/hydra-development/query enter id:your_works_id_here in the "q" field and click the "Execute Query" button

Exercises

1. Add an optional field using the User Interface

   • Verify the change in the Code. HINT use the ID in the url and use it to find the item using the console.
     You might need to use the .reload method to refresh attributes in memory.
   • Verify the change in Fedora.
   • Verify the change in Solr.

2. What other fields are available? Does what you see in the User Interface match the code at hyrax/basic_metadata.rb?
   Also see: https://github.com/no-reply/sufia-profile/blob/master/profile.md

3. What happens when you add multiple entries for a field?

4. What happens when you remove all the entries for a field?

5. Add a second description using the console. HINT you'll need to use the .save method to make changes in memory permanent in Solr and Fedora.

   • Verify the change in the User Interface.
   • Verify the change in Fedora.
   • Verify the change in Solr.

6. Find the access controls in Fedora

   • Change the access control using the User Interface
   • What changes in Fedora

7. Create an empty Collection using the User Interface

   • Verify that Collection.count has changed in the rails console
   • What does the collection look like in Code?
   • What does the collection look like in Fedora?
   • What does the collection look like in Solr?

8. Add a new Work to your collection using the User Interface

   • What does the Work look like in CODE
   • What does the collection look like now in Code?
   • What does the collection look like now in Fedora?
   • What does the collection look like now in Solr?
   • What does the Work look like in Solr?

9. Attach and image to an Work using the UI. Then look at FileSets (#file_sets) and Files (#files) in the rails console

   1. Find the original file_name
   2. Display the width, height, color_space, profile_name, size, mime_type, fits_version
   3. Inspect the content
   4. show predicate mappings inherited from Hydra::Works::Characterization::ImageSchema https://github.com/projecthydra/hydra-works/blob/master/lib/hydra/works/characterization/schema/image_schema.rb