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 for Single XML files and Bulk import of Multiple XML files

ICA-AtoM Release 1.2 introduced a command-line tool for importing XML files (single and bulk).

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. Unfortunately, the CSV import ability proved to be quite slow and is considered experimental in Release 1.2. The CSV import algorithm will be improved in Release 1.3 (Fall 2012) and uses a different import template (i.e. different columns are expected in the CSV file). For a more technical discussion of XML import and ICA-AtoM, see: Toolkit-XML import/export.