Defining a Workflow

This is an alpha feature

Introduction

Curation Concern'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:

Defining a Workflow in CurationConcerns

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

Below is the JSON that models the above workflow.

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