The Compound Solution pack module Pack allows you to create what are called "compound objects." Compound objects function as "parent" objects that gather together one or more "child" objects. Child objects can be created with any other Islandora solution pack and have their own metadata. When you associate Islandora objects with a parent compound object, the parent-child relationship is recorded define Parent-Child relationships between Islandora objects. Users can easily navigate between a parent's child objects as though they are an "ordered set". 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 structural metadata datastream of the child objects(see bottom of page for sample RELS-EXT). Sequencing information can also be recorded in the RELS-EXT metadata so child objects can be displayed in their proper order. For example, a scanned postcard with a front and back view would have the following structure, 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 Object (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:
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.
Install as usual, see this for further information.
Configuration
First, enable one of the following blocks to allow navigation between members of a compound object.
Navigation between members of a compound object requires Enable the Islandora compound object module (admin/modules). There are two block options for displaying compound objects within Islandora. Select one of the following two blocks to be placed:
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 This uses the JAILlibrary, 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.
If utilizing using the lazy loading image ability of the solution packoption, the JAIL library must be present within sites/all/libraries/JAIL.
Configuration
, and the "Use alternative autoloading display for compounds" configuration toggle must be enabled (see below).
Module options can be set 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).
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.
[Caution: If you uncheck this option,
Warning
If all objects can have child objects, then:
you run the risk of having orphan child objects if you ever delete a "parent" object that does not use the compoundCModel Content Model. This is because Islandora does not remove the relationship predicates from child objects if the parent wasn't a
real
"Compound Object."
]
Be careful with "Generate a thumbnail for compound objects from their first child" because it will replace the parent object's existing thumbnail when a child is added or re-ordered
Generate a thumbnail for compound objects from their first child.
Checked:
A thumbnail will be generated and
When the first child is added or changed through removal/reordering, the thumbnail of the first child will be attached to the
compound object as a TN datastream.
parent as a TN datastream.
Warning
This will overwrite any existing thumbnail on the parent, and if the first child does not have a TN datastream, then the parent's TN datastream (if it exists) will be purged. This will occur even if the parent is not a Compound CModel object, which may be a bug:
Jira
server
DuraSpace JIRA
serverId
c815ca92-fd23-34c2-8fe3-956808caf8c5
key
ISLANDORA-2266
Unchecked: No thumbnail is generated and a system default thumbnail will display
Info
Note: By default, objects of type Compound CModel do not have thumbnail datastreams.
Hide child objects in RI results
Checked: Child objects will not be displayed in the Islandora browse (collection display). Only parent objects will display.
Unchecked: Child objects and parent objects will be displayed in the Islandora browse.
Hide child objects in Solr results
Checked: Child objects will not be displayed in Solr search results. Only parent objects will display.
Unchecked: Child objects and parent objects will be displayed in the Islandora search.
Warning
This option will hide child objects in user searches, but may also hide child objects in other places in the interface if Solr is being used to provide back-end functionality. See improvement ticket:
Jira
server
DuraSpace JIRA
serverId
c815ca92-fd23-34c2-8fe3-956808caf8c5
key
ISLANDORA-1747
When enabled, if you would like the Compound object set to be discoverable via Solr, then all metadata relating to the parent/children must be present in the parent object's datastreams. However, if the parent has the Compound CModel, the user will only ever be able to see the metadata of the children. Thus, repository managers may need to maintain metadata in two places.
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 *]`
Child relationship predicate
This is the statement in the RELS-EXT metadata that associates child objects with parent objects. The default value is `isConstituentOf`
Use alternative, autoloading display for compounds?
Checked: Enables the 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 default display will be used"Islandora Compound Object Navigation" block will be populated (block also needs to be configured. See documentation for "installation" and "display" for more information.)
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.
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.
Redirect to first child when a compound object is requested.
Checked: When navigating to the page of a Compound CModel object with children, redirect the user to the page of the first child.
Unchecked: On the page of a Compound CModel object with children, remain "on" the parent object (per the URL) but display the first child's content and metadata (default).
Info
This can cause confusion about which object is currently being viewed. When unchecked, the user sees the first child's metadata and content, but the Manage tab, and any contextual blocks, views, or anything else controlled by the Context module, understands the user to be on the parent's page.
However, the redirect option will also hinder administrators attempting to navigate to the parent. Hence, links to "Manage parent" are provided to authorized users in the compound navigation blocks.
Compound Member Query
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 Removed
Usage
To create a compound object:
SPARQL - Use this option for fully compliant SPARQL triple stores. Does not work with Mulgara.
Solr (requires Islandora Solr) - uses Solr to find child objects. This works even if "Hide child objects in Solr results" is checked.
Image Added
Usage
Designate a parent object - either by creating an object of type Compound CModel, or (with the appropriate configuration option enabled) an existing object.
Info
If using a non-Compound object as the parent, then it will appear as the "first child" in the Compound Navigation block (JAIL or regular).
Add children to the parent object.
Go to parent collection.
Click "Manage".
Enable the "Compound Object" object under "Collection" tab, then click "Update Collection Policy".
After adding compound objects to your Collection Policy, you will be able to click the "Overview" tab and "Add an Object".
Select "Islandora Compound Object Content Model" then "Next".
Select your metadata form, such as the "Compound Object MODS form", then "Next". [If prompted for a MARCXML file, choose that file if you have one. If you do not have one, just click "Next."]
Fill in your metadata form then click "Next".
Compound objects do not have content datastreams. This process creates a "parent" compound object that child objects can be associated with. The content is attached to the child objects.
After the compound object has been created, go to "Manage" > "Compound" to associate objects with the parent compound object.
Child objects must already exist in your repository before you can add them.
Under the "Add Child Object" field, enter the PID for each object to be added to the compound object.
This can be done either through the parent object's Manage > Compound tab, or the child object's Manage > Compound tab.
Even from the parent, child Child objects can only be added one at a time.
The "Child Object Pid/Label" box has "Add child object" and "Add Parent Object" fields have an autocomplete function that searches for existing objects by label or PID.
Click "Save"when all the child objects are associated with the parent objects..
If the option to do so is enabled, this will cause the parent object's thumbnail to be replaced by the TN of the first child.
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 but does not remove and if the child has no other parent compound or collection objects, will delete the child object from the repositoryas well.
...
Warning
The object view of a compound object is replaced by the view of its first child object. After a compound object is created, the "Islandora Compound Object Navigation" block must be activated and set in an appropriate region. When a user navigates to a compound object, this block will render a thumbnail view of all the additional objects linked via the compound object.
As of 7.x-1.12, deleting a parent compound object will also delete the child objects if they have no other parents (either compound parents or collection parents).
Display
If the parent object has the Compound content model, then its default view will present the "landing page" (content and metadata) of its first child object. If the parent object uses another content model, then it will display its own content and metadata.
...
Navigation Block
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 using theJAIL library library which allows for "lazy loading" of images. This allows the block to load images only when they are being accessedneeded, which will greatly increase performance on compound objects with many children.See the "InstallationConfiguration" section for more information about the two display options.
Image Modified
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 Compound CModel objects from `isPartOf` 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)