In order to batch ingest items, items and associated metadata must be bundled in the DSpace Simple Archive Format (SAF). These instructions assume that the user is using the open source SAFCreator tool to create a batch for import into DSpace.
Install SAF Creator from the following link to create the SAF package: https://github.com/jcreel/SAFCreator
| Table of Contents | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
Prepping Metadata File
Make a CSV with column headers that match the corresponding metadata fields in DSpace. This file MUST be a CSV and not an Excel file. If you try to run the batch upload with an Excel file, it will not work. At minimum the metadata fields should include:
...
Filename | dc.title | dc.contributor.author | dc.type | dc.date.issued | dc.language.isco | dc.description | dc.subject |
Coolpic.tif | Rad Tree | Johnson, Emily || Salisbury, Shari | Image | 2022 | en_US
| A picture of the coolest tree in the entire world | Trees || Oaks || dendrology |
Prepping and Saving Files
To make the batch process run smoothly, I recommend saving copies of all your files on OneDrive as usual while you are prepping the files. Once you are ready to run the SAF Creator, make a copy of the files on your Desktop as outlined below. This will make it easier to find the files when you open SAF Creator.
All files need to be in a single folder along with the metadata CSV file
Once you create a folder on your desktop with the upload files and the metadata CSV file, create another empty folder within it called “Batch.” You will need this later on once you run the SAF Creator.
The file names cannot have any spaces or funny characters, as this sometimes causes issues when you are uploading to DSpace. Keep the file names simple.
Running the SAF Creator and Creating SAF Package
Once the metadata spreadsheet is complete and your files are prepped, it’s time to run the SAF Creator.
...
Once the SAF package is created, you can upload the items into DSpace using the Batch Import tool.
Sources
Credits
These instructions were adapted from documentation contributed by Emily Johnson (UT San Antonio) and adapted from documentation originally created by Taylor Fairweather Leitch (formerly at West Texas A&M University). The SAF Creator was developed by James Creel, Texas A&M University.