010 ‐ file preparation

Islandora Workbench requires several files to run a batch ingest.

• CSV file with metadata
• YML file with instructions for workbench
• The media files (images, PDFs, etc.) for repository items.

Files

Filetype	Description	Environment	Filename format	Example location
CSV	Contains the metadata for a batch ingest.	Staging & Production	[coll-number].csv	/mnt/ingest/002-01-01.csv
YML	Contains the instructions for Islandora Workbench to run the ingest command.	Staging	create_s_[your initials].yml	/opt/islandora-workbench/create_s_jsf.yml
		Production	create_p_[your initials].yml	/mnt/ingest/islandora-workbench/create_p_jsf.yml
Media file	The file or files that correspond with the records described in the metadata CSV	Staging & Production	[field_identifier].[ext]	/mnt/ingest/002-01-01/providencedirect1824unse.pdf

Metadata

Metadata Template

Field descriptions

More information about creating, formatting, and normalizing metadata

CSV file

Google Drive > Shared Drives > Digital Collections > Metadata for Digitized Collections > [collection]

Download from Google Sheets.

Rename to [collection-number].csv

YML file

Media files

ProvLibDigital

Create the collection

• Content > Add Content > Repository Item
• Fill in required fields
  • Title
  • Resource Type: Collection
  • Model: Collection
  • (optional but recommended) Unselect "Published"
  • (optional but recommended) Set URL alias
    • Uncheck "Generate automatic URL alias"
    • Enter "/collection/[collection_number]"
  • Save

Confirm Node ID

Click on "Edit," "Media," etc. to see the five digit Node ID, Drupal's unique identifier for the collection, embedded in the page URL (example: https://provlibdigital.org/node/18350/edit). This value will go in the field_member_of column of the metadata spreadsheet.

Note - the Node ID for a given collection will be different between staging and production. Be sure to update the Node ID prior to ingesting onto Production.