Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 43 Next »

Introduction

Avalon's Batch Ingest feature provides a method of building one or more media objects at a time from uploaded content and metadata outside the user interface. A batch ingest is started by uploading an Ingest Package consisting of one Manifest File and zero or more Content Files to the Avalon dropbox.  For your convenience there is a demo batch available for download and importing into test systems.

Ingest Packages

An Ingest Package is the combination of content and metadata that make up a single batch.

Package Layout

The package must be uploaded somewhere within the batch subdirectory of the Avalon dropbox. It can either be at the root of the batch directory, or in any subdirectory thereof. The following is a very simple Package that has been uploaded:

Manifest File Format

The manifest file is a spreadsheet (xls, xlsx, csv, or ods) containing the metadata for the objects to be created, as well as the names of the content files that make up each object. In this case, the manifest file is named batch_manifest.xlsx.  See batch_manifest_template.xlsx for an Excel example file.  Required fields are in bold.

 ABCDE
1Michael's First Test Batchmichael.klein@northwestern.edu   
2Main TitleCreatorDate Issued  
3Test Object 1Klein, Michael B.2012content/file_1.mp3content/file_2.mp4
4Test Object 2Northwestern1951content/file_3.mp4 

Row 1, Column A contains a reference name for the batch. This is mostly for your reference so we recommend naming the batch file according to what will help you remember the contents.

Row 1, Column B contains the submitter's email address (to be used for notifications and exceptions).

Row 2 specifies the names of the metadata fields supplied in the following rows. Main TitleCreator, and Date Issued are required. These fields are bolded in the Excel example file.  Each subsequent row represents a single Media Object to be created. Metadata values are specified first, followed by a list of content files to be attached to each object. (It is important that the content file columns not have headers, or they will be misinterpreted as metadata.) Content filenames are relative to the location of the manifest file itself.

Content files listed in the manifest file must have the correct path noted for where those files are located in the Avalon dropbox, relative to the manifest file.  Additionally, all content files must include a file extension.  If necessary, include any directories or subdirectories (note the paths listed in columns D and E in the above example).

Multivalued fields are specified by multiple columns with the same header, e.g. Topical Subject in the following example:

 ABCDEF
1Michael's Second Test Batchmichael.klein@northwestern.edu    
2Main TitleCreatorDate IssuedTopical SubjectTopical Subject 
3Nachos: A MemoirKlein, Michael B.2012-12-22MeatCheesetasty_tasty_nachos.mp4

