All rights reserved by the source institution and holding location.
DIGITOOL & WEB-BASED INGEST FOR ARCHIVES FLORIDA COLLECTIONS
Produced by the
FLORIDA CENTER FOR LIBRARY AUTOMATION
The Archives Florida collection home page is online at:
Archives Florida is a collection of archival finding aids (inventories) from libraries, archives,
museums, and other agencies in Florida. These finding aids are encoded in XML according
to the Encoded Archival Description (EAD) standard. For more information on EAD and its
use in Florida archives, including best practices, documentation and instructions on how to
contribute to Archives Florida, see FCLA's Opening Archives in Florida website at:
FCLA periodically offers workshops on how to create EAD-encoded inventories. Please
contact FCLA's Digital Library Services Dept. if you would like to request a training workshop
for your library-based or archives-based organization, or to request that a sub-collection for
your organization's Finding Aids be created in Archives Florida.
This manual explains procedures for ingesting completed and validated EAD finding aids into
the Archives Florida collections. Archives Florida currently is hosted on a software system
(DigiTool from Ex Libris) that requires contributors to upload both digital objects like finding
aids and accompanying metadata records (for this workflow, in Dublin Core format)
describing each finding aid. Because a good EAD finding aid is the master description for an
archival collection, the workflow described here does not require contributors to create
metadata records from scratch. Instead, metadata records are derived by an automated
process from the finding aid, and are then ready to be uploaded along with finding aids into
DigiTool. FCLA provides free software tools to assist in preparing batches of finding aids and
metadata records for batch-uploadinq into Archives Florida. A batch consists of one or more
finding aids + one XML file containing all the Dublin Core metadata records for that batch.
The following pages describe start-to-finish procedures for generating batches, ingesting
them via a Web browser into the DigiTool software, and viewing them online.
I. Software Installation
Many organizations already have established procedures and software for creating valid EAD
finding aids. If your organization does not, FCLA provides templates for creating and
validating EAD inventories with the following free software running on Windows-based
NoteTab text processing software (http://www.notetab.com)
AltovaXML 2007 Validator (http://www.altova.com/altovaxml.html)
After installing both of these free applications:
1. Create a new C:\ead2002 [lower-case] directory on your computer
2. Copy into the C:\ead2002 directory the following files provided by FCLA:
ead.dtd ["rules" file for creating good EAD]
group of 23 files that define character encodings for XML documents, including:
iso-box.ent a iso-mscr.ent
2 stylesheets used by the software including:
fcla_ead2dc.xsl[derives metadata records from EAD inventories]
fcla_ead2html.xsl [creates HTML preview of inventory in DigiTool]
3. Copy the three following files into the C:\Program Files\NoteTab\Libraries, which is
created when NoteTab software is installed. These templates include:
fcla_make_ead.clb [template for creating EAD finding aids]
fcla_valid_plus.clb [template for validating finding aids & previewing in HTML]
fcla_wrap2DC.clb [template to create metadata records to upload with inventories]
NOTE: If you intend to use other software for creating and validating your EAD finding aids,
you can omit installing the AltovaXML 2007 software, as well as the first two .clb files listed in
the above paragraph. All of the other software and files listed in this section are required to
perform the workflow described in this manual.
NOTE: You will also need an Internet connection and a Web browser to upload EAD finding
aids and metadata records into DigiTool and Archives Florida. DiqiTool staff-side functions
often work better if you use the Microsoft Internet Explorer web browser.
II. Preparing Finding Aids & Metadata Records for Upload
1. Open NoteTab application
2. Select the fcla_wrap2DC tab near the bottom of the NoteTab screen
3. If you do not have a new document already open, click "Step 1. New Document" option in the left pane of the screen
EL- El 3I.- Vi!- .. i 5c -rur-rr, F -vc.nler To.'. .ep
. ...^1;^^lBi^.,. --, .--^-- ^^^i^N^^^,-.^.- -?*. -
L-., '- < L.'s:',- .- ._- -. ? ^ .'j 'i ia -
$:ep 2, Opening Tags
SS:ep 3. Create FileList repeatablee]
SSep 4. Cleanup/Closing Tags
Step 5. Save File
S:ep 6. Create DC Recard(s)
Sep 7. Preview DC Record(s)
/ I .,.
4. Double-click "Step 2. Opening Tags"; a few preliminary XML tags will appear in the blank document
Archives and Special
Collections, Olin Library, Rollins College
Henry Nehrling Collection
The personal papers and library of Henry Nehrling
contain manuscripts, photographs, memorabilia,
periodicals and pamphlets from his personal
library. The collection also includes Nehrling's
correspondence with internationally famous
botanists, plant collectors and horticulturalists
of his time, such as Theodore L. Head.
6. On the Enter Activity Parameters screen
a. Enter a locally meaningful name for the ingest job (this name is of only temporary value)
b. Choose the option "Dublin Core XML file and associated file streamss"
c. Choose the "Template Task Chain"
d. Of the template chain options, choose "Attribute Assignment Only"
v 1 vs-4h ^, i 334 q" "li ... .... ,...,-,
*' S-. ... j *:* .t. .r j t. ..:; .- ..
'f"' t I: -- -. A..- -
2 - -a a - :1. l .]. .. ..' .... . . .
Enter Actiiity Paramcters
tlrl l l ., I hlnl1i
4 L t
7. Click the "Next" button at the bottom right of the browser screen
8. If the "Selected Tasks" menu on the right side of the screen has only the task named "Control section Attribute Assignment"
click the "Next" button at the bottom ri ht side of the browser screen
Fr-. 'i I t e:i IncpFl t A tivily I Inl- lt F.-.. I T,i-.k Ni l I IIl..,rI Ler: CTHO'.a S Admin Linit: V[IF.LO I j;-rrJ'm e irr r ta i lrrn.m ci-,l rj ?
Create a New Task Chain
Control section Attribute Assignment
Premis Metadata Creation with PI
Technical Metadata Extraction
Control section Attribute Assignment
Ful Text Extraction
Add History Event
Tiff To ]p2 Converter
Remote Stream Download
-1 ( E., t.-i.
-` --:-~----~-'-' T uted W in~
9. On the Parameters page
a., b. Select the template "dc_simpleentity.xml" and the Processing Instruction file "dc_with_file_stream.xml"
c For DC file upload, select from your computer the batch file of Dublin Core metadata to upload to the DigiTool server
El li -. ,i*P ,,, Io r ... .. .: ;... ..
S'C ", -' .. . ) 6 '- " " "" ." "
-_ _- ..sfr ,.- .
.i -. ": .... .--' "--: :' --. kdi r ...... .., ~......... ............ .... .
.& ; -." -! .. o, ,; L .. "-- ..." ... . ,
'I OJTxiT i:"l U :
*,,~. ~.; .1
." . li
1! -.-*.i. 'Ii.lr I. . l -_ ,'.-.- j *"t, lri-o. fa t7f >y ' .. ,.,
F .. ,I .
e. Create an attribute named "partition a" and assign its value as (collection code)
f. Create an attribute named "partition_b" and assign its value as (contributor code)
g. Create an attribute named "partition_c" and assign its value as (archive account)
h. Click the ""Next" button at the bottom right side of the browser screen.
~ : ~~E.rr f~t~u ~7,,r~
-- a, b, c _
10. On the Upload Files page:
a. Under Local Files tab (default selected) navigate and select EAD file(s) described in the metadata file you chose in
step 9c above, then click the "Send" button to upload a copy of each of these EAD files to the DigiTool server
b. Each uploaded file will then be listed in the "Uploaded to Server" window
c. When you have selected and uploaded all EAD files that are part of this batch job, choose the "Activate" button at the
bottom right side of the browser screen
MInta if un i hav\ nrnhlim wiith thi c frn cll inctrn rtinnQ hlanw
*If you do not see the directory browse window shown in Step 10, and are using the Internet Explorer web browser
(recommended) the cause may be with that DigiTool Web Ingest functions rely upon ActiveX scripts. You should change your
browser's ActiveX settings by doing the following:
1) Click Tools then Internet Options...
2) Click the Security tab on the top left
3) Click the Trusted sites icon then click Sites...
4) Add 'http://digitoolt.fcla.edu:1801/' in the upper text box
5) Be sure to uncheck the box that requires server verification
6) Click Add
7) You should be able to install ActiveX
a. If your batch upload is successful, there may be a delay of several hours before the new finding aids and metadata appear in
DigiTool or Archives Florida.
b. Your uploaded finding aids and metadata will be preserved in FCLA's systems according to standard backup and data
management practices. Nonetheless, you should devise a local plan to manage the master copies of each of your finding aids.
The batch files produced during the workflow described in this manual may be valuable to you in the future as well; if so, FCLA
suggests storing them along with batches of finding aids that have been uploaded to DigiTool.