This documentation refers to an earlier version of Islandora. https://wiki.duraspace.org/display/ISLANDORA/Start is current.

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

Overview

The Compound Solution pack module adds the ability to to create compound objects using objects created with any other Islandora solution pack by enabling a generic parent-child relationships between objects. The object view of a compound object is replaced by the view of its first child object. The included "Islandora Compound Object Navigation" block provides a thumbnail navigation of an object's siblings. A "Compound" management tab allows for the addition and removal of parent and child objects for each object as well as reordering of a compound object's child objects..

Configuration options are available through the Compound objects administrative menu (admin/islandora/solution_pack_config/compound_object)

Dependencies

  • Islandora
  • JAIL library
    • required if the "Islandora Compound Object JAIL Display" block is enabled

Downloads

Release Notes and Downloads

Installation

Enable the Islandora compound object module (admin/modules). There are two display blocks that provide an navigation interface for compound objects that come with the module:

  • either enable and configure the "Islandora Compound Object Navigation" block (admin/structure/block/manage/islandora_compound_object/compound_navigation/configure)
  • or enable and configure the "Islandora Compound Object JAIL Display" block (admin/structure/block/manage/islandora_compound_object/compound_jail_display/configure)
    • to use this block you also need to check the "Use alternative, autoloading display for compounds" option in the Compound Object Solution Pack's administrative menu (admin/islandora/solution_pack_config/compound_object)

Usage

To create a compound object:

  • Go to parent collection.
  • Click "Manage".
  • Enable the "Compound Object" module under "Collection" tab, then click "Update Collection Policy".
  • After enabling the compound object module, click the "Overview" tab then "Add an Object".
  • Select "Compound Object" then "Next".
  • Select "Compound Object MODS form" then "Next".
  • Fill in the form then click "Next".
  • Note that you will not be ingesting an object datastream at this point, you are just creating the "parent" compound object to add "child" objects to.
  • After the compound object has been created, you can add "child" objects. Click "Manage" > "Compound".
  • Under the "Add Child Object" field, enter the PID for each object to be added to the compound object, then click submit. If you do not use drush, you must do this once-at-a-time for each PID.

Configuration

The module has documented configuration options at admin/islandora/solution_pack_config/compound_object. 

By default, compound objects will be filtered from Solr search results. To change this, go to "Islandora" > "Solution pack configuration" > "Compound Object Solution Pack" > and uncheck the "Hide child objects in Solr results.  


 Customization

The "Islandora Compound Object Navigation" block can be themed. See theme_islandora_compound_prev_next().

Drush

A Drush command has been added, to be run from the command line (Terminal), that will update the existing rel-predicate of existing compound objects to 'isConstituentOf'. It can be run with the drush command 'drush update_rels_predicate'. This command accpets no arguments.

Content Models, Prescribed Datastreams and Forms

The Compound Solution Pack comes with the following objects in http://path.to.your.site/admin/islandora/solution_packs:

  • Islandora Compound Object Content Model (islandora:compoundCModel)
  • Compound Collection (islandora:compound_collection)

An image object created using the Compound Solution Pack's content model will have the following datastreams:

RELS-EXT

Default Fedora relationship metadata

MODSMODS record, created at time of ingest
DCDublin Core record
TN

Thumbnail image, created at time of ingest

The Compound Solution Pack comes with the Compound Object MODS form.

  • No labels