Actor Stack and Workflows

Lesson Goals:

• Understand the Hyrax Actor Stack

  • What does the actor stack do,
  • What are the default actors in Hyrax
  • How do you customize Actor Stack behavior

• Understand workflows

  • What is mediated deposit
  • What are the default workflows installed with Hyrax
  • How do you customize customize Hyrax workflows

Steps

Actor Stack

1. What kinds of things seem to be happening here: https://github.com/samvera/hyrax/blob/master/app/services/hyrax/default_middleware_stack.rb
2. Compare this version:
   https://github.com/UCLALibrary/californica/blob/master/app/services/californica/ingest_middleware_stack.rb
3. To create a custom actor, begin by reading the comments here: https://github.com/samvera/hyrax/blob/master/app/services/hyrax/curation_concern.rb

Workflows

1. Create a second user
2. Make one user an administrator by editing ./config/rolemap.yml and adding something that looks like this

   development:
     admin:
       - mark@curationexperts.com
   

3. docker-compose run web rails hyrax:workflow:load
4. docker-compose stop web
5. docker-compose start web
6. Re-login with your administrator user
7. Change the workflow for your default admin set
   • localhost:3000/admin/admin_sets/admin_set%2Fdefault/edit#workflow
8. Logout and login as your non-admin user
9. Add a new work to your repository
   • http://localhost:3000/concern/images/new?locale=en
   • Set the visibility to "Public"
10. Once you've submitted your new image, not the status badge next to the visibility
11. Check your notifications (for the depositing user)
    • http://localhost:3000/notifications
12. Log out and search for your work - does it show up?
13. Log in with your administrator account
14. Click on the Review Submissions link in the left dashboard navigation bar
15. Check the "Under Review" tab, the newly submitted work should appear there, click on it's title
16. Click "Review and Approve" and approve the work

DISCUSSION

• What other options do you have beside approving a work in the workflow provided by default
• What does the default workflow look like - see ./config/workflows/mediated_deposit_workflow.json - how does this look different than the default workflow
• What happens if you remove the InitializeWorkflowActor actor from the middleware stack?
• Creating your own workflow: https://github.com/samvera/hyrax/wiki/Mediated-Deposit-Workflow