FL-Islandora Field Inventory

From FIG

Jump to: navigation, search
The FIG wiki has moved to a LibGuide at http://falsc.libguides.com/FL-Islandora/Guide_home . Please update any links you maintain and link to the new location. If any information is missing from the new guide, or if you have any feedback you would like to share regarding the new FIG LibGuide, please email to help@flvc.org and let us know!
The specific information previously maintained on this page can now be found at http://falsc.libguides.com/FL-Islandora/Metadata .

Contents

Introduction

All descriptive metadata in FL-Islandora is stored in XML format using the MODS bibliographic standard. To the end user (students, faculty, the general public) the terms and structure used by MODS may be difficult to interpret. FL-Islandora is customized to index and sort the metadata under labels to improve the user experience. This includes labels at the object record level, in search results, and in search facets. This may create a challenge to FL-Islandora staff users working directly with the MODS records. Refined lists of records can be retrieved in Advanced Search by selecting Solr search fields. To aide staff users in using this function, an inventory has been created to map fields of the MODS to that of these Solr search fields. The inventory also maps MODS fields to display fields found in the Full Description tab at the object record level. By using this tables below staff users will have access to a reference that will provide detail of how their metadata will appear in Islandora as well as create queries to maintain granular control over the metadata. See the screenshots in the documentation below for guidance.

Field Inventory

The rows of these tables document the associations between solr, metadata, and display fields. The principal purpose is to allow end users to reference the elements and their corresponding Search, Sort, and Record fields. This list is not exhaustive as solr fields are dynamically generated.

Navigate between the sheets using the tabs at the bottom of the document to see each table. Main document:

ltm suggestion: at least an introductory sentence at the top of the page that indicates that the Solr fields of individual MODS metadata elements can be used in Advanced Search to retrieve lists of records. Give an example. Also: give a brief explanation of each dataset below. Assume that the reader has no idea what this is for or how it is to be used.

Guidance

MODS Element/Attribute

In each dataset there is a MODS Element/Attribute column. Similar to X-Path, the data in the cells of this column are presented in a format that will allow a staff user to trace elements down through the MODS XML parent-child structure to the MODS element of which a value is contained. The string begins at the top-level MODS element and precedes through this elements children indicated by /. An element not followed by / is the XML element that contains the metadata value. Ex: relatedItem/titleInfo/subTitle - the MODS element containing the value is subTitle. Say the value of the subtitle is A New Hope. It would be expressed in MODS XML in the following way:

<relatedItem>
  <titleInfo>
   <title>Star Wars Episode IV</title>
   <subTitle>A New Hope</subTitle>
  </titleInfo>
 </relatedItem>

Here you see how relatedItem/titleInfo/subTitle is followed down from MODS Top Level Element relatedItem to subTitle.

Attributes are also included in these strings. Please see this tutorial for an explanation of XML attributes. Attributes are represented in the strings by @ followed by the name of the attribute (most commonly type) followed by = and the value of the attribute itself in quotations "...". Ex: name/namePart@type="family" - the MODS element containing the value is namePart type="family" or in XML <namePart type="family>. Say the value of namePart is Skywalker. It would be expressed in MODS XML in the following way:

<name>
 <namePart type="family">Skywalker</namePart>
</name>

This element without the type="family" attribute would simply be expressed as name/namePart.

Datasets and Description

