Difference between revisions of "Resources/CSV templates"

Revision as of 13:41, 20 May 2020

Main Page > Resources > Resources/CSV templates

On this page you will find copies of the CSV templates we provide for use when importing data into AtoM. As the CSV files change over versions, we will add sections, so that you can be sure you are using the right template for your AtoM installation.

For more information on CSV import, see the Import/Export section of our User manual. Links directly to each major release's CSV import documentation are included in the relevant sections below.

Page organization

This page has been divided first by type and then by release.

If there are no changes to the CSV templates for a major release, a link or section will not be included - you can then use the templates from the previous release. Be sure to review the CSV import documentation in the AtoM User manual for your release.

Archival descriptions

Below you'll find copies of the CSV template examples for archival descriptions, organized by each major release. A change log is included so that you can quickly determine what has changed.

At this time, we provide templates for the ISAD(G) and RAD descriptive templates in AtoM. If you are using a different content standard (e.g. DACS, DC, or MODS), we recommend using the ISAD(G) template and ignoring any fields that do not crosswalk. Information about crosswalk mappings can be found in the Data Entry / Templates section of the AtoM User manual.

AtoM 2.6 CSV templates

Change log

• Added missing columns from examples - accessionNumber and digitalObjectPath. See issue #13300
• Updated the example data to include references to the related standard element number wherever possible. See issue #10070

Templates

• ISAD 2.6 CSV template
• RAD 2.6 CSV template

AtoM 2.3 CSV templates

Change log

• Changes to how Actors and events (e.g. creators, creation events, etc) are implemented to better support roundtripping of non-creation events (e.g. accumulation, broadcasting, etc)
  • creators, creatorHistories, creationDates, creationDatesStart, and creationDatesEnd columns removed
  • eventActors, eventActorHistories, eventTypes, eventDates, eventDatesStart, and eventDatesEnd columns added to replace previous columns
  • In RAD template, eventDescriptions replaces creationDateNotes, and eventPlaces has been added
• Added new genreAccessPoints column to support genre access points - see issue #9390
• Removed duplicate column radNoteOnPublishersSeries - see issue #9762
• Updated the sample data for better mapping to related standards fields - see issue #10070

Templates

• ISAD 2.3 CSV template
• RAD 2.3 CSV template

AtoM 2.2 CSV templates

Change log

• Change creatorDates column header and related columns labels to creationDates - see issue #6526
• Add new columns to allow import of alternativeIdentifiers and alternativeIdentifierLabels - see issue #7388

Templates

• ISAD 2.2 CSV template
• RAD 2.2 CSV template

AtoM 2.1 CSV templates

Change log

• digitalObjectURI and digitalObjectPath columns added for importing digital objects with archival descriptions - see issue #6525
• Cast, Credits, and Signatures columns added to RAD CSV template - see issue #7130

Templates

• ISAD 2.1 CSV template
• RAD 2.1 CSV template

AtoM 2.0 and earlier CSV templates

These archival description CSV templates should work for AtoM 2.0.0, 2.0.1, 2.0.2, and any earlier version of ICA-AtoM that supports CSV import.

Templates

• ISAD CSV template
• RAD CSV template

Accessions

AtoM 2.6 CSV templates

Change log

• new donorNotes column added
• Other changes to import behavior:
  • Previously, new terms in the resourceType or acquisitionType columns would trigger an error and halt the import. Now, they will be added to the related taxonomy
  • When a duplicate accessionNumber is encountered during an import, the console log will now include the accession number of the conflict for reference

Templates

• Accessions 2.6 CSV template

AtoM 2.3 CSV templates

Change log

• Changes to actor/event handling columns in Accessions CSV template:
  • Removed creationDates, creationDatesStart, creationDatesEnd and creationDatesType
  • Added eventDates, eventDatesStart, eventDatesEnd. and eventDatesEnd

Templates

• Accessions 2.3 CSV template

AtoM 2.2 CSV templates

Change log

• Add 4 new columns to Accessions CSV import template to allow for creation date imports - see issue #8463

Templates

• Accessions 2.2 CSV template

AtoM 2.1 CSV templates

Change log

• Add qubitParentSlug to accessions CSV import to allow accessions import to link to existing descriptions - see issue #6752
• Add identifier as an option for the second column in the digital object CSV import task - see the related documentation here.

Templates

• Accessions 2.1 CSV template

AtoM 2.0.0 and earlier CSV templates

The following CSV templates should work for AtoM 2.0.0, 2.0.1, and 2.0.2, as well as any previous ICA-AtoM release that supports CSV import.

Templates

• Accession CSV template

Deaccession records

Below you'll find copies of the CSV template examples for deaccession records, organized by each major release. A change log is included so that you can quickly determine what has changed. The ability to import deaccession records via CSV was first introduced in the AtoM 2.5 release.

Templates

• 2.5 Deaccession CSV template

Authority records

In AtoM, there are 3 CSV templates for importing authority records - a primary template, as well as two optional secondary templates that can be imported at the same time (when using the command-line only) to add further forms of name (the Aliases CSV), or relationships between actors (the Relationships CSV).

These two supplementary AtoM authority record CSV templates have not changed since AtoM 2.0.0, and should work for any AtoM or ICA-AtoM release that supports CSV import. Note that currently the aliases and relationships CSV templates can only be imported via the command-line.

In the 2.4 release 2 new fields were added to the primary authority records CSV template, to support the import and export of Occupation access point data.

AtoM 2.5 CSV template

Change log

• Add 2 new fields to the actor CSV import template for subjectAccessPoints and placeAccessPoints. For more details, see issue #12647.

Template

• 2.5 Authority record CSV template

AtoM 2.4 CSV template

Change log

• Add 2 new fields to the actor CSV import template for occupations data: actorOccupations and actorOccupationNotes. For more details, see issue #11081.

Template

• 2.4 Authority record CSV template

AtoM 2.0 CSV templates

The primary authority record template found below should work with all releases up to version 2.3. The Aliases and Relationships CSV templates should work for command-line imports on all versions of AtoM.

Templates

• 2.0 Authority record CSV template
• 2.0 Authority record aliases CSV template
• 2.0 Authority record relationships CSV template

Archival Institutions

CSV import and export for archival institutions (aka repository records) was introduced in the 2.4 release.

Templates

• Archival Institutions CSV template

Physical storage containers and locations

The ability to import physical storage data was added to AtoM in the 2.6 release.

Templates

• Physical storage CSV template

Events

The AtoM events CSV templates have not changed since AtoM 2.0.0. The following CSV templates should work for any AtoM or ICA-AtoM release that supports CSV import.

Templates

• Events CSV template

Digital objects

It is possible to link digital objects to existing descriptions using a CSV template, but we do not provide an example template because the format is very simple. For further information, please see the relevant section in the CSV import documentation:

• https://www.accesstomemory.org/docs/latest/admin-manual/maintenance/cli-import-export/#load-digital-objects-via-the-command-line

• Back to Resources
• Back to AtoM wiki home