Add finding aids

Learn how to use the Add Finding Aid wizard, edit finding aid compound objects, and work with stylesheets using the Project Client.

Use the Project Client Add Finding Aid wizard to add archival finding aids encoded using Encoded Archival Description (EAD). The Project Client processes the EAD and enables you to:

When added to a Project Client project, the finding aid is converted to HTML and processed as a compound object. After you upload it to the server and it is approved and indexed, end users can search the full text of the finding aid and see highlighted search results.

Preparing to add finding aids

Before adding finding aids, configure your collection for optimal use by designating a full text search metadata field into which the full text of the finding aid will be copied. Please see Edit field properties for more information.  For granular metadata mapping, map collection fields to Qualified Dublin Core.

After your collection is configured, use the following tips to create a finding aid file that can be processed by CONTENTdm.

To understand how the finding aid files are processed, see Processing.

Using the Add Finding Aid wizard

After you have configured your collection and created your finding aid using the tips above, you can use the Add Finding Aid wizard to add the file to your project.

  1. From the Add menu, click Finding Aid. The Add Finding Aid wizard displays.
  2. Click Browse to select the finding aid file. Click OK.
  3. (Optional) Choose the thumbnail to display for the finding aid.
    • Select Use default thumbnail to use the CONTENTdm default finding aid thumbnail.
    • Select Use custom thumbnail for this finding aid to use a customized thumbnail image for this finding aid. Click Browse to select an image file from to use as the thumbnail.
  4. Click Next. A progress screen displays while the finding aid is processed by a web service. The Map Metadata Fields screen displays.
  5. Map the finding aid tags to collection metadata fields.
    • This mapping applies to the compound object-level metadata only. Page-level metadata is not mapped.
    • On the left of the mapping interface, the wizard displays the tags found in your finding aid, while the right side displays a drop-down list of the collection’s metadata fields. Use the drop-down list to select a collection metadata field for the EAD tags you want mapped in your collection metadata. See Available tags for metadata mapping for a list of the tags that can be mapped.
    • You can map multiple tags to the same field. Data from all the mapped EAD tags is added to the designated field separated by a semicolon.
    • The wizard displays a default mapping the first time you import a finding aid into your project. If you change the default mapping, the wizard will remember your settings for subsequent imports. The default mapping provided is intended only as a guide.
    • If any of the Dublin Core fields used in the default map do not exist in the CONTENTdm collection, the EAD field is mapped to None.
    • The EAD tags are not included in the extracted data added to the metadata record for the finding aid, only the data from within the tags is displayed.
    • Default mapping - Table
      EAD Tag Dublin Core Field
      EAD.ARCHDESC.DID.CONTROLACCESS.GEOGNAME Coverage-Spatial
      EAD.ARCHDESC.DID.UNITDATE Coverage-Temporal
      EAD.ARCHDESC.DID.ORIGINATION.PERSNAME Creator
      EAD.ARCHDESC.DID.ORIGINATION.FAMNAME Creator
      EAD.ARCHDESC.DID.ORIGINATION.NAME Creator
      EAD.FILEDESC.DATE
      or
      EAD.FILEDESC.PUBLICATIONSTMT.DATE
      Date
      EAD.ARCHDESC.DID.ABSTRACT Description
      EAD.ARCHDESC.DID.SCOPECONTENT Description
      EAD.EADHEADER.EADID.URL Identifier
      EAD.ARCHDESC.DID.LANGMATERIAL Language
      EAD.FILEDESC.PUBLISHER
      or
      EAD.FILEDESC.PUBLICATIONSTMT.PUBLISHER
      Publisher
      EAD.ARCHDESC.DID.REPOSITORY Publisher
      EAD.ARCHDESC.DID.SUBJECT Subject
      EAD.ARCHDESC.DID.UNITTITLE Title
      EAD.ARCHDESC.TYPE Type
  6. Click Next. The Formatting screen displays.
  7. Choose the page structure for the finding aid when it is converted to and displayed as a compound object.

