Compound Solution Pack

Overview

The Compound Solution Pack allows you to define Parent-Child relationships between Islandora objects. It can be used to allow easy navigation between "ordered sets" of objects that are related because they share a parent. "Parent" objects may have the Compound Object content model, or (optionally) any content model. "Child" objects may have any content model. The parent-child relationship is recorded as a (configurable) predicate in the RELS-EXT datastream of the child objects, along with an ordering which uses a predicate unique to the parent object.

Navigation is provided through one of two blocks which must be placed in a region under Structure > Blocks.

Objects can be added, removed, and reordered from the parent object's Manage > Compound tab.

Example use cases:

Parent object: Postcard (the compound object, using the Compound content model)

• Child object: Scan of postcard front (large image object) - Order 1 of 2

• Child object: Scan of postcard back (large image object) - Order 2 of 2

Parent object: Slides of a presentation (PDF content model)

• Child object: Video of the presentation (video content model)

Dependencies

This module requires the following modules/libraries:

• Islandora

This module has the following as optional requirements for certain features:

For Islandora Compound Object JAIL (Jquery Asynchronous Image Loader) Display:

• JAIL library
  • If utilizing the lazy loading image ability of the solution pack, enable the "Islandora Compound Object JAIL Display" block and ensure the JAIL library is present within sites/all/libraries/JAIL.

Downloads

Release Notes and Downloads

Installation

Install as usual, see this for further information.

Navigation between members of a compound object requires one of the following two blocks to be placed:

• "Islandora Compound Object Navigation" block.
• "Islandora Compound Object JAIL Display" block. This uses the JAIL library, which allows for lazy loading of images. This will increase performance on compounds with many children. 

If using the lazy loading option, the JAIL library must be present within sites/all/libraries/JAIL, and the "Use alternative autoloading display for compounds" configuration toggle must be enabled.

Configuration

Set the 'Child relationship predicate' and 'Solr filter query', as well as select options in Administration » Islandora » Solution pack configuration » Compound Object Solution Pack (admin/islandora/solution_pack_config/compound_object).

1. Only allow compound objects to have child objects associated with them.
   • Checked: you can only add child objects to Islandora objects with the "Compound Solution Pack" type. [With this option checked, whenever you delete a Compound Object, Islandora will not delete the child object(s). It only removes the relationship predicate from the child objects.]
   • Unchecked: all objects can have child objects.

1. Generate a thumbnail for compound objects from their first child.
   • Checked: When the first child is added or changed through removal/reordering, the thumbnail of the first child will be attached to the parent as a TN datastream. Note: this will overwrite an existing thumbnail, and will occur even if the parent is not a Compound CModel object. If the first child does not have a TN datastream, then any TN attached to the parent will be purged.
     
   • Unchecked: No thumbnail is generated and a system default thumbnail will display.
     
2. Hide child objects in RI results
   • Checked: Child objects will not be displayed in the Islandora browse. Only parent objects will display.
   • Unchecked: Child objects and parent objects will be displayed in the Islandora browse.
3. Hide child objects in Solr results
   1. Checked: Child objects will not be displayed in Solr search results. Only parent objects will display.
   2. Unchecked: Child objects and parent objects will be displayed in the Islandora search.
4. Solr Filter Query
   • This is the query that enables the "Hide child objects in Solr results" function. The default value is `-RELS_EXT_isConstituentOf_uri_mt:[* TO *]`
5. Child relationship predicate
   • This is the statement in the RELS-EXT metadata that associates child objects with parent objects. The default value is `isConstituentOf`
6. Use alternative, autoloading display for compounds?
   • Checked: The "Islandora Compound Object JAIL display" block will be populated (dependencies and blocks also need to be configured. See the documentation for "Installation" and "Display" for more information.)
   • Unchecked: The "Islandora Compound Object Navigation" block will be populated (block also needs to be configured. See documentation for "installation" and "display" for more information.)
7. Use Derivative hooks for parent thumbnail updates?
   • Checked: If the parent object is a Compound CModel, then changes to the TN of the first child will cause the TN of the parent to be updated. This is independent of the "Generate a thumbnail for compound objects from their first child" and will occur even if that option is turned off.
   • Unchecked: Changes to the first child of a Compound CModel object do not change the parent's TN.
