#Automated exports for ArchivesSpace These scripts export updated data from ArchivesSpace and version all data in git.

##Dependencies

• Python 2.7 or higher
• lxml
• requests
• requests_toolbelt
• psutil
• gittle
• git

##Getting Started

1. Get a copy of the repo

   git clone [email protected]:RockefellerArchiveCenter/asExportIncremental.git
   

   or just download the zip file of this repo

2. Create a local configuration file at local_settings.cfg and add variables. A sample file looks like this:

   [ArchivesSpace]
   baseURL:http://localhost:8089
   repository:2
   user:admin
   password:admin
   
   [EADexport]
   exportUnpublished:false
   exportDaos:true
   exportNumbered:false
   exportPdf:false
   
   [LastExport]
   filepath:lastExport.pickle
   
   [PDFexport]
   filepath:ead2pdf.jar
   
   [MODSexport]
   # EAD to MODS XSL filepath
   filepath:eadToMods.xsl
   
   [Git]
   dataRemote:[email protected]:username/repository.git
   PDFRemote:[email protected]:username/repository.git
   
   [Logging]
   filename:log.txt
   format: %(asctime)s %(message)s
   datefmt: %m/%d/%Y %I:%M:%S %p
   level: WARNING
   

3. Set up repositories

   • Install git
   • Create local git repositories at your data export locations
   • Create Github repositories to push to
   • Add a remote in each of your local repositories pointing to the appropriate Github repository

4. Set a cron job to run asExportIncremental.py at an interval of your choice

The first time you run this, the script may take some time to execute, since it will attempt to export all published resource records in your ArchivesSpace repository. If you ever want to do a complete export, simply delete the Pickle file specified in lastExportFilepath and the lastExport variable will be set to zero (i.e. the epoch, which was long before ArchivesSpace was a twinkle in anarchivist's eye).

##Optional arguments The script supports a few arguments, which will include or exclude specific functions.

--update_time updates last exported time stored in external file to current time. Useful when you want to avoid exporting everything after you re-sequence your AS instance.

--archival exports EAD for all resource records whose id_0 does not start with 'LI', regardless of when those resources were last updated. When this argument is used, the script does not update the last run time.

--library exports MODS for all resource records whose id_0 starts with 'LI', regardless of when those resources were last updated. When this argument is used, the script does not update the last run time.

--digital exports METS for all digital object records, regardless of when those resources were last updated. When this argument is used, the script does not update the last run time.

--digital --resource %identifier% exports METS digital object records associated with the the resource record whose id_0 matches %identifier%, regardless of when those records were last updated. When this argument is used, the script does not update the last run time.

--resource %identifier% exports EAD for the resource record whose id_0 contains %identifier%, regardless of when those resources were last updated. This argument supports partial matches, for example if FA00 is entered as the identifier, any resources whose id_0 contains FA00 would be exported, including for example FA001, FA002 or xFA001. When this argument is used, the script does not update the last run time.

##What's here

###asExportIncremental.py Exports EAD files from published resource records updated since last export (including updates to any child components or associated agents and subjects), as well as METS records for digital object records associated with those resource records. If a resource record is unpublished, this script will remove the EAD, PDF and any associated METS records. Exported or deleted files are logged to a text file log.txt. (Python)

###ead2pdf.jar Creates PDFs from an EAD file, forked from ead2pdf which includes the Rockefeller Archive Center logo. You may want to replace this file and recompile the .jar for your local institution. (Java)