Description display options

Contents list display options

  1. Click Advanced to select formatting for the full view of the finding aid. The Project Settings Manager displays the Processing Settings page.
  2. The default CONTENTdm XSL file is selected by default. You can choose a custom XSL file to customize the display of the full finding aid. Under the Finding Aid section, click Use a Custom XSL File.
  3. Browse to select the XSL file that you want to use and click Open.
  4. Click OK to continue.
  5. Click Next. The Confirm Settings screen displays.
  6. Review the settings and then click Finish. A progress screen displays as the finding aid is processed. When complete, a summary screen displays the summary and any errors or warning.
  7. Click Close. The finding aid is added to the project spreadsheet.

 Note: You can edit both compound-object and page-level metadata for a finding aid from the project spreadsheet. Pay particular attention to the page-level titles used for the finding aid and the contents list sections. You may prefer to modify the Title field in the metadata for each section so that it displays properly for end users.

Processing

The following processing details provide guidelines for understanding how to work with EAD files in CONTENTdm.

If the EAD CONTENTdm will
Includes references to an external .XSD or .DTD file If the externally referenced XSD or DTD is available, the finding aid will be processed using it.

If the externally referenced XSD or DTD is not available, the finding aid will be processed using the publicly available Library of Congress EAD XSD.

If the Library of Congress EAD XSD is not available, EAD processing will fail.
Includes references to local (internal) files If the reference to the local file is between the <xml> and <ead> tags, it will be removed and the EAD will be processed without using the referenced file.

If the reference to the local file is within the <ead></ead>, EAD processing will fail.
Includes references to image files If the reference to the image file uses an absolute path, the image will display in both the compound object pages and the full finding aid view.

If the reference to the image file is to a local file or uses a relative path, the image will not display.
Contains badly formed XML If the EAD XML is badly formed, it will not process.
Uses encoding other than UTF-8 If the EAD file uses encoding other than UTF-8 or ANSI. If your finding aid uses ISO encoding, save the file using UTF-8 and change the encoding to UTF-8.
Contains namespace encoding If namespace information is encoded between the <xml> and <ead> tags, it will be ignored and the EAD will process.

If namespace information is encoded within the tags, the EAD processing will fail.

Supported values for

The following values for are supported and displayed. If a finding aid uses a value other than the values defined below, it may not display properly.

  • carton
  • box
  • folder
  • reel
  • frame
  • oversize
  • reel-frame
  • volume
  • map-case
  • box-folder
  • page
  • folio
  • othertype

Available tags for metadata mapping

When processing an EAD file, the following tags will be available for mapping, if they are in the finding aid being processed.  EAD tags that are not included in this list are not currently available for mapping.

