Overview
This module allows you to add person, place, event, and organization entities to an Islandora repository. These entities are metadata-based repository objects that can be used for consistent use of names throughout the repository (name authority control) and to build departmental directories or faculty profiles to work with the Islandora Scholar institutional repository module. A number of forms and additional features are provided in this module for those building an institutional repository with Islandora.
Entities can be created in one of two metadata formats: Metadata Authority Description Schema (MADS) or Encoded Archival Context - Corporate Bodies, Persons, and Families (EAC-CPF). Much of the functionality for batch ingest and autocomplete (to use entities as authority objects) uses the MADS forms provided with the module. EAC-CPF forms are also provided for each entity type.
- People entities comes with a default MADS and EAC-CPF form.
- Places have an EAC-CPF form.
- Events have an EAC-CPF form.
- Organization entities come with a Organization EAC-CPF form and a Department MADS form.
Thumbnails
Custom thumbnails can be added via the manage tab to ingested Events, Places, and Organizations. When creating People entities, a thumbnail can be added at time of object creation. If the thumbnail is not added afterward for the Events, Places, and Organizations Entities, the default icon is the folder icon used for collections.
Entity Content Model
Objects ingested under Events, Places, Organization and People content models are also affiliated with the generic "Entity" content model provided with the solution pack. To use the Entity content model to create entities in a collection, you must add it to the collection policy in the collection's Manage tab, and associate an appropriate form with entities in the Islandora Forms module administration.
Dependencies
Downloads
Release Notes and Downloads (Copy)
Latest Code on GitHub
Configuration
Solr configuration
The autocomplete for the MADS forms requires that MADS entity values are indexed in Solr.
...
Entity Solution Pack - Solr Configuration Fields
![](/download/attachments/85525149/Screen%20Shot%202015-04-01%20at%2011.17.23%20AM.png?version=1&modificationDate=1493672533902&api=v2)
Entity Solution Pack - Entity Collection Configuration Fields
By default, the solution pack creates a single collection for all entities. If entities are divided into several collections, the PIDS for relevant collections can be added here.
![](/download/attachments/85525149/Screen%20Shot%202015-04-01%20at%2011.17.36%20AM.png?version=1&modificationDate=1493672533910&api=v2)
Entity Solution Pack - Autocomplete Configuration Fields
The autocomplete configuration fields correspond to fields indexed in Solr and the MADS forms packaged with the module.
Default configurations:
- Solr field for scholar title: MADS_title_mt
- Solr field for department: MADS_department_mt
- Solr field for disambiguated full name: MADS_disambiguated_fullname_mt
- Solr field for last name: MADS_family_mt
Image Modified
Entity Solution Pack - Solr Sort Field
The "Solr field to sort citations and theses by" will be used to order the lists of related objects under "Recent citations" and on the "Citations" and "Theses" tabs (which only show up if a person is connected to Citation or Theses objects - see below). As with all Solr sort fields, this must be a single-valued field, and must be followed by a space and the string 'asc' or 'desc' to indicate sort order.
![](/download/attachments/85525149/Screen%20Shot%202017-02-27%20at%2010.00.37%20PM.png?version=1&modificationDate=1493672533946&api=v2)
View EACCPF Person
The default view for an EACCPF person record:
![](/download/attachments/85525149/Screen%20Shot%202015-04-01%20at%2011.26.47%20AM.png?version=1&modificationDate=1493672533919&api=v2)
View MADS Person
The default view for a MADS person record (reflecting a "scholar" in an Institution)
![](/download/attachments/85525149/Screen%20Shot%202015-04-01%20at%2011.28.53%20AM.png?version=1&modificationDate=1493672533928&api=v2)
Other Views
EACCPF Objects, Events, and Places (after a thumbnail has been affiliated) will look as below:
The Entities Solution Pack comes with the following objects in http://path.to.your.site/admin/islandora/solution_pack_config/solution_packs:
...
RELS-EXT | Default Fedora relationship metadata |
MADS/EACCPF/MODS | Descriptive metadata, in a format correlating to the form selected. |
TN | Thumbnail image, created at time of ingest |
DC | Dublin Core record |
Batch Ingest for Person Entities
Instructions for using the CSV import can be found in islandora_solution_pack_entities/modules/islandora_entities_csv_import/README.md
...
Code Block |
---|
language | xml |
---|
title | Sample MADS output with multiple values |
---|
collapse | true |
---|
|
|
How to Connect a Person Entity with Citation or Thesis objects
Connecting is done by string match on an identifier.
- Create the Person Entity with the MADS Scholar Form.
- In the MADS Scholar Form, in the field for "Identifier", enter a controlled value. (The "Identifier" form field stores to MADS as <identifier type="u1">.) You will use this identifier later to link citation objects, by entering the same identifier in with author information on a Citation or Thesis object. (Tip: Before beginning, pick a system for assigning these identifiers. A good idea would be to use an existing authority control system, such as university assigned email addresses or Orcid IDs, and use these consistently in your repository.)
Note: If you link a Citation object to a Person entity, then you change the Person's identifier, the link from the Citation object will break. So, you need to pick the system for assigning identifiers before you begin to create Person entities. - Create a Citation object. In the Citation MODS Form, in the Author information in the field for "Qualified Name", enter the identifier that you used when you created the Person Entity for the author. (The "Qualified Name" form field stores to MODS as <displayForm>.)
- Now, when you view the Person Entity which you created in step 1, you will see the Citation object show up under "Recent Citations" for the person.
How to Connect a Person Entity to a Department
- Create an Organization using Department MADS Form.
- Use a controlled identifier for "Department Name" (stores in the MADS as <authority><name type="corporate"><namePart>). This will be shown to the user on each faculty member's profile, so use actual department names as identifiers.
- Edit or create a Person entity using the MADS Scholar Form.
- For "Department", start typing the name of the Department. When it autofills, click to complete the value you would like to use. The department name is stored as a string in the Person entity's MADS in MADS field <affiliation><organization>, and displays on the person's profile under the heading for "Department(s)" and under "Other Scholars in..."
- If you need to change the department name later, you need to edit the name in the MADS for every person in that department.
...