Defining a Workflow - samvera/hyrax GitHub Wiki

Introduction

Hyrax's workflow is a database-driven implementation of a finite state machines. There exist other Ruby implementations of FSMs (AASM gem but these state machines are defined in code).

Workflow Modeling

Grab a whiteboard and draw up your workflow.

  • Circles represent states
  • Lines represent actions
  • Determine what roles are required to take an action
  • Determine what roles can see an item in the given state
  • When changing state, what else should happen (e.g. send notifications, update metadata)

Consider that some roles will be assigned to all items in the workflow (e.g. Metadata Reviewer) whereas some roles will be assigned to single items in the workflow (e.g. an Advisor Reviewer).

Below is one example:

example-workflow

Defining a Workflow in Hyrax

Hyrax will create a default workflow configuration when you call the rails generate hyrax:work. Before you load the default workflow into the database via the rails hyrax:workflow:load command, make sure to review your workflow.

Below is the JSON that models the above workflow.

{
  "work_types": [
    {
      "name": "example",
         "actions": [{
             "name": "submit_for_review", "transition_to": "under_review",
             "from_states": [{"names": ["new", "changes_required"], "roles": ["creating_deposit"]}]
         }, {
             "name": "request_changes", "transition_to": "changes_required",
             "from_states": [{"names": ["under_review"], "roles": ["approving_work"]}]
        }, {
             "name": "approve", "transition_to": "approved",
             "from_states": [{"names": ["under_review"], "roles": ["approving_work"]}]
        }]
     }
  ]
}

Loading a Workflow

Default Workflow

When a Hyrax app is created by running rails generate hyrax:install, a default workflow is created in config/workflows/default_workflow.json.

Additional Workflows

You can define additional workflows following the syntax described Defining a Workflow in Hyrax above. Add the json files to config/workflows directory in your app.

Loading workflows

All workflows defined in config/workflows directory can be loaded using the following command.

rails hyrax:workflow:load

This will load the workflow and create user roles. You will want to assign users/groups to the roles. You will be able to select the workflow for use in an admin_set.