Available tags for metadata mapping - Table
Tag structure Tag name in User Interface
ead.archdesc.accessrestrict EAD.ARCHDESC.ACCESSRESTRICT
ead.archdesc.altformatavail EAD.ARCHDESC.ALTFORMAVAIL
ead.archdesc.arrangement.p EAD.ARCHDESC.ARRANGEMENT
ead.archdesc.bioghist EAD.ARCHDESC.BIOGHIST
ead.archdesc.controlaccess.controlaccess.corpname EAD.ARCHDESC.CONTROLACCESS.CORPNAME
ead.archdesc.controlaccess.controlaccess.genreform EAD.ARCHDESC.CONTROLACCESS.GENREFORM
ead.archdesc.controlaccess.controlaccess.geogname EAD.ARCHDESC.CONTROLACCESS.GEOGNAME
ead.archdesc.controlaccess.controlaccess.persname EAD.ARCHDESC.CONTROLACCESS.PERSNAME
ead.archdesc.controlaccess.controlaccess.subject EAD.ARCHDESC.CONTROLACCESS.SUBJECT
ead.archdesc.descgrp.accessrestrict.p EAD.ARCHDESC.DESCGRP.ACCESSRESTRICT
ead.archdesc.descgrp.acqinfo.p EAD.ARCHDESC.DESCGRP.ACQINFO
ead.archdesc.descgrp.processinfo.p EAD.ARCHDESC.DESCGRP.PROCESSINFO
ead.archdesc.descgrp.relatedmaterial.bibref.persname EAD.ARCHDESC.DESCGRP.RELATEDMATERIAL.BIBREF.PERSNAME
ead.archdesc.descgrp.relatedmaterial.bibref.title EAD.ARCHDESC.DESCGRP.RELATEDMATERIAL.BIBREF.TITLE
ead.archdesc.descgrp.userestrict.p EAD.ARCHDESC.DESCGRP.USERESTRICT
ead.archdesc.did.abstract EAD.ARCHDESC.DID.ABSTRACT
ead.archdesc.did.langmaterial EAD.ARCHDESC.DID.LANGMATERIAL
ead.archdesc.did.name EAD.ARCHDESC.DID.ORIGINATION.NAME
ead.archdesc.did.origination.corpname EAD. ARCHDESC.DID.ORIGINATION.CORPNAME
ead.archdesc.did.origination.famname EAD.ARCHDESC.DID.ORIGINATION.FAMNAME
ead.archdesc.did.origination.persname EAD.ARCHDESC.DID.ORIGINATION.PERSNAME
ead.archdesc.did.physdesc ead.archdesc.did.physdesc
ead.archdesc.did.physloc EAD.ARCHDESC.DID.PHYSLOC
ead.archdesc.did.repository.address EAD.ARCHDESC.DID.REPOSITORY.CORPNAME.SUBAREA.ADDRESS
ead.archdesc.did.repository.corpname EAD.ARCHDESC.DID.REPOSITORY.CORPNAME
ead.archdesc.did.repository.corpname.subarea EAD.ARCHDESC.DID.REPOSITORY.CORPNAME.SUBAREA
ead.archdesc.did.repository.name EAD.ARCHDESC.DID.REPOSITORY.NAME
ead.archdesc.did.unitdate EAD.ARCHDESC.DID.UNITDATE
ead.archdesc.did.unitid EAD.ARCHDESC.DID.UNITID
ead.archdesc.did.unittitle EAD.ARCHDESC.DID.UNITTITLE
ead.archdesc.odd.p EAD.ARCHDESC.ODD
ead.archdesc.origination.corpname EAD.ARCHDESC.ORIGINATION.CORPNAME
ead.archdesc.relatedmaterial EAD.ARCHDESC.RELATEDMATERIAL
ead.archdesc.scopecontent.p EAD.ARCHDESC.DID.SCOPECONTENT
ead.archdesc.type EAD.ARCHDESC.TYPE
ead.archdesc.userestrict EAD.ARCHDESC.USERESTRICT
ead.eadheader.eadid.ur EAD.EADHEADER.EADID.URL
ead.eadheader.filedesc.publicationstmt.address.addressline EAD.FILEDESC.PUBLICATIONSTMT.ADDRESS
ead.eadheader.filedesc.publicationstmt.date EAD.FILEDESC.PUBLICATIONSTMT.DATE
ead.eadheader.filedesc.publicationstmt.publisher EAD.FILEDESC.PUBLICATIONSTMT.PUBLISHER
ead.eadheader.filedesc.seriesstmt.titleproper EAD.FILEDESC.SERIESSTMT.TITLEPROPER
ead.eadheader.revisiondesc.change.date EAD.REVISIONDESC.CHANGE.DATE
ead.eadheader.revisiondesc.change.item EAD.REVISIONDESC.CHANGE.ITEM
ead.filedesc.titlestmt.author EAD.FILEDESC.TITLESTMT.AUTHOR
ead.filedesc.titlestmt.sponsor EAD.FILEDESC.SPONSOR
ead.filedesc.titlestmt.subtitle EAD.FILEDESC.TITLESTMT.SUBTITLE
ead.filedesc.titlestmt.titleproper EAD.FILEDESC.TITLESTMT.TITLEPROPER

