Page History

Overview

The Compound Solution pack module adds the ability to to create what are called "compound objects." Compound objects function as "parent" objects that gather together "child" objects created with any other Islandora solution pack. When you associate Islandora objects with a parent compound object, the parent-child relationship is recorded in the RELS-EXT structural metadata of the child objects (see bottom of page for sample RELS-EXT). Order can also be recorded in the RELS-EXT metadata so child objects can be displayed in a sequence.

...

• The first is the default "Islandora Compound Object Navigation" block. Go to admin/structure/block/manage/islandora_compound_object/compound_navigation/configure to find navigation controls and load all objects related to the parent compound. 
• The second is the "Islandora Compound Object JAIL Display" block. Go to admin/structure/block/manage/islandora_compound_object/compound_jail_display/configure to use 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 compounds with many children. 

Configuration

The module has configuration options at 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.
   • Unchecked: all objects can have child objects.
2. Generate a thumbnail for compound objects from their first child.
   • Checked: A thumbnail will be generated and attached to the compound object as a TN datastream.
   • Unchecked: No thumbnail is generated and a system default thumbnail will display.
3. 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.
4. 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.
5. 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 *]`
6. Child relationship predicate
   • This is the statement in the RELS-EXT metadata that associates child objects with parent objects. The default value is `isConstituentOf`
7. Use alternative, autoloading display for compounds?
   • Checked: Enables the JAIL display (dependencies and blocks also need to be configured. See the documentation for "Installation" and "Display" for more information.)
   • Unchecked: The default display will be used.
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.
9. 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.

Optionally, enable the JAIL compound block to utilize the lazy loading image ability as outlined below.

Image Added

Usage

To create a compound object:

...

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 second option 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.

Image Added

Theme

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

...

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

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

...

<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