For larger collections, Islandora is able to pull multiple files out of a zipped archive and ingest them into Fedora as a batch. There are a few ways that this can be done. You can upload .zip archives full of:
This page will run through the specifics of each one. In these examples, we will be batch-ingesting PDF files into a collection with the 'PDF Solution Pack' content model applied to its collection policy.
Ingest zipped content
1. Create a .zip archive with your files in it
The process for doing this will vary from operating system to operating system, but on PC, Mac and Linux at least, a .zip archive can be made in your file browser by highlighting the file or files you would like to zip, right-clicking, and finding an option similar to 'compress', 'create archive', 'create zipped folder', and so on.
In our example, opening the zipped archive shows our PDFs grouped together:
![](/download/attachments/68063596/Archive%20Without%20XML.png?version=1&modificationDate=1425325080886&api=v2)
2. Navigate to the destination collection and click 'Manage'
![](/download/attachments/68063596/Batch%20Ingest-Manage.png?version=1&modificationDate=1425325080925&api=v2)
This will take you to the collection's management page.
![](/download/attachments/68063596/batch%20ingest-collection.png?version=1&modificationDate=1425325080900&api=v2)
This will take you to that collection's options page.
4. Click on 'Batch Import Objects'
![](/download/attachments/68063596/batch%20ingest-import%20objects.png?version=1&modificationDate=1425325080912&api=v2)
This will start the batch import process.
The Islandora Batch Importer module comes with several different modules for handling different types of content. If more than one is enabled, you will need to select the correct one.
![](/download/attachments/68063596/Step%204.png?version=1&modificationDate=1425325080953&api=v2)
In this case, we will be importing objects from a .zip file, so we are going to select that option.
6. Choose the correct options for your batch import
There are a few options on this screen that will need to be set up:
![](/download/attachments/68063596/Step%205.png?version=1&modificationDate=1425325080958&api=v2)
- Browse to the .zip file you would like to upload, and then click the 'Upload' button. It may take a while to move the file to the server.
- Choose the content models you would like to apply to the objects.
- Choose the namespace to be applied to the objects. ("Islandora" is given only as an example.)
- Click the 'Import' button to begin the batch import process.
This will import all the files from your zipped archive during which new Fedora objects are created and associated with the specified collection.
If you wish to ingest objects as simply metadata without a file datastream attached, you may do so by using the batch importer to import a .zip file full of XML forms.
In our example, a .zip file full of XML files has been created. Once the metadata files are fully ingested, PDF files can be added to the objects as datastreams.
![](/download/attachments/68063596/Archive%20Without%20PDF.png?version=1&modificationDate=1425325080880&api=v2)
In this case, we can simply follow the same steps as in the previous example to perform the batch ingest.
To create the XML files, you can either design them manually in a text editor or XML editor or use the Form Builder built into Islandora.
To use the Form Builder to create XML records, navigate to http://path.to.your.site/admin/islandora/xmlform, find the type of form you would like to fill out, and click the 'view' link beside it:
![](/download/attachments/68063596/batch%20ingest-form%20builder.png?version=1&modificationDate=1425325080906&api=v2)
In this case, we will be creating an XML file for a PDF.
Fill out the form with the metadata values you would like, and click the 'Submit' button at the bottom of the form. This will output raw XML to your browser that you can then paste into a text editor, similar to the following:
![](/download/attachments/68063596/XML.png?version=1&modificationDate=1425325080963&api=v2)
Save this output as an XML file, and add it to your .zip archive.
Zip archives can contain both the content files to be ingested and the metadata files at the same time. This can be accomplished in the same way as the first example, with a few changes to the .zip archive itself:
![](/download/attachments/68063596/Archive.png?version=1&modificationDate=1425325080893&api=v2)
In the above example, you will notice that each PDF file has a corresponding XML file, and that the filenames of the PDFs and the XML files are identical in every way – including capitalization – except for the extension. Files with matching filenames will be ingested together into the same object.
After creating a .zip archive like above, you can simply follow the steps from the first example to ingest the batch into the repository.
Batch Ingest Books
When batch ingesting books, each folder/directory represents one book, and nested folders/directories represent the pages.
Sample Directory Structure
ZIP File
- Book One (Folder) - contains a single metadata file (MODS.xml)
- Page 1 (Folder) - contains a single .tiff file (OBJ.tiff)
- Page 2 (Folder) - contains a single .tiff file (OBJ.tiff)
- Page 3 (Folder) - contains a single .tiff file (OBJ.tiff)
- Book Two (Folder) - contains a single metadata file (MODS.xml)
- Page 1 (Folder) - contains a single .tiff file (OBJ.tiff)
- Page 2 (Folder) - contains a single .tiff file (OBJ.tiff)
- Page 3 (Folder) - contains a single .tiff file (OBJ.tiff)
Within each book, an XML file named "MODS.xml" provides the metadata record. Inside each folder, a .tiff file, named "OBJ.tiff" become the page. If you have downloaded MARC XML, you will also be able to upload a file called --METADATA--.mrc (containing binary MARC) in lieu of the MODS.xml file.
Batch Ingest Newspapers
When batch ingesting newspapers, you must already have an existing newspaper-level object. Each ingest folder contains folders that represent issues of the newspaper, and each issue directory contains folders that represent separate page images.
For sample directory structures and configuration options, see the Newspaper Batch Ingest instructions.