Editing finding aid compound objects

You can edit both compound object and page level metadata for a finding aid. The structure of a finding aid compound object is not editable, but page names can be edited in the Project Client.

For more information about editing finding aids, see Editing compound objects.

Working with stylesheets

In order to process an EAD finding aid, CONTENTdm uses three default stylesheets:

These files are located within the CONTENTdm Project Client\EAD directory.

Editing the default stylesheets

If the default stylesheets do not adequately render your finding aids, you can edit them to make adjustments needed for your EAD files.

  1. Copy the default files to another location on your local system.
  2. Before editing the default files, make a back-up copy of the originals so you can revert to the defaults if needed.
  3. Open the .xsl file you want to edit using an XML editor of your choice.
  4. Make the desired changes.
  5. Save the edited files to their original location in CONTENTdm Project Client\EAD directory.

 Note: The files must retain their original names in order for EAD processing to work correctly in the Project Client.

Using CONTENTdm alternate stylesheets

Not all EAD finding aids will display correctly using the default style. To support different EAD finding aids, alternate stylesheets are provided below. These stylesheets may be used in lieu of the default stylesheets.

This set of stylesheets supports the display of the tag

  1. Download and save the alternate stylesheet(s) to your machine.

     Note: The alternate description and contentslist stylesheets are designed to work together. For best results, use both of them.

  2. Save the stylesheets in the CONTENTdm Project Client\EAD directory.
  3. Rename the default stylesheets in that folder so you can use them again if needed.
  4. Rename the alternate stylesheets with the corresponding default filename(s):
  • description_default.xsl
  • contentslist_default.xsl
  • fullfindingaid_default.xsl

The next time you import an EAD in Project Client, these alternate stylesheets will be used for finding aid processing.

More alternate stylesheets will be made available in the future.

Using locally customized EAD stylesheets

If you prefer to use customized stylesheets, you may replace the default stylesheets with your own customized files.

 Note: OCLC does not guarantee future compatibility when you use your own customized stylesheets. The CONTENTdm Website does not support custom stylesheets.

  1. Before replacing the default files, make a back-up copy of the originals so you can revert to the defaults if needed.
  2. Move your replacement files into the CONTENTdm Project Client\EAD directory.
  3. Name your replacement files as follows:
    • description_default.xsl
    • contentslist_default.xsl
    • fullfindingaid_default.xsl
  4. Test your stylesheets by importing an EAD using the Add Finding Aid wizard in Project Client.
  5. Upload the finding aid to the server for approval and indexing.
  6. View the finding aid to determine if the custom stylesheets are satisfactory.

Creating locally customized stylesheets from the EAD Cookbook

If you are replacing the default stylesheets with stylesheets from the EAD Cookbook, please take note of the following changes that you will need to make to the Cookbook files in order to use them with CONTENTdm.

  1. Using an XML editor, open the stylesheet from the EAD Cookbook that you want to use with CONTENTdm.
  2. Edit the dsc file (dsc1.xsl - dsc15.xsl), by adding the following template above the
    "" tag.
    < >
  3. Save the changes to the file(s).
  4. Before replacing the default files, make a back-up copy of the originals so you can revert to the defaults if needed.
  5. Move your replacement files into the CONTENTdm Project Client\EAD directory.
  6. Name your replacement files as follows:
    • description_default.xsl
    • contentslist_default.xsl
    • fullfindingaid_default.xsl
  7. Test your stylesheets by importing an EAD using the Add Finding Aid wizard in Project Client.
  8. Upload the finding aid to the server for approval and indexing.
  9. View the finding aid to determine if the custom stylesheets are satisfactory.