Current Release
This documentation covers the latest release of Islandora 7.x. For the very latest in Islandora, we recommend Islandora 8.

Overview

The Islandora Simple Workflow module causes a basic editorial workflow to be applied to the ingest process.

When the module is enabled, objects ingested by most users will be given the Fedora state 'inactive' until another user with proper permissions activates them. If the user creating the objects has the permission "Bypass default inactive object state", objects will be given the normal, 'active' state. The "Drupal Super User" (uid = 1) will always bypass the inactive state.

By default, 'inactive' objects are not displayed in collections and are not indexed in Solr, but they are accessible directly (if the PID is known) by anyone who can view Islandora objects. To restrict access to inactive objects, check the "Lock down inactive and deleted objects" option in Islandora configuration (admin/islandora/configure) and grant the resulting permission to appropriate roles.

Dependencies

This module requires the following modules/libraries:

Downloads

Release Notes and Downloads

Installation

Install as usual, see this for further information.

Usage

Once the module is active, Simple Workflow causes Islandora to react differently to certain users' permissions upon ingest of an object. Most users' uploads will be set to 'inactive' upon ingest, which is a flag that prevents them from being searched to or browsed.

By default, inactive objects are not "locked down" and anyone with permission to 'View repository objects' can navigate to them with the direct link. They will also be indexed by the XML Sitemaps Module if it is enabled. To lock down inactive objects so that only specific users can see them, first enable the 'Lock down inactive and deleted objects' option in Islandora configuration (admin/islandora/configure).


The following permissions can be set up for particular groups at http://path.to.your.site/admin/people/permissions, under the Islandora Simple Workflow section:

  • Bypass default inactive object state - Groups with this permission ingest objects as 'active' instead of 'inactive'.
  • Manage inactive objects - Groups with this permission are able to view and manage a list of inactive objects at http://path.to.your.site/admin/islandora/simple_workflow/list; this page contains links to the 'Properties' page of the 'Manage' tab for each object whose state is set to Inactive.

Optionally (if enabled under Islandora configuration), in the Islandora section:

  • Access inactive and deleted objects - If this permission is enabled, then groups without this permission can not access inactive objects. If this permission is not enabled, then anyone with the permission to 'View repository objects' can access inactive objects. 

Beyond this, any user wishing to upload objects needs to be part of a group with appropriate uploading permissions, i.e. 'Create new repository objects' and 'View repository objects' at http://path.to.your.site/admin/people/permissions.

It is important to check your Fedora installation's XACML policies to make sure that nothing is preventing your user from uploading objects with an inactive state. For example, your Fedora installation may include the policy file 'deny-inactive-or-deleted-objects-or-datastreams-if-not-administrator.xml', which would prevent Simple Workflow from functioning as intended. You can check the XACML policies on your server at $FEDORA_HOME/data/fedora-xacml-policies/repository-policies/; in a standard installation they will be located in the 'default' directory at the end of that path. After making changes to XACML policies, you will need to restart Fedora.

Configuration

Simple Workflow objects can be managed at Administration » Islandora » Islandora Utility Modules » Simple Workflow objects (admin/islandora/tools/simple_workflow/list).

  • No labels