8. Display compound object parents in the breadcrumbs on children objects
   • Checked: The parent object will appear in the breadcrumb navigation.
   • Unchecked: The parent object will not appear in the breadcrumb navigation. If child objects are members of other collections, those paths will be shown in the breadcrumbs.
9. Redirect to first child when a compound object is requested.
   • Checked: If a
     
10. Compound Member Query
    • (Default) Legacy SPARQL - Does a SPARQL query followed by an access check. 
    • SPARQL - Does a SPARQL query with filters. Generally faster than the default option.

Usage

1. Create a designated Parent object
2. Add existing children to the parent under the parent object's "Manage" > "Compound" tab.
   
   • Child objects must already exist in your repository before you can add them.
3. Under the "Add Child Object" field, enter the PID for each object to be added to the compound object.
   
   • Child objects can only be added one at a time. The "Child Object Pid/Label" box has an autocomplete function that searches for objects by label or PID.

4. Click "Save" when all the child objects are associated with the parent objects.

Once a child has been added to the compound, the view of the compound will use the metadata and thumbnail from the first object to render the main object view. To reorder objects, go to the parent object's Manage tab, select "Compound", and use the "Reorder" list. If you do reorder the child objects, be sure to click "Save changes" in the "Reorder" fieldset.

Child objects can be removed from parent objects from the parent object Manage >Compound tab. This removes the association from the RELS-EXT metadata and if the child has no other parent compound or collection objects, will delete the child object as well.

Display

If the parent object has the Compound content model, then its default view will present the "landing page" of its first child object.

Block options

There are two block options for displaying compound objects within Islandora. The default "Islandora Compound Object Navigation" block will provide navigation controls and loading of all objects related to the parent compound. The other option "Islandora Compound Object JAIL Display," is a block utilizing the JAIL library which allows for "lazy loading" of images. This allows the block to load images only when they are being accessed, which will greatly increase performance on compound objects with many children. See the "Installation" section for more information about the two display options.

Theme

The "Islandora Compound Object Navigation" block can be themed. Use the hook: theme_islandora_compound_prev_next().

Correcting out-of-date child object relationships

Previous versions of this module (Islandora 7.x-1.2 and earlier) had a different predicate in the RELS-EXT to associate child objects with parent objects. To update to the new compound object predicate, run the drush command `update_rels_predicate` from the command line. This will update the predicates of existing compound objects to `isConstituentOf`. This command accepts no arguments.

Content Models, Prescribed Datastreams and Forms

The Compound Solution Pack comes with the following Content Models:

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

A parent object created using the Compound Solution Pack's compoundCModel will have the following datastreams:

The Compound Solution Pack comes with the "Compound Object MODS form" for editing the MODS datastream (admin/islandora/xmlform).

Sample RELS-EXT for Parent Object (Compound Object)

  
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:fedora="info:fedora/fedora-system:def/relations-external#" 
xmlns:fedora-model="info:fedora/fedora-system:def/model#" xmlns:islandora="http://islandora.ca/ontology/relsext#">
  <rdf:Description rdf:about="info:fedora/islandora:3">
    <fedora:isMemberOfCollection rdf:resource="info:fedora/islandora:compound_collection"></fedora:isMemberOfCollection>
    <fedora-model:hasModel rdf:resource="info:fedora/islandora:compoundCModel"></fedora-model:hasModel>
  </rdf:Description>
</rdf:RDF>

Sample RELS-EXT for Child Object (Large Image Object)

<rdf:RDF xmlns:fedora="info:fedora/fedora-system:def/relations-external#" xmlns:fedora-model="info:fedora/fedora-system:def/model#" 
xmlns:islandora="http://islandora.ca/ontology/relsext#" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
  <rdf:Description rdf:about="info:fedora/islandora:2">
    <fedora:isMemberOfCollection rdf:resource="info:fedora/islandora:sp_large_image_collection"></fedora:isMemberOfCollection>
    <fedora-model:hasModel rdf:resource="info:fedora/islandora:sp_large_image_cmodel"></fedora-model:hasModel>
    <fedora:isConstituentOf rdf:resource="info:fedora/islandora:3"></fedora:isConstituentOf>
    <islandora:isSequenceNumberOfislandora_3>1</islandora:isSequenceNumberOfislandora_3>
  </rdf:Description>
</rdf:RDF>

  

Troubleshooting/Issues

Having problems or solved a problem? Check out the Islandora google groups for a solution.

• Islandora Group
• Islandora Dev Group