Data sets covered (click to view placement in Islandora):

  • Full Description Display - This dataset refers to fields found on the Full Description tab of FL-Islandora Objects. The table provides:
  1. (Full Description Display) - the label of a metadata field printed on Full Description.
  2. (MODS Element/Attribute) - the corresponding element path the wraps the data in the MODS XML w/without brackets - see above.
  3. (MODS Top Level Element) the name of the MODS top-level element from which the field is descended.
  4. (Solr Field) - the solr field which can be entered in metadata search/browse of the advanced search page - see below.
  • Search labels - This dataset refers to the fields found in FL-Islandora search results. The table provides:
  1. (Search Label)- the label of a metadata field printed in search results.
  2. (MODS Element/Attribute) - the corresponding element path the wraps the data in the MODS XML w/without brackets - see above.
  3. (MODS Top Level Element) the name of the MODS top-level element from which the field is descended.
  4. (Solr Field) - the solr field which can be entered in metadata search/browse of the advanced search page - see below.
  • Search Facets- This dataset refers to the fields found in FL-Islandora search facets. Facets are links generated from the metadata of the returned query that allow you to narrow search results by excluding objects with that data from results or limiting results to objects containing that data. The table provides:
  1. (Facet Label)- the label of a metadata field printed in the Facets found in search results.
  2. (MODS Element/Attribute) - the corresponding element path the wraps the data in the MODS XML w/without brackets - see above.
  3. (MODS Top Level Element) the name of the MODS top-level element from which the field is descended.
  4. (Solr Field) - the solr field which can be entered in metadata search/browse of the advanced search page - see below.
  • Search Sort- This dataset refers to the fields found in FL-Islandora search sort. Sort allows you to arrange search results in either ascending or descending order as applied to the selected field. The table provides:
  1. (Sort Label)- the label of a metadata field printed in the sort block in search results.
  2. (MODS Element/Attribute) - the corresponding element path the wraps the data in the MODS XML w/without brackets - see above.
  3. (MODS Top Level Element) the name of the MODS top-level element from which the field is descended.
  4. (Solr Field) - the solr field which can be entered in metadata search/browse of the advanced search page - see below.
  • Advanced Search labels- This dataset refers to the fields found in the Field drop-down of the Advanced Search menu. Selecting a field limits an executed query to values found in the selected field. The table provides:
  1. (Advanced Search Label)- the label of a metadata field printed in the Field drop-down of the Advanced Search menu on the Advanced Search page.
  2. (MODS Element/Attribute) - the corresponding element path the wraps the data in the MODS XML w/without brackets - see above.
  3. (MODS Top Level Element) the name of the MODS top-level element from which the field is descended.
  4. (Solr Field) - the solr field which can be entered in metadata search/browse of the advanced search page - see below.
  • MODS - Solr mapping- This dataset is a list of MODS elements and their corresponding Solr value. The table provides:
  1. (MODS Element/Attribute) - the element path the wraps the data in the MODS XML w/without brackets - see above.
  2. (Solr Field) - the solr field which can be entered in metadata search/browse of the advanced search page - see below.

Using Solr fields

Users can make further use of the solr values found in the table by visiting their institutions Advanced Search page. Entering the solr values into the Islandora Metadata Search and Islandora Metadata Browse feature will generate lists of records indexed by these values, thus providing library staff a tool for rigorous control of their records, their relation to one another, and their discovery through FL-Islandora.

Metadata Search

Example: Say you want to locate all objects with the value "Telegram" input within top-level element 'genre', <genre>Telegram</genre>, in the MODS datastreams of your library. Executing a simple search for "Telegram" will retrieve these objects but it may also retrieve the value from other fields as well. To perform a search isolated to the MODS genre element locate the corresponding Solr Field from one of the tables within the inventory.

SolrFieldGenre.png

Copy the Solr Field and enter it into 'Search Solr field' in the metadata search box on the advanced search page. Refine the query by entering "Telegram" in the adjacent field. Date fields and a Collection drop-down are available if you wish to limit the search.

MetadataSearchGenre.png

Execute the search to retrieve all objects with the Solr field mods.genre indexed with the value "Telegram". These objects will contain <genre>Telegram</genre> in the MODS.

SearchGenreTelegram.png

Metadata Browse

Example: If you were looking for the most commonly used subjects you could simply View All Items and browse the facets. However, not all metadata fields are not available in the facets. Now say you want to locate the most commonly used publishers in your library - it's not in the facets AND you are unsure of how it is expressed in the MODS. You can use the datasets in the inventory to locate your fields based on what you are familiar with. For example, locate the 'Publisher' label from the Full Description Display. From this point you will be able to locate both the MODS Element (originInfo/publisher) and the Solr Field (mods.originInfo.publisher).

MetadataPublisher.png

Take the Solr Field and enter it into the Islandora Metadata Browse. Sort by 'Count' to see the most frequently used Publisher.

MetadataBrowsePublisher.png

The resulting search will provide a list of Publishers along with the amount of objects the term is found in. Select a value to retrieve a search containing each of the objects with this value.

MetadataBrowsePublisherList.png

MetadataBrowsePublisherTermSearch.png

Want to get crazy? Use the csv export from these final search results to create a spreadsheet of these records to share with friends and family.

Personal tools