Page History

...

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.

     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 "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.

     
     

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

     Warning
     This will overwrite

     an

     any existing thumbnail on the parent, 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's TN datastream (if it exists) will be purged. This will occur even if the parent is not a Compound CModel object.

     
     

   • Unchecked: No thumbnail is generated and a system default thumbnail will display
     Note: By default, objects of type Compound CModel do not have thumbnail datastreams. 
     
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
     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.

     
     

10. Compound 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. 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).

   
   

2. Add children to the parent object. 
3. Create a designated Parent object
4. 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.
   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.
5. 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.

...

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

...

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.

...