Import descriptions and terms

From ICA-AtoM
Jump to navigation Jump to search

Please note that ICA-AtoM is no longer actively supported by Artefactual Systems.
Visit https://www.accesstomemory.org for information about AtoM, the currently supported version.

Main Page > User manual > Import/export > Import descriptions and terms

Select an XML fle to import

ICA-AtoM provides an import functionality that can be used to import single archival descriptions, authority records, archival institutions and terms.

The following filetypes can be imported:

  • EAD (hierarchical archival descriptions and associated authority records, archival institution descriptions and taxonomy terms)
  • Dublin Core XML, MODS XML (archival descriptions and associated taxonomy terms)
  • EAC (authority records)
  • SKOS (hierarchical taxonomies)
  • CSV (comma separated values)


  1. In the main menu, hover your cursor over the "Import" menu and select "XML".
  2. Click Browse to select a file
  3. Click Import
  4. If the file is successfully uploaded, the page will show the elapsed time. If there are errors in the file, the page will display a message describing the errors. However, it should still be possible to edit and view the imported descriptions. You will need to review them carefully to determine whether the errors in the import file were serious enough to affect the display of the descriptions.
  5. Click the "View Archival Description" button in the button block to go to the view page of the highest level of description of the imported object(s) (i.e., the fonds description for an archival description or the top-level term in a hierarchical taxonomy). You will be able to view and edit this description and any child records just as you would if you had entered them in ICA-AtoM instead of importing them.


Select View Archival Description

You can also import SKOS files from the view page of a taxonomy term. Doing so will result in the highest level term in the SKOS file being imported as a child level of the term currently being viewed.


Command-line import of XML files

Release 1.2 introduced a command-line tool for importing single XML files or multiple XML files in a single directory. Running the import from the command-line bypasses web server and client timeout limits and allows the import to run for hours ,or even days, without interruption.

The following is the output from the "help" page for the import:bulk task:


 Usage:
 symfony import:bulk [--application="..."] [--env="..."]
 [--noindex[="..."]] [--schema[="..."]] [--output[="..."]]
 [--v[="..."]] folder

 Arguments:
  folder         The import folder or file

 Options:
  --application  The application name (default: qubit)
  --env          The environment (default: cli)
  --noindex      Set to 'true' to skip indexing on imported objects
  --schema       Schema to use if importing a CSV file
  --output       Filename to output results in CSV format
  --v            Verbose output

 Description:
  Bulk import multiple XML/CSV files at once

The only required argument is the "folder", which despite it's name can point to a single file. The import:bulk task supports import of EAD (archival descriptions), EAC-CPF (authority records) and SKOS (Subject thesauri) XML schemas as of Release 1.2.

Experimental CSV import was included with Release 1.2, but it proved to be too slow for practical use.

For a more technical discussion of XML import and ICA-AtoM, see: Qubit Toolkit-XML import/export.