Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  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.

      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
      serverDuraSpace JIRA
      serverIdc815ca92-fd23-34c2-8fe3-956808caf8c5
      keyISLANDORA-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. 


  2. 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.
  3. 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
      serverDuraSpace JIRA
      serverIdc815ca92-fd23-34c2-8fe3-956808caf8c5
      keyISLANDORA-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.


  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: 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 Member Query
    • SPARQL - Does a SPARQL query with filters. Generally faster than the default option.
    • 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 Image Removed


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. 
    • Child objects must already exist in your repository before you can add them.
    • 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 objects can only be added one at a time.
    • The "Add child object" and "Add Parent Object" fields have an autocomplete function that searches for existing objects by label or PID.
  3. Click "Save".

...