Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Added notes about issue 1977 and merging fields from configurations

...

To use Solr indexed metadata in the display, go to Administration > Islandora > Administration » Islandora » Metadata Display (admin/islandora/metadata) and select "Islandora Solr Metadata" to be the default display viewer.  Click Save Configuration.

...

To set up a display, go to Administration > Islandora > Administration » Islandora » Solr Index » Metadata Display (admin/islandora/search/islandora_solr/metadata).

...

  1. After you have created a custom display, click the linked configuration name to add fields to that display.
  2. Select the content models that will use this display.
  3. Click on the new display to add fields.

  4. Add fields to the display by entering Solr field names with type "string." As you type in the "Add Field" box, field names will be suggested from the index. Once a field is selected, click "Add". In order to edit the field, click Save Configuration at the bottom of the form.

    Info

    Currently only fields that are present in the Solr index can be added in metadata display configurations.

    Jira
    showSummaryfalse
    serverDuraSpace JIRA
    serverIdc815ca92-fd23-34c2-8fe3-956808caf8c5
    keyISLANDORA-1977


    Image Modified

  5. After you add fields, you can create custom labels, choose whether to hyperlink the field values in the display, or apply truncation options by clicking the edit button next to the field. The edit button appears only after you click Save Configuration at the bottom of the form. By default, the display label will be the Solr field name. A hyperlinked field value will launch a new Solr search for other records with that same value.

  6. Truncation can also be applied from the edit menu.  Truncation can be applied to separate values or an entire field.  You can specify the maximum field length (use 0 or less to disable truncation), and choose whether to attempt truncation on a word boundary and whether or not to append an ellipsis to the end of a field when it is begin truncated.


     
  7. The "Description" field that shows up directly under an object's viewing derivative is configured separately from the other display fields. Enter the field and an optional label in the Description settings.

...

6. Click Save Configuration.

Content models with multiple metadata

...

display configurations

A content model can have more than one metadata display configuration associated with it. In this case, all fields present in both the associated configurations are displayed, and the order of fields is determined by Solr field weightingsSolr field weights.

Suppose, for example, that two configurations 'A' and 'B' are associated with a content model. If configuration A contains fields 'a' and 'c' and B contains fields 'b' and 'd', then the metadata display output would be in the order 'a, b, c, d'.

Info

If the same Solr field is included in multiple metadata display configurations associated with a certain content model, only the label and value(s) from the last configuration are displayed. The last configuration is the most recently created configuration that is associated with the content model; the (machine) name of the configurations is not used to determine the order.

Notes

  • To use Solr Metadata with Scholar's citation/thesis cModels, please enable the `Use Standard Metadata Display` option in Administration >> Islandora >> Administration » Islandora » Solution pack configuration >> configuration » Scholar (/admin/islandora/solution_pack_config/scholar).

...

For a more indepth look at the metadata display framework and an example module implementation see the Islandora wiki page on Metadata Display Viewers.It's to be noted that you can have a content model associated with more than one configuration at a time. Similarly, on objects with two content models, two or more configurations could respond to display the markup for the object. These cases are handled by merging the displays based around the weight. Take for example the case where you have two responding configurations where the first configuration contains the a and c fields and the second the b and d fields. The metadata display output would then be in the following order: a, b, c, d. As such, it's at the discretion of the user, through the creation of configurations, to determine how they want their metadata to be displayed.