Supported Field Names (required fields in bold)

  • Main Title
    • MODS mapping: titleInfo/title
    • Not repeatable
    • Required field.  Title is used for display in search results and single item views.  Only the first 32 characters of a title are included in search results listings.  Recommended use is to reflect the content captured in digitized media files (such as the title of the piece performed or a short description of the content of a home movie).
    • Editable after ingest in "Title" field of Resource Description form.
  • Alternative Title
    • MODS mapping: titleInfo@type=”alternative”
    • Repeatable
  • Translated Title
    • MODS mapping: titleInfo@type=”translated”
    • Repeatable
  • Uniform Title
    • MODS mapping: titleInfo@type=”uniform”
    • Repeatable
  • Creator
    • MODS mapping: name@usage="primary"/namePart (role/roleTerm set to "Creator")
    • Repeatable
    • No ability to specify Corporate Body in batch at this time
    • Required field.  Main contributors are the primary persons or bodies associated with the creation of the content.  Main contributors will be included in search results display and aggregated for browsing access.  At this time there is no ability to specify a main contributor as a corporate body.  When possible, use the Library of Congress Name Authority File.
    • Editable after ingest in "Main contributor(s)" field of Resource Description form.
  • Contributor
    • MODS mapping: name/namePart (role/roleTerm set to "Contributor")
    • Repeatable
    • Contributors are persons or bodies associated with the item but not considered primary to the creation of its content.  Examples of this would be performers in a band or opera, conductor, arranger, cinematographer, and choreographer.  At this time this is no ability to specify a contributor as a corporate body.  When possible, use the Library of Congress Name Authority File.
    • Editable after ingest in "Contributor(s)" field of Resource Description form.
  • Statement of Responsibility
    • MODS mapping: note@type=”statement of responsibility”
    • Not repeatable
  • Genre
    • MODS mapping: genre
    • Repeatable
    • Genre can be used to categorize an item by form, style, or subject matter.  For consistency and to allow for sorting and aggregating, use terms from the Open Metadata Registry labels for PBCore: pbcoreGenre.
    • Editable after ingest in "Genre(s)" field of Resource Description form.
  • Publisher
    • MODS mapping: originInfo/publisher
    • Repeatable
    • Publisher of the content of the item.
    • Editable after ingest in "Publisher(s)" field of Resource Description form.
  • Place of Origin
    • MODS mapping: originInfo/place/placeTerm
    • Not repeatable
  • Date Created
    • MODS mapping: originInfo/dateCreated@encoding=”edtf”
    • Not repeatable
    • Creation date should only be used if Date Issued is a re-issue date.  Then Creation date would contain the original publication date.  Enter date information in a format consistent with the options shown in Extended Date/Time Format (EDTF) 1.0.
    • Editable after ingest in "Creation date" field of Resource Description form.
  • Date Issued
    • MODS mapping: originInfo/dateIssued@encoding=”edtf”
    • Not repeatable
    • Required field.  Date should be the main publication date associated with the item to be used for sorting browse and search results.  Enter date information in a format consistent with the options shown in Extended Date/Time Format (EDTF) 1.0.
    • Editable after ingest in "Publication date" field of Resource Description form.
  • Copyright Date
    • MODS mapping: originInfo/dateIssued
    • Repeatable
    • This field does not need to be formatted to any encoding standard.
  • Abstract
    • MODS mapping: abstract
    • Not repeatable
    • Abstract provides a space for describing the contents of the item.  Examples include liner notes, contents list, or an opera scene abstract.  This field is not meant for cataloger's descriptions but for descriptions that accompany the item.  The first 15-20 words are included in search result listings.
    • Editable after ingest in "Summary" field of Resource Description form.
  • Note
    • MODS mapping: note
    • Repeatable
    • No ability to distinguish type of note for batch upload at this time
  • Topical Subject
    • MODS mapping: subject/topic
    • Repeatable
    • Subject should be used for the topical subject of the content.  For consistency and to allow for sorting and aggregating, use terms from the Library of Congress Subject Headings.  For temporal subjects (time periods), use Temporal Subject and for geographic subjects (locations), use Geographic Subject.  See below.
    • Editable after ingest in "Subject(s)" field of Resource Description form.
  • Geographic Subject
    • MODS mapping: subject/geographic
    • Repeatable
    • Geographic Subject should be used for the location associated with the content.  For consistency and to allow for sorting and aggregating, use terms from the Getty Thesaurus of Geographic Names.
    • Editable after ingest in "Location(s)" field of Resource Description form.
  • Temporal Subject
    • MODS mapping: subject/temporal
    • Repeatable
    • Temporal Subject should be used for the time period of the content (for example, years or year ranges).  Enter date information in a format consistent with the options shown in Extended Date/Time Format (EDTF) 1.0.
    • Editable after ingest in "Time period(s)" field of Resource Description form.
  • Occupation Subject
    • MODS mapping: subject/occupation
    • Repeatable
  • Person Subject
    • MODS mapping: subject/name@type=”personal”/namePart
    • Repeatable
  • Corporate Subject
    • MODS mapping: subject/name@type=”corporate”/namePart
    • Repeatable
  • Family Subject
    • MODS mapping: subject/name@type=”family”/namePart
    • Repeatable
  • Title Subject
    • MODS mapping: subject/titleInfo/title
    • Repeatable
  • Collection
    • MODS mapping: relatedItem@type="host"/titleInfo/title
    • Repeatable
    • Collection defines the source or host of the item (for example, the source of the original record or the collection responsible for entering information about the item).  Collections will be aggregated for browsing access.  Examples: Variations, Indiana University Libraries Film Archive, IUCAT, NUcat..
    • Editable after ingest in "Collection(s)" field of Resource Description form.

In addition to the descriptive fields, there are two supported operational fields:

  •  Publish
    • Whether the item should be automatically published after ingest.
    • Default is "No".
    • To trigger auto-publishing, enter value of "Yes".
  • Hidden
    • Whether the item will appear in search/browse results for end users. Use this field to prevent users from discovering extra-restricted items.
    • Default is "No".
    • To trigger hiding, enter value of "Yes".
    • Hidden items will still appear in search/browse results for those with ingest privileges.

Notes

The batch ingest process will verify that the package is complete (i.e., all content files specified in the manifest are present and not open by any other processes) before attempting to ingest. If the package is incomplete, it will be skipped and returned to on a subsequent pass.

 

  • No labels