Archivists Toolkit integration

From Archivematica
Jump to navigation Jump to search

Main Page > Development > Requirements > Archivists' Toolkit integration

This feature will re-format a DIP for import into Archivists' Toolkit.

Workflow

  1. The user sets AT upload configuration options in the admin tab, via a menu called Archivists' Toolkit settings (see Settings, below)
  2. The user processes a SIP the same way that all SIPs are processed
  3. At the Upload DIP micro-service, the user selects "Upload to Archivists' Toolkit"
  4. The DIP is placed in /uploadedDIPs/AT/.
  5. The user can edit the metadata in the text file if desired
  6. Archivematica sends the DIP metadata to Archivists Toolkit


DIP requirements

  • A DIP formatted for upload to Archivists' Toolkit consists of the objects plus a tab-delimited text file called ATmetadata.txt.
  • The tab-delimited text file contains field values derived from the user-supplied settings or automatically generated during processing.


Settings

This screenshot shows the settings form in the admin tab, with some default settings:


Metadata entry.png


Database field mapping

  • restrictionsApply: TRUE or FALSE (see also RestrictionsApply: Base on PREMIS, below)
  • isComponent: TRUE or FALSE
  • eadDaoActuate: onRequest
  • eadDaoShow: new
  • useStatement: Image-Service [for example]
  • objectType: If no data entered, leave emtpy
  • conditionsGoverningAccess: If no data entered, automatically populate from PREMIS <rightsGrantedNote>. If there is no content in <rightsGrantedNote>, leave empty
  • conditionsGoverningUse: If no data entered, leave empty
  • digitalObjectID: If isComponent is TRUE, populate from Parent digital object ID field in settings; if isComponent is FALSE, automatically populate with file UUID
  • title: Automatically populate with filename (without UUID)
  • uri: Automatically populate with eg http://www.myinstitution.org/[UUID]-filename
  • existenceLocationOriginals: automatically populate with AIP UUID


RestrictionsApply: Base on PREMIS

  • If PREMIS <act>= Disseminate and PREMIS <restriction> = Allow, restrictionsApply = FALSE
  • If PREMIS <act>= Disseminate and PREMIS <restriction> = Conditional, restrictionsApply = TRUE
  • If PREMIS <act>= Disseminate and PREMIS <restriction> = Disallow, restrictionsApply = TRUE
  • In addition, when restrictionsApply=TRUE, both eadDaoActuate and eadDaoShow will be set to “none.”